Importing Components

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.


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.

To Import a Component

  1. Display the Import Component dialog Components > Import Component [button].

  2. Enter the path to the JSON file containing the component definition or use the Browse button to select one.

  3. 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.


    The component's name is the first parameter 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 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.

  5. Click Submit.