Die Phrase Strings Integration (in der Strings-Oberfläche genannt) verbindet Phrase TMS und Phrase Strings. Die Integration unterstützt sowohl die Synchronisierung auf Job- als auch auf Projekt-Ebene.
-
Job-Sync
Jobs, die in Strings mit dem Status In Bearbeitung erstellt und gestartet wurden, können zur Übersetzung in TMS importiert und nach der Übersetzung an Strings zurückgesendet werden. Standardmäßig werden Jobs, die von Strings an TMS gesendet werden, als XLIFF 2.0-Dateien importiert.
Empfohlen für Batch-basierte Workflows mit granularer Steuerung.
-
Synchronisierung auf Projektebene
Alle Keys in einem ausgewählten Strings-Projekt werden an TMS übertragen, ohne dass ein Job erstellt werden muss. Neu hinzugefügte oder aktualisierte Keys werden automatisch für die Synchronisierung verfügbar.
Empfohlen für Workflows zur kontinuierlichen Lokalisierung.
Voraussetzungen
-
Zugriff sowohl auf TMS- als auch auf Strings-Anwendungen
-
Sprachcodes, die im TMS-Projekt verwendet werden, müssen mit den Sprachcodes im Strings-Job übereinstimmen.
-
Die Standardsprache des Strings-Projekts muss mit der im TMS-Projekt definierten Ausgangssprache übereinstimmen.
Wichtig
Figma-Dateien können in Strings als vollständige Live-Datei angezeigt werden, werden jedoch in TMS nicht unterstützt. Der TMS CAT Editor kann übersetzte Inhalte in einem bestimmten Figma-Frame nur im SVG-Format anzeigen.
Übersetzungsstatus von Strings-Key werden nicht unterstützt. Keys, die vor dem Import in TMS in Strings als markiert sind, können bei unveränderten Zielübersetzungen als an Strings zurückgegeben werden.
Nach dem Import eines Strings-Jobs kann sich die Anzahl der in TMS erstellten Segmente von der ursprünglichen Anzahl der Keys unterscheiden. Dies geschieht in den folgenden Fällen:
-
Die Keys sind in Strings als ausgeschlossen markiert. Ausgeschlossene Keys werden nicht importiert.
-
Die Option XLIFF segmentieren wurde beim Erstellen des Jobs in TMS in den Datei-Importeinstellungen für XLIFF 2.0 aktiviert. In diesem Fall kann die Anzahl der Segmente höher sein als die Anzahl der Keys in Strings.
Strings-Keys können HTML-Entitäten enthalten. Aktiviere beim Einrichten des Konnektors in TMS die Option , um HTML-Entitäten beizubehalten, anstatt die entsprechenden Zeichen in TMS anzuzeigen.
Führende und nachgestellte Leerzeichen im Ausgangstext eines Strings-Keys werden im TMS CAT Editor nicht angezeigt. Diese Leerzeichen bleiben im Grundgerüst erhalten und werden sowohl in die Ausgangs- als auch in die Zielsprache wieder eingefügt, wenn der Job zurück an Strings synchronisiert wird. Dies kann sich auf die in Strings konfigurierten Zeichenbegrenzungs-Validierungen auswirken, da die Anzahl der Leerzeichen während der Übersetzung im TMS Editor nicht berücksichtigt wird.
Mit dem Konnektor können mehrere Projekte und Dateien in APE überwacht werden. Jedes Projekt erfordert eine individuelle Überwachung innerhalb einer einzigen APE.
Der Konnektor verwendet Job-Sprache-Anmerkungen, um Metadaten über das entsprechende Phrase TMS-Projekt an Strings-Jobs und Job-Sprachen anzuhängen. Der Phrase Strings-API-Endpunkt zum Auflisten von Job-Sprache-Anmerkungen ruft diese Metadaten ab. Der Endpunkt zum Auflisten von Job-Zielsprachen enthält diese Metadaten ebenfalls, wenn der Parameter include_annotations auf true gesetzt ist. Annotierte Jobs enthalten Felder wie tms_project_id und tms_in_progress, die die Nachverfolgung des Status eines Strings-Jobs in seinem verknüpften Phrase TMS-Projekt ermöglichen.
ICU-Nachrichten und CLDR-Pluralformen
Wenn du Strings-Jobs mit ICU-Nachrichten oder Pluralformen zur Übersetzung an TMS senden, aktiviere die Option in den Datei-Importeinstellungen in XLIFF 2.0 oder in den TMS-Projektvorlagen.
Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:
-
TMS-Projektmanager können direkt aus einem Online-Repository Dateien zu TMS-Projekten hinzufügen.
-
Stelle im Einreicher-Portal in Phrase TMS die Möglichkeit ein, dass Einreicher direkt aus Phrase Strings Dateien zu Anfragen hinzufügen können.
-
Verwende die Automatisierte Projekterstellung in TMS, um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dateien oder Ordnern eine Änderung des „Zuletzt geändert“- Datums festgestellt wird.
-
Sowohl für Job- als auch für Projektebene-Syncs muss der überwachte Projektpfad bis zum Jobs-Ordner ausgewählt werden (z. B. space/project/main/jobs).
-
Für Job-Syncs wird die APC durch die folgenden Job-Updates ausgelöst:
-
Neu hinzugefügte Keys oder Änderungen vorhandener Keys
-
Geändertes Fälligkeitsdatum des Jobs in Strings
Hinweis
Das erneute Öffnen von Jobs wird zählt für die APE nicht als Update.
-
-
Für Projektebene-Syncs wird die APC ausgelöst durch:
-
Neu hinzugefügte Schlüssel
-
Änderungen an bestehenden Schlüsseln
-
-
Wenn beim Einrichten der APE die Option ausgewählt ist, kann das Remote Online Repository nicht nur auf Aktualisierungen der Ausgangssprache, sondern auch auf Aktualisierungen der Zielsprache überwacht werden.
Wenn du die Aktualisierung der Zielsprache überwachst, werden alle Änderungen an der Zielsprache im Online-Repository das Translation Memory in Phrase TMS automatisch aktualisieren.
-
Wenn die Option ausgewählt ist, werden wichtige Textänderungen im Strings-Zieltext automatisch in den Translation Memorys aktualisiert, die im relevanten APE-Projekt verwendet werden.
-
-
Mit dem TMS-Konnektor-API können Schritte automatisiert werden, die sonst manuell über die Benutzeroberfläche ausgeführt werden. Mit Webhooks können Systeme von Drittanbietern über bestimmte Ereignisse benachrichtigt werden (beispielsweise wenn sich der Status eines Jobs ändert).
Die Seite bietet eine zentrale Ansicht aller Job Sync-Setups (APCs), die den Phrase Strings Konnektor verwenden. Sie enthält sowohl direkt in Strings erstellte als auch in TMS konfigurierte Syncs mit den entsprechenden Informationen.
Von der -Seite aus können Benutzer mit Administrator- oder Projektmanagerrolle in Strings neue Job Syncs konfigurieren, bestehende Job Syncs bearbeiten (einschließlich ihres aktiven/inaktiven Status) oder sie löschen.
Bestehende Job Syncs können durch Verwendung der entsprechenden Optionen im Menü bearbeitet oder gelöscht werden. Alle Änderungen werden zwischen Strings und TMS synchronisiert. Das Löschen eines Job Syncs entfernt die entsprechende APC in TMS.
Die Seite ist sowohl über das Menü als auch über das Menü in der linken Navigation zugänglich.
Hinweis
Wenn in TMS erforderliche benutzerdefinierte Felder definiert sind, wird das Einrichten eines Job Syncs von Strings aus nicht unterstützt.
Um einen neuen Job Sync zwischen Strings und TMS mit einer grundlegenden Konfiguration einzurichten, sind folgende Schritte in der Strings-Benutzeroberfläche auszuführen:
-
Auf der Seite wird neben der -Integration die Option Konfigurieren angezeigt.
Die Seite wird angezeigt.
-
Auf + Neuer Job Sync wird geklickt.
Das Fenster wird angezeigt.
-
Ein ist anzugeben und aus dem Dropdown-Menü sind die Strings-Projekte auszuwählen, die mit dem TMS verbunden werden sollen.
Es können nur Projekte mit denselben Sprachkombinationen einbezogen werden.
-
Optional ist die zu verwendende auszuwählen. Die ausgewählte TMS-Projektvorlage muss mit den in den zugewiesenen Strings-Projekten definierten Sprachen übereinstimmen.
Synchronisierte Jobs werden dem TMS-Projekt hinzugefügt, das aus der ausgewählten Vorlage erstellt wurde.
-
Wenn ausgewählt ist, wird automatisch eine TMS-Projektvorlage basierend auf den ausgewählten Strings-Projekten erstellt.
-
-
Der Projekt- ist für die Erstellung im TMS auszuwählen.
-
Standardoption.
-
Jedes Mal, wenn Änderungen in den Strings-Jobs erkannt werden, wird ein neues TMS-Projekt erstellt.
-
-
Im Abschnitt sind die Strings-Exporteinstellungen festzulegen, um zu steuern, wie Übersetzungen aus dem TMS zurück in Strings exportiert werden.
-
Aktualisiert bestehende Zielsprachen-Übersetzungen in Strings.
-
Markiert den Job in Strings automatisch als abgeschlossen.
-
Als nicht verifiziert markierte Keys werden in Strings automatisch als überprüft markiert, falls die Zielsprachen-Übersetzungen unverändert bleiben.
-
-
Bei Bedarf auf Erweiterte Optionen klicken, um weitere Exportoptionen anzuzeigen.
-
Markiert eine bestimmte Sprache als abgeschlossen, sobald ihre Übersetzungen zurück synchronisiert wurden.
-
Stellt sicher, dass neue Schlüssel aus dem TMS in Strings erstellt und bestehende aktualisiert werden.
-
Verhindert das Überschreiben von Übersetzungen, wenn sich der Ausgangssprache-Text in Strings seit dem export geändert hat.
-
-
Klicke auf Speichern.
Die neue Job Sync-Konfiguration wird der Liste mit inaktivem Status hinzugefügt. Der Umschalter unter der Spalte kann verwendet werden, um den Job Sync zu aktivieren.
Tipp
Für fortgeschrittenere Konfigurationen kann der Konnektor mithilfe der Phrase TMS-Einstellungen eingerichtet werden.
Einige Organisationen haben bereits automatisch einen Phrase Strings-Konnektor erstellt, der die Phrase Platform-Identität der Organisation verwendet. Die Konnektor-Liste auf der Seite sollte überprüft werden, bevor einer manuell erstellt wird. Der automatisch erstellte Konnektor authentifiziert sich serverseitig unter Verwendung der angemeldeten Identität, nicht über ein manuell eingegebenes access token.
Der Konnektor zeigt den Status an, während er nach der Erstellung seine erste Synchronisierung abschließt, und ändert sich dann zu . Der Status wird auch ausgelöst, wenn eine Änderung an der Konnektor-Konfiguration vorgenommen wird oder wenn die Seite mit den Konnektor-Einstellungen gespeichert wird, selbst ohne wesentliche Änderungen. Während ein Konnektor anzeigt, kann er nicht als Ausgangssprache für die Job-Erstellung in Phrase TMS verwendet werden. Warten, bis sich der Status zu ändert, bevor Jobs mit diesem Konnektor erstellt werden.
-
Scrolle auf der Seite Einstellungen
nach unten zum Abschnitt .
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Es ist auf New connector zu klicken.
Die Seite wird geöffnet.
-
Der Type wird auf geändert und ein Name für den Konnektor wird angegeben.
-
Die Konto-ID und das access token sind einzugeben, wie von Strings bereitgestellt.
-
Klicke auf Verbindung testen.
-
Bei Erfolg erscheint ein kleines Häkchen neben der Schaltfläche .
-
-
Elemente auswählen, die in das TMS importiert werden sollen.
Wenn Zielzeichenfolgen nicht importiert werden, kann die XLIFF 2.0-Datei weiter segmentiert werden, wenn in den für XLIFF 2.0-Dateien XLIFF segmentieren ausgewählt ist.
-
Die erweiterten Importoptionen nach Bedarf aktivieren oder deaktivieren:
-
Die Ausgangssprache des TMS-Projekts wird unabhängig von der Standard Sprache im Strings-Projekt angewendet.
-
Diese Option aktivieren, um die Erstellung doppelter TMS-Jobs für Sprachen zu verhindern, die bereits in Bearbeitung sind. Wenn aktiviert, werden Änderungen an Keys, die bereits Teil eines aktiven TMS-Jobs sind, erst reimportiert, wenn der ursprüngliche Job abgeschlossen ist. Empfohlen für bessere Kontrolle bei Jobs mit mehreren Sprachen.
-
-
Diese Option stellt sicher, dass HTML-Entitäten in CDATA-Dateien eingeschlossen sind, die bei der Übertragung zwischen Strings und TMS beibehalten werden.
-
Mit dieser Option können Inhalte importiert werden, die die ICU-Syntax mit HTML-Inline-Elementen kombinieren.
-
-
-
-
Wähle einen Exportmodus aus.
-
Die folgenden Exportoptionen nach Bedarf aktivieren oder deaktivieren:
-
Deaktivieren, um zu verhindern, dass vorhandene Übersetzungen mit dem Content der Datei aktualisiert werden.
-
Deaktivieren, um die Erstellung neuer Keys und Aktualisierungen vorhandener Keys zu verhindern.
-
Übersetzungen, die nicht mit dem neuesten Content der Ausgangssprache übereinstimmen, werden während der Synchronisierung ausgeschlossen. Dies trägt dazu bei, die Konsistenz zwischen Ausgangssprache und Übersetzungen zu wahren und veraltete oder falsche Übersetzungen zu vermeiden.
-
Keys, die als markiert sind, werden bei unveränderten Zielsprachen-Übersetzungen automatisch in Strings als überprüft markiert.
-
Markiert eine bestimmte Sprache als abgeschlossen, sobald ihre Übersetzungen zurück synchronisiert wurden.
-
Wenn ausgewählt, wird der Job erst nach dem Hochladen der letzten Sprache als abgeschlossen markiert.
-
-
-
Falls angegeben, kann ein Standardordner ausgewählt werden (nur nach dem Speichern möglich).
-
wird vorgestellt und kann bei Bedarf angepasst werden. Änderungen des Sprach-Mappings wirken sich nicht auf vorhandene Jobs aus.
Die Liste zeigt jeweils fünf Projekte an, wobei die Projekte alphabetisch sortiert werden; zuerst von A-Z (Großbuchstaben) und dann a-z (Kleinbuchstaben).
-
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
Konnektor löschen
Zum Löschen eines Konnektors:
-
Auf der Seite den zu löschenden Konnektor auswählen.
-
Auf Delete ist zu klicken.
Das Fenster öffnet sich.
-
Es ist "delete" einzugeben und auf Delete zu klicken.
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 „Failed to delete connector“.
Lösung: Das mit dem Konnektor verknüpfte Projekt öffnen und alle verbleibenden Jobs abschließen oder löschen. Zu gehen und ihn leeren, um alle Jobs zu entfernen, die noch mit dem Konnektor verknüpft sind. Erneut versuchen, den Konnektor zu löschen.
Unterstützt bei der Integration:
-
TMS-Projektvorlagen
-
TMS-Workflows
-
Job briefing (nicht anwendbar bei Verwendung der Synchronisierung auf Projektebene)
-
Job due date (nicht anwendbar bei Verwendung der Synchronisierung auf Projektebene)
Das in Strings festgelegte Fälligkeitsdatum aktualisiert die Deadline des Projekts in TMS. Wenn es mehrere unterschiedliche Deadlines gibt, wird die am weitesten entfernte Deadline auf das TMS-Projekt angewendet.
Als Projekt-Referenz von Strings an TMS übertragen:
-
Key-Namen
Von Strings übernommen und im Kontexthinweis des TMS CAT Editors als Kontext-Key angezeigt.
-
Key-Beschreibungen
Von Strings übernommen und als Kontexthinweis im Kontexthinweis des TMS-CAT Editors angezeigt.
-
Max. Key-Zeichenlänge
Von Strings übernommen und im Kontexthinweis des TMS-CAT Editors angezeigt.
-
Screenshots
Um Screenshots aus Strings im Bereich der TMS CAT Editoren anzuzeigen:
-
Die Option im Abschnitt Access and Security der TMS-Projekteinstellungen aktivieren.
-
Das Textformat im Bereich auswählen.
-
-
Benutzerdefinierte Metadaten in unterstützten Dateiformaten:
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
Gehe folgendermaßen vor, um die in Strings mit APE vorgenommenen Aktualisierungen in der Zielsprache zu überwachen:
-
Wähle beim Einrichten einer APE jedes Mal aus.
Damit kann das Online-Repository auf Aktualisierungen der Zielsprache in Strings überwacht werden.
-
Wähle im Bereich des APE-Setups die Option aus.
Änderungen an den Inhalten der Zielsprache in Strings werden automatisch im Phrase TMS-Translation Memory gespeichert, wenn die APE-Überwachung ausgelöst wird.
Es ist möglich, die Aktualisierungen des Translation Memory durch Ändern der Zielsegmente im Phrase TMS-Editor zu überschreiben. Diese Aktualisierungen werden nach Abschluss des Jobs in Phrase TMS zurück in Strings exportiert.
Verhalten beim Löschen von Keys mit APC
Das Löschen eines Keys in Strings, nachdem er in einen Job aufgenommen wurde, hat keine Auswirkungen auf einen Phrase TMS-Job, der durch einen einmaligen manuellen Import erstellt wurde. Dieser Job bleibt unverändert, bis er manuell erneut importiert wird.
Wenn die APE-Überwachung aktiv ist, vergleicht Phrase bei jedem Abruf oder Webhook-Trigger einen Content-Hash und behandelt jede Änderung, einschließlich einer Key-Löschung, als ein Update, das eine erneute Synchronisierung auslöst.
-
Im Modus aktualisiert die erneute Synchronisierung das bestehende Phrase TMS-Projekt oder den Job, um ihn an den aktuellen Content in Strings anzupassen, sodass der Content des gelöschten Keys aus diesem Job entfernt wird.
-
Im Modus erstellt die erneute Synchronisierung eine neue Phrase TMS-Jobversion, die den Content nach der Löschung widerspiegelt, während zuvor erstellte Jobversionen unverändert bleiben.
In der folgenden Tabelle werden häufige Probleme aufgeführt, auf die User bei der Verwendung der Strings-Integration stoßen können. Sie bietet mögliche Ursachen und Lösungen für die Fehlerbehebung.
|
Problem |
Ursache(n) |
Die Lösung |
|---|---|---|
|
Warnung bezüglich |
Key-Namen enthalten unerwünschte Zeichen (z.B. Leerzeichen) |
User können Übersetzungsinhalte trotz der Warnung weiterhin verarbeiten und zurück in Strings exportieren. |
|
Keys in TMS sind leer |
Job enthält Keys ohne Ausgangstext in der Ausgangssprache |
Entweder:
|
|
Die APE erstellt/verarbeitet keine neuen Jobs |
Die Sprachcodes stimmen nicht überein |
Stelle sicher, dass die Sprachcodes in Strings mit denen im TMS-Projekt übereinstimmen. Wenn die APE als kontinuierliches Projekt festgelegt wird, werden alle Änderungen an der Projektvorlage nach der Projekterstellung nicht auf vorhandene Projekte angewendet. Daher müssen Änderungen direkt an den kontinuierlichen Projekten vorgenommen werden. |
|
Die APE betrachtet den Job / die Sprache als verarbeitet |
Wenn die Projekvorlage/APE-Einstellungen nach dem Starten des Jobs geändert werden, kann dies im Verlauf der APE als verarbeitet betrachtet werden. Daher kann es notwendig sein, den Job zu aktualisieren, um ihn für die nächste Ausgabe zu qualifizieren. Entweder:
|
|
|
Fehler |
Reduziere die Anzahl der APEs und senke die Überwachungshäufigkeit. |
|
|
Bestehender Key im Strings-Projekt fehlt im TMS-Job |
Der spezifische Key wurde dem Strings-Job nicht hinzugefügt |
Der Key sollte zum Strings-Job hinzugefügt und der Job aus dem Online-Repository in TMS erneut importiert werden. |
|
„Could not authenticate“-Fehler erscheint beim Versuch, Jobs zu importieren/exportieren. |
Abgelaufenes oder widerrufenes Zugriffstoken auf dem automatisch erstellten „created by Phrase Strings“-Konnektor |
Ein neuer Phrase Strings Konnektor sollte in TMS erstellt, vorhandene APCs mit dem neuen Konnektor erneut verknüpft und der Monitor ausgelöst werden. |
|
Der Strings Job kann nicht für den Import oder Re-Import über APE oder manuell gefunden werden, obwohl er nicht als abgeschlossen angezeigt wird. |
Der Job wurde bereits in ein TMS Projekt importiert, das später in den Papierkorb verschoben wurde, ohne abgeschlossen oder bereinigt zu werden. Da das Projekt technisch gesehen noch in Bearbeitung ist, wird der Job nicht für den Re-Import freigegeben. |
Die des Jobs neben seiner Sprache in Strings sollten überprüft werden, um zu verifizieren, ob er bereits in TMS importiert wurde, bevor mit der weiteren Fehlerbehebung fortgefahren wird. Wenn das verknüpfte Projekt im Papierkorb gefunden wird, sollte das Projekt wiederhergestellt und direkt weiter daran gearbeitet werden, oder, falls das Projekt nicht benötigt wird, sollten die Jobs und das Projekt abgebrochen oder das Projekt dauerhaft über die API unter Verwendung des |
|
Job Sync kann nicht gespeichert werden und gibt den Fehler \" |
Job Sync validiert Zielsprachen im Strings Projekt direkt anhand der Liste der locales natively supported by TMS zum Zeitpunkt des Speicherns. Diese Validierung berücksichtigt keine individuellen Konnektor-Sprachzuordnungen. |
Für ein Strings Projekt mit einer Zielsprache, die nicht nativ von TMS unterstützt wird, sollte der Strings Konnektor direkt in TMS verwendet und eine individuelle Sprachzuordnung konfiguriert werden, anstatt den Konnektor aus Strings heraus zu nutzen. |