Phrase Strings Konnektor (Job Sync)

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

Die Phrase Strings Integration (in der Strings-Oberfläche Job Sync 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 Fortschritt 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 Kontrolle.
Synchronisierung auf Projekt-Ebene

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 erforderlich
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 übersetzten Content nur in einem bestimmten Figma-Frame im SVG-Format anzeigen.

Übersetzungsstatus von Strings-Key werden nicht unterstützt. Keys, die vor dem Import in TMS in Strings als nicht verifiziert markiert sind, können bei unveränderten Zielsprachen-Übersetzungen als überprüft 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 HTML-Inhalt in CDATA einschließen, 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 in Strings konfigurierte Validierungen von Zeichenbegrenzungen 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. Anmerkungs-Jobs enthalten Felder wie tms_project_id und tms_in_progress, die die Nachverfolgung des Status eines Strings-Jobs im 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 ICU-Nachrichten analysieren in den Datei-Importeinstellungen in XLIFF 2.0 oder in den TMS-Projektvorlagen.

Anwendungsfälle

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 Projekt-Ebene-Syncs muss der Pfad zum überwachten Projekt bis zum Jobordner ausgewählt sein (z. B. Space / Projekt / Hauptprojekt / Jobs).
- Für Job Syncs wird die APE 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 Syncs auf Projektebene wird die APE ausgelöst durch:
  - Neu hinzugefügte Schlüssel
  - Änderungen an bestehenden Schlüsseln
- Wenn beim Einrichten der APE die OptionJedes Mal ein neues Projekt erstellen 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 In der Remote-Entität vorgenommene Zielsprachen-Updates automatisch im TM speichern 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).

Seite für Job Syncs

Die Seite Job Syncs bietet eine zentrale Übersicht aller Job Sync-Setups (APEs), 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 Job Syncs aus können Benutzer mit der Administratorrolle oder dem Projektmanagement in Strings neue Job Syncs konfigurieren, bestehende Job Syncs bearbeiten (einschließlich ihres Status aktiv/inaktiv) oder sie löschen.

Bestehende Job Syncs können durch Verwendung der entsprechenden Optionen im Menü Mehr More Menu bearbeitet oder gelöscht werden. Alle Änderungen werden zwischen Strings und TMS synchronisiert. Das Löschen eines Job Syncs entfernt die entsprechende APE in TMS.

Die Seite Job Syncs ist sowohl über das Menü Integrationen als auch über das Menü Jobs in der linken Navigation zugänglich.

Job Syncs in Strings konfigurieren

Hinweis

Wenn in TMS erforderliche Individuell Felder definiert sind, wird das Festlegen eines Job Syncs von Strings aus nicht unterstützt.

Um einen neuen Job Sync zwischen Strings und TMS mit grundlegender Konfiguration festzulegen, folgen Sie diesen Schritten in der Strings-Benutzeroberfläche:

Wählen Sie auf der Seite Integrationen neben der Job Sync-Integration die Option Konfigurieren aus.

Die Seite Job Syncs wird angezeigt.
Klicken Sie auf + Neuer Job Sync.

Das Fenster Neuen Job Sync erstellen wird angezeigt.
Geben Sie einen Sync-Namen ein und wählen Sie aus dem Dropdown-Menü Zugewiesene Strings-Projekte die Strings-Projekte aus, die mit dem TMS verbunden werden sollen.

Es können nur Projekte mit denselben Sprachkombinationen einbezogen werden.
Wählen Sie optional die zu verwendende TMS-Projektvorlage aus. Die ausgewählte TMS-Projektvorlage muss mit der Menge der Sprachen übereinstimmen, die in den zugewiesenen Strings-Projekten definiert sind.

Synchronisierte Jobs werden dem TMS-Projekt hinzugefügt, das aus der ausgewählten Vorlage erstellt wurde.
- Wenn Standard ausgewählt ist, wird automatisch eine TMS-Projektvorlage basierend auf den ausgewählten Strings-Projekten erstellt.
Wählen Sie den Projekt-Typ, der im TMS erstellt werden soll.
- kontinuierliches Projekt
  
  Standardoption.
- Neues Projekt
  
  Jedes Mal, wenn Änderungen in den Strings-Jobs erkannt werden, wird ein neues TMS-Projekt erstellt.
Legen Sie im Abschnitt Export zurück zu Strings die Strings-Exporteinstellungen fest, um zu steuern, wie Übersetzungen aus dem TMS zurück in Strings exportiert werden.
- Vorhandene Übersetzungen überschreiben
  
  Aktualisiert bestehende Zielsprachen-Übersetzungen in Strings.
- Job als abgeschlossen markieren
  
  Markiert den Job in Strings automatisch als abgeschlossen.
- Unveränderte Übersetzungen in Strings verifizieren
  
  Als nicht verifiziert markierte Keys werden in Strings automatisch als überprüft markiert, falls die Zielsprachen-Übersetzungen unverändert bleiben.
Klicken Sie bei Bedarf auf Erweiterte Optionen, um zusätzliche Exportoptionen anzuzeigen.
- Sprache als abgeschlossen markieren
  
  Markiert eine bestimmte Sprache als abgeschlossen, sobald ihre Übersetzungen zurück synchronisiert wurden.
- Neue Keys erstellen und vorhandene Keys aktualisieren
  
  Stellt sicher, dass neue Schlüssel aus dem TMS in Strings erstellt und bestehende aktualisiert werden.
- Übersetzung nur anwenden, wenn die Quelle mit der gespeicherten Version übereinstimmt
  
  Verhindert das Überschreiben von Übersetzungen, wenn sich der Text der Ausgangssprache seit dem exportieren in Strings geändert hat.
Klicke auf Speichern.

Die neue Job Sync-Konfiguration wird der Liste TMS Job Syncs mit dem Status „inaktiv“ hinzugefügt. Verwenden Sie den Umschalter in der Spalte aktiv, um den Job Sync zu aktivieren.

Tipp

Für fortgeschrittenere Konfigurationen legen Sie den Konnektor mithilfe der Phrase TMS-Einstellungen fest.

Phrase TMS-Einstellungen

Scrolle auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Klicken Sie auf Neuer Konnektor.

Die Seite Konnektor erstellen wird geöffnet.
Ändern Sie den Typ in Phrase Strings und geben Sie einen Namen für den Konnektor an.
Geben Sie die User-Konto-ID und das von Strings erhaltene Zugriffs-Token ein.
Klicke auf Verbindung testen.
- Bei Erfolg erscheint ein kleines Häkchen neben der Schaltfläche Verbindung testen.
Wählen Sie Elemente aus, die in das TMS importiert werden sollen.

Wenn Zielschlüssel nicht importiert werden, kann die XLIFF 2.0-Datei weiter segmentiert werden, wenn in den Datei-Importeinstellungen für XLIFF 2.0-Dateien Segment XLIFF ausgewählt ist.
- Aktivieren oder deaktivieren Sie die erweiterten Importoptionen nach Bedarf:
  - Ausgangssprache des TMS-Projekts beim Import verwenden
    
    Die Ausgangssprache des TMS-Projekts wird unabhängig von der Standard-Sprache im Strings-Projekt angewendet.
  - TMS-Job für jede Sprache erstellen
    
    Aktivieren Sie diese Option, um die Erstellung doppelter TMS-Jobs für bereits in Bearbeitung befindliche Locales zu verhindern. Empfohlen für bessere Kontrolle bei Jobs mit mehreren Sprachen.
  - HTML-Inhalt in CDATA einschließen
    
    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.
- Aktivieren oder deaktivieren Sie die folgenden Exportoptionen nach Bedarf:
  - Übersetzungen überschreiben
    
    Deaktivieren Sie dies, um zu verhindern, dass bestehende Übersetzungen mit dem Content der Datei aktualisiert werden.
  - Neue Keys erstellen oder aktualisieren
    
    Deaktivieren Sie dies, um die Erstellung neuer Schlüssel und Aktualisierungen bestehender Schlüssel zu verhindern.
  - Übersetzung nur anwenden, wenn die Ausgangssprache übereinstimmt
    
    Übersetzungen, die nicht mit dem neuesten Content der Ausgangssprache übereinstimmen, werden während der Synchronisierung ausgeschlossen. Dies trägt dazu bei, die Konsistenz zwischen dem Text der Ausgangssprache und den Übersetzungen zu wahren und veraltete oder falsche Übersetzungen zu vermeiden.
  - Nur überprüfen, wenn die Übersetzung unverändert ist
    
    Keys, die als nicht verifiziert markiert sind, werden in Strings bei unveränderten Zielsprachen-Übersetzungen automatisch überprüft.
  - Sprache als abgeschlossen markieren
    
    Markiert eine bestimmte Sprache als abgeschlossen, sobald ihre Übersetzungen zurück synchronisiert wurden.
  - Job als abgeschlossen markieren
    
    Wenn ausgewählt, wird der Job erst nach dem Hochladen der letzten Sprache als abgeschlossen markiert.
Falls angegeben, wählen Sie einen Standardordner aus (nur nach dem Speichern möglich).
Sprach-Mapping 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 sind; zuerst von A-Z (Großbuchstaben) und dann a-z (Kleinbuchstaben).
Klicke auf Speichern.

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

Unterstützt bei der Integration:

TMS-Projektvorlagen
TMS-Workflows
Job-Briefing (nicht anwendbar bei Verwendung der Synchronisierung auf Projektebene)
Job-Fälligkeitsdatum (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 Kontexthinweis-Bereich der TMS CAT Editoren anzuzeigen:
- Aktivieren Sie die Option Laden von externem Content im Phrase CAT Editor erlauben unter dem Abschnitt Zugriff und Sicherheit der TMS-Projekteinstellungen.
- Wählen Sie das Rich-Textformat im Kontexthinweis-Bereich aus.
Benutzerdefinierte Metadaten in unterstützten Dateiformaten:
- .XLSX
- .CSV
- .XLIFF 2.0

Überwachung von Aktualisierungen der Zielsprachen in Strings mittels APE

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 ein neues Projekt erstellen aus.

Damit kann das Online-Repository auf Aktualisierungen der Zielsprache in Strings überwacht werden.
Wähle im Bereich Automatisierungen des APE-Setups die Option Zielaktualisierungen, die in der Remote-Entität vorgenommen werden, werden automatisch im Translation Memory gespeichert 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.

Key-Löschverhalten bei APE

Das Löschen eines Keys in Strings, nachdem dieser 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 kontinuierliches Projekt 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 jedes Mal ein neues Projekt erstellen 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.

Fehlerbehebung bei Job Sync

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 `NMTOKEN` in TMS-Jobs	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: Ignoriere die Segmente. Entferne die Keys aus dem Strings-Job und importiere die Ausgangssprache erneut aus dem Online-Repository.
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: Füge dem Job einen neuen Key hinzu oder aktualisiere einen vorhandenen Key des Jobs Ändere das Fälligkeitsdatum des Jobs in Strings
	Fehler `429 Zu viele Anforderungen` (Strings API-Limit)	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	Key zum Strings-Job hinzufügen und Job aus dem Online-Repository in TMS erneut importieren
Fehler „Could not authenticate“ tritt beim Versuch auf, Jobs zu importieren/exportieren.	Abgelaufenes oder widerrufenes Zugriffstoken auf dem automatisch erstellten „created by Phrase Strings“-Konnektor	Erstellen Sie einen neuen Phrase Strings-Konnektor in TMS, verknüpfen Sie vorhandene APCs erneut mit dem neuen Konnektor und starten Sie den Monitor.