|On this page|
This node has two inputs. It looks for work items in the second input that "match" items in the first input. The node can match items up by position (index), or match up items that share a certain attribute value. Then, when it generates outgoing items, for items that match, it copies a list of attributes from the items in the second input onto the items in the first input.
You can choose to Exclude unmatched items, in which case any work items from the first input that don’t match items in the second input are discarded.
Use Dynamic Partitioning
When this toggle is enabled the partitioner will wait for all input work items to be generated before partitioning them. If the input work items are dynamic, this means the partitioner will have to wait for and depend on the parent(s) of those items.
Copy Attributes from All Work Items
When this toggle is enabled, the attributes from all work items on the second input will be copied onto each of the work items on the first input. No Match By condition is used to filter the work items.
Whether to match by
index value (roughly, match by position) or by an attribute.
When Match by is "Attribute", the name of the attribute to use to match up work items (items in the second input will match items in the first input that have the same value of this attribute).
When Match by is "Attribute", the type of the attribute to match (Integer, Float, or String).
Excluded Unmatched Items
When this is on, items from the first input are only passed down to the output if they matched. Items that didn’t match an item in the second input are filtered out. (Items are never passed down from the second input.)
Attributes to Copy
A space-separated list of names/patterns describing which attributes to copy from items in the second input onto items in the first input. The default is
* (copy all attributes).
For example, you could set this to
foo bar baz to only copy those three attributes, or
file_* to only copy attributes whose names start with
Copy Result Data
When this is on, also copy output filenames onto the items in the first input.
This example demonstrates how to copy attributes from one workitem to another.
The following examples include this node.