Aspose.Words for Java での構造化ドキュメントタグ (SDT) の使用

Aspose.Words for Java での構造化ドキュメントタグ (SDT) の使用の概要

構造化ドキュメントタグ (SDT) は、Aspose.Words for Java の強力な機能で、ドキュメント内で構造化コンテンツを作成および操作できるようになります。この包括的なガイドでは、Aspose.Words for Java での SDT の使用に関するさまざまな側面について説明します。初心者でも経験豊富な開発者でも、この記事では貴重な洞察と実用的な例を見つけることができます。

はじめる

詳細に入る前に、環境をセットアップして基本的な SDT を作成しましょう。このセクションでは、次のトピックについて説明します。

新しいドキュメントの作成
構造化文書タグの追加
文書を保存する

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

//CHECKBOX タイプの構造化文書タグを作成する
StructuredDocumentTag sdtCheckBox = new StructuredDocumentTag(doc, SdtType.CHECKBOX, MarkupLevel.INLINE);
builder.insertNode(sdtCheckBox);

//文書を保存する
doc.save("WorkingWithSDT.docx");

チェックボックス SDT の現在の状態を確認する

ドキュメントにチェックボックス SDT を追加したら、その現在の状態をプログラムで確認したい場合があります。これは、ユーザー入力を検証する必要がある場合や、チェックボックスの状態に基づいて特定のアクションを実行する必要がある場合に役立ちます。

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

if (sdtCheckBox.getSdtType() == SdtType.CHECKBOX) {
    //チェックボックスがチェックされています
    sdtCheckBox.setChecked(true);
}

doc.save("UpdatedDocument.docx");

コンテンツコントロールの変更

このセクションでは、ドキュメント内のコンテンツコントロールを変更する方法を説明します。プレーンテキスト、ドロップダウンリスト、画像の 3 種類のコンテンツコントロールについて説明します。

プレーンテキストコンテンツコントロールの変更

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

if (sdtPlainText.getSdtType() == SdtType.PLAIN_TEXT) {
    //既存のコンテンツをクリアする
    sdtPlainText.removeAllChildren();

    //新しいテキストを追加
    Paragraph para = (Paragraph) sdtPlainText.appendChild(new Paragraph(doc));
    Run run = new Run(doc, "New text goes here");
    para.appendChild(run);
}

doc.save("ModifiedDocument.docx");

ドロップダウンリストコンテンツコントロールの変更

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

if (sdtDropDown.getSdtType() == SdtType.DROP_DOWN_LIST) {
    //リストから 2 番目の項目を選択します
    SdtListItem secondItem = sdtDropDown.getListItems().get(2);
    sdtDropDown.getListItems().setSelectedValue(secondItem);
}

doc.save("ModifiedDocument.docx");

画像コンテンツコントロールの変更

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()) {
    //画像を新しいものに置き換えます
    shape.getImageData().setImage("Watermark.png");
}

doc.save("ModifiedDocument.docx");

ComboBox コンテンツコントロールの作成

ComboBox コンテンツコントロールを使用すると、ユーザーは事前定義されたオプションのリストから選択できます。ドキュメント内に作成しましょう。

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

リッチテキストコンテンツコントロールの操作

リッチテキストコンテンツコントロールは、書式設定されたテキストをドキュメントに追加するのに最適です。作成してその内容を設定しましょう。

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

コンテンツコントロールスタイルの設定

コンテンツコントロールにスタイルを適用して、ドキュメントの外観を向上させることができます。コンテンツコントロールのスタイルを設定する方法を見てみましょう。

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

//カスタムスタイルを適用する
Style style = doc.getStyles().getByStyleIdentifier(StyleIdentifier.QUOTE);
sdt.setStyle(style);

doc.save("StyledDocument.docx");

SDT をカスタム XML データにバインドする

シナリオによっては、動的コンテンツ生成のために SDT をカスタム XML データにバインドする必要がある場合があります。これを達成する方法を見てみましょう。

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

カスタム XML データにマップされた繰り返しセクションを含むテーブルの作成

繰り返しセクションを含む表は、構造化データを表現するのに非常に役立ちます。このようなテーブルを作成し、カスタム XML データにマッピングしてみましょう。

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

複数セクションの構造化文書タグの操作

構造化ドキュメントタグは、ドキュメント内の複数のセクションにまたがることができます。このセクションでは、複数セクションの SDT を操作する方法について説明します。

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

結論

Aspose.Words for Java の構造化ドキュメントタグは、ドキュメント内のコンテンツを管理および書式設定するための多彩な方法を提供します。テンプレート、フォーム、動的ドキュメントのいずれを作成する必要がある場合でも、SDT は必要な柔軟性と制御を提供します。この記事で説明されている例とガイドラインに従うことで、SDT の機能を利用してドキュメント処理タスクを強化できます。

よくある質問

構造化ドキュメントタグ (SDT) の目的は何ですか?

構造化ドキュメントタグ (SDT) は、ドキュメント内のコンテンツを整理して書式設定する目的を果たし、テンプレート、フォーム、および構造化ドキュメントの作成を容易にします。

チェックボックス SDT の現在の状態を確認するにはどうすればよいですか?

チェックボックス SDT の現在の状態を確認するには、setChecked記事で説明されている方法です。

コンテンツコントロールにスタイルを適用できますか?

はい、コンテンツコントロールにスタイルを適用して、ドキュメント内の外観をカスタマイズできます。

SDT をカスタム XML データにバインドすることはできますか?

はい、SDT をカスタム XML データにバインドして、動的なコンテンツ生成とデータマッピングを可能にすることができます。

SDT の繰り返しセクションとは何ですか?

SDT の繰り返しセクションを使用すると、動的なデータを含むテーブルを作成でき、マッピングされた XML データに基づいて行を繰り返すことができます。

Aspose.Words for Java でのドキュメント範囲の使用 Aspose.Words for Java でのスタイルとテーマの使用

Aspose.Words for Java での構造化ドキュメント タグ (SDT) の使用