Associez directement des Espaces à des dépôts Bitbucket (repos) pour toujours savoir quel travail est associé.

Les propriétaires et administrateurs d'Environnement de travail peuvent connecter des Espaces à leurs dépôts, ce qui permet aux membres d'ajouter leur travail Bitbucket aux tâches.

Les tâches dans des Espaces ayant un dépôt connecté peuvent être associées à des commits, des branches et des pull requests.

Ce dont vous aurez besoin

• L'intégration Bitbucket est disponible sur tous les plans ClickUp.
• Seuls les propriétaires et administrateurs d'Environnement de travail peuvent créer des connexions à l'Environnement de travail. Plusieurs connexions à l'Environnement de travail sont autorisées.
• Les membres et les rôles supérieurs 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 dépôt peuvent ajouter des dépôts Bitbucket à ClickUp.
• Seuls les propriétaires et administrateurs d'Environnement de travail peuvent modifier les Paramètres de l'Environnement de travail dans l'App Center.
• Seuls les propriétaires et administrateurs d'Environnement de travail peuvent ajouter des dépôts et les lier à des Espaces.

Types de connexion

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

Les commandes ClickUp pour Bitbucket sont uniquement disponibles pour les connexions personnelles. Les données ne sont pas liées aux connexions de l'Environnement de travail. Lorsqu'un utilisateur dispose d'une connexion personnelle active et exécute une commande Bitbucket, il voit une liste d'options, telles que des listes de dépôts, auxquelles il est autorisé à accéder dans Bitbucket.

Configurer l'intégration

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

1. Connecter Bitbucket.
2. Associer des dépôts Bitbucket à votre Environnement de travail. Les dépôts sont nécessaires pour que ClickUp puisse lier automatiquement les pull requests aux tâches ClickUp correspondantes.
3. Lier des dépôts Bitbucket à des Espaces ClickUp.

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

Étape 1 : connecter Bitbucket

Pour connecter Bitbucket depuis l'App Center :

1. Recherchez et sélectionnez Bitbucket.
2. Selon le type de connexion souhaité, sélectionnez l'onglet Personnel ou Environnement de travail.
3. Choisissez votre méthode d'autorisation :
   • Compte Bitbucket : autorisez l'accès à l'aide de votre compte bitbucket.org.
   • Version auto-hébergée : autorisez l'accès à l'aide d'une URL Bitbucket personnalisée.

     

4. Cliquez sur Suivant.
5. Autorisez ClickUp.
6. Cliquez sur Terminé.

Étape 2 : associer des dépôts Bitbucket à votre Environnement de travail

Seul le propriétaire de la connexion peut ajouter des dépôts.

Associer un dépôt ne donne pas aux utilisateurs ClickUp accès au code source de votre dépôt.

Pour ajouter un dépôt à un Environnement de travail :

1. Dans l'App Center, recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Connecter des dépôts aux Espaces, cliquez sur Ajouter un dépôt.
4. Sélectionnez le dépôt que vous souhaitez ajouter.
5. Répétez les étapes ci-dessus pour ajouter d'autres dépôts.

Si vous ne voyez pas les bons dépôts, vérifiez que vous êtes connecté au bon compte. Un propriétaire ou un administrateur de l'Environnement de travail doit sélectionner chaque dépôt à connecter. Les dépôts liés sont consultables dans l'App Center.

Étape 3 : lier des dépôts Bitbucket à des Espaces ClickUp

Après avoir ajouté des dépôts à votre Environnement de travail, un administrateur peut ajouter chaque dépôt à un ou plusieurs Espaces. Chaque Espace ClickUp peut recevoir plusieurs dépôts.

Vous pouvez ajouter ou retirer des dépôts des Espaces à tout moment.

Pour lier un dépôt à un Espace :

1. Dans l'App Center, recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Connecter des dépôts aux Espaces, cliquez sur le nom du dépôt 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éfinir le format du 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 l'App Center. Lorsque des personnes créent des branches à partir de tâches ClickUp, ce format sera utilisé.

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 Bitbucket dans l'App Center :

1. Recherchez et sélectionnez Bitbucket.
2. En haut à droite, cliquez sur Paramètres.
3. Sous Nom de branche généré automatiquement, saisissez le format de nom de branche souhaité.
4. Cliquez sur Enregistrer.

Lier des 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 le titre de la pull request, la description de la pull request, le nom de la branche ou le message de commit.

Lorsqu'un identifiant de tâche ClickUp est inclus dans une pull request, un commentaire contenant un lien vers la tâche ClickUp est publié dans la pull request. Aucun lien ne s'affiche si vous collez manuellement une pull request dans une tâche ClickUp.

Le commentaire est publié à l'aide du compte Bitbucket de la personne qui a configuré le dépôt et le mappage d'Espace.

L'identifiant de tâche doit être formaté selon l'une des options suivantes :

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

eng-123

#eng-123

Lier des tâches depuis ClickUp

Liez manuellement des tâches ClickUp à des commits, des branches et des pull requests Bitbucket depuis les tâches ClickUp. Assurez-vous que la tâche se trouve dans un Espace lié à un dépôt.

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 commit suggérés que vous pouvez copier dans votre presse-papiers. Vous pouvez également copier l'identifiant de la tâche depuis cet endroit.
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é des tâches ClickUp

Le fil d'activité des tâches réduit parfois des éléments d'activité similaires afin de vous montrer les informations les plus importantes.

Vous pouvez effectuer les actions suivantes pour localiser l'activité Bitbucket :

• Cliquez sur Plus de mises à jour pour afficher l'activité masquée.
• Lorsqu'une branche est fusionnée, les commits s'affichent sous forme d'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 une fenêtre modale.
  • Cliquez sur un commit individuel 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, vérifiez que vous référencez correctement 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, les noms de branches et les pull requests :

#{task_id}

CU-{task_id}

{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

prefix-1

Vous pouvez lier manuellement des tâches ClickUp à des commits, des branches et des pull requests Bitbucket depuis la tâche ClickUp.

Aperçus des liens Bitbucket

Lorsque vous collez un lien Bitbucket en milieu de phrase ou dans du texte existant, un aperçu de lien en ligne s'affiche. Vous pouvez le survoler pour obtenir plus de détails.

Lorsque vous collez un lien Bitbucket sur une nouvelle ligne, vous pouvez choisir de l'afficher en ligne, sous forme d'aperçu en direct ou en tant qu'URL classique.

Les aperçus de liens fonctionnent dans les descriptions de tâches, les commentaires, les Documents et les messages Discussion. Pour modifier manuellement le type d'aperçu d'un lien, survolez-le et cliquez sur l'icône points de suspension ….

Créer des tickets, des branches et des pull requests Bitbucket depuis ClickUp

Créez de nouvelles branches et des pull requests directement depuis des tâches. Assurez-vous que la tâche se trouve dans un Espace lié à un dépôt.

Pour créer une branche ou une pull request :

1. Ouvrez une tâche et cliquez sur l'icône Bitbucket.
2. Sur la droite, vous verrez des suggestions de noms de branches et de messages de commit que vous pouvez copier dans votre presse-papiers. Vous pouvez également copier l'identifiant de la tâche depuis cet endroit.
3. Dans le coin inférieur droit, cliquez sur Ajouter un lien Bitbucket.
4. Choisissez l'une des options suivantes :
   • Nouvelle branche Bitbucket
   • Nouvelle pull request Bitbucket
5. Nommez la branche ou la pull request.
6. Sélectionnez un dépôt et renseignez 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 la description ou un commentaire d'une tâche, vous verrez une nouvelle icône Bitbucket dans la barre latérale droite de toute tâche se trouvant dans des Espaces connectés à des dépôts. Vous pouvez cliquer sur cette icône à tout moment pour voir tous les liens Bitbucket publiés dans la tâche.

L'activité des tâches Bitbucket utilise le nom d'utilisateur ClickUp de la personne, ou son nom d'utilisateur Bitbucket si elle ne possède 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 un commit, poussez un commit ou créez une pull request. ClickUp détecte automatiquement la nouvelle activité Bitbucket et l'associe aux tâches si vous incluez un identifiant de tâche valide dans n'importe quelle partie du titre de la pull request, de la description de la pull request ou du message de commit.

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

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Pour mettre à jour le statut d'une tâche :

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

Par exemple : #ud5b[ready]

Tous les formats répertoriés dans la section Lier des tâches depuis Bitbucket de cet article peuvent être utilisés. Pour garantir un formatage correct, n'ajoutez pas d'espace entre l'identifiant de la tâche et les informations de statut.

Gérer les problèmes, branches, pull requests et commits Bitbucket depuis ClickUp

Une fois que vous avez lié des problèmes, des branches, des pull requests ou des commits, 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 ou l'administrateur de votre Environnement de travail pour demander une mise à niveau vers le statut de membre de l'Environnement de travail.

Une fois qu'un élément Bitbucket est lié, les informations suivantes s'affichent dans votre tâche ClickUp :

Informations sur le problème

Une fois un problème lié, vous pouvez consulter les détails suivants :

• La personne qui a ouvert le problème, appelée l'auteur
• Les relecteurs assignés
• Lien créé
• Référentiel
• Le statut du problème
• URL

Informations sur la branche

Une fois une branche liée, vous pouvez consulter les détails suivants :

• La personne qui a créé la branche, appelée l'auteur
• Créateur du lien
• Référentiel
• URL

Informations sur la pull request

Une fois une pull request liée, vous pouvez consulter les détails suivants :

• La personne qui a ouvert la pull request, appelée l'auteur
• Les relecteurs assignés
• Personnes assignées
• Modifications de lignes
• Lien créé
• Référentiel
• Branche source
• Branche cible
• Le statut de la pull request
• URL

Informations sur le commit

Une fois un commit lié, vous pouvez consulter les détails suivants :

• La personne qui a créé le commit, appelée l'auteur
• Modifications de lignes
• Lien créé
• Référentiel
• URL

Ajouter votre compte Bitbucket à ClickUp

Configurez une connexion personnelle à l'aide de votre compte Bitbucket.

Pour ajouter votre compte Bitbucket depuis l'App Center :

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 dépôts ou l'intégralité de votre compte.

Ces actions n'ont aucun impact sur la capacité de quiconque à accéder aux dépôts via son compte Bitbucket sur Bitbucket.

Pour déconnecter un dépôt depuis l'App Center :

1. Recherchez et sélectionnez Bitbucket.
2. Dans le coin supérieur droit, cliquez sur Paramètres.
3. Sous Dépôts, cliquez sur le menu points de suspension ... à droite du dépôt.
4. Cliquez sur Supprimer de ClickUp.

La section ci-dessous contient les instructions pour déconnecter l'intégralité de votre compte.

Déconnecter 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 l'App Center :

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.