Contentful (TMS)

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

Verfügbar für

Business- und Enterprise-Pläne (nicht verfügbar für LSP-Pläne)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Enterprise-Plan (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Tipp

Für Informationen zur Contentful-Integration in Phrase Strings siehe Contentful (Strings).

Contentful bietet eine headless Content-Management-Infrastruktur, um Inhalte zu erstellen, zu verwalten und auf jede Plattform oder jedes Gerät zu verteilen. Phrase integriert sich auf zwei Arten mit Contentful:

Über einen dedizierten Contentful-Konnektor (2.0, Entry-Level, Field-Level)

Der Contentful 2.0-Konnektor unterstützt derzeit die Authentifizierung nur über das US-Rechenzentrum.
Über das Contentful Marketplace-Plugin für ein angepasstes Erlebnis

Hinweis

Der Konnektor unterstützt nicht die Übersetzung von JSON-Objekten.

Unterstützte Lokalisierungsmethoden

Contentful unterstützt mehrere Lokalisierungsmethoden. Siehe Contentful-Dokumentation für deren detaillierte Beschreibung.

Der Contentful 2.0-Konnektor ist die aktuelle und bevorzugte Integration, die die Lokalisierung auf Feldebene unterstützt. Er bietet auch:

Mehrere Leerzeichen
Umgebungsalias
Vorschau-URL-Setup
Referenzimport
Tag-basierte Inhaltsfilterung
Live-Vorschau-Konfiguration

Entry-Level-Lokalisierung (Vermächtnis)

Verwenden Sie Contentful (Entry-Level) Konnektor.

Der Einstiegskonnektor funktioniert nur mit Inhaltstypen, die lokalisierte Referenzfelder haben (z. B. ein Referenz-Feld namens Lokalisierte, das für die Lokalisierung aktiviert ist).

Feldbasierte Lokalisierung (Vermächtnis)

Verwende den Contentful (Feldbasiert)-Konnektor.

Der feldbasierte Konnektor funktioniert nur mit Inhaltstypen, die ein übersetzbares Feld haben (z. B. entweder Text oder Rich Text-Feld mit aktivierter Lokalisierung) und optional Medienassets. Es importiert referenzierte Einträge und deren übersetzbare Felder (wenn Referenzfelder lokalisiert sind).

Hinweis

Die Legacy-Konnektoren werden nicht mehr aktiv gewartet, bleiben jedoch funktionsfähig.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können Dateien direkt aus einem Online-Repository zu Projekten hinzufügen. Inhalt ist durch die Eintrags-ID durchsuchbar.
Richten Sie das Submitter-Portal ein, damit Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können. Inhalt ist durch die Eintrags-ID durchsuchbar.
Verwende die automatisierte Projekterstellung (APC), um neue Projekte automatisch zu erstellen, wenn eine Änderung der Inhaltsgröße bei überwachten Dokumenten oder einem Ordner festgestellt wird.

Anwendungsfälle für die Anwendung:

Inhaltsredakteure können direkt einen Eintrag zur Lokalisierung aus Contentful einreichen. Dies ermöglicht es Inhaltsredakteuren oder Managern, die volle Kontrolle über den Lokalisierungsfluss zu haben und Statusaktualisierungen in Echtzeit beim Anzeigen eines Eintrags zu erhalten.

Sobald der Eintrag finalisiert ist:
- Wählen Sie die gewünschten Zielsprache für die Lokalisierung aus.
- Reichen Sie nur den Eintrag mit den ausgewählten Sprachen an Phrase TMS ein oder verwenden Sie die Feldauswahl-Registerkarte, um Felder auszuwählen.
  - Wenn keine Felder ausgewählt sind, werden alle lokalisierbaren Felder zur Übersetzung eingereicht.
  - Wenn ein nicht lokalisierbares Feld ausgewählt ist, wird dieses Feld dennoch nicht zur Übersetzung eingereicht. Nur lokalisierbare Felder werden eingereicht.
  - Wenn nur einige lokalisierbare Felder ausgewählt sind, werden nur diese Felder zur Übersetzung eingereicht.
- Basierend auf den APC-Einstellungen werden Jobs automatisch aus dem eingereichten Content erstellt. Während der APC-Durchläufe werden nur Einträge im eingereicht Status für die Job-Erstellung ausgewählt.
- Sobald Jobs aus einem eingereichten Eintrag erstellt werden, ändert sich der Status zu in Bearbeitung. Wenn die Übersetzungen zurück zu Contentful gepusht werden, ändert sich der Status zu abgeschlossen.
- Bereits übersetzte Einträge können nach Änderungen im Originaltext erneut eingereicht werden.
Content-Redakteure können den Startbildschirm von Phrase TMS verwenden, um:
- Einträge in großen Mengen einzureichen.
- Einzelne Zielsprache beim Bulk-Einreichen anzugeben.
- Einen Überblick über aktive Übersetzungsjobs zu haben.

Contentful Einstellungen

Beim Arbeiten mit der Phrase TMS-Anwendung:

Laden Sie die Phrase TMS Anwendung aus dem Marktplatz herunter.
Installieren Sie die Anwendung im aktuellen aktiven Raum und wählen Sie die Inhaltsmodelle aus, in denen die Anwendung installiert werden muss.
Geben Sie das Phrase TMS Auth-Token ein, das beim Erstellen des Konnektors innerhalb von Phrase TMS erhalten wurde.
Klicken Sie auf Installieren.

Optional - App starten (von Contentful veraltet)

Wenn Sie die Workflow-Unterstützung über die Launch App von Contentful verwenden, befolgen Sie diese Schritte:

Installieren Sie die Launch Anwendung von Contentful in einem oder mehreren Räumen.

Hinweis

Es kann nur ein Workflow pro Raum erstellt werden. Wenn innerhalb eines Contentful-Raums unterschiedliche Ansätze für Inhaltstypen erforderlich sind, wenden Sie sich an den zuständigen Customer Success Manager.
Richten Sie den erforderlichen Lokalisierungs-Workflow ein.
Wählen Sie den Inhaltstyp oder die Inhaltstypen aus, die dem beschriebenen Workflow folgen.

Wenn Workflows in einem Konnektor festgelegt sind, erstellt die Automatisierte Projekt Erstellung (APE) automatisch neue Projekte, wenn eine Änderung in den Workflow-Schritten für überwachte Artikel oder Inhaltstypen erkannt wird.

Eingereichte Aufträge können storniert werden, sodass Inhalte nach Änderungen erneut eingereicht werden können. Diese Aufträge existieren weiterhin in Phrase und müssen von einem Projektmanager gelöscht werden.

Phrase TMS-Einstellungen (Contentful 2.0)

Hinweis

Die Contentful Launch App wird im 2.0-Konnektor nicht unterstützt.

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 öffnet sich.
Ändern Sie den Typ in Contentful 2.0.
Geben Sie einen Namen für den Konnektor an.
Klicken Sie auf Mit Contentful 2.0 verbinden.

Das Anmeldefenster von Contentful öffnet sich.
Geben Sie die Anmeldedaten ein und klicken Sie auf Einloggen (oder verwenden Sie alternative Anmeldemethoden). Das Anmeldefenster schließt sich und Verbunden wird angezeigt.
Wählen Sie optional das Kontrollkästchen Phrase Contentful App aus, wenn Sie den Konnektor mit der App verwenden.
1. Klicken Sie auf Token generieren.
  
  Das Fenster Contentful-Token generieren öffnet sich.
2. Klicken Sie auf Token generieren.
  
  Ein Token wird generiert, das in die Zwischenablage oder in eine Textdatei kopiert werden sollte. Stellen Sie sicher, dass das Token vor dem Schließen des Fensters kopiert wird, da es danach nicht mehr sichtbar ist. Dieses Token wird verwendet, wenn die Verbindung zur App hergestellt wird.
3. Schließen Sie das Fenster und Token generiert wird angezeigt.
Wenn Contentful-Tags verwendet werden, um übersetzbare Inhalte zu identifizieren, geben Sie eine Tag-ID ein und drücken Sie Enter.

Die ID wird angezeigt und es können weitere hinzugefügt werden.
- Wählen Sie die Listungsstrategie aus.
  - Mit allen Tags
    
    Zeigt Inhalte innerhalb von Contentful mit allen aufgelisteten Tags an.
  - Mit mindestens einem Tag
    
    Zeigt Inhalte von Contentful mit mindestens einem der aufgelisteten Tags an.
Falls erforderlich, wählen Sie Assets einbeziehen aus.
Falls erforderlich, wählen Sie Referenzierte Einträge einbeziehen (verschachtelte Inhalte) aus.

Die Einstellungen für referenzierte Einträge werden angezeigt. Wenden Sie die gewünschten Filter an, um eine granularere Kontrolle darüber zu erhalten, wie das System durch Inhaltsbeziehungen navigiert.
- Lege die Importtiefe für verknüpfte Einträge fest.
  
  Begrenzt, wie weit Phrase Referenzen während des Imports folgt.
  
  Der Standardwert beträgt 10.000. Falls erforderlich, wählen Sie andere Werte aus oder geben Sie einen benutzerdefinierten Ganzzahlwert an.
- Art des Inhalts
  
  Wählen Sie aus, ob Sie anhalten oder Einträge folgen möchten, deren Inhaltstyp mit der angegebenen Liste übereinstimmt.
- Übergeordnete Inhaltstypen
  
  Schließen Sie Einträge aus, deren übergeordneter Inhaltstyp mit der angegebenen Liste übereinstimmt.
- Tags
  
  Wählen Sie aus, ob Sie anhalten oder Einträge folgen möchten, die eines der angegebenen Inhaltstags haben.
- Fields-IDs
  
  Wählen Sie aus, ob Sie anhalten oder Einträge folgen möchten, die von den angegebenen Feld-IDs referenziert werden.
Falls erforderlich, wählen Sie Taxonomie einbeziehen aus.

Das Feld Contentful Organisations-ID wird angezeigt. Geben Sie einen Wert ein, um die Taxonomieeinstellung zu aktivieren.
- Wenn ausgewählt, ruft der Konnektor Taxonomien von Contentful ab und fügt sie in die .XLIFF-Datei ein. Das Kontexthinweis Fenster des CAT Editors listet die Contentful-Taxonomiewerte für jedes Segment auf.
- Wenn Metadaten zur Taxonomie nicht verfügbar sind oder der Konnektor nicht damit konfiguriert ist, wird das Kontexthinweis Fenster einfach weggelassen.
- Wenn ein Projekt keine Kontextinformationen für Funktionen/Bildschirme benötigt, wird empfohlen, die Taxonomie deaktiviert zu lassen, um die Leistung beim .XLIFF-Export zu optimieren.
Falls erforderlich, wählen Sie Alias folgen aus.

Der Alias wird für alle APC-Überwachungen und Job-Reimporte/-Exporte verwendet. Wenn das Alias-Ziel in Zukunft geändert wird, überwacht APC den Inhalt im neuen Ziel und Jobs werden von/dem neuen Alias-Ziel reimportiert/exportiert.
- Deaktiviert (Standard und empfohlen)
  
  APCs und erstellte Jobs sind an die Umgebung gebunden, auf die das Alias zum Zeitpunkt der Erstellung des Jobs/APC verwiesen hat. APCs überwachen nur diese Umgebung und diesen Inhalt; Jobs werden dorthin exportiert und reimportiert.
- Aktiviert
  
  APCs und erstellte Jobs sind an das Alias selbst gebunden. APCs überwachen nur dieses Alias und diesen Inhalt; Jobs werden dorthin exportiert und reimportiert.
  
  Wenn das Alias-Ziel geändert wird, überwachen APCs das neue Alias-Ziel (Umgebung); Jobs werden jetzt dorthin exportiert und reimportiert.
Falls erforderlich, geben Sie die Vorschau-URL an.

Dies ist die URL-Vorlage, die zu den gerenderten Inhalten von Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebung-ID
- {entry.id}: Eintrag-ID
- {space_id}: Space-ID
Eine URL-Vorlage könnte so aussehen:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

Hinweis

Die URL muss zu einer bereitgestellten Anwendung führen, die den Contentful-Inhalt rendert. Um die Live-Vorschau zu verwenden, ersetzen Sie contentfulapp.tld in der URL-Vorlage durch die tatsächliche Domain der Anwendung.

Siehe die Contentful-Dokumentation für weitere Informationen zur Einrichtung der Inhaltsvorschau.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um die Sprache in der URL zu verwenden, geben Sie einen festen Wert an und erstellen Sie mehrere Konnektorinstanzen.
Falls erforderlich, geben Sie ContentIDs an, die beim Import in Phrase weggelassen werden sollen.
Geben Sie Space ID und Token für Space-Vorschau-Token-Karte an (erforderlich).

Die Vorschau-API benötigt ein Contentful-Zugriffstoken mit dem Namen Content Preview API – Zugriffstoken, das in den API-Einstellungen des Contentful-Raums konfiguriert werden sollte.

Die Contentful 2.0-Integration verwendet diese API zum Importieren von Inhalten und Überwachen von Änderungen (APC).
- Wählen Sie jeden Raum und jede Umgebung aus, um von Contentful zu überwachen/importieren.
- Setup und Zugriff werden innerhalb von Contentful selbst verwaltet.
Klicke auf Speichern.

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

Phrase TMS-Einstellungen

Wichtig

Wenn Sie von einer benutzerdefinierten Domain (z. B. mydomain.phrase.jp) zugreifen, öffnen Sie ein Inkognito-Browserfenster und melden Sie sich über cloud.memsource.com oder us.cloud.memsource.com an, um die für die Erstellung oder Speicherung des Konnektors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann auf den Konnektor über die benutzerdefinierte Domain zugegriffen werden.

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 öffnet sich.
Ändern Sie den Typ in entweder Contentful (Entry-Level) oder Contentful (Field-Level) und geben Sie einen Namen für den Konnektor an.
Wählen Sie optional das Kontrollkästchen Phrase Contentful App aus, wenn Sie den Konnektor mit der App verwenden.
- Contentful App-Token
  
  Generieren Sie ein App-Token, das in die Phrase TMS Contentful-Anwendung eingegeben werden soll. Speichern Sie den Konnektor, nachdem Sie das Token generiert und in die Contentful-App kopiert haben.
Hinweis

Nach dem Speichern kann das Token nicht mehr innerhalb von Contentful geändert werden. Um es zu aktualisieren, widerrufen Sie das Token aus der Konnektor-Konfiguration in Phrase TMS und generieren Sie ein neues.
Konfigurieren Sie sprachunabhängige Einstellungen.
- Ausgangssprache
  
  Wählen Sie eine Ausgangssprache aus, um die standardmäßige Contentful-Sprache zu überschreiben. Der Konnektor wird dann Inhalte aus der im Konnektor konfigurierten Sprache abrufen.
  
  Beispiel:
  
  Wenn EN-US als Standardsprache in Contentful festgelegt ist, aber DE-DE als Ausgangssprache für die Lokalisierung in einem bestimmten Raum oder Inhaltsmodell erforderlich ist, kann die Konfiguration so angepasst werden, dass der Raum (Remote-Ordner) Inhalte aus DE-DE anstelle von EN-US abruft.
Hinweis

Nicht anwendbar, wenn die Anwendung verwendet wird.
Wählen Sie aus, wie verschachtelte Inhalte durch Eintragsimportmodus verarbeitet werden sollen. Inhalte können ein Referenzfeld verwenden, um auf andere Inhalte zu verweisen, wodurch eine Hierarchie von Entitäten erstellt wird.

Hinweis

Nicht anwendbar, wenn die Anwendung verwendet wird.
- Contentful (Eintragsniveau)
  
  Der Eintragskonnektor durchläuft automatisch die gesamte Hierarchie der verschachtelten Inhalte.
- Contentful (Feldniveau)
  
  Wählen Sie aus, wie der Feldkonnektor verschachtelte Inhalte importieren soll.
  - Nur ausgewählter Eintrag
    
    Inhalte, die beim Hinzufügen aus dem Repository ausdrücklich ausgewählt werden, werden importiert.
    
    Änderungen, die von APC erkannt werden, werden zur Übersetzung importiert.
  - Referenzierte Einträge importieren
    
    Der Konnektor durchläuft die gesamte Hierarchie der verschachtelten Inhalte und importiert alle übersetzbaren Felder zur Übersetzung.
Erstellen Sie eine durch Kommas getrennte Liste in Übersetzbare Felder auslassen, um Felder, die auf Lokalisierung dieses Feldes aktivieren überprüft werden, vom Import in Phrase TMS auszuschließen. Verwenden Sie die folgende Struktur: contentTypeID:fieldID.
- Wählen Sie Ausgelassene Felder leer lassen, wenn die aufgeführten Felder leer gelassen werden sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
- Wählen Sie Quelle in Ziel kopieren, wenn die aufgeführten Felder Quellwerte enthalten sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
Wählen Sie Fallback-Sprache verwenden, wenn Daten für ein bestimmtes Feld in der Ausgangssprache fehlen.

Wählen Sie eine Fallback-Sprache der Ausgangssprache aus der Dropdown-Liste, falls erforderlich. Diese Sprachlokalisierung wird im Falle fehlender Daten verwendet.

Hinweis

Es besteht keine Beziehung zwischen der Contentful-Fallback-Sprache und dieser Einstellung.
Falls erforderlich, geben Sie die Live-Vorschau-URL (BETA) an.

Dies ist die URL-Vorlage, die zu den gerenderten Inhalten von Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebung-ID
- {entry.sys.id}: Eintrag-ID
- {space_id}: Space-ID
Eine URL-Vorlage könnte so aussehen:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

Hinweis

Die URL muss zu einer bereitgestellten Anwendung führen, die den Contentful-Inhalt rendert. Um die Live-Vorschau zu verwenden, ersetzen Sie contentfulapp.tld in der URL-Vorlage durch die tatsächliche Domain der Anwendung.

Siehe die Contentful-Dokumentation für weitere Informationen zur Einrichtung der Inhaltsvorschau.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um die Sprache in der URL zu verwenden, geben Sie einen festen Wert an und erstellen Sie mehrere Konnektorinstanzen.
Wenn das Protokollieren von Debug-Informationen vom technischen Support-Team angefordert wird, wählen Sie Debug-Informationen protokollieren.
Klicken Sie auf Mit Contentful verbinden.

Ein Häkchen erscheint in der Konnektor-Setup, wenn die Verbindung erfolgreich war. Ein rotes Ausrufezeichen wird angezeigt, wenn nicht. Bewege die Maus über das Symbol, um weitere Details anzuzeigen.
Contentful (Einsteiger-Level) nur:

Legen Sie die Ausgangssprache fest.

Hinweis

Diese Sprache sollte mit der Standard-Sprache des Contentful-Raums übereinstimmen, die in den Locale-Einstellungen von Contentful konfiguriert ist.
Klicke auf Speichern.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.
Optional können Sie den Konnektor bearbeiten, um Contentful-Workflows auszuwählen.
- Artikel übersetzen von:
  
  Der Konnektor überwacht Artikel in der ausgewählten Phase (z. B. Übersetzen). Der Autor kann dieses Label auf Artikel anwenden, wenn diese übersetzt werden sollen.
Beim Import von Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor bringt den Workflow in die ausgewählte Phase (z.B. Übersetzung in Bearbeitung), wenn die Quellartikel heruntergeladen werden.
Beim Export nach Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor setzt die Workflow-Phase der Quellartikel auf die ausgewählte Phase (z.B. Übersetzungen abgeschlossen), wenn die Übersetzung exportiert wird.
Hinweis

Die Unterstützung für Workflows wurde von Contentful am 1. Juni 2023 eingestellt. Die fortgesetzte Nutzung wird nicht unterstützt.