XML Transform

Applies an XSLT transform to XML data associated with a Grooper document.

Remarks

XmlTransform enables the transformation of XML data within a Grooper document using a user-supplied XSLT stylesheet.

Purpose and Use Cases

• Convert XML data into different XML schemas for interoperability.
• Generate human-readable formats (such as HTML) from XML for reporting or review.
• Prepare XML for downstream integration, export, or ingestion by other systems (including AI knowledge bases).
• Normalize or restructure XML from various sources to a standard schema.

Supported Standards

• Only XSLT 1.0 is supported.
• Input must be well-formed XML.
• Output format (XML, HTML, or text) is determined by the xsl:output element in the XSLT.

Input Options

The XML source can be selected from:

• Index data (serialized as XML) for the document.
• Index data for the document and its ancestors.
• The document's primary attachment (if it is an XML file).
• A custom file attached to the document.

Use the Source and InputFilename properties to control the input selection.

Output Options

The result of the transformation can be:

• Saved as a new file attached to the document.
• Used to replace the document's primary attachment.
• Stored in the document's index data.
• Appended or prepended as a child document.

Use the Target and OutputFilename properties to control the output destination.

Namespace Handling

• Namespace prefixes can be mapped using the NamespaceMappings property.
• This allows the XSLT to reference XML elements and attributes in different namespaces.

Customization

• The Transform property accepts any valid XSLT 1.0 stylesheet.
• The built-in editor provides syntax highlighting and code completion for XSLT.

Example Scenarios

• Transforming extracted index data into a custom XML or HTML report.
• Normalizing XML from various sources to a standard schema for export or integration.
• Generating knowledge base articles or documents from structured XML for AI Assistant ingestion.

Considerations

• Only XSLT 1.0 features are supported; XSLT 2.0/3.0 constructs are not available.
• Errors in the XSLT or input XML will result in task failure; error messages include line and position information for troubleshooting.
• Performance may be affected by the size of the XML and complexity of the XSLT.

Properties

Used By

Batch Process StepProcessing JobBatch Object - Run ActivityExecute Activity