Property description
The renameObject action type renames each object in the stream to a name built from the expression property, for example combining the parent’s name with one or more attributes.
The action trims leading and trailing whitespace from the composed name; internal whitespace is kept. An object whose composed name equals its current name is skipped: no warning, and nothing is added to its change history. An object whose name is composed from a rich-text attribute keeps only the link text of any links in that attribute, not the underlying address or markup.
If the expression references a key that doesn’t exist, the action succeeds but renames nothing for that object, and the run log carries two warnings explaining why. If the expression fails for one object, the rest of the stream is still renamed; a warning names the object that failed. If the composed name collides with a sibling’s name, the object is renamed anyway, and a warning names the colliding sibling.
The run’s result summarizes how many objects were renamed, skipped, and errored, for example input 4, renamed 2, skipped 1, errors 1. Per-object warnings are capped at 10 in the summary; beyond that, a line reports how many further objects had warnings not listed.
A rename from this action raises the same objectRenamed trigger as a manual rename, so a chained rule reacts to it the same way. The change is recorded in the object’s change history as old name to new name, authored by the technical user, not the user who caused the triggering event.
The action renames an object regardless of its workflow state, including an approved object or one with an open concept: the rename applies directly, the same as a manual rename, and is not undone if the concept is later approved.
Attributes with formatted (rich) text are not supported as a naming source: adjacent blocks in the composed name are joined without a space. Compose the name from plain-text attributes instead.
Automation Preview shows this action and the name it would produce, without renaming any object.
Minimal JSON
{
"key": "",
"type": "renameObject",
"expression": ""
}{
"key": "",
"type": "renameObject",
"expression": "[{{currentObject}.parent().name()}] {{currentObject}.name()}"
}Nested properties
| Property | Description | Values | Mandatory |
|---|---|---|---|
key | Key of the action. | string | Yes |
type | renameObject | string | Yes |
expression | Dynamic expression that composes the new name, for example combining {currentObject}.parent().name() with one or more {currentObject}.attribute('key') values. Must be a non-empty string; an empty, omitted, null, or non-string value fails the package installation. An expression that composes to an empty result is treated as an error in the run summary, and the object’s name is left unchanged. | string | Yes |