XmlDataSource class Leave feedback

Provides access to data of an XML file or stream to be used while assembling a document.

To access data of the corresponding file or stream while assembling a document, pass an instance of this class as a data source to one of DocumentAssembler.assemble_document overloads.

In template documents, if a top‑level XML element contains only a list of elements of the same type, a XmlDataSource instance should be treated as a System.Data.DataTable. Otherwise, it should be treated as a System.Data.DataRow. For more information, see the template syntax reference.

When an XML Schema Definition is passed to a constructor of this class, data types of values of simple XML elements and attributes are determined according to the schema, allowing typed values in templates.

When no XML Schema Definition is provided, data types are inferred automatically from string representations. The engine can recognize the following types:

• long?
• double?
• bool?
• DateTime?
• string

Note that automatic type recognition requires string representations to use invariant culture settings.

To override the default XML data loading behavior, initialize and pass a XmlDataLoadOptions instance to a constructor of this class.

The XmlDataSource type exposes the following members:

from groupdocs.assembly import DataSourceInfo, DocumentAssembler
from groupdocs.assembly.data import XmlDataSource

xml_data_source = XmlDataSource("staff-profile.xml")
assembler = DocumentAssembler()
assembler.assemble_document(
    "staff-profile.docx",
    "staff-profile-report.docx",
    DataSourceInfo(xml_data_source, "data")
)

Task guides that use XmlDataSource:

• GroupDocs.Assembly Engine APIs

• module groupdocs.assembly.data