Gestisci Tag e Dati Personalizzati nelle Presentazioni con Python

Panoramica

Questo articolo spiega come Aspose.Slides gestisce i tag e i dati personalizzati nelle presentazioni PowerPoint. Descrive brevemente come i dati sono archiviati nei file PPTX, osserva che i dati specifici della presentazione possono esistere come tag e parti XML personalizzate, e descrive i tag come coppie di stringhe chiave‑valore.

Mostra inoltre come leggere i valori dei tag e come aggiungere tag a una presentazione, a una singola diapositiva o a una forma. Inoltre, l’articolo copre le operazioni comuni di gestione dei tag, come cancellare tutti i tag, rimuovere un tag per nome e recuperare l’elenco dei nomi dei tag.

Archiviazione dei dati nei file di presentazione

I file PPTX — elementi con estensione .pptx — sono archiviati nel formato PresentationML, che fa parte della specifica Office Open XML. Il formato Office Open XML definisce la struttura per i dati contenuti nelle presentazioni.

Con una diapositiva che è uno degli elementi delle presentazioni, una parte di diapositiva contiene il contenuto di una singola diapositiva. Una parte di diapositiva può avere relazioni esplicite con molte parti — come i Tag definiti dall’utente — definite da ISO/IEC 29500.

Dati personalizzati (specifici a una presentazione) o dell’utente possono esistere come tag (ITagCollection) e CustomXmlParts (ICustomXmlPartCollection).

I tag sono essenzialmente coppie chiave‑valore di stringa.

Ottenere i valori dei tag

Nelle diapositive, un tag corrisponde alla proprietà IDocumentProperties.Keywords. Questo esempio di codice mostra come ottenere il valore di un tag con Aspose.Slides per Python via .NET per Presentation:

import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
    print(pres.document_properties.keywords)

Aggiungere tag alle presentazioni

Aspose.Slides consente di aggiungere tag alle presentazioni. Un tag tipicamente consiste di due elementi:

il nome di una proprietà personalizzata - MyTag
il valore della proprietà personalizzata - My Tag Value

Se è necessario classificare alcune presentazioni in base a una regola o proprietà specifica, è possibile beneficiare dell’aggiunta di tag a tali presentazioni. Ad esempio, se si desidera raggruppare tutte le presentazioni dei paesi del Nord America, è possibile creare un tag North American e quindi assegnare i paesi pertinenti (Stati Uniti, Messico e Canada) come valori.

Questo esempio di codice mostra come aggiungere un tag a una Presentation usando Aspose.Slides per Python via .NET:

import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
   tags = pres.custom_data.tags 
   tags.add("MyTag", "My Tag Value")

I tag possono anche essere impostati per Slide:

import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
    slide = pres.slides[0]
    tags = slide.custom_data.tags
    tags.add("tag", "value")

O qualsiasi Shape individuale:

import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
    slide = pres.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 50)
    shape.text_frame.text = "My text"
    shape.custom_data.tags.add("tag", "value")

Limitazioni

I tag aggiunti tramite la collezione custom_data.tags vengono archiviati solo all’interno del file PowerPoint. Non vengono trasferiti nella struttura dei tag PDF quando la presentazione viene esportata in PDF. Di conseguenza, un identificatore personalizzato assegnato come tag non può essere recuperato dal PDF con tag.

Soluzione alternativa: è possibile archiviare un identificatore personalizzato nell'Alt Text dell’oggetto (ad es., shape.alternative_text = "MyId"). Dopo l’esportazione in PDF, l’Alt Text può apparire nella struttura dei tag PDF.

FAQ

Posso rimuovere tutti i tag da una presentazione, diapositiva o forma in un’unica operazione?

Sì. La collezione di tag supporta un’operazione clear che elimina tutte le coppie chiave‑valore in una volta.

Come posso eliminare un singolo tag per nome senza iterare sull’intera collezione?

Utilizzare l’operazione remove(name) sulla TagCollection per cancellare il tag mediante la sua chiave.

Come posso recuperare l’elenco completo dei nomi dei tag per analisi o filtraggio?

Utilizzare get_names_of_tags sulla collezione di tag; restituisce un array di tutti i nomi dei tag.

Crea e personalizza tabelle PowerPoint in Python