9.76 DOM_UPDATE_ITEM
Þ Note: Built-In Function Rules.
Updates an existing item to an open data note using the item name. The item type must also be specified. If the item does not exist it will be added to the document.
The item 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 item type and from EBCDIC to LMBCS for TYPE_TEXT, TYPE_DATE and TYPE_TEXT_LIST items.
Either an alphanumeric field value or numeric field value should be specified to update the specified item. For a TYPE_TIME item, the alphanumeric value may be specified as '*CURRENT', in which case the current date and time will be set for the item 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 item, the value will be added to the existing item if the text list item 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 4: Updating Documents selected from a Browselist
Technical Notes
This Built-In Function uses the standard Lotus Notes APIs NSFItemSetNumber, NSFItemSetText, ConvertTextToTIMEDATE, NSFItemSetTime and NSFItemAppendTextList. 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.