Integrationen
    1. Phrase
    2. Phrase TMS
    3. Integrationen

    Adobe Experience Manager - AEM (TMS)

    Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

    Verfügbar für

    • Enterprise-Plan

    Kontaktiere Vertrieb für Fragen zur Lizenzierung.

    Verfügbar für

    • Enterprise-Plan (Legacy)

    Kontaktiere Vertrieb für Fragen zur Lizenzierung.

    Unterstützte Versionen

    Das Phrase-Übersetzungs-Plug-in für Adobe Experience Manager folgt denselben Produktsupportzeiträumen wie Adobe Experience Manager. Siehe https://helpx.adobe.com/support/programs/eol-matrix.html für Informationen zu Supportzeiträumen.

    Sobald eine Adobe Experience Manager-Version das Ende des Kernsupports erreicht, wartet Phrase das Plug-in nicht mehr. Das Installationsprogramm bleibt verfügbar, aber es werden keine weiteren Verbesserungen oder Korrekturen mehr implementiert.

    • Plug-in-Version 2.X unterstützt 6.5.

    • Plug-in-Version 3.X unterstützt AEM as a Cloud Service.

    Plug-in-Versionshinweise

    Phrase-Konfiguration

    In-Context-Vorschau konfigurieren

    Die In-Context-Vorschau bietet eine Echtzeit-Vorschau von ursprünglichem oder übersetztem Text sowohl im CAT Web Editor als auch im CAT Desktop Editor.

    Tabellen, Spalten, verschiedene Grafiken, Formatierungen und Schriftarten (sofern von Benutzern installiert) werden unterstützt. Die Funktion soll beim Übersetzen Kontext bieten und ist keine perfekte Darstellung des ursprünglichen oder fertigen Dokuments; einige visuelle Unterschiede sind zu erwarten. Sie kann auch durch das Aktivieren/Deaktivieren der Option Laden von externem Content in Editoren erlauben in den Zugreifen- und Sicherheitseinstellungen beeinflusst werden.

    Phrase-Anforderungen:

    • Die Enterprise-Firewall passieren, um auf die On-Premise-Installation zugreifen zu können.

    • Sich in der Authoring-Umgebung authentifizieren.

    Firewall-Konfiguration für On-Premise-Installation:

    • Die Installation muss von den IP-Adressen des Phrase-Servers aus zugänglich sein. Die aktuelle Liste finden Sie unter Phrase Servers IP Addresses.

    • Der Fachbereichsname muss extern auflösbar sein.

    Hinweis

    Einige HTML-Tags stellen ein Risiko dar und der CAT Editor entfernt sie aus diesem HTML bei der Anzeige der Vorschau. Dies dient dem Schutz der Datenprivatsphäre und der Sicherheit des Users.

    Beispiele für entfernte Tags sind FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT oder background-image CSS-Eigenschaften.

    Phrase TMS-Einstellungen

    Pre-requisite: Erstellen Sie einen Adobe Experience Manager-User mit den für die Anzeige unveröffentlichter Seiten erforderlichen Mindestberechtigungen.

    Tipp

    Erstellen Sie einen neuen User namens phrase-preview und fügen Sie den User der Gruppe Von: hinzu.

    1. Scrolle auf der Seite EinstellungenSetup_gear.png nach unten zum Abschnitt Integrationen.

    2. Klicke auf Konnektoren.

      Die Seite Konnektoren wird geöffnet.

    3. Klicken Sie auf New connector.

      Die Seite Create connector wird geöffnet.

    4. Ändern Sie den Type auf Adobe Experience Manager Live Preview und geben Sie einen Namen für den Konnektor an.

    5. Geben Sie den Host ein.

      Verwenden Sie die Host-Adresse der Adobe Experience Manager-Installation (z. B. https://aem-author.example.org/ oder https://author-X-Y.adobeaemcloud.com/).

      Der Fachbereichsname muss extern auflösbar sein (kein Intranet-Fachbereich).

    6. Geben Sie den Usernamen und das Passwort ein.

      Single Sign-On (SSO) und Zwei-Faktor-Authentifizierung (2FA) werden nicht unterstützt. Wenn SSO oder 2FA für das Drupal-User-Konto erzwungen wird, verwenden Sie ein dediziertes User-Konto für Dienstleistungen, das von beidem ausgenommen ist.

    7. Um Links im Seiten-HTML zu ändern, geben Sie die URL rewrite rule als regex an.

      Beispiel:

      Um einen vollständigen Sprachcode durch nur den Sprachcode in https://example.org/en-us/images/sample.jpg zu ersetzen, suchen Sie nach /([a-z]{2})-[a-z]{2}/ und ersetzen Sie ihn durch /$1/.

      Links in den Tags <img src=\"\" data-lazy-src=\"\", <link href=\"\", <script src=\"\", <iframe src=\"\" sowie Links in CSS-Stilen und referenzierten CSS-Dateien (url: ('')) werden umgeschrieben.

    8. Klicke auf Speichern.

      Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.

    Konnektor löschen

    So löschen Sie einen Konnektor:

    1. Wählen Sie auf der Seite Integrationen den zu löschenden Konnektor aus.

    2. Klicken Sie auf löschen.

      Das Fenster Konnektor löschen öffnet sich.

    3. Geben Sie „löschen“ ein und klicken Sie auf löschen.

      Der Konnektor wird gelöscht und die Liste der Konnektoren wird angezeigt.

    Hinweis

    Ein Konnektor kann nicht gelöscht werden, solange er noch mit unvollständigen Jobs in einem Projekt verknüpft ist, einschließlich Jobs, die sich im Papierkorb befinden. Der Versuch, einen solchen Konnektor zu löschen, führt zu der Fehlermeldung „Konnektor konnte nicht gelöscht werden“.

    Lösung: Öffnen Sie das mit dem Konnektor verknüpfte Projekt und schließen Sie alle verbleibenden Jobs ab oder löschen Sie diese. Gehen Sie zu Einstellungen/Papierkorb und leeren Sie ihn, um alle Jobs zu entfernen, die noch mit dem Konnektor verknüpft sind. Versuchen Sie erneut, den Konnektor zu löschen.

    Hinweis

    Einige HTML-Tags stellen ein Risiko dar und der CAT Editor entfernt sie aus diesem HTML bei der Anzeige der Vorschau. Dies dient dem Schutz der Datenprivatsphäre und der Sicherheit des Users.

    Beispiele für entfernte Tags sind FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT oder background-image CSS-Eigenschaften.

    Übersetzungs-Workflow konfigurieren

    Um die Adobe Experience Manager-Jobverarbeitung zu konfigurieren, erstellen Sie eine Projektvorlage, die an Ihre Bedürfnisse angepasst ist:

    • Aktivieren Sie unter Zugriff und Sicherheit die Option Laden von externem Content im Phrase CAT Editor erlauben.

    Bei Verwendung von Vermächtnis-Versionen müssen eine Dienstleistung und ein Submitter Portal erstellt und validiert werden. Um die Konfiguration zu validieren, führen Sie diese Schritte aus:

    1. Öffnen Sie ein unvollständiges Übersetzungsprojekt.

    2. Wählen Sie Exportieren aus dem Menü der Job-Kachel.

    3. Suchen Sie die .XML-Datei, die den Ausgangstext enthält, in der heruntergeladenen Zip-Datei.

    4. Navigieren Sie in Phrase zu den für die Integration verwendeten Submitter Portalen und öffnen Sie die aufgelistete URL.

    5. Schließen Sie das SP-Formular ab, laden Sie die .XML-Datei hoch, überprüfen Sie die E-Mail und senden Sie es ab.

    6. Überprüfen Sie, ob das neue Projekt wie konfiguriert aus der Projektvorlage erstellt wurde.

    AEM Konfiguration

    Installieren Sie das Plug-in

    On-Premise AEM

    1. Wenn Sie von 6.2 oder 6.3 auf 6.4 oder höher migrieren, entfernen Sie alle Vermächtnis-Cloud-Dienstleistungskonfigurationen aus dem Admin-Tool der klassischen Benutzeroberfläche (/miscadmin#/etc/cloudservices/memsource-translation)

      Alle Konfigurationen verschwinden aus Vermächtnis-Cloud-Dienstleistungen > Memsource Translation Plug-in für AEM.

    2. Gehen Sie in Tools, Bereitstellung zu Pakete.

    3. Deinstallieren Sie gegebenenfalls die vorherige Version des Plug-ins.

    4. Wählen Sie Paket hochladen aus und laden Sie die Installationsdatei hoch.

    5. Aktivieren Sie Upload erzwingen und senden Sie es ab.

    AEM as a Cloud Service

    Wenn das Plug-in bereits installiert ist, springen Sie zu Schritt 4.

    1. Fügen Sie das auf dem lokalen Dateisystem basierende Maven-Repository zum Stammverzeichnis des AEM-Dienstleistungsprojekts hinzu pom.xml:

      <repositories>
...
  <repository>
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  </repository>
...
</repositories>

    2. Plug-in-Abhängigkeit zu all/pom.xml hinzufügen:

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

    3. Eingebetteten Block zur all/pom.xml -> filevault-package-maven-plugin-Konfiguration hinzufügen:

      ...
<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. Das Plug-in zum lokalen Maven-Repository hinzufügen. Führen Sie den folgenden Befehl vom Stammverzeichnis des AEM-Cloud-Dienstleistung-Projekts aus und ersetzen Sie den {memsource.plugin.path}-Platzhalter durch den Pfad zum Plug-in (z. B. /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. Die korrekte Plug-in-Version in all/pom.xml festlegen (z. B. 3.0.1):

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

    Das Plug-in konfigurieren

    Es sind zwei Konfigurationen erforderlich:

    • Teilen Sie dem System mit, dass Phrase existiert, indem Sie es als Übersetzungsdienstleister hinzufügen und angeben, wie eine Verbindung zum TMS hergestellt werden soll.

    • Teilen Sie Adobe Experience Manager mit, wann und wie Phrase verwendet werden soll, indem Sie die Übersetzungs-Integration-Konfiguration konfigurieren.

      Beispiel:

      Verwenden Sie Phrase für Content mit hoher Sichtbarkeit, aber einen Auftragnehmer für maschinelle Übersetzung für Community-Content.

    Fügen Sie Phrase als Dienstleister für Übersetzungen hinzu

    Folge diesen Schritten:

    1. Gehen Sie in Tools, General zu Configuration Browser.

    2. Erstellen Sie einen Konfigurationscontainer für jede Phrase-Dienstleistung (z. B. eine Konfiguration für menschliche Übersetzung und eine separate Konfiguration für reine maschinelle Übersetzung).

    3. Gehen Sie in Cloud Services zu Translation Cloud Services.

    4. Erweitern Sie das Verzeichnis conf.

    5. Erstellen Sie eine neue Konfiguration und geben Sie die folgenden Informationen ein:

      • Hostname: Die Standard-URL ist https://cloud.memsource.com/web/, kann aber abweichen, wenn Sie oder der LSP eine benutzerdefinierte URL verwenden.

      • Username und Password (muss eine PM-Rolle mit aktivierter Option Modify global server settings in den User-Rechten sein).

      Klicken Sie auf Connect.

    6. Wählen Sie weitere Optionen aus und schließen Sie die Einstellungen.

      • Gruppieren Sie alle Übersetzungs-Jobs in einem einzigen Phrase-Projekt 

        Alle Übersetzungs-Jobs innerhalb eines AEM-Projekts werden auch innerhalb eines Phrase-Projekts erstellt.

        Wichtig

        Diese Option funktioniert nicht korrekt, wenn Set job to completed once pre-translated und Set project to completed once all jobs are completed gleichzeitig in den Einstellungen der Phrase-Projektvorlage aktiviert sind.

      • Setzen Sie den Phrase-Job-Status nach dem Import in AEM auf Delivered 

      • Analysen generieren 

        Wenn aktiv, werden nach dem Senden eines Übersetzungs-Jobs automatisch Analysen generiert, sobald die Dateien importiert werden. Analysen werden immer nach Sprache generiert, unabhängig von den Einstellungen der Projektvorlage. 

      • Angebote generieren 

        Wenn die automatische Generierung von Analysen aktiviert ist, können Angebote auf Basis dieser Analysen generiert werden.

    Bei Verwendung von Vermächtnis-Versionen sind auch Informationen zu Dienstleistung und Submitter Portal erforderlich.

    Translation Integration festlegen

    Bei Verwendung des Phrase-Plug-ins für AEM werden alle Dateien in den Übersetzungsaufträgen zur Übersetzung abgesendet und somit von Phrase zurückgegeben. Verwenden Sie die Konfiguration der Projekt-Translation Integration, um zu verhindern, dass nicht übersetzbare Elemente oder Referenzmaterialien in die Projekte aufgenommen werden.

    1. Gehen Sie in den Tools zu Cloud Services und klicken Sie auf Translation Cloud Services.

    2. Erstellen Sie eine neue Konfiguration speziell für die Übersetzung.

      • Stellen Sie sicher, dass Translate Component Strings und Translate Tags nicht ausgewählt sind.

      • Legen Sie Translate page assets auf Do not translate fest.

      • Legen Sie auf dem Assets Tab den Workflow auf Do not translate fest.

    3. Wenn ein Projekt weiterhin nicht übersetzbare Elemente oder Referenzmaterialien enthält, markieren und löschen Sie diese direkt in Phrase.

    Translation Integration auf Sites anwenden

    Standard-Phrase-Dienstleister für verschiedene Teile der Site-Taxonomie konfigurieren. Konfigurieren Sie den Dienstleister am Stammknoten der Site. Alle untergeordneten Seiten erben diese Einstellung. Überschreiben Sie die Einstellung an dem Knoten, der eine andere Dienstleister-Konfiguration verwenden soll (z. B. die gesamte Site verwendet menschliche Übersetzung, aber der Community-Bereich verwendet maschinelle Übersetzung).

    So wenden Sie die Translation Integration an:

    • Wählen Sie auf dem Tab „Advanced“ die neu erstellte Konfiguration als Cloud-Konfiguration aus.

    Wenn Sie Content von diesen Seiten hinzufügen, wird nur übersetzbarer Content hinzugefügt. Wenn ein Projekt über das References Panel erstellt wird, wird es automatisch so festgelegt, dass die mit der Stammseite verknüpfte Cloud-Konfiguration verwendet wird.

    Content zur Übersetzung absenden

    Um Content (Sites, Assets) zur Übersetzung abzusenden, erstellen Sie ein Übersetzungsprojekt in Adobe Experience Manager. Projekte können manuell im Bereich Projekte erstellt werden oder nutzen Sie integrierte Workflows, um den Aufwand zu minimieren.

    Um ein Projekt für die Übermittlung über die integrierten Workflows vorzubereiten, befolgen Sie diese Schritte:

    1. Navigieren Sie in der Ansicht Sites zur Seite, wählen Sie diese aus und öffnen Sie das References Panel.

    2. Klicken Sie auf Language Copies und erweitern Sie den Bereich Create & Translate am unteren Rand der Leiste.

    3. Wählen Sie die Zielsprachen aus und deaktivieren Sie optional Select all sub-pages.

    4. Wählen Sie Create Multi-language Translation Project.

      Wenn es mehrere Zielsprachen gibt, wird für jede Sprache ein separates Projekt erstellt.

    5. Geben Sie den Projekttitel ein und klicken Sie auf Create.

    6. Navigieren Sie zum Projekt im Bereich Projekte und öffnen Sie es.

    7. Klicken Sie auf die Auslassungspunkte auf der ersten Kachel, um die erweiterten Projekteinstellungen zu öffnen.

      Bei korrekter Konfiguration wird auf die in den obigen Schritten erstellten Konfigurationen verwiesen.

    8. Um einen Job abzusenden, wählen Sie Start aus dem Menü der Job-Kachel.

      Ein neues Projekt wird innerhalb weniger Minuten erstellt.

      • Nach dem Import werden Dienstleister aus der Projektvorlage zugewiesen und der Status des Job-Elements wird auf Committed for translation gesetzt.

      • Sobald der Job von einem Dienstleister akzeptiert wurde, ändert sich der Status des Job-Elements auf Translation in progress.

      • Der Status des Job-Elements ändert sich auf Cancelled, wenn der Job gelöscht oder storniert wird.

      Tipp

      Adobe Experience Manager fragt den Status eines Jobs gemäß einem Zeitplan ab, der in der Translation Platform Configuration konfiguriert ist, auf die über die Web Console zugegriffen wird.

      Wenn die Eigenschaft Scheduler Cron auf eine häufige Ausführung eingestellt ist (z. B. 0 0/5 * * * ? *, wird der Status des Jobs alle 5 Minuten aktualisiert).

      Das Aktualisieren der Projektdetailseite erzwingt einen Abruf.

    9. Übersetzen Sie in Phrase die Projekt-Jobs und setzen Sie deren Status auf Completed. Nach Abschluss werden die Jobs wieder in AEM importiert.

    10. Bei Ablehnung wird der erste Arbeitsschritt des Jobs auf Emailed gesetzt und die verbleibenden Arbeitsschritte auf New.

    11. Sobald ein AEM-Jobelement akzeptiert wurde, wird der Job-Status auf Delivered aktualisiert, wie in den Plug-in-Einstellungen konfiguriert.

    Weitere Details zum Erstellen von Übersetzungsprojekten über das Referenz-Panel findest du in der Adobe-Dokumentation.

    Verschiedenes

    Benutzerdefinierte Sprachzuordnung

    On-Premise AEM

    Um Adobe Experience Manager-Sprachen verschiedenen Sprachen in Phrase zuzuordnen (z. B. zh zu zh_tw), befolge diese Schritte.

    Die Zuordnung gilt sowohl für die Ausgangssprache als auch für die Zielsprache.

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

    2. Navigiere zum Ordner /apps/memsource-connector/language-mapping/.

    3. Erstelle einen neuen Knoten.

    4. Verwende den Adobe Experience Manager Sprachcode als Name (z. B. zh) und behalte Type: nt:unstructured bei.

    5. Eigenschaft hinzufügen:

      • Name: memsourceLanguage

      • Type: String

      • Value: Sprachcode (z. B. zh_tw)

    6. Klicke auf Alle speichern.

    Nicht zugeordnete Sprachcodes werden unverändert gesendet.

    AEM as a Cloud Service

    Um eine Sprachzuordnung in AEM Cloud Services hinzuzufügen, befolge diese Schritte:

    1. Erstelle eine .content.xml-Datei im Ordner /conf/aem-memsource-plugin/language-mapping/.

    2. Öffnen Sie die erstellte Datei und kopieren Sie Folgendes hinein:

      <?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. Erstellen Sie eine .content.xml-Datei im Ordner /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Öffnen Sie die erstellte Datei und kopieren Sie Folgendes hinein:

      <?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. Fügen Sie die in den vorherigen Schritten erstellten Pfade zur filter.xml-Datei hinzu, die sich unter ui.content/src/main/content/META-INF/vault/filter.xml befindet:

      <?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>

    Projekt-IDs

    Sobald ein Übersetzungs-Job übermittelt wurde, werden die Projekt-ID und UID im /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob als PROPERTY_MEMSOURCE_PROJECT_ID und PROPERTY_MEMSOURCE_PROJECT_UID Eigenschaften gespeichert.

    Verwenden Sie die IDs zur Anzeige in der AEM-Umgebung oder in APIs, um die Plug-in-Funktionalität zu erweitern.

    AEM-Fehlerbehebung

    Problem

    Ursache(n)

    Die Lösung

    Cloud Manager meldet eine „Query Without Index“-Warnung für eine Query auf translationObjectID unter /content/projects

    Der Phrase AEM-Konnektor lokalisiert Übersetzungs-Job-Knoten über eine zur Laufzeit zugewiesene translationObjectID. Dieser Bezeichner existiert nicht als bereits vorhandene Repository-Eigenschaft, daher kann AEM as a Cloud Service ihn nicht im Voraus indizieren und greift auf eine vollständige Durchsuchung zurück, was der Cloud Manager markiert.

    Fügen Sie eine individuelle Oak/Lucene-Indexdefinition vom Typ oak:QueryIndexDefinition hinzu, die auf /content/projects begrenzt ist, mit einem Eigenschaftsindex auf translationObjectID. Stellen Sie die Indexdefinition über die Code-Pipeline bereit, anstatt sie zur Laufzeit zu erstellen, und validieren Sie sie in einer Nicht-Produktionsumgebung, bevor Sie sie in der Produktion bereitstellen. Begrenzen Sie den Index auf die Projektordnerstruktur in der AEM-Instanz und schränken Sie ihn nach Möglichkeit auf bestimmte Projektordner ein, anstatt das gesamte /content/projects zu indizieren, da ein zu breit gefasster Index eigene Auswirkungen auf die Leistung haben kann. Nach der Bereitstellung setzt AEM die reindex-Eigenschaft der Indexdefinition auf false, sobald die Neuindizierung abgeschlossen ist, was bestätigt, dass die Neuindizierung fehlerfrei beendet wurde und keine weiteren Maßnahmen erforderlich sind.
    War dieser Beitrag hilfreich?
    ★ ★ ★ ★ ★

    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.