Artefacts de contenu Payload

Traduisez les champs sélectionnés de Payload CMS et le texte Lexical pris en charge, tout en conservant la structure nécessaire à la réécriture côté fournisseur.

Une page Payload associe du contenu lisible à des identifiants, des relations, des fichiers téléversés et une structure propre à l’éditeur. L’intégration sélectionne d’abord les champs localisés et assemble un artefact à traduire. Le gestionnaire payload traduit ensuite les valeurs textuelles simples et le texte Lexical pris en charge dans cet artefact.

Utilisez l’intégration Payload pour sélectionner le contenu et le réécrire. L’envoi direct d’un enregistrement CMS non filtré contourne la sélection des champs effectuée par le fournisseur et peut inclure des données qui n’ont jamais été destinées à la traduction.

Champs sélectionnés et texte enrichi #

Un artefact composé de champs sélectionnés peut contenir un titre et une arborescence Lexical :

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

Le titre et le contenu textuel pris en charge constituent les éléments à traduire. Les types de nœuds Lexical, les données de mise en forme et la structure en ligne prise en charge guident la reconstruction. Les destinations des liens, les fichiers téléversés, les relations et les champs structurels des blocs ne deviennent pas du texte à traduire du seul fait qu’ils contiennent des chaînes de caractères. Le texte localisé sélectionné dans les champs de blocs pris en charge peut néanmoins être traduit après filtrage côté fournisseur.

Dans Lexical, les segments de texte pris en charge conservent leur mise en forme et leur structure en ligne. Il faut vérifier que les nœuds personnalisés correspondent à la représentation prise en charge ; la prise en charge de Lexical ne s’étend pas à l’arborescence de documents de n’importe quel éditeur.

Correspondance entre source et cible #

Les chemins des champs source et cible permettent d’identifier les valeurs correspondantes. Lorsqu’une cible existante est fournie sans source précédente, le gestionnaire reprend les valeurs cibles correspondantes déjà présentes et traduit les éléments manquants. Il n’écrase pas tous les champs localisés existants au seul motif qu’il s’agit de la première synchronisation enregistrée.

Lorsqu’une source précédente est disponible, les unités source modifiées et les valeurs cibles manquantes doivent être traitées. Un document CMS existant peut n’être que partiellement traduit : sa présence ne garantit donc pas que la traduction est complète. La reconstruction part de l’artefact source sélectionné et y insère les valeurs prises en charge, qu’elles soient traduites ou conservées ; elle sérialise le JSON au lieu de préserver les octets de la source.

L’alignement du texte enrichi doit être vérifié après modification. Une modification de la structure des paragraphes ou d’un nœud personnalisé peut affecter la correspondance, même si certains mots restent identiques. Vérifiez le champ CMS obtenu et le contenu affiché, et pas seulement la validité de l’artefact.

Relier la sélection à la réécriture #

L’intégration Payload assure la sélection du schéma, la lecture des langues, la configuration de la connexion et la réécriture. Le paquet Payload CMS documente les exports du plugin. Maintenez ces étapes côté fournisseur en amont et en aval du gestionnaire d’artefacts pour que les champs sélectionnés soient réécrits dans le bon document et la bonne langue.

Après la réécriture, ouvrez le document CMS localisé et examinez aussi bien les champs simples que le texte enrichi. Suivez les liens, vérifiez les relations intégrées et comparez les champs couverts dans la cible à ceux sélectionnés dans la source. La reconstruction de l’artefact n’accorde aucun droit d’écriture côté fournisseur et ne détermine pas si le contenu est prêt à être publié.