GitLab integration allows to import Projects, Branches and Merge Requests into Fibery. The most interesting case is to import Merge Requests and attach them to real work items, like Features, User Stories or Tasks. Thus you will see Merge Requests statuses right in Fibery.
Import GitLab data
GitLab integration can be enabled inside any App. Here we will create a new GitLab App and fetch data from GitLab:
In case of success, in the left area you will see Table Views with all Projects, Branches and Merge Requests.
Feel free to create other Views to see, for example, Open Merge Requests. These GitLab Types are similar to all the other Types in Fibery, so you can create custom Views and connect to other Types.
Link Merge Requests to Features (or any other Types)
To have this connections, you have to encode Feature Id in your Merge Requests. In our team we include Feature Id into a Merge Requests name, like this:
[feature/2013] Documents ant Whiteboards collections on entity as extensions
The main idea is to extract Feature Id from Merge Request name and link Feature and Merge Request Types via automatic rule. This is a two-steps process.
Step 1. Create Feature Id formula field inside Merge Request.
Open any Merge Request and add a new formula, in our case formula will look like this:
Here is the formula for your convenience:
If(StartsWith(Name,"\[feature/"),Trim(ReplaceRegex(Name,"\[feature\/(\d+).+"," \1 ")),"")
Step 2. Create automatic connection between Merge Request and Feature.
Inside a Merge Request create a new Relation field, set relation to Feature and set automatic rule to match any Merge Request with a Feature by Id:
As a result, you will have the following info:
Inside a Feature you will see a list of Merge Requests:
Let us know if you need something else from GitLab integration.