GitLab

Go back to Integria IMS Documentation Index

Integria IMS allows the display of tickets created in GitLab. Thanks to this feature you may have all tickets visible within the same tool.

Configuration

In order to access the list of GitLab tickets, the first thing we have to do is activate it in the Setup in the corresponding tab and enter the necessary data to connect to GitLab.

You need an access token that belongs to a GitLab user with permissions to see the tickets of the project that interest you.

Creation of personal access token in GitLab:

  1. Login in GitLab.
  2. In the upper right corner, select the avatar icon.
  3. Edit profile.
  4. Access tokens.
  5. Enter name and optional expiration date for the token.
  6. Select the desired scopes.
  7. Save the personal access token in a safe place. After leaving the page, you will no longer have access to the token.

You also need the project's URL. Example:

https://example.es:8080/api/v4/projects/1/

And the base URL of the images to be able to load the images that contain the tickets in their description and in their comments. Example:

https://example.es:8080/artica/integria/

In order to access the menu in the following image, in addition to having the token active in the Configuration section, have the appropriate profile applied or be an administrator user.

Profile management

To give access to the GitLab menu, in addition to activating the configuration token, assign the permission to the desired profiles.

Here is an example profile for the ticket view:

Mark the option Gitlab View. And as side note, remember that it will be necessary to have permissions on the Tickets section to be able to access the list of GitLab tickets as shown in the previous image.

Uploading tickets from GitLab to Integria IMS

To upload tickets from GitLab, just run the file found in operation/incidents/load_issues_gitlab.php from a terminal or by accessing it from Integria IMS.

Once uploaded, you may check the list of tickets from GitLab.

Ticket display

The ticket list is accessed from the Support menu –> GitLab Issues.This is a list only for ticket display. It is not possible to edit it. You may narrow down the search using the filters: keyword in title or description, ticket status, milestone the ticket belongs to, tags assigned to it and creation date range.

To see the detail, click on the GitLab ID or on the ticket title.

The ticket details, its description and comments, if any, are displayed.

Go back to Integria IMS Documentation Index