Intégrations
    1. Phrase
    2. Phrase TMS
    3. Intégrations

    Adobe Experience Manager - AEM (TMS)

    Le contenu est traduit de l’anglais par Phrase Language AI.

    Disponible pour

    • Forfait Entreprise

    Contactez le service commercial pour toute question relative aux licences.

    Disponible pour

    • Forfait enterprise (ancien)

    Contactez le service commercial pour toute question relative aux licences.

    Versions prises en charge

    Le plugin de traduction Phrase pour Adobe Experience Manager suit les mêmes périodes de support produit qu'Adobe Experience Manager. Consultez https://helpx.adobe.com/support/programs/eol-matrix.html pour plus d'informations sur les périodes de support.

    Une fois qu'une version d'Adobe Experience Manager atteint la fin du support principal, Phrase ne maintient plus le plugin. L'installateur restera disponible, mais aucune amélioration ou correction supplémentaire ne sera mise en œuvre.

    • La version 2.x du plugin prend en charge la version 6.5.

    • La version 3.x du plugin prend en charge AEM as a Cloud Service.

    Notes de version du plugin

    Configuration de Phrase

    Configurer l'aperçu en contexte

    La fonctionnalité d'aperçu en contexte offre un aperçu en temps réel du texte original ou traduit, aussi bien dans l'éditeur web CAT que dans l'éditeur de bureau CAT.

    Les tableaux, colonnes, divers graphiques, la mise en forme et les polices (si installées par les utilisateurs) sont pris en charge. Cette fonctionnalité est destinée à fournir du contexte lors de la traduction et ne constitue pas une représentation parfaite du document original ou final ; certaines différences visuelles sont à prévoir. Elle peut également être influencée par l'activation ou la désactivation de l'option Autoriser le chargement de contenu externe dans les éditeurs dans les paramètres d'accès et de sécurité.

    Exigences de Phrase :

    • Traverser le pare-feu d'entreprise pour accéder à l'installation sur site.

    • S'authentifier dans l'environnement de création.

    Configuration du pare-feu pour l'installation sur site :

    • L'installation doit être accessible depuis les adresses IP du serveur Phrase. Consultez Phrase Servers IP Addresses pour obtenir la liste actuelle.

    • Le nom de domaine doit pouvoir être résolu de l'extérieur.

    Remarque

    Certaines balises HTML présentent un risque et l'éditeur CAT les supprime de ce HTML lors de l'affichage de l'aperçu. Ceci afin de garantir la confidentialité et la sécurité des données de l'utilisateur.

    Des exemples de balises supprimées incluent FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT ou les propriétés CSS background-image.

    Paramètres Phrase TMS

    Prérequis: Créez un utilisateur Adobe Experience Manager avec les autorisations minimales requises pour afficher les pages non publiées.

    Astuce

    Créez un nouvel utilisateur appelé phrase-preview et ajoutez l'utilisateur au groupe Authors.

    1. À partir de la page des paramètres Setup_gear.png, faites défiler vers le bas jusqu'à la section Intégrations.

    2. Cliquez sur Connecteurs.

      La page Connecteurs s'ouvre.

    3. Cliquez sur Nouveau connecteur.

      La page Créer un connecteur s'ouvre.

    4. Modifiez le Type en Adobe Experience Manager Live Preview et donnez un nom au connecteur.

    5. Activez éventuellement Forcer la connexion sécurisée.

    6. Saisissez le Host.

      Utilisez l'adresse hôte de l'installation Adobe Experience Manager (par ex. https://aem-author.example.org/ ou https://author-X-Y.adobeaemcloud.com/).

      Le nom de domaine doit être résolvable de l'extérieur (pas un domaine intranet).

    7. Saisissez le Live preview username et le Live preview password.

    8. Pour modifier les liens contenus dans le HTML de la page, fournissez une règle de réécriture d’URL en regex.

      Exemple :

      Pour remplacer un code de paramètres régionaux complet par le code de langue uniquement dans https://example.org/en-us/images/sample.jpg, recherchez /([a-z]{2})-[a-z]{2}/ et remplacez-le par /$1/.

      Les liens dans les balises <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" ainsi que les liens dans les styles CSS et les fichiers CSS référencés (url: ('')) seront réécrits.

    9. Cliquez sur Enregistrer.

      Le connecteur est ajouté à la liste de la page Connecteurs.

    Remarque

    Certaines balises HTML présentent un risque et l'éditeur CAT les supprime de ce HTML lors de l'affichage de l'aperçu. Ceci afin de garantir la confidentialité et la sécurité des données de l'utilisateur.

    Des exemples de balises supprimées incluent FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT ou les propriétés CSS background-image.

    Configurer le flux de travail de traduction

    Pour configurer le traitement des tâches Adobe Experience Manager, créez un modèle de projet configuré selon vos besoins :

    • Sous Accès et sécurité, activez l'option Autoriser le chargement de contenu externe dans l'éditeur Phrase CAT.

    Si vous utilisez des versions héritées, un service et un portail de soumission devront être créés et validés. Pour valider la configuration, suivez ces étapes :

    1. Ouvrez un projet de traduction incomplet.

    2. Sélectionnez Exporter dans le menu de la carte Tâche.

    3. Recherchez le fichier .XML contenant le texte source dans le fichier zip téléchargé.

    4. Dans Phrase, accédez aux Portails de soumission utilisés pour l'intégration et ouvrez l'URL indiquée.

    5. Remplissez le formulaire SP, téléchargez le fichier .XML, validez l'e-mail et soumettez.

    6. Vérifiez que le nouveau projet a été créé à partir du modèle de projet tel qu'il a été configuré.

    Configuration AEM

    Installer le plugin

    Téléchargez le dernier package de plugin depuis la page Écosystème Phrase dans Phrase en utilisant le bouton Télécharger. Le plugin est uniquement disponible pour les organisations qui l'ont acheté.

    AEM sur site

    1. En cas de migration de la version 6.2 ou 6.3 vers la version 6.4 ou supérieure, supprimez toutes les configurations de services cloud hérités de l'outil d'administration de l'interface classique (/miscadmin#/etc/cloudservices/memsource-translation).

      Toutes les configurations disparaissent de Services cloud hérités > Plugin de traduction Memsource pour AEM.

    2. Dans Outils, Déploiement, accédez à Packages.

    3. Désinstallez la version précédente du plugin, le cas échéant.

    4. Sélectionnez Téléverser le package et téléversez le fichier d'installation.

    5. Cochez Forcer le téléversement et validez.

    AEM en tant que service cloud

    Si le plugin est déjà installé, passez à l'étape 4.

    1. Ajoutez un dépôt Maven basé sur le système de fichiers local à la racine du projet AEM cloud service pom.xml :

      repositories {

  Référentiel %
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  Référentiel %

repositories {

    2. Ajoutez la dépendance du plugin à all/pom.xml :

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>X.X.X</version>
  <type>zip</type>
</dependency>

    3. Ajoutez le bloc intégré à la configuration de all/pom.xml -> filevault-package-maven-plugin :

      plug-in
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Configuration
  <group>my_packages</group>
  <embeddeds>
   <embedded>
     <groupId>com.memsource</groupId>
     <artifactId>aem-memsource-plugin.all</artifactId>
     <type>zip</type>
     <target>/apps/aem-memsource-plugin-packages/application/install</target>
   </embedded>

    4. Ajoutez le plugin au dépôt maven local. Exécutez la commande suivante depuis la racine du projet de service cloud AEM en remplaçant l'espace réservé {memsource.plugin.path} par le chemin d'accès au plugin (par exemple /tmp/aem-memsource-plugin.all-3.0.1.zip) :

      mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip

    5. Définissez la version correcte du plugin dans all/pom.xml (par exemple 3.0.1) :

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>3.0.1</version>
  <type>zip</type>
</dependency>

    Configurer le plugin

    Deux configurations sont requises :

    • Indiquez au système que Phrase existe en l'ajoutant en tant que fournisseur de services de traduction et en précisant comment se connecter au TMS.

    • Indiquez à Adobe Experience Manager quand et comment Phrase doit être utilisé en configurant l'intégration de la traduction.

      Exemple :

      Utilisez Phrase pour le contenu à haute visibilité, mais un fournisseur de traduction automatique pour le contenu communautaire.

    Ajouter Phrase en tant que fournisseur de services de traduction

    Suivez ces étapes :

    1. Dans Outils, Général, accédez au Navigateur de configuration.

    2. Créez un conteneur de configuration pour chaque service Phrase (par exemple, une configuration pour la traduction humaine et une configuration distincte pour la traduction automatique uniquement).

    3. Dans Services cloud, accédez à Services cloud de traduction.

    4. Développez le répertoire conf.

    5. Créez une nouvelle configuration et saisissez les informations suivantes :

      • Nom d'hôte : L'URL par défaut est https://cloud.memsource.com/web/ mais peut être différente si vous ou le LSP utilisez une URL personnalisée.

      • Nom d'utilisateur et Mot de passe (doit avoir un rôle PM avec l'option Modifier les paramètres globaux du serveur activée dans les droits utilisateur).

      Cliquez sur Connecter.

    6. Sélectionnez d'autres options et fermez la configuration.

      • Grouper tous les travaux de traduction dans un seul projet Phrase 

        Tous les travaux de traduction au sein d'un projet AEM seront également créés au sein d'un seul projet Phrase.

        Important

        Cette option ne fonctionne pas correctement si Définir le travail comme terminé une fois pré-traduit et Définir le projet comme terminé une fois tous les travaux terminés sont activés en même temps dans les paramètres du modèle de projet Phrase.

      • Définir le statut du travail Phrase sur Livré après l'importation dans AEM 

      • Générer des analyses 

        Si cette option est active, une fois qu'un travail de traduction est envoyé, les analyses sont automatiquement générées lorsque les fichiers sont importés. Les analyses sont toujours générées par langue, indépendamment des paramètres du modèle de projet. 

      • Générer des devis 

        Si la génération automatique des analyses est activée, des devis peuvent être générés sur la base de ces analyses.

    Si vous utilisez des versions héritées, les informations de service et de portail de soumission seront également requises.

    Configurer l'intégration de la traduction

    Lors de l'utilisation du plugin de traduction Phrase pour AEM, tous les fichiers des travaux de traduction sont soumis pour traduction et donc renvoyés depuis Phrase. Utilisez la configuration Intégration de la traduction du projet pour empêcher l'inclusion d'actifs non traduisibles ou de documents de référence dans les projets.

    1. Dans Outils, accédez à Services Cloud, cliquez sur Services Cloud de traduction.

    2. Créez une nouvelle configuration spécifiquement pour la traduction.

      Remarque

      Créez la configuration sous conf. Les entrées sous /libs sont des valeurs par défaut Adobe en lecture seule.

      • Assurez-vous que Traduire les chaînes de composants et Traduire les balises ne sont pas cochés.

      • Réglez Traduire les ressources de la page sur Ne pas traduire.

      • Dans l'onglet Assets, réglez le Flux de travail de traduction sur Ne pas traduire.

    3. Si un projet contient toujours des ressources non traduisibles ou des documents de référence, marquez-les et supprimez-les directement dans Phrase.

    Appliquer l'intégration de la traduction aux sites

    Configurez le fournisseur de traduction Phrase par défaut avec différentes parties de la taxonomie du site. Configurez le fournisseur au niveau du nœud racine du site. Toutes les pages descendantes hériteront du paramètre. Remplacez le paramètre au niveau du nœud qui doit utiliser une configuration de fournisseur différente (par exemple, l'ensemble du site utilise la traduction humaine mais la section communauté utilise la traduction automatique).

    Pour appliquer l'intégration de la traduction :

    • Dans l'onglet Avancé, sélectionnez la configuration nouvellement créée comme configuration Cloud.

    Lors de l'ajout de contenu à partir de ces pages, seul le contenu traduisible sera ajouté. Si un projet est créé à partir du Panneau de références, il sera automatiquement configuré pour utiliser la configuration cloud associée à la page racine.

    Soumettre du contenu pour traduction

    Pour soumettre du contenu (sites, ressources) à la traduction, créez un projet de traduction dans Adobe Experience Manager. Les projets peuvent être créés manuellement dans la section Projets ou utiliser des flux de travail intégrés pour minimiser les efforts.

    Pour préparer un projet en vue d'une soumission via les flux de travail intégrés, suivez ces étapes :

    1. Depuis la vue Sites, accédez à la page, sélectionnez-la et ouvrez le Panneau de références.

    2. Cliquez sur Copies de langue et développez la section Créer et traduire en bas du rail.

    3. Sélectionnez les langues cibles, décochez éventuellement Sélectionner toutes les sous-pages.

    4. Sélectionnez Créer un projet de traduction multilingue.

      S'il y a plusieurs langues cibles, un projet distinct sera créé pour chaque langue.

    5. Saisissez le titre du projet et cliquez sur Créer.

    6. Accédez au projet dans la section Projets et ouvrez-le.

    7. Cliquez sur les points de suspension sur la première vignette pour ouvrir les paramètres avancés du projet.

      S'ils sont correctement configurés, les configurations créées dans les étapes ci-dessus sont référencées.

    8. Pour soumettre un travail, sélectionnez Démarrer dans le menu de la vignette du travail.

      Un nouveau projet sera créé en quelques minutes.

      • Lors de l'importation, les fournisseurs sont attribués à partir du modèle de projet et le statut de l'élément de travail AEM est défini sur Engagé pour la traduction.

      • Une fois le travail accepté par un fournisseur, le statut de l'élément de travail AEM passe à Traduction en cours.

      • Le statut de l'élément de travail AEM passe à Annulé si le travail est supprimé ou annulé.

      Astuce

      Adobe Experience Manager interroge le statut du travail selon un calendrier configuré dans Configuration de la plateforme de traduction accessible via Console Web.

      Le réglage de la propriété Scheduler Cron pour une exécution fréquente (par ex. 0 0/5 * * * ? * déclenche une actualisation du statut du travail de traduction toutes les 5 minutes).

      L'actualisation de la page de détails du projet provoque une récupération.

    9. Dans Phrase, traduisez les travaux du projet et définissez leur statut sur Terminé. Une fois terminés, les travaux sont réimportés dans AEM.

    10. En cas de rejet, la première étape du flux de travail du travail est définie sur Envoyé par e-mail, et les étapes restantes du flux de travail sur Nouveau.

    11. Une fois qu'un élément de travail AEM est accepté, le statut du travail est mis à jour sur Livré comme configuré dans les paramètres du plugin.

    Pour plus de détails sur la création de projets de traduction à l'aide du panneau Références, consultez la documentation Adobe.

    Divers

    Mappage de langue personnalisé

    AEM sur site

    Pour associer les langues d'Adobe Experience Manager à d'autres langues dans Phrase (par exemple, zh à zh_tw), suivez ces étapes.

    Cette correspondance s'applique aux langues source et cible.

    1. Ouvrez CRXDE (/crx/de/index.jsp).

    2. Accédez au dossier /apps/memsource-connector/language-mapping/.

    3. Créez un nouveau nœud.

    4. Utilisez le code de langue Adobe Experience Manager comme Nom (par ex. zh), et conservez Type: nt:unstructured.

    5. Ajoutez une propriété :

      • Nom : memsourceLanguage

      • Type chaîne

      • Valeur: code de langue (par ex. zh_tw)

    6. Cliquez sur Enregistrer tout.

    Les codes de langue non mappés sont envoyés tels quels.

    AEM en tant que service cloud

    Pour ajouter une correspondance de langue dans AEM Cloud Services, suivez ces étapes :

    1. Créez un fichier .content.xml dans le dossier /conf/aem-memsource-plugin/language-mapping/.

    2. Ouvrez le fichier créé et copiez-y ce qui suit :

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Folder"/>

    3. Créez un fichier .content.xml dans le dossier /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Ouvrez le fichier créé et copiez-y ce qui suit :

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0"
          jcr:primaryType="nt:unstructured"
          memsourceLanguage="zh_cn">
</jcr:root>

    5. Ajoutez les chemins créés lors des étapes précédentes au fichier filter.xml situé dans ui.content/src/main/content/META-INF/vault/filter.xml :

      <?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">

    <filter root="/conf/aem-memsource-plugin" mode="update"/>
    <filter root="/conf/aem-memsource-plugin/language-mapping" mode="update"/>
</workspaceFilter>

    Identifiants du projet

    Une fois qu'un travail de traduction est soumis, l'identifiant du projet et l'UID sont stockés dans /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob en tant que propriétés PROPERTY_MEMSOURCE_PROJECT_ID et PROPERTY_MEMSOURCE_PROJECT_UID.

    Utilisez les identifiants pour l'affichage dans l'environnement AEM ou dans les API afin d'étendre les fonctionnalités du plugin.

    Dépannage d'AEM

    Problème

    Cause(s)

    Solution

    Cloud Manager signale une alerte « Query Without Index » pour une requête sur translationObjectID sous /content/projects

    Le connecteur Phrase AEM localise les nœuds de travail de traduction par un translationObjectID attribué au moment de l'exécution. Cet identifiant n'existe pas en tant que propriété de référentiel préexistante, donc AEM as a Cloud Service ne peut pas l'indexer à l'avance et revient à un parcours complet, ce que Cloud Manager signale.

    Ajoutez une définition d'index Oak/Lucene personnalisée de type oak:QueryIndexDefinition, limitée à /content/projects, avec un index de propriété sur translationObjectID . Déployez la définition d'index via le pipeline de code plutôt que de la créer au moment de l'exécution, et validez-la dans un environnement hors production avant de la déployer en production. Limitez l'index à la structure de dossiers du projet dans l'instance AEM, en restreignant si possible à des dossiers de projet spécifiques au lieu d'indexer l'intégralité de /content/projects, car un index trop largement limité peut créer son propre impact sur les performances. Après le déploiement, AEM définit la propriété reindex de la définition d'index sur false une fois la réindexation terminée, ce qui confirme que la réindexation s'est terminée sans erreur et ne nécessite aucune action supplémentaire.

    La build Maven échoue avec des erreurs de validation filevault-package-maven-plugin telles que « Package of type ‘APPLICATION’ is not supposed to contain any sub packages » ou « Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations ».

    Dans les versions 3.1.18.6 et antérieures du plugin, les bundles OSGi et les fichiers de configuration sont empaquetés dans un package de type application, ce que la validation d'AEM as a Cloud Service rejette.

    Mettez à jour vers la version 3.1.18.7 ou ultérieure du plugin. Supprimez skipSubPackageValidation de la configuration Maven s'il a été ajouté en guise de solution de contournement.

    Phrase est absent de la liste sous /libs dans Translation Cloud Services.

    Les entrées sous /libs sont des valeurs par défaut Adobe en lecture seule. Le plugin stocke sa configuration sous /conf, /apps/aem-memsource-plugin et /var/memsource-tms.

    Créez la configuration de l'intégration de traduction sous conf. La connexion au serveur est stockée séparément sous /conf/global/settings/cloudconfigs/translation/memsource-translation.
    Cet article vous a-t-il été utile ?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.