Installation de la version Workfront for Experience Manager enhanced connector assets-integration-overview

Version
Lien de l’article
AEM 6.5
Cliquez ici
AEM as a Cloud Service
Cet article

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.

IMPORTANT
Depuis juin 2022, Adobe a lancé une nouvelle intégration native pour connecter Workfront à Adobe Experience Manager Assets as a Cloud Service. Cette intégration est devenue la méthode requise pour connecter ces deux solutions. Toute nouvelle implémentation future du connecteur amélioré (version 1.9.8 et versions ultérieures) pour connecter Workfront à AEM Assets as a Cloud Service est bloquée. Pour plus d’informations sur la configuration de cette intégration, voir Configurer l’intégration Experience Manager Assets as a Cloud Service.
IMPORTANT
  • Adobe nécessite le déploiement et la configuration de Adobe Workfront for Experience Manager enhanced connector uniquement par le biais de partenaires certifiés ou Adobe Professional Services. S’il est déployé et configuré sans partenaire certifié ou sans Adobe Professional Services, il n’est pas pris en charge par Adobe.

  • Adobe peut publier des mises à jour d’Adobe Workfront et d’Adobe Experience Manager qui rendent ce connecteur redondant ; si cela se produit, les clients peuvent être amenés à cesser d’utiliser ce connecteur.

  • Adobe prend en charge les versions 1.7.4 et supérieures du connecteur. Les versions précédentes et personnalisées ne sont pas prises en charge. Pour vérifier la version du connecteur amélioré, consultez l’étape 5(a) des instructions d’installation du connecteur amélioré.

  • Consultez la section Examen de certification des partenaires pour Workfront pour le connecteur amélioré Experience Manager Assets. Pour plus d’informations sur l’examen, consultez le Guide d’examen.

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.

    note important
    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 :

      code language-none
      
      
      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 :

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 :

    code language-txt
       /ui.apps/src/main/resources/<zip file>
    
    note note
    NOTE
    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.

      code language-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>
      
      note note
      NOTE
      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.

      code language-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.

    code language-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 configure-connection

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.

    Connexion Experience Manager et Workfront

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab