Purpose
The assign task is used to copy the values (of all enumerable own properties) from a source object to a target object. It will return a modified target object, which has properties and values pushed from the source object. Of note, the target object is the first parameter and is also used as the return value (targetObject).
Potential Use Case
Suppose you have an ordered list of emails in a collection and you want to assign them into a numbered list. The target object and the source object will be given the numerical assignments in the final list.
Properties
Input and output properties are shown below.
| Incoming | Type | Description |
|---|---|---|
target |
Object | Required. The target object to apply the source properties to. |
sourceN |
Object | Required. The source object containing the properties to copy. |
| Outgoing | Type | Description |
|---|---|---|
targetObject |
Object | The target object. |
Example
In the IAP example below:
Property "a" has been assigned the value of "1" in the
targetobject.Property "b" has been assigned the value of "2" in the
sourceNobject.
The source object
"b:2"is copied to the target object and thetargetObjectreturns the combined variables of"a":1,"b":2.