Translation Service

Warum es existiert

Die Plattform benötigt eine mehrsprachige Inhaltsauslieferung, ohne das zugrunde liegende Inhaltsmodell zu duplizieren oder aufzuspalten. Die Übersetzungsunterstützung erstellt sprachspezifische Dokumentvarianten, die mit ihren Quelldokumenten verknüpft sind, während das ursprüngliche Schema und die Inhaltsstruktur erhalten bleiben.

Verwenden Sie dies, wenn

• eine oder mehrere Komponenten in mehrere Sprachen übersetzt werden sollen
• den Fortschritt eines Massenübersetzungsauftrags nachverfolgen
• fehlgeschlagene Übersetzungen erneut ausführen
• maschinell erzeugte Übersetzungen manuell korrigieren
• übersetzte Inhalte in einer Dokumentations- oder Website-Anwendung lesen
• sprachspezifische Dokumentansichten im CMS erstellen

Was enthalten ist

• gebündelte Komponenten- und Sprachauswahl im CMS
• asynchrone Übersetzungsaufträge mit Fortschrittsverfolgung
• durch TensorZero unterstützte Dokumentübersetzung
• automatisches Überspringen bereits aktueller Übersetzungen
• Deduplizierung identischer aktiver Übersetzungsaufträge
• Wiederherstellung des Fortschritts aktiver Aufträge nach der Navigation im CMS
• Wiederholungssteuerung für fehlgeschlagene Übersetzungen
• dauerhafte Zielsprachenpräferenzen
• manuelle Übersetzungskorrektur über den Patch-Endpunkt
• sprachsensitive Dokumentabfrage
• Quellen-Hashes zur Erkennung veralteter Übersetzungen
• übersetzungsbewusste Datenbankspalten und -indizes

Kernworkflow

1. Öffnen Sie die Seite Components und wählen Sie Zur Übersetzung senden.
2. Wählen Sie eine oder mehrere Komponenten und Zielsprachen aus.
3. Prüfen Sie die geschätzte Anzahl der Übersetzungen und stellen Sie die Charge in die Warteschlange.
4. Der Übersetzungsmanager lädt die veröffentlichten Quelldokumente und überspringt Übersetzungen, deren Quellen-Hash bereits aktuell ist.
5. Verbleibende Übersetzungen werden asynchron über TensorZero verarbeitet.
6. Überwachen Sie im CMS Übersetzungen in der Warteschlange sowie abgeschlossene, übersprungene und fehlgeschlagene Übersetzungen.
7. Wiederholen Sie fehlgeschlagene Übersetzungen bei Bedarf.
8. Korrigieren Sie übersetzte Inhalte manuell, wenn maschinell erzeugte Ergebnisse angepasst werden müssen.
9. Lesen Sie übersetzte Varianten über sprachbewusste Schema- und Dokument-APIs.

Übersetzungsaufträge

Das Einreichen einer Charge erstellt einen Übersetzungsauftrag. Ein Auftrag protokolliert:

• ausgewählte Komponenten und Sprachen
• verarbeitete Quelldokumente
• geplante Übersetzungen
• Übersetzungen, die übersprungen wurden, weil sie bereits aktuell sind
• abgeschlossene Übersetzungen
• fehlgeschlagene Übersetzungen
• aktuellen Auftragsstatus

Das Einreichen derselben Auswahl, solange ein gleichwertiger Auftrag aktiv ist, stellt die Verbindung zum vorhandenen Auftrag wieder her, anstatt doppelte Arbeit zu erzeugen.

Das CMS speichert die Kennung des aktiven Auftrags lokal, damit der Fortschritt nach einer Navigation wiederhergestellt werden kann. Der Status von Übersetzungsaufträgen wird derzeit vom Übersetzungsmanager im Speicher gehalten und beim Neustart des Dienstes gelöscht. Stellen Sie den Dienst als einzelne Instanz bereit oder verwenden Sie Sticky Routing, damit Auftragseinreichungen und Statusanfragen denselben Prozess erreichen.

Erkennung veralteter Übersetzungen

Jedes übersetzte Dokument speichert einen Hash des veröffentlichten Inhalts des Quelldokuments zum Zeitpunkt der Übersetzung.

Wenn eine weitere Übersetzungscharge eingereicht wird:

• Übereinstimmende Hashes zeigen an, dass die Übersetzung aktuell ist und übersprungen werden kann
• Unterschiedliche Hashes zeigen an, dass sich die Quelle geändert hat und die Übersetzung neu erstellt werden sollte

Dadurch kann die Massenübersetzung sicher wiederholt ausgeführt werden, ohne unveränderte Inhalte erneut zu übersetzen.

API-Endpunkte

• POST /translation — Übersetzungen für eine oder mehrere Komponenten in die Warteschlange stellen
• GET /translation-jobs/{job_id} — Status und Fortschritt eines Übersetzungsauftrags abrufen
• PATCH /translations — übersetzte Inhalte manuell korrigieren

Systemoberflächen

• CMS-Dialog für Massenübersetzungen
• CMS-Steuerelemente für Auftragsstatus und Wiederherstellung
• API des Übersetzungsmanagers und Hintergrundprozesse
• TensorZero-Übersetzungsintegration
• sprachspezifische Dokumentansichten im CMS
• sprachbewusstes Laden von Inhalten in der Docs-App
• Übersetzungspersistenz und Verfolgung von Quellen-Hashes