Installation de la version Workfront for Experience Manager enhanced connector

Un utilisateur disposant d’un accès administrateur dans Adobe Experience Manager as a Cloud Service installe le connecteur amélioré. Avant de procéder à l’installation, vérifiez la prise en charge de la plateforme et d’autres conditions préalables pour le connecteur.

Avant d’installer le connecteur, procédez comme suit :

1. Si votre programme AEM as a Cloud Service a configuré la mise en réseau avancée et activé la liste autorisée d’IP, vous devez ajouter les adresses IP de Workfront à cette liste autorisée pour permettre aux abonnements aux événement et aux divers appels API de passer à AEM.

   • IP de cluster Workfront. Pour connaître le cluster d’IP dans Workfront, accédez à Configuration > Système > Informations sur le client.

   • IP des API d’abonnement à un événement Workfront

   IMPORTANT

   • Si la mise en réseau avancée est configurée pour votre programme et que vous utilisez la liste autorisée d’IP, en raison d’une limitation de l’architecture du connecteur amélioré de Workfront, vous devez également ajouter l’adresse IP sortante du programme à la liste autorisée dans Cloud Manager.

   • p{PROGRAM_ID}.external.adobeaemcloud.com

   • Pour trouver l’adresse IP de votre programme, ouvrez une fenêtre de terminal et exécutez une commande, telle que :

     
     
     dscacheutil -q host -a name p{PROGRAM_ID}.external.adobeaemcloud.com
     
     

2. Assurez-vous que les recouvrements suivants n’existent pas dans le référentiel Experience Manager : Si ces chemins contiennent des recouvrements préexistants, vous devez supprimer les recouvrements ou fusionner les différences de modifications entre les deux :

   • /apps/dam/gui/coral/components/admin/schemaforms/formbuilder
   • /apps/dam/gui/coral/components/admin/folderschemaforms/formbuilder
   • /apps/dam/gui/content/foldermetadataschemaeditor
   • /apps/dam/cfm/models/editor/components/datatypeproperties
   • /apps/settings/dam/cfm/models/formbuilderconfig
   • /apps/dam/gui/content/assets/jcr:content/actions/secondary/create/items/fileupload

3. Cette installation nécessite des connaissances pour définir un projet Maven dans Experience Manager as a Cloud Service. Utilisez les ressources suivantes pour comprendre comment inclure un package tiers dans votre projet Maven :

   • Incluez un package tiers dans votre projet Maven.
   • Effectuez le déploiement avec Cloud Manager.

Pour installer le module complémentaire dans Experience Manager as a Cloud Service, procédez comme suit :

1. Téléchargez le connecteur amélioré depuis la distribution logicielle Adobe.

2. Accédez à votre référentiel AEM as a Cloud Service et clonez-le à partir de Cloud Manager.

3. Ouvrez le référentiel AEM as a Cloud Service cloné à l’aide d’un IDE de votre choix.

4. Placez le fichier zip du connecteur amélioré téléchargé à l’étape 1 à l’emplacement suivant :

      /ui.apps/src/main/resources/<zip file>
   

   REMARQUE

   Si le dossier resources n’existe pas, créez-le.

5. Ajoutez des dépendances pom.xml :

   1. Ajoutez une dépendance dans le fichier parent pom.xml.

      <dependency>
         <groupId>digital.hoodoo</groupId>
         <artifactId>workfront-tools.ui.apps</artifactId>
         <type>zip</type>
         <version>enhanced connector version number</version>
         <scope>system</scope>
         <systemPath>${project.basedir}/ui.apps/src/main/resources/workfront-tools.ui.apps.zip</systemPath>
      </dependency>
      

      REMARQUE

      Veillez à mettre à jour le numéro de version du connecteur amélioré avant de copier la dépendance sur le parent pom.xml.

   2. Ajoutez une dépendance dans le fichier all module pom.xml.

         <dependency>
            <groupId>digital.hoodoo</groupId>
            <artifactId>workfront-tools.ui.apps</artifactId>
            <type>zip</type>
            <scope>system</scope>
            <systemPath>${project.basedir}/../ui.apps/src/main/resources/workfront-tools.ui.apps.zip</systemPath>
         </dependency>
      

6. Ajoutez des incorporations pom.xml. Ajoutez les packages Workfront for Experience Manager enhanced connector à la section embeddeds du pom.xml de tous vos sous-projets. Nécessite qu’il soit incorporé dans tous les modules pom.xml.

   <!-- Workfront Tools -->
   <embedded>
      <groupId>digital.hoodoo</groupId>
      <artifactId>workfront-tools.ui.apps</artifactId>
      <type>zip</type>
      <target>/apps/<path-to-project-install-folder>/install</target>
   </embedded>
   

   La cible de la section incorporée est définie sur /apps/<path-to-project-install-folder>/install. Ce chemin d’accès JCR /apps/<path-to-project-install-folder> doit être inclus dans les règles de filtrage du fichier all/src/main/content/META-INF/vault/filter.xml. Les règles de filtrage du référentiel sont généralement dérivées du nom du programme. Utilisez le nom du dossier comme cible dans les règles existantes.

7. Envoyez les modifications au référentiel.

8. Exécutez le pipeline pour déployer les modifications dans Cloud Manager.

9. Pour créer une configuration utilisateur système, créez wf-workfront-users dans le groupe d’utilisateurs Experience Manager et affectez l’autorisation jcr:all à /content/dam. Un utilisateur système workfront-tools est créée automatiquement et les autorisations requises sont gérées automatiquement. Tous les utilisateurs de Workfront qui utilisent le connecteur amélioré sont automatiquement ajoutés dans le cadre de ce groupe.

Pour plus d’informations sur la mise à jour du Workfront for Experience Manager enhanced connector d’une version précédente à la dernière version, cliquez ici.

Configurer la connexion entre Experience Manager as a Cloud Service et Workfront

Pour créer une connexion avec Workfront, procédez comme suit :

1. Dans Experience Manager, sélectionnez Outils > Cloud Services > Configuration des outils Workfront.

2. Sélectionnez workfront-tools dans le panneau de gauche et sélectionnez l’option Créer dans la zone supérieure droite de la page.

3. Dans la boîte de dialogue Connexion Workfront, fournissez les détails requis de votre déploiement Workfront, et sélectionnez l’option Connexion à Workfront. Une fois la connexion établie, l’intégration personnalisée du document Workfront est créée automatiquement dans l’environnement Workfront.

   

4. Accédez à l’onglet Avancé et sélectionnez l’option Le serveur est-il AEM as a Cloud Service ?