VLDFILEX

Usage

TIBCO iProcess Workspace (Windows)

Warning: (iProcess only) This expression is not available to the TIBCO iProcess Script Server Plug-in. Therefore, even though you can successfully enter the expression in your iProcess Script plug-in definition, it will not be processed by the iProcess Engine. It will return SW_NA.

Adds each line from a text file to the list of validations to be used on the current field. Only relevant when in the validations Values column; ignored elsewhere.

Syntax

VLDFILEX (file, location, limit, format, charset)

where:

• file is a text string specifying the name of the text file containing the validations; either the full pathname, or a simple filename in the directory specified by the location parameter. (In the latter case the filename will be case sensitive.)
Note: A simple filename may be a maximum of 12 characters, and a full pathname 255 characters.
• location is a numeric value specifying the directory where the file is located IF file is a simple filename:

Value

Directory

0

Central SWDIR\lists directory

1

User’s SWDIR\queues\username directory
• limit is a numeric value specifying the maximum number of validations to add to the validations list (subject to the overall limit specified by the MAXVLD entry in the SWDIR\etc\staffcfg file, or 1000 if there is no such entry).
• format is a numeric value specifying the format of the file. This is not currently implemented.

Value

File format

0

UNIX

1

DOS

This affects line terminator characters.

• charset is a numeric value specifying the character set of file:

Value

Character set

0

SICS (iProcess Internal Character Set)

1

EUC (UNIX) Kanji

2

Shift-JIS (MS-Windows) Kanji

3

Unicode

Returns

The number of validations added to the validations list - not normally used.

Note: The list is created when the form is first displayed, and cannot be regenerated while the form is open.