@GetField (Formula Language)

Returns the value of a specified field.

Note: This @function is new with Release 6.

Syntax

@GetField ( fieldName )

Parameters

fieldName

Text. The name of a field in the current document.

Return value

value

The value of the specified field.

Usage

This @function returns null if the field does not exist.

This @function is useful in writing portable code and in other instances where you want to vary the name of the field.

This function returns the complete field value, including all values if the field is multivalued, or the rich text value if it is a rich text field.

Examples

  1. This code, when added to a computed field on a form and accessed on the Web or in Notes®, displays Hello if "Hello" is the default value of the greeting field.
    @GetField("greeting")
  2. This computed field formula multiplies values from two fields. The fields are named by adding suffixes to the name of the current field.
    @GetField(@ThisName + "_Quantity") * @GetField(@ThisName + "_Cost")

Language cross-reference

FieldGetText method of LotusScript® NotesUIDocument class

GetItemValue method of LotusScript® NotesDocument class

getItemValue method of Java Document class