Leçon 3 : Intégration d'outils dans une chaîne de valeur#

Fournissez des données aux chaînes de valeur en y intégrant des outils externes, comme Jira.

Avant de commencer

Avant de commencer cette leçon, assurez-vous d'avoir terminé la leçon précédente.

Description de la tâche

Maintenant que nous avons configuré la chaîne de valeur, le moment est venu de lui ajouter des données.

D'où proviennent les données de la chaîne de valeur ? La réponse est double :

  1. Les intégrations jointes à une chaîne de valeur définissent les sources de données. Une intégration Jira, par exemple, fournit des données de projet Jira à la chaîne de valeur.
  2. Les requêtes DQL déterminent les enregistrements de la source de données qui sont sélectionnés pour la chaîne de valeur.

Dans cette leçon, nous abordons le point 1 en ajoutant une intégration à la chaîne de valeur du tutoriel.

Pour modifier la chaîne de valeur du tutoriel, procédez comme suit :

Procédure

  1. Cliquez sur Paramètres > Intégration > Plug-ins.

  2. Sur l'onglet Plug-ins, cliquez sur Ajouter une intégration pour l'intégration Jira.

    Il existe plusieurs manières de définir des intégrations. Vous pouvez les définir directement dans la matrice "integrations" du fichier JSON. Vous pouvez également définir une intégration sur la page Plug-in, puis la référencer dans le fichier JSON. Au cours de cette leçon, nous configurons l'intégration sur la page Plug-in.

  3. Dans la fenêtre Ajouter une intégration Jira, configurez une intégration en procédant comme suit :

    1. Dans le champ Nom de l'intégration, entrez un nom pour l'intégration, comme "tutoriel".

      Par exemple, tutorial Jira. Ensuite, nous allons utiliser ce nom pour associer l'intégration à notre chaîne de valeur.

    2. Dans le champ URL, saisissez l'URL du projet Jira que vous avez configuré précédemment.

      L'URL est similaire à cet exemple, https://my_project.atlassian.net.

    3. Dans le champ Nom d'utilisateur, saisissez l'adresse électronique associée à votre compte Jira.

    4. Dans le champ Mot de passe, saisissez la clé d'API Jira que vous avez créée précédemment.

      Etant donné que nous utilisons la clé d'API, nous ne devons pas utiliser les autres champs liés à l'authentification.

    5. Dans le champ Projets, saisissez votre code de projet Jira.

      Veillez à utiliser le code de projet Jira et non le nom du projet. Dans le projet Jira que j'ai configuré pour le tutoriel, le code de projet Jira est DEL.

    6. Cliquez sur Ajouter.

    L'intégration est répertoriée sur la page Intégrations. Si l'intégration aboutit, le champ Statut affiche Online. Si le statut n'est pas Online, utilisez l'option Afficher le journal pour dépanner l'intégration. Vous pouvez augmenter le niveau de journalisation dans la configuration de l'intégration, dans le cas où vous auriez besoin de plus d'informations de dépannage.

  4. Sur la page Chaînes de valeur, sélectionnez la chaîne de valeur que vous avez créée dans la leçon précédente.

  5. Cliquez sur Configurer la mappe de la chaîne de valeur > Télécharger la mappe de la chaîne de valeur.

    Le fichier helloWorld-vsm.json est téléchargé sur votre ordinateur.

    Remarque : Après avoir modifié le fichier de mappe de chaîne de valeur par défaut, le nom du fichier téléchargé va représenter le nom de la chaîne de valeur.

  6. Dans votre éditeur de texte, ouvrez le fichier helloWorld-vsm.json, puis ajoutez l'intégration Jira à la matrice integrations dans le fichier JSON.

    Etant donné que vous avez déjà défini les intégrations Jira, vous pouvez les ajouter à la chaîne de valeur en indiquant son nom, comme dans l'exemple suivant :

    "integrations": [ { "name":"tutorial Jira" } ],

    Bien entendu, utilisez le nom que vous avez affecté à l'intégration à l'étape 3.

  7. Dans votre éditeur de texte, ajoutez une requête DQL à l'étape Backlog dans le fichier JSON.

    Les requêtes DQL affectées à une étape filtrent les informations qui s'affichent dans l'étape, comme le montre l'exemple suivant :

    "phases": [ { "name": "PLAN", "description": "", "stages": [ { "name": "Backlog", "query": "issue.status=\"Backlog\"", "description": "", "wipLimit": null, "gates": null },

    Il est recommandé d'éviter les guillemets internes.

  8. Sauvegardez le fichier helloWorld-vsm.json.

  9. Sur la page de la chaîne de valeur helloWorld, sélectionnez Configurer la mappe de la chaîne de valeur > Remplacer la mappe de la chaîne de valeur, puis sélectionnez le fichier JSON que vous avez modifié.

    Après le chargement du fichier, actualisez la page de la chaîne de valeur helloWorld. Une particule avec le statut Jira de Backlog s'affiche dans l'étape Délai, comme le montre la figure ci-dessous :

    Si votre projet Jira compte plusieurs problèmes dont le statut est Backlog, des particules correspondant à tous ces problèmes apparaissent dans l'étape Délai.

    Sélectionnez la particule pour afficher une carte contenant des informations sur la particule, y compris son historique. Les liens vers le problème Jira associé sont fournis.

résultats

Dans cette leçon, vous avez intégré l'outil externe Jira à votre chaîne de valeur, et affiché des données à l'aide d'une requête DQL.

Que faire ensuite

Au cours de la leçon suivante, nous ajoutons une requête DQL qui reflète les changements apportés aux problèmes JIRA intégrés.

Sujet parent : Créer une chaîne de valeur