Używanie danych XML w Aspose.Words dla Java

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

W tym przewodniku omówimy, jak pracować z danymi XML za pomocą Aspose.Words dla Java. Dowiesz się, jak wykonywać operacje korespondencji seryjnej, w tym zagnieżdżone korespondencje seryjne, oraz jak wykorzystywać składnię Mustache w zestawie danych. Udostępnimy instrukcje krok po kroku i przykłady kodu źródłowego, które pomogą Ci rozpocząć.

Warunki wstępne

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

  • Aspose.Words dla Javy zainstalowany.
  • Przykładowe pliki danych XML dla klientów, zamówień i dostawców.
  • Przykładowe dokumenty programu Word dla miejsc docelowych korespondencji seryjnej.

Korespondencja seryjna z danymi XML

1. Podstawowe korespondencji seryjnej

Aby wykonać podstawową korespondencję seryjną z danymi 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 wąsów przy użyciu zestawu danych

Aby wykorzystać składnię Mustache w zestawie 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 obszernym przewodniku zbadaliśmy, jak efektywnie wykorzystywać dane XML w Aspose.Words dla Java. Wiesz już, jak wykonywać różne operacje korespondencji seryjnej, w tym podstawową korespondencję seryjną, zagnieżdżoną korespondencję seryjną i jak korzystać ze składni Mustache w zestawie danych. Techniki te pozwalają z łatwością zautomatyzować generowanie i dostosowywanie dokumentów.

Często zadawane pytania

Jak przygotować dane XML do korespondencji seryjnej?

Upewnij się, że dane XML mają wymaganą strukturę, ze zdefiniowanymi tabelami i relacjami, jak pokazano w podanych przykładach.

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

Tak, możesz kontrolować, czy początkowe i końcowe białe znaki są przycinane podczas korespondencji seryjnej, używającdoc.getMailMerge().setTrimWhitespaces(false).

Jaka jest składnia wąsów i kiedy należy jej używać?

Składnia Mustache umożliwia bardziej elastyczne formatowanie pól korespondencji seryjnej. Używaćdoc.getMailMerge().setUseNonMergeFields(true) aby włączyć składnię wąsów.