Tutorial

Enterprise Resources

Learn how to map JIRA users to Enterprise Resources in Microsoft Project Server or Project Online and import JIRA users into the Resoure Pool.

More tutorials

Ceptah Bridge tutorial

Introduction

Project Professional 2013 and Project Server 2013 were used to produce the demo (for other versions, see a note at the end).

Steps

  1. Open PWA (Project Server web interface), then click Settings (gear symbol) > PWA Settings.

    PWA Settings

  2. Click 'Enterprise Custom Fields and Lookup Tables'.

    PWA Settings

  3. Click 'New Field'.

    New Field button

  4. Enter a name for the field that will store JIRA logins for enterprise resources. Select 'Resource' in the 'Entity' box and make sure that the field type is 'Text'.

    Create New Enterprise Resource field

    Save the field configuration.

  5. The new field has been added.

    New Enterprise Resource field

  6. Click 'Resources' on the left-hand side, select the resources that you want to map to JIRA users, then click the 'Resources' ribbon page caption at the top for the ribbon to appear, and press 'Open' to open the Enterprise Resource Pool.

    Open Enterprise Resource Pool

  7. The enterprise resources will open in a sheet in Microsoft Project Professional. Add the JiraLogin column to the view to make sure that the latest set of enterprise fields is loaded. If Microsoft Project Professional (client application) was open before the enterprise field was added, you will need to close the application and reopen it for the new field to become available.

    Enterprise Resources in MS Project

  8. Enter JIRA logins for existing resources in the JiraLogin column to link the resources to JIRA users.

    Linking manually Microsoft Project Server Enterprise Resources with JIRA users

  9. You can also import Enterprise Resources directly from JIRA. Select 'JIRA' > 'Import Users' in the MS Project ribbon.

    Import Users menu item

  10. As there are no settings for the project yet (which is not a real project anyway), the following dialog will pop up.

    Create Mappings

    Press OK.

  11. Enter any valid values into the mandatory fields. For the Assignee mapping, select 'Username' or 'Account Id' on the JIRA side and 'Resource Field' on the Microsoft Project side and type in 'JiraLogin' manually into the 'Resource Field' box. Note that the field name will not be available in the dropdown.

    Mappings for user import

    Save the mappings. They will be disposed of once the resource pool is closed and will not be saved anywhere.

  12. The User Import window will appear. Enter search text, select the users to be imported and press 'Import'.

    Import users

    Close the window.

  13. The new resources will be added to the resource sheet and automatically mapped to JIRA users.

    Updated enterprise resource sheet

    Check in the resources into the Enterprise Resource Pool.

  14. Reload the Resource Pool page in PWA. The resources have been added to the Enterprise Resource Pool.

    Updated enterprise resource pool

  15. Now, when configuring synchronisation mappings for your projects, make sure that JIRA Assignee is mapped to MS Project Resource using the enterprise resource field 'JiraLogin' (or whatever field you are using for storing JIRA logins).

    Assignee mapping

  16. Try to synchronise a task assigned to an enterprise resource that is linked to a JIRA user. Note that Ceptah Bridge will use the login to populate the Assignee field in JIRA.

    Proposed changes

The process will be quite similar for Project Server 2007 and 2010. It is completely different for Project Server 2003, though. To map Project Server 2003 enterprise resources, refer to the Assignee Mapping tutorial. The only difference with the local mapping method in this case will be that you will need to use an enterprise text field to store JIRA logins (e.g. EnterpriseText10 instead of Text10).