Contents

A new switch is put into operation but you want to maintain all the connections? Use the Replacement add-on so that you don't have to document all the connections anew. This add-on allows swapping of objects with configurable adoption of existing connections. 

 

Download and Installation

 

This add-on can also be installed at a later time. You can find detailed descriptions about download, installation, updates etc. in the "i-doit pro Add-ons" article.

Configuration

 You can find the configuration at Administration → CMDB settings → Object swap → Configuration. For the most part, you can use the configuration to define default values in order to standardize and speed up frequent swapping.

OptionDescription
Selectable object-types

Here you specify which objects of which type can be swapped. Additionally, you define per object type which categories (and thus which attributes) are to be swapped. The categories which aren't selected aren't affected by swaps.

CMDB status for storing objects

You can restrict the selection of objects offered for swapping via their CMDB status.

Consider the "swap" status?

When the swap status is considered, the swapped object receives the CMDB status stored and the object of swapping the CMDB status in operation.

Archive swapped objects?Do you want the object which is swapped to receive the status Archived?
Also swap the SYS-ID?

Do you want to swap the SYS-ID attribute in the General category? This is an attribute for unique referencing.

 

Rights Assignment

Under Administration → Authorization system → Rights → Object swap you can specify rights for persons and person groups.

ConditionDescription
Swap objects

Does the user have permission to swap objects?

Swap by workplace

Does the user have permission to swap workplace components?

Swap CI module configuration

Does the user have permission to adjust the configuration (see above)?

Swap CI-button in object list

The user can swap objects via the action bar of the object list. For this purpose, the Swap button will appear in the action bar.

Swap CI-button in objects

Via the action bar within an object, the user can swap the object with another one. For this purpose, the Swap button will appear in the action bar.

 

Requirements

Before two objects can be swapped, the following conditions have to be met:

  • Both objects have the same object type.
  • You can't swap an object with itself.

Object Swap

There are three ways to swap an object for another one:

  1. Select both objects within an object list and click the Swap button in the action bar.
  2. Click the Swap button in the action bar within an object and then select the object of swapping  under Stored object.
  3. Select both objects under Object to swap and Stored object at Extras → Object Swap.

Now you can swap the selected objects by clicking the Change button.

 

After selecting both objects, you can adjust further options. The preselection is from the above mentioned configuration.

OptionDescription

(Categories to adopt)

see above
see above
see above
see above

 

By clicking the Start swapping button both objects will be swapped.

Swap by Workplace

You can carry out a preselection for swapping via assigned workplaces. First select an object type under Extras → Object swap → Swap by workplace. Then all objects of the type Workplace, in whose Workplace components category objects of this type are assigned, will be listed. You select an object for swapping from the respective workplace. With the button  Swap selected objects you can reach Extras → Object swap → Swap objects.

Swap Report

A report about swapping actions which have been carried out so far is generated under Extras → Object swap → Swap-report. You can also reach the reports item via Extras → Report Manager → Views → Swap-report.


Releases

VersionDateChangelog
1.42022-09-05[Task]        PHP 8.0 Compatibility
[Task]        Design Compatibility
[Improvement] English add-on renaming to Replacement
1.3.22022-02-21[Bug] Use Of German Language in English Version Of Object Swap
1.3.12020-08-10[Bug] The location is lost during swap
[Bug] Information is deleted when objects are exchanged
1.32019-05-20
[Improvement] Properties series number and model title in swap ci report available
[Bug] Search index will not be renewed after a device replacement
[Bug] Device exchange uses workflow tables
[Bug] Swap-status has a uppercase first letter in its CMDB-Status
[Bug] Opening the swap-report displays an error
1.2.52017-05-02
[Bug]           Error Message Appears Trying To Deinstall SWAP_CI in AdminCenter
1.2.42017-03-08
[Bug]           Button "Swap" of "SwapCI" does not Work in object lists
[Bug]           Improved PHP and i-doit compability
1.2.32015-10-08
[Improvement]   Properties series number and model title in swap ci report available
[Bug]           SwapCi shows error message when you log in to this context
[Bug]           SQL error prevents from choosing a category for swap
1.2.22015-03-09
[Bug]           SwapCi is showing error if tenant did not install the add-on
1.2.12014-04-14Initial release