Artefactos de conteúdo do Payload

Traduza campos selecionados do Payload CMS e texto Lexical suportado, preservando a estrutura usada para gravar os resultados no fornecedor.

Uma página do Payload combina conteúdo legível com IDs, relações, ficheiros carregados e a estrutura do editor. A integração começa por selecionar os campos localizados e criar um artefacto para tradução. Em seguida, o processador payload traduz os valores simples suportados e o texto Lexical contidos nesse artefacto.

Utilize a integração do Payload para selecionar conteúdo e voltar a gravá-lo no CMS. Enviar diretamente um registo do CMS sem o filtrar ignora a seleção de campos do fornecedor e pode incluir dados que nunca se destinaram a tradução.

Campos selecionados e texto formatado #

Um artefacto com campos selecionados pode conter um título e uma árvore Lexical:

json
{
  "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 suportado destinam-se a tradução. Os tipos de nós Lexical, os dados de formatação e a estrutura em linha suportada orientam a reconstrução. Os destinos das ligações, os ficheiros carregados, as relações e os campos estruturais dos blocos não passam a ser texto para tradução só por conterem cadeias de caracteres. Ainda assim, o texto localizado selecionado nos campos de blocos suportados pode ser traduzido após a filtragem pelo fornecedor.

No Lexical, os segmentos de texto suportados mantêm a formatação e a estrutura em linha. Os nós personalizados têm de ser verificados à luz da representação suportada; o suporte para 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 de destino identificam os valores correspondentes. Quando é fornecido um destino existente sem uma versão anterior da origem, o processador aproveita os valores de destino correspondentes já presentes e traduz o que falta. Não substitui todos os campos localizados existentes só por se tratar da primeira sincronização registada.

Quando existe uma versão anterior da origem, é necessário processar as unidades de origem alteradas e os valores de destino em falta. Um documento existente no CMS pode estar apenas parcialmente traduzido, pelo que a sua presença não garante que esteja completo. A reconstrução parte do artefacto de origem selecionado e insere os valores suportados, traduzidos ou mantidos; serializa o JSON em vez de preservar os bytes de origem.

O alinhamento do texto formatado tem de ser verificado após as edições. Uma alteração na estrutura de um parágrafo ou num nó personalizado pode afetar a correspondência, mesmo que algumas palavras se mantenham. Verifique o campo resultante no CMS e o conteúdo apresentado, não apenas a validade do artefacto.

Da seleção à gravação dos resultados #

A integração do Payload assegura a seleção do esquema, a leitura por idioma, a configuração da ligação e a gravação dos resultados. O pacote do Payload CMS documenta as exportações do plugin. Mantenha esses passos do fornecedor antes e depois do processamento do artefacto, para que os campos selecionados sejam gravados no documento e no idioma corretos.

Depois de gravar os resultados, abra o documento localizado no CMS e verifique tanto os campos simples como o texto formatado. Siga as ligações, verifique as relações incorporadas e compare os campos abrangidos no destino com a seleção de origem. A reconstrução do artefacto não concede permissão de escrita no fornecedor nem determina se o conteúdo está pronto para publicação.