L'application DocTemplates vous permet de générer vos documents Boond (dossiers techniques, contrats, factures, devis…) au format Word (.docx) ou PDF, à vos couleurs, à partir de vos propres modèles Word. Cet article s'adresse aux administrateurs qui installent l'application et créent les modèles. [À VÉRIFIER : offres concernées – toutes les offres ?]
Pré-requis
Pour installer DocTemplates et charger des modèles, vous devez disposer des droits d'accès à l'Administration de Boond, section Marketplace.
Vos modèles doivent être des documents Word au format .docx.
⠀
1 - Installer l'application DocTemplates
Administration > Apps/Marketplace > onglet Marketplace > DocTemplates
Pour installer l'application DocTemplates, rendez-vous dans la Marketplace de l'Administration Boond.
Ouvrez Administration, puis Apps/Marketplace.
Dans l'onglet Marketplace, recherchez DocTemplates.
Cliquez sur Installer.
Une fois DocTemplates installée, l'application apparaît dans vos applications et vous pouvez charger vos modèles (voir section 4).
2 - Créer votre modèle Word avec les variables DocTemplates
Pour créer votre modèle DocTemplates, vous rédigez un document Word classique dans lequel vous insérez des variables. Au moment de la génération, DocTemplates remplace chaque variable par la donnée correspondante de la fiche Boond.
Quels documents pouvez-vous créer avec DocTemplates ?
DocTemplates vous permet de créer des modèles pour les documents suivants :
Dossiers techniques (DT) des candidats et des ressources
Contrats RH et contrats de sous-traitance
Documents administratifs (prêt de matériel, autorisations diverses…)
Factures et avoirs
Devis
Prestations et ordres de mission
Commandes et bon de livraison
Besoins (offre commerciale)
Achats
Partir d'un exemple de modèle DocTemplates
Pour gagner du temps, vous pouvez partir des exemples de modèles DocTemplates mis à disposition par Boond et les adapter à votre charte graphique.
La liste complète des variables, classée par type de document, est disponible dans la documentation des variables DocTemplates. Pour chaque variable, elle indique le libellé, un exemple de résultat, la fiche et l'onglet où la donnée est renseignée dans Boond, et le type de variable (simple, liste ou table).
Écrire une variable DocTemplates
Une variable DocTemplates s'écrit entre deux symboles dollar, sans espace : $nomDeLaVariable$. Vous pouvez la mettre en forme (gras, souligné, couleur) comme n'importe quel texte Word : la mise en forme est conservée dans le document généré.
Exemple : pour une ressource Monsieur Nicolas LEFRANC dont l'email est [email protected], la phrase « L'adresse email de $civility$ $firstName$ $lastName$ est $email1$. » devient « L'adresse email de Monsieur Nicolas LEFRANC est [email protected]. »
Attention au symbole $
Attention : DocTemplates utilise le symbole $ pour repérer les variables. N'écrivez jamais le symbole $ à la main dans votre modèle (par exemple « 1 000 $ ») : il serait lu comme le début d'une variable et bloquerait le chargement du modèle. Pour afficher une devise, utilisez la variable prévue, par exemple $currencySymbol$ (symbole de la devise) ou $currency$ (code de la devise, par exemple EUR) sur une facture ou un devis.
Les trois types de variables DocTemplates : simple, liste et table
Chaque variable DocTemplates a un type, indiqué dans la colonne « Type de variable » de la documentation. Le type détermine où placer la variable dans votre document Word.
Variable simple : elle contient une seule valeur (texte ou nombre), comme le nom d'une ressource. Insérez-la directement dans le texte. Exemple :
$lastName$.Variable liste : elle contient plusieurs valeurs, comme les domaines d'un dossier technique. Placez-la dans une liste à puces (ou numérotée) d'un seul élément : DocTemplates crée une puce par valeur. Exemple : une puce contenant
$activityAreas$devient « • Développeur Web » et « • Certification 1 ».Variable table : elle contient plusieurs lignes, comme les langues et leur niveau. Placez-la dans une ligne de tableau Word : DocTemplates crée une ligne de tableau par élément, avec les colonnes définies dans votre modèle. Exemple : une ligne de tableau contenant
$languages.language$et$languages.level$devient « Anglais | Courant » puis « Allemand | Maternel ».
Les modificateurs de variables DocTemplates : count, col, join et literal
Les modificateurs DocTemplates transforment la valeur d'une variable au moment de la génération. Ils s'écrivent après la variable, séparés par une barre verticale : $variable|modificateur$. Vous pouvez en enchaîner plusieurs : $variable|modificateur1|modificateur2$.
count (variables liste ou table) : affiche le nombre d'éléments. Exemple :
$activityAreas|count$affiche « 3 » si la ressource a 3 domaines.join (variables liste) : transforme la liste en texte, valeurs séparées par une virgule. Exemple :
$activityAreas|join$affiche « Formation, Conseil en technologie, Internet & multimédia ».col (variables table) : extrait une colonne de la table sous forme de liste ; il est souvent suivi de join. Exemple :
$languages|col('language')|join$affiche « anglais, allemand ».literal (variables simples contenant un nombre) : écrit le nombre en toutes lettres. Exemple : pour un salaire mensuel de 2800,
$monthlySalary|literal$affiche « deux mille huit cent ».
Afficher la date du jour dans un modèle DocTemplates
Pour afficher la date du jour de génération dans votre modèle DocTemplates, utilisez l'une des variables suivantes (exemples pour le lundi 11 janvier 2016) :
$TODAY$: 11/01/2016$TODAY_MEDIUM$: 11 janv. 2016$TODAY_LONG$: 11 janvier 2016$TODAY_FULL$: lundi 11 janvier 2016
Chaque type de modèle a ses propres variables
Attention : les variables DocTemplates disponibles dépendent du type de document. Par exemple, un modèle de contrat RH ne peut pas utiliser les variables propres à une prestation. Utilisez uniquement les variables de l'onglet de la documentation qui correspond à votre type de modèle.
Factures et devis : séparez le tableau des totaux
Attention : dans un modèle DocTemplates de facture ou de devis, placez les totaux dans un tableau séparé de celui qui contient les lignes de facture ou de devis. Si les totaux sont dans le même tableau, le document ne se génère pas correctement.
3 - Nommer votre modèle DocTemplates pour qu'il soit sélectionné automatiquement
Le nom du fichier de votre modèle DocTemplates permet d'imposer le format PDF et de sélectionner automatiquement le bon modèle selon la fiche (pôle, agence juridique) et la langue de l'utilisateur. Ces règles de nommage sont aussi affichées dans chaque rubrique de la configuration DocTemplates.
Vous devez modifier le nom de votre fichier avant de le déposer comme modèle.
Dans chaque rubrique, nous vous affichons les instructions de nommage des templates à respecter.
Comment écrire les champs dans le nom du fichier docx
Les champs s'écrivent entre crochets, sous la forme [CHAMP], et chaque champ est précédé d'un tiret bas (_).
Exemple : nomdufichier_[CHAMP1]_[CHAMP2].docx.
Les champs disponibles dans le nom d'un modèle DocTemplates sont les suivants :
Format de génération – [PDF] : le document est généré en PDF. Sans ce champ, le document est généré en Word (.docx).
Pôle de la fiche – [POLEX] : X est la référence interne du pôle. Exemple : [POLE3].
Société de la fiche : [CSOCX], CSOCX étant la référence interne de la société
Type de contrat : [TYPEX], TYPEX étant l'ID, des paramètres globaux, du type de contrat
Agence juridique de la fiche – [AJUX] : X est la référence interne de l'agence juridique. Exemple : [AJU1].
Langue de l'utilisateur qui génère le document – [FR] ou [EN].
Exemples de noms valides : nomdufichier_[POLE3]_[FR].docx · nomdufichier_[AJU1]_[FR].docx · nomdufichier_[EN].docx · nomdufichier_[PDF].docx
Comment DocTemplates choisit le modèle à utiliser
Quand plusieurs modèles DocTemplates sont disponibles, la sélection automatique repose sur un score : plus le nom du modèle contient de champs correspondant à la fiche et à l'utilisateur, plus son score est élevé. Le modèle qui a le score le plus élevé est sélectionné. À score égal, le modèle qui contient un format (par exemple [PDF]) est choisi en priorité.
Exemple 1 : l'utilisateur a son interface en français et la fiche appartient à l'agence juridique dont la référence interne est AJU4. Les modèles disponibles sont : nomdufichier_[AJU4]_[EN].docx, nomdufichier_[AJU1].docx, nomdufichier_[FR].docx, nomdufichier_[FR]_[PDF].docx, nomdufichier_[EN].docx et nomdufichier.docx. Le modèle sélectionné est nomdufichier_[FR]_[PDF].docx : les modèles en [EN] et en [AJU1] ne correspondent pas, et entre [FR] et [FR]_[PDF], c'est le modèle avec un format qui l'emporte.
Exemple 2 : dans le même contexte, les modèles disponibles sont : nomdufichier_[AJU4]_[FR].docx, nomdufichier_[AJU4].docx, nomdufichier_[EN].docx et nomdufichier.docx. Le modèle sélectionné est nomdufichier_[AJU4]_[FR].docx, car il correspond à la fois à l'agence juridique et à la langue.
4 - Charger votre modèle dans DocTemplates
Administration > Apps/Marketplace > DocTemplates > Configuration
Pour charger votre modèle dans DocTemplates, déposez votre fichier Word dans la rubrique qui correspond au type de document.
Ouvrez la configuration de l'application DocTemplates.
Repérez la rubrique qui correspond à votre type de document (par exemple Factures ou Contrats).
Chargez votre fichier .docx dans cette rubrique.
Si le modèle est accepté, il apparaît dans la rubrique. Si DocTemplates refuse le modèle, il affiche la liste des variables qu'il ne reconnaît pas : consultez la FAQ en fin d'article pour corriger votre modèle.
5 - Générer un document à partir de votre modèle DocTemplates
Pour générer un document à partir de votre modèle DocTemplates, ouvrez la fiche concernée (ressource, facture, besoin, devis…). Cliquez ensuite sur le bouton en haut à droite "Générer un document".
Vous pouvez ensuite choisir le modèle dans le menu déroulant qui s'affiche :
FAQ
Est-ce possible d'avoir plusieurs modèles de devis ?
Oui, vous pouvez avoir plusieurs modèles de devis sur DocTemplate. Vous pourrez choisir le template de votre choix au moment de la génération du devis en PDF.
Quelles variables DocTemplates utiliser pour la facture électronique ?
Depuis la mise en place des formats Factur-X et CII sur Boond (décembre 2023), de nouvelles variables DocTemplates sont disponibles pour la facture électronique.
Côté facture : $billingDetailVatNumber$ (N° TVA), $billingDetailSiren$ (SIREN), $billingDetailNic$ (NIC), $billingDetailRegistrationNumber$ (SIRET), $billingDetailNumber$ (numéro fournisseur), $billingDetailSendingMode$ (mode d'envoi).
Côté commande : $billingDetail.vatNumber$ (N° TVA), $billingDetail.siren$ (SIREN), $billingDetail.nic$ (NIC), $billingDetail.registrationNumber$ (SIRET), $billingDetail.number$ (numéro fournisseur), $billingDetail.sendingMode$ (mode d'envoi).
Mon template DocTemplates est refusé au chargement : que faire ?
Lorsque votre template DocTemplates est refusé au chargement, DocTemplates affiche la liste des variables qu'il ne reconnaît pas. Ce nombre d'erreurs vous oriente :
Une seule variable signalée : vérifiez son orthographe, sa syntaxe complète (
$nomDeLaVariable$), qu'elle existe bien pour ce type de template et qu'aucun caractère spécial ou$supplémentaire ne l'entoure.Beaucoup de variables signalées : cherchez plutôt une cause globale, par exemple un
$isolé dans le document, une variable mal fermée ou des variables provenant d'un autre type de template (par exemple des variables de prestation dans un contrat RH).
Comment afficher le symbole $ (dollar) ou une devise dans mon template DocTemplates ?
Pour afficher une devise dans votre template DocTemplates, n'écrivez pas le symbole $ à la main (par exemple « 1 000 $ ») : DocTemplates utilise le caractère $ pour repérer les variables et le lit comme le début d'une variable incomplète, ce qui bloque le chargement du template.
Utilisez à la place la variable de devise prévue, par exemple $currencySymbol$ (symbole de la devise) ou $currency$ (code de la devise, par exemple EUR) sur une facture ou un devis. Le nom exact de la variable dépend du type de template : consultez l'onglet correspondant de la documentation des variables.
Mon template DocTemplates est chargé mais je ne le vois pas au moment de générer mon document : pourquoi ?
Si votre template DocTemplates est chargé mais n'est pas proposé au moment de générer le document, vérifiez le nom du fichier. Le nom du template détermine dans quel contexte il est sélectionné (agence juridique, pôle, langue de l'utilisateur, format PDF). Un template valide mais dont le nom ne correspond pas au contexte de la fiche ne sera pas proposé. Les règles de nommage sont affichées dans chaque rubrique de la configuration DocTemplates.
Une information est vide dans le document généré par DocTemplates : pourquoi ?
Lorsqu'une information est vide dans le document généré par DocTemplates alors quev la variable est correcte, c'est le plus souvent que la donnée n'est pas renseignée dans Boond ou qu'elle n'est pas reliée à la bonne fiche. Par exemple, les informations du fournisseur d'une ressource externe restent vides si aucun fournisseur n'est associé à cette ressource. La documentation des variables indique, pour chaque variable, sur quelle fiche et dans quel onglet la donnée doit être renseignée.
Ma variable DocTemplates fonctionne dans le texte mais pas dans un tableau (ou l'inverse) : pourquoi ?
Une variable DocTemplates qui fonctionne dans le texte mais pas dans un tableau (ou l'inverse) n'est probablement pas utilisée selon son type. Une variable simple s'insère dans le texte, une variable liste dans une liste à puces d'un seul élément (ou avec le modificateur join pour l'afficher en texte), et une variable table dans une ligne de tableau Word. Le type de chaque variable est indiqué dans la documentation des variables ; les trois types sont détaillés en section 2 de cet article.
Ma facture ou mon devis DocTemplates ne se génère pas correctement : que vérifier ?
Si votre modèle de facture ou de devis DocTemplates ne se génère pas correctement, vérifiez la structure des tableaux : les totaux doivent être placés dans un tableau séparé de celui qui contient les lignes de facture ou de devis.
Comment savoir si le problème vient de mon document Word ou de la variable DocTemplates ?
Pour savoir si le problème vient de votre document Word ou de la variable DocTemplates, faites un test avec un document minimal :
Créez un nouveau document Word contenant une seule ligne de texte et la variable à tester.
Chargez ce document dans le même type de template DocTemplates.
Générez un document à partir de ce template.
Si le document minimal fonctionne, le problème vient de votre document Word d'origine : caractères cachés, contenu copié depuis Excel ou un PDF, zones de texte, tableaux imbriqués ou variables placées dans l'en-tête ou le pied de page. Simplifiez alors votre document progressivement pour identifier la partie en cause.
Est-il possible d'avoir plusieurs modèles de devis dans DocTemplates ?
Oui, il est possible d'avoir plusieurs modèles de devis dans DocTemplates. Vous choisissez le modèle de votre choix au moment de générer le devis en PDF.



