IBM Engineering Workflow Management (EWM) Integration

This service allows you to go from GitLab to EWM work items mentioned in merge request descriptions and commit messages. Each work item reference is automatically converted to a link to the work item.

This IBM product was formerly named Rational Team Concert(RTC). This integration is compatible with all versions of RTC and EWM.

To enable the EWM integration, in a project:

  1. On the top bar, select Main menu > Projects and find your project.
  2. On the left sidebar, select Settings > Integrations.
  3. Select EWM.
  4. Select the checkbox under Enable integration.
  5. Fill in the required fields:

    • Project URL: The URL to the EWM project area.

      To obtain your project area URL, navigate to the path /ccm/web/projects and copy the listed project’s URL. For example, https://example.com/ccm/web/Example%20Project.

    • Issue URL: The URL to the work item editor in the EWM project area.

      The format is <your-server-url>/resource/itemName/com.ibm.team.workitem.WorkItem/:id. GitLab replaces :id with the issue number (for example, https://example.com/ccm/resource/itemName/com.ibm.team.workitem.WorkItem/:id, which becomes https://example.com/ccm/resource/itemName/com.ibm.team.workitem.WorkItem/123).

    • New issue URL: URL to create a new work item in the EWM project area.

      Append the following fragment to your project area URL: #action=com.ibm.team.workitem.newWorkItem. For example, https://example.com/ccm/web/projects/JKE%20Banking#action=com.ibm.team.workitem.newWorkItem.

  6. Select Save changes or optionally select Test settings.

Reference EWM work items in commit messages

To refer to work items, you can use any keywords supported by the EWM Git Integration Toolkit. Use the format: <keyword> <id>.

You can use the following keywords:

  • bug
  • defect
  • rtcwi
  • task
  • work item
  • workitem

Avoid using the keyword #. Learn more in the EWM documentation page Creating links from commit comments.