Invoke option - Output tab

Invoke other program option

This option is not available with Capture Pro Limited Edition.

The Invoke Other Program option on the Output tab allows you to use an application other than the software to make changes to your output. Select the checkbox to enable this option.

Program Name — enter the application name. If needed, click Browse to search for the application.

Parameters — parameters can be any combination of literal text strings and variable values which are determined at the time a batch is output. Variable values are defined by clicking Select.

Literal text strings can be typed into the Parameters text box or in the Parameter formula window of the Parameter Setup dialog box. Literal strings should be separated by spaces. Literal strings which include spaces should be enclosed in double quotes.

To add a variable parameter:

Click Select to display the Parameter Setup dialog box to setup variable parameters.
Select the parameter you want to add from the list of Available parameters.
Click Add Item.

You can also enter literal strings in the Parameter Formula dialog box. Variable parameters are added to the formula enclosed in <> marks (e.g. <BATCH_NAME>).

When the batch is output, the actual value will be substituted and the value passed as a parameter.

For example, the parameter formula <BATCH_NAME> one two "three four" produces the following four parameters:

/BATCH_NAME=Batch99999

one

two

three four

Omit “/tagname=” identifiers on parameters — by default, parameters will be passed to the invoked application preceded by a string of the form /tagname= where tagname identifies the parameter type (e.g. /BATCH_NAME=Batch001). Selecting this option will omit this identifier and the program will have to know the number and sequence of passed parameters in order to interpret them properly.

For example, if Omit “/tagname=” identifiers on parameters was selected the formula: <BATCH_NAME> one two "three four" would produce the following parameters:

Batch99999

one

two

three four

Create output file and send its path as parameter — selecting this option generates an XML file which contains the parameters. The path to this file will be passed to the invoked program as the only parameter.

Location — click Setup to specify the path formula and file name for the output file.

In the XML file, string literals will be in a PARAM_LIST element which contains one PARAM element per literal.

Variable parameters will be contained in elements which identify the parameter type (like <BATCH_NAME>).

A schema file KCCustomApplication.xsd can be used to validate resultant XML files and as a reference during code development.

For example, the location and file name formula <EXPORT_PATH>"\"<BATCH_NAME>"\" and Parameters.XML generated the parameter C:\BatchesPro\Batch001033841\Parameters.XML.

The Parameters.XML file had the following content:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>

- <KCCustomApplication xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="KCCustomApplication.xsd">

- <PARAM_LIST>

<PARAM>three four</PARAM>

</PARAM_LIST>

<BATCH_NAME>Batch001033841</BATCH_NAME>

</KCCustomApplication>