In the same way that there is a meta model that dictates the types of items and parts (and their relationships) in a SystemWeaver server, there are also meta data types for configuration items . They are called Config Items and they are stored as items. Config items are primitive item types used for saving configurations of charts, graphs, grids, reports, XML definitions, etc. At some point, a situation may arise where you want to export a server's meta model including the meta data of all config item types as well as the config item definitions themselves. For example, you may want to migrate to a new database, create a database copy for testing purposes or share your meta model with a supplier or customer. This article describes how to view and export the config items meta data and definition data.


Note: It is worth noting here that config item types are standardized in SystemWeaver and they should not be changed. They can be "installed" in a database without having to receive an export file in order to import them. To install the standard config item types meta data, see Installing the SystemWeaver Config Items Meta Data.


Prerequisites

  • Assignment of the SW Architect role in the database.
  • An installation of the SystemWeaver Architect (swArchitect).

Viewing Config Items

Each configuration that is saved by an Architect exists as an item of a specific config item type in the database. Before exporting the config item meta data and the definitions themselves, you may want to view them. You can view them by type in the swExplorer or by Configured Type in the swArchitect. 


In swExplorer

In the swExplorer, you can search for and view the config item types by selecting Open item>Other item type. Then, check the Include Base Item checkbox in the Select Type dialog. The various config item types will display.


If you want to view the data itself, select the config item type for the definitions that you want to view, e.g., Grid definition for all grid definitions, and click OK.  You can only search for one type at a time. Your results will display on an Open Item page. Here, you can preview an item in your results, by clicking on it. A Preview pane will display to the right. In the Properties section, the Configured type will indicate which type of item in the server that the selected configuration item is defined for. In the Attributes section, you can view the XML Definition by clicking on the look-up button.


In swArchitect

If you are working in the swArchitect client and want to view the definition items associated with a particular item type, go to the Metadata tab and select the item type in the meta data structure tree to the left. Then, click on the Config Items tab. Aside from viewing a list of the configurations associated with the selected item, there are options to view their definitions (via the Definition attribute) as well as to remove config items.



Exporting the Meta Data and Definitions

The config item meta data, along with the configuration items themselves, are exported from and imported to SystemWeaver as items. The export of config items is an option when you export the meta model via the swArchitect client. Select XML Export..., check the Include config-items box, and click OK. The config items and definitions will then be included in the meta model XML export file. 



Tip: If you have already done a meta model export without this option selected, you can simply do the export again with the box checked.


Note: The config items exported using this option are not to be confused with the view configurations defined in Configure the explorer in the swExplorer client. Those configurations are exported using XML export. See Exporting Explorer View Configurations.


What's Next?

The above article describes how to export the config item types and the existing definition items. 

The import of the meta data for the config items is done via the swArchitect client using the Import XML option.
To import the various definition items themselves, use the XML Import view in the swExplorer client.