Utilizzo di Structured Document Tags (SDT) in Aspose.Words per Java

Introduzione all’utilizzo dei tag di documento strutturato (SDT) in Aspose.Words per Java

Gli Structured Document Tags (SDT) sono una potente funzionalità di Aspose.Words per Java che consente di creare e manipolare contenuti strutturati all’interno dei documenti. In questa guida completa, ti guideremo attraverso i vari aspetti dell’utilizzo degli SDT in Aspose.Words per Java. Che tu sia un principiante o uno sviluppatore esperto, troverai spunti preziosi ed esempi pratici in questo articolo.

Iniziare

Prima di immergerci nei dettagli, impostiamo il nostro ambiente e creiamo un SDT di base. In questa sezione, tratteremo i seguenti argomenti:

Creazione di un nuovo documento
Aggiunta di un tag di documento strutturato
Salvataggio del documento

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Crea un tag di documento strutturato di tipo CHECKBOX
StructuredDocumentTag sdtCheckBox = new StructuredDocumentTag(doc, SdtType.CHECKBOX, MarkupLevel.INLINE);
builder.insertNode(sdtCheckBox);

// Salva il documento
doc.save("WorkingWithSDT.docx");

Controllo dello stato corrente di una casella di controllo SDT

Una volta aggiunto un SDT di casella di controllo al documento, potresti voler controllare il suo stato attuale a livello di programmazione. Ciò può essere utile quando devi convalidare l’input dell’utente o eseguire azioni specifiche in base allo stato della casella di controllo.

Document doc = new Document("WorkingWithSDT.docx");
StructuredDocumentTag sdtCheckBox = (StructuredDocumentTag) doc.getChild(NodeType.STRUCTURED_DOCUMENT_TAG, 0, true);

if (sdtCheckBox.getSdtType() == SdtType.CHECKBOX) {
    // La casella di controllo è selezionata
    sdtCheckBox.setChecked(true);
}

doc.save("UpdatedDocument.docx");

Modifica dei controlli del contenuto

In questa sezione, esploreremo come modificare i controlli di contenuto all’interno del tuo documento. Tratteremo tre tipi di controlli di contenuto: Testo normale, Elenco a discesa e Immagine.

Modifica del controllo del contenuto di testo normale

Document doc = new Document("WorkingWithSDT.docx");
StructuredDocumentTag sdtPlainText = (StructuredDocumentTag) doc.getChild(NodeType.STRUCTURED_DOCUMENT_TAG, 0, true);

if (sdtPlainText.getSdtType() == SdtType.PLAIN_TEXT) {
    // Cancella il contenuto esistente
    sdtPlainText.removeAllChildren();

    // Aggiungi nuovo testo
    Paragraph para = (Paragraph) sdtPlainText.appendChild(new Paragraph(doc));
    Run run = new Run(doc, "New text goes here");
    para.appendChild(run);
}

doc.save("ModifiedDocument.docx");

Modifica del controllo del contenuto dell’elenco a discesa

Document doc = new Document("WorkingWithSDT.docx");
StructuredDocumentTag sdtDropDown = (StructuredDocumentTag) doc.getChild(NodeType.STRUCTURED_DOCUMENT_TAG, 0, true);

if (sdtDropDown.getSdtType() == SdtType.DROP_DOWN_LIST) {
    // Seleziona il secondo elemento dall'elenco
    SdtListItem secondItem = sdtDropDown.getListItems().get(2);
    sdtDropDown.getListItems().setSelectedValue(secondItem);
}

doc.save("ModifiedDocument.docx");

Modifica del controllo del contenuto dell’immagine

Document doc = new Document("WorkingWithSDT.docx");
StructuredDocumentTag sdtPicture = (StructuredDocumentTag) doc.getChild(NodeType.STRUCTURED_DOCUMENT_TAG, 0, true);
Shape shape = (Shape) sdtPicture.getChild(NodeType.SHAPE, 0, true);

if (shape.hasImage()) {
    // Sostituisci l'immagine con una nuova
    shape.getImageData().setImage("Watermark.png");
}

doc.save("ModifiedDocument.docx");

Creazione di un controllo contenuto ComboBox

Un controllo contenuto ComboBox consente agli utenti di selezionare da un elenco predefinito di opzioni. Creiamone uno nel nostro documento.

Document doc = new Document();
StructuredDocumentTag sdtComboBox = new StructuredDocumentTag(doc, SdtType.COMBO_BOX, MarkupLevel.BLOCK);
sdtComboBox.getListItems().add(new SdtListItem("Choose an item", "-1"));
sdtComboBox.getListItems().add(new SdtListItem("Item 1", "1"));
sdtComboBox.getListItems().add(new SdtListItem("Item 2", "2"));
doc.getFirstSection().getBody().appendChild(sdtComboBox);

doc.save("ComboBoxDocument.docx");

Lavorare con il controllo del contenuto di testo avanzato

controlli di contenuto Rich Text sono perfetti per aggiungere testo formattato ai tuoi documenti. Creiamone uno e impostiamone il contenuto.

Document doc = new Document();
StructuredDocumentTag sdtRichText = new StructuredDocumentTag(doc, SdtType.RICH_TEXT, MarkupLevel.BLOCK);
Paragraph para = new Paragraph(doc);
Run run = new Run(doc);
run.setText("Hello World");
run.getFont().setColor(Color.GREEN);
para.getRuns().add(run);
sdtRichText.getChildNodes().add(para);
doc.getFirstSection().getBody().appendChild(sdtRichText);

doc.save("RichTextDocument.docx");

Impostazione degli stili di controllo del contenuto

Puoi applicare stili ai controlli contenuto per migliorare l’aspetto visivo del tuo documento. Vediamo come impostare lo stile di un controllo contenuto.

Document doc = new Document("WorkingWithSDT.docx");
StructuredDocumentTag sdt = (StructuredDocumentTag) doc.getChild(NodeType.STRUCTURED_DOCUMENT_TAG, 0, true);

// Applica uno stile personalizzato
Style style = doc.getStyles().getByStyleIdentifier(StyleIdentifier.QUOTE);
sdt.setStyle(style);

doc.save("StyledDocument.docx");

Associazione di un SDT a dati XML personalizzati

In alcuni scenari, potrebbe essere necessario associare un SDT a dati XML personalizzati per la generazione di contenuti dinamici. Vediamo come ottenere questo risultato.

Document doc = new Document();
CustomXmlPart xmlPart = doc.getCustomXmlParts().add(UUID.randomUUID().toString(), "<root><text>Hello, World!</text></root>");
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PLAIN_TEXT, MarkupLevel.BLOCK);
doc.getFirstSection().getBody().appendChild(sdt);
sdt.getXmlMapping().setMapping(xmlPart, "/root[1]/text[1]", "");

doc.save("CustomXMLBinding.docx");

Creazione di una tabella con sezioni ripetute mappate su dati XML personalizzati

Le tabelle con sezioni ripetute possono essere estremamente utili per presentare dati strutturati. Creiamo una tabella del genere e la mappiamo a dati XML personalizzati.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
CustomXmlPart xmlPart = doc.getCustomXmlParts().add("Books", "<books>...</books>");
Table table = builder.startTable();
builder.insertCell();
builder.write("Title");
builder.insertCell();
builder.write("Author");
builder.endRow();
builder.endTable();

StructuredDocumentTag repeatingSectionSdt = new StructuredDocumentTag(doc, SdtType.REPEATING_SECTION, MarkupLevel.ROW);
repeatingSectionSdt.getXmlMapping().setMapping(xmlPart, "/books[1]/book", "");
table.appendChild(repeatingSectionSdt);

StructuredDocumentTag repeatingSectionItemSdt = new StructuredDocumentTag(doc, SdtType.REPEATING_SECTION_ITEM, MarkupLevel.ROW);
repeatingSectionSdt.appendChild(repeatingSectionItemSdt);

Row row = new Row(doc);
repeatingSectionItemSdt.appendChild(row);

StructuredDocumentTag titleSdt = new StructuredDocumentTag(doc, SdtType.PLAIN_TEXT, MarkupLevel.CELL);
titleSdt.getXmlMapping().setMapping(xmlPart, "/books[1]/book[1]/title[1]", "");
row.appendChild(titleSdt);

StructuredDocumentTag authorSdt = new StructuredDocumentTag(doc, SdtType.PLAIN_TEXT, MarkupLevel.CELL);
authorSdt.getXmlMapping().setMapping(xmlPart, "/books[1]/book[1]/author[1]", "");
row.appendChild(authorSdt);

doc.save("RepeatingTableDocument.docx");

Lavorare con i tag dei documenti strutturati multisezione

I tag di documento strutturato possono estendersi su più sezioni in un documento. In questa sezione, esploreremo come lavorare con gli SDT multi-sezione.

Document doc = new Document("MultiSectionDocument.docx");
NodeCollection tags = doc.getChildNodes(NodeType.STRUCTURED_DOCUMENT_TAG_RANGE_START, true);

for (StructuredDocumentTagRangeStart tag : tags) {
    System.out.println(tag.getTitle());
}

doc.save("ModifiedMultiSectionDocument.docx");

Conclusione

tag di documento strutturati in Aspose.Words per Java forniscono un modo versatile per gestire e formattare i contenuti nei tuoi documenti. Che tu debba creare modelli, moduli o documenti dinamici, gli SDT offrono la flessibilità e il controllo di cui hai bisogno. Seguendo gli esempi e le linee guida fornite in questo articolo, puoi sfruttare la potenza degli SDT per migliorare le tue attività di elaborazione dei documenti.

Domande frequenti

Qual è lo scopo degli Structured Document Tag (SDT)?

Gli Structured Document Tag (SDT) servono a organizzare e formattare il contenuto all’interno dei documenti, semplificando la creazione di modelli, moduli e documenti strutturati.

Come posso verificare lo stato attuale di un Checkbox SDT?

È possibile controllare lo stato corrente di un Checkbox SDT utilizzandosetChecked metodo, come dimostrato nell’articolo.

Posso applicare stili ai controlli dei contenuti?

Sì, puoi applicare stili ai Controlli contenuto per personalizzarne l’aspetto nel documento.

È possibile associare un SDT a dati XML personalizzati?

Sì, è possibile associare un SDT a dati XML personalizzati, consentendo la generazione di contenuti dinamici e la mappatura dei dati.

Cosa sono le sezioni ripetute negli SDT?

Le sezioni ripetute negli SDT consentono di creare tabelle con dati dinamici, in cui le righe possono essere ripetute in base ai dati XML mappati.

Go Top