Child pages
  • Exporting Structure

This documentation relates to an older version 2.1 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

When you Export a structure, you use the hierarchy from the structure to create, update or delete other issue attributes or make any other changes based on the hierarchy that a specific synchronizer provides.

For example, you can use Links Synchronizer to create issue links between sub-issues and their parents.

To run Export, you must have Control permissions on the Structure, and you will likely need some additional permissions, depending on which synchronizer you're going to use. For example, you have to have Link Issues permission when working with the Links synchronizer.

To export hierarchy from a structure:

  1. Open Manage Structure page using top navigation Structure menu.
  2. Select the structure you'd like to export from and click Export link. 

    If you don't see Export link in the Operations column, then you possibly don't have Control permissions on this structure.

  3. Select a synchronizer from the drop-down list and proceed to configure export parameters. 

    If there are no synchronizers in the drop-down list, then either none are currently installed or none of the installed synchronizers support exporting from a structure.

  4. Enter synchronizer parameters. Each synchronizer has its own parameters, so please refer to specific synchronizer documentation. If you're not yet acquainted with how this specific synchronizer works, please read the Rules section on the parameters page. 
  5. Click Run Export. When you start export, the synchronizer will read the current structure and apply it to whatever it syncs with.
  6. After you have clicked Run Export and confirmed the operation, a job status page will be present. When the job is marked Finished, the synchronization is done and you can inspect the results.

When export is run, it runs under your user name and with your permissions. So if you don't have enough permissions to make a certain change in JIRA, the synchronizer will skip that change (a warning will be printed out in the server logs).

 Import and Export are actually a one-time Resync. Export is resync from Structure and import is resync into Structure. If you need to run export or import periodically, you can set up a synchronizer with all the parameters but without enabling it - so no synchronization happens in the background. When you need to export or import, you can open Synchronization Settings page for the structure and run Resync. Just make sure you've selected the correct Resync direction!