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. Informationen zur aktuellen Liste finden Sie unter Phrase Servers IP Addresses.

  • Der Fachbereichsname muss extern auflösbar sein.

Hinweis

Einige HTML-Tags stellen ein Risiko dar, weshalb der CAT Editor sie bei der Anzeige der Vorschau aus diesem HTML entfernt. 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 Hintergrundbild-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 Authors 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 in 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 Benutzernamen und das Passwort ein.

  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.

Hinweis

Einige HTML-Tags stellen ein Risiko dar, weshalb der CAT Editor sie bei der Anzeige der Vorschau aus diesem HTML entfernt. 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 Hintergrundbild-CSS-Eigenschaften.

Übersetzungs-Workflow konfigurieren

Um die Job-Verarbeitung in Adobe Experience Manager zu konfigurieren, erstellen Sie eine Projekt-Vorlage, die Ihren Anforderungen entspricht:

  • Aktivieren Sie unter Access and Security die Option Allow loading of external content in Phrase CAT editor.

Bei Verwendung von Vermächtnis-Versionen müssen eine Dienstleistung und ein Submitter Portal erstellt und validiert werden. Befolgen Sie diese Schritte, um die Konfiguration zu überprüfen:

  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 die Ausgangssprache enthält, in der heruntergeladenen Zip-Datei.

  4. Navigieren Sie in Phrase zu den Submitter Portals, die für die Integration verwendet werden, und öffnen Sie die aufgeführte URL.

  5. Füllen Sie das SP-Formular aus, laden Sie die .XML-Datei hoch, überprüfen Sie die E-Mail und absenden.

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

AEM-Konfiguration

Plug-in installieren

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 Classic UI Admin-Tool (/miscadmin#/etc/cloudservices/memsource-translation).

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

  2. Gehen Sie unter Tools, Deployment zu Packages.

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

  4. Wählen Sie Upload package aus und laden Sie die Installationsdatei hoch.

  5. Aktivieren Sie Force Upload und absenden.

AEM as a Cloud Service

Wenn das Plug-in bereits installiert ist, fahren Sie mit Schritt 4 fort.

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

    <repositories>
    ...
      <repository>
        <id>project.local</id>
        <name>project</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      </Repository>
    ...
    </repositories>
  2. Fügen Sie die Plug-in-Abhängigkeit zu all/pom.xml hinzu:

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>X.X.X</version>
      <type>zip</type>
    </dependency>
  3. Fügen Sie den eingebetteten Block zur Konfiguration von all/pom.xml -> filevault-package-maven-plugin hinzu:

    ...
    <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. Fügen Sie das Plug-in zum lokalen Maven-Repository hinzu. Führen Sie den folgenden Befehl vom Stammverzeichnis des AEM-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. Legen Sie die korrekte Plug-in-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>
    

Konfigurieren Sie das Plug-in

Es sind zwei Konfigurationen erforderlich:

  • Teilen Sie dem System mit, dass Phrase existiert, indem Sie es als Übersetzungs-Dienstleister 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 Translation Integration Configuration 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 Übersetzungs-Dienstleister hinzu

Folge diesen Schritten:

  1. Gehen Sie unter Tools, General zum 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 unter Cloud Services zu Translation Cloud Services.

  4. Erweitern Sie das conf-Verzeichnis.

  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 Dienstleister eine benutzerdefinierte URL verwenden.

    • Username und Password (muss ein User mit PM-Rolle sein, bei dem die Option Modify global server settings in den User-Rechten aktiviert ist).

    Klicken Sie auf Connect.

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

    • 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 Phrase-Projektvorlage-Einstellungen aktiviert sind.

    • Phrase Job Status auf Geliefert nach importieren in AEM festlegen 

    • Analysen generieren 

      Wenn aktiv, werden nach dem importieren der Dateien automatisch Analysen generiert, sobald ein Job gesendet wird. Analysen werden immer nach Sprache generiert, unabhängig von den Projekt Vorlage Einstellungen. 

    • Angebote erstellen 

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

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

Phrase Integration festlegen

Bei Verwendung des Phrase Plug-in für AEM werden alle Dateien in den Jobs zur Übersetzung eingereicht und somit von Phrase zurückgegeben. Verwenden Sie die Projekt Integration Konfiguration, um zu verhindern, dass nicht übersetzbares Element oder Referenz in die Projekte aufgenommen werden.

  1. Gehen Sie in 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.

    • Setzen Sie Translate page assets auf Do not translate.

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

  3. Wenn ein Projekt weiterhin nicht übersetzbares Element oder Referenz enthält, markieren und Löschen Sie diese direkt in Phrase.

Phrase Integration auf Sites anwenden

Konfigurieren Sie den standardmäßigen Phrase Dienstleister mit verschiedenen Teilen der Site-Taxonomie. Konfigurieren Sie den Dienstleister am Stammknoten der Site. Alle untergeordneten Seiten erben diese Einstellungen. Ü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 Übersetzungs-Integration an:

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

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

Content zur Übersetzung absenden

Um Content (Sites, Assets) zur Übersetzung zu absenden, erstellen Sie ein Übersetzungsprojekt in Adobe Experience Manager. Projekte können manuell im Bereich Projekt erstellt werden oder verwenden 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 Sites-Ansicht zur Seite, wählen Sie sie aus und öffnen Sie das Referenz-Panel.

  2. Klicken Sie auf Sprache und erweitern Sie den Bereich Erstellen & Übersetzen am unteren Rand der Leiste.

  3. Wählen Sie Zielsprachen aus, deaktivieren Sie optional Alle Unterseiten auswählen.

  4. Wählen Sie Mehrsprachiges Übersetzungsprojekt erstellen.

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

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

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

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

    Bei korrekter Konfiguration werden die in den obigen Schritten erstellten Konfigurationen referenziert.

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

    Ein neues Projekt wird innerhalb weniger Minuten erstellt.

    • Nach dem importieren werden Anbieter aus der Projekt-Vorlage zugewiesen und der AEM Job-Status wird auf Zur Übersetzung übermittelt gesetzt.

    • Sobald der Job von einem Dienstleister akzeptiert wurde, ändert sich der Status des AEM-Jobelements auf Übersetzung in Bearbeitung.

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

    Tipp

    Adobe Experience Manager fragt den Status des 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 wird (z. B. 0 0/5 * * * ? *, wird der Status des Übersetzungs-Jobs alle 5 Minuten aktualisiert).

    Das Aktualisieren der Projekt-Detailseite erzwingt einen Abruf.

  9. Übersetzen Sie in Phrase die Projekt-Jobs und setzen Sie deren Status auf Abgeschlossen. Nach Abschluss werden die Jobs zurück in AEM importiert.

  10. Bei Ablehnung wird der erste Arbeitsschritt des Jobs auf Per E-Mail gesendet gesetzt und die verbleibenden Arbeitsschritte auf Neu.

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

Weitere Details zum Erstellen von Übersetzungsprojekten über das Referenz-Panel finden Sie 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), befolgen Sie diese Schritte.

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

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

  2. Navigieren Sie zum Ordner /apps/memsource-connector/language-mapping/.

  3. Erstellen Sie einen neuen Knoten.

  4. Verwenden Sie den Adobe Experience Manager-Sprachcode als Name (z. B. zh) und behalten Sie Typ: NÜE:unstructured bei.

  5. Eigenschaft hinzufügen:

    • Name: memsourceLanguage

    • Typ: Zeichenfolge

    • Wert: 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. Öffne die erstellte Datei und kopiere 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. Erstelle eine .content.xml-Datei im Ordner /conf/aem-memsource-plugin/language-mapping/zh-cn.

  4. Öffne die erstellte Datei und kopiere 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üge 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.

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

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.