Importing Components

When you import a component, you can create a 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 property set to true, the new component will automatically import component versions as long as the artifacts are accessible to the importing server.

To import a component

  1. Navigate to Management > Components.

  2. Click Import.

  3. If you want to upgrade an existing component, select Upgrade Component.

    If the component's name in the JSON file (not the name of the file itself) matches an existing component, the component's properties 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 property in the JSON file; for example,

    "name": "helloWorld",

  4. If the imported component was originally created from a template, use the Component Template Upgrade Type options 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 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.

  5. Click Choose File and select the JSON file containing the component.

  6. Click Import.