xpmfetch
This retrieves data from the specified field within the XPM handle.
xpmfetch ?-warn var? xpmId field
Depending on the underlying record format, a single field string can imply multiple values. For example, an FRL field that is defined with multiple subfields.
This command returns a list of datum handles, one per value (subfields for FRL, subcomponents for HL7). If any warning messages are generated during the retrieval, then they are appended to var, if specified.
An error is returned if the field specification is invalid, with
respect to the record definition. An error is also returned if any item's value
cannot be retrieved. For example, not present in XPM handle data-state, or the
underlying message is too short to cover the field
.
field
is interpreted as an input value to an XPM
operation. Its leading character identifies which side of the translation the data
is retrieved from:
- @name: Temporary field name
- ~name: Output field name
- name: Input field name