Importing Objects from an Archive Using CentraSite Control
You can import objects from an archive file that was previously created by using the CentraSite export feature. The archive you wish to import must reside in the file system of the computer where your browser is running.
For general information about what happens during the import process, see
Importing an Object.
To import objects from an archive file
1. In CentraSite Control, go to any page that displays the Import button. Examples of pages that include this button are:
Asset Catalog > Browse
Policies > Design/Change-Time
Administration > Taxonomies
2. Click the Import button. This activates the import dialog.
In the field Import as, select Archive from the drop-down list. When you select this option, the layout of the wizard changes to show just the fields that are required for importing an archive.
In the field File, supply the name of the file that contains the archive.
Click Finish. The Import Preview page is now displayed.
Note: | If the archive you wish to import was created with CentraSite 8.2 or earlier, the Import Preview page is not available. In this case, when you click Finish, the import operation continues with the Import Options dialog in step 4. |
3. The Import Preview page displays the names of the top-level objects contained in the export archive. If the archive contains related objects that the top-level objects require for completeness, the related objects are not displayed, but they will be imported automatically along with the top-level objects. For example, an exported web service requires a related schema, so the archive file will contain both the web service and the schema, and an import of the web service will cause the related schema to be imported also.
By default, all displayed top-level objects are selected for import; this is indicated by the marked checkbox beside the name of each object.
You can exclude objects from the import by unmarking their checkboxes.
Note: | In some cases, there may be a dependency between top-level objects (for example, a web service that refers to a taxonomy), and the import operation ensures that such dependencies are retained. This means that if you unmark the checkbox of a top-level object that is required by another top-level object, CentraSite will ensure that the required object is nevertheless included in the import. |
Additional options are available that allow you to choose how the imported objects will be created. To access these options, click Import Options.
4. In the Import Options dialog, set the following options.
Option | Meaning |
Keep current organization / Assign new organization | When you import objects, you can import them into the same organization in the target registry as in the source registry from which they were exported, or you can assign a new owning organization. Choose Keep current organization to import the objects into the same organization. The organization in the target registry must have the same name and UUID as in the source registry. Choose Assign new organization to import the objects into a new organization. If you choose this option, you can select the new organization via the Select Organization button. In some cases, the original organization will be preserved during import even if you have selected a specific organization in this field. This happens if the object to be imported is any of the following:  an organization a system-wide lifecycle model a system-wide policy Asset types are not owned by any organization, so selecting an organization for such objects has no effect. |
Keep current owner / Assign new owner | The imported objects can be assigned to the same owner as in the source registry, or you can assign a new owner. Choose Keep current owner to assign the imported objects to the same owner as in the source registry. The owner in the target registry must have the same name and UUID as in the source registry. Choose Assign new owner to assign the imported objects to a new owner. If you choose this option, you can select the new owner via the Select Owner button. |
Keep lifecycle state | This option determines whether the lifecycle state of the imported assets is preserved. Enable the option to retain the lifecycle state of the assets being imported. |
Allow replace of registry objects | |
Import groups that the user belongs to | When you import a user, you can specify whether you want to also import the groups that the user belongs to. This applies only to user-defined groups; system-defined groups are not imported. Choose this option to import the user-defined groups that the user belongs to. |
5. Click OK to leave the Import Options dialog.
If you are importing an archive that was created with CentraSite 8.2 or earlier, the import now starts.
If you are importing an archive that was created after CentraSite 8.2, the Import Preview dialog is displayed again. Now click OK to start the import.
6. When the import operation completes, the import wizard informs you if the import was successful or if there were any errors.
You can click OK here to terminate the import wizard without viewing the import log.
Alternatively, to see details of the objects that were imported, the wizard offers you a link to view the import log. When you click this link, the import log lists each top-level object and indicates whether or not it was successfully imported. The import log also lists the import status of any related objects that were contained in the archive (i.e. objects in the archive that are not top-level objects).
In the import log view page, click OK to terminate the import wizard.
