Sử dụng Thẻ Tài liệu có Cấu trúc (SDT) trong Aspose.Words cho Java

Giới thiệu về cách sử dụng Thẻ tài liệu có cấu trúc (SDT) trong Aspose.Words cho Java

Thẻ tài liệu có cấu trúc (SDT) là một tính năng mạnh mẽ trong Aspose.Words for Java cho phép bạn tạo và thao tác nội dung có cấu trúc trong tài liệu của mình. Trong hướng dẫn toàn diện này, chúng tôi sẽ hướng dẫn bạn qua các khía cạnh khác nhau của việc sử dụng SDT trong Aspose.Words for Java. Cho dù bạn là người mới bắt đầu hay là nhà phát triển có kinh nghiệm, bạn sẽ tìm thấy những hiểu biết có giá trị và các ví dụ thực tế trong bài viết này.

Bắt đầu

Trước khi đi sâu vào chi tiết, chúng ta hãy thiết lập môi trường và tạo SDT cơ bản. Trong phần này, chúng ta sẽ đề cập đến các chủ đề sau:

Tạo một tài liệu mới
Thêm thẻ tài liệu có cấu trúc
Lưu tài liệu

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

// Tạo một thẻ tài liệu có cấu trúc loại CHECKBOX
StructuredDocumentTag sdtCheckBox = new StructuredDocumentTag(doc, SdtType.CHECKBOX, MarkupLevel.INLINE);
builder.insertNode(sdtCheckBox);

// Lưu tài liệu
doc.save("WorkingWithSDT.docx");

Kiểm tra trạng thái hiện tại của hộp kiểm SDT

Sau khi bạn đã thêm SDT hộp kiểm vào tài liệu của mình, bạn có thể muốn kiểm tra trạng thái hiện tại của nó theo chương trình. Điều này có thể hữu ích khi bạn cần xác thực đầu vào của người dùng hoặc thực hiện các hành động cụ thể dựa trên trạng thái hộp kiểm.

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

if (sdtCheckBox.getSdtType() == SdtType.CHECKBOX) {
    // Hộp kiểm đã được chọn
    sdtCheckBox.setChecked(true);
}

doc.save("UpdatedDocument.docx");

Sửa đổi Kiểm soát Nội dung

Trong phần này, chúng ta sẽ khám phá cách sửa đổi các điều khiển nội dung trong tài liệu của bạn. Chúng ta sẽ đề cập đến ba loại điều khiển nội dung: Văn bản thuần túy, Danh sách thả xuống và Hình ảnh.

Sửa đổi Kiểm soát Nội dung Văn bản thuần túy

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

if (sdtPlainText.getSdtType() == SdtType.PLAIN_TEXT) {
    // Xóa nội dung hiện có
    sdtPlainText.removeAllChildren();

    // Thêm văn bản mới
    Paragraph para = (Paragraph) sdtPlainText.appendChild(new Paragraph(doc));
    Run run = new Run(doc, "New text goes here");
    para.appendChild(run);
}

doc.save("ModifiedDocument.docx");

Sửa đổi Kiểm soát Nội dung Danh sách Thả xuống

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

if (sdtDropDown.getSdtType() == SdtType.DROP_DOWN_LIST) {
    // Chọn mục thứ hai từ danh sách
    SdtListItem secondItem = sdtDropDown.getListItems().get(2);
    sdtDropDown.getListItems().setSelectedValue(secondItem);
}

doc.save("ModifiedDocument.docx");

Sửa đổi Kiểm soát Nội dung Hình ảnh

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()) {
    // Thay thế hình ảnh bằng một hình ảnh mới
    shape.getImageData().setImage("Watermark.png");
}

doc.save("ModifiedDocument.docx");

Tạo một điều khiển nội dung ComboBox

ComboBox Content Control cho phép người dùng chọn từ danh sách tùy chọn được xác định trước. Hãy tạo một trong tài liệu của chúng ta.

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

Làm việc với Rich Text Content Control

Rich Text Content Controls hoàn hảo để thêm văn bản được định dạng vào tài liệu của bạn. Hãy tạo một cái và thiết lập nội dung của nó.

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

Thiết lập Kiểu Kiểm soát Nội dung

Bạn có thể áp dụng kiểu cho các điều khiển nội dung để tăng cường giao diện trực quan cho tài liệu của mình. Hãy cùng xem cách thiết lập kiểu cho một điều khiển nội dung.

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

// Áp dụng một phong cách tùy chỉnh
Style style = doc.getStyles().getByStyleIdentifier(StyleIdentifier.QUOTE);
sdt.setStyle(style);

doc.save("StyledDocument.docx");

Liên kết SDT với Dữ liệu XML Tùy chỉnh

Trong một số trường hợp, bạn có thể cần liên kết SDT với dữ liệu XML tùy chỉnh để tạo nội dung động. Hãy cùng khám phá cách thực hiện điều này.

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

Tạo một bảng với các phần lặp lại được ánh xạ tới dữ liệu XML tùy chỉnh

Các bảng có phần lặp lại có thể cực kỳ hữu ích để trình bày dữ liệu có cấu trúc. Hãy tạo một bảng như vậy và ánh xạ nó vào dữ liệu XML tùy chỉnh.

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

Làm việc với thẻ tài liệu có cấu trúc nhiều phần

Thẻ tài liệu có cấu trúc có thể trải dài trên nhiều phần trong một tài liệu. Trong phần này, chúng ta sẽ khám phá cách làm việc với SDT nhiều phần.

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

Phần kết luận

Thẻ tài liệu có cấu trúc trong Aspose.Words for Java cung cấp một cách linh hoạt để quản lý và định dạng nội dung trong tài liệu của bạn. Cho dù bạn cần tạo mẫu, biểu mẫu hay tài liệu động, SDT đều cung cấp tính linh hoạt và khả năng kiểm soát mà bạn cần. Bằng cách làm theo các ví dụ và hướng dẫn được cung cấp trong bài viết này, bạn có thể khai thác sức mạnh của SDT để nâng cao các tác vụ xử lý tài liệu của mình.

Câu hỏi thường gặp

Mục đích của Thẻ tài liệu có cấu trúc (SDT) là gì?

Thẻ tài liệu có cấu trúc (SDT) có mục đích tổ chức và định dạng nội dung trong tài liệu, giúp việc tạo mẫu, biểu mẫu và tài liệu có cấu trúc dễ dàng hơn.

Làm thế nào để tôi có thể kiểm tra trạng thái hiện tại của Checkbox SDT?

Bạn có thể kiểm tra trạng thái hiện tại của Checkbox SDT bằng cách sử dụngsetChecked phương pháp như đã trình bày trong bài viết.

Tôi có thể áp dụng kiểu cho Kiểm soát nội dung không?

Có, bạn có thể áp dụng kiểu cho Điều khiển nội dung để tùy chỉnh giao diện của chúng trong tài liệu.

Có thể liên kết SDT với dữ liệu XML tùy chỉnh không?

Có, bạn có thể liên kết SDT với dữ liệu XML tùy chỉnh, cho phép tạo nội dung động và ánh xạ dữ liệu.

Các phần lặp lại trong SDT là gì?

Lặp lại các phần trong SDT cho phép bạn tạo các bảng có dữ liệu động, trong đó các hàng có thể được lặp lại dựa trên dữ liệu XML được ánh xạ.

Go Top