Importing/Exporting Subcomponents

Exporting Subcomponents

Click on the export button to export subcomponents to JSON file. You can import this JSON file to another project or to the same project. It may be even another Jira instance.

[
  {
    "name": "Mobile Applications",
    "components": [
      {
        "name": "iOS Application",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "Android Application",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "Function Modules",
        "components": [
          {
            "name": "Production Planning",
            "description": "Test description for Production Planning module for Configuration Management Toolkit for Jira Cloud. We are going to use this for testing.",
            "assigneeType": "PROJECT_DEFAULT",
            "isProjectComponent": true,
            "components": [
              {
                "name": "Material Management",
                "description": "Description for Material management",
                "assigneeType": "PROJECT_DEFAULT",
                "isProjectComponent": true,
                "components": [
                  {
                    "name": "Finance",
                    "description": "Finance module description",
                    "lead": {
                      "accountId": "6347d6d38bb342276b5179c7"
                    },
                    "assigneeType": "PROJECT_DEFAULT",
                    "isProjectComponent": true,
                    "components": []
                  }
                ]
              }
            ]
          },
          {
            "name": "Quality Management",
            "assigneeType": "PROJECT_DEFAULT",
            "isProjectComponent": true,
            "components": [
              {
                "name": "Project Management",
                "assigneeType": "PROJECT_DEFAULT",
                "isProjectComponent": true,
                "components": []
              }
            ]
          },
          {
            "name": "Human Resources",
            "assigneeType": "UNASSIGNED",
            "isProjectComponent": true,
            "components": []
          }
        ]
      }
    ]
  },
  {
    "name": "Database Support",
    "components": [
      {
        "name": "MySQL",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "MongoDB",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "NoSQL",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "Oracle",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "PostgreSQL",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      }
    ]
  },
  {
    "name": "DevOps",
    "components": [
      {
        "name": "Installer",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "Service Desk",
        "assigneeType": "PROJECT_DEFAULT",
        "isProjectComponent": true,
        "components": []
      },
      {
        "name": "Sales and Distributions",
        "assigneeType": "PROJECT_DEFAULT",
        "components": []
      }
    ]
  },
  {
    "name": "IT Support",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "Manager",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "Debug",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "Advertisement",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "MySQL1",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "MySQL2",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "MySQL3",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  },
  {
    "name": "MySQL4",
    "assigneeType": "PROJECT_DEFAULT",
    "isProjectComponent": true,
    "components": []
  }
]

Importing Subcomponents

To import subcomponents click on the import button on top of the component hierarchy. This will open a file selector dialog, you can either select a previously exported JSON file or select a handcrafted file. But its structure should match the sample given above.

Click on the "Load" button to see a preview of the import operation. Don't worry, you can still cancel the operation after clicking on "Load". After clicking on "Load" the following preview dialog will be displayed.

In the dialog, project components and folders that will be created are shown in purple, those that will be updated are shown in yellow and those that already exist in the project are shown in black.

After clicking the import button, the progress bar is revealed.

Import operation will automatically create missing components and update existing components to match them to the information in the JSON file. It will not delete any component even if it doesn't exist in the JSON file. But it will remove all component hierarchy and recreate it to match the hierarchy specified in the JSON File.