Intégrations

Adobe Experience Manager - AEM (TMS)

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

Disponible pour

  • Forfait Enterprise

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 plug-in de traduction Phrase pour Adobe Experience Manager suit les mêmes périodes de support produit qu'Adobe Experience Manager. Voir 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 plug-in. Le programme d'installation restera disponible, mais aucune amélioration ou correction supplémentaire ne sera mise en œuvre.

  • La version X.x du plug-in prend en charge la version 6.5.

  • La version X.x du plug-in prend en charge AEM as a Cloud service.

Notes de version du plug-in

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 dans le CAT Web Editor et le CAT Desktop Editor.

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/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 Enterprise 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. Reportez-vous à Phrase Servers IP Addresses pour 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 le CAT Editor 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.

Les 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

Pre-requisite : Créer un utilisateur Adobe Experience Manager avec les autorisations minimales requises pour afficher les pages non publiées.

Astuce

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

  1. À partir de la page Setup_gear.png des paramètres, 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. Modifier le Type en Adobe Experience Manager Live Preview et fournir un nom pour le connecteur.

  5. 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).

  6. Saisissez le nom d'utilisateur et le mot de passe.

  7. Pour modifier les liens contenus dans le HTML de la page, fournissez une URL rewrite rule en regex.

    Exemple :

    Pour remplacer un paramètre linguistique complet par uniquement le code de langue 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=\"\" et les liens dans les styles CSS et les fichiers CSS référencés (url: ('')) seront réécrits.

  8. Cliquez sur Enregistrer.

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

Remarque

Certaines balises HTML présentent un risque et le CAT Editor 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.

Les 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 travaux de traduction

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

  • Sous Access and Security, activez l'option Allow loading of external content in Phrase CAT editor.

Si vous utilisez des versions ancien, un service et un submitter portal 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 tuile 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 d'envoyeur utilisés pour l'intégration et ouvrez l'URL indiquée.

  5. Remplissez le formulaire SP, chargez le fichier .XML, vérifiez l'e-mail et envoyez.

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

Configuration AEM

Installer le plug-in

AEM sur site

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

    Toutes les configurations disparaissent de l'ancien service cloud > plug-in de traduction Memsource pour AEM.

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

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

  4. Sélectionnez Charger le package et chargez le fichier d'installation.

  5. Cochez Forcer le chargement et envoyez.

AEM en tant que service cloud

Si le plug-in est déjà installé, passez à l'étape 4.

  1. Ajoutez le référentiel maven basé sur le système de fichiers local à la racine du projet de service cloud AEM pom.xml :

    <repositories>
    ...
      <référentiel>
        <id>project.local</id>
        <name>nom du projet</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      </référentiel>
    ...
    </repositories>
  2. Ajouter la dépendance du plug-in à all/pom.xml :

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>X.X.X</version>
      <type>zip</type>
    </dependency>
  3. Ajouter le bloc embedded à la configuration de all/pom.xml -> filevault-package-maven-plugin :

    ...
    <plugin>
      <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. Ajouter le plug-in au référentiel 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 plug-in (par ex. /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 plug-in dans all/pom.xml (par ex. 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 plug-in

Deux configurations sont requises :

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

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

    Exemple :

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

Ajouter Phrase en tant que fournisseur de service de traduction

Suivez ces étapes :

  1. Dans Outils, Général, accédez à 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 prestataire utilisez une URL personnalisée.

    • Nom d'utilisateur et Mot de passe (doit avoir un rôle de 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.

    • Regrouper toutes les tâches de traduction dans un seul projet Phrase 

      Toutes les tâches de traduction au sein d'un projet AEM seront également créées au sein d'un seul projet Phrase.

      Important

      Cette option ne fonctionne pas correctement si Définir la tâche comme terminée une fois pré-traduite et Définir le projet comme terminé une fois toutes les tâches terminées sont activés en même temps dans les paramètres du modèle de projet Phrase.

    • Définir le statut de la tâche Phrase sur Livré après importation dans AEM 

    • Générer des analyses 

      S'il est actif, une fois qu'une tâche de traduction est envoyée, des 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 d'analyses est activée, des devis peuvent être générés sur la base de ces analyses.

En cas d'utilisation d'anciennes versions, les informations de service et de submitter portal seront également requises.

Configurer l'intégration de traduction

Lors de l'utilisation du plug-in de traduction Phrase pour AEM, tous les fichiers des travaux de traduction sont soumis pour traduction et donc renvoyés par Phrase. Utiliser la configuration de l'intégration de traduction du projet pour empêcher l'inclusion de ressources à ne pas traduire ou de documents de référence dans les projets.

  1. Dans Outils, aller dans Cloud Services, cliquer sur Translation Cloud Services.

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

    • Assurez-vous que Translate Component Strings et Translate Tags ne sont pas cochés.

    • Réglez Translate page assets sur Do not translate.

    • Dans l'onglet Assets, réglez le flux de travaux de traduction sur Do not translate.

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

Appliquer l'intégration de traduction aux sites

Configurer le fournisseur de traduction Phrase par défaut avec différentes parties de la taxonomie du site. Configurer le fournisseur au niveau du nœud racine du site. Toutes les pages descendantes hériteront du paramètre. Remplacer 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 traduction :

  • Dans l'onglet Advanced, sélectionner la configuration nouvellement créée comme Cloud Configuration.

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

Envoyer le contenu pour traduction

Pour envoyer du contenu (Sites, Ressources) pour traduction, créer 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 l'effort.

Pour préparer un projet pour l'envoi 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 Références.

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

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

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

    S'il existe 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 configurés correctement, les paramètres créés dans les étapes ci-dessus sont référencés.

  8. Pour envoyer une tâche, sélectionner Démarrer dans le menu de la vignette de tâche.

    Un nouveau projet sera créé en quelques minutes.

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

    • Une fois la tâche acceptée par un fournisseur, le statut de l'élément de tâche AEM passe à Traduction en cours.

    • Le statut de l'élément de tâche AEM passe à Annulé si la tâche est supprimée ou annulée.

    Astuce

    Adobe Experience Manager interroge le statut d'une tâche selon un calendrier configuré dans Translation Platform Configuration accessible via Web Console.

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

    L'actualisation de la page de détails du projet force une extraction.

  9. Dans Phrase, traduisez les tâches du projet et définissez leur statut sur Completed. Une fois terminées, les tâches sont réimportées dans AEM.

  10. En cas de rejet, la première étape du flux de travail de la tâche est définie sur Emailed, et les étapes restantes du flux de travaux sur New.

  11. Une fois qu'un élément de tâche AEM est accepté, le statut de la tâche se met à jour sur Delivered tel que configuré dans les paramètres du plug-in.

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 mapper les langues d'Adobe Experience Manager vers différentes langues dans Phrase (par ex. zh vers zh_tw), suivez ces étapes.

Le mappage s'applique aux langues source et cible.

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

  2. Parcourez le dossier /apps/memsource-connector/language-mapping/.

  3. Créer un nouveau nœud.

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

  5. Ajouter une propriété :

    • Name : memsourceLanguage

    • Type : String

    • Value : 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 un mappage 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 aux é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'une tâche de traduction est soumise, l'identifiant du projet et l'UID sont stockés dans le /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 plug-in.

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.