DocumentationWorkfrontGuide Workfront

Configurer Adobe Workfront for Jira

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Vous pouvez utiliser Adobe Workfront for Jira pour intégrer vos systèmes Jira et Workfront.

Après l’installation du module complémentaire, vous pouvez définir des workflows qui créent automatiquement des problèmes Jira lors de la création d’éléments de travail Workfront. Les éléments des deux applications sont liés et certaines de leurs informations sont automatiquement mises à jour dans les deux systèmes.

Tous les utilisateurs de Workfront et Jira peuvent bénéficier de cette intégration. Ils n'ont besoin d'une licence que pour le système dans lequel ils travaillent le plus, et non pour les deux systèmes.

Ce module complémentaire est disponible pour les versions Server et OnDemand (ou Cloud) du logiciel Jira.

Pour obtenir la liste des Jira versions actuellement prises en charge par Workfront for Jira, voir Workfront for Jira sur le Atlassian Marketplace.

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

Vous devez disposer des éléments suivants :

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront plan

Nouveau : Tous

ou

Actuel : Pro ou version ultérieure
Adobe Workfront licence

Nouvelle : Standard

ou

Actuelle : Plan
Jira access

Accès administrateur système

Important : Nous vous recommandons de créer des comptes d’administrateur système distincts dans Jira et Workfront afin de vous consacrer à cette intégration, plutôt que d’utiliser des comptes existants pouvant être joints aux utilisateurs.
Configurations du niveau d’accès Vous devez être un administrateur ou une administratrice Workfront.

Pour plus d’informations sur ce tableau, consultez Conditions d’accès requises dans la documentation Workfront.

Conditions préalables

Avant de pouvoir configurer Workfront for Jira, vous devez :

Configurer Workfront for Jira

En configurant Workfront for Jira, vous pouvez :

  • Définissez des déclencheurs qui créeront Jira éléments lors de la création de Workfront éléments.
  • Spécifiez les champs à synchroniser entre les éléments liés entre Jira et Workfront.
NOTE
  • Une fois que vous avez configuré Workfront for Jira sur votre environnement Jira, tous les utilisateurs Jira voient un panneau de droite Workfront sur tous les éléments Jira. Le panneau contient des informations sur les éléments qui peuvent être liés à partir de Workfront ou indique qu’aucun élément Workfront n’est lié à des éléments Jira.
  • Lors de l’utilisation de l’installation Jira Server, seuls les problèmes associés aux projets identifiés comme déclencheurs de l’intégration Workfront affichent le panneau Workfront. Pour plus d’informations sur la configuration des déclencheurs pour le workflow Workfront to Jira, voir Configuration des déclencheurs pour la liaison automatique d’éléments entre Jira et Workfront.

Pour configurer Workfront for Jira :

  1. Connectez-vous à Jira en tant qu’administrateur Jira.

  2. Cliquez sur Paramètres dans le menu principal Jira.

  3. Cliquez sur Add-ons, puis sur Gérer les modules complémentaires.

  4. Développez le module complémentaire Workfront.

  5. Cliquez sur Configurer.

  6. Suivez les invites pour vous connecter à Workfront.

    note note
    NOTE
    L’utilisateur doit disposer d’un apiKey valide dans Workfront pour créer une connexion réussie.

    Vous devez vous connecter à Workfront en tant qu'administrateur Workfront pour continuer la configuration.

    note note
    NOTE
    • Workfront se connecte à Jira à l’aide d’OAuth 2.0, une norme utilisée par la plupart des intégrations web pour l’authentification et l’autorisation des utilisateurs.
    • Lorsque vous êtes invité à saisir le domaine de votre compte Workfront, saisissez-le au format suivant : yourCompany'sDomain.my.workfront.com. Le domaine de votre société correspond généralement au nom de votre société.
    • L’authentification améliorée n’est pas disponible tant qu’un administrateur Workfront ne l’a pas activée pour cette intégration.

  7. Dans Jira, sélectionnez l’onglet Triggers pour configurer la création automatique de Jira éléments à mesure que de nouveaux Workfront éléments sont créés.

    Pour plus d’informations sur la configuration des déclencheurs pour le processus Workfront vers Jira, voir Configuration des déclencheurs pour la liaison automatique d’éléments entre Jira et Workfront.

  8. Sélectionnez l'onglet Setup pour configurer la synchronisation des champs entre les éléments Jira et Workfront liés.

    Pour plus d’informations sur la configuration de la synchronisation des champs entre Jira et Workfront, voir Configuration de la synchronisation des champs entre Jira et Workfront Éléments.

    note note
    NOTE
    Après avoir défini les déclencheurs et la synchronisation des champs entre les deux applications, tout utilisateur Workfront pouvant créer des tâches ou des problèmes peut potentiellement déclencher la création d’un élément dans Jira. L’utilisateur peut créer un élément si les critères qu’il crée correspondent aux déclencheurs dans Jira, même si l’utilisateur ne dispose pas d’une licence Jira. En outre, tout utilisateur de Jira peut immédiatement commencer à travailler sur l’élément Jira et ses mises à jour sont visibles dans Workfront, sans disposer d’une licence Workfront. Toutes les mises à jour de Workfront sont également visibles sur les éléments Jira .

  9. (Facultatif) Sélectionnez l’onglet Journal d’activité pour passer en revue les erreurs qui se sont produites pendant l’intégration.

    Pour plus d’informations sur le journal des activités, voir Affichage du Jira journal des activités.

Configuration de déclencheurs pour la liaison automatique d’éléments entre Jira et Workfront

En tant qu'administrateur système Jira, vous pouvez définir des déclencheurs qui créeraient automatiquement des problèmes dans Jira lorsqu'un élément de Workfront répond à certains critères.

NOTE
L’intégration peut prendre jusqu’à 10 minutes pour créer de nouveaux problèmes dans Jira.

Tenez compte de ce qui suit lors de la configuration du déclenchement de la création de Jira éléments lorsque Workfront éléments sont créés :

  • L’intégration est unidirectionnelle : vous pouvez uniquement déclencher la création automatique d’éléments que vous créez dans Workfront dans Jira. Vous ne pouvez pas déclencher la création automatique d’éléments que vous créez dans Jira dans Workfront.
  • Le nombre de déclencheurs que vous pouvez avoir n’est pas limité.
  • Si un élément que vous créez dans Workfront correspond à plusieurs des déclencheurs, un seul élément est créé dans Jira. L’élément est créé dans Jira en fonction du premier déclencheur (dans l’ordre dans lequel il a été défini dans Jira). Tous les autres déclencheurs sont ignorés.
  • Un seul élément de Workfront peut être lié à un élément de Jira. Vous ne pouvez jamais lier un élément Workfront à plusieurs problèmes Jira ou un problème Jira à plusieurs éléments Workfront.

Pour configurer des déclencheurs pour la création automatique d’éléments dans Jira :

  1. Connectez-vous à Jira en tant qu’administrateur système.

  2. Cliquez sur Paramètres dans le menu principal Jira.

  3. Cliquez sur Add-ons, puis Gérer les modules complémentaires.

  4. Développez le module complémentaire Workfront.

  5. Cliquez sur Configurer.

  6. Connectez-vous à Workfront en tant qu’administrateur système.

    L’onglet Triggers est sélectionné par défaut dans Jira.

  7. Cliquez sur Ajouter un déclencheur pour ajouter un nouveau déclencheur.

  8. Dans le champ Équipe de Workfront/utilisateur/rôle, indiquez le nom d’une équipe Workfront, d’un utilisateur ou d’un rôle de tâche, puis cliquez pour le sélectionner lorsqu’il s’affiche dans la liste.

    note note
    NOTE
    Vous ne pouvez pas avoir plusieurs déclencheurs pour une même équipe, un même utilisateur ou un même rôle.

    Lorsqu’une personne crée une tâche ou un problème et l’affecte à l’une de ces entités, un problème est automatiquement créé dans Jira.

  9. Dans le champ Jiraproject , commencez à saisir le nom d’un projet Jira, puis cliquez pour le sélectionner lorsqu’il s’affiche dans la liste.

    Lorsque le problème Jira est créé, il est placé sur le projet que vous avez choisi ici.

  10. Sélectionnez un Itype de thème dans le menu déroulant.

    Cela indique le type de problème créé dans Jira lorsque les conditions de ce déclencheur sont remplies, en fonction de vos paramètres pour ce projet spécifique dans Jira.

  11. Cliquer sur Enregistrer.

    Avec cette configuration, chaque fois qu’un utilisateur Workfront crée un élément correspondant aux déclencheurs spécifiés, un nouveau problème est créé dans Jira.

Configurer la synchronisation des champs entre Jira et Workfront éléments

En tant qu'administrateur Jira, vous pouvez définir les champs à synchroniser automatiquement sur les éléments liés entre Workfront et Jira. Certains champs peuvent se synchroniser de l’élément Workfront vers l’élément Jira, tandis que d’autres se synchronisent de Jira vers Workfront.

Pour définir les champs à synchroniser automatiquement sur les éléments liés entre les deux applications :

  1. Connectez-vous à Jira en tant qu’administrateur Jira.

  2. Cliquez sur Paramètres dans le menu principal Jira.

  3. Cliquez sur Add-ons, puis Gérer les modules complémentaires.

  4. Développez le module complémentaire Workfront.

  5. Cliquez sur Configurer.

  6. Connectez-vous à Workfront en tant qu’administrateur Workfront.

  7. Dans Jira, cliquez sur l’onglet Setup .

  8. Dans la section Synchroniser de Workfront à Jira , sélectionnez les champs que vous souhaitez mettre à jour dans Jira lorsqu’ils sont mis à jour dans Workfront.

    1. Sélectionnez l'une des fréquences avec lesquelles les champs sont synchronisés :

      table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
      À La Création Les champs que vous spécifiez sont synchronisés entre les éléments Workfront liés et Jira lorsque l’élément est créé dans Workfront.
      Toujours Les champs que vous spécifiez sont synchronisés entre les éléments Workfront liés et Jira lorsque les champs sont mis à jour dans Workfront.
      Jamais Les champs que vous spécifiez ne sont jamais synchronisés entre les éléments Workfront et Jira liés. Il n’y a aucune indication dans Jira que le champ a été mis à jour dans Workfront.

    2. Sélectionnez l’une des options suivantes pour synchroniser les champs de Workfront à Jira :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Name

      Le nom d'une tâche ou d'un problème dans Workfront devient le nom du problème auquel il est lié dans Jira.

      Remarque : Lorsque de nouveaux éléments sont créés automatiquement dans Jira, le nom Workfront est toujours mis à jour sur l’élément Jira, que ce champ soit activé ou non dans ce champ. Lorsqu’un élément Jira est lié manuellement à un élément Workfront, le nom de l’élément Workfront n’est mis à jour que dans Jira lorsque vous sélectionnez Toujours pour synchroniser ce champ. Pour plus d’informations sur la liaison manuelle ou automatique d’éléments, voir Liaison d’éléments entre Adobe Workfront et Jira.
      Description La description d'une tâche ou d'un problème dans Workfront devient la description du problème auquel elle est liée dans Jira.
      Documents

      Les documents joints à une tâche ou à un problème dans Workfront sont également joints au problème auquel il est lié dans Jira. Les nouvelles versions de documents de Workfront sont ajoutées en tant que documents distincts à Jira et sont ajoutées avec _v<numéro de version> pour indiquer la version numérotée dans Workfront.

      Par exemple, si le nom d’un document dans Workfront est Main Ad et que vous y ajoutez une nouvelle version dans Workfront, la nouvelle version est transférée vers Jira en tant que nouveau document portant le nom Main Ad_v2.

      Important :

      Tenez compte des points suivants lors de la synchronisation de documents :

      • Les documents de plus de 5 Mo ne sont pas synchronisés. Si la synchronisation d’un document échoue car le document est trop volumineux, une erreur est consignée dans le journal d’activité.

        Pour plus d’informations sur le journal des activités, voir Affichage du journal des activités Jira.

      • Les documents liés à des tâches et des problèmes provenant de serveurs externes ne sont pas transférés vers les éléments Jira. Seuls les documents chargés directement sur la tâche ou le problème dans Workfront sont transférés vers le problème lié dans Jira.

      • Pour créer un BAT à partir d’un document, vous devez générer le BAT dans Workfront.

        Pour plus d'informations sur la génération d'un BAT, voir Création d'un BAT pour un document existantdans Création d'un BAT pour un document.
      Date d’achèvement prévue

      La Date d’achèvement planifiée d’une tâche ou d’un problème dans Workfront devient la Date d’échéance du problème auquel elle est liée dans Jira.

      Remarque : Assurez-vous d’afficher Échéance sur les problèmes Jira pour que cette valeur soit synchronisée.

  9. Dans la section Synchroniser de Jira àWorkfront , sélectionnez les champs que vous souhaitez mettre à jour dans Workfront lorsqu'ils sont mis à jour dans Jira.

    1. Sélectionnez l'une des fréquences avec lesquelles les champs sont synchronisés :

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      Toujours Les champs que vous spécifiez sont toujours synchronisés entre les éléments Workfront et Jira liés lorsque les champs sont mis à jour dans Jira.
      Jamais

      Les champs que vous spécifiez ne sont jamais synchronisés entre les éléments Workfront et Jira liés. Il n’y a aucune indication dans Workfront que le champ a été mis à jour dans Jira.

      Remarque : Lorsque vous sélectionnez Jamais, les champs Workfront peuvent toujours être mis à jour manuellement à partir de Jira dans le panneau de gauche Workfront du problème Jira. Ces mises à jour s’affichent uniquement sur les éléments Workfront de Jira et Workfront et non sur les éléments Jira.

    2. Sélectionnez pour synchroniser l’un des champs suivants de Jira à Workfront :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Status L’Status d’un problème dans Jira devient l’Status de la tâche ou du problème auquel il est lié dans Workfront.
      Pour plus d’informations sur les états Workfront, voir Création ou modification d’un état.
      Cessionnaire

      Le cessionnaire d’un problème dans Jira devient le cessionnaire de la tâche ou du problème auquel il est lié dans Workfront.

      Important : Lorsque vous affectez un élément dans Jira à un utilisateur qui n’a pas de compte Workfront, l’intégration crée un nouvel utilisateur actif dans Workfront uniquement lorsque Créer automatiquement un utilisateur dans Workfront si l’utilisateur Jira n’a pas de compte Workfront est défini sur Toujours. Cet utilisateur n’utilise pas de licence Workfront. Les utilisateurs actifs peuvent être affectés à des tâches dans Workfront, mais ne peuvent pas être inclus dans les mises à jour.
      Pièces jointes Les pièces jointes d'un problème dans Jira sont également jointes à la tâche ou au problème auquel il est lié dans Workfront.
      Comments

      Un commentaire sur un problème Jira est également publié sur l’élément Workfront lié dans la zone Mises à jour. Inversement, un commentaire publié dans la zone Mises à jour pour une tâche Workfront ou émet des synchronisations avec le flux de commentaires natif de Jira pour le problème lié.

      Il est défini sur Toujours par défaut. Si vous sélectionnez Jamais ici, vous pouvez toujours publier des commentaires manuellement sur un élément lié, que ce soit dans Workfront ou dans Jira.

  10. Dans la section AUTRE , sélectionnez les champs supplémentaires à mettre à jour entre les éléments liés.

    1. Sélectionnez une option pour déterminer si les champs que vous spécifiez Toujours ou Jamais se mettent à jour dans Jira ou Workfront lorsqu’ils sont modifiés.

    2. Sélectionnez l’un des champs et mises à jour suivants :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Copier Workfront des données personnalisées dans le panneau de droite de Jira

      Affiche les Workfront données personnalisées d’un élément dans le panneau de droite de Workfront.

      Remarque : les sections Formulaire personnalisé s’affichent dans le panneau de droite Workfront avec le niveau d’accès de l’administrateur système Workfront.
      Copie Workfront Priorité dans le panneau de droite de Jira Affiche la priorité Workfront d’un élément dans le panneau de droite Workfront.
      Ajout d’une mise à jour dans l’onglet Workfront Mises à jour concernant les changements de date d’échéance dans Jira Ajoute un commentaire dans l’onglet Mettre à jour de l’élément Workfront lorsque la Date d’échéance change dans l’élément Jira lié.
      Créer automatiquement un utilisateur dans Workfront si l’utilisateur Jira n’a pas de compte Workfront

      Les scénarios suivants sont possibles :

      • Lorsque vous sélectionnez Toujours, vous activez l’intégration pour créer un utilisateur Workfront chaque fois qu’un utilisateur Jira sans compte Workfront effectue les actions suivantes sur un problème Jira lié :

        • Est affecté à un problème Jira

        • Consigne le temps d’un problème Jira

          Ce nouvel utilisateur n’utilise pas de licence Workfront. Le paramètre par défaut est Toujours. "Jira" a été ajouté à son nom pour l’utilisateur créé de cette manière dans Workfront.

      • Lorsque vous sélectionnez Jamais, les événements suivants se produisent :

        • Vous ne pouvez pas voir d’affectations Jira sur les éléments Workfront. Dans ce cas, seules les affectations effectuées dans Workfront s’affichent sur les éléments Workfront.
        • L’heure connectée à un problème Jira lié par un utilisateur sans compte Workfront ne se transfère pas automatiquement vers l’élément Workfront lié. Vous pouvez toujours consigner l’heure sur l’élément Workfront dans le panneau droit du problème Jira.

  11. Cliquer sur Enregistrer.

    Désormais, chaque fois qu’un utilisateur met à jour l’un des champs spécifiés dans cette configuration sur un élément dans Jira ou Workfront, l’élément lié dans l’autre application est également mis à jour.

Dépannage

Les éléments ne peuvent pas être créés dans Jira en raison des champs déclencheurs marqués "Impossible de trouver"

Problème

Lorsqu'une erreur se produit avec l'application Workfront for Jira, Workfront désactive les déclencheurs pour éviter d'autres complications. Lorsque ces déclencheurs sont désactivés, ils s’affichent comme "Impossible de trouver".

Solution

Recherchez l’erreur qui a désactivé les déclencheurs. Vous pouvez trouver l’erreur dans le Workfront for Jira Journal d’activité.

La cause la plus courante de ce comportement est l’erreur "Field ’duedate’ ne peut pas être définie. Il ne se trouve pas sur l’écran approprié, ou inconnu."

Cette erreur signifie que vous tentez de synchroniser la "date d’achèvement prévue" de Workfront à Jira. Pour ce faire, vous devez vous assurer que vos objets Jira ont un champ appelé "Date d’échéance". Si ce champ n’est pas disponible, Workfront ne peut pas synchroniser la date d’achèvement prévue à partir de Workfront et désactive vos déclencheurs.

Pour résoudre cette erreur, essayez l’une des méthodes suivantes :

  • Demandez à votre administrateur Jira de mettre à jour les objets Jira concernés pour vous assurer qu'ils disposent d'un champ de date d'échéance.
  • Désactivez la synchronisation de la date d'achèvement prévue de Workfront dans la page Configuration de Workfront.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43