DocumentationWorkfrontGuide Workfront

Configurer Adobe Workfront for Jira

Last update: Tue Sep 03 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 votre Jira et les systèmes Workfront.

Après l’installation du module complémentaire, vous pouvez définir des workflows qui créent des problèmes Jira automatiquement lorsque des éléments de travail Workfront sont créés. 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 et utilisatrices 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 à la fois pour les versions Serveur et OnDemand (ou Cloud) du logiciel Jira.

Pour une liste de versions Jira que Workfront for Jira prend actuellement en charge, voir Workfront for Jira à l’adresse 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

Actuelle : Pro ou licence supérieure
Adobe Workfront licence

Nouvelle : Standard

ou

Actuelle : Plan
Jira accès

Accès pour l’administration système

Important : nous vous recommandons de créer des comptes d’administration système distincts dans Jira et Workfront qui seront dédiés à cette intégration, plutôt que d’utiliser des comptes existants qui peuvent être associés à des utilisateurs et utilisatrices existants.
Configurations des niveaux d’accès Vous devez être administrateur ou administratrice Workfront.

Pour plus d’informations sur ce tableau, voir la section 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 effectuer ce qui suit :

  • Définir les déclencheurs qui vont créer des éléments Jira lorsque des éléments Workfront sont créés.
  • Spécifier les champs à synchroniser entre les éléments liés entre Jira et Workfront.
NOTE
  • Après avoir configuré Workfront for Jira sur votre environnement Jira, tous les utilisateurs et utilisatrices de Jira voient un panneau droit Workfront sur tous les éléments Jira. Le panneau contient des informations sur les éléments pouvant être liés à partir de Workfront ou spécifie 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 Configurer des déclencheurs pour la liaison automatique d’éléments entre Jira et Workfront.

Pour configurer Workfront for Jira, procédez comme suit :

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

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

  3. Cliquez sur Modules complémentaires, puis cliquez 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
    Une personne doit disposer d’un apiKey valide dans Workfront pour établir une connexion réussie.

    Vous devez vous connecter à Workfront en tant qu’administrateur ou administratrice Workfront pour poursuivre la configuration.

    note note
    NOTE
    • Workfront se connecte à Jira en utilisant OAuth 2.0, une norme utilisée par la plupart des intégrations web pour l’authentification et l’autorisation des utilisateurs et utilisatrices.
    • Lorsque vous recevez une invitation à saisir le domaine de votre compte Workfront, saisissez-le au format suivant : domaineDeVotreEntreprise.my.workfront.com. Le domaine de votre entreprise est généralement le nom de votre entreprise.
    • L’authentification améliorée n’est pas disponible tant qu’un administrateur ou une administratrice de Workfront ne l’a pas activée pour cette intégration.

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

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

  8. Sélectionnez l’onglet Configuration 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 Configurer la synchronisation des champs entre les éléments Jira et Workfront.

    note note
    NOTE
    Après avoir défini les déclencheurs et la synchronisation des champs entre les deux applications, toute personne utilisant Workfront qui peut créer des tâches ou des problèmes peut potentiellement déclencher la création d’un élément dans Jira. La personne peut créer un élément si les critères de l’élément créé correspondent aux déclencheurs dans Jira, même si la personne n’a pas de licence Jira. En outre, toute personne utilisant Jira peut immédiatement commencer à travailler sur l’élément Jira et ses mises à jour sont visibles dans Workfront, sans nécessiter de licence Workfront. Toutes les mises à jour dans 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 d’activité, voir Afficher le Journal d’activité Jira.

Configurer des déclencheurs pour la liaison automatique d’éléments entre Jira et Workfront

En tant qu’administrateur ou administratrice système Jira, vous pouvez définir des déclencheurs qui créent automatiquement des problèmes dans Jira lorsqu’un élément dans 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 d’éléments Jira au fur et à mesure que des éléments Workfront sont créés :

  • L’intégration est unidirectionnelle : vous ne pouvez que déclencher la création automatique dans Jira des éléments que vous créez dans Workfront . Vous ne pouvez pas déclencher la création automatique dans Workfront des éléments que vous créez dans Jira.
  • Le nombre de déclencheurs que vous pouvez avoir n’est pas limité.
  • Si un élément créé dans Workfront correspond à plusieurs déclencheurs, un seul élément est créé dans Jira. L’élément est créé dans Jira selon le premier déclencheur (dans l’ordre dans lequel ils ont été définis dans Jira). Tous les autres déclencheurs sont ignorés.
  • Un seul élément dans Workfront peut être lié à un élément dans 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 afin de créer automatiquement des éléments dans Jira :

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

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

  3. Cliquez sur Modules complémentaires, puis sur 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 ou administratrice système.

    L’onglet Déclencheurs 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/utilisateur/utilisatrice/rôle Workfront, indiquez le nom d’une équipe, d’un utilisateur/utilisatrice ou d’une fonction Workfront, puis cliquez pour le sélectionner lorsqu’il s’affiche dans la liste.

    note note
    NOTE
    Une même équipe, un même utilisateur ou une même utilisatrice ou un même rôle ne peut pas avoir plusieurs déclencheurs.

    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 de projet Jira, 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 type de problè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 ou une utilisatrice 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 des éléments Jira et Workfront

En tant qu’administrateur ou administratrice 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 et d’autres se synchroniser 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 ou administratrice de Jira.

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

  3. Cliquez sur Modules complémentaires, puis sur 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 ou administratrice de Workfront.

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

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

    1. Sélectionnez l’une des fréquences de synchronisation des champs :

      table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
      On Creation Les champs que vous spécifiez sont synchronisés entre les éléments Workfront et Jira liés lors de la création de l’élément dans Workfront.
      Always Les champs que vous spécifiez sont synchronisés entre les éléments Workfront et Jira liés lorsque les champs sont mis à jour dans Workfront.
      Never 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 vers 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 ici. Lorsqu’un élément Jira est lié manuellement à un élément Workfront, le nom de l’élément Workfront se met à jour uniquement dans Jira lorsque vous sélectionnez de Toujours synchroniser ce champ. Pour plus d’informations sur la liaison manuelle ou automatique d’éléments, voir Lier des é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 il est lié 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 document de Workfront sont ajoutées en tant que documents distincts à Jira et sont ajoutés avec _v<version number> pour indiquer la version numérotée dans Workfront.

      Par exemple, si le nom d’un document dans Workfront est Main Ad (publicité principale), et que vous y ajoutez une nouvelle version dans Workfront, la nouvelle version est transférée à 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 parce que le document est trop volumineux, une erreur est consignée dans le journal d’activité.

        Pour plus d’informations sur le journal d’activité, voir Afficher le journal d’activité Jira.

      • Les documents liés à des tâches et des problèmes depuis des 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 une épreuve à partir d’un document, vous devez générer l’épreuve dans Workfront.

        Pour plus d’informations sur la génération d’une épreuve, voir Créer une épreuve pour un document existantdans Créer une épreuve pour un document.
      Planned Completion Date

      La Planned Completion Date d’une tâche ou d’un problème dans Workfront devient la Due Date du problème auquel il est lié dans Jira.

      Note : assurez-vous d’afficher la Due Date  sur les problèmes Jira, pour que cette valeur se synchronise.

  9. Dans la section Synchroniser depuis Jira versWorkfront, sélectionnez les champs à mettre à jour dans Workfront lorsqu’ils sont mis à jour dans Jira.

    1. Sélectionnez l’une des fréquences de synchronisation des champs :

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

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

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

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

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Status Le Status d’un problème dans Jira devient le Status de la tâche ou du problème auquel il est lié dans Workfront.
      Pour plus d’informations sur les statuts Workfront, voir Créer ou modifier un statut.
      Assignee

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

      Important : lorsque vous affectez un élément dans Jira à une personne qui ne dispose pas de compte Workfront, l’intégration crée un utilisateur actif ou une utilisatrice active dans Workfront uniquement lorsque l’option Créer automatiquement un utilisateur ou une utilisatrice dans Workfront si l’utilisateur ou l’utilisatrice Jira ne possède pas de compte Workfront est définie sur Always. Cette personne ne dispose pas de licence Workfront.Les utilisateurs et utilisatrices actifs peuvent être affectés à des éléments de travail dans Workfront, mais ne peuvent pas être inclus dans les mises à jour.
      Attachments Les pièces jointes d’un problème dans Jira sont également associées à l’objet (tâche ou 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 Updates. À l’inverse, un commentaire publié dans la zone Updates pour une tâche ou un problème Workfront se synchronise avec le flux des commentaires natifs de Jira pour le problème lié.

      Ceci est défini sur Always par défaut. Si vous sélectionnez Never ici, vous pouvez toujours publier des commentaires manuellement sur un élément lié, dans Workfront ou dans Jira.

  10. Dans la section AUTRES, 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 réglez sur Toujours ou Jamais s’actualisent dans Jira ou dans Workfront lorsqu’ils sont modifiés.

    2. Effectuez un choix dans les champs et mises à jour suivants :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Copy Workfront Custom Data in the right panel in Jira

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

      Note : les sections Formulaire personnalisé s’affichent dans le panneau droit de Workfront avec le niveau d’accès de l’administration système Workfront.
      Copy Workfront Priority in the right panel in Jira Affiche la priorité Workfront d’un élément dans le panneau droit de Workfront.
      Add an update in the Workfront Updates tab about Due Date changes in Jira Ajoute un commentaire dans l’onglet Update de l’élément Workfront lorsque la Due Date change dans l’élément Jira lié.
      Automatically create a user in Workfront if the Jira user does not have a Workfront account

      Les scénarios suivants sont possibles :

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

        • Affectation à un problème Jira

        • Consignation de temps dans un problème Jira

          Cette nouvelle personne ne dispose pas de licence Workfront. Le paramètre par défaut est Toujours.Le terme « Jira » est ajouté au nom de la personne créée de cette façon dans Workfront.

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

        • Vous ne pouvez pas voir les affectations Jira sur les éléments Workfront. Dans ce cas, seules les affectations effectuées dans Workfront s’affichent sur les éléments Workfront.
        • Les heures consignées sur un problème Jira lié par une personne ne disposant pas d’un compte Workfront ne sont pas automatiquement transférées vers l’élément Workfront lié. Vous pouvez toujours consigner les heures passées sur l’élément Workfront dans le panneau de droite du problème Jira.

  11. Cliquer sur Enregistrer.

    Désormais, à chaque fois qu’une personne met à jour l’un des champs spécifiés dans cette configuration pour 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 de champs déclencheurs marqués « Éléments introuvables ».

Problème

Lorsqu’une erreur liée à l’application Workfront for Jira se produit, Workfront désactive les déclencheurs pour éviter d’autres complications. Lorsque ces déclencheurs sont désactivés, ils s’affichent sous la forme « Éléments introuvables ».

Solution

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

La cause la plus courante de ce comportement est l’erreur « Le champ « duedate » ne peut pas être défini. Il ne se trouve pas dans l’écran approprié ou il est inconnu. »

Cette erreur signifie que vous tentez de synchroniser la « Date d’achèvement prévue » de Workfront vers Jira. Pour ce faire, vous devez vous assurer que vos objets Jira ont un champ appelé « Date d’échéance ». S’ils ne disposent pas de ce champ, 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 équipe d’administration Jira de mettre à jour les objets Jira affectés afin de s’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