Inhaltsartefakte aus Payload
Übersetze ausgewählte Felder aus Payload CMS und unterstützten Lexical-Text, ohne die Struktur für das Zurückschreiben durch den Anbieter zu verändern.
Eine Payload-Seite verbindet lesbare Inhalte mit IDs, Beziehungen, Uploads und der Editorstruktur. Die Integration wählt zunächst lokalisierte Felder aus und erstellt daraus ein Artefakt für die Übersetzung. Der payload-Handler übersetzt anschließend die unterstützten einfachen Werte und den Lexical-Text in diesem Artefakt.
Verwende die Payload-Integration, um Inhalte auszuwählen und zurückzuschreiben. Wenn du einen ungefilterten CMS-Datensatz direkt übermittelst, umgehst du die Feldauswahl des Anbieters. So können auch Daten einbezogen werden, die nie für eine Übersetzung vorgesehen waren.
Ausgewählte Felder und Rich Text #
Ein Artefakt aus ausgewählten Feldern kann einen Titel und einen Lexical-Baum enthalten:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}Der Titel und die unterstützten Textinhalte sind für die Übersetzung vorgesehen. Lexical-Knotentypen, Formatierungsdaten und unterstützte Inline-Strukturen bestimmen, wie die Inhalte rekonstruiert werden. Linkziele, Uploads, Beziehungen und strukturelle Blockfelder werden nicht allein dadurch zu Fließtext, dass sie Zeichenfolgen enthalten. Ausgewählter lokalisierter Text in unterstützten Blockfeldern lässt sich nach der Filterung durch den Anbieter weiterhin übersetzen.
In Lexical bleiben Formatierung und Inline-Struktur unterstützter Textabschnitte erhalten. Benutzerdefinierte Knoten müssen mit der unterstützten Darstellung abgeglichen werden. Die Lexical-Unterstützung gilt nicht für den Dokumentbaum eines beliebigen Editors.
Quelle und Ziel zuordnen #
Die Feldpfade in Quelle und Ziel kennzeichnen die jeweils zusammengehörigen Werte. Wird ein vorhandenes Ziel ohne vorherige Quelle bereitgestellt, übernimmt der Handler die vorhandenen passenden Zielwerte und übersetzt die fehlenden Inhalte. Er überschreibt nicht sämtliche vorhandenen lokalisierten Felder, nur weil es sich um die erste protokollierte Synchronisierung handelt.
Liegt eine vorherige Quelle vor, müssen geänderte Quelleinheiten und fehlende Zielwerte bearbeitet werden. Ein vorhandenes CMS-Dokument kann nur teilweise übersetzt sein. Dass es existiert, bedeutet also nicht, dass es vollständig ist. Die Rekonstruktion beginnt mit dem ausgewählten Quellartefakt und fügt unterstützte übersetzte oder beibehaltene Werte ein. Dabei wird JSON serialisiert, statt die ursprünglichen Bytes zu erhalten.
Nach Änderungen muss die Zuordnung im Rich Text kontrolliert werden. Eine veränderte Absatzstruktur oder ein benutzerdefinierter Knoten kann die Zuordnung beeinflussen, selbst wenn einige Wörter unverändert bleiben. Kontrolliere das resultierende CMS-Feld und die gerenderten Inhalte, nicht nur die Gültigkeit des Artefakts.
Feldauswahl und Zurückschreiben verbinden #
Die Payload-Integration übernimmt die Schemaauswahl, das Lesen der Sprachversionen, die Einrichtung der Verbindung und das Zurückschreiben. Im Payload-CMS-Paket sind die Plugin-Exporte dokumentiert. Behalte diese Anbieterschritte vor und nach der Verarbeitung durch den Artefakt-Handler bei, damit die ausgewählten Felder in das richtige Dokument und die richtige Sprache zurückgeschrieben werden.
Öffne nach dem Zurückschreiben das lokalisierte CMS-Dokument und sieh dir sowohl die einfachen Felder als auch den Rich Text an. Folge den Links, kontrolliere eingebettete Beziehungen und vergleiche die im Ziel abgedeckten Felder mit der Quellauswahl. Die Rekonstruktion des Artefakts erteilt keine Schreibberechtigung beim Anbieter und entscheidet nicht darüber, ob die Inhalte bereit für die Veröffentlichung sind.