9.56 DOM_ADD_FIELD
Þ Note: Built-In Function Rules.
Adds a field to an open data note using the field name. The field type must also be specified.
The field types supported are the simple data types TYPE_TEXT, TYPE_NUMBER, TYPE_TIME and TYPE_TEXT_LIST as these are the closest types to the standard LANSA data types A (Alphanumeric), P (Packed) and S (Signed). The data will be converted to the required field type and from EBCDIC to LMBCS for TYPE_TEXT, TYPE_DATE and TYPE_TEXT_LIST fields.
Either an alphanumeric field value or numeric field value should be specified to create the new field. For a TYPE_TIME field, the alphanumeric value may be specified as '*CURRENT', in which case the current date and time will be set for the field otherwise the date/time value must be supplied in the correct format e.g. mm/dd/yy hh:mm:ss. For a TYPE_TEXT_LIST field, the value will be added to the existing field if the text list field already exists.
Note that the document/data note is not updated in the database until you use the DOM_UPDATE_DOCUMENT Built-In Function.
For use with
|
Arguments
|
Return Values
|
Example
Refer to this Domino Built-In Function Example:
Example 1: Creating a New Document in a Database
Technical Notes
This Built-In Function uses the standard Lotus Notes APIs NSFFieldSetNumber, NSFFieldSetText, ConvertTextToTIMEDATE, NSFFieldSetTime and NSFFieldAppendTextList. All security and integrity issues related to the use of this Built-In Function are according to normal Lotus Notes API use for the current platform.