Table of Contents

Exporting reports

List & Label Cross Platform (LLCP) supports multiple export targets for server-side and automated reporting workflows.

Use ExportConfiguration together with LlExportTarget to select the output format and destination.

Available export formats

The following targets are currently available:

Format Target Output Package
PDF Pdf .pdf combit.ListLabel32.CrossPlatform
PDF (enhanced engine) PdfEnhanced .pdf combit.ListLabel32.CrossPlatform
JSON Json .json combit.ListLabel32.CrossPlatform
CSV Csv .csv combit.ListLabel32.CrossPlatform
PNG Png .png combit.ListLabel32.CrossPlatform
JPEG Jpeg .jpeg combit.ListLabel32.CrossPlatform
SVG Svg .svg combit.ListLabel32.CrossPlatform
Excel (OpenXML) Xlsx .xlsx combit.ListLabel32.CrossPlatform.Export.OpenXml
Word (OpenXML) Docx .docx combit.ListLabel32.CrossPlatform.Export.OpenXml
HTML Html .html combit.ListLabel32.CrossPlatform.Export.Html
Note

The core package covers PDF, JSON, CSV, and image exports.
PdfEnhanced produces a .pdf document through the enhanced PDF engine, which additionally supports PDF/A conformance, encryption and embedded e-invoices. It requires a native library to be deployed - see PDF export.
Excel export (Xlsx) and Word export (Docx) are provided separately through the OpenXml package. HTML export is provided separately through Html package.

Installing export packages

Install the core package:

dotnet add package combit.ListLabel32.CrossPlatform

Install the OpenXml export package when you need Xlsx or Docx output:

dotnet add package combit.ListLabel32.CrossPlatform.Export.OpenXml

Add the separate HTML exporter package when you need Html output:

dotnet add package combit.ListLabel32.CrossPlatform.Export.Html
Warning

If an export target provided by a separate export package is used without that package or assembly, the corresponding export is not available at runtime.

Basic export example

using combit.Reporting;

ListLabel listLabel = new ListLabel
{
    DataSource = GetDataSource(),
    AutoProjectFile = "reports/invoice.json",
    LicensingInfo = "..."
};

ExportConfiguration exportConfiguration = new ExportConfiguration(
    LlExportTarget.Pdf,
    "output/invoice.pdf",
    listLabel.AutoProjectFile);

listLabel.Export(exportConfiguration);

Export to specific formats

Use the same pattern and switch only the target and output file:

new ExportConfiguration(LlExportTarget.PdfEnhanced, "output/invoice.pdf", projectFile);
new ExportConfiguration(LlExportTarget.Json, "output/report.json", projectFile);
new ExportConfiguration(LlExportTarget.Csv, "output/report.csv", projectFile);
new ExportConfiguration(LlExportTarget.Png, "output/report.png", projectFile);
new ExportConfiguration(LlExportTarget.Xlsx, "output/report.xlsx", projectFile);
new ExportConfiguration(LlExportTarget.Docx, "output/report.docx", projectFile);
new ExportConfiguration(LlExportTarget.Html, "output/report.html", projectFile);

Choosing the right format

Use case Recommended format
Printable document exchange PDF
Archival (PDF/A), encrypted PDF, e-invoices PDF via PdfEnhanced
Structured data exchange JSON
Spreadsheet-style tabular export CSV or XLSX
Editable word processing document DOCX
Visual snapshots or previews PNG or JPEG
Scalable vector output SVG
Browser-based, accessible report output HTML

Setting export options

Format-specific behavior is controlled through ExportConfiguration.ExportOptions. Option values are stored as strings, regardless of whether they represent booleans, numbers, or text:

ExportConfiguration exportConfiguration = new ExportConfiguration(
    LlExportTarget.Xlsx,
    "output/report.xlsx",
    projectFile);

exportConfiguration.ExportOptions[LlExportOption.XlsAllPagesOneSheet] = "1";
exportConfiguration.ExportOptions[LlExportOption.XlsShowGridlines] = "0";

listLabel.Export(exportConfiguration);
Note

Boolean-style options use the string values "0" and "1". Options that are not set fall back to the documented default.

Tip

Options that are not listed for a given format are silently ignored by that exporter. Setting, for example, an XLSX-specific option for a PDF export has no effect.

Format-specific options and restrictions

Each export target supports its own subset of LlExportOption values and has format-specific limitations. See the dedicated pages for details: