User Guide
Introduction
Getting started
System requirements
Installation
Activation
Reactivation
Global connection settings
Project settings
Overview
Basic mappings
Status mappings
Secondary mappings
Reporter mappings
Time tracking mappings
Issue link mappings
Sub-task mapping
Parent/Epic Link/Parent Link mappings
Sprint mappings
Rank mappings
History mappings
Tempo mappings
Event mappings
Custom field mappings
Options
Connection settings
Enterprise fields
Commands
Synchronisation
Skipping tasks
Import issues
Import users
Advanced
API
Command-line mode
Logs

Import issues

The Bridge can import existing issues from JIRA and create the respective tasks in MS Project. To start the import, do the following.

  1. Select JIRA > Import in the main menu

    Ceptah Bridge Import menu item

    or press the Import button on the synchronisation window.

    Ceptah Bridge Import button

  2. The following window will appear.

    Ceptah Bridge issues import window

  3. To import all available issues from a JIRA project, tick Project and select the project in the adjacent combo box.

    To import particular issues, tick Issue keys and then type the keys of the issues in or copy them into the adjacent text box. The keys must be separated by a space or comma.

    To import the set of issues returned by a JIRA filter, tick JIRA filter and select the filter in the adjacent combo box.
    To import issues from a JQL query, tick JQL and enter the query into the adjacent field.

  4. The following options, grouped under Import additional issues linked to the imported issues, allow importing linked issues for the already imported issues.

    • Do not import. If the option is on, no additional linked issues are imported.

    • All linked. If the option is on, all the issues linked to the imported issues will be imported as well even if they do not match the import criteria.

    • For mapped link types. If the option is on, all the issues linked to the imported issues will be imported as well if the link type is mapped in Ceptah Bridge settings. That will happen even if the additional issues do not match the import criteria.

    • Where the link type is mapped, and the additional linked issue has the mapped role. If the option is on, all the issues linked to the imported issues will be imported as well if the link type is mapped in Project Settings and the additional linked issue has the role the mapping is applied to. That will happen even if the additional issue does not match the import criteria.

      For example, if there is a link mapping for "is blocked by" and A is blocked by B, when B is imported, A will be imported as well. The opposite is not true - when A is imported, B will not be imported unless it satisfies the filter.

    • Where the link type is mapped, and the already imported issue has the mapped role. If the option is on, all the issues linked to the imported issues will be imported as well if the link type is mapped in Project Settings and the already imported issue has the role the mapping is applied to. That will happen even if the additional issue does not match the import criteria.

      For example, if there is a link mapping for "is blocked by" and A is blocked by B, when A is imported, B will be imported as well. The opposite is not true - when B is imported, A will not be imported unless it satisfies the filter.

    The above logic is recursive. Ceptah Bridge will also analyse links for the issues that did not match the original filter and have been imported as linked issues or sub-tasks.

  5. To import the sub-tasks of the issues specified with one of the above methods as well, tick the Import Subtasks check box. Note that the sub-tasks that match the import criteria are imported regardless of this setting.

    Then choose where the imported sub-tasks are placed in the schedule.

    • As children. The sub-tasks are created under their parent tasks in MS Project if those tasks are being imported or are already in the project.

    • On the top level. The sub-tasks are created on the first outline level.

    The above logic is recursive. Ceptah Bridge will also analyse sub-tasks for the issues that did not match the original filter and have been imported as linked issues or sub-tasks.

  6. To stop the recursion, tick Import only one level of linked issues and subtasks. With this option on, Ceptah Bridge does not analyse the links and sub-tasks of the issues that were pulled in as linked issues or sub-tasks themselves.

  7. After the import options are specified, click Prepare to start analysing the issues being imported. The synchronisation window will be populated with the new tasks to be created basing on the imported issues.

  8. Review the tasks, uncheck the ones you don’t want to be created, and click Apply changes to add the tasks to the project.

The import is executed in accordance with the synchronisation mappings described in the Project Settings chapter.