The EWM integration 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:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > Integrations.
- Select EWM.
- Under Enable integration, select the Active checkbox.
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/projectsand copy the listed project’s URL. For example,
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
:idwith the issue number (for example,
https://example.com/ccm/resource/itemName/com.ibm.team.workitem.WorkItem/:id, which becomes
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,
- Optional. Select Test settings.
- Select Save changes.
To refer to work items, you can use any keywords supported by the EWM Git Integration Toolkit.
Use the format:
You can use the following keywords:
Avoid using the keyword
#. For more information, see
Creating links from commit comments.