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. Tags können verwendet werden, um einzuschränken, welcher Content aus Contentful für den Konnektor sichtbar ist.
- 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 einbeziehen aus.
Wählen Sie bei Bedarf Referenzierte Einträge einbeziehen (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, angehalten oder gefolgt werden soll.
- Übergeordnete Inhaltstypen
  
  Schließen Sie Einträge aus, deren übergeordnetes Element Content-Typ mit der angegebenen Liste übereinstimmt.
- Tags
  
  Wählen Sie aus, ob bei Einträgen, die eines der angegebenen Content-Tag(s) aufweisen, angehalten oder ob 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 ob 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 Kontexthinweis-Bereich 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 ist, wird der Kontexthinweis-Bereich einfach weggelassen.
- Wenn ein Projekt keinen Feature-/Bildschirm-Kontext 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 und Job-Reimporte/-Exporte verwendet. Wenn das Zielsprache des Alias in Zukunft geändert wird, überwacht APE den Content im neuen Zielsprache und Jobs werden vom/zum neuen Alias-Zielsprache reimportiert/exportiert.
- Disabled (Standard und empfohlen)
  
  APEs und erstellte Jobs sind an die Umgebung gebunden, auf die der 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 den Alias selbst gebunden. APEs überwachen nur diesen Alias und diesen Content; Jobs werden dorthin exportiert und von dort reimportiert.
  
  Wenn das Zielsprache des Alias geändert wird, überwachen APEs das neue Alias-Zielsprache (Umgebung); Jobs werden nun dorthin exportiert und von dort reimportiert.
Benutzerdefinierte Contentful-Rollen erfordern direkten zugreifen auf die spezifische zugrunde liegende Umgebung, auf die der Alias verweist, nicht nur auf den Alias selbst, da sonst das Phrase TMS App Dashboard nicht geladen wird. Fügen Sie diesen Zugriff in Contentful unter Contentful Leerzeichen Einstellungen/Rollen im Abschnitt Umgebungen der Rolle hinzu. Wenn der Alias später auf eine andere Umgebung umgestellt wird, fügen Sie auch für die neue Umgebung Zugriff hinzu.
Geben Sie bei Bedarf die Vorschau-URL an.

Dies ist die URL-Vorlage, die zum gerenderten Content aus Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebungs-ID
- {entry.id}: Eintrag-ID
- {space_id}: Leerzeichen-ID
Eine URL-Vorlage kann wie folgt 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 Vorlage durch die tatsächliche Domain der Anwendung.

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

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 Konnektor-Instanzen.
Verwenden Sie bei Bedarf Übersetzbare Felder auslassen, um bestimmte Felder vom Import nach Phrase auszuschließen. Geben Sie Content-IDs an, die vom Import ausgeschlossen werden sollen.
Geben Sie Leerzeichen ID und Token für Leerzeichen Vorschau-Token-Zuordnung 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 für den Import von Content und die Überwachung von Änderungen (APE).
- Wählen Sie jedes Leerzeichen und jede Umgebung aus, die aus Contentful überwacht/importiert werden sollen.
- Setup und Zugriff werden innerhalb von Contentful selbst verwaltet.
Klicke auf Speichern.

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

Hinweis

Die APE-Überwachung überprüft bei jedem Durchlauf den vollständigen Content eines nachverfolgten Eintrags und dessen Referenzen erneut, da Contentful nicht meldet, welche Sprache geändert wurde. Aus diesem Grund kann ein Eintrag nach Erhalt einer Übersetzung erneut importiert werden, auch wenn sich seine Ausgangssprache nicht geändert hat. Bei Spaces mit hohem Volumen kann dies APE-Durchläufe verlangsamen.

Um dies zu reduzieren:

Entfernen Sie das Übersetzungs-Tag, sobald ein Eintrag fertig ist, und fügen Sie es nur dann wieder hinzu, wenn er erneut übersetzt werden muss.
Beschränken Sie die Einstellungen für Referenzierte Einträge auf nur die Einträge, die übersetzt werden müssen.
Verwenden Sie die Phrase Contentful-App, die nur Einträge überwacht, die über sie eingereicht wurden.

Phrase TMS-Einstellungen

Wichtig

Wenn Sie von einem Individuellen Fachbereich aus zugreifen (z. B. mydomain.phrase.jp), ö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 das Speichern des Konnektors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über den Individuellen Fachbereich auf den Konnektor zugegriffen 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 (Eintragsebene) oder Contentful (Feldebene) 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 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 in der Konnektor-Konfiguration festgelegten Sprache.
  
  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 importieren-Modus 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 (Eintrag-Ebene)
  
  Der Konnektor auf Eintrag-Ebene durchläuft automatisch die gesamte Hierarchie des verschachtelten Contents.
- 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 Contents und importiert alle übersetzbaren Felder zur Übersetzung.
Erstellen Sie eine kommagetrennte Liste in Übersetzbare Felder auslassen, um Felder, die für Lokalisierung dieses Feldes aktivieren geprü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 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 Daten für ein bestimmtes Feld in der Ausgangssprache fehlen.

Wählen Sie bei Bedarf eine Fallback-Ausgangssprache 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 URL-Vorlage, die zum gerenderten Content aus Contentful führt. Die folgenden Platzhalter werden unterstützt:
- {env_id}: Umgebungs-ID
- {entry.sys.id}: Entry ID
- {space_id}: Leerzeichen-ID
Eine URL-Vorlage kann wie folgt 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 Vorlage durch die tatsächliche Domain der Anwendung.

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

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 Konnektor-Instanzen.
Wenn die Protokollierung von Debug-Informationen vom technischen Support-Team angefordert wird, wählen Sie Debug-Informationen protokollieren.
Klicken Sie auf Connect to Contentful.

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-Leerzeichen übereinstimmen, das 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 von Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor verschiebt den Workflow in die ausgewählte Phase (z. B. Übersetzung in Fortschritt), wenn die Ausgangssprache-Artikel heruntergeladen werden.
Beim Export nach Contentful:
- Setzt Quellartikel auf Stufe
  
  Der Konnektor setzt die Workflow-Phase der Ausgangssprache-Artikel 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.

Konnektor löschen

So löschen Sie einen Konnektor:

Wählen Sie auf der Seite Integrations den zu löschenden Konnektor aus.
Klicken Sie auf Delete.

Das Fenster Delete connector wird geöffnet.
Geben Sie „delete“ ein und klicken Sie auf Delete.

Der Konnektor wird gelöscht und die Liste der Konnektoren wird angezeigt.

Hinweis

Ein Konnektor 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 Konnektor zu löschen, führt zu der Fehlermeldung „Failed to delete connector“.

Lösung: Öffnen Sie das mit dem Konnektor verknüpfte Projekt und schließen Sie alle verbleibenden Aufträge ab oder löschen Sie diese. Gehen Sie zu Einstellungen/Papierkorb und leeren Sie diesen, um alle Aufträge zu entfernen, die noch mit dem Konnektor verknüpft sind. Versuchen Sie erneut, den Konnektor zu löschen.