Champs de fusion
TrueSign relie Salesforce et le document signé dans deux sens opposés, à deux moments différents. Les confondre est la première cause d'incompréhension.
| Champs de fusion | Writeback | |
|---|---|---|
| Sens | Salesforce → document | Document → Salesforce |
| Quand | À l'envoi | À la complétion de la signature |
| Ce que ça fait | Pré-remplit le document avec la donnée du record | Récupère ce que le signataire a saisi et l'écrit sur un record |
| Où ça se règle | Éditeur de template › Champs de fusion | Le même éditeur › Writeback |
1. D'où vient la valeur
Le chemin Salesforce (Account.Name, Amount, Description…) est lu sur l'enregistrement d'où part l'envoi. Les chemins relationnels sont suivis : depuis une Opportunité, Account.Industry va bien chercher le secteur du compte lié.
La valeur est mise en forme selon la locale d'envoi de l'org (français par défaut) :
- Montant →
24 500,00 €(séparateur de milliers, symbole après le nombre en français) - Date →
05/03/2026— toujours avec le zéro de tête, pour qu'une date de contrat ne puisse pas se lire à l'envers - Case à cocher →
Oui/Non
2. Où le champ se pose — les deux modes
C'est le réglage le plus structurant, et celui qui surprend le plus souvent.
Mode ancre. Vous écrivez un jeton dans le document (par exemple {{client}}) et TrueSign le remplace par la valeur, exactement à sa place, en gardant la mise en forme du texte autour.
Mode coordonnées. Vous donnez une page et une position X/Y, et TrueSign imprime la valeur à ce point. Voir Positionnement des champs.
Dans les deux modes, TrueSign pose uniquement la valeur. Il n'écrit jamais « Client : » devant. Le libellé doit déjà exister dans le document lui-même — c'est votre modèle PDF ou Word qui le porte.
Si vous placez cinq champs par coordonnées sur une page vierge, vous obtiendrez cinq valeurs empilées, sans aucun intitulé. Ce n'est pas un dysfonctionnement : c'est le document de départ qui est vide. Le fonctionnement est identique chez DocuSign.
En pratique : partez d'un document déjà rédigé, qui contient « Client : », « Montant : », et posez le champ à droite de ce texte — ou utilisez une ancre placée juste après.
Un champ sans ancre et sans coordonnées est simplement ignoré à l'envoi.
3. Lecture seule ou saisissable
- Lecture seule — la valeur est figée. C'est ce que l'expéditeur affirme : un montant, une raison sociale. Le signataire la lit, ne la modifie pas.
- Saisissable — le champ est pré-rempli mais reste modifiable. C'est le seul cas où le writeback a un sens : il n'y a de valeur à rapporter que si quelqu'un a pu la changer.
4. Types disponibles
| Type | Comportement pour le signataire |
|---|---|
| Texte | Champ libre |
| Date | Vrai sélecteur de date |
| Case à cocher | Cochée / décochée — un booléen Salesforce coché arrive coché |
| Boutons radio | Choix unique parmi une liste d'options |
| Liste déroulante | Choix unique dans un menu |
| Signature / Paraphe | Zone de signature ou d'initiales |
Un champ peut être masqué ou désactivé conditionnellement selon la valeur d'un autre champ — voir Logique conditionnelle.
5. Validation de saisie
Les champs saisissables acceptent une validation de type : date, nombre, e-mail ou expression régulière. Une saisie non conforme est refusée au moment de signer — la donnée qui revient dans Salesforce est propre.
Ne mappez jamais un montant ou une date en « texte brut » : utilisez les types dédiés, qui mettent la valeur en forme (24 500,00 €, 05/03/2026) avant injection. La valeur brute Salesforce n'est pas présentable dans un contrat.
6. Diagnostic
| Symptôme | Cause la plus fréquente |
|---|---|
| Les valeurs apparaissent sans intitulé | Le document de départ ne contient pas les libellés — voir §2 |
| Un champ n'apparaît pas du tout | Ni ancre ni coordonnées renseignées : le champ est ignoré |
| Un champ relationnel sort vide | Le lookup est vide sur l'enregistrement (pas de compte lié, par exemple) |
| Une valeur attendue est vide | Le champ n'est pas lisible par l'expéditeur : un champ masqué par la sécurité au niveau champ rend vide, il ne fuit jamais |