Hantera sensitivitetsetiketter i PowerPoint-presentationer i C++

Vad den här sidan handlar om

Läs, lägg till, uppdatera, ta bort och migrera Microsoft Purview-sensitivitetsetiketter i PowerPoint PPTX-presentationer med Aspose.Slides för C++.

Översikt

Microsoft Purview‑sensitivitetsetiketter hjälper organisationer att klassificera och styra dokument. Under automatisk bearbetning av presentationer kan en applikation behöva bevara en befintlig etikett, tillämpa en etikett som valts av en policy, uppdatera dess status eller migrera etikettmetadata som skrivits av ett äldre Microsoft Information Protection (MIP)-arbetsflöde.

Aspose.Slides exponerar modern metadata för sensitivitetsetiketter via IPresentation::get_SensitivityLabels. Denna metod returnerar en ISensitivityLabelCollection som kan inspekteras och modifieras innan presentationen sparas som PPTX.

Note

Sensitivitetsetikettidentifierare och policyinformation definieras av din Microsoft Purview‑konfiguration. Validera etikettens tillgänglighet och policykrav i din miljö innan du lägger till eller migrerar metadata. Värdena från ISensitivityLabel::get_ContentMarkTypes beskriver innehållsmärkningar som är kopplade till en etikett; de lägger inte själva till synlig text eller former på bilder.

Förstå egenskaper för sensitivitetsetiketter

Varje ISensitivityLabel innehåller följande metadata:

Åtkomstmetoder	Syfte
ISensitivityLabel::get_Id, ISensitivityLabel::set_Id	Identifiera sensitivitetsetiketten i Purview‑policyn.
ISensitivityLabel::get_SiteId, ISensitivityLabel::set_SiteId	Identifiera webbplatsen som är associerad med etikettpolicyn.
ISensitivityLabel::get_IsEnabled, ISensitivityLabel::set_IsEnabled	Indikera om etiketten är aktiverad.
ISensitivityLabel::get_IsRemoved, ISensitivityLabel::set_IsRemoved	Indikera att etiketten har tagits bort. Sätt värdet till `true` när borttagningsstatusen måste behållas i metadata.
ISensitivityLabel::get_AssignmentMethodType, ISensitivityLabel::set_AssignmentMethodType	Specificera om etiketten tillämpades automatiskt eller genom ett användarbeslut.
ISensitivityLabel::get_ContentMarkTypes	Lista de typer av innehållsmärkning som är associerade med etiketten.

Uppräkningen SensitivityLabelAssignmentType beskriver hur en etikett tilldelades:

SensitivityLabelAssignmentType::Standard representerar en standard‑ eller automatiskt tillämpad etikett.
SensitivityLabelAssignmentType::Privileged representerar en etikett som tillämpats genom ett användarbeslut, inklusive manuellt tillämpade, rekommenderade och obligatoriska etiketter.

Uppräkningen SensitivityLabelContentType identifierar den märkning som är kopplad till en etikett:

Värde	Betydelse
SensitivityLabelContentType::None	Etiketten tillämpades som standard eller automatiskt.
SensitivityLabelContentType::Header	Innehållsmärkning för sidhuvud är associerad med etiketten.
SensitivityLabelContentType::Footer	Innehållsmärkning för sidfot är associerad med etiketten.
SensitivityLabelContentType::Watermark	Innehållsmärkning för vattenstämpel är associerad med etiketten.
SensitivityLabelContentType::Encryption	Krypteringsskydd är associerat med etiketten.

Flera märkningstyper kan vara associerade med en och samma etikett.

Lista befintliga sensitivitetsetiketter

Läs den moderna etikettkollektionen från IPresentation::get_SensitivityLabels och iterera över den. Följande exempel listar varje egenskap och innehållsmärkning som lagras för varje etikett:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <DOM/SensitivityLabelContentType.h>
#include <system/collections/ilist.h>
#include <system/console.h>
#include <system/guid.h>
#include <system/shared_ptr.h>
#include <system/string.h>

using Aspose::Slides::Presentation;
using System::Console;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();

for (auto&& sensitivityLabel : sensitivityLabels)
{
    auto labelIdentifier = sensitivityLabel->get_Id();
    auto siteIdentifier = sensitivityLabel->get_SiteId();
    auto isEnabled = sensitivityLabel->get_IsEnabled();
    auto isRemoved = sensitivityLabel->get_IsRemoved();
    auto assignmentMethod = sensitivityLabel->get_AssignmentMethodType();

    Console::WriteLine(u"Label ID: {0}", labelIdentifier);
    Console::WriteLine(u"Site ID: {0}", siteIdentifier);
    Console::WriteLine(u"Enabled: {0}", isEnabled);
    Console::WriteLine(u"Removed: {0}", isRemoved);
    Console::WriteLine(u"Assignment method: {0}", assignmentMethod);

    for (auto contentMarkType : sensitivityLabel->get_ContentMarkTypes())
    {
        Console::WriteLine(u"Content marking: {0}", contentMarkType);
    }
}

presentation->Dispose();

Lägg till en sensitivitetsetikett med innehållsmärkning

Använd ISensitivityLabelCollection::Add med etikettidentifieraren, webbplatsidentifieraren, aktiveringsstatusen och tilldelningsmetoden. När metoden returnerar den nya ISensitivityLabel, lägg till de kräva märkningarna via ISensitivityLabel::get_ContentMarkTypes.

Följande exempel lägger till en manuellt vald etikett som är associerad med sidfot‑ och vattenstämpelmärkningar, och sparar sedan resultatet som PPTX:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <DOM/SensitivityLabelContentType.h>
#include <Export/SaveFormat.h>
#include <system/collections/ilist.h>
#include <system/guid.h>
#include <system/shared_ptr.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::SensitivityLabelAssignmentType;
using Aspose::Slides::SensitivityLabelContentType;
using Aspose::Slides::Export::SaveFormat;
using System::Guid;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();

auto labelIdentifier = u"{11111111-2222-3333-4444-555555555555}";
auto siteIdentifier = Guid::Parse(u"{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}");
bool isEnabled = true;
auto assignmentMethod = SensitivityLabelAssignmentType::Privileged;

auto sensitivityLabel = sensitivityLabels->Add(
    labelIdentifier,
    siteIdentifier,
    isEnabled,
    assignmentMethod);

sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Footer);
sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Watermark);

presentation->Save(u"presentation_with_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Uppdatera en sensitivitetsetikett

Värdena i ISensitivityLabel är läsbara/skrivbara via deras getter‑ och setter‑metoder, förutom att kollektionen som returneras av ISensitivityLabel::get_ContentMarkTypes modifieras genom dess listoperationer. Efter att ha lokaliserat den önskade etiketten kan du uppdatera dess identifierare, webbplatsidentifierare, aktiveringsstatus, tilldelningsmetod, borttagningsstatus och typer av innehållsmärkning. Spara presentationen för att persistera ändringarna.

Följande exempel uppdaterar aktiveringsstatusen och tilldelningsmetoden för den första etiketten:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <Export/SaveFormat.h>
#include <system/shared_ptr.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::SensitivityLabelAssignmentType;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();
int labelCount = sensitivityLabels->get_Count();

if (labelCount > 0)
{
    auto sensitivityLabel = sensitivityLabels->idx_get(0);
    sensitivityLabel->set_IsEnabled(true);
    sensitivityLabel->set_AssignmentMethodType(SensitivityLabelAssignmentType::Privileged);
}

presentation->Save(u"presentation_with_updated_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Markera en sensitivitetsetikett som borttagen

För att bevara att en etikett har tagits bort, hitta etiketten och anropa ISensitivityLabel::set_IsRemoved med true. Detta behåller etikettsposten samtidigt som dess borttagningsstatus registreras. Om du i stället behöver ta bort en post från den moderna kollektionen, använd ISensitivityLabelCollection::RemoveAt; använd ISensitivityLabelCollection::Clear för att ta bort alla poster.

Följande exempel markerar en specifik etikett som borttagen och sparar den uppdaterade presentationen:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <Export/SaveFormat.h>
#include <system/shared_ptr.h>
#include <system/string.h>
#include <system/string_comparison.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;
using System::String;
using System::StringComparison;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();
auto targetLabelIdentifier = u"{11111111-2222-3333-4444-555555555555}";

for (auto&& sensitivityLabel : sensitivityLabels)
{
    auto labelIdentifier = sensitivityLabel->get_Id();
    bool isTargetLabel = String::Equals(
        labelIdentifier,
        targetLabelIdentifier,
        StringComparison::OrdinalIgnoreCase);

    if (isTargetLabel)
    {
        sensitivityLabel->set_IsRemoved(true);
        break;
    }
}

presentation->Save(u"presentation_with_removed_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Läs och migrera äldre MIP‑sensitivitetsetiketter

Äldre MIP‑baserade arbetsflöden kan lagra metadata för sensitivitetsetiketter i anpassade dokumentegenskaper istället för i den moderna etikettkollektionen. Läs den metadata med IDocumentProperties::GetSensitivityLabels. Metoden parsar de äldre anpassade egenskaperna och returnerar en array av ISensitivityLabel‑objekt.

För att migrera metadata, lägg till varje returnerad etikett i den moderna ISensitivityLabelCollection via ISensitivityLabelCollection::Add. Eftersom tillägg av en duplicerad etikettidentifierare kastar ett undantag, kontrollerar exemplet målkollektionen innan varje etikett kopieras. Du kan lägga till ytterligare validering för att bekräfta att varje äldre etikett fortfarande finns i den aktuella Purview‑policyn.

#include <DOM/Presentation.h>
#include <DOM/IDocumentProperties.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <Export/SaveFormat.h>
#include <system/array.h>
#include <system/shared_ptr.h>
#include <system/string.h>
#include <system/string_comparison.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;
using System::String;
using System::StringComparison;

auto presentation = MakeObject<Presentation>(u"presentation_with_legacy_labels.pptx");
auto documentProperties = presentation->get_DocumentProperties();
auto legacySensitivityLabels = documentProperties->GetSensitivityLabels();
auto modernSensitivityLabels = presentation->get_SensitivityLabels();

for (auto&& legacySensitivityLabel : legacySensitivityLabels)
{
    bool labelAlreadyExists = false;
    auto legacyLabelIdentifier = legacySensitivityLabel->get_Id();

    for (auto&& modernSensitivityLabel : modernSensitivityLabels)
    {
        auto modernLabelIdentifier = modernSensitivityLabel->get_Id();
        labelAlreadyExists = String::Equals(
            modernLabelIdentifier,
            legacyLabelIdentifier,
            StringComparison::OrdinalIgnoreCase);

        if (labelAlreadyExists)
        {
            break;
        }
    }

    if (!labelAlreadyExists)
    {
        modernSensitivityLabels->Add(legacySensitivityLabel);
    }
}

presentation->Save(u"presentation_with_modern_labels.pptx", SaveFormat::Pptx);
presentation->Dispose();

Migreringen kopierar de parsade etikettobjekten till den moderna kollektionen. Det krävs inte att alla anpassade dokumentegenskaper rensas, så orelaterad dokumentmetadata förblir intakt. Använd IPresentation::Save med SaveFormat::Pptx för att skriva den moderna etikettmetadata till en PPTX‑fil.

FAQ

Skapar tillägg av en innehållsmärkningstyp ett synligt sidhuvud, en sidfot eller en vattenstämpel på bilderna?

Nej. Värden som läggs till via ISensitivityLabel::get_ContentMarkTypes beskriver de märkningar som är kopplade till sensitivitetsetiketten. De skapar inte synlig text eller former i presentationen. Lägg till motsvarande bildinnehåll separat om ditt arbetsflöde måste rendera dessa märkningar.

Vad är skillnaden mellan att markera en etikett som borttagen och att radera den från kollektionen?

Att anropa ISensitivityLabel::set_IsRemoved med true behåller etikettsposten och registrerar dess borttagningsstatus. Att anropa ISensitivityLabelCollection::RemoveAt tar bort posten från den moderna kollektionen. Välj den operation som motsvarar din organisations krav på metadata‑behållning.

Kan en presentation innehålla både äldre MIP‑metadata och moderna sensitivitetsetiketter?

Ja. Äldre etiketter kan finnas kvar i anpassade dokumentegenskaper medan moderna etiketter är tillgängliga via IPresentation::get_SensitivityLabels. Använd IDocumentProperties::GetSensitivityLabels för att läsa den äldre metadata och migrera endast de giltiga etiketter som ännu inte finns i den moderna kollektionen.

Vad händer när en etikett med samma identifierare läggs till mer än en gång?

ISensitivityLabelCollection::Add kastar ett argumentundantag när kollektionen redan innehåller en etikett med samma identifierare. Kontrollera befintliga ISensitivityLabel::get_Id‑värden innan du lägger till eller migrerar etiketter.

Vilket utdataformat bör användas för att bevara uppdaterade sensitivitetsetiketter?

Spara presentationen som PPTX genom att anropa IPresentation::Save med SaveFormat::Pptx, som visas i exemplen ovan.

Lägg till vattenmärken i presentationer i C++