Once linked (see the setup article) Enzyme will let you associate merged pull requests with Design Outputs and optionally, create tracing dependences to Requirements.
There are two methods for linking GitLab pull requests to Enzyme:
- Enzyme user interface linking - ideal for quality owners/non-developers
- Developer centric tags in pull requests (similar to GitHub cross org references)
Enzyme UI Linking
- Navigate to Product > Design Control
- Select the Design Output card that you want to associate with a pull request
- Open it and click the
Link to GitLab PRbutton. This provide you a modal to select repository and pull request to trace to this Design Output.
- Observe the "Link to GitLab" button. Click it and select the pull request. Then Save.
This will now serve as a trace from your Design Output to the merged code that implements.
Developer centric Pull Request Tagging
From GitLab when creating a merge request you can insert a GitHub style cross repository reference tag. We support two tags:
- A tag to target specific Design Outputs (required):
- A tag to to trace Design Output to a Requirement (optional):
Product short codes are located in the Product > Design Control > Product Switcher, see this article.
Note: You must turn on automatic tracing on the integrations panel;
For more context on how dependencies work in Enzyme please read What are the Tracing Dependencies in Design Control?
If the requirement tag is provided, Enzyme will know to create a tracing dependency between the Design Output and the Requirement it satisfies. This is helpful for large teams where developers may not have direct access to Enzyme.