Liez directement les Espaces aux référentiels Bitbucket pour toujours savoir quel travail est associé.

Les propriétaires et les administrateurs d'environnement de travail peuvent connecter les Espaces à leurs référentiels, permettant aux membres d'ajouter leur travail Bitbucket aux tâches.

Les tâches dans les Espaces avec un référentiel connecté peuvent être liées à des validations, des branches et des demandes de tirage.

Ce dont vous aurez besoin

• L'intégration Bitbucket est disponible sur chaque forfait ClickUp.
• Seuls les propriétaires et les administrateurs d'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 Bitbucket.
• Seuls les administrateurs de référentiels peuvent ajouter des référentiels Bitbucket à ClickUp.
• Seuls les propriétaires et les administrateurs d'environnement de travail peuvent modifier les paramètres d'environnement de travail dans le Centre d'applications.
• Seuls les propriétaires et administrateurs de l'environnement de travail peuvent ajouter et lier des référentiels aux espaces.

Types de connexion

Les fonctionnalités et commandes disponibles dépendent du type de connexion utilisé.

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

Configurez l'intégration

Il y a trois étapes pour configurer l'intégration Bitbucket dans ClickUp :

1. Connectez Bitbucket.
2. Attachez les référentiels Bitbucket à votre environnement de travail.
   

   Les référentiels sont nécessaires pour que ClickUp puisse automatiquement lier les demandes de tirage à leurs tâches ClickUp respectives.

3. Lier les référentiels Bitbucket aux Espaces ClickUp.

Vous pouvez éventuellement définir un format de nom de branche personnalisé. Ce format est utilisé dans le panneau d'application des tâches pour créer des branches directement depuis ClickUp.

Étape 1 : Connectez Bitbucket

Pour connecter Bitbucket depuis le Centre d'applications:

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

Étape 2 : Attachez les référentiels Bitbucket à votre environnement de travail

Seul le propriétaire de la connexion peut ajouter des référentiels. 

Attacher un référentiel ne donne pas aux utilisateurs de ClickUp l'accès à la base de code de votre référentiel.

Pour ajouter un référentiel à un environnement de travail :

1. Dans le Centre d'applications, recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Lier les référentiels aux Espaces, cliquez sur Ajouter un référentiel.
4. Sélectionnez le référentiel que vous souhaitez ajouter.
5. Répétez les étapes ci-dessus pour ajouter plus de référentiels.

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

Étape 3 : Lier les référentiels Bitbucket aux Espaces ClickUp

Après avoir ajouté des référentiels à votre environnement de travail, un administrateur peut ajouter chaque référentiel à un ou plusieurs Espaces. Chaque espace ClickUp peut avoir plusieurs référentiels ajoutés.

Vous pouvez ajouter ou retirer des référentiels des Espaces à tout moment.

Pour lier un référentiel à un Espace :

1. Dans le Centre d'applications, recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Connecter les référentiels aux Espaces, cliquez sur le nom du référentiel que vous souhaitez lier.
4. Cliquez sur + Ajouter un Espace et sélectionnez un Espace.
5. 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 Bitbucket dans le Centre d'applications. Lorsque les personnes créent des branches à partir des tâches ClickUp, elles utiliseront ce format.

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

Par exemple : CU-ae27de_Nom-automatique_John-smith

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

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

1. Recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Nom de branche auto-généré, entrez votre format de nom de branche préféré.
4. Cliquez sur Enregistrer.

Lier les tâches depuis Bitbucket

ClickUp associe automatiquement les nouvelles activités Bitbucket aux tâches si vous incluez un identifiant de tâche ClickUp valide dans une partie du titre de la demande de tirage, la description de la demande de tirage, le nom de la branche ou le message de validation.

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

Le commentaire sera publié en utilisant le compte Bitbucket de la personne qui a configuré le mappage du référentiel et de l'Espace.

L'identifiant de 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

Liez manuellement les tâches ClickUp avec les validations, les branches et les demandes de tirage Bitbucket depuis les tâches ClickUp. Assurez-vous que la tâche se trouve dans un Espace lié à un référentiel.

Pour lier une tâche :

1. Ouvrez la tâche.
2. Dans la barre latérale droite, cliquez sur l'icône Bitbucket .
   

   À 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 Bitbucket.
   
4. Collez le lien.
5. Dans le coin inférieur droit, cliquez sur Ajouter.

Activité de tâche ClickUp

Le fil d'activité des tâches peut parfois regrouper 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é Bitbucket :

• Cliquez sur Plus de mises à jour pour révéler l'activité qui a été cachée.
• Lorsqu'une branche est fusionnée, les validations s'affichent comme un seul élément d'activité dans le fil d'activité de la tâche.
  • Cliquez sur le lien vers tous les commits pour ouvrir un modal.
  • Cliquez sur une validation individuelle pour l'ouvrir dans Bitbucket.
• Filtrez l'activité de la tâche par éléments Git.
  

Activité manquante 

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

#{task_id}

CU-{task_id}

{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

préfixe-1

Vous pouvez lier manuellement les tâches ClickUp avec les validations, les branches et les demandes de tirage Bitbucket depuis la tâche ClickUp.

Aperçus de lien Bitbucket

Lorsque vous collez un lien Bitbucket 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 tirage Bitbucket depuis ClickUp

Créez de nouvelles branches et demandes de tirage directement depuis les tâches. Assurez-vous que la tâche se trouve dans un Espace lié à un référentiel.

Pour créer une branche ou une demande de tirage :

1. Ouvrez une tâche et cliquez sur l'icône Bitbucket.
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 Bitbucket.
4. Choisissez l'une des options suivantes :
   • Nouvelle branche Bitbucket
   • Nouvelle demande de tirage Bitbucket
5. Nommez la branche ou la demande de tirage.
6. Sélectionnez un référentiel et remplissez les informations. Ajoutez une branche source et une branche de destination si applicable.
7. Cliquez sur Créer.

Panneau d'application Bitbucket dans les tâches

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

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

Mettre à jour les statuts des tâches depuis Bitbucket

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 tirage. ClickUp détecte automatiquement la nouvelle activité Bitbucket et l'associe aux tâches si vous incluez un identifiant de tâche valide dans une partie du titre de la demande de tirage, de la description de la demande de tirage ou du message de validation.

L'identifiant de 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 tirage.
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 Bitbucket de cet article peuvent être utilisés. Pour garantir un formatage correct, ne ajoutez pas d'espace entre l'identifiant de la tâche et les informations de statut.

Gérez les problèmes, les branches, les demandes de tirage et les validations Bitbucket depuis ClickUp

Après avoir lié des problèmes, des branches, des demandes de tirage ou des validations, ils s'affichent sur le côté droit de votre tâche lorsque vous cliquez sur l'icône Bitbucket. 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 Bitbucket. Contactez le propriétaire de votre environnement de travail ou l'administrateur pour demander une mise à niveau vers membre de l'environnement de travail.

Une fois qu'un élément Bitbucket 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 d'auteur
• Tout examinateur assigné
• Lien créé
• Référentiel
• 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 d'auteur
• Créateur de lien
• Référentiel
• URL

Informations sur la demande de tirage

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

• La personne qui a ouvert la demande de tirage, connue sous le nom d'auteur
• Tout examinateur assigné
• Les assignés
• Modifications de ligne
• Lien créé
• Référentiel
• Branche source
• Branche cible
• Le statut de la demande de tirage
• 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
• Modifications de ligne
• Lien créé
• Référentiel
• URL

Ajoutez votre compte Bitbucket à ClickUp

Configurez une connexion personnelle en utilisant votre compte Bitbucket.

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

1. Recherchez et sélectionnez Bitbucket.
2. Cliquez sur Connecter.
3. Connectez-vous à Bitbucket et autorisez ClickUp.
4. Cliquez sur Terminé.

Problèmes de connexion

Parfois, le mauvais compte Bitbucket est lié ou il y a un problème avec la connexion. Pour corriger les erreurs de connexion, essayez de déconnecter et de reconnecter vos référentiels ou votre compte entier.

Ces actions n'affectent pas la capacité de quiconque à accéder aux référentiels en utilisant leur compte Bitbucket via Bitbucket.

Pour déconnecter un référentiel du Centre d'applications :

1. Recherchez et sélectionnez Bitbucket.
2. Dans le coin supérieur droit, cliquez sur Paramètres.
3. Sous Référentiels, cliquez sur le menu points de suspension ... à droite du référentiel.
4. Cliquez sur Supprimer de ClickUp.

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

Déconnectez l'intégration Bitbucket

Si vous n'avez plus besoin d'accéder aux fichiers Bitbucket dans ClickUp, vous pouvez déconnecter l'intégration depuis le Centre d'applications :

1. Recherchez et sélectionnez Bitbucket.
2. Sélectionnez l'onglet Environnement de travail.
   

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

3. À côté de Connecté, cliquez sur le menu points de suspension ....
4. Sélectionnez Déconnecter.
5. Pour confirmer, cliquez sur Déconnecter.