Importing Objects through CentraSite Business UI
To export an object, you must have View permission for the object you want to export.
CentraSite Business UI, you can do the import operation only for assets in CentraSite Business UI. You can import assets by importing the archive (zip) file to which the assets were previously exported. You can import assets into the same CentraSite registry from which they were originally exported or to a different CentraSite registry.
Predefined asset types that are exported from older versions of CentraSite may not get imported. The asset instances are imported only if they conform to the asset type schema in the target CentraSite registry.
To import an asset or a set of assets
1. In CentraSite Business UI, click the Create Asset activity.
This opens the Create New Asset wizard. The bottom panel of the Create New Asset wizard shows the option to import an archive file.
2. To import an archive file, click Choose to navigate to the folder where the exported archive file resides, and choose the file.
When you select a file to import, the fields in the Basic Information panel cannot be edited.
3. Click Next.
4. The Create New Asset wizard displays the list of objects to import.
The checkbox beside each object indicates whether the object should be imported. By default, all objects displayed are included in the import set.
To exclude any object from the import set, clear its checkbox.
If you are importing an archive file that was generated prior to CentraSite version 9.0, the wizard does not display the list of objects. However, the objects are imported.
5. Expand Advanced Settings to display a set of additional import options. These settings are optional.
Option | Description |
Change Owner | The imported assets can be assigned to the same owner as in the source CentraSite registry, or you can assign a new owner. The Change Owner field is type-ahead field. As you enter characters in this field, the dialog will list the usernames that match the characters you enter. |
Change Organization | When you import assets, you can import them into the same organization in the target CentraSite registry as in the source CentraSite registry from which they were exported, or you can assign a new organization. The Change Organization field is type-ahead field. As you enter characters in this field, the dialog will list the organization names that match the characters you enter. |
Retain 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. |
Overwrite existing entities | This option specifies that existing assets with the same UUID in the target CentraSite registry will be overwritten, even if the asset in the archive is older than the one in the target CentraSite registry. Enable the option to overwrite the existing assets. |
Import groups that the user belongs to | This option determines that when you import a user, whether you want to import the groups that the user belongs to. This applies only to user-defined groups. System-defined groups are not imported. Enable the option to import the groups. |
Ignore API Keys / OAuth2 tokens | This option determines whether the API keys and OAuth2 tokens of the imported assets are to be imported into the target CentraSite registry. Enable the option to ignore the API keys and OAuth2 tokens during the import process. |
6. Click Import to import the assets.
7. If an asset has an attribute that is required in the target CentraSite registry but not in the source CentraSite registry, CentraSite displays intermediate screens to provide values for each required attribute, before importing the asset.
This happens when an asset type definition in the source CentraSite registry is different from an asset type definition in the target CentraSite registry. For example, the asset type in the target CentraSite registry represents an updated version of the asset type with different attribute definitions.
8. When the import operation completes, the import wizard informs you if the import was successful or if there were any errors/warnings. Click Download Import Log to view the import logs. When you click this link, the import log lists the status of all the objects stating whether they were successfully imported or if there were errors/warnings.
9. Click OK to terminate the import wizard.