Artefactos de contenido de Payload

Traduce los campos seleccionados de Payload CMS y el texto compatible de Lexical sin perder la estructura necesaria para guardar los resultados en el proveedor.

Una página de Payload combina contenido legible con IDs, relaciones, archivos cargados y la estructura del editor. Primero, la integración selecciona los campos localizados y crea un artefacto para su traducción. Luego, el controlador payload traduce los valores simples compatibles y el texto de Lexical dentro de ese artefacto.

Usa la integración de Payload para seleccionar contenido y guardar los resultados en el proveedor. Enviar directamente un registro del CMS sin filtrar omite la selección de campos del proveedor y puede incluir datos que nunca estuvieron destinados a traducirse.

Campos seleccionados y texto enriquecido #

Un artefacto con los campos seleccionados puede contener un título y un árbol de Lexical:

json
{
  "title": "Delivery options",
  "body": {
    "root": {
      "type": "root",
      "children": [
        {
          "type": "paragraph",
          "children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
        }
      ]
    }
  }
}

El título y el contenido de texto compatible son el material que se traduce. Los tipos de nodos de Lexical, los datos de formato y la estructura en línea compatible guían la reconstrucción. Los destinos de los enlaces, los archivos cargados, las relaciones y los campos estructurales de los bloques no se convierten en prosa solo por contener cadenas de texto. El texto localizado que se seleccione dentro de campos de bloque compatibles sí puede traducirse después de que el proveedor aplique el filtro.

En Lexical, los segmentos de texto compatibles conservan el formato y la estructura en línea. Los nodos personalizados deben revisarse para comprobar que se ajusten a la representación compatible; la compatibilidad con Lexical no se extiende al árbol de documentos de cualquier editor.

Correspondencia entre origen y destino #

Las rutas de los campos de origen y destino identifican los valores correspondientes. Cuando se proporciona un destino existente sin un origen anterior, el controlador conserva los valores de destino que ya tienen correspondencia y traduce los que faltan. No sobrescribe todos los campos localizados existentes solo porque sea la primera sincronización registrada.

Cuando hay un origen anterior, se deben procesar las unidades de origen modificadas y los valores de destino que faltan. Un documento existente del CMS puede estar parcialmente traducido, así que su presencia no garantiza que esté completo. La reconstrucción parte del artefacto de origen seleccionado e inserta los valores compatibles, ya sean traducidos o conservados; serializa JSON en lugar de conservar los bytes del origen.

Revisa la alineación del texto enriquecido después de hacer cambios. Un cambio en la estructura de un párrafo o en un nodo personalizado puede afectar la correspondencia, aunque algunas palabras sigan siendo las mismas. Verifica el campo resultante del CMS y el contenido renderizado, no solo la validez del artefacto.

Vincula la selección con el guardado de resultados #

La integración de Payload proporciona la selección del esquema, la lectura por idioma, la configuración de la conexión y el guardado de resultados en el proveedor. El paquete de Payload CMS documenta las exportaciones del complemento. Mantén esos pasos del proveedor antes y después del procesamiento del artefacto para que los campos seleccionados vuelvan al documento y al idioma correctos.

Después de guardar los resultados en el proveedor, abre el documento localizado del CMS y revisa tanto los campos simples como el texto enriquecido. Sigue los enlaces, verifica las relaciones incrustadas y compara la cobertura de campos del destino con la selección del origen. La reconstrucción del artefacto no otorga permisos de escritura en el proveedor ni determina si el contenido está listo para publicarse.