Access control: Workspace Owner Authorize GitLab account

1. Click the gear icon in the top-right corner. The settings window will appear.
   
2. Click Others under Marketplace.
   
3. Click Configure on the GitLab app.
   
4. Accept the terms.
   
5. Select Cloud or Self-Managed.
   
6. On click of Cloud, you will be redirected to GitLab.com.
   

Configure your account from the Self-Managed version of GitLab

1. Navigate to Settings in the upper-right corner in the self-managed version of GitLab.
   
2. Navigate to Access Token in the left panel.
   
3. Enable api and read_user scopes and create a new access token.
   
4. Copy and paste the Access Token from GitLab to Zoho Sprints.
   

Map your repositories to workspace repository

1. Click the gear icon in the top-right corner. The settings window will appear.
   
2. Select Others under Marketplace.
   
3. Select GitLab.
   

View the list of repositories in My Repository

1. Hover over the repository name.
   
2. Click the arrow icon next to the repository name to map the repository to your workspace.
   

Associate projects to workspace repository

You can associate a project to your workspace repository.

1. Go to GitLab.
   
2. View the list of repositories in your Workspace Repository.
   
3. Click the Associate Projects button. The projects listing will appear.
   
4. Select the projects and click Update.
   

Sync repository issues to projects

1. Go to GitLab.
   
2. Map repositories to your workspace.
   
3. Click the Associate Projects button. The project listing will appear.
   
4. Select project.
   
5. Click the toggle switch to enable Sync Only Bugs. (You can associate multiple projects to your repository. But, you can mark only one project to 'Sync Only Bugs'.)
6. Click Update.
   

Sync work items to GitLab repository

Two-way sync for fields 

1. Title
   
2. Description
   
3. Comments
   
4. Weight (Estimation Points) 
   
5. Start date
   
6. End date
   
7. Assignee
   

1. Only the repositories with "Sync Only Bugs" enabled will be listed in the Create Item window.
   
2. The estimation points that you define in Sprints will be synced to the nearest point in GitLab.
   
3. Status of the work items will be mapped to the open and closed status in GitLab.

Quick Commands in Zoho Sprints

The email address of the GitLab user should be registered with the Zoho Sprints team only then they can process the commits: #comment, #time, #status, and #priority.

Advanced commands

Note:

1. Users will receive a feed notification for any status updates executed through Merge requests.
   
2. Users can link new work items by editing the merge request's description.
   
3. The linked items cannot be reverted through quick commands from the merge request description. Users can remove them from the merge request tab in item details page.  
   

Attach commits from work item details section

1. Go to the work item details page.
   
2. Select GitLab from the tabs.
   
3. Click Attach Commit.
   
4. Enter the required details. * All the fields are mandatory.
   
5. Click Attach.
   

Attach merge requests from work item details section

1. Go to the work item details page.
   
2. Select GitLab from the tabs.
3. Click Attach Merge Request.
4. Enter the required details. * All the fields are mandatory.
5. Click Attach.

How to copy the work item ID with prefix? 

1. Navigate to a project.
   
2. Select an item.
   
3. On the Item details page, hover over the project name prefix.
   
4. Select Copy ID with prefix. 
   

Delete commits and merge request

You can delete the commit and merge request directly from the work item details page. Hover over the attached commit and merge request and click .

Access for commands

Adding comments

1. You must be an active user in the project to tag comments to work items in your commits.
   
2. Anyone can add comments to the work items in the backlog.
   
3. You must be a part of the sprint and have the work item assigned to you before you can add comments to it.
   
4. You can also add comments for unassigned work items.
   

Adding Log hours

1. You must be an active user in the project to add log hours to the work items.
   
2. You can log hours for the work items only in active sprint.
   
3. You must be a part of the sprint.
   
4. You can only add log hours for unassigned work items and the work items that are assigned to you.
   

Updating priority

1. When a priority contains space, add them in the quick command separated by '_'. For example: #SP-L1 #priority low_risk. Priorities are not case sensitive. 
2. You must be an active user in the project to update the priority of the work items.
   
3. You should be the admin, joint admin, or project manager to update the priority of the work items.
4. The priority name that you provide must be an existing priority in the project.
5. You can update the priority of the work items only for the active and upcoming sprints and the work items in the backlog.
6. You cannot update the priority of the work items if they are in the closed status.

Updating status

1. When a status contains space, add them in the quick command separated by '_'. For example: #SP-L1 #status to_do. Statuses are not case sensitive. 
2. You must be an active user in the project to update the status of the work items.
   
3. You can be a sprint owner, assignee, admin, manager, or sprint creator to update the status of the work items.
4. The status name that you mention must be an existing status in the project.
5. You can update the status of the work items only in active sprints.

CI/CD

1. Sign in to Zoho Sprints.
   
2. Select the CI/CD option in the left navigation panel. The tabs for CI/CD will appear.
3. Select GitLab tab.
4. Select a mapped repository. The pipeline and commits in the repository will appear.
5. Hover over pipeline to view details and stage.
6. Click the links to view the respective details.
   

Disassociate projects from repository

1. Go to GitLab.
   
2. Click the Associate Project button in your Workspace Repository.
   
3. Deselect the projects in the Associate Projects form.
   
4. Click Update.
   

1. Go to GitLab.
   
2. Click the project count next displayed.
   
3. Hover over the project that you want to dissociate.
4. Click Remove Project.

Remove repositories from team

1. Go to GitLab.
   
2. View the list of repositories in your Workspace Repository.
   
3. Hover over the repository name.
4. Click the arrow icon to the left end of the repository name to unmap the repository from the workspace.

What happens when the repository is removed from the workspace?

1. Go to GitLab.
   
2. Click at the bottom of My repository. A confirmation pop-up will appear.
   
3. Click Delete.

What happens when the authorization is removed?