Aller au contenu principal

Liaison de données

Les valeurs par défaut des champs de formulaire peuvent référencer les chemins $data, qui sont résolus avant la génération du PDF. Cela vous permet de créer des modèles dont les champs arrivent pré-remplis à partir de vos données — les destinataires examinent et éditent, plutôt que de partir de zéro.

Consultez Liaison de données pour le système de référence $data plus large.

Règle de citation​

Les valeurs de chaîne contenant des références $data doivent être entourées de guillemets simples dans la balise, afin que l'analyseur les transmette littéralement :

{ "p": "Full Name: [textfield, fullName, '$data.applicant.fullName', 200|20]" }

Les valeurs numériques et booléennes n'ont pas besoin de guillemets :

{ "p": "[checkbox, termsAccepted, $data.preferences.termsAccepted, 16|16] I accept the terms" }

Formulaire de révision pré-rempli​

Combinez les champs avec $data pour livrer des formulaires pré-remplis que les destinataires peuvent examiner et éditer :

{
  "table": {
    "widths": [1, 2],
    "rows": [
      [
        { "p": "Full Name:", "style": "fieldLabel" },
        { "p": "[textfield, fullName, '$data.applicant.fullName', 220|22]" }
      ],
      [
        { "p": "Email:", "style": "fieldLabel" },
        { "p": "[textfield, email, '$data.applicant.email', 220|22]" }
      ],
      [
        { "p": "Phone:", "style": "fieldLabel" },
        { "p": "[textfield, phone, '$data.applicant.phone', 220|22]" }
      ],
      [
        { "p": "Department:", "style": "fieldLabel" },
        { "p": "[choicefield, dept, Engineering|Sales|Operations, 0, 200|22]" }
      ]
    ]
  }
}

Lors de la génération avec ces données :

{
  "applicant": {
    "fullName": "Sophie Müller",
    "email": "sophie.mueller@example.com",
    "phone": "+49 30 1234 5678"
  }
}

Les champs de texte PDF résultants arrivent pré-remplis — et les destinataires peuvent toujours les éditer.

Modèles courants​

Champs optionnels​

Utilisez des valeurs par défaut vides afin que les destinataires voient des champs vierges :

{ "p": "Notes:[br][textarea, notes, , 400|80]" }

Pré-remplissage conditionnel via la couche de données​

Lorsqu'une valeur peut être manquante, fournissez une valeur par défaut au niveau de la couche de données plutôt que dans la balise — cela maintient le modèle propre :

{ "p": "Reference: [textfield, reference, '$data.shipment.reference', 220|22]" }
{ "shipment": { "reference": "" } }

Lecture seule via le style​

Les champs de formulaire restent modifiables par défaut. Pour fournir un rendu statique des valeurs, utilisez du texte de paragraphe brut au lieu d'une balise de champ.