Specify Infobox Caller Entry Preprocessing
This command specifies pre-processing of entered infobox numbers. It controls only the pre-processing of numbers entered by the caller. Infobox numbers from $auto_call, menus, etc. are not affected.
The parameters on this command are used as follows:
|max||the maximum number of digits which can be keyed by the user as an infobox number. The default is 9 if this command is not used. By setting this value to a number bigger than the number of digits in your reference numbers, you allow the caller to key # after the digits to terminate entry. By setting this value to the sum of skip and use the entry will be terminated as soon as all the digits have been keyed.|
|skip||the number of leading keyed digits to skip. This allows you, for example, to ask for the full entry of prefixed numbers from a catalog, but to ignore the fixed-length prefix.|
|use||the maximum number of entered digits to use. Additional digits keyed by the user are discarded. This allows you, for example, to ask for the full entry of suffixed numbers from a catalog, but to ignore a variable-length suffix.|
|runcmd||this option has been disabled in version 7 and above. It allowed the specification of an operating system command which could be run to pre-process the entered infobox number and return a different number. If you have older applications which still need this capability, please contact Copia support.|
|lookup||this keyword can be entered in place of the run command. It signifies that the entered infobox number should be used as an index to look up a replacement number. The following three parameters specify the details of the lookup:|
|index||the full pathname of an NDX file to be used as an index file (with numeric key).|
|data||the full pathname of a DBF file containing the replacement infobox numbers.|
|field||the field name of the field in the DBF file which contains the replacement infobox numbers.|
To reference .DBF files which have Clipper or FoxPro indexes, use the data parameter to specify a '.DD' file with the same basename as the .DBF file. This .DD file will then contain the name of the index file, and the index parameter must be used to specify the name of the index tag in the specified index file.
If a lookup is specified, it does not take place immediately after the number is entered. Instead it takes place when the $image_locn directory with the special name lookup is encountered. If this is the only applicable $image_locn for the actual entered Infobox number then all entered numbers will be looked up. If an actual image file corresponding to the entered infobox number is encountered during the processing of an earlier $image_locn command, the lookup will be abandoned.
Default: entered infobox numbers are used as keyed
Transform entered numbers by looking up an alphabetic reference:
$infobox 9 0 8 lookup findit.ndx findit.dat newdoc
$image_locn 0 99999999 lookup
$image_locn A ZZZZZZZZ @FFBASE\images
Accept four-digit numbers immediately, and discard the first digit keyed:
$infobox 4 1 3