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 Translation Plugin für Adobe Experience Manager folgt denselben Produktsupportzeiträumen wie Adobe Experience Manager. Unter https://helpx.adobe.com/support/programs/eol-matrix.html sind Informationen zu den Supportzeiträumen verfügbar.

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

    • Plugin-Version 2.x unterstützt 6.5.

    • Plugin-Version 3.x unterstützt AEM als Cloud Service.

    Plugin-Versionshinweise

    Phrase-Konfiguration

    In-Context-Vorschau konfigurieren

    Die In-Context-Vorschaufunktion bietet eine Echtzeit-Vorschau des Original- oder übersetzten Textes sowohl im CAT-Webeditor 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 Original- oder fertigen Dokuments; einige visuelle Unterschiede sind zu erwarten. Sie kann auch durch das Aktivieren/Deaktivieren der Option Laden von externen Inhalten in Editoren erlauben in den Zugriffs- und Sicherheitseinstellungen beeinflusst werden.

    Phrase-Anforderungen:

    • Um auf die On-Premises-Installation zugreifen zu können, muss die Unternehmens-Firewall durchquert werden.

    • Zuerst muss in der Authoring-Umgebung authentifiziert werden.

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

    • Die Installation muss von den IP-Adressen des Phrase-Servers aus zugänglich sein. Die aktuelle Liste ist unter Phrase Servers IP Addresses verfügbar.

    • Der Domänenname muss extern auflösbar sein.

    Hinweis

    Einige HTML-Tags stellen ein Risiko dar und werden vom CAT-Editor beim Anzeigen der Vorschau aus diesem HTML entfernt. Dies dient der Gewährleistung des Datenschutzes und der Sicherheit der Benutzerdaten.

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

    Phrase TMS-Einstellungen

    Voraussetzung: Ein Adobe Experience Manager-Benutzer mit den minimal erforderlichen Berechtigungen zur Anzeige unveröffentlichter Seiten sollte erstellt werden.

    Tipp

    Einen neuen Benutzer mit dem Namen phrase-preview erstellen und der Gruppe Authors hinzufügen.

    1. Auf der Seite Einstellungen Setup_gear.png ist zum Abschnitt Integrationen hinunterscrollen.

    2. Klicke auf Konnektoren.

      Die Seite Konnektoren wird geöffnet.

    3. Den Button New connector auswählen.

      Die Seite Create connector wird geöffnet.

    4. Der Type sollte auf Adobe Experience Manager Live Preview geändert und ein Name für den Connector vergeben werden.

    5. Optional kann Enforce secure connection aktiviert werden.

    6. Geben Sie den Host ein.

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

      Der Domänenname muss extern auflösbar sein (keine Intranet-Domäne).

    7. Den Live preview username und das Live preview password eingeben.

    8. Zum Ändern von Links im Seiten-HTML ist eine URL rewrite rule in regex anzugeben.

      Beispiel:

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

      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.

    9. Klicke auf Speichern.

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

    Hinweis

    Einige HTML-Tags stellen ein Risiko dar und werden vom CAT-Editor beim Anzeigen der Vorschau aus diesem HTML entfernt. Dies dient der Gewährleistung des Datenschutzes und der Sicherheit der Benutzerdaten.

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

    Übersetzungs-Workflow konfigurieren

    Um die Job-Verarbeitung von Adobe Experience Manager zu konfigurieren, ist eine Projektvorlage zu erstellen, die den individuellen Anforderungen entspricht:

    • Unter Access and Security ist die Option Allow loading of external content in Phrase CAT editor zu aktivieren.

    Bei Verwendung älterer Versionen müssen ein Service und ein Submitter Portal erstellt und validiert werden. Zur Validierung der Konfiguration sind die folgenden Schritte durchzuführen:

    1. Ein unvollständiges Übersetzungsprojekt öffnen.

    2. Export aus dem Menü der Job-Kachel auswählen.

    3. Die .XML-Datei, die den Quelltext enthält, in der heruntergeladenen Zip-Datei finden.

    4. In Phrase zu den für die Integration verwendeten Submitter portals navigieren und die aufgeführte URL öffnen.

    5. Das SP-Formular ausfüllen, die .XML-Datei hochladen, die E-Mail validieren und das Formular abschicken.

    6. Es sollte überprüft werden, ob das neue Projekt gemäß der Konfiguration aus der Projektvorlage erstellt wurde.

    AEM-Konfiguration

    Plugin installieren

    Das neueste Plugin-Paket von der Seite Phrase Ecosystem in Phrase mithilfe der Schaltfläche Download herunterladen. Das Plugin ist nur für Organisationen verfügbar, die es erworben haben.

    On-Premise AEM

    1. Bei einer Migration von 6.2 oder 6.3 auf 6.4 und höher sind alle Legacy Cloud Services-Konfigurationen aus dem Classic UI Admin-Tool (/miscadmin#/etc/cloudservices/memsource-translation zu entfernen.

      Alle Konfigurationen verschwinden aus Legacy Cloud Services > Memsource Translation Plugin for AEM.

    2. Unter Tools und Deployment zu Packages navigieren.

    3. Falls zutreffend, ist die vorherige Version des Plugins zu deinstallieren.

    4. Paket hochladen auswählen und die Installationsdatei hochladen.

    5. Force Upload aktivieren und absenden.

    AEM als Cloud Service

    Ist das Plugin bereits installiert, so ist zu Schritt 4 überzugehen.

    1. Dem Stammverzeichnis des AEM Cloud Service-Projekts ist ein lokales, dateisystembasiertes Maven-Repository hinzuzufügen: pom.xml:

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

    2. Dem all/pom.xml ist die Plugin-Abhängigkeit hinzuzufügen:

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

    3. Füge den eingebetteten Block zur Konfiguration von all/pom.xml -> filevault-package-maven-plugin hinzu:

      ...
Plug-in
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Konfiguration
  <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. Füge das Plugin zum lokalen Maven-Repository hinzu. Führe den folgenden Befehl vom Stammverzeichnis des AEM Cloud Service-Projekts aus und ersetze den Platzhalter {memsource.plugin.path} durch den Pfad zum Plugin (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. Lege die korrekte Plugin-Version in all/pom.xml fest (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>

    Konfiguriere das Plugin

    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 Konfiguration der Übersetzungs-Integration vornehmen.

      Beispiel:

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

    Hinzufügen von Phrase als Übersetzungsdienstleister

    Folge diesen Schritten:

    1. Gehe unter Tools, General zum Configuration Browser.

    2. Erstelle einen Konfigurationscontainer für jeden Phrase-Dienst (z. B. eine Konfiguration für die menschliche Übersetzung und eine separate Konfiguration für die reine maschinelle Übersetzung).

    3. Gehe unter Cloud Services zu Translation Cloud Services.

    4. Erweitern Sie das Verzeichnis conf.

    5. Erstelle eine neue Konfiguration und gib die folgenden Informationen ein:

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

      • Benutzername und Passwort (muss eine PM-Rolle mit aktivierter Option Globale Servereinstellungen ändern in den Benutzerrechten haben).

      Klicke auf Connect.

    6. Wähle weitere Optionen aus und schließe die Konfiguration.

      • Alle Übersetzungsaufträge in einem einzigen Phrase-Projekt gruppieren 

        Alle Übersetzungsaufträge innerhalb eines AEM-Projekts werden ebenfalls innerhalb eines Phrase-Projekts erstellt.

        Wichtig

        Diese Option funktioniert nicht korrekt, wenn Auftrag nach Vorübersetzung auf abgeschlossen setzen und Projekt auf abgeschlossen setzen, sobald alle Aufträge abgeschlossen sind gleichzeitig in den Einstellungen der Phrase-Projektvorlage aktiviert sind.

      • Setzen Sie den Phrase-Auftragsstatus nach dem Import in AEM auf „Geliefert“ 

      • Analysen generieren 

        Wenn diese Option aktiviert ist, werden Analysen automatisch erstellt, sobald ein Übersetzungsauftrag gesendet wurde und die Dateien importiert werden. Analysen werden immer nach Sprache erstellt, unabhängig von den Einstellungen der Projektvorlage. 

      • Generiere Angebote 

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

    Bei Verwendung älterer Versionen sind zusätzlich Informationen zu service und submitter portal erforderlich.

    Richte die Übersetzungsintegration ein

    Bei Verwendung des Phrase Translation Plugin für AEM werden alle Dateien in den Übersetzungsaufträgen zur Übersetzung eingereicht und anschließend von Phrase zurückgegeben. Verwenden Sie die Übersetzungsintegration-Projektkonfiguration, um zu verhindern, dass nicht übersetzbare Assets oder Referenzmaterialien in die Projekte aufgenommen werden.

    1. Gehe im Bereich Tools zu Cloud Services und klicke auf Translation Cloud Services.

    2. Erstelle eine neue Konfiguration speziell für Übersetzungen.

      Hinweis

      Erstellen Sie die Konfiguration unter conf. Einträge unter /libs sind schreibgeschützte Adobe-Standards.

      • Stellen Sie sicher, dass Translate Component Strings und Translate Tags deaktiviert sind.

      • Setze Translate page assets auf Do not translate.

      • Setzen Sie auf der Registerkarte Assets den Translation Workflow auf Do not translate.

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

    Übersetzungsintegration auf Sites anwenden

    Konfigurieren Sie den standardmäßigen Phrase-Übersetzungsanbieter mit verschiedenen Teilen der Site-Taxonomie. Konfigurieren Sie den Anbieter am Stammknoten der Site. Alle untergeordneten Seiten übernehmen die Einstellung. Überschreiben Sie die Einstellung an dem Knoten, der eine andere Anbieterkonfiguration verwenden soll (z. B. verwendet die gesamte Website eine menschliche Übersetzung, aber der Community-Bereich verwendet eine maschinelle Übersetzung).

    So wenden Sie die Übersetzungsintegration an:

    • Wähle auf der Registerkarte Advanced die neu erstellte Konfiguration als Cloud-Konfiguration aus.

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

    Inhalt zur Übersetzung einreichen

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

    Um ein Projekt für die Einreichung über die integrierten Workflows vorzubereiten, führe diese Schritte aus:

    1. Navigiere in der Ansicht Sites zur Seite, wähle sie aus und öffne das References Panel.

    2. Klicke auf Language Copies und erweitere 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ähle Create Multi-language Translation Project aus.

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

    5. Gib den Projekttitel ein und klicke auf Create.

    6. Navigiere im Bereich Projekte zum Projekt und öffne es.

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

      Wenn sie ordnungsgemäß konfiguriert sind, wird auf die in den obigen Schritten erstellten Konfigurationen verwiesen.

    8. Um einen Auftrag zu übermitteln, wähle Start aus dem Menü der Auftragskachel.

      Ein neues Projekt wird innerhalb weniger Minuten erstellt.

      • Nach dem Import werden die Anbieter aus der Projektvorlage zugewiesen und der Status des AEM-Auftragselements wird auf Zur Übersetzung übermittelt gesetzt.

      • Sobald der Auftrag von einem Anbieter angenommen wurde, ändert sich der Status des AEM-Auftragselements auf Übersetzung läuft.

      • Der Status des AEM-Auftragselements ändert sich auf Abgebrochen, wenn der Auftrag gelöscht oder abgebrochen wird.

      Tipp

      Adobe Experience Manager fragt den Status eines Auftrags 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 wird (z. B. 0 0/5 * * * ? *, wird die Aktualisierung des Übersetzungsauftragsstatus alle 5 Minuten ausgelöst).

      Das Aktualisieren der Projektdetailseite erzwingt einen Abruf.

    9. In Phrase werden die Projektaufträge übersetzt und ihr Status auf Abgeschlossen gesetzt. Nach Abschluss werden die Aufträge wieder in AEM importiert.

    10. Bei Ablehnung wird der erste Workflow-Schritt des Auftrags auf Per E-Mail versendet und die verbleibenden Workflow-Schritte auf Neu gesetzt.

    11. Sobald ein AEM-Auftragselement angenommen wurde, wird der Auftragsstatus auf Geliefert aktualisiert, wie in den Plugin-Einstellungen konfiguriert.

    Weitere Details zum Erstellen von Übersetzungsprojekten über das Referenz-Panel sind in der Adobe-Dokumentation zu finden.

    Verschiedenes

    Benutzerdefinierte Sprachzuordnung

    On-Premise AEM

    Zum Zuordnen von Adobe Experience Manager-Sprachen zu anderen Sprachen in Phrase (z. B. zh zu zh_tw) sind folgende Schritte durchzuführen:

    Die Zuordnung gilt sowohl für Quell- als auch für Zielsprachen.

    1. CRXDE wird über /crx/de/index.jsp geöffnet.

    2. Zum Ordner /apps/memsource-connector/language-mapping/ navigieren.

    3. Ein neuer Knoten wird erstellt.

    4. Der Adobe Experience Manager-Sprachcode wird als Name (z. B. zh) verwendet und Type: nt:unstructured beibehalten.

    5. Eine Eigenschaft hinzufügen:

      • Name: memsourceLanguage

      • Typ Zeichenfolge

      • Value: Sprachcode (z. B. zh_tw)

    6. Auf Save All klicken.

    Nicht zugeordnete Sprachcodes werden unverändert gesendet.

    AEM als Cloud Service

    Zum Hinzufügen einer Sprachzuordnung in AEM Cloud Services sind folgende Schritte durchzuführen:

    1. Eine .content.xml-Datei im Ordner /conf/aem-memsource-plugin/language-mapping/ erstellen.

    2. Die erstellte Datei öffnen und Folgendes hineinkopieren:

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

    4. Die erstellte Datei öffnen und Folgendes hineinkopieren:

      <?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. Die in den vorherigen Schritten erstellten Pfade zur Datei filter.xml hinzufügen, 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 Übersetzungsauftrag übermittelt wurde, werden die Projekt-ID und die UID in /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob als PROPERTY_MEMSOURCE_PROJECT_ID und PROPERTY_MEMSOURCE_PROJECT_UID gespeichert.

    Die IDs werden zur Anzeige in der AEM-Umgebung oder in APIs verwendet, um die Plugin-Funktionalität zu erweitern.

    AEM-Fehlerbehebung

    Problem

    Ursache(n)

    Die Lösung

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

    Der Phrase AEM-Connector lokalisiert Übersetzungsauftragsknoten anhand einer zur Laufzeit zugewiesenen 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 Durchquerung zurück, was vom Cloud Manager markiert wird.

    Eine benutzerdefinierte Oak/Lucene-Indexdefinition vom Typ oak:QueryIndexDefinition, begrenzt auf /content/projects und mit einem Eigenschaftsindex auf translationObjectID, hinzufügen. Die Indexdefinition über die Code-Pipeline bereitstellen, anstatt sie zur Laufzeit zu erstellen, und in einer Nicht-Produktionsumgebung validieren, bevor sie in der Produktion bereitgestellt wird. Der Index sollte auf die Projektordnerstruktur in der AEM-Instanz begrenzt und – wenn möglich – auf bestimmte Projektordner eingeschränkt werden, anstatt das gesamte /content/projects zu indizieren, da ein zu breit gefasster Index die Leistung beeinträchtigen kann. Nach der Bereitstellung setzt AEM die Eigenschaft reindex der Indexdefinition auf false, sobald die Neuindizierung abgeschlossen ist. Dies bestätigt, dass die Neuindizierung fehlerfrei beendet wurde und keine weiteren Maßnahmen erforderlich sind.

    Der Maven-Build schlägt aufgrund von Validierungsfehlern des filevault-package-maven-plugin fehl, wie z. B. „Package of type ‘APPLICATION’ is not supposed to contain any sub packages“ oder „Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations“.

    In Plugin-Versionen 3.1.18.6 und früher werden die OSGi-Bundles und Konfigurationsdateien in einem Paket vom Typ „APPLICATION“ verpackt, was von der Validierung von AEM as a Cloud Service abgelehnt wird.

    Auf Plugin-Version 3.1.18.7 oder höher aktualisieren. Falls skipSubPackageValidation als Workaround hinzugefügt wurde, aus der Maven-Konfiguration entfernen.

    In der Liste unter /libs in Translation Cloud Services fehlt die Phrase.

    Einträge unter /libs sind schreibgeschützte Adobe-Standards. Das Plugin speichert seine Konfiguration unter /conf, /apps/aem-memsource-plugin und /var/memsource-tms.

    Die Translation Integration-Konfiguration unter conf erstellen. Die Serververbindung wird separat unter /conf/global/settings/cloudconfigs/translation/memsource-translation gespeichert.
    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.