Il vous sera ensuite demandé de choisir une organisation sur votre compte :

Puis vous devrez autoriser monday.com sur votre compte GitHub :

Une fois l'appli installée, les utilisateurs peuvent ajouter de nouvelles formules GitHub et seront automatiquement authentifiés avec votre compte GitHub.

Cliquez ici pour savoir ce que signifient ces autorisations

Il est important de noter que monday.com ne fait qu'accéder aux données utiles, telles que les noms et emplacements de vos données, pour garantir la fonctionnalité du système. Ces autorisations comprennent :

• Accès à votre code - Spécifique à la formule TODO, monday.com lit les changements sur le PR, sans sauvegarder le code, afin de le connecter à votre élément monday. 
• Problèmes - monday.com doit accéder aux informations concernant les problèmes pour pouvoir déclencher les automatisations monday pertinentes.
• Métadonnées - monday.com doit accéder à une collection de points de terminaison en lecture seule avec métadonnées pour pouvoir déclencher les automatisations monday pertinentes. Ces points de terminaison ne fournissent aucune information privée ou sensible concernant le dépôt.
• Demandes d'extraction - monday.com doit lire les modifications effectuées dans le PR, ainsi qu'accéder aux informations concernant les demandes d'extraction, pour pouvoir déclencher les automatisations  monday et les formules à synchronisation bidirectionnelle

Ajoutez-le à votre processus de travail 

Pour ajouter les nouvelles formules d'intégration GitHub au tableau de votre choix, vous pouvez vous rendre sur ce tableau et cliquer sur Intégrer dans le coin supérieur droit :

Dans le centre des intégrations, tapez « GitHub » dans la barre de recherche :

Remarque : notre ancienne intégration GitHub se trouve toujours dans le centre des intégrations. Vous devrez donc l'ignorer et cliquer sur « GitHub (nouvelle intégration) » dans la section Applis.

Cliquez sur la bannière « GitHub (nouvelle intégration) » pour trouver les formules disponibles dans notre intégration :

Il vous suffit ensuite de sélectionner les formules que vous souhaitez ajouter à votre tableau.

Les formules d'intégration prises en charge par monday.com sont les suivantes :

• Lorsqu'un problème a l'étiquette quelque chose dans ce répertoire, créer un élément
• Lorsqu'une demande de tirage est fusionnée dans ces répertoires et que l'ID d'un élément y est mentionné, passer le ,statut à quelque chose
• Lorsqu'un problème est créé dans ces répertoires, créer un élément
• Lorsqu'une demande de tirage est créée dans ces répertoires et que l'ID d'un élément y est mentionné, passer le ,statut à quelque chose
• Lorsqu'une demande de tirage est créée dans ces répertoires et que l'ID d'un élément y est mentionné, ajouter le lien de la demande dans cette colonne Lien
• Lorsqu'une branche est créée dans ces répertoires, créer un élément
• Lorsque le statut d'un problème passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un utilisateur GitHub fait passer un commentaire TODO dans ces répertoires, créer un élément
• Lorsqu'un problème est créé dans ces répertoires et que l'ID d'un élément y est mentionné, ajouter le lien à cette colonne Lien
• Lorsque le statut d'une demande de tirage passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un problème a l'étiquette quelque chose dans ce répertoire et que l'ID de l'élément y est mentionné, faire passer le statut à quelque chose
• Lorsque le statut d'une demande de tirage passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, créer une mise à jour
• Lorsqu'une demande de tirage a l'étiquette quelque chose dans ce répertoire et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un problème est créé dans ces répertoires, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'un problème est créé avec ces étiquettes dans ce répertoire, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'une demande d'extraction est créée ou mise à jour dans ces répertoires, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'un élément est créé ou mis à jour, créez un problème dans ce répertoire, avec ces champs et synchronisez toutes les modifications futures

Conseil : avec les nouvelles formules d'intégration GitHub, vous pouvez sélectionner plusieurs répertoires GitHub dans une seule formule. Il n'est pas nécessaire de créer plusieurs formules d'intégration pour chaque répertoire. 🥳

Créer une synchronisation bidirectionnelle

Une synchronisation bidirectionnelle se produit lorsque les données sont à la fois transférées de monday.com vers GitHub et extraites de GitHub vers monday.com. Ce type de synchronisation permet de faire correspondre vos données sur les deux plateformes et de rester à jour.

La nature de cette formule vous permet de choisir la direction de votre synchronisation afin de créer une synchronisation bidirectionnelle entre GitHub et monday.com.

Création d'une synchronisation bidirectionnelle

Lorsque vous représentez « ces champs », vous sevrez sélectionnez le champ dans GitHub et monday.com, et la direction dans laquelle vous souhaitez que la synchronisation s'effectue. Pour créer une synchronisation dans les deux sens, sélectionnez « dans les deux sens ».

Par exemple, en utilisant le GIF ci-dessous, si vous souhaitez mettre en correspondance la colonne « Admin » de votre élément sur monday.com avec le champ « Responsable » sur GitHub, vous sélectionnerez ces champs sous le logo de l'entreprise concernée. Ensuite, dans le menu déroulant « Choisir la direction », choisissez « dans les deux sens » pour indiquer que l'information circulera dans les deux sens.

Que signifie « ID de l'élément » dans certaines des formules ?

Excellente question ! Certaines des formules d'intégration nécessitent une connexion unique entre monday.com et GitHub afin de synchroniser les deux plateformes. L'ID de l'élément sert de numéro unique associé à un élément.

Remarque : vous devez mettre un symbole « # » devant le numéro dans GitHub pour que la colonne ID de l'élément de monday.com reconnaisse la connexion. Ex : utilisez #376479 dans GitHub, et non 376479. 

Par exemple, prenons la formule d'intégration : « Lorsqu'une demande de tirage est créée dans ce répertoire, et que l'ID de l'élément est mentionné dans le nom de la demande, changez le statut en quelque chose ». Une fois la demande de tirage créée dans GitHub, le système utilise l'ID de l'élément dans monday.com pour identifier l'élément qu'il doit modifier.

Conseil : vous pouvez cliquer une fois sur la colonne ID de l'élément pour copier facilement et automatiquement la valeur depuis votre tableau.

La nouvelle intégration fonctionnera-t-elle même si je n'installe pas l'application dans GitHub ?

Non, l'intégration n'est pas possible sans installer l'application dans GitHub.

Puis-je connecter mon compte monday.com à plusieurs organisations dans GitHub ? 

Oui ! Vous pouvez connecter vos comptes monday.com à plusieurs organisations dans GitHub.

Comment puis-je désynchroniser GitHub de monday.com ?

Pour ce faire, vous pouvez aller dans votre section Admin > Applis. Faites défiler la page jusqu'à ce que vous voyiez GitHub App et cliquez sur « Désinstaller » : 

 Ensuite, pour désinstaller l'application monday.com de GitHub, vous pouvez aller dans votre compte GitHub > Paramètres > Applications et chercher monday.com. Faites défiler jusqu'à « Zone de danger » et cliquez sur « Désinstaller » :

Que va devenir l'ancienne intégration GitHub ?

Pour le moment, vous pouvez toujours trouver l'ancienne intégration GitHub dans le Centre des intégrations et l'utiliser, mais elle sera progressivement supprimée à mesure que nous continuerons à prendre en compte les commentaires de nos formidables utilisateurs (c'est-à-dire vous !) et à ajouter des fonctionnalités à la nouvelle intégration.

Envoyez vos commentaires ici et suivez notre actualité pour être informé des futures mises à jour.