Configurer Workfront avec un connecteur hérité Adobe Experience Manager

25 avril 2025

Rubriques :

Créé pour :

Administration

En tant qu’administrateur ou administratrice Adobe Workfront, vous pouvez intégrer Workfront avec Adobe Experience Manager (AEM) Assets et fournir à votre organisation une solution de gestion de contenu complète pour la création, le partage et la maintenance des ressources dans votre workflow.

Conditions d’accès

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

Vous devez disposer des accès suivants pour effectuer les étapes de cet article :

Adobe Workfront plan

Tous

Adobe Workfront licence

Nouveau : Standard

Ou

Actuel : formule

Configurations des niveaux d’accès

Administrateur ou administratrice système

Pour plus de détails sur les informations contenues dans ce tableau, consultez Conditions d’accès préalables dans la documentation Workfront.

Workfront for AEM Assets

Le Workfront for AEM Assets connector permet à votre organisation d’effectuer les opérations suivantes :

Collaborez et gérez le contenu créatif en liant des ressources et dossiers AEM aux projets, tâches, problèmes et demandes dans Workfront.

Pour plus d’informations sur la configuration des intégrations de documentation avec des applications tierces, voir Configurer les intégrations de documents.
Intégrez le référentiel AEM Digital Asset Management (DAM), ce qui vous permet d’utiliser Workfront pour gérer et partager des ressources numériques stockées dans la gestion des ressources numériques.

Pour plus d’informations sur la liaison de documents et de dossiers de ressources, voir Lier des documents à partir d’applications externes.
Combinez et appliquez des métadonnées des deux applications à une ressource.
Affichez un flux de communication global pour une ressource. Les mises à jour et commentaires effectués sur une ressource dans Workfront ou AEM Assets sont synchronisés avec l’autre application, ce qui permet d’établir un historique complet des communications effectuées sur la ressource.

Pour plus d’informations sur la création de commentaires dans Workfront, voir Ajouter une mise à jour à un document.

Conditions préalables à l’installation du connecteur AEM Assets

Avant de pouvoir installer le connecteur Workfront pour AEM Assets, vérifiez que les conditions préalables suivantes sont remplies :

AEM Assets est installé et configuré, version 6.5 ou ultérieure. Pour plus d’informations sur l’installation d’AEM Assets, voir la Adobe Experience Manager documentation.
(Le cas échéant) Si les règles de pare-feu n’autorisent pas le trafic comme prévu, ajoutez l’adresse IP et/ou le domaine de votre cluster à votre liste autorisée. Pour plus d’informations, voir Configurer la liste autorisée de votre pare-feu.

Installer le package connecteur Workfront for AEM Assets

IMPORTANT

Les instructions suivantes concernent un connecteur hérité Workfront with AEM Assets, qui a été remplacé par le Workfront for Experience Manager connecteur amélioré. Contactez votre représentant ou représentante de compte pour plus d’informations.

Pour installer le connecteur Workfront for AEM Assets, vous devez importer le connecteur dans AEM sous la forme d’un package à l’aide du gestionnaire de packages CRX.

Sur un poste de travail où vous avez déjà installé AEM, téléchargez le fichier d’installation du connecteur Workfront for AEM Assets.

Vous pouvez obtenir le connecteur Workfront for AEM Assets auprès de votre personne représentante Workfront.
Connectez-vous à AEM à l’aide d’un compte d’administrateur ou d’administratrice.
Cliquez sur Outils > Déploiement > Packages. Le Gestionnaire de packages CRX s’ouvre.
Cliquez sur Charger le package.
Dans la boîte de dialogue Télécharger le package, recherchez et sélectionnez le package Connecteur Workfront, puis cliquez sur OK. Le package s’affiche dans le Gestionnaire de packages CRX.
Cliquez sur Installer.
Dans la boîte de dialogue Package, ignorez les paramètres avancés et cliquez sur Installer.
(Facultatif) Pour confirmer l’installation du connecteur, vérifiez que l’instruction suivante s’affiche dans le journal d’activité :
Package installed in <time>
Fermez le Gestionnaire de packages CRX. Le connecteur est installé et vous pouvez maintenant configurer l’intégration d’AEM Assets à Workfront.
Passez à Configurer AEM Assets pour l’intégrer à Workfront.

Configurer AEM Assets pour l’intégrer à Workfront

Après avoir installé le connecteur, importez le package connecteur vers AEM et configurez l’application pour lier les documents dans Workfront.

Pour plus d’informations sur l’installation du connecteur, voir Installer le package du connecteur Workfront for AEM Assets.

Conditions préalables
Intégrer AEM à Workfront
Configurer l’Externalizer d’AEM

Conditions préalables

Avant de commencer, vous devez activer les autorisations pour workfront-service :

Dans AEM, accédez à Outils > Sécurité > Autorisations.
Dans le coin supérieur gauche, choisissez Utilisateurs dans le menu déroulant, puis saisissez workfront-service dans le champ Rechercher . Sélectionnez l’utilisateur ou l’utilisatrice workfront-service.
Dans la partie droite de l’écran, sélectionnez Ajouter ACE pour créer des entrées.
Dans la fenêtre Ajouter une nouvelle entrée , cochez l'icône de case dans le champ Chemin et choisissez le dossier : /conf
Dans le champ Privilèges, saisissez : jcr:read
Dans le coin supérieur droit, sélectionnez Ajouter.
(Facultatif) Répétez les étapes ci-dessus pour créer d’autres entrées.

Intégrer AEM à Workfront

Connectez-vous à AEM Assets en tant qu’administrateur ou administratrice.
Cliquez sur Outils > Services cloud > Configuration de l’intégration de Workfront > Global-Workfront.
(Conditionnel) Si vous ne l’avez pas encore fait, créez un fichier de configuration cloud Workfront :
1. Dans l’angle supérieur droit de la page Global-Workfront, cliquez sur Créer.
2. Dans la zone URL Workfront, spécifiez l’URL de votre instance Workfront.
  
  Par exemple : https://<account>.my.workfront.com, où <account> est le compte que vous utilisez pour les intégrations avec AEM.
3. Dans le champDossier base, cochez l’icône en forme de case.
4. Dans le menu déroulant, sélectionnez le chemin d’accès où sont stockés les documents liés à Workfront objets .
5. Dans le modal d’AEM qui s’affiche, suivez le chemin d’accès au dossier contenant les documents connectés aux objets Workfront. Choisissez le dossier, puis appuyez sur Sélectionner dans le coin supérieur droit.
  
  Vous pouvez créer un lien vers n’importe quel dossier sous la racine /content/dam/.
6. Dans la Clé API Workfront, spécifiez votre clé API Workfront.
  
  Pour récupérer votre clé API Workfront :
  1. Ouvrez un onglet de navigateur et connectez-vous à votre compte Workfront en tant qu’administrateur ou administratrice Workfront.
Cliquez sur l’icône Menu principal dans le coin supérieur droit d’Adobe Workfront, ou (si disponible), cliquez sur l’icône Menu principal dans le coin supérieur gauche, puis cliquez sur Configuration .
1. Cliquez sur Système > Infos client.
  
  Si vous avez déjà généré une clé API, votre clé API Workfront s’affiche sous le libellé Votre clé API d’utilisateur.
2. (Le cas échéant) Si vous n’avez pas encore généré de clé API, vous devez en générer une :
  1. Dans la section Paramètres de clé API, assurez-vous que l’option Après création, les clés API expirent dans est définie sur Aucune.
    
    Si vous sélectionnez une période d’expiration, le connecteur cesse de fonctionner après l’expiration de la clé API. Vous devrez ensuite générer à nouveau une clé API et mettre à jour votre configuration Workfront.
  2. Sous le libellé Votre clé API d’utilisateur, cliquez sur Générer la clé API. Une clé API pour Workfront est générée et s’affiche.
3. Copiez la clé API dans le presse-papiers.
4. Ouvrez l’onglet du navigateur pour Connecteur AEM et dans la zone Workfront API Key , puis collez la clé API que vous avez copiée.
5. (Le cas échéant) Cliquez sur l’onglet Avancé dans le coin supérieur gauche de la page Configuration de l’intégration Workfront et sélectionnez les options suivantes, le cas échéant :
  
  Autoriser la navigation dans les collections : sélectionnez cette option si votre entreprise autorise les utilisateurs et utilisatrices Workfront à lier des collections AEM Assets à des objets Workfront.
  
  Federated ID utilisateur : sélectionnez cette option si votre organisation utilise des Federated ID ou l’authentification unique (SSO) lors de la connexion à Workfront.
  
  Ignorer le domaine de messagerie : sélectionnez cette option si vos utilisateurs et utilisatrices AEM n’utilisent pas le nom de domaine dans leur ID d’utilisateur ou d’utilisatrice.
  
  Limiter l’accès : sélectionnez cette option pour spécifier les adresses IP Workfront appropriées à ajouter à la liste autorisée. Pour plus d’informations sur la liste autorisée, voir Configurer la liste autorisée de votre pare-feu.
6. Dans le coin supérieur gauche de la page Configuration de l’intégration de Workfront, cliquez sur l’onglet De base, puis sur Connexion.
  
  NOTE
  L’application des modifications peut prendre un certain temps. Un redémarrage du lot peut accélérer le processus.
(Le cas échéant) Si vous avez déjà créé un fichier de configuration cloud Workfront, sélectionnez Global-Workfront puis, dans le coin supérieur gauche, cliquez sur Propriétés.
Générez la clé API AEM en cliquant sur Générer la clé, puis copiez la clé API AEM dans le presse-papiers.

Vous aurez besoin de la clé API AEM ultérieurement lorsque vous configurerez Workfront pour l’intégrer à AEM Assets. Pour plus d’informations, voir Configurer Workfront pour l’intégrer à AEM Assets.
Dans le coin supérieur droit, cliquez sur Enregistrer. La fenêtre Global-Workfront s’affiche.
(Facultatif) Synchronisez la communication bidirectionnelle entre AEM et Workfront :
1. Cliquez sur Global-Workfront.
2. Dans le coin supérieur gauche de la fenêtre, cliquez sur Propriétés. La page Configuration de l’intégration Workfront s’affiche.
3. (Facultatif) Pour activer la synchronisation des commentaires entre AEM Assets et Workfront, cliquez sur Activater la synchronisation des commentaires.
  
  IMPORTANT
  Vous devez activer Synchronisation des documents pour synchroniser les ressources.
4. (Facultatif) Pour désactiver la synchronisation des commentaires, cliquez sur Désactiver la synchronisation des commentaires.
  
  Ou
  
  Supprimez l’abonnement aux événements NOTE CREATE enregistré sur votre instance AEM.
  
  Pour plus d’informations sur les abonnements aux événements, voir API d’abonnement aux événements.
Continuez avec Configurer l’Externalizer AEM.

Configurer l’Externalizer AEM

L’Externalizer AEM permet à AEM de transmettre des URL dans un format pouvant être utilisé dans Workfront. Si elle n’est pas correctement configurée, Workfront ne pouvez pas effectuer d’appels vers l’API AEM et les URL liant les documents AEM dans Workfront ne fonctionneront pas.

Dans AEM, cliquez sur Outils > Opérations > Console web.
Cliquez sur OSGI, puis cliquez sur Configuration dans le menu déroulant.
Dans la liste de configuration, sélectionnez ’Externaliseur lien Day CQ . La page Externalizer s’affiche.
Dans la section Domaines, assurez-vous que le domaine répertorié dans le champ Création est le nom de domaine accessible de l’extérieur aux utilisateurs et utilisatrices AEM.

Le nom de domaine dans le champ Création doit correspondre au domaine répertorié dans la ligne URL de votre instance AEM.
(Le cas échéant) Si nécessaire, mettez à jour le domaine dans le champ Création.
Cliquer sur Enregistrer. AEM Assets est maintenant configuré pour lier des documents à des Workfront.
Passez à Configurer Workfront pour l’intégrer à AEM assets.

Configurer Workfront pour l’intégrer à AEM assets

Après avoir installé le connecteur Workfront pour AEM Assets (comme décrit dans Installer le package connecteur Workfront pour AEM Assets) et configuré AEM Assets (comme décrit dans Configurer AEM Assets pour l’intégrer à Workfront), vous devez configurer Workfront pour lier des documents entre Workfront et AEM Assets.

Connectez-vous à Workfront en tant qu’administrateur.

TIP
Workfront recommande de créer une personne chargée de l’administration Workfront dédiée uniquement à votre intégration AEM. Pour plus d’informations sur l’attribution du niveau d’accès d’administration Workfront à une personne, voir Accorder aux utilisateurs et aux utilisatrices un accès d’administration à certaines zones.
Cliquez sur l’icône Menu principal dans le coin supérieur droit d’Adobe Workfront, ou (si disponible), cliquez sur l’icône Menu principal dans le coin supérieur gauche, puis cliquez sur Configuration .
Cliquez sur Documents > Intégration personnalisée.
Cliquez sur Ajouter une intégration personnalisée.
Dans la zone Nom, saisissez le nom de l’intégration personnalisée.

Il s’agit du nom que voient les utilisateurs lorsqu’ils utilisent l’intégration dans Workfront.
Dans la zone URL de l’API de base, saisissez l’URL de votre instance AEM.

L’URL API de base se compose de l’URL de votre instance AEM suivie du chemin d’accès : /bin/webhooks/api/
Dans le menu déroulant Type d’authentification, sélectionnez ApiKey.
Dans la zone Clé API, collez la clé API AEM que vous avez copiée lors de la configuration d’AEM Assets.
Cliquer sur Enregistrer.
(Facultatif) Vérifiez que l’intégration est marquée comme Active.

Workfront est maintenant configuré pour fonctionner avec AEM Assets.

Pour accéder aux ressources dans AEM, chaque personne de Workfront qui doit utiliser le connecteur doit être configurée en tant qu’utilisateur ou utilisatrice dans AEM. Pour plus d’informations sur la création d’utilisateurs et d’utilisatrices, voir Configurer l’accès des utilisateurs et utilisatrices au connecteur.

Configurer l’accès des utilisateurs et utilisatrices au connecteur

Pour que les utilisateurs et utilisatrices puissent accéder au connecteur, ils doivent disposer d’un profil d’utilisateur ou d’utilisatrice dans AEM et appartenir à un groupe Workfront ayant des niveaux d’accès qui incluent les autorisations Créer et Supprimer.

Pour plus d’informations sur les autorisations Workfront, voir Créer ou modifier des niveaux d’accès personnalisés.

Configurer des utilisateurs et utilisatrices dans AEM assets

Configurer des utilisateurs et utilisatrices dans AEM assets

Connectez-vous à AEM Assets en tant qu’administrateur ou administratrice de Workfront.
Cliquez sur Outils > Sécurité > Utilisateurs.
(Le cas échéant) Si l’utilisateur ou l’utilisatrice n’a pas de profil d’utilisateur ou d’utilisatrice dans AEM, créez-en un.
1. Cliquez sur Créer un utilisateur ou une utilisatrice.
2. Saisissez les informations personnelles de l’utilisateur ou de l’utilisatrice.
  
  Le seul champ obligatoire est le champ ID. L’identifiant AEM de l’utilisateur ou de l’utilisatrice doit correspondre à son ID Workfront, qui est l’adresse e-mail Workfront de l’utilisateur ou de l’utilisatrice.
  
  Si vous avez sélectionné l’option Ignorer le domaine de messagerie lorsque vous avez configuré AEM pour l’intégration avec Workfront, alors l’identifiant AEM ne correspondra pas à l’adresse e-mail Workfront.
(Conditionnel) Si l’utilisateur possède un profil AEM, ouvrez son profil AEM :
1. Cliquez sur Utilisateur. La page Gestion des utilisateurs et utilisatrices s’affiche.
2. Cliquez sur l’utilisateur à ajouter, puis sur Propriétés. La page des paramètres de l’utilisateur ou de l’utilisatrice s’affiche.
Cliquez sur l’onglet Groupes.
Assurez-vous que l’utilisateur ou l’utilisatrice appartient à au moins un groupe Workfront ayant des niveaux d’accès qui incluent les autorisations Créer et Supprimer.
1. Pour ajouter l’utilisateur ou l’utilisatrice à un groupe existant, commencez à saisir le nom du groupe dans la zone Saisir le nom du groupe, puis sélectionnez le groupe lorsqu’il apparaît dans le menu déroulant.
  
  Ou
  
  Pour sélectionner un groupe dont l’utilisateur ou l’utilisatrice est membre, sélectionnez un groupe dans la section Groupes dont cet utilisateur ou cette utilisatrice est membre.
Cliquez sur Enregistrer.

recommendation-more-help