Korzystanie z danych XML w Aspose.Words dla Java

Wprowadzenie do korzystania z danych XML w Aspose.Words dla Java

W tym przewodniku pokażemy, jak pracować z danymi XML przy użyciu Aspose.Words for Java. Dowiesz się, jak wykonywać operacje korespondencji seryjnej, w tym zagnieżdżone korespondencje seryjne, i jak wykorzystywać składnię Mustache z DataSet. Zapewnimy instrukcje krok po kroku i przykłady kodu źródłowego, aby pomóc Ci zacząć.

Wymagania wstępne

Zanim zaczniemy, upewnij się, że spełnione są następujące wymagania wstępne:

  • Aspose.Words dla Javy zainstalowano.
  • Przykładowe pliki danych XML dla klientów, zamówień i dostawców.
  • Przykładowe dokumenty Word przeznaczone do korespondencji seryjnej.

Korespondencja seryjna z danymi XML

1. Podstawowa korespondencja seryjna

Aby wykonać podstawową korespondencję seryjną przy użyciu danych XML, wykonaj następujące kroki:

DataSet customersDs = new DataSet();
customersDs.readXml("Your Directory Path" + "Mail merge data - Customers.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Registration complete.docx");
doc.getMailMerge().execute(customersDs.getTables().get("Customer"));
doc.save("Your Directory Path" + "BasicMailMerge.docx");

2. Zagnieżdżona korespondencja seryjna

W przypadku zagnieżdżonych korespondencji seryjnej użyj następującego kodu:

DataSet pizzaDs = new DataSet();
pizzaDs.readXml("Your Directory Path" + "Mail merge data - Orders.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Invoice.docx");
doc.getMailMerge().setTrimWhitespaces(false);
doc.getMailMerge().executeWithRegions(pizzaDs);
doc.save("Your Directory Path" + "NestedMailMerge.docx");

Składnia Mustache przy użyciu DataSet

Aby wykorzystać składnię Mustache z zestawem danych, wykonaj następujące kroki:

DataSet ds = new DataSet();
ds.readXml("Your Directory Path" + "Mail merge data - Vendors.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Vendor.docx");
doc.getMailMerge().setUseNonMergeFields(true);
doc.getMailMerge().executeWithRegions(ds);
doc.save("Your Directory Path" + "MustacheSyntaxUsingDataSet.docx");

Wniosek

tym kompleksowym przewodniku zbadaliśmy, jak skutecznie używać danych XML z Aspose.Words for Java. Nauczyłeś się, jak wykonywać różne operacje korespondencji seryjnej, w tym podstawową korespondencję seryjną, zagnieżdżoną korespondencję seryjną i jak wykorzystywać składnię Mustache z DataSet. Te techniki pozwalają z łatwością automatyzować generowanie i dostosowywanie dokumentów.

Najczęściej zadawane pytania

Jak mogę przygotować dane XML do korespondencji seryjnej?

Upewnij się, że Twoje dane XML mają wymaganą strukturę, a tabele i relacje są zdefiniowane, tak jak pokazano w podanych przykładach.

Czy mogę dostosować zachowanie przycinania dla wartości korespondencji seryjnej?

Tak, możesz kontrolować, czy początkowe i końcowe odstępy mają zostać przycięte podczas scalania korespondencji, używającdoc.getMailMerge().setTrimWhitespaces(false).

Czym jest składnia Mustache i kiedy powinienem jej używać?

Składnia Mustache pozwala na bardziej elastyczne formatowanie pól korespondencji seryjnej. Użyjdoc.getMailMerge().setUseNonMergeFields(true) aby włączyć składnię Mustache.