XSLT Connector

Version 23.3.8698


XSLT Connector


The XSLT connector provides support for Extensible Stylesheet Transformation (XSLT 1.0) transforms.

Overview

After an XSLT file has been uploaded to the connector, XML files arriving at the connector are automatically converted based on the XLST definition.

Connector Configuration

This section contains all of the configurable connector properties.

Settings Tab

Connector Settings

Settings related to the core operation of the connector.

  • 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.
  • XSL Template File The XSLT file that defines the XML transformation to be performed by the connector.

Other Settings

Settings not included in the previous categories.

  • Document Function Check this to allow use of the document() function while processing XSLT.
  • Embedded Scripts Check this to allow use of embedded scripts while processing XSLT.
  • Local File Scheme A scheme for assigning filenames to messages that are output by the connector. You can use the following macros to reference contextual information:
    %ConnectorId%, %Filename%, %FilenameNoExt%, %Ext%, %ShortDate%, %LongDate%, %RegexFilename%, %DateFormat%, %Header%.
    For example: %FilenameNoExt%_%ShortDate%%Ext%
  • Processing Delay The amount of time (in seconds) by which the processing of files placed in the Input folder is delayed. This is a legacy setting. Best practice is to use a File connector to manage local file systems instead of this setting.

Message

Message settings determine how the connector searches for messages and manages them after processing. You can save messages to your Sent folder or you can group them based on a Sent folder scheme, as described below.

  • Save to Sent Folder A toggle that instructs the connector to keep a copy of sent messages in the Sent folder.
  • Sent Folder Scheme Instructs the connector to group files in the Sent folder according to the selected interval. For example, the Weekly option instructs the connector to create a new subfolder each week and store all sent files for the week in that folder. The blank setting instructs the connector to save all files directly in the Sent folder. For connectors that process many transactions, using subfolders can help keep files organized and improve performance.

Logging

  • 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. For example, the Weekly option instructs the connector to create a new subfolder each week and store all logs for the week in that folder. The blank setting 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 Input or Output tabs.

Miscellaneous

Miscellaneous settings are for specific use cases.

  • 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.

  • Send Whether messages arriving at the connector are automatically processed.

Performance

Settings related to the allocation of resources to the connector.

  • 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 Settings > Automation 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 Settings > Automation page.

XSLT Operations

In addition to the Operations provided with Arc, connectors can provide operations that extend functionality into ArcScript. The operation specific to the functionality of the XSLT connector is described below.

xsltTranslate

Translates an input XML file according to a configured XSLT connector or a specified XSLT file.

Required Parameters

  • ConnectorId: The name of the configured XSLT connector to use for translation
    OR
  • TemplateFile: The path to the XSL template to use for translation
    OR
  • Data: The contents of the XSL template to use for translation

  • File: The input file to translate

Optional Parameters

  • OutputEncoding: By default, the operation outputs ASCII data. To output base64-encoded binary data instead, set this parameter to base64.
  • OutputFile: When this is set, output data is not written to the Data output attribute and is instead written to the specified file.

Output Attributes

  • Data: The output from the translation is passed through this parameter.