Gestion des libellés de sensibilité dans les présentations PowerPoint en Python

À propos de cette page

Lire, ajouter, mettre à jour, supprimer et migrer les libellés de sensibilité Microsoft Purview dans les présentations PowerPoint PPTX avec Aspose.Slides pour Python via .NET.

Aperçu

Les libellés de sensibilité Microsoft Purview aident les organisations à classer et à gérer les documents. Lors du traitement automatisé d’une présentation, une application peut devoir conserver un libellé existant, appliquer un libellé sélectionné par une stratégie, mettre à jour son état ou migrer les métadonnées de libellé écrites par un flux de travail Microsoft Information Protection (MIP) plus ancien.

Aspose.Slides for Python via .NET expose les métadonnées modernes de libellés de sensibilité via Presentation.sensitivity_labels. Cette propriété renvoie une SensitivityLabelCollection qui peut être inspectée et modifiée avant que la présentation soit enregistrée au format PPTX.

Note

Les identifiants de libellés de sensibilité et les informations de stratégie sont définis par votre configuration Microsoft Purview. Validez la disponibilité des libellés et les exigences de stratégie dans votre environnement avant d’ajouter ou de migrer les métadonnées. Les valeurs de SensitivityLabel.content_mark_types décrivent les marquages de contenu associés à un libellé ; elles n’ajoutent pas elles‑mêmes de texte ou de formes visibles aux diapositives.

Comprendre les propriétés du libellé de sensibilité

Chaque SensitivityLabel contient les métadonnées suivantes :

Propriété	Objectif
SensitivityLabel.id	Identifie le libellé de sensibilité dans la stratégie Purview.
SensitivityLabel.site_id	Identifie le site associé à la stratégie du libellé.
SensitivityLabel.is_enabled	Indique si le libellé est activé.
SensitivityLabel.is_removed	Indique que le libellé a été supprimé. Définissez cette propriété sur `True` lorsque l’état de suppression doit être conservé dans les métadonnées.
SensitivityLabel.assignment_method_type	Spécifie si le libellé a été appliqué automatiquement ou par décision d’un utilisateur.
SensitivityLabel.content_mark_types	Liste les types de marquage de contenu associés au libellé.

L’énumération SensitivityLabelAssignmentType décrit comment un libellé a été attribué :

SensitivityLabelAssignmentType.STANDARD représente un libellé par défaut ou appliqué automatiquement.
SensitivityLabelAssignmentType.PRIVILEGED représente un libellé appliqué par décision d’un utilisateur, incluant les libellés appliqués manuellement, recommandés et obligatoires.

L’énumération SensitivityLabelContentType identifie le marquage associé à un libellé :

Valeur	Signification
SensitivityLabelContentType.NONE	Le libellé a été appliqué par défaut ou automatiquement.
SensitivityLabelContentType.HEADER	Le marquage de contenu d’en‑tête est associé au libellé.
SensitivityLabelContentType.FOOTER	Le marquage de contenu de pied‑de‑page est associé au libellé.
SensitivityLabelContentType.WATERMARK	Le marquage de contenu de filigrane est associé au libellé.
SensitivityLabelContentType.ENCRYPTION	La protection par chiffrement est associée au libellé.

Plusieurs types de marquage peuvent être associés à un même libellé.

Lister les libellés de sensibilité existants

Lisez la collection moderne de libellés depuis Presentation.sensitivity_labels et parcourez‑la. L’exemple suivant répertorie chaque propriété et marquage de contenu stockés pour chaque libellé :

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    sensitivity_labels = presentation.sensitivity_labels

    for sensitivity_label in sensitivity_labels:
        print("Label ID:", sensitivity_label.id)
        print("Site ID:", sensitivity_label.site_id)
        print("Enabled:", sensitivity_label.is_enabled)
        print("Removed:", sensitivity_label.is_removed)
        print("Assignment method:", sensitivity_label.assignment_method_type)

        for content_mark_type in sensitivity_label.content_mark_types:
            print("Content marking:", content_mark_type)

Ajouter un libellé de sensibilité avec marquage de contenu

Utilisez SensitivityLabelCollection.add avec l’identifiant du libellé, l’identifiant du site, l’état d’activation et la méthode d’attribution. Passez l’identifiant du site en tant qu’objet Python uuid.UUID. Après que la méthode a renvoyé le nouveau SensitivityLabel, ajoutez les valeurs de marquage requises à SensitivityLabel.content_mark_types.

L’exemple suivant ajoute un libellé sélectionné manuellement associé aux marquages de pied‑de‑page et de filigrane, puis enregistre le résultat au format PPTX :

import uuid
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    sensitivity_labels = presentation.sensitivity_labels

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

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

    sensitivity_label.content_mark_types.append(slides.SensitivityLabelContentType.FOOTER)
    sensitivity_label.content_mark_types.append(slides.SensitivityLabelContentType.WATERMARK)

    presentation.save("presentation_with_label.pptx", slides.export.SaveFormat.PPTX)

Mettre à jour un libellé de sensibilité

Les propriétés du SensitivityLabel sont en lecture/écriture, sauf que la liste renvoyée par SensitivityLabel.content_mark_types est modifiée via ses opérations de liste. Après avoir localisé le libellé requis, vous pouvez mettre à jour son identifiant, l’identifiant du site, l’état d’activation, la méthode d’attribution, l’état de suppression et les types de marquage de contenu. Enregistrez la présentation pour conserver les modifications.

L’exemple suivant met à jour l’état d’activation et la méthode d’attribution du premier libellé :

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    sensitivity_labels = presentation.sensitivity_labels

    if sensitivity_labels.count > 0:
        sensitivity_label = sensitivity_labels[0]
        sensitivity_label.is_enabled = True
        sensitivity_label.assignment_method_type = (
            slides.SensitivityLabelAssignmentType.PRIVILEGED
        )

    presentation.save("presentation_with_updated_label.pptx", slides.export.SaveFormat.PPTX)

Marquer un libellé de sensibilité comme supprimé

Pour conserver le fait qu’un libellé a été supprimé, trouvez le libellé et définissez SensitivityLabel.is_removed sur True. Cela conserve l’entrée du libellé tout en enregistrant son état de suppression. Si vous devez plutôt supprimer une entrée de la collection moderne, utilisez SensitivityLabelCollection.remove_at; utilisez SensitivityLabelCollection.clear pour supprimer toutes les entrées.

L’exemple suivant marque un libellé spécifique comme supprimé et enregistre la présentation mise à jour :

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    sensitivity_labels = presentation.sensitivity_labels
    target_label_identifier = "{11111111-2222-3333-4444-555555555555}"

    for sensitivity_label in sensitivity_labels:
        identifiers_match = (
            sensitivity_label.id.casefold() == target_label_identifier.casefold()
        )

        if identifiers_match:
            sensitivity_label.is_removed = True
            break

    presentation.save("presentation_with_removed_label.pptx", slides.export.SaveFormat.PPTX)

Lire et migrer les libellés de sensibilité MIP hérités

Les anciens flux de travail basés sur MIP peuvent stocker les métadonnées de libellés de sensibilité dans des propriétés de document personnalisées au lieu de la collection moderne de libellés. Lisez ces métadonnées avec DocumentProperties.get_sensitivity_labels. La méthode analyse les propriétés personnalisées héritées et renvoie des objets SensitivityLabel.

Pour migrer les métadonnées, ajoutez chaque libellé renvoyé à la SensitivityLabelCollection moderne via SensitivityLabelCollection.add. Comme l’ajout d’un identifiant de libellé en double lève une exception, l’exemple vérifie la collection de destination avant de copier chaque libellé. Vous pouvez ajouter une validation supplémentaire pour confirmer que chaque libellé hérité existe toujours dans la stratégie Purview actuelle.

import aspose.slides as slides

with slides.Presentation("presentation_with_legacy_labels.pptx") as presentation:
    legacy_sensitivity_labels = (
        presentation.document_properties.get_sensitivity_labels()
    )
    modern_sensitivity_labels = presentation.sensitivity_labels

    for legacy_sensitivity_label in legacy_sensitivity_labels:
        label_already_exists = False

        for modern_sensitivity_label in modern_sensitivity_labels:
            label_already_exists = (
                modern_sensitivity_label.id.casefold()
                == legacy_sensitivity_label.id.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", slides.export.SaveFormat.PPTX)

La migration copie les objets de libellé analysés dans la collection moderne. Elle ne nécessite pas d’effacer toutes les propriétés personnalisées du document, de sorte que les métadonnées du document non liées restent intactes. Utilisez Presentation.save avec SaveFormat.PPTX pour écrire les métadonnées modernes du libellé dans un fichier PPTX.

FAQ

L’ajout d’un type de marquage de contenu crée‑t‑il un en‑tête, un pied‑de‑page ou un filigrane visible sur les diapositives ?

Non. Les valeurs ajoutées via SensitivityLabel.content_mark_types décrivent les marquages associés au libellé de sensibilité. Elles ne créent pas de texte ou de formes visibles dans la présentation. Ajoutez séparément le contenu de diapositive correspondant si votre flux de travail doit rendre ces marquages.

Quelle est la différence entre marquer un libellé comme supprimé et le supprimer de la collection ?

Définir SensitivityLabel.is_removed sur True conserve l’entrée du libellé et enregistre son état de suppression. Appeler SensitivityLabelCollection.remove_at supprime l’entrée de la collection moderne. Choisissez l’opération qui correspond aux exigences de conservation des métadonnées de votre organisation.

Une présentation peut‑elle contenir à la fois des métadonnées MIP héritées et des libellés de sensibilité modernes ?

Oui. Les libellés hérités peuvent demeurer dans les propriétés personnalisées du document tandis que les libellés modernes sont accessibles via Presentation.sensitivity_labels. Utilisez DocumentProperties.get_sensitivity_labels pour lire les métadonnées héritées et ne migrer que les libellés valides qui ne sont pas déjà présents dans la collection moderne.

Que se passe‑t‑il lorsqu’un libellé avec le même identifiant est ajouté plusieurs fois ?

SensitivityLabelCollection.add lève une exception lorsque la collection contient déjà un libellé avec le même identifiant. Vérifiez les valeurs existantes de SensitivityLabel.id avant d’ajouter ou de migrer des libellés.

Quel format de sortie doit être utilisé pour conserver les libellés de sensibilité mis à jour ?

Enregistrez la présentation au format PPTX en appelant Presentation.save avec SaveFormat.PPTX, comme illustré dans les exemples ci‑dessus.

Ajouter des filigranes aux présentations en Python