Features Overview Leave feedback

GroupDocs.Assembly for Python via .NET generates reports from templates. A template is an ordinary document of one of the supported formats whose text holds tags such as <<[customer.Name]>> or <<foreach [o in orders]>>. Every task follows the same workflow: prepare the data, wrap each data source in a DataSourceInfo with the name the template uses, and call DocumentAssembler.assemble_document() with the template and the report to write.

Fill a template with:

• Python data: dicts, lists, numbers, strings, dates and Decimal values, as they are. A dict’s keys are read as members (customer.Name), a list is a collection to iterate. See Generate from custom objects and The Business Layer.
• JSON, XML and CSV files through JsonDataSource, XmlDataSource and CsvDataSource, which recognize numbers, booleans and dates in the text. See Working with simple data sources.
• The tables of other documents: a table of a Word document or a presentation, or a worksheet, as a DocumentTable, and several related tables of one document as a DocumentTableSet. See Using documents as data source.
• Database rows, turned into dicts in Python. See Generate from a database.
• Several sources in one report, each under its own name. See Working with multiple data sources.

Expressions in tags use a subset of C# syntax that works on any data source: arithmetic, comparisons, string operations, the Sum, Count, Average, Where, OrderBy, GroupBy and other sequence operations, and conditional expressions. Format numbers, dates and text in the tag itself, declare variables, and leave comments in a template. See Template syntax - part 1, part 2, Basic template syntax and Enumeration extension methods.

• Tables: a row per item, with totals, grouping, filtering and ordering, master-detail tables, highlighted rows, alternate content for empty data, merged cells. See Working with table reports and Generate tables from a collection.
• Lists: bulleted, numbered and multicolored numbered lists, and lists inside a paragraph. See Generate bullet lists and Generate numbered lists.
• Charts: pie, bubble, scatter and column charts whose series, points, colors and titles come from the data. See Working with chart reports: pie and Working with chart series coloring.
• Images and barcodes: pictures named by the data, and barcodes generated from it. See Inserting images dynamically and Working with barcode image generation.
• Hyperlinks, bookmarks, check boxes and other documents: links and bookmarks built from data, check box and drop-down values, and whole documents inserted into the report. See Inserting hyperlinks or bookmarks, Set checkbox values dynamically and Inserting documents dynamically.
• Email messages: MSG and EML templates whose sender, recipients, subject and body come from the data. See Generate email messages.

Templates and reports can be Word processing documents, spreadsheets, presentations, OpenDocument files, emails, HTML, Markdown and plain text. A report is saved in the format of its file extension, or of the format you name with LoadSaveOptions, so a Word template can give a PDF or HTML report. See Supported document formats, Changing target file format and Using Markdown documents.

• Update fields and recalculate formulas while assembling: see Updating fields and Calculate formulas.
• Remove the paragraphs that end up empty: see Removing empty paragraphs.
• Write template errors into the report instead of raising: see In-line syntax error messages.
• Allow members the data does not have (DocumentAssemblyOptions.ALLOW_MISSING_MEMBERS).

Read templates from files or streams and write reports to files or streams, resolve the pictures of an HTML template from a folder of your choice, save an HTML report with its resources in a separate folder, and choose the OOXML compliance level of a Word report. See Streams vs. file paths, Loading and saving with external resource files and Specify OOXML compliance.