Liez directement les Espaces aux projets GitLab pour toujours savoir quel travail est lié.

Tâches dans les Espaces avec un projet connecté peuvent être liées avec des validations, des branches et des demandes de fusion.

Ce dont vous aurez besoin

• L'intégration GitLab est disponible sur tous les forfaits ClickUp.
• Seuls les propriétaires et les administrateurs de l'environnement de travail peuvent ajouter des projets Gitlab dans le Centre d'applications.
• Les propriétaires et administrateurs d'environnement de travail peuvent connecter les Espaces à leurs projets, permettant aux membres d'ajouter leur travail GitLab aux tâches.
• Seuls les propriétaires et les administrateurs de l'environnement de travail peuvent créer des connexions d'environnement de travail. Plusieurs connexions d'environnement de travail sont autorisées.
• Les membres et plus peuvent créer des connexions personnelles.

• Les invités et les membres limités ne peuvent pas utiliser l'intégration GitLab.

Types de connexion

Les fonctionnalités et commandes disponibles dépendent du type de connexion que vous utilisez.

Les commandes ClickUp pour GitLab sont disponibles uniquement pour les connexions personnelles. Les données ne sont pas liées aux connexions de l'environnement de travail. Lorsqu'un utilisateur a une connexion personnelle activée et exécute une commande GitLab, il verra une liste d'options, comme les listes de projets, auxquelles il est autorisé à accéder dans GitLab.

Configurez l'intégration

Il y a trois étapes nécessaires pour configurer l'intégration de GitLab dans ClickUp :

1. Connectez GitLab.
2. Associez des projets GitLab à votre environnement de travail.
   

   Les projets sont nécessaires pour que ClickUp puisse automatiquement lier les demandes de fusion à leurs tâches ClickUp respectives.

3. Liez les projets GitLab aux espaces ClickUp.
4. Vous pouvez également définir un format de nom de branche personnalisé.

Étape 1 : Connecter GitLab

Pour connecter GitLab depuis le Centre d'applications:

1. Recherchez et sélectionnez GitLab.
2. Selon le type de connexion souhaité, sélectionnez l'onglet Personnel ou Environnement de travail.
3. Choisissez comment vous souhaitez autoriser :
   • Compte GitLab: Autorisez en utilisant votre compte GitLab.com.
   • Version auto-hébergée: Autoriser en utilisant une URL GitLab personnalisée.
4. Cliquez sur Suivant.
5. Autorisez ClickUp.
6. Cliquez sur Terminé.

Étape 2 : Associez des projets GitLab à votre environnement de travail

Seul le propriétaire de la connexion peut ajouter des projets. Joindre un projet ne donne pas aux utilisateurs de ClickUp l'accès à la base de code de votre référentiel.

Pour garantir que tous les projets GitLab soient affichés dans le Centre d'applications, définissez des permissions individuelles pour chaque projet au lieu d'utiliser des permissions de groupe.

Pour ajouter un projet à un environnement de travail :

1. Dans le Centre d'applications, recherchez et sélectionnez GitLab.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Connecter les Projets aux Espaces, cliquez sur Ajouter un projet.
4. Sélectionnez le projet que vous souhaitez ajouter.
5. Répétez les étapes ci-dessus pour ajouter d'autres projets.

Si vous ne voyez pas les projets corrects, assurez-vous d'être connecté au bon compte. Un propriétaire de l'environnement de travail ou un administrateur doit sélectionner chaque projet à connecter. Les projets liés peuvent être consultés dans le Centre d'applications.

Étape 3 : Lier les projets GitLab aux espaces ClickUp

Après avoir ajouté des projets à votre environnement de travail, un administrateur peut ajouter chaque projet à un ou plusieurs espaces. Chaque espace ClickUp peut avoir plusieurs projets ajoutés.

Vous pouvez ajouter ou retirer des projets des espaces à tout moment.

Pour lier un projet à un espace :

1. Dans le Centre d'applications, recherchez et sélectionnez GitLab.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Connecter les Projets aux Espaces, cliquez sur le nom du projet que vous souhaitez lier.
4. Cliquez sur Ajouter un Espace et sélectionnez un Espace. Répétez cette étape pour ajouter d'autres Espaces.

Définissez le format de votre nom de branche

Si votre organisation utilise un format spécifique pour les noms de branches, vous pouvez le définir depuis la page GitLab dans le Centre d'applications. Lorsque les gens créent des branches à partir de tâches ClickUp, elles utiliseront ce format.

Le format par défaut est : :taskId:_:taskName:_:username:

Par exemple : CU-ae27de_Auto-generated-naming_John-smith

Les options disponibles sont présentées dans le tableau suivant :

Pour définir votre format de nom par défaut depuis GitLab dans le Centre d'applications :

1. Recherchez et sélectionnez GitLab.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Nom de branche auto-généré, saisissez le format de nom de branche que vous préférez.
4. Cliquez sur Enregistrer.

Liez les tâches depuis GitLab

ClickUp associe automatiquement les nouvelles activités GitLab aux tâches si vous incluez un identifiant de tâche ClickUp valide dans n'importe quelle partie du titre de la demande de fusion, de la description de la demande de fusion, du nom de la branche ou du message de validation.

Lorsqu'un identifiant de tâche ClickUp est inclus dans une demande de fusion, un commentaire avec un lien vers la tâche ClickUp sera publié dans la demande de fusion. Un lien ne s'affichera pas lors du collage manuel d'une demande de fusion dans une tâche ClickUp.

Le commentaire sera publié en utilisant le compte GitLab de la personne qui a configuré le projet et la correspondance de l'Espace.

L'identifiant de la tâche doit être formaté en utilisant l'une de ces options :

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

eng-123

#eng-123

Lier les tâches de ClickUp

Vous pouvez également lier manuellement les tâches ClickUp avec les validations, les branches et les demandes de fusion GitLab depuis la tâche ClickUp. Assurez-vous que la tâche se trouve dans un espace qui est lié à un projet.

Pour lier une tâche :

1. Ouvrez une tâche et cliquez sur l'icône GitLab à droite.
2. À droite, vous verrez des noms de branches et des messages de validation suggérés que vous pouvez copier dans votre presse-papiers. Vous pouvez également copier l'identifiant de la tâche ici.
3. Dans le coin inférieur droit, cliquez sur Ajouter un lien GitLab.
   
4. Collez un lien.
5. Dans le coin inférieur droit, cliquez sur Ajouter.

Activité de tâche ClickUp

Le flux d'activité des tâches regroupe parfois des éléments d'activité similaires pour vous montrer les détails les plus importants.

Vous pouvez prendre les actions suivantes pour localiser l'activité GitLab :

• Cliquez sur Plus d'actualisations pour révéler des activités qui ont été cachées.
• Lorsqu'une branche est fusionnée, les validations apparaissent comme un élément d'activité unique dans le fil d'activité de la tâche.
  • Cliquez sur le lien vers tous les commits pour ouvrir un menu.
  • Cliquez sur un commit individuel pour l'ouvrir dans GitLab.
• Filtrer l'activité de la tâche par éléments Git.

Activité manquante 

Si vous ne trouvez pas certaines activités, assurez-vous de bien utiliser l'identifiant de tâche ClickUp pour lier l'activité dans GitLab. Vous pouvez utiliser l'une de ces trois options pour référencer vos tâches ClickUp dans les validations, les noms de branches et les demandes de fusion :

#{task_id}

CU-{task_id}

{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

préfixe-1

Vous pouvez lier manuellement les tâches ClickUp aux validations, branches et demandes de fusion GitLab depuis la tâche ClickUp.

Aperçus de lien GitLab

Lorsque vous collez un lien GitLab dans une tâche ClickUp, Chat, ou Doc, vous verrez l'option de le coller comme aperçu, mention ou URL.

Créez des problèmes, des branches et des demandes de fusion GitLab depuis ClickUp

Vous pouvez également créer de nouveaux problèmes, branches et demandes de fusion directement depuis les tâches. Assurez-vous que la tâche se trouve dans un espace qui est lié à un projet.

Pour créer un problème, une branche ou une demande de fusion :

1. Ouvrez une tâche et cliquez sur l'icône GitLab.
2. À droite, vous verrez des noms de branches et des messages de validation suggérés que vous pouvez copier dans votre bloc-notes. Vous pouvez également copier l'identifiant de la tâche ici.
3. Dans le coin inférieur droit, cliquez sur Ajouter un lien GitLab.
4. Choisissez l'une des options suivantes :
   • Nouvelle branche GitLab
   • Nouvelle demande de fusion GitLab
   • Nouveau problème GitLab
5. Nommez la branche, la demande de fusion, ou le problème.
6. Sélectionnez un projet et remplissez les informations. Ajoutez une branche source et une branche de destination si applicable.
7. Dans le coin inférieur droit, cliquez sur Créer.

Panneau de l'application GitLab dans les tâches

Après avoir collé votre premier lien GitLab dans une description de tâche ou un commentaire, vous verrez une nouvelle icône GitLab dans la barre latérale droite de toute tâche qui se trouve dans les Espaces connectés aux projets. Vous pouvez cliquer sur cette icône à tout moment pour voir chaque lien GitLab publié dans la tâche.

L'activité des tâches GitLab utilise le nom d'utilisateur ClickUp de la personne, ou leur nom d'utilisateur GitLab s'ils n'ont pas de compte ClickUp.

Mettez à jour les statuts des tâches depuis GitLab

Vous pouvez mettre à jour le statut d'une tâche ClickUp lorsque vous liez une validation, poussez une validation ou créez une demande de fusion. ClickUp détecte automatiquement les nouvelles activités GitLab et les associe aux tâches si vous incluez un identifiant de tâche valide dans une partie du titre de la demande de fusion, la description de la demande de fusion, le nom de la branche ou le message de validation.

L'identifiant de la tâche doit être formaté en utilisant l'une de ces options :

#{task_id}[statut]

CU-{task_id}[statut]

{custom_task_id}[statut]

#{custom_task_id}[statut]

Pour mettre à jour un statut de tâche :

1. Ajoutez l'identifiant de tâche ClickUp dans n'importe quelle partie du message de validation ou de la demande de fusion.
2. Incluez le statut de la tâche mis à jour entre crochets.

Par exemple : #ud5b[prêt]

Tous les formats listés dans la section Lier les tâches depuis GitLab de cet article peuvent être utilisés. Pour garantir un formatage correct, ne pas ajouter d'espace entre l'identifiant de tâche et les informations de statut.

Gérez les problèmes, les branches, les demandes de fusion et les validations GitLab depuis ClickUp

Après avoir lié des problèmes, des branches, des demandes de fusion ou des validations, ils s'affichent sur le côté droit de votre tâche lorsque vous cliquez sur l'icône GitLab. Utilisez le menu points de suspension ... pour copier le lien ou supprimer l'élément.

Si vous avez rejoint l'environnement de travail en tant qu'invité, vous ne pourrez pas utiliser l'intégration GitLab. Contactez le propriétaire de votre environnement de travail ou l'administrateur pour demander une mise à niveau en tant que membre de l'environnement de travail.

Une fois qu'un élément GitLab est lié, les informations suivantes sont affichées dans votre tâche ClickUp :

Informations sur le problème

Après qu'un problème soit lié, vous pouvez voir les détails suivants :

• La personne qui a ouvert le problème, connue sous le nom de l'auteur
• Projet
• Le statut du problème
• URL

Informations sur la branche

Après qu'une branche soit liée, vous pouvez voir les détails suivants :

• La personne qui a créé la branche, connue sous le nom de l'auteur
• Créateur du lien
• Projet
• URL

Informations sur la demande de fusion

Après qu'une demande de fusion soit liée, vous pouvez voir les détails suivants :

• La personne qui a ouvert la demande de fusion, connue sous le nom d'auteur
• Tout examinateur assigné
• Projet
• Le statut de la demande de fusion
• URL

Informations sur la validation

Après qu'une validation soit liée, vous pouvez voir les détails suivants :

• La personne qui a créé la validation, connue sous le nom d'auteur
• Changements de ligne
• Projet
• URL

Ajoutez votre compte GitLab à ClickUp

Les membres de l'environnement de travail peuvent lier leurs comptes GitLab à leur compte ClickUp à l'avance ou lorsqu'ils créent une branche ou une demande de fusion.

Pour ajouter votre compte GitLab depuis le Centre d'applications :

1. Recherchez et sélectionnez GitLab.
2. À côté de Créer une connexion personnelle, cliquez sur Connecter.
3. Connectez-vous à GitLab et autorisez ClickUp.
4. Cliquez sur Terminé.

Affichez les demandes de fusion en vue Liste ou Tableur.

Ajoutez la colonne des demandes de tirage à toute vue Liste ou vue Tableur pour afficher rapidement vos demandes de fusion GitLab.

Problèmes de connexion

Parfois, le mauvais compte GitLab est lié ou il y a un problème avec la connexion. Dans ce scénario, vous pouvez essayer de déconnecter et de reconnecter vos projets ou votre compte entier.

Ces actions n'affectent pas la capacité des autres à accéder aux projets via leur compte GitLab sur GitLab.

Pour déconnecter un projet :

1. Depuis le Centre d'applications, sélectionnez GitLab.
2. Dans le coin supérieur droit, cliquez sur Paramètres.
3. Sous Projet, cliquez sur le menu points de suspension ... à droite du projet.
4. Cliquez sur Supprimer de ClickUp.

La section ci-dessous comprend des instructions pour déconnecter votre compte entier.

Déconnectez l'intégration GitLab

Si vous n'avez plus besoin d'accéder aux fichiers GitLab dans ClickUp, vous pouvez déconnecter l'intégration de votre environnement de travail.

Seuls les propriétaires et les administrateurs peuvent déconnecter les connexions d'environnement de travail.

Depuis le Centre d’applications :

1. Recherchez et sélectionnez GitLab.
2. Sélectionnez l'onglet Environnement de travail.
3. À côté de Connecté, cliquez sur le menu ellipsis ....
4. Sélectionnez Déconnecter.
5. Pour confirmer, cliquez sur Déconnecter.