Frequently Asked Questions

If you don't find an answer to your question below, please get in touch with us.

Please also check out our Tutorials.

Try Ceptah Bridge file_download
30 days, unlimited
Ceptah Bridge frequently asked questions


Can I use Ceptah Bridge with Jira Cloud (or Jira Server/Data Centre)?

Yes, you can use Ceptah Bridge with both Jira Cloud and any versions of Jira Server/Data Centre.

Though Jira Server will no longer be supported by Atlassian from Feb 2024, we will still provide support for the customers connecting Ceptah Bridge to JIRA Server to the best of our abilities.

Does Ceptah Bridge support Microsoft Project Server and Project Online?

Ceptah Bridge works with projects stored in any version of Microsoft Project Server and in Project Online. It also works with resources from the Global Resource Pool and can synchronise Enterprise fields. You will need Project Professional (Desktop Client) to use Ceptah Bridge with the server products.

Project Professional is included in Project Plan 3 and Project Plan 5 Project Online subscriptions.

Installation and Connection

Error 401 (Unauthorized)

Possible causes:

  • If you are connecting to JIRA Cloud, make sure that you are using your e-mail as the user name and a valid Api Token as the password with the Auto or Basic option. Do not enter your actual JIRA Password. There is a link in the Connection Settings form to the article that explains how to generate an Api Token.

  • If you are connecting to JIRA Server, your login or password is incorrect. Check the username, re-enter the password and try again.

  • The JIRA URL starts with HTTP for a secure server, e.g. Change it to https: Always use HTTPS for JIRA Cloud.

  • If you are connecting to JIRA Cloud, please update to Ceptah Bridge 3.6.5 or newer or tick the 'Always use basic authentication' option in the connection settings.

Be mindful of the fact that there are global and project-level settings. The latter override the former, if provided. Make sure that you are testing the settings in effect.

Error 403 (Forbidden)

The most common cause of this error is a locked JIRA account. It gets locked after a few attempts to log in with invalid credentials. To resolve the issue, do the following:

  1. Open the effective connection settings, check the login and re-enter the password. You need to fix the password before unlocking the account. If you try to open the project settings while the password is invalid, the account will be locked again because Ceptah Bridge will try to access JIRA with the wrong credentials.

  2. Log in to JIRA through the web UI in the browser. If you are logged in, log out and log in again. If JIRA has added the CAPTCHA test to the regular log-in screen, that means that the account is locked. After you have logged in, the account will be unlocked.

  3. Test the connection in Ceptah Bridge and save the settings.

'JIRA' is missing from the ribbon (or from the menu for Project 2007 or earlier)

With Ceptah Bridge prior to version 3.8, in 99.99% of cases this is because the bitness of your MS Project is different from the bitness of the installed Ceptah Bridge package. If you are using Ceptah Bridge 3.7 or earlier and MS Project 2000, 2003, 2007 or the 32-bit version of 2010, 2013 or 2016, the 32-bit package needs to be installed even if the Windows is 64 bit. For MS Project 2010-2016 64 bit, use the 64-bit installer. No matter how confident you are that you are running the correct version, please go to FILE > Account > About Project and double-check. It will be right at the top.

If the bitness does not match, uninstall the product and install it using the right installer. Make sure that you uninstalled the other package before installing the correct one because failing to do so may create issues as well.

Also, the following may cause the problem.

  • Installing Ceptah Bridge 3.8 or older on top of Ceptah Bridge 64 bit. If this is the case, uninstall all Ceptah Bridge packages and install Ceptah Bridge 3.8.
  • Antivirus software may prevent the product from being installed correctly. Check the C:\Program Files\Ceptah\Msp JIRA Bridge folder (C:\Program Files (x86)\Ceptah\Msp JIRA Bridge on Windows 64 bit). There should be more than 30 files in the directory. If there are no files or only a few, disable the antivirus, uninstall the product, install it again and then turn the antivirus on.
  • The add-in can be disabled. To check its status by clicking FILE > Options > Add-Ins and then Com Add-ins > GO... in MS Project.
  • Some rogue 3-rd party add-ins can make the ADD-INS tab disappear completely. Try disabling 3-rd party add-ins if you can see that Ceptah Bridge is there and enabled.

Configuration and Synchronisation

How to create issues of different types in JIRA, including Sub-tasks

To create issues with a non-default issue type, map Issue Type to a custom text field and then populate the field with the desired issue type for each task:

Map issue type to field.

Populate the issue type column.

When createing Sub-tasks, please also make sure that the parent tasks of these tasks are or will be associated with JIRA issues (e.g. will not be skipped during synchronisation) because the new sub-tasks will need a parent.

How to make the Ceptah Bridge skip some tasks during synchronisation

To skip a particular task, enter 'skip' in the field containing issue key (Text10 by default).

How to synchronise a task hierarchy

There are different ways to organise issues into a hierarchy in Jira: Epic Links, Issue Links, Sub-tasks and Parent Links in Advanced Roadmaps. Ceptah Bridge supports all these Jira features.

Jira Cloud with Advanced Roadmaps

To create a hierarchy in Advanced Roadmaps for Jira Cloud, the only mapping you need to configure is the Parent mapping:

Parent mapping for Advanced Roadmaps in Cloud

This will take care of all levels, from Initiatives and Epics to Sub-tasks.

Jira Cloud with Issue Links

If you do not use Advanced Roadmaps, you can utilise Issue Links to connect the issues above Epics and below Stories to each other. The Stories can be linked to Epics with the standard Epic Links.

The below example will work for the Initiative > Epic > Story > Task (Bug) > Sub-task hierarchy.

Use Parent mapping to link Stories to Epics and Sub-tasks to tasks:

Parent mapping without Advanced Roadmaps in Cloud

Use Issue Links to connect everything else, including Epics to Initiatives. You will need to create a new link type as there is no suitable link type in a new Jira instance. In the below example, we have created a link type Hierarchy. It WILL NOT EXIST in your Jira. You will need to create it.

Issue Links in Cloud

To copy the hierarchy from MS Project to Jira, you will also need to map Issue Type to a custom text field and populate this field with the issue type for each task that is associated with an issue of a non-default issue type:

Map issue type to field.

Populate the issue type column.

That will ensure that the issue type filters in the Parent and Issue Link mappings above work correctly.

To create multiple issue types, e.g., Epics, Stories, Sub-tasks in Jira, you will need to map issue type and populate the mapped column, anyway.

If you are importing issues, map Issue Type as described above, and the issue type will be copied from Jira.

Jira Data Centre (Server)

For the self-hosted Jira, please review this tutorial.

No differences found during synchronisation

If you start synchronisation, but no changes are coming up in the list, most likely this is because you have not specified resources for the tasks in your project. By default, such tasks are skipped during synchronisation. The number of skipped tasks is displayed in the left bottom corner of the synchronisation window.

To solve the problem, either assign resources to the tasks or change the synchronisation settings.

"There is more than one issue type with the name "????" in JIRA" error

If you have multiple issue types with the same name, you need to use the following format for the Default Issue Type in the settings and the field mapped to Issue Type:

Task (<id>)

, where <id> is the ID of the issue type.

To see the available types and their IDs in the above format, just open the Default Project drop-down. The type with a small ID will be the standard Task, and the one with an ID in thousands will be the additional non-standard issue type.

The duplication should not happen unless you are using the new JIRA Agility Templates. If the duplication happened for a different reason, we recommend renaming one of the types.

How to map JIRA users to MS Project resources without using their logins as resource names

Please review this tutorial.

How to map MS Project Server Enterprise fields

The Enterprise Fields are supported, but they are not available in the drop-down lists. Please enter the field names manually where required.

Notes on the Time Tracking mappings

  • The most (if not the only) sensible way of mapping Remaining Estimate to the MS Project *Work fields is either

    • Remaining Estimate + Time Spent => Work or

    • Remaining Estimate <= Work - Time Spent,

    depending on the desired direction of synchronisation. This is the default configuration in Ceptah Bridge.

  • Always consider how fields are related in MS Project. For example, mapping both Work and Finish with the direction from JIRA to MS Project will not work properly because changing Work will change Finish and updating Finish resets Work. It is extremely unlikely that both mappings will produce compatible results, thus one of the fields will always be out of sync. The solution here is to configure one of the mappings to copy data from MS project to JIRA. This is a sensible thing to do because it will allow you utilising MS Project for what it is good at - planning and scheduling. It will take effort from JIRA, schedule the activity and send back the Finish date. Alternatively, you can import Due Date, calculate the effort required to arrive on it and publish the Remaining Estimate in JIRA.

  • It may appear logical to map Remaining Estimate to Remaining Work, but, in practice, that will not work because MS Project will automatically reflect any Remaining Work changes in the total Work field, and the task will grow or shrink even if the total effort in JIRA has not changed. Probably we should not have added the Remaining Work field to the dropdown box at all so that it would not confuse the users.

  • Mapping Original Estimate to Duration is not a good idea either. Firstly, because Original Estimate is original and is different from the actual effort. But most importantly, because they have a different measure - the JIRA estimates are man-hours, whereas MS Project Duration is just the number of working hours between Start and Finish. It is much better to update Work based on the values from JIRA and let MS Project calculate Duration and Finish for you. As an option, then you may want to set Due Date in JIRA to Finish from MS Project to close the loop.

  • A good fit for Original Estimate is Baseline Work.

How to leave Security Level, Components, Fix Versions or Affects Versions blank when a default value is specified

When an issue is created or synchronized and the mapped field in MS Project is blank, the JIRA field is set to the default value specified in the mappings.

To make the JIRA field empty regardless of the default settings, enter '(none)' in the respective column in MS Project.

How to map JIRA Issue Priority to MS Project Task Priority

It is not possible to map Issue Priority to Task Priority directly. However, Issue Priority can be mapped to a text field (e.g. Text3) and a macro that updates the task priority based on the text field can be written and run using the Ceptah Bridge events after synchronisation.

The macro should look as follows:

Sub OnSyncTaskAfterUpdate(Project As Project, Task As Task) Select Case task.Text3 Case "Blocker" task.Priority = 700 Case "Critical" task.Priority = 700 Case "Major" task.Priority = 500 Case "Minor" task.Priority = 300 Case "Trivial" task.Priority = 100 End Select End Sub

How to synchronise JIRA work log with MS Project task usage data on user by user basis

Please go to JIRA -> Project Settings, select the "Time tracking" tab, tick "Time Spent", select "Daily actual work" and then tick "For each assignment". This will populate the time scale entries for your tasks with the data from JIRA work log on user by user and day by day basis.

Please note that the option is disabled if the Assignee is mapped to MS Project Resource on the first tab page. You need to map assignee to a text field or avoid mapping it at all to enable the "For each assignment" option. The reason for the limitation is that MS Project allows assigning multiple resources to the same task while JIRA does not. "For each assignment" option implies associating multiple resources with the same task. At the same time, there is no way for the user to tell Ceptah Bridge which particular resource to use as assignee. For instance, it would not make sense to use the first resource from the Resource Names list as the order is simply alphabetical.

Purchasing and Maintenace

We have 10000 JIRA users. Which Ceptah Bridge licence do we need?

Your Ceptah Bridge licence should cover all MS Project users who will synchronise JIRA with MS Project on their computers. The total number of JIRA users and the number of JIRA instances does not affect the price.

What if I want to use Ceptah Bridge with multiple JIRA instances?

You can use Ceptah Bridge with multiple JIRA instances, and this does not affect the price.

If I use a desktop computer in the office and also have a laptop, which licence do I need?

These two computers will count as two separate users from the licensing point of view and will take two users out of the activations available on your licence.