Renaming Objects and Folders

Renaming objects and folders is always possible, whether they are used in other objects or not.

Using a consistent naming policy for your objects is important. Before you create or rename objects have a look at Naming Conventions, where we provide detailed information on naming rules, best practices and examples. Applying consistent naming conventions will help you not only in your daily work but also in defining and keeping a reliable authorization system.

Example

You change the name of a Queue object that is being used in multiple Jobs. When doing so, you can also simultaneously edit the Jobs in which it is being used by also editing the Queue name there. This renames not only the Queue object itself but also all its occurrences in the Job objects. This way, the Jobs will be able to continue running as usual without your having to adapt them manually.

Notes:

• Maximum length of object names: 200 characters

  Exceptions:

  • Time Zone (TZ): 8 characters only.
  • Clients: 4 digits.
  • Agents and Agent Groups: 32 characters

• Allowed characters:

  • A–Z
  • 0–9
  • $ @ _ - . #

To Rename an Object or Folder

1. Select the object or folder and right-click to select Rename.

2. The Rename Object or Rename Folder dialog is displayed, which is different depending on whether the object you want to rename is used in other objects or not.

   • If the object is not used anywhere else, you simply change its name and click Rename.

   • If the object is used in other objects, a dialog is displayed that lists all the objects in which it is being used.

     All objects on the list are selected by default.

     • To rename all occurrences of the object, leave all checkboxes activated and click Rename Selected.
     • To rename only certain occurrences of the object, deactivate the checkboxes of those occurrences that should NOT be renamed and click Rename this Object Only.
     • To rename only the object that you have originally selected , click Rename This Object Only.
     • Click Cancel if you do not want to rename the object.

     If an object (a Workflow, for example) uses the same task several times, the name of all these tasks are replaced.

Restriction

If the object is used in a script (on any of the Process pages of executable objects) or in an Include (JOBI) or Script (SCRI) object, you have to rename it there manually:

1. Highlight the name of the object in which it is used and click Ctrl+C to copy it.
2. Paste it in the Global Search field that is available at the upper right corner of the window.
3. Right-click the object and select Open or Open in New Tab.
4. On the Process page search for the object you want to rename. The Script editor provides convenient functions for this purpose, see Searching and Replacing Strings.
5. Save and close the object.