Copyright © Cloud Software Group, Inc. All Rights Reserved

abox Files

These are ASCII text files that certain integration options use to pass data to iProcess. The data is used to update field values in the current case of the procedure - see Externally Updating Field Data in a Case for more information.

To change the value of a field in a main procedure, the file should contain lines consisting of the name of the field, followed by a comma, followed by the data. For example:

    CUST_BALANCE,400.10

However, the abox file format enables you to be more precise in what field you update - for example, you might want to update a field value in a sub-case without changing the field value in the parent case or update a field within a composite field. The following table describes the possible formats you can use in the abox file and what is updated:

Abox Syntax	Description
FIELDNAME, new_value	Sets FIELDNAME to the value supplied as new_value.
FIELDNAME:FIELD1, new_value	Sets FIELD1 in the composite field of FIELDNAME to the value supplied as new_value.
SUBCALL | FIELD, new_value	Sets the value of FIELD in the sub-procedure called from the SUBCALL step name to the value supplied as new_value.
SUBCALL | $IPn, new_value	Sets the value of the field mapped to the $IPn parameter in the sub-procedure called from the SUBCALL step to the value supplied as new_value. Note: You can get the name for a parameter ($IPn) by looking at the sub-procedure Input mapping dialog.
DYNCALL[index] | $IPTn, new_value	Sets the field mapped to the $IPTn parameter in a sub-case started from a dynamic sub-procedure call to the value supplied in new_value. The index is used to determine which sub-case is affected e.g. if index is 10 the tenth sub-case started would have its field updated. Note: You can get the name for the parameter ($IPTn) by looking at the dynamic sub-procedure Input mapping dialog.
DYNCALL[index] | FIELD, new_value	Sets FIELD in a sub-case started from a the dynamic sub-procedure call step name of DYNCALL to the value supplied in new_value. The index is used to determine which sub-case to update.

For example, the following are valid entries in an abox file:

   CUST_NAME,Algernon Fitzpatrick
   CUST_BALANCE,400.10
   SUB1|CUST:POSTCODE,SN1 6EN
   SUB1|SUB2|ACCOUNT_NAME,Jefferson
   DYNCALL[10]|NAME, Paul
   SUBCALL|$IP1, Patrick

If there is no text after the comma, the field is set to SW_NA (unless it is a TEXT field, in which case it is set to blank but assigned). Fields can also be set to SW_NA by putting the text “SW_NA” after the comma - for example:

   FIELD,SW_NA

Note that:

•	Text data is NOT enclosed in quote marks

•	Delimiters are NOT used for date or time data – just enter the figures with the appropriate separators, e.g. DD/MM/YYYY for dates and HH:MM for times.

•	Dates should always be provided with a full 4 digit year specification.

•	For a memo field, the value is the pathname of a text file containing the memo text.

Copyright © Cloud Software Group, Inc. All Rights Reserved