debian-mirror-gitlab/doc/user/project/integrations/squash_tm.md

stage	group	info
Manage	Import and Integrate	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Squash TM (FREE SELF)

Introduced in GitLab 15.10.

When Squash TM (Test Management) integration is enabled and configured in GitLab, issues (typically user stories) created in GitLab are synchronized as requirements in Squash TM and test progress is reported in GitLab issues.

Configure Squash TM

1. Optional. Ask your system administrator to configure a token in the properties file.
2. Follow the Squash TM documentation to:

   1. Create a GitLab server.

   2. Enable the Xsquash4GitLab plugin

   3. Configure a synchronization.

   4. From the Real-time synchronization panel, copy the following fields to use later in GitLab:

      • Webhook URL.
      • Secret token if your Squash TM system administrator configured one at step 1.

Configure GitLab

1. On the top bar, select Main menu > Projects and find your project.

2. On the left sidebar, select Settings > Integrations.

3. Select Squash TM.

4. Ensure that the Active toggle is enabled.

5. In the Trigger section, indicate which type of issue is concerned by the real-time synchronization.

6. Complete the fields:

   • Enter the Squash TM webhook URL,
   • Enter the secret token if your Squash TM system administrator configured it earlier.