VDA Connector

VDA connectors support generating VDA documents from XML and converting VDA documents into XML.

Key Capabilities

German automotive EDI standard support with bidirectional VDA/XML translation
Automatic schema detection and validation with interchange header generation
Support for VDA-specific segment structures, nested loops, and qualifier expansion

Overview

When receiving VDA documents, VDA connectors validate interchange headers and convert the VDA document into XML. This is useful as a staging step, because XML is the primary format that Arc uses to manipulate data in a flow. The VDA connector automatically reads the input file to determine the appropriate schema, then parses the document according to this schema. When generating VDA documents, VDA connectors convert XML into VDA document syntax and apply the appropriate interchange headers. This is useful as the final step for creating a VDA document, after the XML data has been fetched and transformed elsewhere in the flow.

Connector Configuration

This section contains all of the configurable connector properties.

Settings Tab

Translation Configuration

Settings related to the core operation of the connector.

Setting	Description
Connector Id	The static, unique identifier for the connector.
Connector Type	Displays the connector name and a description of what it does.
Connector Description	An optional field to provide a free-form description of the connector and its role in the flow.
Translation Type	Whether the connector should convert VDA documents into XML, or generate VDA documents from XML.

Header Settings

Settings related to the VDA interchange headers. When converting documents into XML, the document headers are validated against these settings; when generating documents from XML, these settings are used to generate document headers.

Setting	Description
Sender Identifier	The unique Id identifying the sending party in the VDA communication (when generating a VDA document, this should be your identifier).
Receiver Identifier	The unique Id identifying the receiving party in the VDA communication (when generating a VDA document, this should be your partner’s identifier).

Sample Files Tab

Advanced Tab

EDI Delimiters

Settings that specify which characters separate elements, segments, and so on.

Setting	Description
Suffix	Appears at the end of segments to distinguish them from each other.

Advanced Settings

Settings not included in the previous categories.

Setting	Description
Batch Transactions	An exchange can contain multiple transactions. When this is not checked, the connector creates a separate output file for each transaction in the exchange. When checked, the connector groups all transactions into a single output file. Only applicable when the Translation Type is VDA to XML.
Encoding	Specifies the character encoding (such as ASCII or UTF-8).
Expand Qualifier Values	When checked, XML elements containing a VDA qualifier include child elements containing the qualifier code and value. For example: `<N101>` `<Code>ST</Code>` `<Value>Ship To</Value>` `</N101>`
Functional Acks	By default, all functional acknowledgments (997, 999) are routed to the connector selected in the flow diagram, and XML translations are not received in the Transactions tab. Check this to have the translated acknowledgment also be included in the Transactions tab. This allows functional acknowledgments to be integrated into a destination source in addition to new EDI documents.
Generate Description As	When translating VDA into XML, descriptions of the VDA segments and elements can be provided as context for the VDA data. Use this dropdown to choose whether to add this context as an XML comment or as XML attributes.
Local File Scheme	A scheme for assigning filenames to messages that are output by the connector. You can use macros in your filenames dynamically to include information such as identifiers and timestamps. For more information, see Macros.
Nest Loops	When checked, the connector detects VDA structures that have hierarchical relationships embedded in the VDA data, and generates XML with these hierarchical relationships represented as parent-child relationships.
Processing Delay	The amount of time (in seconds) by which the processing of files placed in the Transactions tab is delayed. This is a legacy setting. Best practice is to use a File connector to manage local file systems instead of this setting.
Strict Schema Validation	Whether the connector should Ignore, Warn, or Fail when the following are detected: repeat counts above the allowed number, missing required elements or segments, invalid qualifier and code values, disallowed element lengths, and invalid element values. Choosing Disable turns off the schema validation checks.
Upload Schema	Use this to upload a schema and install it in the connector’s Schema folder. If a schema already exists, you are asked if you want to overwrite it.
Reset State	EDI connectors keep track of control numbers that have been used and increment that number to ensure that future runs do not duplicate data. Use this button to reset the counter to its initial state without changing any of the configured settings.

Message

Message settings determine how the connector searches for messages and manages them after processing.

Note: The settings below are deprecated and hidden by default. They appear only on connectors where they were previously enabled or configured to a non-default value. To retain copies of successfully processed files, right-click the connector in the flow, choose Show Success Path, and connect the success path to a File connector.

Setting	Description
Save to Sent Folder (Deprecated)	Copies files processed by the connector to the Sent folder. Disabled by default. Files saved to the Sent folder are not covered by Encryption at Rest.
Sent Folder Scheme (Deprecated)	Groups files in the Sent folder by the selected time interval. Only relevant when Save to Sent Folder is enabled.

Logging

Settings that govern the creation and storage of logs.

Setting	Description
Log Level	The verbosity of logs generated by the connector. When you request support, set this to Debug.
Log Subfolder Scheme	Instructs the connector to group files in the Logs folder according to the selected interval. The Weekly option (which is the default) instructs the connector to create a new subfolder each week and store all logs for the week in that folder. Leaving this setting blank tells the connector to save all logs directly in the Logs folder. For connectors that process many transactions, using subfolders helps keep logs organized and improves performance.
Log Messages	Check this to have the log entry for a processed file include a copy of the file itself. If you disable this, you might not be able to download a copy of the file from the Transactions tab.

Miscellaneous

Miscellaneous settings are for specific use cases.

Setting	Description
Other Settings	Enables you to configure hidden connector settings in a semicolon-separated list (for example, `setting1=value1;setting2=value2`). Normal connector use cases and functionality should not require the use of these settings.

Automation Tab

Automation Settings

Settings related to the automatic processing of files by the connector.

Setting	Description
Send	A toggle that instructs the connector to automatically send files when they are ready.
Resend Interval	The interval the connector waits before resending a file that received a negative ACK. For example, if a trading partner receives the file but something is wrong with it and they send back a negative ACK, this setting specifies how long to wait before sending the file again.
Max Attempts (async)	The maximum number of times the connector processes the input file when a functional ACK is requested. Success is based on the return of a functional ACK within the Resend Interval. If a successful functional ACK is not returned, the connector resends the file until Max Attempts is reached. If this is set to 0, the connector resends the file indefinitely.

Performance

Settings related to the allocation of resources to the connector.

Setting	Description
Max Workers	The maximum number of worker threads consumed from the threadpool to process files on this connector. If set, this overrides the default setting on the Performance Settings portion of the Advanced Settings page.
Max Files	The maximum number of files sent by each thread assigned to the connector. If set, this overrides the default setting on the Performance Settings portion of the Advanced Settings page.

Alerts Tab

SLAs Tab

VDA to XML

When generating XML, set the Translation Type to VDA to XML. The connector then processes VDA files placed in the Transactions tab. The connector validates VDA message headers against the Sender Identifier and Receiver Identifier configured in the Header Settings. After validating the transmission, the VDA segments are converted into XML according to the schema specified in the message. The resulting XML files are placed in the connector’s Transactions tab.

XML to VDA

When generating VDA files, set the Translation Type to XML to VDA. The connector then processes XML files placed in the Transactions tab. The connector converts the XML elements representing a VDA file into VDA segments, then uses the Sender Identifier and Receiver Identifier fields configured in the Header Settings to generate the transmission headers. To create an example of the XML structure required to generate VDA documents, start with an example VDA document and send it through the VDA connector in VDA to XML mode. You can use the resulting XML as a template in the XML Map connector to convert XML structures into a VDA structure.

Getting Started

Flows

EDI Trading Partner Management Console

Connectors

Mapping

APIs and Automation

How-To Guides

Scripting

Software License and Third-Party Copyrights

Key Capabilities

Overview

Connector Configuration

Settings Tab

Translation Configuration

Header Settings

Sample Files Tab

Advanced Tab

EDI Delimiters

Advanced Settings

Message

Logging

Miscellaneous

Automation Tab

Automation Settings

Performance

Alerts Tab

SLAs Tab

VDA to XML

XML to VDA

Use With the XML Map Connector

Upload Test File

Macros

Examples

​Key Capabilities

​Overview

​Connector Configuration

​Settings Tab

​Translation Configuration

​Header Settings

​Sample Files Tab

​Advanced Tab

​EDI Delimiters

​Advanced Settings

​Message

​Logging

​Miscellaneous

​Automation Tab

​Automation Settings

​Performance

​Alerts Tab

​SLAs Tab

​VDA to XML

​XML to VDA

​Use With the XML Map Connector

​Upload Test File

​Macros

​Examples

Key Capabilities

Overview

Connector Configuration

Settings Tab

Translation Configuration

Header Settings

Sample Files Tab

Advanced Tab

EDI Delimiters

Advanced Settings

Message

Logging

Miscellaneous

Automation Tab

Automation Settings

Performance

Alerts Tab

SLAs Tab

VDA to XML

XML to VDA

Use With the XML Map Connector

Upload Test File

Macros

Examples