Gestire le etichette di sensibilità nelle presentazioni PowerPoint in Python

Di cosa tratta questa pagina

Leggi, aggiungi, aggiorna, rimuovi e migra le etichette di sensibilità Microsoft Purview nelle presentazioni PowerPoint PPTX con Aspose.Slides per Python tramite .NET.

Panoramica

Le etichette di sensibilità di Microsoft Purview aiutano le organizzazioni a classificare e gestire i documenti. Durante l’elaborazione automatica delle presentazioni, un’applicazione potrebbe dover preservare un’etichetta esistente, applicare un’etichetta selezionata da una policy, aggiornare il suo stato o migrare i metadati dell’etichetta scritti da un flusso di lavoro Microsoft Information Protection (MIP) più vecchio.

Aspose.Slides for Python via .NET espone i metadati delle etichette di sensibilità moderne tramite Presentation.sensitivity_labels. Questa proprietà restituisce una SensitivityLabelCollection che può essere esaminata e modificata prima che la presentazione sia salvata come PPTX.

Note

Gli identificatori delle etichette di sensibilità e le informazioni sulla policy sono definiti dalla configurazione di Microsoft Purview. Convalida la disponibilità delle etichette e i requisiti della policy nel tuo ambiente prima di aggiungere o migrare i metadati. I valori di SensitivityLabel.content_mark_types descrivono i marcatori di contenuto associati a un’etichetta; non aggiungono da soli testo o forme visibili alle diapositive.

Comprendere le proprietà dell’etichetta di sensibilità

Ogni SensitivityLabel contiene i seguenti metadati:

Proprietà	Scopo
SensitivityLabel.id	Identifica l’etichetta di sensibilità nella policy di Purview.
SensitivityLabel.site_id	Identifica il sito associato alla policy dell’etichetta.
SensitivityLabel.is_enabled	Indica se l’etichetta è abilitata.
SensitivityLabel.is_removed	Indica che l’etichetta è stata rimossa. Imposta questa proprietà a `True` quando lo stato di rimozione deve essere conservato nei metadati.
SensitivityLabel.assignment_method_type	Specifica se l’etichetta è stata applicata automaticamente o tramite decisione dell’utente.
SensitivityLabel.content_mark_types	Elenca i tipi di marcatori di contenuto associati all’etichetta.

L’enumerazione SensitivityLabelAssignmentType descrive come è stata assegnata un’etichetta:

SensitivityLabelAssignmentType.STANDARD rappresenta un’etichetta predefinita o applicata automaticamente.
SensitivityLabelAssignmentType.PRIVILEGED rappresenta un’etichetta applicata tramite decisione dell’utente, inclusi etichette applicate manualmente, consigliate e obbligatorie.

L’enumerazione SensitivityLabelContentType identifica il marcatore associato a un’etichetta:

Valore	Significato
SensitivityLabelContentType.NONE	L’etichetta è stata applicata per impostazione predefinita o automaticamente.
SensitivityLabelContentType.HEADER	Il marcatore di contenuto dell’intestazione è associato all’etichetta.
SensitivityLabelContentType.FOOTER	Il marcatore di contenuto del piè di pagina è associato all’etichetta.
SensitivityLabelContentType.WATERMARK	Il marcatore di contenuto della filigrana è associato all’etichetta.
SensitivityLabelContentType.ENCRYPTION	La protezione di crittografia è associata all’etichetta.

È possibile associare più tipi di marcatori a una singola etichetta.

Elencare le etichette di sensibilità esistenti

Leggi la raccolta di etichette moderne da Presentation.sensitivity_labels e iterala. L’esempio seguente elenca ogni proprietà e marcatore di contenuto memorizzato per ciascuna etichetta:

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)

Aggiungere un’etichetta di sensibilità con marcatore di contenuto

Usa SensitivityLabelCollection.add con l’identificatore dell’etichetta, l’identificatore del sito, lo stato abilitato e il metodo di assegnazione. Passa l’identificatore del sito come oggetto Python uuid.UUID. Dopo che il metodo restituisce il nuovo SensitivityLabel, aggiungi i valori di marcatura richiesti a SensitivityLabel.content_mark_types.

L’esempio seguente aggiunge un’etichetta selezionata manualmente associata a marcatori di piè di pagina e filigrana, quindi salva il risultato come 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)

Aggiornare un’etichetta di sensibilità

Le proprietà del SensitivityLabel sono leggibili e scrivibili, eccetto che la lista restituita da SensitivityLabel.content_mark_types viene modificata tramite le sue operazioni di lista. Dopo aver individuato l’etichetta necessaria, è possibile aggiornare il suo identificatore, l’identificatore del sito, lo stato abilitato, il metodo di assegnazione, lo stato di rimozione e i tipi di marcatura del contenuto. Salva la presentazione per rendere permanenti le modifiche.

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)

Contrassegnare un’etichetta di sensibilità come rimossa

Per conservare il fatto che un’etichetta è stata rimossa, trova l’etichetta e imposta SensitivityLabel.is_removed su True. Questo mantiene la voce dell’etichetta registrando il suo stato di rimozione. Se invece è necessario eliminare una voce dalla raccolta moderna, usa SensitivityLabelCollection.remove_at; usa SensitivityLabelCollection.clear per eliminare tutte le voci.

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)

Leggere e migrare le etichette di sensibilità MIP legacy

I flussi di lavoro basati su MIP più vecchi possono memorizzare i metadati delle etichette di sensibilità in proprietà personalizzate del documento anziché nella raccolta di etichette moderne. Leggi quei metadati con DocumentProperties.get_sensitivity_labels. Il metodo analizza le proprietà personalizzate legacy e restituisce oggetti SensitivityLabel.

Per migrare i metadati, aggiungi ciascuna etichetta restituita alla moderna SensitivityLabelCollection tramite SensitivityLabelCollection.add. Poiché l’aggiunta di un identificatore di etichetta duplicato genera un’eccezione, l’esempio controlla la raccolta di destinazione prima di copiare ogni etichetta. È possibile aggiungere ulteriori convalide per confermare che ogni etichetta legacy esista ancora nella policy di Purview corrente.

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 migrazione copia gli oggetti etichetta analizzati nella raccolta moderna. Non è necessario cancellare tutte le proprietà personalizzate del documento, quindi i metadati non correlati rimangono intatti. Usa Presentation.save con SaveFormat.PPTX per scrivere i metadati delle etichette moderne in un file PPTX.

FAQ

L’aggiunta di un tipo di marcatore di contenuto crea un’intestazione, un piè di pagina o una filigrana visibile nelle diapositive?

No. I valori aggiunti tramite SensitivityLabel.content_mark_types descrivono i marcatori associati all’etichetta di sensibilità. Non creano testo o forme visibili nella presentazione. Aggiungi separatamente il contenuto della diapositiva corrispondente se il tuo flusso di lavoro deve renderizzare tali marcatori.

Qual è la differenza tra contrassegnare un’etichetta come rimossa e eliminarla dalla raccolta?

Impostare SensitivityLabel.is_removed su True mantiene la voce dell’etichetta e registra il suo stato di rimozione. Chiamare SensitivityLabelCollection.remove_at elimina la voce dalla raccolta moderna. Scegli l’operazione che corrisponde ai requisiti di conservazione dei metadati della tua organizzazione.

Una presentazione può contenere sia metadati MIP legacy che etichette di sensibilità moderne?

Sì. Le etichette legacy possono rimanere nelle proprietà personalizzate del documento, mentre le etichette moderne sono disponibili tramite Presentation.sensitivity_labels. Usa DocumentProperties.get_sensitivity_labels per leggere i metadati legacy e migrare solo le etichette valide che non sono già presenti nella raccolta moderna.

Cosa succede quando la stessa etichetta viene aggiunta più volte?

SensitivityLabelCollection.add genera un’eccezione se la raccolta contiene già un’etichetta con lo stesso identificatore. Controlla i valori di SensitivityLabel.id prima di aggiungere o migrare le etichette.

Quale formato di output dovrebbe essere usato per conservare le etichette di sensibilità aggiornate?

Salva la presentazione come PPTX chiamando Presentation.save con SaveFormat.PPTX, come mostrato negli esempi precedenti.

Aggiungere filigrana alle presentazioni in Python