Catalogue Copy

Catalogues and Specifications User Guide

Common Tools : Catalogue Copy

Use the Catalogue Copy window to copy catalogue items from read only databases to local write databases. The read only databases may be foreign databases or locally copied MASTER databases that you has no write access to.

The following restrictions should be observed:

•

The system only allows items to be copied at the same level in the hierarchy within a copy sequence.

•

The owning hierarchy must exist (or be created) in the database where the items are going to be copied to.

•

Only members of top level items (for example: SPWL, CATA and so on) can be copied, as it is not possible to specify into which database an item is to be copied without actually having an existing item in the target database.

The Catalogue Copy window is divided into the following frames:


Copy Options	Select either the Same Name or the Prefix option. If the Prefix option is selected, the string in the adjacent text gadget is used as the prefix to the Copy To name. The Include Reference toggle is used to include any references for any SCOM, SPRF or SFIT items that are included in the Copy From frame, as these references may or may not exist in the same part of the hierarchy.
Catalogue Explorer	Displays all the catalogue elements in the current set of databases.
Copy From	Displays all the items that are to be copied in the current sequence.
Copy To	Displays the name of the database items that to be created when the Apply Copy option is applied. It also shows the database item name in the target database into which the item is to be copied.
Copy to Location	Displays all the possible locations in the target databases, where the Copy From items can be copied to.

The Copy From frame can be populated by right clicking in the Catalogue Explorer frame to display a sub-menu, Add Elements to Copy From and Add Members to Copy From or by clicking either of the two top options to the right of the Catalogue Explorer frame.

Or by clicking either of the two top options to the right of the Catalogue Explorer frame.

Either option adds the current element or its members to the Copy From pane.

Once the Copy From pane has been populated, the right click functionality on the Catalogue Explorer is only active if the Catalogue Explorer item's owner is the same as the one in the pane. The options are also only active based on the current catalogue explorer item and the Copy From pane owner type.

Items can be removed from the Copy From pane by using the right click functionality:

Or by clicking the two lower options to the left of the Copy From pane:

The Copy From pane can also be populated by using the Include References toggle and Update option. These are only active if any items in the grid are of type SCOM, SPRF or SFIT and will look for any references for example: GMRE, PTRE, NGMRE, DTRE, PSTR, GSTR and BLFARRAY.

Any items not already in the Copy From pane are added.

If the Include References toggle is not checked then the references are removed from the pane. The Update option allows any new items that have been added to the pane after the Include References toggle has been ticked to be added to the pane.

When the Copy From pane is populated the Copy To pane is also populated.

The Copy To pane is populated with the name the item is to be given when the Apply Copy option is applied. The green tick indicates that the name does not already exist in the target databases. Any items where the specified name does exist in the target databases will be highlighted with a red dot sphere and will not be copied. The target databases are defined by any database in the current MDB that can be written to.

The Copy To column now needs to be populated with the new location in the target databases.

Select an owning element in the Catalogue Explorer frame to copy to, making it the currently selected item.

If the selected item in the Catalogue Explorer frame is of the correct owner type and the database can be written to then a Set copy location from Explorer right click option is available in Copy To pane.

For example if the element members that are to be copied are of type CATA then an owning element of type CATA in the destination database from the Catalogue Explorer frame must be selected then select Set copy location from Explorer.

Note:

If the destination database does not have an owning element of the correct type then it must be created in the database hierarchy. For example in the case of a CATA refer to Create Catalogue.

If an owning element of the correct type is already present when the Copy From grid is populated then the Copy To Location pane is also populated with any items in the target databases where the items in the Copy From pane can be created.

For example, in the following figure a number of SPRF items are copied which need to be created at an STCA level. Therefore the pane is populated with all STCA elements in all databases that can be written to in the MDB.

When an item is selected in the Copy to Location pane, the location of the selected items in the Copy To pane can be set by either right clicking on the Copy To Location pane.

Or by clicking the options located to the right of the pane.

Note:

Different elements can be created in different locations in the target databases.

Once the Copy To grid is populated and contains any items that have a name and copy location that both contain a green tick, Apply becomes active.

When Apply is clicked, all the items that can be copied (items with green ticks in both columns of the Copy To grid) are copied from the Copy From pane to the location in the Copy To pane with the applied name. All references that are included in the copy are reset to the newly created references in the target databases. The Catalogue Copy window is then cleared ready for the next copy sequence.