Intégration de GitHub à Document360

De nombreuses organisations dans le monde utilisent Git pour gérer des référentiels de code, GitHub étant l’une des plateformes les plus populaires.  GitHub permet aux développeurs de présenter leur travail et de collaborer à l’échelle mondiale.
Les développeurs utilisent les commandes Git pour valider de nouvelles fonctionnalités et des corrections de bogues dans leurs dépôts de projets.  GitHub propose également une interface graphique intuitive pour gérer efficacement ces dépôts.

Intégration de  GitHub avec Document360

En utilisant Document360 comme plateforme de base de connaissances, vous pouvez l’intégrer à  GitHub pour rationaliser la gestion du contenu. Par exemple, lorsque les développeurs communiquent un nouveau code ou des mises à jour dans un référentiel  GitHub , il peut être nécessaire de refléter les modifications correspondantes dans votre base de connaissances. La mise à jour manuelle des Document360 pour chaque modification peut prendre du temps et être sujette à des erreurs.

En connectant Document360 et  GitHub via Zapier, vous pouvez automatiser ce processus, assurant ainsi une synchronisation transparente entre votre référentiel de code et votre base de connaissances. Pour établir une connexion entre  GitHub et Document360, procédez comme suit :

1. Assurez-vous d’être connecté à votre compte Zapier.

2. Dans le menu de navigation de gauche, cliquez sur Créer , puis sur Zaps dans les options disponibles.

3. Zap sera créé avec un déclencheur et un flux d’action .

   

Connexion  GitHub et Document360 dans Zapier

Suivez les étapes ci-dessous pour établir une connexion entre  GitHub et Document360 :

1. Dans le champ Action , choisissez Document360.

2. Dans le panneau Installation qui s’affiche à droite, sélectionnez l’événement souhaité dans le champ Événement .

3. Cliquez sur le champ Compte et une fenêtre de connexion s’affiche.

4. Entrez vos identifiants de connexion et cliquez sur Autoriser.

   
   Pour générer le jeton d’API à partir du portail Document360 ,

5. Accédez à Paramètres () > Portail de la base de connaissances > Extensions > Collaboration d’équipe.

6. Sur la vignette de l’extension Zapier , cliquez sur Connecter.

7. Cliquez sur l’icône Copier () pour copier le jeton.

   

8. Revenez à la fenêtre Zapier et collez le jeton API dans le champ.

9. Cliquez sur Oui, passez à Document360.

   

10. Vous pouvez trouver le projet Document360 connecté sur la page du compte Connect Document360 .

    Si vous souhaitez configurer un autre compte ultérieurement, vous pouvez le faire en cliquant sur Modifier.

11. Cliquez sur Continuer.

Étape 3 : Personnaliser Zap

1. Mappez tous les champs obligatoires :

• Titre : la sélection par défaut est Nouveau commit dans GitHub. Cependant, vous pouvez choisir parmi différentes options en fonction des besoins de votre entreprise.

• Contenu : la sélection par défaut est Commit Message, mais vous pouvez sélectionner d’autres options en fonction de vos besoins.

• Version : Sélectionnez l’espace de travail dans votre projet de base de connaissances où l’article doit être créé.

• Langue : choisissez la langue de l’article dans l’espace de travail sélectionné.

• Catégorie : Sélectionnez la catégorie sous la langue choisie où l’article sera créé.

• Publier : définissez sur True pour publier l’article immédiatement ou sur False pour l’enregistrer en tant que brouillon.

2. Une fois cela fait, cliquez sur Continuer. Le bouton ne s’active que lorsque tous les champs sont remplis.

Étape 4 : Testez Zap

1. Dans la section test, cliquez sur Envoyer le test.

2. En cas de succès, vous recevrez le message « Article de test envoyé ! Vérifiez votre compte Document360 pour le voir ».

   Dans votre portail de base de connaissances Document360, vous trouverez l’article intitulé « Nouveau commit dans GitHub», situé dans le dossier que vous avez précédemment sélectionné.

3. Revenez à la fenêtre de configuration de l' Zapier et cliquez sur Suivant.

4. Une fois cela fait, cliquez sur Publier.

Activer Zap

Pour activer un Zap une fois qu’il est testé et publié, suivez les étapes ci-dessous :

1. Après avoir testé le Zap, vérifiez ou modifiez les paramètres avant d’activer le Zap.

2. Vous pouvez modifier les paramètres configurés sur le déclencheur de  GitHub et l’action correspondante du nouvel article dans Document360.

3. Vous recevrez un message de réussite indiquant que votre Zap est activé. Vous pouvez cliquer sur le bouton Gérer votre Zap pour accéder à la page d’aperçu de votre Zap.

Présentation de Zap

Créer des articles en Document360 à partir de nouveaux commits GitHub

Vous pouvez afficher et modifier les informations sur les Zaps créés sur la page de présentation de Zap.

Suppression d’un Zap

Pour supprimer un Zap que vous avez créé,

1. Accédez au tableau de bord Zapier. Sur la page d’aperçu, une liste de tous les Zaps existants sera affichée.

2. Cliquez sur l’icône Actions Zap () à droite de la Zap souhaitée, puis cliquez sur Supprimer.

   Le Zap sélectionné sera supprimé.