Configuring traceability from work items to Gerrit commits

You can configure Gerrit to enable linking of Git commits to IBM® Engineering Workflow Management (Engineering Workflow Management) work items.

Before you begin

Make sure that you have completed the tasks described in Configuring the basic integration with Gerrit.

A shared user base, such as a common LDAP, between Engineering Workflow Management and Gerrit server is optional for linking Git commits or patchsets to work items through ref-updated script hook, patchset–created script hook, or webhook. It is recommended to add an Engineering Workflow Management functional user ID to the webhook, ref-updated script hook, or patchset-created script hook if there is no shared user base between Engineering Workflow Management and Gerrit server.

You must register every Git repository with Engineering Workflow Management to enable linking of Git commits in that repository to Engineering Workflow Management work items.

You must configure every Git repository with Engineering Workflow Management-specific configuration variables or webhook configuration details if you are using ref-updated or patchset-created script hooks to link Git commits or patchsets to EWM work items.

Traceability from Gerrit patchsets, Git commits to work items Configuring the basic integration with Gerrit Integrate Gerrit with EWM Prerequisites for integrating with Gerrit Configuring ref-updated hooks to link Git commits to Engineering Workflow Management work items Configuring patchset-created hooks to link patchsets to Engineering Workflow Management work items Configuring web hooks to link patchsets to Engineering Workflow Management work items Validating the link

About this task

You must use ref-updated script hooks to link Git commits to Engineering Workflow Management work items. You can use either the patchset-created script hook or a webhook to link Gerrit patchsets to Engineering Workflow Management work items.