-
Business- und Enterprise-Pläne (nicht für LSP-Pläne verfügbar)
Kontaktiere Vertrieb für Fragen zur Lizenzierung.
Tipp
Informationen zur Contentful-Integration in Phrase Strings sind unter Contentful (Strings) zu finden.
Contentful bietet eine Headless-Content-Management-Infrastruktur zum Erstellen, Verwalten und Verteilen von Inhalten an 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 ein individuell angepasstes Nutzungserlebnis
Hinweis
Der Connector unterstützt nicht die Übersetzung von JSON-Objekten.
Unterstützte Lokalisierungsmethoden
Contentful unterstützt mehrere Lokalisierungsmethoden. Eine detaillierte Beschreibung ist in der Contentful-Dokumentation zu finden.
Der Contentful 2.0-Connector ist die aktuelle und bevorzugte Integration, die 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)
Den Contentful (Entry-Level)-Connector verwenden.
Der Entry-Level-Connector funktioniert nur mit Inhaltstypen, die lokalisierte Referenzfelder aufweisen (z. B. ein Referenzfeld (reference) namens Localized, für das die Lokalisierung aktiviert ist).
Lokalisierung auf Feldebene (Legacy)
Den Contentful (Field-Level)-Connector verwenden.
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 aufweisen. Er importiert referenzierte Einträge und deren übersetzbare Felder (sofern Referenzfelder lokalisiert sind).
Wichtig
Die Legacy-Connectoren werden am 30. November 2026 als veraltet eingestuft. Neue Instanzen dieser Connectoren können bis zum 17. August 2026 erstellt werden. Vor dem Datum der Einstufung als veraltet auf den neuen Connector migrieren.
Ein vollständiger Migrationsleitfaden ist unter Legacy Connector Deprecation zu finden.
Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:
-
Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen. Inhalte sind nach Entry-ID durchsuchbar.
-
Das Submitter-Portal so einrichten, dass Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können. Inhalte sind nach Entry-ID durchsuchbar.
-
Mit der automatisierten Projekterstellung (APC) automatisch neue Projekte erstellen lassen, wenn bei überwachten Dokumenten oder einem Ordner eine Änderung der Inhaltsgröße festgestellt wird.
Anwendungsfälle für die Anwendung:
-
Content-Editoren können einen Eintrag direkt aus Contentful heraus zur Lokalisierung einreichen. So haben Content-Editoren oder Manager die volle Kontrolle über den Lokalisierungsprozess und erhalten beim Anzeigen eines Eintrags Statusaktualisierungen in Echtzeit.
Sobald der Eintrag fertiggestellt wurde:
-
Die gewünschten Zielsprachen für die Lokalisierung auswählen.
-
Nur den Eintrag mit den ausgewählten Sprachen an Phrase TMS übermitteln oder auf der Registerkarte Feldauswahl die gewünschten Felder auswä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. 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.
-
-
Content-Editoren können den Phrase-TMS-Startbildschirm verwenden, um:
-
Einträge gesammelt einreichen.
-
Bei der gesammelten Einreichung einzelne Zielsprachen angeben.
-
Sich einen Überblick über aktive Übersetzungsaufträge verschaffen.
-
Contentful-Einstellungen
Bei der Arbeit mit der Phrase-TMS-Anwendung:
-
Die Phrase TMS-Anwendung aus dem Marketplace herunterladen.
-
Die Anwendung im aktuell aktiven Space installieren und die Inhaltsmodelle auswählen, für die sie installiert werden soll.
-
Das beim Erstellen des Connectors in Phrase TMS erhaltene Phrase TMS Auth-Token eingeben.
-
Auf Installieren klicken.
Optional – Launch App (von Contentful als veraltet eingestuft)
Bei Nutzung der Workflow-Unterstützung über die Launch App von Contentful wie folgt vorgehen:
-
Die Launch-Anwendung von Contentful in einem oder mehreren Spaces installieren.
Hinweis
Pro Space kann nur ein Workflow erstellt werden. Wenn innerhalb eines Contentful-Space unterschiedliche Ansätze für Inhaltstypen erforderlich sind, den zuständigen Customer Success Manager kontaktieren.
-
Den erforderlichen Lokalisierungs-Workflow einrichten.
-
Die Inhaltstypen auswählen, die dem beschriebenen Workflow folgen sollen.
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.
Hinweis
Die Contentful Launch App wird im 2.0-Connector nicht unterstützt.
-
Auf der Seite „Einstellungen“
nach unten zum Abschnitt scrollen.
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Auf Neuer Connector klicken.
Die Seite wird geöffnet.
-
Den Typ auf Contentful 2.0 ändern.
-
Einen Namen für den Connector angeben.
-
Auf Mit Contentful 2.0 verbinden klicken.
Das Contentful-Anmeldefenster wird geöffnet.
-
Die Anmeldedaten eingeben und auf Anmelden klicken (oder eine alternative Anmeldemethode verwenden). Das Anmeldefenster wird geschlossen und wird angezeigt.
-
Bei Verwendung des Connectors mit der App optional das Kontrollkästchen Phrase Contentful App aktivieren.
-
Auf Token generieren klicken.
Das Fenster öffnet sich.
-
Auf Token generieren klicken.
Das generierte Token in die Zwischenablage oder eine Textdatei kopieren. Das Token vor dem Schließen des Fensters kopieren, da es danach nicht mehr angezeigt wird. Dieses Token wird beim Herstellen einer Verbindung zur App verwendet.
-
Das Fenster schließen. Anschließend wird angezeigt.
-
-
Wenn Contentful Tags verwendet werden, um übersetzbare Inhalte zu identifizieren, eine Tag-ID eingeben und Enter drücken.
Die ID wird angezeigt und weitere können hinzugefügt werden. Tags können verwendet werden, um einzuschränken, welche Inhalte aus Contentful für den Connector sichtbar sind.
-
Bei Bedarf auswählen.
-
Bei Bedarf (verschachtelte Inhalte) auswählen.
Die werden angezeigt. Die gewünschten Filter anwenden, um genauer zu steuern, wie das System Inhaltsbeziehungen durchläuft.
-
Begrenzt, wie weit Phrase beim Import referenzierten Einträgen folgt.
Der Standardwert ist 10.000. Bei Bedarf andere Werte auswählen oder einen benutzerdefinierten Ganzzahlwert angeben.
-
Festlegen, ob bei Einträgen mit einem Inhaltstyp aus der angegebenen Liste angehalten oder ihren Referenzen gefolgt werden soll.
-
Einträge ausschließen, deren übergeordneter Inhaltstyp mit der angegebenen Liste übereinstimmt.
-
Festlegen, ob bei Einträgen mit mindestens einem der angegebenen Inhalts-Tags angehalten oder ihren Referenzen gefolgt werden soll.
-
Festlegen, ob bei Einträgen, auf die über die angegebenen Feld-IDs verwiesen wird, angehalten oder ihren Referenzen gefolgt werden soll.
-
-
Bei Bedarf auswählen.
Das Feld wird angezeigt. Einen Wert eingeben, um die Taxonomie-Einstellung zu aktivieren.
-
Wenn diese Option ausgewählt ist, ruft der Connector Taxonomien aus Contentful ab und fügt sie in die .XLIFF-Datei ein. Im Bereich des CAT-Editors werden die Contentful-Taxonomiewerte für jedes Segment aufgeführt. Taxonomiewerte sind keine übersetzbaren Inhalte. Sie können weder einzeln noch zusammen mit einem Eintrag als eigenständiger Job aufgelistet, importiert oder exportiert werden.
-
Wenn Taxonomie-Metadaten nicht verfügbar oder im Connector nicht konfiguriert sind, wird der Bereich einfach weggelassen.
-
Wenn ein Projekt keinen Feature-/Bildschirmkontext erfordert, wird empfohlen, die Taxonomie deaktiviert zu lassen, um die Leistung beim .XLIFF-Export zu optimieren.
-
-
Bei Bedarf auswählen.
Der Alias wird für die gesamte APC-Überwachung sowie für den Job-Reimport/-Export verwendet. Wenn das Alias-Ziel in Zukunft geändert wird, überwacht APC den Inhalt im neuen Ziel, und Jobs werden vom neuen Alias-Ziel reimportiert und dorthin exportiert.
Follow aliases gilt für die APC-Überwachung, den Job-Reimport und den Job-Export. Dies gilt auch für Einträge, die über die Phrase Contentful App unter einer Alias-URL übermittelt wurden. Die App speichert den Alias bei der Übermittlung, sodass der Connector diese Einträge auch nach einer Änderung des Alias-Ziels findet. Einträge, die übermittelt wurden, während der Alias auf eine frühere Umgebung verwies, bleiben für den Connector sichtbar. Jeder Eintrag wird weiterhin in die Umgebung exportiert und reimportiert, aus der er übermittelt wurde.
Ein Connector, der einem Alias folgt, findet keine Einträge, die von der konkreten Umgebungs-URL anstelle der Alias-URL übermittelt wurden. Er findet auch keine Einträge, die über die App übermittelt wurden, bevor die Alias-Unterstützung hinzugefügt wurde. Diese Einträge erneut aus Contentful über die Alias-URL übermitteln.
-
(Standardeinstellung und empfohlen)
APCs und erstellte Jobs sind an die Umgebung gebunden, auf die das Alias zum Zeitpunkt der Job-/APC-Erstellung verwies. APCs überwachen nur diese Umgebung und diesen Inhalt; Jobs werden dorthin exportiert und reimportiert.
-
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 nun dorthin exportiert und reimportiert.
Für Einträge, die über die Phrase Contentful App übermittelt wurden, werden Jobs in die Umgebung exportiert und reimportiert, aus der der Eintrag übermittelt wurde.
Benutzerdefinierte Contentful-Rollen erfordern direkten Zugriff auf die spezifische zugrunde liegende Umgebung, auf die das Alias verweist, nicht nur auf das Alias selbst, da sonst das Phrase TMS App-Dashboard nicht geladen wird. Diesen Zugriff in Contentful unter im Abschnitt der Rolle hinzufügen. Wenn der Alias später auf eine andere Umgebung verweist, auch den Zugriff auf die neue Umgebung hinzufügen.
-
-
Bei Bedarf die angeben.
Dies ist die URL-Vorlage, die zum gerenderten Inhalt 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 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-Inhalt rendert. Für die Live-Vorschau
contentfulapp.tldin der URL-Vorlage durch die tatsächliche Domain der Anwendung ersetzen.Weitere Informationen zum Einrichten der Inhaltsvorschau stehen in der Contentful-Dokumentation.
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.
-
-
Bei Bedarf verwenden, um bestimmte Felder vom Import in Phrase auszuschließen. Die ContentIDs angeben, die vom Import ausgeschlossen werden sollen.
-
und für angeben (erforderlich).
Die Preview API erfordert ein Contentful-Zugriffstoken namens , das in den API-Einstellungen des Contentful-Space konfiguriert sein sollte.
Die Contentful 2.0-Integration verwendet diese API zum Importieren von Inhalten und Überwachen von Änderungen (APC).
-
Alle Spaces und Umgebungen auswählen, deren Inhalte in Contentful überwacht bzw. aus Contentful importiert werden sollen.
-
Einrichtung und Zugriff werden innerhalb von Contentful selbst verwaltet.
-
-
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
Hinweis
Die APC-Überwachung überprüft bei jedem Durchlauf den vollständigen Inhalt eines nachverfolgten Eintrags und dessen Referenzen erneut, da Contentful nicht meldet, welches Gebietsschema geändert wurde. Referenzierte Einträge werden einzeln statt in Batches abgerufen, sodass ein einzelner Durchlauf bei Spaces mit vielen referenzierten Einträgen eine hohe Anzahl an Anfragen an die Contentful Preview API und Content API generieren kann. Aus diesem Grund kann ein Eintrag nach Erhalt einer Übersetzung erneut importiert werden, obwohl sich dessen Quelle nicht geändert hat. Bei Spaces mit vielen Einträgen kann dies APC-Durchläufe verlangsamen und die Nutzung der Contentful API erheblich erhöhen.
So lässt sich die Belastung reduzieren:
-
Das Übersetzungs-Tag entfernen, sobald die Übersetzung eines Eintrags abgeschlossen ist, und es nur dann wieder hinzufügen, wenn der Eintrag erneut übersetzt werden muss.
-
Die Einstellungen für auf 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: Eine redaktionell tätige Person muss den Eintrag in Contentful und die Seitenleiste der Phrase App öffnen und auf Start over klicken (oder die erneute Einreichung mehrerer Einträge über das App-Dashboard nutzen). Erst danach erkennt APC den Eintrag und aktualisiert den Quelltext des bestehenden Jobs. Dies unterscheidet sich von Datei- oder Ordnerüberwachungs-Connectoren, bei denen APC Quelländerungen automatisch erkennt, ohne dass eine manuelle Neueinreichung erforderlich ist.
Ein Contentful 2.0-Connector gehört zur Organisation und nicht zu einer einzelnen Person. Das Contentful-OAuth-Token, das der Connector verwendet, ist an den Benutzer gebunden, der es autorisiert hat.
Um den Connector mit einem anderen Contentful-Benutzer zu verknüpfen, muss das vorhandene OAuth-Token entfernt werden, damit ein anderer Benutzer den Connector erneut autorisieren kann:
-
Mit dem Contentful-Konto, mit dem das Token erstellt wurde, die Seite für API-Token des betreffenden Space öffnen (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
-
Das Token mit dem Namen „Memsource Connector“ löschen. Wenn mehrere Token diesen Namen haben, vor dem Löschen prüfen, welches davon vom betroffenen Connector verwendet wird.
-
Sobald das Token gelöscht ist, wird der Connector deaktiviert, bis der neue Benutzer ihn in den Connector-Einstellungen in Phrase TMS erneut autorisiert.
Diese Schritte durchführen, bevor der Contentful-Zugriff des ursprünglichen Benutzers entfernt wird, da das Token sonst möglicherweise nicht mehr sichtbar ist.
Wichtig
Beim 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 durchzuführen. Nach dem Speichern kann über die benutzerdefinierte Domain auf den Connector zugegriffen werden.
-
Auf der Seite „Einstellungen“
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Auf Neuer Connector klicken.
Die Seite wird geöffnet.
-
Als Typ entweder Contentful (Entry-Level) oder Contentful (Field-Level) auswählen und einen Namen für den Connector angeben.
-
Bei Verwendung des Connectors mit der App optional das Kontrollkästchen Phrase Contentful App aktivieren.
-
Contentful-App-Token
Ein App-Token generieren, das in die Contentful-Anwendung von Phrase TMS eingegeben werden soll. Nach dem Generieren des Tokens und dem Kopieren in die Contentful-App den Connector speichern.
Hinweis
Nach dem Speichern kann das Token nicht mehr innerhalb von Contentful geändert werden. Zum Aktualisieren das Token in der Connector-Konfiguration in Phrase TMS widerrufen und ein neues generieren.
-
-
Sprachunabhängige Einstellungen konfigurieren.
-
Ausgangssprache
Eine Ausgangssprache auswählen, um die Contentful-Standardsprache zu überschreiben. Der Connector ruft dann Inhalte in der Sprache ab, die in der Connector-Konfiguration festgelegt wurde.
Beispiel:
Hinweis
Gilt nicht bei Verwendung der App.
-
-
Über Eintragsimportmodus auswählen, wie verschachtelte Inhalte verarbeitet werden sollen. Inhalte können ein Referenzfeld verwenden, um auf andere Inhalte zu verweisen, was die Erstellung einer Hierarchie von Entitäten ermöglicht.
-
Contentful (Entry-Level)
Der Connector auf Eintragsebene durchläuft automatisch die gesamte Hierarchie verschachtelter Inhalte.
-
Contentful (Field-Level)
Auswählen, wie der Connector auf Feldebene verschachtelte Inhalte importieren soll.
-
-
Inhalte, die beim Hinzufügen aus dem Repository explizit ausgewählt werden, werden importiert.
-
Änderungen, die von APC erkannt werden, werden zur Übersetzung importiert.
-
-
Referenzierte Einträge importieren
-
Der Connector durchläuft die gesamte Hierarchie verschachtelter Inhalte und importiert alle übersetzbaren Felder zur Übersetzung.
-
-
-
-
Unter Übersetzbare Felder auslassen eine durch Kommas getrennte Liste erstellen, um Felder, für die aktiviert ist, vom Import in Phrase TMS auszuschließen. Die folgende Struktur verwenden:
contentTypeID:fieldID.-
Ausgelassene Felder leer lassen auswählen, wenn die aufgelisteten Felder leer bleiben sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
-
Quelle in Ziel kopieren auswählen, wenn die aufgelisteten Felder Quellwerte enthalten sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
-
-
auswählen, falls für ein bestimmtes Feld in der Ausgangssprache Daten fehlen.
Bei Bedarf einen aus der Dropdown-Liste auswählen. Dieses Gebietsschema wird bei fehlenden Daten verwendet.
Hinweis
Diese Einstellung ist unabhängig von der Contentful-Fallback-Sprache.
-
Bei Bedarf die (BETA) angeben.
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. Für die Live-Vorschau
contentfulapp.tldin der URL-Vorlage durch die tatsächliche Domain der Anwendung ersetzen.Weitere Informationen zum Einrichten der Inhaltsvorschau sind in der Contentful-Dokumentation zu finden.
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 das technische Support-Team die Protokollierung von Debug-Informationen anfordert, auswählen.
-
Auf Mit Contentful verbinden klicken.
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):
Die Ausgangssprache festlegen.
Hinweis
Diese Sprache sollte mit dem Standard-Gebietsschema des Contentful-Spaces übereinstimmen, das in den Gebietsschema-Einstellungen von Contentful konfiguriert wurde.
-
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
-
Optional den Connector bearbeiten und auswählen.
-
:
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:
-
Der Connector verschiebt den Workflow auf die ausgewählte Stufe (z. B. Übersetzung in Bearbeitung), wenn die Quellartikel heruntergeladen werden.
Beim Export nach Contentful:
-
Der Connector setzt die Workflow-Stufe der Quellartikel auf die ausgewählte Stufe (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.
-