Génération documentaire sur le contexte de pricing

Le problème

Un devis doit sortir en PDF à la charte. L’approche classique construit une couche d’extraction pour alimenter le modèle — couche qu’il faut ensuite maintenir en parallèle de chaque évolution du modèle de devis.

Le contexte

Un modèle Word existant, et un modèle de devis que le moteur de pricing lit déjà à travers une définition de contexte.

L’architecture recommandée

Pointer le modèle de document vers la même définition de contexte que la pricing procedure. Le contrat de données existe déjà et est déjà maintenu : la couche d’extraction disparaît entièrement.

Les tokens du modèle sont alors simplement les noms des attributs du contexte.

Mise en œuvre

1. Lier le modèle au contexte plutôt qu’à un extrait sur mesure.
2. Nommer chaque token exactement comme son attribut. Les attributs custom gardent leur suffixe __c dans le token.
3. Tagger chaque attribut que vous comptez utiliser. Un attribut n’est utilisable comme token que s’il porte un context tag. Les attributs hérités sont déjà taggés et fonctionnent tout de suite ; les custom doivent être mappés, taggés et republiés — ce qui est exactement pourquoi « seuls les hérités marchent » est le premier symptôme que vous verrez.
4. Formater les dates et résoudre les noms avant le modèle. Une date brute s’affiche en horodatage ISO, et le contexte expose une référence de compte plutôt que le nom.

Ce que ça coûte

Réutiliser le contexte de pricing veut dire que les changements documentaires touchent une définition dont le pricing dépend aussi. Les ajouts sont sûrs ; le reste mérite une sandbox d’abord.

En échange, il n’y a pas de seconde couche de données à maintenir, et le document et le prix ne peuvent jamais diverger sur le contenu du devis.

Attention

• Choisissez le total qui signifie net. Un des totaux du contexte est la somme des prix de liste et gonflera le document.
• Remplacer un fichier de modèle peut changer son identifiant, ce qui casse tout bouton qui le porte en dur. Charger une nouvelle version du même fichier le garde stable.
• Un nouveau champ peut n’apparaître dans le designer qu’après rechargement de la page.

Composants Salesforce