Správa štítků citlivosti v PowerPoint prezentacích v Javě

O čem je tato stránka

Čtěte, přidávejte, aktualizujte, odstraňujte a migrujte štítky citlivosti Microsoft Purview v PowerPoint PPTX prezentacích pomocí Aspose.Slides pro Javu.

Přehled

Microsoft Purview sensitivity labels pomáhají organizacím klasifikovat a spravovat dokumenty. Během automatického zpracování prezentace může aplikace potřebovat zachovat existující štítek, použít štítek vybraný politikou, aktualizovat jeho stav nebo migrovat metadata štítku zapsaná starším pracovním postupem Microsoft Information Protection (MIP).

Aspose.Slides vystavuje moderní metadata štítků citlivosti prostřednictvím IPresentation.getSensitivityLabels. Tato metoda vrací ISensitivityLabelCollection, kterou lze prozkoumat a upravit před uložením prezentace jako PPTX.

Poznámka

Identifikátory štítků citlivosti a informace o politice jsou definovány vaší konfigurací Microsoft Purview. Ověřte dostupnost štítku a požadavky politiky ve vašem prostředí, než přidáte nebo migrujete metadata. Hodnoty ISensitivityLabel.getContentMarkTypes popisují obsahové označení spojené se štítkem; samy o sobě nepřidávají viditelný text ani tvary do snímků.

Pochopení vlastností označení citlivosti

Každý ISensitivityLabel obsahuje následující metadata:

Metody	Účel
ISensitivityLabel.getId a ISensitivityLabel.setId	Získat nebo nastavit identifikátor štítku citlivosti v politice Purview.
ISensitivityLabel.getSiteId a ISensitivityLabel.setSiteId	Získat nebo nastavit místo (site) spojené s politikou štítku.
ISensitivityLabel.isEnabled a ISensitivityLabel.setEnabled	Získat nebo nastavit, zda je štítek povolen.
ISensitivityLabel.isRemoved a ISensitivityLabel.setRemoved	Získat nebo nastavit, zda byl štítek odstraněn. Nastavte hodnotu na `true`, když má být stav odstranění zachován v metadatech.
ISensitivityLabel.getAssignmentMethodType a ISensitivityLabel.setAssignmentMethodType	Získat nebo nastavit, zda byl štítek aplikován automaticky nebo na základě rozhodnutí uživatele.
ISensitivityLabel.getContentMarkTypes	Získat typy obsahových označení spojených se štítkem.

Třída SensitivityLabelAssignmentType určuje, jak byl štítek přiřazen:

SensitivityLabelAssignmentType.Standard představuje výchozí nebo automaticky aplikovaný štítek.
SensitivityLabelAssignmentType.Privileged představuje štítek aplikovaný na základě rozhodnutí uživatele, včetně ručně aplikovaných, doporučených a povinných štítků.

Třída SensitivityLabelContentType definuje označení spojené se štítkem:

Hodnota	Význam
SensitivityLabelContentType.None	Štítek byl aplikován výchozím způsobem nebo automaticky.
SensitivityLabelContentType.Header	K štítku je přiřazeno označení hlavičky.
SensitivityLabelContentType.Footer	K štítku je přiřazeno označení paty.
SensitivityLabelContentType.Watermark	K štítku je přiřazeno označení vodoznaku.
SensitivityLabelContentType.Encryption	K štítku je přiřazena ochrana šifrováním.

Více typů označení může být přiřazeno jednomu štítku.

Seznam existujících štítků citlivosti

Načtěte moderní kolekci štítků pomocí IPresentation.getSensitivityLabels a enumerujte ji. Následující příklad vypisuje každou vlastnost a obsahové označení uložené pro každý štítek:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    for (ISensitivityLabel sensitivityLabel : sensitivityLabels) {
        System.out.println("Label ID: " + sensitivityLabel.getId());
        System.out.println("Site ID: " + sensitivityLabel.getSiteId());
        System.out.println("Enabled: " + sensitivityLabel.isEnabled());
        System.out.println("Removed: " + sensitivityLabel.isRemoved());
        System.out.println("Assignment method: " + sensitivityLabel.getAssignmentMethodType());

        for (Integer contentMarkType : sensitivityLabel.getContentMarkTypes()) {
            System.out.println("Content marking: " + contentMarkType);
        }
    }
} finally {
    presentation.dispose();
}

Přidání štítku citlivosti s obsahovým označením

Použijte ISensitivityLabelCollection.add s identifikátorem štítku, identifikátorem místa, stavem povolení a metodou přiřazení. Po vrácení nového ISensitivityLabel přidejte požadované hodnoty označení prostřednictvím seznamu vráceného metodou ISensitivityLabel.getContentMarkTypes.

Následující příklad přidává ručně vybraný štítek spojený s označením paty a vodoznaku a poté výsledek uloží jako PPTX:

import com.aspose.slides.*;
import java.util.UUID;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    String labelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    UUID siteIdentifier = UUID.fromString("aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
    boolean isEnabled = true;
    int assignmentMethod = SensitivityLabelAssignmentType.Privileged;

    ISensitivityLabel sensitivityLabel = sensitivityLabels.add(
            labelIdentifier,
            siteIdentifier,
            isEnabled,
            assignmentMethod);

    sensitivityLabel.getContentMarkTypes().addItem(SensitivityLabelContentType.Footer);
    sensitivityLabel.getContentMarkTypes().addItem(SensitivityLabelContentType.Watermark);

    presentation.save("presentation_with_label.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Aktualizace štítku citlivosti

Hodnoty ISensitivityLabel jsou čitelné i zapisovatelné, kromě toho, že seznam vrácený metodou ISensitivityLabel.getContentMarkTypes se upravuje pomocí operací na tomto seznamu. Po nalezení požadovaného štítku můžete aktualizovat jeho identifikátor, identifikátor místa, stav povolení, metodu přiřazení, stav odstranění a typy obsahových označení. Uložte prezentaci, aby se změny projevily.

Následující příklad aktualizuje stav povolení a metodu přiřazení prvního štítku:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    if (sensitivityLabels.getCount() > 0) {
        ISensitivityLabel sensitivityLabel = sensitivityLabels.get_Item(0);
        sensitivityLabel.setEnabled(true);
        sensitivityLabel.setAssignmentMethodType(SensitivityLabelAssignmentType.Privileged);
    }

    presentation.save("presentation_with_updated_label.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Označení štítku citlivosti jako odstraněného

Chcete‑li zachovat informaci o tom, že byl štítek odstraněn, najděte štítek a zavolejte ISensitivityLabel.setRemoved s hodnotou true. Tím se uchová záznam štítku a zaznamená jeho stav odstranění. Pokud místo toho potřebujete ze moderní kolekce štítek odstranit, použijte ISensitivityLabelCollection.removeAt; pro smazání všech položek použijte ISensitivityLabelCollection.clear.

Následující příklad označí konkrétní štítek jako odstraněný a uloží aktualizovanou prezentaci:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();
    String targetLabelIdentifier = "{11111111-2222-3333-4444-555555555555}";

    for (ISensitivityLabel sensitivityLabel : sensitivityLabels) {
        boolean isTargetLabel = sensitivityLabel.getId().equalsIgnoreCase(targetLabelIdentifier);

        if (isTargetLabel) {
            sensitivityLabel.setRemoved(true);
            break;
        }
    }

    presentation.save("presentation_with_removed_label.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Čtení a migrace starých MIP štítků citlivosti

Starší pracovní postupy založené na MIP mohou ukládat metadata štítků citlivosti do vlastních vlastností dokumentu místo moderní kolekce štítků. Načtěte tato metadata pomocí IDocumentProperties.getSensitivityLabels. Metoda parsuje staré vlastní vlastnosti a vrací pole objektů ISensitivityLabel.

Pro migraci metadat přidejte každý vrácený štítek do moderní ISensitivityLabelCollection pomocí ISensitivityLabelCollection.add. Protože přidání duplicitního identifikátoru štítku vyvolá výjimku, příklad před kopírováním každého štítku kontroluje cílovou kolekci. Můžete doplnit další ověření, aby bylo jisté, že každý starý štítek stále existuje v aktuální politice Purview.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation_with_legacy_labels.pptx");
try {
    ISensitivityLabel[] legacySensitivityLabels = presentation.getDocumentProperties().getSensitivityLabels();
    ISensitivityLabelCollection modernSensitivityLabels = presentation.getSensitivityLabels();

    for (ISensitivityLabel legacySensitivityLabel : legacySensitivityLabels) {
        boolean labelAlreadyExists = false;

        for (ISensitivityLabel modernSensitivityLabel : modernSensitivityLabels) {
            labelAlreadyExists = modernSensitivityLabel.getId().equalsIgnoreCase(
                    legacySensitivityLabel.getId());

            if (labelAlreadyExists) {
                break;
            }
        }

        if (!labelAlreadyExists) {
            modernSensitivityLabels.add(legacySensitivityLabel);
        }
    }

    presentation.save("presentation_with_modern_labels.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Migrace zkopíruje parsované objekty štítků do moderní kolekce. Nevyžaduje vymazání všech vlastních vlastností dokumentu, takže nesouvisející metadata dokumentu zůstávají nedotčena. Použijte IPresentation.save s SaveFormat.Pptx k zápisu moderních metadat štítků do souboru PPTX.

Často kladené otázky

Vytváří přidání typu obsahového označení viditelnou hlavičku, patu nebo vodoznak na snímcích?

Ne. Hodnoty přidané přes seznam vrácený metodou ISensitivityLabel.getContentMarkTypes popisují označení spojená se štítkem citlivosti. Nevytvářejí viditelný text ani tvary v prezentaci. Příslušný obsah snímku přidejte samostatně, pokud váš pracovní postup musí tato označení zobrazit.

Jaký je rozdíl mezi označením štítku jako odstraněného a jeho smazáním z kolekce?

Volání ISensitivityLabel.setRemoved s hodnotou true ponechá záznam štítku a zaznamená jeho stav odstranění. Volání ISensitivityLabelCollection.removeAt štítek z moderní kolekce odstraní. Vyberte operaci, která odpovídá požadavkům vaší organizace na uchovávání metadat.

Může prezentace obsahovat jak stará MIP metadata, tak moderní štítky citlivosti?

Ano. Staré štítky mohou zůstat ve vlastních vlastnostech dokumentu, zatímco moderní štítky jsou dostupné přes IPresentation.getSensitivityLabels. Použijte IDocumentProperties.getSensitivityLabels k načtení starých metadat a migrujte jen platné štítky, které ještě v moderní kolekci nejsou.

Co se stane, když je štítek se stejným identifikátorem přidán více než jednou?

ISensitivityLabelCollection.add vyvolá výjimku, pokud kolekce již obsahuje štítek se stejným identifikátorem. Před přidáním nebo migrací štítků zkontrolujte existující hodnoty vrácené metodou ISensitivityLabel.getId.

Jaký výstupní formát použít pro zachování aktualizovaných štítků citlivosti?

Uložte prezentaci jako PPTX voláním IPresentation.save s SaveFormat.Pptx, jak je ukázáno v příkladech výše.

Přidání vodoznaků do prezentací v jazyce Java