Renaming Elements
When renaming elements, keep the following points in mind:
You can rename any elements for which you have Write access to the element and its parent folder. When renaming a folder, you must also have Write access to all elements within the folder. For more information about Write access and ACLs assigned to elements, see
Assigning and Managing Permissions for
Elements.
When you rename a folder,
Designer automatically renames all of the elements in that folder (that is, changes their fully qualified names).
If the folder you want to rename contains elements with unsaved changes, you must save the changes before you can rename the folder. You cannot rename a folder if elements within the folder are locked by other users.
Element names must be unique across all packages. If you try to rename an element using a name that already exists,
Designer reverts the element back to its original name.
When you rename an adapter notification,
Designer also renames its associated publishable document type and prompts you to indicate whether to rename the associated
Broker document type.
You cannot rename a listener or connection element.
When you rename a publishable document type,
Designer checks for dependents such as triggers and services that use the publishable document type. (
Designer performs dependency checking only if you select the
Prompt before updating dependents when renaming/moving preference.) If
Designer finds elements that use the publishable document type,
Designer gives you the option of updating the publishable document type name in each of these elements. If you do not update the references, all of the references to the publishable document type will be broken.
Important:
You must manually update any services that invoke the pub.publish services and specify this publishable document type in the documentTypeName or the receivedDocumentTypeName parameter.
Important:
If you need to change the name of a field in an element, refactor the field instead of renaming it. Refactoring ensures that usages of the field are updated with the new name, including uses in the pipeline such as mapping. For more information about refactoring, see
Refactoring Variable Names in Elements.
To rename an element
1. In Package Navigator view, select the element that you want to rename. Right-click the element and click Rename.
2. If the element you want to rename contains unsaved changes, Designer alerts you that the element cannot be renamed until you save the changes. Click OK to close the alert dialog box. Then, save the changes and repeat the rename action.
3. Edit the name and press ENTER.
If an element already exists with that name at the same level, Designer displays a message alerting you that the rename action could not be completed. Click OK to close the message dialog box and repeat the rename action.
4. If you selected the Prompt before updating dependents when renaming/moving check box in the Package Navigator preferences and any dependent elements on the current server contain unsaved changes, Designer alerts you to save the elements that will be affected by the rename action. Select the elements and click OK to save the changes or Cancel to cancel the entire rename action.
5. If the Move and Rename Dependencies dialog box appears, do one of the following:
To... | Click... |
Rename the selected element in Package Navigator view and update references to dependent elements | Update Usages. |
Rename the selected element without updating references to dependent elements | Ignore Usages. |
Cancel the entire rename action | Cancel. |
For more information about dependency safeguards, see
Configuring Dependency Checking
for Elements.