Artefatos de conteúdo do Payload
Traduza campos selecionados do Payload CMS e textos compatíveis do Lexical, preservando a estrutura usada para gravar os dados de volta no provedor.
Uma página do Payload combina conteúdo legível com IDs, relacionamentos, arquivos enviados e a estrutura do editor. Primeiro, a integração seleciona os campos localizados e monta um artefato para tradução. Em seguida, o manipulador payload traduz os valores simples e os textos do Lexical compatíveis nesse artefato.
Use a integração com o Payload para selecionar o conteúdo e gravá-lo de volta. Enviar um registro do CMS diretamente, sem filtragem, ignora a seleção de campos do provedor e pode incluir dados que nunca foram destinados à tradução.
Campos selecionados e texto formatado #
Um artefato com campos selecionados pode conter um título e uma árvore Lexical:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}O título e o conteúdo textual compatível são o material a ser traduzido. Os tipos de nós do Lexical, os dados de formatação e a estrutura em linha compatível orientam a reconstrução. Destinos de links, arquivos enviados, relacionamentos e campos estruturais de blocos não passam a ser prosa só porque contêm cadeias de caracteres. Textos localizados selecionados em campos de blocos compatíveis ainda podem ser traduzidos após a filtragem pelo provedor.
No Lexical, os trechos de texto compatíveis preservam a formatação e a estrutura em linha. É preciso verificar se os nós personalizados são compatíveis com a representação aceita; o suporte ao Lexical não se estende à árvore de documentos de um editor qualquer.
Correspondência entre origem e destino #
Os caminhos dos campos de origem e destino identificam os valores correspondentes. Quando um destino existente é fornecido sem uma origem anterior, o manipulador aproveita os valores correspondentes já presentes no destino e traduz o que falta. Ele não sobrescreve todos os campos localizados existentes só porque esta é a primeira sincronização registrada.
Quando há uma origem anterior, as unidades de origem alteradas e os valores ausentes no destino precisam ser processados. Um documento existente no CMS pode estar apenas parcialmente traduzido, portanto sua presença não comprova que a tradução esteja completa. A reconstrução parte do artefato de origem selecionado e insere os valores compatíveis, traduzidos ou mantidos; esse processo serializa o JSON em vez de preservar os bytes da origem.
O alinhamento do texto formatado precisa ser verificado após as edições. Uma alteração na estrutura dos parágrafos ou em um nó personalizado pode afetar a correspondência, mesmo que algumas palavras continuem iguais. Verifique o campo resultante no CMS e o conteúdo renderizado, não apenas a validade do artefato.
Conecte a seleção à gravação no provedor #
A integração com o Payload oferece seleção de esquema, leitura por idioma, configuração da conexão e gravação de volta no provedor. O pacote do Payload CMS documenta as exportações do plugin. Mantenha essas etapas do provedor antes e depois do processamento pelo manipulador de artefatos para que os campos selecionados retornem ao documento e ao idioma corretos.
Após gravar os dados de volta, abra o documento localizado no CMS e verifique tanto os campos simples quanto o texto formatado. Acesse os links, confira os relacionamentos incorporados e compare a cobertura de campos do destino com a seleção de origem. A reconstrução do artefato não concede permissão de gravação no provedor nem determina se o conteúdo está pronto para publicação.