Skip to main content

Objects - Object Replace/Merge​

The Object replace/merge tab of the Object finder window replaces every use of one object with another object of the same type. For example, to move many Jobs from an old Credential to a new one, select the old Credential as the source and the new one as the destination.

To open it, click Tools -> Objects -> Object relations or Object search, then click the Object replace/merge tab.

Object finder window on the Object replace/merge tab with source and destination objects selected

warning

Replace changes the objects on the Server at once; there is no confirmation. If you select the "No" entry of the type, for example "No Credential", as the destination, every object that uses the source loses that reference; for example, Tasks are left with no Credential. With Merge source object into destination object checked, the source object is also deleted.

Source object​

The object that is used now and that you want to replace.

  • Object type: the type of object to replace
  • Object name: the object to replace. The Filter.. field narrows the list
  • Count:: how many objects use the source object, which is how many will change

Merge source object into destination object​

When checked, the source object is deleted after its uses are moved to the destination object. When unchecked, the uses are moved and the source object is kept.

warning

With Merge source object into destination object checked, the source object is deleted from the Server. It can be re-created from its stored versions while its audit log entries are kept; see Versions.

Destination object​

The object that replaces the source object.

  • Object name: the replacement object. The list starts with a "No" entry for the type, which removes the reference. The Filter.. field narrows the list. For some types, such as Connections, only compatible objects are listed
  • Count:: how many objects use the destination object now

Result grid​

The grid lists the objects that use the source object and will change: Object type, Name/Description and Job name. Double-click a row to open that object. The Filter: field below the grid narrows the list.

Replace​

Click Replace to run the operation at once; there is no confirmation. A summary shows how many objects were updated. The source and destination object must be different.