copy field by name(variable/result a)
|
Group |
Returns the value of the source structure field whose name is given by parameter a.
Important note: Only source structure fields in the same context can be resolved (always use options relative path and normal data mapper)!
Note: The value of a variable that has not been created can also be read with this function. See examples below.
Description of Parameters
|
Parameter |
Description |
|
a |
Name of the variable or the number of the function result containing the field name. See examples below. |
Examples
Given is a source structure field with the name sourcefield, which has the assigned value 4711.
The variable var_FIELDNAME1 shall contain the value sourcefield, the variable var_FIELDNAME2 shall contain the value NonExistingSource (there is no source structure field with this name).
The result of the function in position number 1 (of the function chain) is sourcefield, the result of the function in position number 2 is NonExistingSource, the result of the function in position number 3 is var_FIELDNAME1 and the result of the function in position number 4 is var_FIELDNAME2.
|
Parameter a (<parameter type>: <parameter value>) |
Result |
|
Variable: var_FIELDNAME1 |
4711 |
|
Variable: var_FIELDNAME2 |
Termination of the function with an error. |
|
Result: 1 |
4711 |
|
Result: 2 |
Termination of the function with an error. |
|
Result: 3 |
Termination of the function with an error. |
|
Result: 4 |
Termination of the function with an error. |
|
Value: MSG_CALL_HTTP_MULTIPART1_VALUE |
Value of the variable (even if it was not created). See section HTTP (Input Agent) (subsection 'Handling HTTP Multipart Messages') for details. |