Configurer Workfront avec un connecteur hérité Adobe Experience Manager
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
Vous devez disposer des accès suivants pour effectuer les étapes de cet article :
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront formule* | Tous |
| Adobe Workfront licence* | Plan |
| Configurations du niveau d’accès* | Vous devez être un administrateur ou une administratrice Workfront. Pour plus d’informations sur les administrateurs et les administratrices Workfront, voir Accorder à un utilisateur ou à une utilisatrice un accès administratif complet. |
*Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez l’administration de 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 d’installer le connecteur Workfront pour AEM Assets, assurez-vous que les conditions préalables suivantes sont remplies :
- AEM Assets 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 install-the-workfront-for-aem-assets-connector-package
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 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é :
code language-none 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.
Configurer AEM Assets pour l’intégrer à Workfront configure-aem-assets-to-integrate-with-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 prerequisites
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 et utilisatrices dans le menu déroulant et 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 entrée, sélectionnez l’icône de case à cocher dans le champ Chemin et choisissez le dossier : /conf.
- Dans le champ Privilèges, saisissez : jcr:read.
- Sélectionnez Ajouter dans le coin supérieur droit.
- (Facultatif) Répétez les étapes pour créer d’autres entrées.
Intégrer AEM à Workfront integrate-aem-with-workfront
-
Connectez-vous à AEM Assets en tant qu’administrateur ou administratrice.
-
Cliquez sur Outils >Services cloud >Configuration de l’intégration Workfront > Global-Workfront.
-
(Le cas échéant) Si vous ne l’avez pas encore fait, créez un fichier de configuration cloud Workfront.
-
Cliquez sur Créer dans le coin supérieur droit de la page Global-Workfront.
-
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. -
Dans le Dossier de base, cliquez sur l’icône de case à cocher puis, dans le menu déroulant, sélectionnez le chemin d’accès où les documents liés aux objets Workfront sont stockés.
-
Dans le modal d’AEM qui s’affiche, suivez le chemin d’accès au dossier contenant les documents connectés aux objets Workfront. Sélectionnez le dossier et 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/.
-
Dans la Clé API Workfront, spécifiez votre clé API Workfront.
Pour récupérer votre clé API Workfront :
- 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
-
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 ou d’utilisatrice.
-
(Le cas échéant) Si vous n’avez pas encore généré de clé API, vous devez en générer une :
-
Dans la section Paramètres de la clé API, assurez-vous que l’option Après leur création, les clés API expirent dans est définie sur Aucun.
Si vous sélectionnez une période d’expiration, le connecteur cesse de fonctionner après l’expiration de la clé API. Vous devrez alors générer à nouveau une clé API et mettre à jour votre configuration Workfront.
-
Sous le libellé Votre clé API d’utilisateur ou d’utilisatrice, cliquez sur Générer la clé API.
Une clé API pour Workfront est générée et s’affiche.
-
-
Copiez la clé API dans le presse-papiers.
-
Ouvrez l’onglet du navigateur pour AEM Connector puis, dans la zone Workfront API Key, collez la clé API que vous avez copiée.
-
(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 d’utilisateur ou d’utilisatrice : sélectionnez cette option si votre entreprise 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.
-
Cliquez sur l’onglet De base dans le coin supérieur gauche de la page Configuration de l’intégration Workfront, puis sur Connecter.
note note 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.
-
Cliquez sur Global-Workfront.
-
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.
-
(Facultatif) Pour activer la synchronisation des commentaires entre AEM Assets et Workfront, cliquez sur Activater la synchronisation des commentaires.
note important IMPORTANT Vous devez activer Synchronisation des documents pour synchroniser les ressources. -
(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 configure-the-aem-externalizer
L’Externalizer AEM permet à AEM de transmettre des URL dans un format pouvant être utilisé dans Workfront. S’il n’est pas correctement configuré, Workfront ne peut 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 des configurations, sélectionnez Externalizer de 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 à Workfront.
-
Continuez avec Configurer Workfront pour l’intégrer à AEM assets.
Configurer Workfront pour l’intégrer à AEM assets configure-workfront-to-integrate-with-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 ou administratrice Workfront.
note tip 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
-
Cliquez sur Documents > Intégration personnalisée.
-
Cliquez sur Ajouter une intégration personnalisée.
-
Dans la zone Nom, indiquez le nom de l’intégration personnalisée.
Il s’agit du nom que les utilisateurs et utilisatrices voient lors de l’utilisation de l’intégration dans Workfront. Par exemple, vous pouvez saisir « AEM Assets » pour le nom.
-
Dans l’URL API de base, spécifiez 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 set-up-users-to-use-the-connector
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 set-up-users-in-aem-assets
-
Connectez-vous à AEM Assets en tant qu’administrateur ou administratrice Workfront.
-
Cliquez sur Outils > Sécurité > Utilisateurs et utilisatrices.
-
(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.
-
Cliquez sur Créer un utilisateur ou une utilisatrice.
-
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.
-
-
(Le cas échéant) Si l’utilisateur ou l’utilisatrice dispose d’un profil AEM, ouvrez-le.
-
Cliquez sur Utilisateur ou utilisatrice.
La page Gestion des utilisateurs et utilisatrices s’affiche.
-
Cliquez sur l’utilisateur ou l’utilisatrice à 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.
-
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.