Command GATHER NAME Foundation
Replaces data in the current record with data in a DataObject.
GATHER NAME <oData> [FIELDS <FieldNameList>] [IN <nWorkArea>|<cAlias>] GATHER NAME <oData> FIELDS EXCEPT <SkeletonList> [IN <nWorkArea>|<cAlias>] GATHER NAME <oData> FIELDS LIKE <SkeletonList> [EXCEPT <SkeletonList>] [IN <nWorkArea>|<cAlias>]
The command GATHER NAME tries to transfer all data from a DataObject to the current record of a work area. <oData> must have exported members with the same name as the fields in the work area. If no such member exists, no replace occurs and the record remains unchanged.
The FIELDS, FIELD EXCEPT and FIELD LIKE arguments can be used to qualify the fields to be changed by the operation. In this case, only the values in the specified fields are replaced provided a corresponding member variable exists in the data object.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.