Strukturált dokumentumcímkék (SDT) használata az Aspose.Words for Java programban

Bevezetés a strukturált dokumentumcímkék (SDT) használatába az Aspose.Words for Java programban

Structured Document Tags (SDT) az Aspose.Words for Java hatékony funkciója, amely lehetővé teszi strukturált tartalom létrehozását és kezelését a dokumentumokban. Ebben az átfogó útmutatóban végigvezetjük az SDT-k Aspose.Words for Java programban való használatának különböző szempontjain. Akár kezdő, akár tapasztalt fejlesztő, ebben a cikkben értékes meglátásokat és gyakorlati példákat talál.

Elkezdeni

Mielőtt belemerülnénk a részletekbe, állítsuk be a környezetünket, és hozzunk létre egy alapvető SDT-t. Ebben a részben a következő témákkal foglalkozunk:

Új dokumentum létrehozása
Strukturált dokumentumcímke hozzáadása
A dokumentum mentése

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

// Hozzon létre egy CHECKBOX típusú strukturált dokumentumcímkét
StructuredDocumentTag sdtCheckBox = new StructuredDocumentTag(doc, SdtType.CHECKBOX, MarkupLevel.INLINE);
builder.insertNode(sdtCheckBox);

// Mentse el a dokumentumot
doc.save("WorkingWithSDT.docx");

Az SDT jelölőnégyzet jelenlegi állapotának ellenőrzése

Miután hozzáadott egy SDT jelölőnégyzetet a dokumentumhoz, érdemes lehet programozottan ellenőrizni az aktuális állapotát. Ez akkor lehet hasznos, ha ellenőriznie kell a felhasználói bevitelt, vagy a jelölőnégyzet állapota alapján meghatározott műveleteket kell végrehajtania.

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

if (sdtCheckBox.getSdtType() == SdtType.CHECKBOX) {
    // A jelölőnégyzet be van jelölve
    sdtCheckBox.setChecked(true);
}

doc.save("UpdatedDocument.docx");

Tartalomvezérlők módosítása

Ebben a részben azt vizsgáljuk meg, hogyan módosíthatja a tartalomvezérlőket a dokumentumban. Háromféle tartalomvezérlőt ismertetünk: egyszerű szöveg, legördülő lista és kép.

Egyszerű szöveges tartalomszabályozás módosítása

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

if (sdtPlainText.getSdtType() == SdtType.PLAIN_TEXT) {
    // Törölje a meglévő tartalmat
    sdtPlainText.removeAllChildren();

    // Új szöveg hozzáadása
    Paragraph para = (Paragraph) sdtPlainText.appendChild(new Paragraph(doc));
    Run run = new Run(doc, "New text goes here");
    para.appendChild(run);
}

doc.save("ModifiedDocument.docx");

A legördülő lista tartalomvezérlőjének módosítása

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

if (sdtDropDown.getSdtType() == SdtType.DROP_DOWN_LIST) {
    // Válassza ki a második elemet a listából
    SdtListItem secondItem = sdtDropDown.getListItems().get(2);
    sdtDropDown.getListItems().setSelectedValue(secondItem);
}

doc.save("ModifiedDocument.docx");

Képtartalom-szabályozás módosítása

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()) {
    // Cserélje ki a képet egy újra
    shape.getImageData().setImage("Watermark.png");
}

doc.save("ModifiedDocument.docx");

ComboBox tartalomvezérlő létrehozása

A ComboBox tartalomvezérlő lehetővé teszi a felhasználók számára, hogy egy előre meghatározott listából válasszanak. Hozzon létre egyet a dokumentumunkban.

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");

A Rich Text Content Control használata

A Rich Text tartalomvezérlők tökéletesek a formázott szövegek dokumentumaihoz való hozzáadásához. Hozzunk létre egyet, és állítsuk be a tartalmát.

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");

Tartalomvezérlési stílusok beállítása

Stílusokat alkalmazhat a tartalomvezérlőkre a dokumentum vizuális megjelenésének javítása érdekében. Nézzük meg, hogyan állíthatjuk be a tartalomvezérlő stílusát.

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

//Egyéni stílus alkalmazása
Style style = doc.getStyles().getByStyleIdentifier(StyleIdentifier.QUOTE);
sdt.setStyle(style);

doc.save("StyledDocument.docx");

SDT kötése egyéni XML adatokhoz

Egyes esetekben előfordulhat, hogy egy SDT-t egyéni XML-adatokhoz kell kötnie a dinamikus tartalom létrehozásához. Vizsgáljuk meg, hogyan érhetjük el ezt.

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");

Egyéni XML adatokra leképezett ismétlődő szakaszokat tartalmazó táblázat létrehozása

Az ismétlődő szakaszokat tartalmazó táblázatok rendkívül hasznosak lehetnek strukturált adatok bemutatására. Hozzunk létre egy ilyen táblázatot, és képezzük le egyéni XML adatokra.

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");

Munka több szakaszból álló strukturált dokumentumcímkékkel

A strukturált dokumentumcímkék egy dokumentum több szakaszára is kiterjedhetnek. Ebben a részben megvizsgáljuk, hogyan dolgozhatunk több szakaszból álló SDT-kkel.

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");

Következtetés

Az Aspose.Words for Java strukturált dokumentumcímkéi sokoldalú módot kínálnak a dokumentumok tartalmának kezelésére és formázására. Legyen szó sablonok, űrlapok vagy dinamikus dokumentumok létrehozásáról, az SDT-k biztosítják a szükséges rugalmasságot és vezérlést. Az ebben a cikkben található példák és irányelvek követésével kihasználhatja az SDT-k erejét a dokumentumfeldolgozási feladatok javítására.

GYIK

Mi a strukturált dokumentumcímkék (SDT) célja?

A strukturált dokumentumcímkék (SDT) a dokumentumokon belüli tartalom rendszerezését és formázását szolgálják, megkönnyítve a sablonok, űrlapok és strukturált dokumentumok létrehozását.

Hogyan ellenőrizhetem a Checkbox SDT aktuális állapotát?

A Checkbox SDT aktuális állapotát asetChecked módszerrel, amint azt a cikk bemutatja.

Alkalmazhatok stílusokat a tartalomvezérlőkre?

Igen, stílusokat alkalmazhat a tartalomvezérlőkre, hogy testreszabhassa megjelenésüket a dokumentumban.

Lehetséges az SDT-t egyedi XML-adatokhoz kötni?

Igen, az SDT-t egyéni XML-adatokhoz kötheti, lehetővé téve a dinamikus tartalomgenerálást és adatleképezést.

Mik azok az ismétlődő szakaszok az SDT-kben?

Az SDT-k szakaszainak ismétlése lehetővé teszi, hogy dinamikus adatokat tartalmazó táblázatokat hozzon létre, ahol a sorok megismételhetők a leképezett XML-adatok alapján.

Dokumentumtartományok használata az Aspose.Words for Java-ban Stílusok és témák használata az Aspose.Words for Java programban