Création d'intégrations de plug-in#

Utilisez des outils externes en définissant des intégrations.

Avant de créer une intégration, assurez-vous que vous disposez des données d'identification utilisateur et des informations de connexion requises par l'outil externe, telles que les URL et les points d'extrémité d'API. Pour créer une intégration avec HCL™ Launch, par exemple, vous avez besoin d'un jeton utilisateur généré par HCL Launch, ainsi que l'URL de l'endroit où se trouve le serveur. Veillez à disposer de toutes les informations de connexion nécessaires avant de démarrer.

Les données d'identification et les autres propriétés de connexion varient d'un plug-in à un autre. Vous pouvez trouver des descriptions de propriété et des cas d'utilisation pour tous les plug-ins sur le site Web du produit.

Un plug-in est un module complémentaire logiciel conçu pour communiquer avec des services et des applications externes. Chaque plug-in définit un type d'enregistrement attendu et une méthode de communication. La communication peut être unidirectionnelle ou bidirectionnelle. Pour utiliser un plug-in, vous configurez une intégration. Il existe trois façons de configurer une intégration :

Cette rubrique décrit les trois premières méthodes. Les intégrations natives sont décrites dans une section distincte.

Pour configurer une intégration, procédez comme suit :

  1. Sur la page HCL™ Accelerate Accueil, cliquez sur Paramètres > Intégrations > Plug-ins.

    La page Plug-ins répertorie les plug-ins disponibles. Pour certains plug-ins, vous utilisez le bouton Ajouter une intégration et, pour d'autres, vous utilisez d'abord le bouton Installer avant de créer des intégrations pour ce dernier. Les plug-ins de type analyseur fournissent généralement des données d'indicateur ou de type qualité. Vous pouvez accéder aux données fournies par les plug-ins de type analyseur à l'aide de la fonction Insights. Les plug-ins de type analyseur installés sont répertoriés dans l'onglet Plug-ins.

  2. Utilisez le tableau suivant pour configurer le plug-in en cliquant sur les actions disponibles pour le plug-in requis sur la page Intégrations.

    Actions Procédure
    *Ajouter une intégration* Définissez les propriétés d'intégration. Pour plus d'informations à propos des propriétés propres au plug-in, visitez le site Web du produit.
    *Installez* Installez le plug-in et après une installation réussie, cliquez sur Ajouter une intégration et suivez les instructions ci-dessus pour créer une intégration pour le plug-in. Remarque : Si des problèmes sont rencontrés lors du processus d'installation, des codes d'état typiques s'affichent pour fournir des informations relatives à la cause du problème. Un code d'état de There was an error when trying to install this plugin (Reason: xxx) en est un exemple parfait, avec xxx indiquant un numéro de code d'état.

  3. Vous pouvez configurer des intégrations pour certains types de plug-in en ajoutant une définition d'intégration à un fichier JSON de chaîne de valeur.

    A l'aide d'un éditeur de texte, définissez un objet d'intégration dans la matrice integrations du fichier value_stream_name.json. L'exemple de code suivant illustre une intégration Jira.

    { "_id": "velocity-generated-id", "type": "ucv-ext-jira", "tenant_id": "velocity-generated-id", "name": "my-JIRA", "disabled": false, "properties": { "baseUrl": "http://my-jira-url", "username": "admin", "password": "****", "jiraProjects": [ "My-Project" ] } },

    Les intégrations créées par la méthode de la chaîne de valeur s'affichent sur la page Intégrations, en plus d'intégrations créées par les autres méthodes.

  4. Parmi les fonctions supplémentaires du produit HCL Accelerate nécessitant l'installation du plug-in avant utilisation, on trouve notamment les fonctions suivantes :

    • Handlebars Reporter
    • Détection des goulots d'étranglement
    • Analyseur

L'intégration est répertoriée sur la page Intégrations. La page Intégrations vous permet de gérer des intégrations.

Les intégrations commencent à fournir des données dès qu'elles sont correctement configurées. Pour certains types d'intégration, comme les types qualité-données, vous pouvez commencer à utiliser leurs données sans configuration supplémentaire. Par exemple, vous pouvez créer des graphiques de tableau de bord contenant des données de qualité dès que vous terminez l'intégration. JUnit est un exemple de plug-in de type qualité.

D'autres types d'intégration exigent une configuration supplémentaire avant que vous ne puissiez commencer à utiliser leurs données. Les intégrations natives exigent que des tâches soient ajoutées aux plans de déploiement. Les intégrations de chaîne de valeur, comme GitHub™, exigent une référence dans le fichier JSON de la chaîne de valeur. Si vous définissez une intégration sur la page Plug-ins, ajoutez une référence au nom d'intégration dans le fichier JSON. Si vous définissez une intégration directement dans un fichier JSON, comme décrit à l'étape 3, aucune configuration supplémentaire n'est requise.

Pour des informations supplémentaires, reportez-vous à Installation de plug-ins dans des produits.

Sujet parent : Extension des fonctions du produit