Integrationen

Tridion Docs (TMS)

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

Verfügbar für

  • Enterprise-Plan (nicht für LSP-Pläne verfügbar)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Tridion Docs ist ein Component Content Management System (CCMS), das zum Erstellen, Verwalten und Veröffentlichen von strukturierten DITA-XML-Inhalten verwendet wird. Der Connector ermöglicht eine optimierte Lokalisierung durch die Integration von Phrase TMS in eine Tridion Docs-Instanz mittels sicherem OIDC-API-Zugriff und FTP-Dateiaustausch. Ein Hintergrund-Job-Scheduler und eine verbesserte Wiederholungslogik erhöhen die Zuverlässigkeit.

Content-Editoren können Phrase TMS verwenden, um:

  • Einträge in großen Mengen zu übermitteln.

  • Einzelne Zielsprachen bei der Massenübermittlung anzugeben.

  • Einen Überblick über aktive Übersetzungsaufträge zu erhalten.

Einschränkungen:

  • Unterstützt nur DITA-Topics und allgemeine XML-Inhalte.

  • Benutzerdefinierte Tridion-Metadaten (z. B. Versionen, Workflow-Status) werden nicht synchronisiert, sofern sie nicht konfiguriert sind.

  • Direkte In-Context-Vorschau und Live-Bearbeitung werden von der Tridion-API nicht unterstützt.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

  • Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen. Inhalte sind in der exportierten Datei über die GUID durchsuchbar.

  • Richten Sie das Submitter-Portal ein, damit Submitter Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können. Inhalte sind in der exportierten Datei über die GUID durchsuchbar.

  • Nutze die automatisierte Projekterstellung (APC), damit neue Projekte automatisch erstellt werden, sobald eine neue ZIP-Datei im überwachten Ordner erkannt wird.

    • Tridion Docs-Übersetzungsaufträge werden nur importiert, wenn ihr Quell-Gebietsschema mit dem im TMS-Projekt oder der APC konfigurierten Quell-Gebietsschema übereinstimmt.

  • Importieren Sie DITA-XML-Topics direkt aus einem Tridion Docs-Repository über sicheres FTP in Phrase TMS.

Authentifizierung

Der Connector verwendet ein hybrides Authentifizierungsmodell:

  • FTP-Anmeldedaten für die Dateiübertragung (Import von DITA-XML-Dateien).

  • OIDC (OAuth 2.0) für den sicheren Zugriff auf Tridion Docs-APIs.

  • Der FTP-Server muss Verbindungen von den IP-Adressen des Phrase-Servers akzeptieren. Die aktuelle Liste finden Sie unter Phrase Servers IP Addresses.

Phrase TMS-Einstellungen

  1. Scrolle auf der Seite Einstellungen Setup_gear.png nach unten zum Abschnitt Integrationen.

  2. Klicke auf Konnektoren.

    Die Seite Konnektoren wird geöffnet.

  3. Klicke auf New connector.

    Die Seite Create connector wird geöffnet.

  4. Ändere den Type auf Tridion Docs und gib einen Namen für den Connector an.

  5. Fülle die erforderlichen Felder aus:

    Feld

    Beschreibung

    FTP-Host

    Hostname des Tridion Docs FTP-Servers

    FTP-Port

    Portnummer (21 oder 22)

    FTP-Benutzername

    FTP-Benutzerkonto

    FTP-Passwort

    Passwort für das FTP-Konto

    Pfad zum Exportordner von Tridion Docs

    Pfad zu dem Ordner auf dem FTP-Server, an den Tridion Docs Dateien sendet, die übersetzt werden müssen.

    FTP-Archivordner

    Pfad zu dem Ordner auf dem FTP-Server, in den der ZIP-Ordner mit den Quelldateien verschoben werden soll, sobald er von Phrase TMS zur Übersetzung abgeholt wurde.

    Status nach der Übersetzung

    Status, der lokalisierten Inhalten zugewiesen werden soll, nachdem sie von Phrase TMS an Tridion Docs zurückgegeben wurden.

    OIDC-Client-ID

    Bereitgestellt vom Tridion Docs-Administrator,

    OIDC-Client-Secret

    Zugehöriges Secret für die Client-ID

    Zugriffstoken-Endpunkt

    Hostname der Tridion Docs REST-API, d. h. subdomain.yourdomain.com

    • Konfigurieren Sie optional die Sprachzuordnung, falls Sie benutzerdefinierte Gebietsschemas in Tridion Docs verwenden.

  6. Klicke auf Mit Tridion Docs verbinden.

    Es wird ein Häkchen angezeigt, wenn die Verbindung erfolgreich war. Ein rotes Ausrufezeichen wird angezeigt, wenn nicht. Bewege die Maus über das Symbol, um weitere Details anzuzeigen.

  7. Klicke auf Speichern.

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

Einen Connector löschen

So löschen Sie einen Connector:

  1. Wähle auf der Seite Integrationen den zu löschenden Connector aus.

  2. Klicke auf Löschen.

    Das Fenster Connector löschen wird geöffnet.

  3. Gib „delete“ ein und klicke auf Löschen.

    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 Aufträgen in einem Projekt verknüpft ist, einschließlich Aufträgen, die sich im Papierkorb befinden. Der Versuch, einen solchen Connector zu löschen, führt zu der Fehlermeldung „Failed to delete connector“.

Lösung: Öffne das mit dem Connector verknüpfte Projekt und schließe alle verbleibenden Aufträge ab oder lösche sie. Gehe zu Einstellungen/Papierkorb und leere ihn, um alle noch mit dem Connector verknüpften Aufträge zu entfernen. Versuche erneut, den Connector zu löschen.

Falls die Verbindung fehlschlägt:

  • Stelle sicher, dass deine FTP-Firewall Datenverkehr aus den Phrase-IP-Bereichen zulässt.

  • Überprüfe die OIDC-Anmeldedaten und den Token-Endpunkt erneut.

  • Nutze eine private Browsersitzung, um die domänenbasierte Authentifizierung zu testen.

Für Hilfe bei der Konfiguration des Connectors oder der Implementierung fortgeschrittener Workflows kontaktiere den Phrase-Support oder deinen Customer Success Manager.

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.