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 gibt es Informationen zu Supportzeiträumen.
Sobald eine Version von Adobe Experience Manager das Ende des Kernsupports erreicht, wird das Plugin von Phrase nicht mehr 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 as a Cloud Service.
Die kontextbezogene Vorschau 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 externer Inhalte in Editoren erlauben in den Zugriffs- und Sicherheitseinstellungen beeinflusst werden.
Phrase-Anforderungen:
-
Für den Zugriff auf die On-Premise-Installation muss die Unternehmensfirewall durchschritten werden.
-
In der Authoring-Umgebung ist eine Authentifizierung erforderlich.
Firewall-Konfiguration für On-Premise-Installation:
-
Die Installation muss von den IP-Adressen des Phrase-Servers aus zugänglich sein. Unter Phrase Servers IP Addresses steht die aktuelle Liste.
-
Der Domainname muss extern auflösbar sein.
Hinweis
Einige HTML-Tags stellen ein Risiko dar und werden vom CAT-Editor bei der Vorschau aus diesem HTML entfernt. Dies dient dem Schutz der Privatsphäre und der Sicherheit der Benutzerdaten.
Beispiele für entfernte Tags sind FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT oder background-image CSS-Eigenschaften.
Voraussetzung: Für die Anzeige unveröffentlichter Seiten ist ein Adobe Experience Manager-Benutzer mit den erforderlichen Mindestberechtigungen anzulegen.
Tipp
Ein neuer Benutzer namens phrase-preview ist anzulegen und der Gruppe Authors hinzuzufügen.
-
Auf der Seite Einstellungen
ist im Abschnitt nach unten zu scrollen.
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Auf New connector ist zu klicken.
Die Seite wird geöffnet.
-
Der Typ im Feld Type ist auf Adobe Experience Manager Live Preview zu ändern und dem Connector ist ein Name zuzuweisen.
-
Der Host ist einzugeben.
Es ist die Host-Adresse der Adobe Experience Manager-Installation anzugeben (z. B. https://aem-author.example.org/ oder https://author-X-Y.adobeaemcloud.com/).
Der Domainname muss extern auflösbar sein (keine Intranet-Domain).
-
Benutzername und Passwort sind einzugeben.
Single Sign-On (SSO) und Zwei-Faktor-Authentifizierung (2FA) werden nicht unterstützt. Falls beim Drupal-Konto SSO oder 2FA erforderlich ist, ist ein dediziertes Dienstkonto zu verwenden, das von beiden ausgenommen ist.
-
Zur Änderung von Links im Seiten-HTML ist eine in Form eines regex anzugeben.
Beispiel:
Zum Ersetzen eines vollständigen Gebietsschemacodes durch nur den Sprachcode in
https://example.org/en-us/images/sample.jpgist 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. -
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
Einen Connector löschen
So wird ein Connector gelöscht:
-
Auf der Seite ist der zu löschende Connector auszuwählen.
-
Auf Delete ist zu klicken.
Das Fenster wird geöffnet.
-
Das Wort „delete“ ist einzugeben und anschließend auf Delete zu klicken.
Der Connector wird gelöscht und die Liste der Connectoren wird angezeigt.
Hinweis
Ein Connector 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 Connector zu löschen, führt zu der Fehlermeldung „Failed to delete connector“.
Lösung: Das mit dem Connector verknüpfte Projekt ist zu öffnen und alle verbleibenden Jobs sind entweder abzuschließen oder zu löschen. Auf der Seite ist der Papierkorb zu leeren, um alle noch mit dem Connector verknüpften Jobs zu entfernen. Ein erneuter Löschversuch des Connectors ist durchzuführen.
Hinweis
Einige HTML-Tags stellen ein Risiko dar und werden vom CAT-Editor bei der Vorschau aus diesem HTML entfernt. Dies dient dazu, die Datensicherheit und die Privatsphäre der Nutzer zu gewährleisten.
Beispiele für entfernte Tags sind FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT oder background-image CSS-Eigenschaften.
Zur Konfiguration der Job-Verarbeitung für Adobe Experience Manager ist eine Projektvorlage zu erstellen, die den jeweiligen Anforderungen entspricht:
-
Unter 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:
-
Ein unvollständiges Übersetzungsprojekt ist zu öffnen.
-
Aus dem Menü der -Kachel ist Export auszuwählen.
-
Suchen Sie die .XML-Datei, die den Quelltext enthält, in der heruntergeladenen ZIP-Datei.
-
In Phrase ist zu den für die Integration verwendeten zu navigieren und die aufgeführte URL zu öffnen.
-
Das SP-Formular ist auszufüllen, die .XML-Datei hochzuladen, die E-Mail-Adresse zu validieren und das Formular abzusenden.
-
Zu überprüfen ist, ob das neue Projekt wie vorgesehen aus der Projektvorlage erstellt wurde.
Das neueste Plugin-Paket ist von der Seite in Phrase über die Schaltfläche Download herunterzuladen. Das Plugin ist nur für Organisationen verfügbar, die es erworben haben.
-
Beim Migrieren von 6.2 oder 6.3 auf 6.4 oder 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.
-
Unter > ist zu Packages zu navigieren.
-
Die vorherige Version des Plugins ist gegebenenfalls zu deinstallieren.
-
Es ist Upload package auszuwählen und die Installationsdatei hochzuladen.
-
Die Option Force Upload ist zu aktivieren und das Formular ist abzusenden.
Ist das Plugin bereits installiert, so ist mit Schritt 4 fortzufahren.
-
Das auf dem lokalen Dateisystem basierende Maven-Repository ist dem Stammverzeichnis des AEM Cloud Service-Projekts (pom.xml) hinzuzufügen:
repositories { ... Repository <id>project.local</id> <name>Projekt</name> <url>file:${maven.multiModuleProjectDirectory}/repository</url> Repository ... repositories { -
Die Plugin-Abhängigkeit ist zu all/pom.xml hinzuzufügen:
<dependency> <groupId>com.memsource</groupId> <artifactId>aem-memsource-plugin.all</artifactId> <version>X.X.X</version> <type>zip</type> </dependency>
-
Der eingebettete Block ist der Konfiguration von all/pom.xml -> filevault-package-maven-plugin hinzuzufügen:
... Plug-in <groupId>org.apache.jackrabbit</groupId> <artifactId>filevault-package-maven-plugin</artifactId> <extensions>true</extensions> Konfiguration <group>meine_pakete</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> ... -
Füge das Plugin dem 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 -
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 Translation Service Provider 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:
Folge diesen Schritten:
-
Gehe unter , zum .
-
Erstellen Sie 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).
-
Gehen Sie in zu .
-
Erweitere das Verzeichnis .
-
Erstelle eine neue Konfiguration und gib die folgenden Informationen ein:
-
Hostname: Die Standard-URL lautet https://cloud.memsource.com/web/ und kann abweichen, wenn eine benutzerdefinierte URL verwendet wird.
-
Username und Password (muss eine PM-Rolle mit aktivierter Option Modify global server settings in den Benutzerrechten sein).
Klick auf Connect.
-
-
Wähle weitere Optionen aus und schließe die Konfiguration.
-
Alle Übersetzungsaufträge innerhalb eines AEM-Projekts werden auch innerhalb eines Phrase-Projekts erstellt.
Wichtig
Diese Option funktioniert nicht korrekt, wenn und gleichzeitig in den Einstellungen der Phrase project template aktiviert sind.
-
-
Wenn diese Option aktiv ist, werden nach dem Senden eines Übersetzungsauftrags automatisch Analysen generiert, sobald die Dateien importiert werden. Analysen werden immer by language generiert, unabhängig von den Einstellungen der Projektvorlage.
-
Wenn die automatische Generierung von Analysen aktiviert ist, können auf Basis dieser Analysen Angebote erstellt werden.
-
Bei Verwendung älterer Versionen sind auch Informationen zu service und submitter portal erforderlich.
Bei Verwendung des Phrase Translation Plugin für AEM werden alle Dateien in den Übersetzungsaufträgen zur Übersetzung eingereicht und somit von Phrase zurückgegeben. Verwende die Projektkonfiguration Translation Integration, um zu verhindern, dass nicht übersetzbare Assets oder Referenzmaterialien in die Projekte aufgenommen werden.
-
Gehe in Tools zu und klick auf Translation Cloud Services.
-
Erstelle eine neue Konfiguration speziell für die Übersetzung.
-
Stelle sicher, dass und nicht ausgewählt sind.
-
Setze auf Do not translate.
-
Setze auf der Registerkarte den auf Do not translate.
-
-
Wenn ein Projekt weiterhin nicht übersetzbare Assets oder Referenzmaterialien enthält, markiere und lösche diese direkt in Phrase.
Konfiguriere den standardmäßigen Phrase Translation Provider mit verschiedenen Teilen der Site-Taxonomie. Konfiguriere den Provider am Root-Knoten der Site. Alle untergeordneten Seiten übernehmen die Einstellung. Überschreibe die Einstellung an dem Knoten, der eine andere Anbieterkonfiguration nutzen soll (z. B. verwendet die gesamte Website menschliche Übersetzung, während der Community-Bereich maschinelle Übersetzung nutzt).
Wende die Übersetzungsintegration an:
Beim Hinzufügen von Inhalten von diesen Seiten werden nur übersetzbare Inhalte hinzugefügt. Wenn ein Projekt über das erstellt wird, wird es automatisch so eingerichtet, dass es die mit der Stammseite verknüpfte Cloud-Konfiguration verwendet.
Um Inhalte (Sites, Assets) zur Übersetzung zu übermitteln, erstelle ein Übersetzungsprojekt in Adobe Experience Manager. Projekte können manuell im Bereich „Projekte“ erstellt werden oder integrierte Workflows nutzen, um den Aufwand zu minimieren.
Um ein Projekt für die Übermittlung über die integrierten Workflows vorzubereiten, führe diese Schritte aus:
-
Navigiere in der -Ansicht zur Seite, wähle sie aus und öffne das .
-
Klick auf Language Copies und erweitere den Bereich Create & Translate am unteren Rand der Leiste.
-
Wähle die Zielsprachen aus und deaktiviere optional Select all sub-pages.
-
Wähle Create Multi-language Translation Project.
Wenn es mehrere Zielsprachen gibt, wird für jede Sprache ein separates Projekt erstellt.
-
Gib den Projekttitel ein und klick auf Create.
-
Navigiere zum Projekt im Bereich und öffne es.
-
Klick auf die Auslassungspunkte auf der ersten Kachel, um die erweiterten Projekteinstellungen zu öffnen.
Bei ordnungsgemäßer Konfiguration werden die in den obigen Schritten erstellten Konfigurationen referenziert.
-
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 Anbieter aus der Projektvorlage zugewiesen und der Status des AEM-Auftragselements wird auf Committed for translation gesetzt.
-
Sobald der Auftrag von einem Anbieter akzeptiert wurde, ändert sich der Status des AEM-Auftragselements auf Translation in progress.
-
Der Status des AEM-Auftragselements ändert sich auf Cancelled, wenn der Auftrag gelöscht oder storniert wird.
Tipp
Adobe Experience Manager fragt den Auftragsstatus in einem Zeitplan ab, der in der konfiguriert ist, auf die über die zugegriffen wird.
Wenn die Eigenschaft auf eine häufige Ausführung eingestellt wird (z. B.
0 0/5 * * * ? *löst alle 5 Minuten eine Aktualisierung des Übersetzungsauftragsstatus aus).Das Aktualisieren der Projektdetailseite erzwingt einen Abruf.
-
-
Übersetze in Phrase die Projektaufträge und setze deren Status auf . Nach Abschluss werden die Aufträge wieder in AEM importiert.
-
Bei Ablehnung wird der erste Workflow-Schritt des Auftrags auf Emailed gesetzt und die verbleibenden Workflow-Schritte auf New.
-
Sobald ein AEM-Auftragselement akzeptiert wurde, wird der Auftragsstatus auf Delivered aktualisiert, wie in den Plugin-Einstellungen konfiguriert.
Weitere Details zum Erstellen von Übersetzungsprojekten über das Referenz-Panel findest du in der Adobe-Dokumentation.
Um Adobe Experience Manager-Sprachen verschiedenen Sprachen in Phrase zuzuordnen (z. B. zh zu zh_tw), folge diesen Schritten.
Die Zuordnung gilt sowohl für Quell- als auch für Zielsprachen.
-
CRXDE öffnen (
/crx/de/index.jsp). -
Zum Ordner
/apps/memsource-connector/language-mapping/navigieren. -
Neuen Knoten erstellen.
-
Adobe Experience Manager-Sprachcode als Name verwenden (z. B. zh) und Type: nt:unstructured beibehalten.
-
Eigenschaft hinzufügen:
-
Name: memsourceLanguage
-
Typ Zeichenfolge
-
Wert: Sprachcode (z. B. zh_tw)
-
-
Auf Alle speichern klicken.
Nicht zugeordnete Sprachcodes werden unverändert gesendet.
Um Sprachzuordnungen in AEM Cloud Services hinzuzufügen, folge diesen Schritten:
-
Erstelle eine
.content.xml-Datei im Ordner/conf/aem-memsource-plugin/language-mapping/. -
Ö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"/> -
Erstelle eine
.content.xml-Datei im Ordner/conf/aem-memsource-plugin/language-mapping/zh-cn. -
Ö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> -
Fügen Sie die in den vorherigen Schritten erstellten Pfade der Datei
filter.xmlhinzu, die Sie unterui.content/src/main/content/META-INF/vault/filter.xmlfinden:<?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>
Sobald ein Übersetzungsauftrag übermittelt wurde, werden die Projekt-ID und die UID im /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob als PROPERTY_MEMSOURCE_PROJECT_ID- und PROPERTY_MEMSOURCE_PROJECT_UID-Eigenschaften gespeichert.
Nutze die IDs zur Anzeige in der AEM-Umgebung oder in APIs, um die Plugin-Funktionalität zu erweitern.
|
Problem |
Ursache(n) |
Die Lösung |
|---|---|---|
|
Cloud Manager meldet eine Warnung „Query Without Index“ für eine Abfrage zu |
Der Phrase AEM-Connector lokalisiert Knoten von Übersetzungsaufträgen anhand einer zur Laufzeit zugewiesenen |
Füge eine benutzerdefinierte Oak/Lucene-Indexdefinition vom Typ |