9.68 DOM_GET_ITEM
Þ Note: Built-In Function Rules.
Gets an item from an open data note using the item name. Either an alphanumeric field value or numeric field value will be returned for the item according to the item type.
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 from the required item type and from LMBCS to EBCDIC for TYPE_TEXT, TYPE_TIME and TYPE_TEXT_LIST items.
For a TYPE_TEXT_LIST item, an entry position must be specified with a value of 0 being for the first entry in the test list item. The return code is set to "NF" when the entry position requested is greater than the number of entries in the text list item.
If an item type of TYPE_TEXT is specified as an argument but the actual item type in the document is TYPE_TEXT_LIST, the first entry in the text list item will be returned by default with no error.
For use with
|
Arguments
|
Return Values
|
Example
Refer to these Domino Built-In Function Examples:
Example 2: Selecting documents from a Database using a view
Example 4: Updating Documents selected from a Browselist
Technical Notes
This Built-In Function uses the standard Lotus Notes APIs NSFItemIsPresent, NSFItemInfo, NSFItemGetNumber, NSFItemGetText, ConvertTIMEDATEToText, NSFItemGetTime, NSFItemGetTextListEntries and NSFItemGetTextListEntry. 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.