Text tracking

Text Reference

Use the Edit Text Reference dialog box to enter a unique description describing this reference, specify whether you want to track this reference on inbound transfers, outbound transfers or both, and specify tracking inclusions.

Text Configuration
Description
A unique description of this reference.
Extract data on inbound transfers
Extract data on outbound transfers
Select these check boxes to track this reference on inbound and outbound transfers, respectively. You can select either or both.
Tracking Inclusions
Unlike EDI and XML tracking, where you can optionally specify items to be excluded from tracking, for text tracking, you specify items you want included in tracking. You must specify at least one inclusion. Also, unlike EDI and XML, where the exclusions are specified at global level, for text tracking, inclusions are specified for each individual reference.
Click Edit Inclusions to display a list where you can choose inclusions as follows:
  • Include all production trading partner connections
  • Include specific trading partner connections - Select items from the list that correspond to the trading partners you want to include in tracking.
  • Include specific folders - Select items from the list that correspond to the folders you want to include intracking.
  • Include specific hosts\mailboxes\actions - Select items from the list that correspond to the hosts, mailboxes, or actions you want to include in tracking.
Only track files named
Select the check box and specify a filename to which you want to limit tracking. You can use regular expressions and wildcards to specify a filename.
Lines
Within the Lines container:
  • enter a Fixed line length or a Variable line delimiter.  Line delimiters cam be either a single character or '\n' (newline) or '\\' (backslash).
  • optionally specify Number of header lines to skip before parsing.
Fields

Within the Fields container

Choose whether fields will specified by character position (Positional (n:m)) or by field number (Delimited by).  When fields are separated by a delimiter, the delimiter character may be either a single character or '\t' (tab).

Identifier Data

Unlike EDI, where the identifier data is automatically tracked when EDI tracking is engaged, for text you must specify the text fields you want to track.  Right-click a row in the Identifier Data table and select Edit to display a dialog box where you can enter information about the data to extract. Use the following fields to enter this information:

Extract Field
Enter information about the field in one of the following ways:
either or a string literal enclosed in two quotation marks.
  • Using proper syntax for field specification - For positional fields, you must enter a string of the form n:m where m must be greater than or equal to n.  For delimited fields, you must enter a single number.  In all cases, whether you specify positional or delimited fields, all positions are one-based.  That is, the first field or character of a line is specified as 1 and not 0.
  • Using a string literal enclosed in two quotation marks - If you key in a string literal, the other fields in the dialog box are disabled.  This is because the tracking software merely passes the literal straight through for storage in the database.
only on line number
Select the radio button and specify the line number from which to extract the data. You cannot select both this radio button and the only if field radio button.
only if field
Select the radio button and specify criteria to select the field from which to extract the data. You cannot select both this radio button and the only on line number radio button.

Extract Transactional Reference

The Extract Transactional Reference dialog box is displayed when you select an item to edit or you click New in the Transactional Data table. Edit or populate the following fields:
Extract field
Identify a field you want to track.
only on line number
Select the radio button and specify the line number from which to extract the data. You cannot select both this radio button and the only if field radio button.
only if field
Select the radio button and specify criteria to select the field from which to extract the data. You cannot select both this radio button and the only on line number radio button.
Storage Location for Extracted Data
Specify where to store the collected reference data. Each reference collected will be separated by commas, and optionally preceded by the label, when it is displayed through the View Information right-click option under transfer reporting.
Reference 1
Reference2
Select the reference in which to store the data.
Reference Label
Optional - a label for the reference.