Use XSL Templates to Transform Action Responses

You can transform the action responses returned by Connector Framework Server using XSL templates. You must write your own XSL templates and save them with either an .xsl or .tmpl file extension.

After creating the templates, you must configure Connector Framework Server to use them, and then apply them to the relevant actions.

To enable XSL transformations

  1. Ensure that the autnxslt library is located in the same directory as Connector Framework Server. If the library is not included in your installation, you can obtain it from OpenText Support.
  2. Open the Connector Framework Server configuration file in a text editor.
  3. In the [Server] section, ensure that the XSLTemplates parameter is set to true.

    CAUTION: If XSLTemplates is set to true and the autnxslt library is not present in the same directory as the configuration file, the server will not start.

  4. (Optional) In the [Paths] section, set the TemplateDirectory parameter to the path to the directory that contains your XSL templates. The default directory is acitemplates.
  5. Save and close the configuration file.
  6. Restart Connector Framework Server for your changes to take effect.

To apply a template to action output

  • Add the following parameters to the action:

    Template The name of the template to use to transform the action output. Exclude the folder path and file extension.
    ForceTemplateRefresh (Optional) If you modified the template after the server started, set this parameter to true to force the ACI server to reload the template from disk rather than from the cache.

    For example:

    action=QueueInfo&QueueName=Ingest
                    &QueueAction=GetStatus
                    &Token=...
                    &Template=myTemplate

    In this example, Connector Framework Server applies the XSL template myTemplate to the response from an Ingest action.

    NOTE: If the action returns an error response, Connector Framework Server does not apply the XSL template.

Example XSL Templates

Connector Framework Server includes the following sample XSL templates, in the acitemplates folder:

XSL Template Description
LuaDebug Transforms the output from the LuaDebug action, to assist with debugging Lua scripts.