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 über die Contentful-Integration in Phrase Strings, siehe Contentful (Strings).

Contentful bietet eine Headless-Content-Management-Infrastruktur, um Content 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, Eintrag-Level, Feld-Level)

Der Contentful 2.0-Konnektor unterstützt derzeit die Authentifizierung nur über das US-Rechenzentrum.
Über das Contentful Marketplace-Plug-in für eine angepasste Erfahrung

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 eine Lokalisierung auf Feldebene unterstützt. Er bietet außerdem:

Mehrere Leerzeichen
Umgebungs-Aliase
Vorschau-URL-Setup
Referenz-importieren
Tag-basierte Content-Filterung
Live-Vorschau-Konfiguration

Eintrag-Level-Lokalisierung (Vermächtnis)

Verwenden Sie den Contentful (Eintrags-Ebene) Konnektor.

Der Konnektor auf Eintrags-Ebene funktioniert nur mit Content-Typen, die lokalisierte Referenzfelder haben (z. B. ein Referenz-Feld namens Localized, das für die Lokalisierung aktiviert ist).

Lokalisierung auf Feld-Ebene (Vermächtnis)

Verwenden Sie den Contentful (Feld-Ebene) Konnektor.

Der Konnektor auf Feld-Ebene funktioniert nur mit Content-Typen, die ein übersetzbares Feld (z. B. entweder ein Text- oder Rich Text-Feld mit aktivierter Lokalisierung) und optional Media Assets haben. Er importiert referenzierte Einträge und deren übersetzbare Felder (wenn Referenzfelder lokalisiert sind).

Wichtig

Die Vermächtnis-Konnektoren werden am 30. November 2026 eingestellt. Neue Instanzen dieser Konnektoren können bis zum 17. August 2026 erstellt werden. Migrieren Sie vor dem Einstellungsdatum zum neuen Konnektor.

Weitere Informationen finden Sie unter Vermächtnis-Konnektor-Einstellung für einen vollständigen Migrationsleitfaden.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen. Content ist nach Eintrag-ID durchsuchbar.
Richten Sie das Submitter Portal ein, damit Submitter direkt aus dem Online-Repository Dateien zu Anfragen hinzufügen können. Content ist nach Eintrag-ID durchsuchbar.
Verwenden Sie die Automatisierte Projekterstellung (APE), um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dokumenten oder einem Ordner eine Änderung der Content-Größe festgestellt wird.

Anwendungsfälle für die Anwendung:

Content-Editoren können direkt aus Contentful heraus einen Eintrag zur Lokalisierung absenden. Dies ermöglicht es Content-Editoren oder Managern, die volle Kontrolle über den Lokalisierungs-Workflow zu haben und Status-Updates direkt bei der Ansicht eines Eintrags zu erhalten.

Sobald der Eintrag fertiggestellt wurde:
- Wählen Sie die gewünschten Zielsprachen für die Lokalisierung aus.
- Senden Sie nur den Eintrag mit den ausgewählten Sprachen an Phrase TMS ab oder verwenden Sie den Tab Feldauswahl, um Felder auszuwählen.
  - Wenn keine Felder ausgewählt sind, werden alle lokalisierbaren Felder zur Übersetzung übermittelt.
  - Wenn ein nicht lokalisierbares Feld ausgewählt ist, wird dieses Feld dennoch nicht zur Übersetzung übermittelt. Nur lokalisierbare Felder werden übermittelt.
  - Wenn nur einige lokalisierbare Felder ausgewählt sind, werden nur diese Felder zur Übersetzung übermittelt.
- Basierend auf den APE-Einstellungen werden Jobs automatisch aus dem übermittelten Content erstellt. Während APE-Läufen werden nur Einträge im Status übermittelt für die Job-Erstellung berücksichtigt.
- Sobald Jobs aus einem übermittelten Eintrag erstellt wurden, ändert sich der Status auf in Bearbeitung. Wenn die Übersetzungen zurück an Contentful übertragen werden, ändert sich der Status auf abgeschlossen.
- Zuvor übersetzte Einträge können nach Änderungen am Originaltext erneut übermittelt werden.
Content-Editoren können die Phrase-Startseite verwenden, um:
- Einträge gesammelt absenden.
- Einzelne Zielsprachen beim gesammelten Absenden angeben.
- Einen Überblick über aktive Übersetzungs-Jobs haben.

Contentful-Einstellungen

Bei der Arbeit mit der Phrase-Anwendung:

Laden Sie die Phrase-Anwendung vom Marketplace herunter.
Installieren Sie die Anwendung im aktuell aktiven Space und wählen Sie die Content-Modelle aus, für die die Anwendung installiert werden muss.
Geben Sie das Phrase-Authentifizierungs-Token ein, das Sie beim Erstellen des Konnektors innerhalb von Phrase erhalten haben.
Klicken Sie auf Installieren.

Optional – App starten (von Contentful als veraltet markiert)

Wenn Sie 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 Leerzeichen.

Hinweis

Pro Leerzeichen kann nur ein Workflow erstellt werden. Wenn innerhalb eines Contentful-Leerzeichens unterschiedliche Ansätze für Content-Typen erforderlich sind, wenden Sie sich an den zuständigen Kunde Success Manager.
Legen Sie den erforderlichen Lokalisierungs-Workflow fest.
Wählen Sie den Content-Typ oder die Content-Typen aus, die dem beschriebenen Workflow folgen.

Wenn Workflows in einem Konnektor festgelegt sind, erstellt die automatisierte APE automatisch neue Projekte, wenn eine Änderung in den Workflow-Schritten für überwachte Artikel oder Content-Typen erkannt wird.

Übermittelte Aufträge können storniert werden, sodass Content nach dem Ändern erneut übermittelt werden kann. Diese Aufträge existieren weiterhin in Phrase und müssen von einem Projektmanagement 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 Neuen Konnektor erstellen.

Die Seite Konnektor erstellen wird geöffnet.
Ändern Sie den Typ auf Contentful 2.0.
Geben Sie einen Namen für den Konnektor an.
Klicken Sie auf Mit Contentful 2.0 verbinden.

Das Contentful-Anmeldefenster wird geöffnet.
Geben Sie Ihre Anmeldedaten ein und klicken Sie auf Anmelden (oder verwenden Sie alternative Anmeldemethoden). Das Anmeldefenster wird geschlossen 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.
  
  Es wird ein Token generiert, das in die Zwischenablage oder eine Textdatei kopiert werden sollte. Stellen Sie sicher, dass das Token kopiert wurde, bevor Sie das Fenster schließen, da es danach nicht mehr sichtbar ist. Dieses Token wird beim Verbinden mit der App verwendet.
3. Schließen Sie das Fenster und Token generiert wird angezeigt.
Wenn Contentful-Tags verwendet werden, um übersetzbaren Content zu identifizieren, geben Sie eine Tag-ID ein und drücken Sie Enter.

Die ID wird angezeigt und weitere können hinzugefügt werden.
- Auflistungsstrategie auswählen
  - Mit allen Tags
    
    Zeigt Content innerhalb von Contentful mit allen aufgelisteten Tags an.
  - Mit mindestens einem Tag
    
    Zeigt Content aus Contentful mit mindestens einem der aufgelisteten Tags an.
Wählen Sie bei Bedarf Assets einschließen aus.
Wählen Sie bei Bedarf Referenzierte Einträge einschließen (verschachtelter Content) aus.

Die Einstellungen für referenzierte Einträge werden angezeigt. Wenden Sie die gewünschten Filter an, um eine genauere Kontrolle darüber zu erhalten, wie das System Content-Beziehungen durchläuft.
- Lege die Importtiefe für verknüpfte Einträge fest.
  
  Begrenzt, wie weit Phrase beim importieren referenzierten Einträgen folgt.
  
  Der Standardwert ist 10.000. Wählen Sie bei Bedarf andere Werte aus oder geben Sie einen individuellen Ganzzahlwert an.
- Art des Inhalts
  
  Wählen Sie aus, ob bei Einträgen, deren Content-Typ mit der angegebenen Liste übereinstimmt, gestoppt oder ob diesen gefolgt werden soll.
- Übergeordnete Inhaltstypen
  
  Einträge ausschließen, deren übergeordnetes Element vom Content-Typ mit der angegebenen Liste übereinstimmt.
- Tags
  
  Wählen Sie aus, ob bei Einträgen mit einem der angegebenen Content-Tags angehalten oder diesen gefolgt werden soll.
- Fields-IDs
  
  Wählen Sie aus, ob bei Einträgen, auf die durch die angegebenen Feld-IDs verwiesen wird, angehalten oder diesen gefolgt werden soll.
Wählen Sie bei Bedarf Include taxonomy aus.

Das Feld Contentful Organization ID wird angezeigt. Geben Sie einen Wert ein, um die Taxonomie-Einstellung zu Aktivieren.
- Wenn diese Option ausgewählt ist, ruft der Konnektor Taxonomien aus Contentful ab und fügt sie in die .XLIFF file ein. Der Bereich Kontexthinweis des CAT Editor listet die Contentful-Taxonomiewerte für jedes Segment auf.
- Wenn keine Taxonomie-Metadaten verfügbar sind oder der Konnektor nicht damit konfiguriert wurde, wird der Bereich Kontexthinweis einfach weggelassen.
- Wenn ein Projekt keinen Feature-/Bildschirmkontext erfordert, wird empfohlen, die Taxonomie deaktiviert zu lassen, um die Leistung beim .XLIFF exportieren zu optimieren.
Wählen Sie bei Bedarf Follow aliases aus.

Der alias wird für die gesamte APE-Überwachung sowie für Job-Reimporte/-Exporte verwendet. Wenn das Zielsprache-Alias in Zukunft geändert wird, überwacht APE den Content in der neuen Zielsprache und Jobs werden aus der/in die neue Zielsprache des Alias reimportiert/exportiert.
- Disabled (Standard und empfohlen)
  
  APEs und erstellte Jobs sind an die Umgebung gebunden, auf die das Alias zum Zeitpunkt der Job-/APE-Erstellung verwies. APEs überwachen nur diese Umgebung und diesen Content; Jobs werden dorthin exportiert und von dort reimportiert.
- Aktiviert
  
  APEs und erstellte Jobs sind an das Alias selbst gebunden. APEs überwachen nur dieses Alias und diesen Content; Jobs werden dorthin exportiert und von dort reimportiert.
  
  Wenn das Zielsprache-Alias geändert wird, überwachen APEs die neue Zielsprache des Alias (Umgebung); Jobs werden nun dorthin exportiert und von dort reimportiert.
Geben Sie bei Bedarf die Preview URL an.

Dies ist die Vorlage für die URL, die zum gerenderten Content aus Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebung-ID
- {entry.id}: Eintrag-ID
- {space_id}: Leerzeichen-ID
Eine URL-Vorlage kann 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-Content rendert. Um die Live-Vorschau zu verwenden, ersetzen Sie contentfulapp.tld in der URL-Vorlage durch den tatsächlichen Fachbereich der Anwendung.

Weitere Informationen zum Einrichten der Content-Vorschau finden Sie in der Contentful-Dokumentation.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um Sprache in der URL zu verwenden, geben Sie einen festen Wert an und erstellen Sie mehrere Konnektor-Instanzen.
Geben Sie bei Bedarf Content-IDs an, die vom importieren in Phrase ausgeschlossen werden sollen.
Geben Sie Leerzeichen-ID und Token für Leerzeichen-Vorschau-Token-Map an (erforderlich).

Die Vorschau-API erfordert ein Contentful-Zugriffstoken namens Content Preview API – access token, das in den API-Einstellungen des Contentful-Leerzeichens konfiguriert werden sollte.

Die Contentful 2.0-Integration verwendet diese API zum importieren von Content und zum Überwachen von Änderungen (APE).
- Wählen Sie jedes Leerzeichen und jede Umgebung aus, die von Contentful überwacht/importiert werden sollen.
- Setup und zugreifen 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 über einen Individuell Fachbereich (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 Authentifizierung anzuwenden, die für das Erstellen oder Speichern der Konnektor erforderlich ist. Nach dem speichern kann auf die Konnektor über den Individuell Fachbereich zugreifen werden.

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

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

Die Seite Konnektor erstellen wird geöffnet.
Ändern Sie den Typ in entweder Contentful (Eintrag-Ebene) oder Contentful (Feld-Ebene) und geben Sie einen Namen für die 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 die 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 in 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 Contentful-Standardsprache zu überschreiben. Der Konnektor zieht dann Content aus der Sprache, die in der Konnektor-Konfiguration festgelegt wurde.
  
  Beispiel:
  
  Wenn EN-US als Standardsprache in Contentful festgelegt ist, aber DE-DE als Ausgangssprache für die Lokalisierung in einem bestimmten Space oder Content-Modell erforderlich ist, kann die Konfiguration so angepasst werden, dass der Space (Remote-Ordner) Content aus DE-DE anstelle von EN-US zieht.
Hinweis

Nicht anwendbar bei Verwendung der Anwendung.
Wählen Sie aus, wie verschachtelter Content durch Eintrag-Importmodus verarbeitet werden soll. Content kann ein Referenzfeld verwenden, um auf anderen Content zu verweisen, was das Erstellen einer Hierarchie von Entitäten ermöglicht.

Hinweis

Nicht anwendbar bei Verwendung der Anwendung.
- Contentful (Eintrags-Ebene)
  
  Der Konnektor auf Eintrags-Ebene durchläuft automatisch die gesamte Hierarchie des verschachtelten Content.
- Contentful (Feld-Ebene)
  
  Wählen Sie aus, wie der Konnektor auf Feld-Ebene verschachtelten Content importieren soll.
  - Nur ausgewählter Eintrag
    
    Content, der beim Hinzufügen aus dem Repository explizit ausgewählt wird, wird importiert.
    
    Änderungen, die von APE erkannt werden, werden zur Übersetzung importiert.
  - Referenzierte Einträge importieren
    
    Der Konnektor durchläuft die gesamte Hierarchie des verschachtelten Content und importiert alle übersetzbaren Felder zur Übersetzung.
Erstellen Sie eine durch Kommas getrennte Liste in Übersetzbare Felder auslassen, um Felder, die für Lokalisierung dieses Feldes aktivieren markiert sind, vom Import in Phrase TMS auszuschließen. Verwenden Sie die folgende Struktur: contentTypeID:fieldID.
- Wählen Sie Ausgelassene Felder leer lassen aus, wenn die aufgelisteten Felder leer bleiben sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
- Wählen Sie Ausgangssprache in Zielsprache kopieren, wenn die aufgelisteten Felder Werte der Ausgangssprache enthalten sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
Wählen Sie Fallback-Sprache verwenden, wenn für ein bestimmtes Feld in der Ausgangssprache Daten fehlen.

Wählen Sie bei Bedarf eine Ausgangssprache-Fallback aus der Dropdown-Liste aus. Diese Sprache wird bei fehlenden Daten verwendet.

Hinweis

Es besteht keine Beziehung zwischen der Contentful-Fallback-Sprache und dieser Einstellung.
Geben Sie bei Bedarf die Live-Vorschau-URL (BETA) an.

Dies ist die Vorlage für die URL, die zum gerenderten Content aus Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebung-ID
- {entry.sys.id}: Entry ID
- {space_id}: Leerzeichen-ID
Eine URL-Vorlage kann 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-Content rendert. Um die Live-Vorschau zu verwenden, ersetzen Sie contentfulapp.tld in der URL-Vorlage durch den tatsächlichen Fachbereich der Anwendung.

Weitere Informationen zum Einrichten der Content-Vorschau finden Sie in der Contentful-Dokumentation.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um Sprache in der URL zu verwenden, geben Sie einen festen Wert an und erstellen Sie mehrere Konnektor-Instanzen.
Wenn die Protokollierung 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 im Konnektor-Setup, wenn die Verbindung erfolgreich war. Ein rotes Ausrufezeichen wird angezeigt, wenn nicht. Bewege die Maus über das Symbol, um weitere Details anzuzeigen.
Nur Contentful (Eintrag-Ebene):

Legen Sie die Ausgangssprache fest.

Hinweis

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

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.
Bearbeiten Sie optional den Konnektor, 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 aus Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor verschiebt den Workflow in die ausgewählte Phase (z. B. Übersetzung in Fortschritt), wenn die Ausgangsartikel heruntergeladen werden.
Beim Export nach Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor setzt die Workflow-Phase der Ausgangsartikel auf die ausgewählte Phase (z. B. Übersetzungen abgeschlossen), wenn die Übersetzung exportiert wird.
Hinweis

Die Workflow-Unterstützung wurde von Contentful am 1. Juni 2023 eingestellt. Die weitere Verwendung wird nicht unterstützt.