Replacing Objects

As a developer and object designer, you can replace an object with another one of the same type. If other objects are referencing the original object, these references are automatically adapted to link to the new object. The Replace function is available from the Explorer list in the Process Assembly perspective, from combo boxes, and from the global search dropdown list.

Restrictions

  • Replacing is not possible for the following objects:

    • Agent/Client Assignment (HSTA)
    • Client (CLNT)
    • Dashboard (DASH)
    • Documentation (DOCU)
    • Folder (FOLD)
    • Schedule (JSCH)
    • Server (SERV)
    • Storage (STORE)
    • User Group (USRG)

  • You cannot use this function to replace objects in scripts. After replacing an object automatically, you still have to do it manually in scripts. For more information, see To Replace Objects Used in Scripts.

  • In objects to which you can assign an Agent Group (Jobs, Job Transfers, Events of type FILE), you can replace an Agent with an Agent Group. Otherwise, you can replace Agents only with other Agents.

To Replace Objects

  1. Select the object and right-click to select Replace.

  2. The Replace Object dialog is displayed. This dialog is different depending on whether the object you want to rename is used in other objects or not. If it is not, select the object that should replace it and click Replace.

    If the object is used in other objects, the Replace Object dialog contains the list of objects in which it is used. All objects in the list are selected by default. This means that if you confirm your action, all objects will be replaced. Activate or deactivate the checkboxes to select the instances that should be replaced.

    If the object you want to replace is used multiple times in another object (for example, in a Workflow ), the list contains an entry for each instance of the object. The Used in column tells you exactly where the instance of the object is used.

    Example: The object that you want to replace is used twice in a Workflow. There are two entries in the list for the Workflow. The Used in column shows Task(3) and Task(5). This means that the first instance is the task with number 3 in the Workflow and the second instance is the task number 5.

    Tip: To understand the potential impact of replacing an object that is being used by other objects, click the Open in New Tab button. The selected objects open in a browser tab each. If the object is used in a Workflow or in a Schedule, the Workflow or the Schedule opens to show you exactly where in its structure that particular task is located. The task is highlighted.

  3. Click the Replace button.

To Replace Objects Used in Scripts

Scripts cannot be replaced using this function, you must do replace them manually.

  1. On the Replace Object dialog, select the object in whose script the objects you want to replace is used.
  2. Click the Open in New Tab button to open the object.
  3. Open the Process Pages where the object is referenced.
  4. Use the search and replace function of the script editor. For more information, see Searching and Replacing Strings.