Engineering Workflow Management (EWM)
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
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, go 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 becomeshttps://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
.
-
-
Optional. Select Test settings.
-
Select Save changes.
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 #
. For more information, see
Creating links from commit comments.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support