Micro-apps

Intégrer Jira

L’intégration Jira vous permet de suivre les problèmes et d’obtenir des mises à jour automatisées sur les tâches à partir de n’importe quel appareil, site intranet ou n’importe quelle messagerie instantanée. Utilisez le processus suivant pour activer l’intégration avec Jira. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.

Remarque :

Nous mettons à votre disposition deux modèles d’intégration Jira. Nous vous recommandons d’utiliser la nouvelle intégration HTTP pour la plupart des cas d’utilisation. L’intégration HTTP est plus performante pour configurer la structure de données mise en cache. Pour plus d’informations sur les micro-apps disponibles dans chaque intégration, consultez la section Utiliser les micro-apps Jira.

Vérifier les conditions préalables

Tous les comptes utilisateur que vous souhaitez utiliser via cette intégration doivent avoir une visibilité au niveau de leur messagerie avec les paramètres de compte définis sur Anyone. Cela désigne les comptes de service, ainsi que les comptes avec lesquels les utilisateurs se connectent à Citrix Workspace via OAuth. Accédez à https://id.atlassian.com/manage-profile/profile-and-visibility et connectez-vous si nécessaire. Dans la section Contact, en regard du compte de messagerie, sélectionnez Anyone dans le menu Who can see this?.

Remarque :

Jira ne prend plus en charge Internet Explorer 11. La configuration de cette micro-app avec Internet Explore 11 entraînera des erreurs. Veuillez utiliser un autre navigateur (Chrome, Edge, etc.) pour configurer la micro-app correctement.

Une fois l’intégration dans Jira configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : templatebaseurl. Remplacez {cloud-id} par votre ID cloud. Si vous ne connaissez pas votre ID cloud, connectez-vous en tant qu’administrateur de votre instance JIRA et vérifiez l’URL.
  • URL d’autorisation : ce paramètre est prédéfini. Il s’agit de l’adresse URL du serveur d’autorisation fournie lors de la configuration de l’intégration de l’application cible.
  • URL du jeton : ce paramètre est prédéfini. Il s’agit de l’URL du jeton d’autorisation d’accès.
  • Epic-name-CustomFieldD : ce paramètre se trouve dans le portail d’administration Jira. Consultez Remplacer les variables Action de service.
  • ID du client : l’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
  • Clé secrète client : la clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
  • Nom d’utilisateur : il s’agit du nom d’utilisateur de votre compte de service.
  • Mot de passe : il s’agit du mot de passe de votre compte de service

Remarque :

Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

Les conditions préalables suivantes doivent être remplies avant de commencer le processus d’intégration :

  • Vous devez disposer d’un compte utilisateur dédié qui dispose d’un accès de navigation aux projets Jira que vous souhaitez gérer.

    Pour plus d’informations sur la gestion des utilisateurs, consultez la section https://www.atlassian.com/software/jira/guides#ManagingUsers-Addingusers.

    Pour plus d’informations sur l’ajout d’un utilisateur à un modèle d’autorisation pour un projet Jira, consultez la section Gérer des autorisations de projet.

  • Configurez Citrix Gateway pour prendre en charge l’authentification unique pour Jira : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Suivez les instructions de l’article Configuration de l’authentification unique pour Jira. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-On), consultez la section Citrix Gateway Service.

Activer OAuth 2.0 (3LO)

Avant de mettre en œuvre OAuth 2.0 (3LO), vous devez l’activer pour votre application dans la gestion des applications Jira.

  1. Accédez à Gestion des applications.
  2. Créez une application en sélectionnant Créer application, donnez-lui un nom, acceptez les conditions d’utilisation et sélectionnez Créer.
  3. Copiez l’ID du client et la Clé secrète client pour une utilisation ultérieure.
  4. Dans la section API et fonctionnalités dans la navigation latérale, cliquez sur +Ajouter.
  5. Dans la section Fonctionnalités de la page API et fonctionnalités, recherchez OAuth 2.0 (3LO), sélectionnez Ajouter, puis Configurer.
  6. Entrez l’URL de rappel. Définissez cette URL sur n’importe quelle URL accessible par l’application. Lorsque vous mettez en œuvre OAuth 2.0 (3LO) dans votre application (voir la section suivante), l’URI redirect_uri doit correspondre à cette URL.
  7. Cliquez sur Enregistrer les modifications.

Votre écran se présente comme suit : Jira OAuth2

Créer un jeton API

Un script ou un autre processus peut utiliser un jeton API pour effectuer une authentification de base avec les applications Jira Cloud ou Confluence Cloud. Vous devez utiliser un jeton API si la vérification en deux étapes du compte Atlassian avec lequel vous vous authentifiez est activée.

  1. Lorsque vous êtes connecté au compte Atlassian, accédez à la section Jetons API.
  2. Sélectionnez Créer un jeton API et donnez un nom au jeton dans le champ Intitulé.
  3. Sélectionnez Copier dans le Presse-papiers et enregistrez le jeton pour une utilisation ultérieure.

Vous devez entrer le Jeton API comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.

Ajouter l’API REST de la plate-forme Jira

Si vous n’avez pas encore ajouté l’API REST de la plate-forme Jira, faites-le maintenant.

  1. Dans la section API et fonctionnalités dans la navigation latérale, cliquez sur +Ajouter.
  2. Dans la section API de la page API et fonctionnalités, recherchez OAuth 2.0 (3LO), sélectionnez Ajouter, puis Configurer.
  3. Ajoutez les champs d’application souhaités pour votre application.

Ajouter une URL de rappel

Ajoutez une adresse URL personnalisée à votre configuration d’instance pour accorder l’accès aux données privées et activer les actions utilisateur authentifiées par OAuth. Pour rechercher l’URL de votre serveur de micro-apps, connectez-vous à Citrix Cloud et sélectionnez la vignette Micro-apps. Dans la barre d’URL, copiez la première section de l’URL. Il s’agit de l’URL de votre serveur de micro-apps. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Pour l’intégration HTTP Jira, vous devez ajouter deux URL de rappel différentes. Notez toutefois qu’une application Jira ne peut avoir qu’une seule URL de rappel. Cela signifie que vous devez enregistrer deux applications, l’un pour les actions de l’utilisateur et l’autre pour la synchronisation. Ces applications doivent disposer d’URL de rappel différentes.

https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext

https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Remarque :

Prêtez une attention particulière aux URL de rappel lors de l’ajout de l’intégration Jira. L’authentification du service et l’authentification des actions de service ont différentes URL de rappel. L’ID client et la clé secrète client doivent convenir soit à l’URL de rappel de l’authentification du service ou de l’authentification des actions de service.

Ajouter l’intégration aux micro-apps Citrix Workspace

Procédez comme suit pour configurer l’intégration HTTP Jira. Nous vous recommandons d’utiliser la nouvelle intégration HTTP pour la plupart des cas d’utilisation. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Nous vous recommandons d’utiliser la nouvelle intégration HTTP pour la plupart des cas d’utilisation. L’intégration HTTP est plus performante pour configurer la structure de données mise en cache.

Remarque :

Par défaut, cette intégration synchronise les données pour une période de six (6) mois. Nous vous recommandons de modifier cette valeur en fonction de vos besoins et de la durée habituelle de vos tickets. Le filtre est basé sur la dernière mise à jour, et non sur la date de création. Pour modifier cette option, vous devez modifier la variable timeToSync dans un point de terminaison de chargement des données. Consultez Remplacer la variable Chargement des données.

Procédez comme suit :

  1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  2. Choisissez la vignette Jira sous Intégrations.
  3. Donnez un nom d’intégration à l’intégration.
  4. Renseignez la section Paramètres du connecteur.
    • Entrez l’URL de base de l’instance ou remplacez simplement {cloud-id} dans l’exemple par votre ID cloud. Si vous ne connaissez pas votre ID cloud, connectez-vous en tant qu’administrateur de votre instance JIRA et vérifiez l’URL. Cet ID cloud est un identifiant universel unique (UUID), c’est-à-dire un nombre hexadécimal composé de 8-4-4-4-12 chiffres qui fait partie de l’URL. Vous pouvez également vous authentifier à l’aide des informations d’identification d’administrateur et envoyer une requête GET à https://api.atlassian.com/oauth/token/accessible-resources. L’ID cloud fait partie de la réponse.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône Jira par défaut.
    • Activez Instance locale si vous créez une connexion locale. Pour de plus amples informations, consultez la section Instance locale. En raison des différences entre l’API Jira Cloud v2 et l’API Jira Server v2 de votre instance Jira, vous devez également mettre à jour certaines parties de l’intégration manuellement. Contactez le support.

    Instance HTTP Jira locale

  5. Sous Authentification du service, sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué. Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

    1. Sélectionnez Code d’autorisation dans le menu Flux de type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application. L’authentification du service et l’authentification des actions de service ont différentes URL de rappel.
    2. Entrez authorization_code dans le champ Valeur du type d’autorisation.
    3. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    4. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    5. Votre URL d’autorisation est prédéfinie. Il s’agit de l’adresse URL du serveur d’autorisation fournie lors de la configuration de l’intégration de l’application cible.
    6. Votre URL de jeton est prédéfinie. Il s’agit de l’URL du jeton d’autorisation d’accès.
    7. Assurez-vous que les éléments suivants sont saisis pour l’étendue. Cette chaîne est définie par le serveur d’autorisation lors de la configuration de l’intégration de l’application cible. Pour synchroniser d’autres entités, vous devez ajouter des étendues ici. Utilisez ce qui suit, séparé par un espace : read:jira-user read:jira-work manage:jira-project manage:jira-configuration write:jira-work manage:jira-data-provider offline_access.
    8. Saisissez votre ID client. L’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet ID et la clé secrète client lorsque vous enregistrez le client OAuth dans votre compte Jira L’ID client et la clé secrète client doivent convenir à l’URL de rappel de l’authentification du service.
    9. Entrez la Clé secrète client. La clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
    10. Entrez votre Préfixe d’en-tête. (facultatif) Entrez le préfixe d’en-tête si le préfixe de votre porteur est différent de l’en-tête par défaut.

    Jeton HTTP Jira

  6. Sous Authentification des actions de service, activez Utiliser authentification utilisateur distincte dans Actions. L’authentification des actions de service s’authentifie au niveau de l’action de service. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.

    1. Sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
    2. Sélectionnez Code d’autorisation dans le menu Flux de type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application. L’authentification du service et l’authentification des actions de service ont différentes URL de rappel.
    3. Entrez authorization_code dans le champ Valeur du type d’autorisation.
    4. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    5. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    6. Votre URL d’autorisation est prédéfinie. Il s’agit de l’adresse URL du serveur d’autorisation fournie lors de la configuration de l’intégration de l’application cible.
    7. Votre URL de jeton est prédéfinie. Il s’agit de l’URL du jeton d’autorisation d’accès.
    8. Assurez-vous que les éléments suivants sont saisis pour l’étendue. Cette chaîne est définie par le serveur d’autorisation lors de la configuration de l’intégration de l’application cible. Pour synchroniser d’autres entités, vous devez ajouter des étendues ici. Utilisez ce qui suit, séparé par un espace : read:jira-user read:jira-work manage:jira-project manage:jira-configuration write:jira-work manage:jira-data-provider offline_access.
    9. Saisissez votre ID client. L’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet ID et la clé secrète client lorsque vous enregistrez le client OAuth dans votre compte Jira L’ID client et la clé secrète client doivent convenir à l’URL de rappel de l’authentification des actions de service.
    10. Entrez la Clé secrète client. La clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
    11. Entrez votre Préfixe d’en-tête. (facultatif) Entrez le préfixe d’en-tête si le préfixe de votre porteur est différent de l’en-tête par défaut.
    12. Si vous avez sélectionné la méthode d’authentification OAuth 2.0, vous pouvez sélectionner + Ajouter un paramètre pour inclure les paramètres de jeton d’accès. Les paramètres de jeton d’accès permettent de définir les paramètres de jeton d’accès requis par le serveur d’autorisation d’application cible si nécessaire.

    Authentification des actions de service Jira

  7. (Facultatif) Si vous souhaitez activer la limitation de taux pour cette intégration, activez Limitation de taux de demandes et définissez le nombre de demandes par intervalle de temps.
  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Le champ Délai d’expiration de la demande est défini sur 120 par défaut.

    Limitation de taux et journalisation

  10. Sélectionnez Enregistrer pour continuer.
  11. Sous Autorisation OAuth, sélectionnez Autoriser pour vous connecter avec votre compte de service. Une fenêtre contextuelle apparaît avec un écran de connexion Webex.
    1. Entrez le nom d’utilisateur et le mot de passe de votre compte de service, puis sélectionnez Connexion.
    2. Sélectionnez Accepter. Authentification du service

Continuez avec les procédures suivantes pour terminer le processus de configuration.

Remplacer les variables Action de service

Pour activer la fonctionnalité de page Créer epic, vous devez modifier manuellement les actions de service Créer epic et Créer epic sans responsable. Remplacez la valeur {Epic-Name-customFieldId} de la variable de modèle EpicFieldId par l’identifiant d’un champ personnalisé dans lequel le nom de l’epic est stocké.

  1. Dans le portail d’administration Jira, accédez à Issues. Sélectionnez Custom fields dans le menu de gauche. Trouvez l’entrée Epic Name et sélectionnez le menu de l’autre côté de l’écran. Sélectionnez View field information.
  2. Copiez et enregistrez la valeur numérique à la fin de l’URL.
  3. Dans la console de micro-apps, sélectionnez le menu en regard de l’intégration Jira, puis Modifier. Sélectionnez Actions de service dans la colonne de navigation gauche.
  4. Sélectionnez le menu situé en regard de l’une des actions de service, puis sélectionnez Modifier, ou sélectionnez le nom de l’action de service. Commençons par l’action de service Créer epic.
  5. Sur l’écran Modifier l’action de service, sous Variables de modèle, remplacez la valeur {Epic-Name-customFieldId} de la variable de modèle EpicFieldId par l’identifiant de champ personnalisé que vous avez obtenu précédemment dans Jira.

    Limitation de taux et journalisation

  6. Sélectionnez Enregistrer pour terminer le processus
  7. Répétez maintenant ce processus pour l’autre action de service : Créer epic sans responsable.

Remplacer la variable Chargement des données

Cette intégration synchronise les données pour une période de six (6) mois par défaut. Nous vous recommandons de modifier cette valeur en fonction de vos besoins et de la durée habituelle de vos tickets. Le filtre est basé sur la dernière mise à jour, et non sur la date de création. Pour modifier cette option, vous devez modifier la variable timeToSync dans le point de terminaison de chargement des données Problèmes.

  1. Sur la page Intégrations de micro-apps, sélectionnez le menu en regard de l’intégration Jira, puis Modifier. L’écran Chargement des données s’ouvre. Si vous êtes sur l’écran de configuration, sélectionnez Chargement des données dans la colonne de navigation gauche.
  2. Sélectionnez le menu en regard du point de terminaison Problèmes, puis sélectionnez Modifier ou sélectionnez le nom du point de terminaison : Problèmes.
  3. Sur l’écran Modifier le point de terminaison de données, sous Variables de modèle, remplacez la valeur de la variable timeToSync par la valeur souhaitée.
  4. Sélectionnez Appliquer en bas de l’écran et confirmez vos sélections.

    Limitation de taux et journalisation

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur HTTP Jira.

Utiliser les micro-apps Jira

L’intégration HTTP Jira est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Créer epic : permet de créer une epic Jira, ainsi que ses détails correspondants.

Remarque :

Pour activer la fonctionnalité de page Créer epic, vous devez modifier les actions de service Créer epic et Créer epic sans responsable. Consultez Remplacer les variables Action de service.

Notification ou Page Workflows de cas d’utilisation
Page Créer epic Fournit un formulaire permettant de créer une epic Jira, de donner un nom à l’epic, de sélectionner un type de problème, un projet et éventuellement un responsable, ainsi qu’un champ pour ajouter une description.
Page Projets Fournit un formulaire consultable permettant de sélectionner un projet auquel attribuer la nouvelle epic.

Créer un ticket : permet de créer un ticket Jira, ainsi que ses détails correspondants.

Notification ou Page Workflows de cas d’utilisation
Page Créer un ticket Fournit un formulaire permettant de créer un ticket Jira, y compris la sélection d’un type de problème, d’un projet et éventuellement d’un responsable, ainsi qu’un champ pour ajouter une description.
Page Projets Fournit un formulaire consultable permettant de sélectionner un projet auquel attribuer le nouveau ticket.

Tickets : permet d’afficher les tickets, d’ajouter des commentaires, de créer des sous-tâches, de modifier l’état et le responsable.

Notification ou Page Workflows de cas d’utilisation
Notification Commentaire modifié (ticket attribué) Lorsqu’un commentaire est modifié sur un ticket existant attribué à un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Commentaire modifié (ticket envoyé) Lorsqu’un commentaire est modifié sur un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Nouveau commentaire (ticket attribué) Lorsqu’un nouveau commentaire est ajouté à un ticket existant attribué à un utilisateur, celui-ci reçoit une notification.
Notification Nouveau commentaire (ticket envoyé) Lorsqu’un nouveau commentaire est ajouté à un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (changement) Lorsqu’un ticket existant est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (nouveau) Lorsqu’un nouveau ticket est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Changement de responsable du ticket (envoyé) Lorsqu’un ticket est réaffecté, l’utilisateur ayant envoyé le ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket attribué) Lorsque l’état d’un ticket est modifié, le responsable du ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket envoyé) Lorsque l’état d’un ticket est modifié, l’utilisateur ayant envoyé le ticket reçoit une notification.
Page Détails du commentaire Fournit une vue en lecture seule d’un commentaire et de ses détails correspondants.
Page Créer une sous-tâche Fournit un formulaire permettant de créer une sous-tâche pour un ticket Jira.
Page Détails du ticket Fournit une vue détaillée d’un ticket Jira, y compris des champs permettant d’ajouter des commentaires et de modifier l’état, la priorité et le responsable directement à partir de la page.
Page Tickets Permet aux utilisateurs d’effectuer des recherches dans leurs tickets Jira à l’aide d’un champ de recherche, d’un sélecteur de projet et d’un sélecteur d’état pour basculer rapidement entre les options Tous, Mes tickets, Ticket attribué, Ticket envoyé, Ticket suivi et Ticket commenté.

Ajouter l’ancienne intégration Jira

Suivez ces instructions en plus des étapes ci-dessus pour configurer l’ancienne intégration.

Conditions préalables

Pour l’ancienne intégration, vous avez besoin de ces valeurs.

  • URL
  • Nom d’utilisateur
  • Mot de passe : vous devez entrer le Jeton API comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.
  • Méthode d’authentification (informations d’identification ou OAuth2)

Pour OAuth 2.0, vous avez également besoin des éléments suivants :

  • ID client
  • Clé secrète client

Définir la durée de récupération des problèmes

Pour l’ancienne intégration Jira, définissez la durée pendant laquelle vous souhaitez récupérer des problèmes dans Jira. Lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace, la quantité de données récupérées à partir de Jira peut être limitée en appliquant un filtre de charge.

  1. Connectez-vous à Jira avec votre compte utilisateur et votre mot de passe dédiés.

    Remarque :

    Si vous utilisez un compte existant, le nom d’utilisateur n’est pas l’e-mail du compte. Pour trouver le nom d’utilisateur d’un compte, connectez-vous à votre instance Jira, sélectionnez la miniature de profil, puis Profil.

  2. Entrez le nombre de jours pendant lesquels vous souhaitez récupérer des problèmes.

    Valeur par défaut : 90 jours

Ajouter les anciennes intégrations Jira

Procédez comme suit :

  1. Sur la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette Jira à ajouter.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Jira : URL, Nom d'utilisateur, Mot de passe, Authentification de l'utilisateur

  5. Renseignez la section Paramètres du connecteur avec les éléments requis que vous avez obtenus.
    • Entrez l’URL.
    • Entrez votre Nom d’utilisateur et votre Mot de passe d’authentification de service.

      Remarque :

      Entrez le Jeton API que vous avez obtenu lors de l’étape précédente comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.

  6. Sélectionnez une Méthode d’authentification. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué.
    • Informations d’identification : les informations d’identification du client sont utilisées.
    • OAuth 2.0 : entrez l’ID du client OAuth et la Clé secrète client OAuth que vous avez obtenus dans la procédure Vérifier les conditions préalables.
  7. Sélectionnez une valeur pour le champ Tickets modifiés – Nombre de semaines à charger.
  8. Sélectionnez Ajouter.

Jira HTTP OAuth

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation. Pour de plus amples informations, consultez la section Vérifier les entités requises. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Jira.

Anciennes micro-apps Jira

L’intégration Jira est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Micro-apps Jira

Créer un ticket : permet de créer un ticket Jira, ainsi que ses détails correspondants.

Notification ou Page Workflows de cas d’utilisation
Page Créer un ticket Fournit un formulaire permettant de créer un ticket Jira, y compris la sélection d’un type de problème, d’un projet et éventuellement d’un responsable, ainsi qu’un champ pour ajouter une description.

Tickets : permet d’afficher les tickets, d’ajouter des commentaires, de créer des sous-tâches, de modifier l’état et le responsable.

Notification ou Page Workflows de cas d’utilisation
Notification Commentaire modifié (ticket attribué) Lorsqu’un commentaire est modifié sur un ticket existant attribué à un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Commentaire modifié (envoyé) Lorsqu’un commentaire est modifié sur un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Nouveau commentaire (ticket attribué) Lorsqu’un nouveau commentaire est ajouté à un ticket existant attribué à un utilisateur, celui-ci reçoit une notification.
Notification Nouveau commentaire (ticket envoyé) Lorsqu’un nouveau commentaire est ajouté à un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (changement) Lorsqu’un ticket existant est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (nouveau) Lorsqu’un nouveau ticket est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Changement de responsable du ticket (envoyé) Lorsqu’un ticket est réaffecté, l’utilisateur ayant envoyé le ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket attribué) Lorsque l’état d’un ticket est modifié, le responsable du ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket envoyé) Lorsque l’état d’un ticket est modifié, l’utilisateur ayant envoyé le ticket reçoit une notification.
Page Ajouter un commentaire Fournit un formulaire permettant d’ajouter un commentaire à un ticket Jira.
Page Changer de responsable Fournit un formulaire permettant de changer le responsable d’un ticket Jira.
Page Modifier l’état Fournit un formulaire permettant de modifier l’état d’un ticket Jira.
Page Détails du commentaire Fournit une vue en lecture seule d’un commentaire et de ses détails correspondants.
Page Créer une sous-tâche Fournit un formulaire permettant de créer une sous-tâche pour un ticket Jira.
Page Détails du ticket Fournit une vue en lecture seule d’un ticket Jira et de ses détails correspondants.
Page Tickets Permet aux utilisateurs de rechercher des tickets Jira qui leur sont attribués, qu’ils ont envoyés ou sur lesquels ils ont commenté.