Skip to main content
Feedback

Grenefolc Vartala Ausa — Partner connector operation

The Ausa operation configures data extraction behavior via two primary inputs: the CLI JSON and the XPath JSON.

Options tab

CLI JSON

The CLI JSON controls extraction behavior and diagnostic output during connector execution.

Default configuration:

{
"cli": {
"showProcessTrace": false,
"extractionMode": "value",
"delimiterChar": "|",
"errorOnNullSource": false
}
}
PropertyTypeDefaultDescription
cli.showProcessTraceBooleanfalseEnables process trace output.
cli.extractionModeStringvalueControls what is extracted from each path. See extraction modes below.
cli.delimiterCharString|Delimiter character used in delimited extraction mode.
cli.releaseCharStringEscape character. Required when using delimited mode.
cli.errorOnNullSourceBooleanfalseWhen true, fails execution if the source document is empty.

Extraction modes (cli.extractionMode):

ValueXML behaviorJSON behavior
valueExtracts node text or valueExtracts property value
entityReturns the complete XML fragmentReturns the complete JSON object or array
nameReturns the local element nameNot supported
qnameReturns the qualified element name (including namespace prefix)Not supported
delimitedFlattens all leaf values into a delimited stringFlattens all leaf values into a delimited string

XPath JSON

The XPath JSON is the primary extraction configuration. It defines which fields to extract and which DDPs to publish the results to.

Minimum configuration:

{
"pathMap": {
"ddp_customerNumber": "/Order/Header/CustomerNumber",
"ddp_orderNumber": "/Order/Header/OrderNumber"
}
}

The pathMap section is required and must contain at least one key-value mapping. Each key is the DDP name to publish; each value is the extraction path.

Source override

By default, Ausa extracts data from the current document in the process. To extract from a DDP instead, specify a source field:

{
"source": "ddp_semanticXml",
"pathMap": {
"ddp_messageType": "/Message/Header/MessageType"
}
}

Ausa reads the contents of the named DDP and performs extraction against that data source.

XML extraction

Ausa supports namespace-aware XPath processing automatically. No additional namespace configuration is required.

Example:

{
"pathMap": {
"ddp_messageClass": "/Invoice/Header/MessageClass",
"ddp_supplier": "/Invoice/Supplier/Name"
}
}

JSON extraction

Ausa supports two JSON path syntaxes interchangeably.

Native JSONPath:

{
"pathMap": {
"ddp_messageClass": "$['invoice'][0]['messageClass']"
}
}

Slash path:

{
"pathMap": {
"ddp_messageClass": "/invoice[1]/messageClass"
}
}

Concatenation

Ausa can generate composite DDP values by concatenating multiple extracted values. Concatenation is processed after all extraction operations complete.

Example:

{
"pathMap": {
"ddp_firstName": "/person/firstName",
"ddp_lastName": "/person/lastName"
},
"concat": {
"ddp_fullName": [
"%ddp_firstName;",
" ",
"%ddp_lastName;"
]
}
}

Result: John Smith

Reference extracted DDPs using the %ddp_name; token syntax within the concat array.

Dynamic Document Properties

Ausa publishes the following Dynamic Document Properties (DDPs) during execution, in addition to any user-defined DDPs configured in the pathMap.

PropertyDescription
ddp_ausa_statusCodeExecution status code. 1 = success, 0 = failure.
ddp_ausa_statusResponseExecution status text. Values: success or error. Use in downstream decision logic.
ddp_ausa_logJsonComplete execution log including configuration source information, runtime warnings, validation failures, and execution status. Intended for troubleshooting and support.
On this Page