Érzékenységi címkék kezelése PowerPoint prezentációkban Androidon

Miről szól ez az oldal

Olvassa, adja hozzá, frissítse, távolítsa el és migrálja a Microsoft Purview érzékenységi címkéket PowerPoint PPTX prezentációkban az Aspose.Slides for Android via Java segítségével.

Áttekintés

A Microsoft Purview érzékenységi címkék segítik a szervezeteket a dokumentumok osztályozásában és kezelésében. Az automatikus prezentációfeldolgozás során egy alkalmazásnak meg kell őriznie egy meglévő címkét, alkalmaznia kell egy szabály által kiválasztott címkét, frissítenie kell annak állapotát, vagy migrálnia kell a régebbi Microsoft Information Protection (MIP) munkafolyamat által írt címke metaadatait.

Az Aspose.Slides for Android via Java a modern érzékenységi címke metaadatokat a IPresentation.getSensitivityLabels metóduson keresztül teszi elérhetővé. Ez a metódus egy ISensitivityLabelCollection objektumot ad vissza, amelyet a prezentáció PPTX formátumba mentése előtt ellenőrizhet és módosíthat.

Note

Az érzékenységi címke azonosítókat és a szabályi információkat a Microsoft Purview konfigurációja határozza meg. Ellenőrizze a címkék elérhetőségét és a szabályi követelményeket a környezetben, mielőtt metaadatokat adna hozzá vagy migrálná őket. Az ISensitivityLabel.getContentMarkTypes értékek leírják a címkéhez kapcsolódó tartalomjelzéseket; önmagukban nem adnak hozzá látható szöveget vagy alakzatot a diákhoz.

Érzékenységi címke tulajdonságainak megértése

Minden ISensitivityLabel a következő metaadatokat tartalmazza:

Módszerek	Cél
ISensitivityLabel.getId és ISensitivityLabel.setId	A Purview szabályban szereplő érzékenységi címke azonosítójának lekérdezése vagy beállítása.
ISensitivityLabel.getSiteId és ISensitivityLabel.setSiteId	A címke szabállyal kapcsolatos webhely lekérdezése vagy beállítása.
ISensitivityLabel.isEnabled és ISensitivityLabel.setEnabled	A címke engedélyezett állapotának lekérdezése vagy beállítása.
ISensitivityLabel.isRemoved és ISensitivityLabel.setRemoved	A címke eltávolított állapotának lekérdezése vagy beállítása. Állítsa `true`-ra, ha a metaadatokban meg kell tartani az eltávolítási állapotot.
ISensitivityLabel.getAssignmentMethodType és ISensitivityLabel.setAssignmentMethodType	A címke automatikus vagy felhasználói döntés alapján történő alkalmazásának lekérdezése vagy beállítása.
ISensitivityLabel.getContentMarkTypes	A címkéhez kapcsolódó tartalomjelzés típusainak lekérdezése.

A SensitivityLabelAssignmentType osztály meghatározza, hogyan lett a címke hozzárendelve:

SensitivityLabelAssignmentType.Standard alapértelmezett vagy automatikusan alkalmazott címkét jelöl.
SensitivityLabelAssignmentType.Privileged felhasználói döntés útján alkalmazott címkét jelöl, beleértve a manuálisan alkalmazott, ajánlott és kötelező címkéket.

A SensitivityLabelContentType osztály határozza meg a címkéhez tartozó jelzést:

Érték	Jelentés
SensitivityLabelContentType.None	A címke alapértelmezetten vagy automatikusan lett alkalmazva.
SensitivityLabelContentType.Header	A fejléc tartalomjelzés kapcsolódik a címkéhez.
SensitivityLabelContentType.Footer	Az élőláb tartalomjelzés kapcsolódik a címkéhez.
SensitivityLabelContentType.Watermark	A vízjel tartalomjelzés kapcsolódik a címkéhez.
SensitivityLabelContentType.Encryption	A címkéhez titkosítási védelem kapcsolódik.

Több jelzéstípus is kapcsolódhat egy címkéhez.

Meglévő érzékenységi címkék listázása

Olvassa be a modern címkegyűjteményt a IPresentation.getSensitivityLabels metódusból, és járja végig. Az alábbi példa minden tulajdonságot és tartalomjelzést felsorol minden címkéhez:

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();
}

Érzékenységi címke hozzáadása tartalomjelzéssel

Használja a ISensitivityLabelCollection.add metódust a címke azonosítóval, a helyazonosítóval, az engedélyezett állapottal és az hozzárendelési móddal. A metódus visszaadja az új ISensitivityLabel objektumot, amelyhez adja hozzá a szükséges jelzési értékeket a ISensitivityLabel.getContentMarkTypes által visszaadott listán keresztül.

Az alábbi példa manuálisan kiválasztott címkét ad hozzá, amelyhez az élőláb és a vízjel jelzések kapcsolódnak, majd a végeredményt PPTX formátumban menti:

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();
}

Érzékenységi címke frissítése

Az [ISensitivityLabel] értékek olvashatók/írhatók, kivéve a ISensitivityLabel.getContentMarkTypes által visszaadott listát, amelyet listaműveletekkel módosíthat. A szükséges címke megtalálása után frissítheti annak azonosítóját, helyazonosítóját, engedélyezett állapotát, hozzárendelési módját, eltávolítási állapotát és tartalomjelzési típusait. Mentse a prezentációt a módosítások mentéséhez.

Az alábbi példa frissíti az első címke engedélyezett állapotát és hozzárendelési módját:

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();
}

Érzékenységi címke megjelölése eltávolítottként

A címke eltávolításának ténye megőrzéséhez keresse meg a címkét, és hívja meg az ISensitivityLabel.setRemoved metódust true értékkel. Ez megtartja a címke bejegyzését, miközben rögzíti az eltávolított állapotot. Ha helyette törölni kell egy bejegyzést a modern gyűjteményből, használja az ISensitivityLabelCollection.removeAt metódust; az összes bejegyzés törléséhez használja az ISensitivityLabelCollection.clear metódust.

Az alábbi példa egy adott címkét megjelöl eltávolítottként, és menti a frissített prezentációt:

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();
}

Legacy MIP érzékenységi címkék olvasása és migrálása

A régebbi MIP-alapú munkafolyamatok a modern címkegyűjtemény helyett saját dokumentumtulajdonságokban tárolhatják az érzékenységi címke metaadatait. Olvassa be ezeket a metaadatokat az IDocumentProperties.getSensitivityLabels metódussal. A metódus az örökölt egyedi tulajdonságokat elemzi, és egy ISensitivityLabel objektumok tömbjét adja vissza.

A metaadatok migrálásához adja hozzá az egyes visszakapott címkéket a modern ISensitivityLabelCollection gyűjteményhez a ISensitivityLabelCollection.add segítségével. Mivel egy duplikált címkeazonosító hozzáadása kivételt vált ki, a példa a másolás előtt ellenőrzi a célgyűjteményt. További ellenőrzést adhat hozzá, hogy megerősítse, minden örökölt címke még létezik-e a jelenlegi Purview szabályban.

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();
}

A migráció a feldolgozott címkeobjektumokat a modern gyűjteménybe másolja. Nem szükséges az összes egyedi dokumentumtulajdonság törlése, így a nem kapcsolódó dokumentum metaadatok érintetlenek maradnak. Használja az IPresentation.save metódust a SaveFormat.Pptx formátummal a modern címke metaadatok PPTX fájlba írásához.

GYIK

Létrehoz-e a tartalomjelzés típusának hozzáadása látható fejlécet, láblécet vagy vízjelet a diákon?

Nem. A ISensitivityLabel.getContentMarkTypes által visszaadott listához hozzáadott értékek leírják a címkéhez kapcsolódó jelzéseket. Nem hoznak létre látható szöveget vagy alakzatot a prezentációban. A megfelelő diákatartalmat külön kell hozzáadni, ha a munkafolyamatnak meg kell jelenítenie ezeket a jelzéseket.

Mi a különbség a címke eltávolítottként való megjelölése és a gyűjteményből való törlése között?

Az ISensitivityLabel.setRemoved true értékkel való meghívása megtartja a címke bejegyzését és rögzíti az eltávolított állapotát. Az ISensitivityLabelCollection.removeAt meghívása törli a bejegyzést a modern gyűjteményből. Válassza azt a műveletet, amely megfelel a szervezet metaadat-tartási követelményeinek.

Lehet egy prezentációban egyszerre legacy MIP metaadat és modern érzékenységi címke?

Igen. A régi címkék maradhatnak az egyedi dokumentumtulajdonságokban, míg a modern címkék a IPresentation.getSensitivityLabels segítségével érhetők el. Használja az IDocumentProperties.getSensitivityLabels metódust a régi metaadatok beolvasásához, és migrálja csak azokat a címkéket, amelyek még nem vannak jelen a modern gyűjteményben.

Mi történik, ha ugyanazzal az azonosítóval rendelkező címkét többször adjuk hozzá?

ISensitivityLabelCollection.add kivételt dob, ha a gyűjtemény már tartalmazza ugyanazzal az azonosítóval a címkét. Ellenőrizze a ISensitivityLabel.getId által visszaadott meglévő értékeket a címkék hozzáadása vagy migrálása előtt.

Melyik kimeneti formátumot kell használni a frissített érzékenységi címkék megőrzéséhez?

Mentse a prezentációt PPTX formátumban az IPresentation.save metódus SaveFormat.Pptx paraméterével, ahogyan a fenti példákban látható.

Vízjelek hozzáadása prezentációkhoz Androidon