Rename Attribute conditionally changes an attribute name on all elements in the supplied collection of document elements.
The values of renamed attributes are unaltered by this rule. Elements in the supplied collection without the named attribute are left unchanged. The rule does not apply to descendant elements.
This rule uses the following parameters:
- Replace With
- The new attribute name.
- Attribute Name
- The existing name of the attribute to be renamed.
Note: No validation is performed. For example, the existing attribute may be required to exist in the relevant schema or DTD. We recommend that you validate the change before checking in
locking units of the affected elements.
Changing Audience Attribute to Importance Attribute
Suppose a user mistakenly tagged elements audience="obsolete" and they should have specified importance="obsolete" in multiple structured documents. To correct the problem, perform a Basic Search using these criteria:
- Find Elements
- By Attribute
- @Name is audience
- @Value Is
- Value: obsolete
- Select all of the element results in the Details view and select .
- From the Type list, select Rename Attribute.
- In the Replace With field, type importance.
- In the Attribute Name field, type audience.
- Leave the Check In check box cleared, so you can validate the changed elements after the job runs.
- Enter a Version Note describing what the job specified.
- Click Ok.
The batch job runs. When it completes, you will receive an email notification indicating the results.