Fast loader repeated tokens

When you create a LoaderControlFileTemplate or a LoaderControlFileTemplateForAppend, a list of special tokens is repeated once for each field in the outbound table.

The available tokens are described in the following table.

Table 1. Fast loader repeated tokens

Token

Description

<CONTROLFILE>

This token is replaced with the full path and file name to the temporary control file that Unica Campaign generates according to the template that is specified in the LoaderControlFileTemplate parameter.

<DSN>

This token is replaced with the value of the DSN property. If the DSN property is not set, the <DSN> token is replaced by the data source name used in the category name for this data source (the same value used to replace the <DATABASE> token).

<DATABASE>

This token is replaced with the name of the data source that Unica Campaign is loading data into. This is the same data source name used in the category name for this data source.

<DATAFILE>

This token is replaced with the full path and file name to the temporary data file created by Unica Campaign during the loading process. This file is in the Unica Campaign Temp directory, UNICA_ACTMPDIR.

<NUMFIELDS>

This token is replaced with the number of fields in the table.

<PASSWORD>

This token is replaced with the database password from the current flowchart connection to the data source.

<TABLE>

This token is obsolete, but is supported for backward compatibility. See <TABLENAME>, which replaced <TABLE> as of version 4.6.3.

<TABLENAME>

This token is replaced with the database table name that Unica Campaign is loading data into. This is the target table from your Snapshot process or the name of the Temp Table being created by Unica Campaign.

<USER>

This token is replaced with the database user from the current flowchart connection to the data source.

In addition to these special tokens, every line includes other characters. To include a single character on every line except the last line, the character can be enclosed within angle brackets. You can enclose only a single character between the angle bracket (< >) characters for this functionality.

This is commonly used to separate the list of fields with a comma. For example, the following syntax generates a comma-separated list of field names:

<FIELDNAME><,>

The angle bracket (< >) characters around the comma indicate that the comma should be present on every line, after every inserted field name, except the last.

If any sequence of characters does not fit this requirement, it is repeated every time, including the last. So for example, to generate a parenthesized, comma-separated list of field names in which each field name is preceded by a colon, you can use the following syntax:

(
	:<FIELDNAME><,>
	)

Because the colon is not enclosed within angle bracket (< >) characters, it repeats for every line; however, the comma appears on every line except the last. It might produce output as follows:

(
	:FirstName,
	:LastName,
	:Address,
	:City,
	:State,
	:ZIP
	)

Note that the comma does not appear after the last field name (ZIP), yet the colon appears before every field name.