Instructions tell the data import framework how to retrieve, map and convert values from the Records and set values in the Model.
Each Instruction in the
instructions array is defined by a dictionary, and executed in order for each Record.
Independence of Instructions
Although Instructions are executed strictly in the order they appear in your control file, in general, Instructions are independent of each other.
Therefore they can appear in any order in your control file, with the following exceptions:
- Where an Instruction sets a value in a Destination, such as
field, and that Instruction has the
"multivalue":trueoption, if you use
remove-valuesto clear the current values, that
remove-valuesInstruction must appear first in the control file.
for-eachInstructions change the ‘context’ within the Record, execute their embedded
instructionslist, then reset the context. To access the expected data, Instructions like
fieldmust appear within that embedded list of Instructions.
Some properties in the definition dictionary are common to all Instructions.
||The action of the Instruction. If not specified, defaults to
Other properties will depend on the
action of the Instruction, and any conversions that need to be applied to the input data.