-
Business- und Enterprise-Pläne (nicht für LSP-Pläne verfügbar)
Kontaktiere Vertrieb für Fragen zur Lizenzierung.
Tipp
Weitere Informationen zur Contentful-Integration in Phrase Strings finden sich unter Contentful (Strings).
Contentful bietet ein Headless-Content-Management-System zum Erstellen, Verwalten und Verteilen von Inhalten auf jeder Plattform oder jedem 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 angepasste Erfahrung
Hinweis
Der Connector 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-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)
Verwende den Contentful (Entry-Level)-Connector.
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)
Verwende den Contentful (Field-Level)-Connector.
Der Field-Level-Connector funktioniert nur mit Inhaltstypen, die ein übersetzbares Feld (z. B. entweder ein Text- oder Rich Text-Feld mit aktivierter Lokalisierung) und optional Media Assets aufweisen. Er importiert referenzierte Einträge und deren übersetzbare Felder (sofern Referenzfelder lokalisiert sind).
Wichtig
Die Legacy-Connectoren werden am außer Betrieb genommen 30. November 2026. Neue Instanzen dieser Connectoren können bis zum 17. August 2026 erstellt werden. Migriere vor dem Abkündigungsdatum auf den neuen Connector.
Unter Legacy Connector Deprecation ist eine vollständige Migrationsanleitung verfügbar.
Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:
-
Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen. Inhalte sind über die Entry ID durchsuchbar.
-
Richte das Submitter-Portal so ein, dass Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können. Inhalte sind nach Entry ID durchsuchbar.
-
Verwenden Sie Automatisierte Projekterstellung (APC), um automatisch neue Projekte erstellen zu 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. Dies ermöglicht Content-Editoren oder Managern, die volle Kontrolle über den Lokalisierungsprozess zu behalten und Statusaktualisierungen direkt beim Anzeigen eines Eintrags zu erhalten.
Sobald der Eintrag fertiggestellt wurde:
-
Wähle die gewünschten Zielsprachen für die Lokalisierung aus.
-
Übermittle nur den Eintrag mit den ausgewählten Sprachen an Phrase TMS oder nutze die Registerkarte Feldauswahl, 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 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.
-
Einzelne Zielsprachen bei der gesammelten Einreichung angeben.
-
Überblick über aktive Übersetzungsaufträge erhalten.
-
Contentful-Einstellungen
Bei der Arbeit mit der Phrase TMS-Anwendung:
-
Lade die Phrase TMS-Anwendung aus dem Marketplace herunter.
-
Installiere die Anwendung im aktuell aktiven Bereich und wähle die Content-Modelle aus, für die die Anwendung installiert werden muss.
-
Gib das Phrase TMS Auth token ein, das beim Erstellen des Connectors in Phrase TMS erhalten wurde.
-
Klicke auf Installieren.
Optional – App starten (von Contentful als veraltet markiert)
Wenn du Workflow-Unterstützung über die Launch App von Contentful nutzt, befolge diese Schritte:
-
Installiere die Launch-Anwendung von Contentful in einem oder mehreren Spaces.
Hinweis
Pro Space kann nur ein Workflow erstellt werden. Wenn innerhalb eines Contentful-Space unterschiedliche Ansätze für Inhaltstypen erforderlich sind, wende dich an deinen zuständigen Customer Success Manager.
-
Richte den erforderlichen Lokalisierungs-Workflow ein.
-
Wähle den oder die Inhaltstypen aus, die dem beschriebenen Workflow folgen sollen.
Wenn Workflows in einem Connector festgelegt sind, erstellt die automatisierte Projekterstellung (APC) automatisch neue Projekte, sobald eine Änderung der Workflow-Schritte für überwachte Artikel oder Inhaltstypen erkannt wird.
Übermittelte Aufträge können storniert werden, sodass Inhalte nach vorgenommenen Ä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.
-
Scrolle auf der Seite Einstellungen
nach unten zum Abschnitt .
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Klicke auf Neuen Connector.
Die Seite wird geöffnet.
-
Ändere den Typ auf Contentful 2.0.
-
Gib einen Namen für den Connector ein.
-
Klicke auf Mit Contentful 2.0 verbinden.
Das Contentful-Anmeldefenster wird geöffnet.
-
Gib deine Anmeldedaten ein und klicke auf Anmelden (oder verwende alternative Anmeldemethoden). Das Anmeldefenster wird geschlossen und wird angezeigt.
-
Wähle optional das Kontrollkästchen Phrase Contentful App aus, wenn du den Connector mit der App verwendest.
-
Klicke auf Generate token.
Das Fenster wird geöffnet.
-
Klicke auf Generate token.
Es wird ein Token generiert, das in die Zwischenablage oder eine Textdatei kopiert werden sollte. Stelle sicher, dass das Token kopiert wurde, bevor du das Fenster schließt, da es danach nicht mehr sichtbar ist. Dieses Token wird verwendet, wenn eine Verbindung zur App hergestellt wird.
-
Schließe das Fenster und wird angezeigt.
-
-
Wenn Contentful Tags verwendet werden, um übersetzbare Inhalte zu identifizieren, gib eine Tag-ID ein und drücke Enter.
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.
-
Wähle bei Bedarf aus.
-
Wähle bei Bedarf (verschachtelte Inhalte) aus.
Die werden angezeigt. Wenden Sie die gewünschten Filter an, um eine genauere Kontrolle darüber zu erhalten, wie das System Inhaltsbeziehungen durchläuft.
-
Begrenzt, wie weit Phrase beim Import referenzierten Einträgen folgt.
Der Standardwert ist 10.000. Wähle bei Bedarf andere Werte aus oder gib einen benutzerdefinierten Ganzzahlwert ein.
-
Wähle aus, ob bei Einträgen, deren Inhaltstyp mit der angegebenen Liste übereinstimmt, angehalten oder diesen gefolgt werden soll.
-
Schließe Einträge aus, deren übergeordneter Inhaltstyp mit der angegebenen Liste übereinstimmt.
-
Wähle aus, ob bei Einträgen, die über eines der angegebenen Inhalts-Tags verfügen, angehalten oder ob diesen gefolgt werden soll.
-
Wähle aus, ob bei Einträgen, auf die durch die angegebenen Feld-IDs verwiesen wird, angehalten oder ob diesen gefolgt werden soll.
-
-
Wähle bei Bedarf aus.
Das Feld wird angezeigt. Gib einen Wert ein, 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. Der Bereich 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 einfach weggelassen.
-
Wenn ein Projekt keinen Feature-/Bildschirmkontext erfordert, wird empfohlen, die Taxonomie deaktiviert zu lassen, um die Leistung beim .XLIFF-Export zu optimieren.
-
-
Wähle bei Bedarf aus.
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/zum neuen Alias-Ziel reimportiert/exportiert.
-
(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 diesen Alias und diesen Inhalt; Jobs werden dorthin exportiert und von dort reimportiert.
-
APCs und erstellte Jobs sind an den Alias selbst gebunden. APCs überwachen nur diesen Alias und diesen Inhalt; Jobs werden dorthin exportiert und von dort reimportiert.
Wenn das Alias-Ziel geändert wird, überwachen APCs das neue Alias-Ziel (Umgebung); Jobs werden nun dorthin exportiert und von dort reimportiert.
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. Füge diesen Zugriff in Contentful unter im Abschnitt der Rolle hinzu. Wenn der Alias später auf eine andere Umgebung umgestellt wird, füge auch den Zugriff auf die neue Umgebung hinzu.
-
-
Gib bei Bedarf die an.
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 den Contentful-Inhalt rendert. Um die Live-Vorschau zu verwenden, ersetze
contentfulapp.tldin der URL-Vorlage durch die tatsächliche Domain der Anwendung.Weitere Informationen zur Einrichtung der Content-Vorschau 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.
-
-
Verwende bei Bedarf , um bestimmte Felder vom Import in Phrase auszuschließen. Gib die ContentIDs an, die vom Import ausgeschlossen werden sollen.
-
Gib und für die an (erforderlich).
Die Vorschau-API erfordert ein Contentful-Zugriffstoken namens , das in den API-Einstellungen des Contentful-Space konfiguriert werden sollte.
Die Contentful 2.0-Integration verwendet diese API für den Import von Inhalten und die Überwachung von Änderungen (APC).
-
Wähle jeden Space und jede Umgebung aus, 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 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 bei 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, auch wenn sich seine Quelle nicht geändert hat. Bei Bereichen mit hohem Volumen kann dies APC-Ausführungen verlangsamen und die Contentful-API-Nutzung erheblich erhöhen.
Um dies zu reduzieren:
-
Entferne das Übersetzungstag, sobald ein Eintrag fertig ist, und füge es nur hinzu, wenn er erneut übersetzt werden muss.
-
Beschränke die Einstellungen für auf die Einträge, die übersetzt werden müssen.
-
Verwende die Phrase Contentful App, die nur Einträge überwacht, die über sie eingereicht wurden.
Wichtig
Wenn du von einer benutzerdefinierten Domain (z. B. mydomain.phrase.jp) aus zugreifst, öffne ein Inkognito-Browserfenster und melde dich über cloud.memsource.com oder us.cloud.memsource.com an, 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.
-
Scrolle auf der Seite Einstellungen
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Klicke auf Neuer Connector.
Die Seite wird geöffnet.
-
Ändere den Type in either Contentful (Entry-Level) or 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, widerruf 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 in der Connector-Konfiguration eingerichteten Sprache.
Beispiel:
Hinweis
Nicht anwendbar bei Verwendung der Anwendung.
-
-
Wähle über Entry import mode, 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 Entry import mode-Connector durchläuft automatisch die gesamte Hierarchie verschachtelter Inhalte.
-
Contentful (Feldebene)
Wähle aus, wie der field-level connector verschachtelte Inhalte importieren soll.
-
-
Inhalte, die beim Hinzufügen aus dem Repository explizit ausgewählt werden, werden importiert.
-
Von APC erkannte Änderungen werden zur Übersetzung importiert.
-
-
Referenzierte Einträge importieren
-
Der Connector durchläuft die gesamte Hierarchie verschachtelter Inhalte und importiert alle übersetzbaren Felder zur Übersetzung.
-
-
-
-
Erstelle eine kommagetrennte Liste in Omit translatable fields, um Felder, die für geprüft werden, vom Import in Phrase TMS auszuschließen. Verwende die folgende Struktur:
contentTypeID:fieldID.-
Wähle Leave omitted fields empty, wenn die aufgeführten Felder leer bleiben sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
-
Wähle Copy source to target, wenn die aufgeführten Felder Quellwerte enthalten sollen. Diese Einstellung wird auf alle aufgelisteten Einträge angewendet.
-
-
Wähle , falls für ein bestimmtes Feld in der Ausgangssprache Daten fehlen.
Wähle bei Bedarf eine aus der Dropdown-Liste. Diese Sprach-Locale wird verwendet, falls Daten fehlen.
Hinweis
Es besteht keine Beziehung zwischen der Contentful-Fallback-Sprache und dieser Einstellung.
-
Gib bei Bedarf die (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 verwenden, wird
contentfulapp.tldin der URL-Vorlage durch die tatsächliche Domain der Anwendung ersetzt.Weitere Informationen zur Einrichtung der Content-Vorschau finden sich in der Contentful-Dokumentation.
Sprache wird zurzeit nicht als Platzhalter unterstützt. Für die Verwendung des Gebietsschemas in der URL ist ein fester Wert anzugeben und es sind mehrere Connector-Instanzen zu erstellen.
-
-
Wird vom technischen Support-Team die Protokollierung von Debug-Informationen angefordert, ist auszuwählen.
-
Durch einen Klick auf Connect to Contentful wird die Verbindung aufgebaut.
Ein Häkchen wird in der Connector-Einrichtung angezeigt, wenn die Verbindung erfolgreich hergestellt wurde. Ein rotes Ausrufezeichen wird angezeigt, wenn nicht. Bewege die Maus über das Symbol, um weitere Details anzuzeigen.
-
Nur Contentful (Entry-Level):
Die Quellsprache ist festzulegen.
Hinweis
Diese Sprache sollte mit dem Standard-Gebietsschema des Contentful-Space übereinstimmen, das in den Gebietsschema-Einstellungen von Contentful konfiguriert ist.
-
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
-
Optional kann der Connector bearbeitet werden, um 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
-
Der Connector verschiebt den Workflow in die ausgewählte Phase (z. B. Übersetzung läuft), wenn die Quellartikel heruntergeladen werden.
Beim Export nach Contentful
-
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.
-
Einen Connector löschen
So löschen Sie einen Connector:
-
Auf der Seite ist der Connector auszuwählen, der gelöscht werden soll.
-
Auf Delete ist zu klicken.
Das Fenster öffnet sich.
-
„delete“ ist einzugeben und anschließend auf Delete zu klicken.
Der Connector wird gelöscht und die Liste der Connectoren wird angezeigt.
Hinweis
Ein Connector kann nicht gelöscht werden, solange er noch mit unvollständigen Aufträgen in einem Projekt verknüpft ist, einschließlich Aufträgen im Papierkorb. Der Versuch, einen solchen Connector zu löschen, führt zu der Fehlermeldung „Failed to delete connector“.
Lösung: Das mit dem Connector verknüpfte Projekt ist zu öffnen und alle verbleibenden Aufträge sind entweder abzuschließen oder zu löschen. Zu navigieren und diesen leeren, um alle noch mit dem Connector verknüpften Aufträge zu entfernen. Es sollte ein erneuter Löschvorgang für den Connector in Angriff genommen werden.