On this page | |
Since | 18.0 |
This node renames a list of attributes from incoming work items. (More correctly, it generates clones of the incoming work items, but with several attributes renamed).
Parameters
Generate When
Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.
All Upstream Items are Generated
This node will generate work items once all of the input nodes have generated their work items.
All Upstream Items are Cooked
This node will generate work items once all of the input nodes have cooked their work items.
Each Upstream Item is Cooked
This node will generate work items each time a work item in an input node is cooked.
Automatic
The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.
Rename When
If you turn this on, the node only renames the attribute(s) below from work items where the given expression evaluates to a non-zero value. The expression does not have to involve the attributes being renamed. For example, to rename attributes from any work items whose tile_x
attribute is greater than 5, turn on Rename When and set the expression to @tile_x > 5
.
Number of Renames
A multiparm of attribute rename operations.
Attribute From/To
The name of the existing attribute to rename, and the new name to be assigned.
Overwrite Existing Attributes
If the new attribute name matches an existing attribute the existing attribute will be replaced if this is checked. If this is unchecked, an error will be reported.
On Attribute Not Found
Determines what happens when the given attribute name does not exist.
Report Error: An error is reported if the attribute is not found.
Report Warning: A warning is reported if the attribute is not found.
Ignore: The rename operation is skipped.
Examples
RenameAttributes Example for Attribute Rename TOP node
This example file demonstrates how to rename work item attributes.
See also |