Beheer gevoeligheidslabels in PowerPoint-presentaties in Python

Waar deze pagina over gaat

Lees, voeg toe, werk bij, verwijder en migreer Microsoft Purview-gevoeligheidslabels in PowerPoint PPTX-presentaties met Aspose.Slides voor Python via Java.

Overzicht

Microsoft Purview gevoeligheidslabels helpen organisaties documenten te classificeren en te beheren. Tijdens geautomatiseerde presentatieverwerking kan een applicatie een bestaand label moeten behouden, een label toepassen dat door een beleid is geselecteerd, de status bijwerken, of labelmetadata migreren die door een oudere Microsoft Information Protection (MIP)-workflow is geschreven.

Aspose.Slides stelt moderne metadata van gevoeligheidslabels beschikbaar via Presentation.getSensitivityLabels. Deze methode retourneert een SensitivityLabelCollection die kan worden geïnspecteerd en aangepast voordat de presentatie wordt opgeslagen als PPTX.

Note

De identificatoren van gevoeligheidslabels en beleidsinformatie worden gedefinieerd door uw Microsoft Purview-configuratie. Controleer de beschikbaarheid van labels en de beleidsvereisten in uw omgeving voordat u metadata toevoegt of migreert. De waarden van SensitivityLabel.getContentMarkTypes beschrijven de inhoudsmarkeringen die aan een label zijn gekoppeld; ze voegen op zichzelf geen zichtbare tekst of vormen toe aan dia’s.

Begrijp eigenschappen van gevoeligheidslabels

Elke SensitivityLabel bevat de volgende metadata:

Methodes	Doel
getId en setId	Haal of stel de identificator van het gevoeligheidslabel in het Purview-beleid in.
getSiteId en setSiteId	Haal of stel de site die aan het labelbeleid is gekoppeld in.
isEnabled en setEnabled	Haal of stel of het label is ingeschakeld.
isRemoved en setRemoved	Haal of stel of het label is verwijderd. Stel de waarde in op `True` wanneer de verwijderingsstatus in de metadata moet worden behouden.
getAssignmentMethodType en setAssignmentMethodType	Haal of stel of het label automatisch of via een gebruikersbeslissing is toegepast.
getContentMarkTypes	Haal de inhoudsmarkeringstypen op die aan het label zijn gekoppeld.

De SensitivityLabelAssignmentType klasse definieert hoe een label is toegewezen:

Standard staat voor een standaard of automatisch toegepast label.
Privileged staat voor een label dat via een gebruikersbeslissing is toegepast, inclusief handmatig toegepaste, aanbevolen en verplichte labels.

De SensitivityLabelContentType klasse definieert de markering die aan een label is gekoppeld:

Waarde	Betekenis
None	Het label werd standaard of automatisch toegepast.
Header	Header‑inhoudsmarkering is gekoppeld aan het label.
Footer	Footer‑inhoudsmarkering is gekoppeld aan het label.
Watermark	Watermark‑inhoudsmarkering is gekoppeld aan het label.
Encryption	Encryptie‑bescherming is gekoppeld aan het label.

Meerdere markeringstypen kunnen aan één label worden gekoppeld.

Lijst bestaande gevoeligheidslabels

Lees de moderne labelverzameling uit via Presentation.getSensitivityLabels en doorloop deze. Het volgende voorbeeld vermeldt elke eigenschap en inhoudsmarkering die voor elk label is opgeslagen:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    for sensitivity_label in sensitivity_labels:
        print("Label ID:", sensitivity_label.getId())
        print("Site ID:", sensitivity_label.getSiteId())
        print("Enabled:", sensitivity_label.isEnabled())
        print("Removed:", sensitivity_label.isRemoved())
        print("Assignment method:", sensitivity_label.getAssignmentMethodType())

        for content_mark_type in sensitivity_label.getContentMarkTypes():
            print("Content marking:", content_mark_type)
finally:
    presentation.dispose()

Voeg een gevoeligheidslabel toe met inhoudsmarkering

Gebruik SensitivityLabelCollection.add met het label‑identificator, site‑identificator, de ingeschakelde status en de toewijzingsmethode. Nadat de methode het nieuwe SensitivityLabel heeft geretourneerd, voeg je de vereiste markeringswaarden toe via de lijst die door SensitivityLabel.getContentMarkTypes wordt geretourneerd.

Het volgende voorbeeld voegt een handmatig geselecteerd label toe dat is gekoppeld aan footer‑ en watermark‑markeringen, en slaat vervolgens het resultaat op als PPTX:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SensitivityLabelAssignmentType, SensitivityLabelContentType
from java.util import UUID

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    label_identifier = "{11111111-2222-3333-4444-555555555555}"
    site_identifier = UUID.fromString("aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
    is_enabled = True
    assignment_method = SensitivityLabelAssignmentType.Privileged

    sensitivity_label = sensitivity_labels.add(label_identifier, site_identifier, is_enabled, assignment_method)

    sensitivity_label.getContentMarkTypes().addItem(jpype.JInt(SensitivityLabelContentType.Footer))
    sensitivity_label.getContentMarkTypes().addItem(jpype.JInt(SensitivityLabelContentType.Watermark))

    presentation.save("presentation_with_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Werk een gevoeligheidslabel bij

De waarden van SensitivityLabel zijn lees‑/schrijfbaar, behalve dat de lijst die door SensitivityLabel.getContentMarkTypes wordt geretourneerd, wordt aangepast via de lijstbewerkingen. Nadat je het gewenste label hebt gevonden, kun je de identifier, site‑identifier, ingeschakelde status, toewijzingsmethode, verwijderingsstatus en inhoudsmarkeringstypen bijwerken. Sla de presentatie op om de wijzigingen te bewaren.

Het volgende voorbeeld werkt de ingeschakelde status en toewijzingsmethode van het eerste label bij:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SensitivityLabelAssignmentType

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    if sensitivity_labels.getCount() > 0:
        sensitivity_label = sensitivity_labels.get_Item(0)
        sensitivity_label.setEnabled(True)
        sensitivity_label.setAssignmentMethodType(SensitivityLabelAssignmentType.Privileged)

    presentation.save("presentation_with_updated_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Markeer een gevoeligheidslabel als verwijderd

Om het feit te behouden dat een label is verwijderd, zoek je het label en roep je SensitivityLabel.setRemoved aan met True. Dit behoudt het label‑item terwijl de verwijderingsstatus wordt vastgelegd. Als je in plaats daarvan een item uit de moderne collectie wilt verwijderen, gebruik dan SensitivityLabelCollection.removeAt; gebruik SensitivityLabelCollection.clear om alle items te verwijderen.

Het volgende voorbeeld markeert een specifiek label als verwijderd en slaat de bijgewerkte presentatie op:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()
    target_label_identifier = "{11111111-2222-3333-4444-555555555555}"

    for sensitivity_label in sensitivity_labels:
        is_target_label = str(sensitivity_label.getId()).casefold() == target_label_identifier.casefold()

        if is_target_label:
            sensitivity_label.setRemoved(True)
            break

    presentation.save("presentation_with_removed_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Lees en migreer legacy MIP‑gevoeligheidslabels

Ouder MIP‑gebaseerde werkstromen kunnen metadata van gevoeligheidslabels opslaan in aangepaste documenteigenschappen in plaats van in de moderne labelverzameling. Lees die metadata met DocumentProperties.getSensitivityLabels. De methode parseert de legacy‑aangepaste eigenschappen en retourneert een array van SensitivityLabel objecten.

Om de metadata te migreren, voeg je elk geretourneerd label toe aan de moderne SensitivityLabelCollection via SensitivityLabelCollection.add. Omdat het toevoegen van een duplicate label‑identificator een uitzondering veroorzaakt, controleert het voorbeeld de doelcollectie voordat elk label wordt gekopieerd. Je kunt extra validatie toevoegen om te bevestigen dat elk legacy‑label nog bestaat in het huidige Purview‑beleid.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation_with_legacy_labels.pptx")
try:
    legacy_sensitivity_labels = presentation.getDocumentProperties().getSensitivityLabels()
    modern_sensitivity_labels = presentation.getSensitivityLabels()

    for legacy_sensitivity_label in legacy_sensitivity_labels:
        label_already_exists = False

        for modern_sensitivity_label in modern_sensitivity_labels:
            label_already_exists = str(modern_sensitivity_label.getId()).casefold() == str(legacy_sensitivity_label.getId()).casefold()

            if label_already_exists:
                break

        if not label_already_exists:
            modern_sensitivity_labels.add(legacy_sensitivity_label)

    presentation.save("presentation_with_modern_labels.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

De migratie kopieert de geparseerde labelobjecten naar de moderne collectie. Het is niet nodig om alle aangepaste documenteigenschappen te wissen, zodat niet‑gerelateerde documentmetadata intact blijft. Gebruik Presentation.save met SaveFormat.Pptx om de moderne labelmetadata naar een PPTX‑bestand te schrijven.

FAQ

Maakt het toevoegen van een inhoudsmarkeringstype een zichtbare header, footer of watermerk op dia’s?

Nee. De waarden die via de lijst die door SensitivityLabel.getContentMarkTypes wordt geretourneerd worden toegevoegd, beschrijven de markeringen die aan het gevoeligheidslabel zijn gekoppeld. Ze creëren geen zichtbare tekst of vormen in de presentatie. Voeg de overeenkomstige dia‑inhoud separaat toe als uw werkstroom die markeringen moet weergeven.

Wat is het verschil tussen een label markeren als verwijderd en het verwijderen uit de collectie?

Het aanroepen van SensitivityLabel.setRemoved met True behoudt het label‑item en registreert zijn verwijderingsstatus. Het aanroepen van SensitivityLabelCollection.removeAt verwijdert het item uit de moderne collectie. Kies de bewerking die overeenkomt met de metadata‑retentie‑eisen van uw organisatie.

Kan een presentatie zowel legacy MIP‑metadata als moderne gevoeligheidslabels bevatten?

Ja. Legacy‑labels kunnen blijven staan in aangepaste documenteigenschappen, terwijl moderne labels beschikbaar zijn via Presentation.getSensitivityLabels. Gebruik DocumentProperties.getSensitivityLabels om de legacy‑metadata te lezen en migreer alleen de geldige labels die nog niet aanwezig zijn in de moderne collectie.

Wat gebeurt er als een label met dezelfde identificator meer dan eens wordt toegevoegd?

SensitivityLabelCollection.add veroorzaakt een uitzondering wanneer de collectie al een label met dezelfde identificator bevat. Controleer de bestaande waarden die door SensitivityLabel.getId worden geretourneerd voordat je labels toevoegt of migreert.

Welk uitvoerformaat moet worden gebruikt om bijgewerkte gevoeligheidslabels te behouden?

Sla de presentatie op als PPTX door Presentation.save aan te roepen met SaveFormat.Pptx, zoals geïllustreerd in de bovenstaande voorbeelden.

Watermerken toevoegen aan presentaties in Python