Contentful (TMS)

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

Verfügbar für

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

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Enterprise-Plan (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Tipp

Weitere Informationen zur Integration von Contentful in Phrase Strings sind unter Contentful (Strings) zu finden.

Contentful bietet eine Headless-Content-Management-Infrastruktur zum Erstellen, Verwalten und Verteilen von Inhalten auf jede Plattform oder jedes Gerät. Phrase lässt sich auf zwei Arten mit Contentful integrieren:

Über einen dedizierten Contentful-Connector (2.0, Eintragsebene, Feldebene)

Der Contentful 2.0-Connector unterstützt derzeit die Authentifizierung nur über das US-Rechenzentrum.
Über das Contentful Marketplace-Plugin für eine maßgeschneiderte Erfahrung

Hinweis

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

Unterstützte Lokalisierungsmethoden

Contentful unterstützt mehrere Lokalisierungsmethoden. Weitere Details sind in der Contentful-Dokumentation zu finden.

Der Contentful 2.0-Connector ist die aktuelle und bevorzugte Integration, die eine Lokalisierung auf Feldebene unterstützt. Er bietet außerdem:

Mehrere Leerzeichen
Umgebungs-Aliase
Einrichtung der Vorschau-URL
Referenzimport
Tag-basierte Inhaltsfilterung
Konfiguration der Live-Vorschau

Lokalisierung auf Eintragsebene (Legacy)

Der Contentful (Entry-Level)-Connector sollte verwendet werden.

Der Entry-Level-Connector funktioniert nur mit Inhaltstypen, die lokalisierte Referenzfelder aufweisen (z. B. ein Referenz-Feld namens Localized, das für die Lokalisierung aktiviert ist).

Feldbasierte Lokalisierung (Legacy)

Der Contentful (Field-Level)-Connector sollte verwendet werden.

Der feldbasierte Connector funktioniert nur mit Inhaltstypen, die ein übersetzbares Feld (z. B. entweder ein Text- oder Rich Text-Feld mit aktivierter Lokalisierung) und optional Medien-Assets enthalten. Er importiert referenzierte Einträge und deren übersetzbare Felder (sofern Referenzfelder lokalisiert sind).

Wichtig

Die Legacy-Connectoren werden eingestellt am 30. November 2026. Neue Instanzen dieser Connectoren können bis zum 17. August 2026 erstellt werden. Vor dem Datum der Einstellung sollte auf den neuen Connector migriert werden.

Der vollständige Migrationsleitfaden ist unter Legacy Connector Deprecation verfügbar.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Dateien können direkt aus einem Online-Repository Projekten hinzugefügt werden. Inhalte sind nach Entry-ID durchsuchbar.
Das Submitter-Portal ist so einzurichten, dass Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können. Inhalte sind nach Entry-ID durchsuchbar.
Es empfiehlt sich, automated project creation (APC) zu nutzen, damit automatisch neue Projekte erstellt werden, sobald bei überwachten Dokumenten oder einem Ordner eine Änderung der Inhaltsgröße festgestellt wird.

Anwendungsfälle für die Anwendung:

Einträge können von Content-Editoren direkt aus Contentful zur Lokalisierung eingereicht werden. Dies ermöglicht Content-Editoren oder Managern, den Lokalisierungsprozess vollständig zu steuern und Statusaktualisierungen in Echtzeit bei der Eintragsanzeige zu erhalten.

Sobald der Eintrag fertiggestellt wurde:
- Die gewünschten Zielsprachen für die Lokalisierung sind auszuwählen.
- Entweder wird nur der Eintrag mit den ausgewählten Sprachen an Phrase TMS übermittelt oder alternativ kann die Registerkarte Feldauswahl zur Auswahl einzelner Felder verwendet werden.
  - Wenn keine Felder ausgewählt sind, werden alle lokalisierbaren Felder zur Übersetzung eingereicht.
  - Wenn ein nicht lokalisierbares Feld ausgewählt wird, wird dieses Feld dennoch nicht zur Übersetzung eingereicht. Es werden nur lokalisierbare Felder eingereicht.
  - Wenn nur einige lokalisierbare Felder ausgewählt sind, werden nur diese Felder zur Übersetzung eingereicht.
- Basierend auf den APC-Einstellungen werden Aufträge automatisch aus den eingereichten Inhalten erstellt. Während APC-Durchläufen werden nur Einträge im Status eingereicht für die Auftragserstellung berücksichtigt.
- Sobald Aufträge aus einem eingereichten Eintrag erstellt wurden, ändert sich der Status zu in Bearbeitung. Wenn die Übersetzungen zurück an Contentful übertragen werden, ändert sich der Status zu abgeschlossen.
- Zuvor übersetzte Einträge können nach Änderungen am Originaltext erneut eingereicht werden.
Der Phrase TMS-Startbildschirm kann von Content-Editoren genutzt werden, um:
- Einträge können gesammelt eingereicht werden.
- Einzelne Zielsprachen können bei der Sammel-Einreichung angegeben werden.
- Ein Überblick über aktive Übersetzungsaufträge wird bereitgestellt.

Contentful-Einstellungen

Bei der Arbeit mit der Phrase TMS-Anwendung:

Die Phrase TMS-Anwendung kann aus dem Marketplace heruntergeladen werden.
Die Anwendung wird im aktuell aktiven Bereich installiert, und die entsprechenden Content-Modelle, für die die Anwendung eingesetzt werden soll, sind auszuwählen.
Das Phrase TMS Auth-Token, das beim Erstellen des Connectors in Phrase TMS generiert wurde, ist einzugeben.
Auf Installieren wird geklickt.

Optional – App starten (von Contentful als veraltet markiert)

Bei Nutzung der Workflow-Unterstützung über die Launch App von Contentful sind folgende Schritte zu befolgen:

Die Launch-Anwendung von Contentful wird in einem oder mehreren Spaces installiert.

Hinweis

Pro Space kann nur ein Workflow erstellt werden. Sollten innerhalb eines Contentful-Spaces unterschiedliche Ansätze für Inhaltstypen erforderlich sein, ist der zuständige Customer Success Manager zu kontaktieren.
Der erforderliche Lokalisierungs-Workflow ist einzurichten.
Die Inhaltstypen, die dem beschriebenen Workflow folgen sollen, sind auszuwählen.

Wenn Workflows in einem Connector festgelegt sind, erstellt die automatisierte Projekterstellung (APC) automatisch neue Projekte, wenn eine Änderung der Workflow-Schritte für überwachte Artikel oder Inhaltstypen erkannt wird.

Übermittelte Aufträge können storniert werden, sodass Inhalte nach Änderungen erneut übermittelt 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-Connector nicht unterstützt.

Auf der Seite Einstellungen ist zum Abschnitt Integrationen hinunterzuscrollen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Es ist auf Neuer Connector zu klicken.

Die Seite Connector erstellen öffnet sich.
Der Typ sollte auf Contentful 2.0 geändert werden.
Ein Name für den Connector ist anzugeben.
Es ist auf Mit Contentful 2.0 verbinden zu klicken.

Das Contentful-Anmeldefenster wird geöffnet.
Die Anmeldedaten sind einzugeben, und anschließend ist auf Anmelden zu klicken (alternativ können andere Anmeldemethoden verwendet werden). Das Anmeldefenster wird geschlossen und Verbunden wird angezeigt.
Optional kann das Kontrollkästchen Phrase Contentful App aktiviert werden, wenn der Connector mit der App genutzt wird.
1. Es ist auf Generate token zu klicken.
  
  Das Fenster Generate Contentful Token öffnet sich.
2. Es ist auf Generate token zu klicken.
  
  Es wird ein Token generiert, das in die Zwischenablage oder eine Textdatei kopiert werden sollte. Es sollte sichergestellt werden, dass das Token kopiert wurde, bevor das Fenster geschlossen wird, da es danach nicht mehr einsehbar ist. Dieses Token wird beim Herstellen der Verbindung zur App im Rahmen der genutzt.
3. Fenster schließen – anschließend wird Token generated angezeigt.
Falls Contentful Tags zur Identifizierung übersetzbarer Inhalte verwendet werden, eine Tag-ID eingeben und Enter drücken.

Die ID wird angezeigt und weitere können hinzugefügt werden. Mit Tags lässt sich begrenzen, welche Inhalte aus Contentful für den Connector sichtbar sind.
- Listing-Strategie auswählen
  - Mit allen Tags
    
    Zeigt Inhalte innerhalb von Contentful mit allen aufgelisteten Tags an.
  - Mit mindestens einem Tag
    
    Zeigt Inhalte aus Contentful mit mindestens einem der aufgelisteten Tags an.
Falls erforderlich, Include assets auswählen.
Bei Bedarf Include referenced entries (verschachtelte Inhalte) auswählen.

Die Referenced entries settings werden angezeigt. Die gewünschten Filter anwenden, um die Kontrolle darüber zu präzisieren, wie das System Inhaltsbeziehungen durchläuft.
- Lege die Importtiefe für verknüpfte Einträge fest.
  
  Es wird festgelegt, wie weit Phrase beim Import referenzierte Einträge folgt.
  
  Der Standardwert ist 10.000. Falls erforderlich, andere Werte auswählen oder einen benutzerdefinierten Ganzzahlwert angeben.
- Art des Inhalts
  
  Entscheiden, ob bei Einträgen, deren Inhaltstyp mit der angegebenen Liste übereinstimmt, angehalten oder diesen gefolgt werden soll.
- Übergeordnete Inhaltstypen
  
  Einträge ausschließen, deren übergeordneter Inhaltstyp mit der angegebenen Liste übereinstimmt.
- Tags
  
  Entscheiden, ob bei Einträgen, die eines der angegebenen Inhalts-Tags besitzen, angehalten oder diesen gefolgt werden soll.
- Fields-IDs
  
  Entscheiden, ob bei Einträgen, auf die durch die angegebenen Feld-IDs verwiesen wird, angehalten oder diesen gefolgt werden soll.
Falls erforderlich, Include taxonomy auswählen.

Das Feld Contentful Organization ID wird angezeigt. Einen Wert eingeben, um die Taxonomie zu aktivieren.
- Wird diese Option ausgewählt, ruft der Connector Taxonomien aus Contentful ab und fügt sie in die .XLIFF-Datei ein. Der Bereich Kontexthinweis des CAT-Editors listet die Contentful-Taxonomiewerte für jedes Segment auf.
- Wenn keine Taxonomie-Metadaten verfügbar sind oder der Connector nicht damit konfiguriert ist, 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-Export zu optimieren.
Falls erforderlich, Follow aliases auswählen.

Der Alias wird für alle APC-Überwachungen sowie für den Reimport/Export von Aufträgen verwendet. Wenn das Alias-Ziel in Zukunft geändert wird, überwacht APC den Inhalt im neuen Ziel und Aufträge werden vom/zum neuen Alias-Ziel importiert/exportiert.

Aliase folgen gilt nur für die APC-Überwachung, den Reimport und Export von Aufträgen des Standard-Connectors. Dies gilt nicht für Einträge, die mit der Phrase Contentful App übermittelt werden. Wenn die App verwendet wird, bleibt ein Eintrag an die spezifische Umgebung gebunden, aus der er zum Zeitpunkt der Übermittlung übermittelt wurde. Dies gilt auch dann, wenn diese Umgebung später gelöscht oder hinter einem stabilen Alias ersetzt wird. Wenn die ursprüngliche Umgebung gelöscht oder ersetzt wird, erfasst der Connector den Eintrag nicht unter der neuen Umgebung, selbst wenn Aliase folgen aktiviert ist. Den Eintrag aus Contentful erneut übermitteln, während die neue Umgebung aktiv ist, damit der Connector diesen erkennt.
- Deaktiviert (Standard und empfohlen)
  
  APCs und erstellte Jobs sind an die Umgebung gebunden, auf die der Alias zum Zeitpunkt der Job-/APC-Erstellung verwies. APCs überwachen nur diese Umgebung und diesen Inhalt; Jobs werden exportiert und erneut in diese importiert.
- Aktiviert
  
  APCs und erstellte Jobs sind an den Alias selbst gebunden. APCs überwachen nur diesen Alias und den zugehörigen Inhalt; Jobs werden dorthin exportiert und erneut importiert.
  
  Wenn das Alias-Ziel geändert wird, überwachen APCs das neue Alias-Ziel (Umgebung); Jobs werden nun dorthin exportiert und erneut importiert.
Benutzerdefinierte Contentful-Rollen erfordern direkten Zugriff 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. Diesen Zugriff in Contentful unter Contentful Space Settings/Roles im Abschnitt Environments der Rolle hinzufügen. Wird der Alias später auf eine andere Umgebung umgeleitet, auch Zugriff auf die neue Umgebung hinzufügen.
Falls erforderlich, die Vorschau-URL angeben.

Dies ist die URL-Vorlage, die zum gerenderten Inhalt von Contentful führt. Die folgenden Platzhalter werden unterstützt:
- env_id: Umgebung-ID
- Eintrag-ID Eintrag-ID
- Space-ID Space-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 die Contentful-Inhalte rendert. Zur Nutzung der Live-Vorschau contentfulapp.tld in der URL-Vorlage durch die tatsächliche Domain der Anwendung ersetzen.

In der Contentful-Dokumentation findet sich weitere Information zum Einrichten der Inhaltsvorschau.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um das Gebietsschema in der URL zu verwenden, einen festen Wert angeben und mehrere Connector-Instanzen erstellen.
Falls erforderlich, Übersetzbare Felder auslassen verwenden, um bestimmte Felder vom Import in Phrase auszuschließen. Die ContentIDs angeben, die vom Import ausgeschlossen werden sollen.
Space ID und Token für die Space-Vorschau-Token-Zuordnung angeben (erforderlich).

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

Die Contentful 2.0-Integration verwendet diese API zum Importieren von Inhalten und Überwachen von Änderungen (APC).
- Jeden Space und jede Umgebung auswählen, die von Contentful überwacht/importiert werden sollen.
- Einrichtung und Zugriff werden innerhalb von Contentful selbst verwaltet.
Klicke auf Speichern.

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

Hinweis

Die APC-Überwachung überprüft bei jedem Durchlauf den vollständigen Inhalt eines verfolgten Eintrags und dessen Referenzen erneut, da Contentful nicht meldet, welches Gebietsschema geändert wurde. Referenzierte Einträge werden einzeln und nicht in Batches abgerufen. Daher kann ein einzelner Durchlauf auf Spaces mit vielen referenzierten Einträgen eine hohe Anzahl von Anfragen an die Contentful Preview API und Content API generieren. Aus diesem Grund kann ein Eintrag nach Erhalt einer Übersetzung erneut importiert werden, obwohl sich seine Quelle nicht geändert hat. Bei Spaces mit hohem Volumen kann dies APC-Durchläufe verlangsamen und die Contentful API-Nutzung erheblich erhöhen.

Um dies zu reduzieren:

Das Übersetzungs-Tag entfernen, sobald ein Eintrag fertig ist, und nur wieder hinzufügen, wenn eine erneute Übersetzung erforderlich ist.
Die Einstellungen für Referenced entries auf die Einträge beschränken, die übersetzt werden müssen.
Die Phrase Contentful App verwenden, die nur Einträge überwacht, die über sie eingereicht wurden.

Zuvor übersetzte Einträge können nach Änderungen am Originaltext erneut eingereicht werden. Bei Verwendung der Phrase Contentful App erfolgt die erneute Einreichung manuell: Den Eintrag in Contentful öffnen, die Phrase App-Seitenleiste öffnen und Start over anklicken (oder eine Massen-Neueinreichung über das App-Dashboard verwenden), bevor APC den Eintrag erfasst und die Quellinformation des bestehenden Auftrags aktualisiert wird. Dies unterscheidet sich von Datei- oder Ordnerüberwachungs-Connectors, bei denen APC Quelländerungen automatisch erkennt, ohne dass eine manuelle Neueinreichung erforderlich ist.

Phrase TMS-Einstellungen

Wichtig

Bei Zugriff über eine benutzerdefinierte Domain (z. B. mydomain.phrase.jp) ein Inkognito-Browserfenster öffnen und sich über cloud.memsource.com oder us.cloud.memsource.com anmelden, um die für das Erstellen oder Speichern des Connectors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über die benutzerdefinierte Domain auf den Connector zugegriffen werden.

Auf der Seite Einstellungen bis zum Abschnitt Integrationen scrollen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Auf Neuer Connector klicken.

Die Seite Connector erstellen wird geöffnet.
Ändere den Type in entweder Contentful (Entry-Level) oder Contentful (Field-Level) und gib einen Namen für den Connector ein.
Wähle optional das Kontrollkästchen Phrase Contentful App, wenn du den Connector mit der App verwendest.
- Contentful App-Token
  
  Generiere ein App-Token, das in die Phrase TMS Contentful-Anwendung eingegeben werden muss. Speichere den Connector, nachdem du das Token generiert und in die Contentful App kopiert hast.
Hinweis

Nach dem Speichern kann das Token nicht mehr innerhalb von Contentful geändert werden. Um es zu aktualisieren, widerrufe das Token in der Connector-Konfiguration in Phrase TMS und generiere ein neues.
Konfiguriere sprachunabhängige Einstellungen.
- Ausgangssprache
  
  Wähle eine Ausgangssprache aus, um die Contentful-Standardsprache zu überschreiben. Der Connector zieht dann Inhalte aus der Sprache, die in der Connector-Konfiguration eingerichtet ist.
  
  Beispiel:
  
  Wenn EN-US als Standardsprache in Contentful festgelegt ist, aber DE-DE als Ausgangssprache für die Lokalisierung in einem bestimmten Bereich oder Inhaltsmodell erforderlich ist, kann die Konfiguration so angepasst werden, dass der Bereich (Remote-Ordner) Inhalte aus DE-DE anstelle von EN-US zieht.
Hinweis

Nicht anwendbar bei Verwendung der Anwendung.
Wähle über Entry import mode aus, wie verschachtelte Inhalte verarbeitet werden sollen. Inhalte können ein Referenzfeld verwenden, um auf andere Inhalte zu verweisen und so die Erstellung einer Hierarchie von Entitäten zu ermöglichen.

Hinweis

Nicht anwendbar bei Verwendung der Anwendung.
- Contentful (Entry-Level)
  
  Der Connector auf Eintragsebene durchläuft automatisch die gesamte Hierarchie verschachtelter Inhalte.
- Contentful (Feldebene)
  
  Wähle aus, wie der Connector auf Feldebene verschachtelte Inhalte importieren soll.
  - Nur ausgewählter Eintrag
    
    Inhalte, die beim Hinzufügen aus dem Repository explizit ausgewählt werden, werden importiert.
    
    Änderungen, die von APC erkannt werden, werden zur Übersetzung importiert.
  - Importiere referenzierte Einträge.
    
    Der Connector durchläuft die gesamte Hierarchie verschachtelter Inhalte und importiert alle übersetzbaren Felder zur Übersetzung.
Erstelle eine durch Kommas getrennte Liste in Omit translatable fields, um Felder, die für Enable localization of this field aktiviert sind, vom Import in Phrase TMS auszuschließen. Verwende die folgende Struktur: contentTypeID:fieldID.
- Wähle Leave omitted fields empty, wenn die aufgelisteten Felder leer bleiben sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
- Wähle Copy source to target, wenn die aufgelisteten Felder Quellwerte enthalten sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
Wähle Use fallback language, wenn für ein bestimmtes Feld in der Ausgangssprache Daten fehlen.

Wähle bei Bedarf eine Source language fallback aus der Dropdown-Liste. Dieses Sprachgebietsschema wird verwendet, falls Daten fehlen.

Hinweis

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

Dies ist die URL-Vorlage, die zum gerenderten Inhalt 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 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-Inhalt rendert. Um die Live-Vorschau zu nutzen, ersetze contentfulapp.tld in der URL-Vorlage durch die tatsächliche Domain der Anwendung.

Weitere Informationen zum Einrichten von content preview findest du in der Contentful-Dokumentation.

Sprache wird zurzeit nicht als Platzhalter unterstützt. Um das Gebietsschema in der URL zu verwenden, gib einen festen Wert an und erstelle mehrere Connector-Instanzen.
Wenn das Protokollieren von Debug-Informationen vom technischen Support-Team angefordert wird, wähle Debug-Informationen protokollieren aus.
Klicke auf Mit Contentful verbinden.

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

Lege die Quellsprache fest.

Hinweis

Diese Sprache sollte mit dem Standard-Gebietsschema des Contentful-Bereichs übereinstimmen, das in den Gebietsschema-Einstellungen von Contentful konfiguriert ist.
Klicke auf Speichern.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.
Bearbeite optional den Connector, um Contentful workflows auszuwählen.
- Artikel übersetzen aus
  
  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 Connector verschiebt 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 Connector setzt die Workflow-Phase der Quellartikel 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. Eine weitere Nutzung wird nicht unterstützt.