When you import a component, you can create an entirely new component or upgrade an existing one. Additionally, if the imported component was created from a template, you can use it or create a new one.
Note
If the imported component has the Import Versions Automatically parameter set to true, the new component will automatically import component versions as long as the artifacts are accessible to the importing server.
-
Display the Import Component dialog (
Components > Import Component [button]). -
Enter the path to the JSON file containing the component definition or use the Browse button to select one.
-
If you want to upgrade an existing component, check the Upgrade Component check box. To create a new component, leave the box unchecked.
If the component's name in the JSON file (not the name of the file itself) matches an existing component, the component's parameters are updated with the new values, and new items—such as processes—are added. If the name of the component is not found, the command has no effect.
Note
The component's name is the first parameter in the JSON file; for example,
"name": "helloWorld",
.
-
If the imported component was originally created from a template, use the Component Template Upgrade Type drop-down box to specify how you want to use the template. For these options, the template must be on the importing server. If the imported component was not created from a template, these options are ignored.
-
To use the imported component's template, select Use Existing Template. The new component will be an exact copy of the imported one and contain a pointer to the imported component's template. This option is especially useful if you are importing a lot of components based on the same template.
If you are upgrading, the component will also point to the imported template.
-
To create a new template, select Create New Template. The new component will be an exact copy of the imported one and contain a pointer to the newly created template (which is based on the imported component's template).
If you are upgrading a component, a new template is also created used.
-
When you want to create a fresh installation and ensure a template is not on the importing server, select Fail if Template Exists. If you are creating a component, it will create both a new component and template unless the template already exists, in which case the component is not imported.
If you are upgrading a component, the upgrade will fail if the imported component's template already exists.
-
To ensure the template is on the importing server, select Fail if Template Does Not Exist. If you are creating a component, it will create both a new component and template unless the template does not exist, in which case the component is not imported.
If you are upgrading a component, the upgrade will fail if the imported component's template does not exist on the importing server.
-
To upgrade the template, select Upgrade if Exists. This option creates a new component and upgrades the template on the importing server. If the template does not exist, a new one is created.
-
-
Click Submit.
