<ExtendedAction>
Each <Step> element can have one or more <ExtendedAction> elements as children, which can be used to call methods of the step’s target business object. This table describes each attribute of the <ExtendedAction> element.
| Attribute | Description |
|---|---|
| VariableId | Variable ID that identifies the business object the extended action will act on. You use the VariableId attribute of the <Step> element to assign a variable ID to a step’s target business object. Required. |
| Target | Target is an optional attribute that you can use to drill into the business object specified by the VariableId. |
| TargetOperation | Method the extended action will call. This must be a method defined for the business object identified by the combination of the VariableId and Target attributes. If the method has parameters, the parameters are set by one or more <Parameter>, <VariableParameter>, or <SelfParameter> elements.
Required unless the object is a collection (one that implements the IList interface). For a collection, the extended action will execute the .Add method if no TargetOperation is defined. |
| ReturnVariableId | Assigns the specified variable ID to the return value of the method. |
| ReturnVariableType | Type of variable for the return variable ID. If the variable type implements the IList interface, the import processor will call the .add method and add the object to the collection. Otherwise it will overwrite the current value of the variable, if set. |
| OverrideFor | Condition for overriding the step’s action. You can specify
one or more of three values in a comma-separated list: Create, Update,
and Delete. If the step would perform one of the listed actions, the
extended action will be executed instead. For example, suppose the step’s action is “Create, Update” and the OverrideFor attribute of the step’s extended action is set to “Create.” If an existing record is found, the step will update that record as usual. If no record is found, so that the step would create a new record, the extended action will be executed instead. |
<Parameter>
The <Parameter> element is one of three ways to set parameters for the method executed by an <ExtendedAction> element. A <Parameter> element specifies the value to use for a parameter and the parameter’s type.
This table describes each attribute of the <Parameter> element.
| Attribute | Description |
|---|---|
| Type | Type of parameter. Required. |
| Value | Value of the parameter. Required. |
<VariableParameter>
A <VariableParameter> element uses a selected variable, defined elsewhere in the mapping file, to set the value of a method parameter. This table describes each attribute of the <VariableParameter> element.
| Attribute | Description |
|---|---|
| VariableId | ID of the variable that sets the value of the parameter. Required. |
| Target | Can be used to drill into the business object specified by the VariableId. |
| Direction | Can be set to “In” or “Out” to indicate whether the parameter is an output parameter—that is, whether the method will change the value of the variable. The default is “In,” meaning the method won’t change the variable. If the value is “Out,” then the method will assign a new value to the variable. Note that the parameter defined for the method must be an output parameter too. |
<SelfParameter>
A <SelfParameter> element uses the step’s target business object as a method parameter This table describes each attribute of the <SelfParameter> element.
| Attribute | Description |
|---|---|
| Target | Can be used to drill into the business object. |