# GENERER UN OU PLUSIEURS DOCUMENTS A PARTIR D'UNE OU PLUSIEURS MATRICES

A mettre à jour

**Une fois configuré, les documents sont mis à jour automatiquement à chaque modification.** ##### **Configuration de la table** Pour pouvoir générer des documents, une table doit contenir :

Un champ de type Booléan intitulé MISE A JOUR AUTO ?	Celui-ci permet d'activer la génération automatique des documents ou de la désactiver
Un champ intitulé MATRICES	Celui-ci doit être de type Lien vers une table
Un champ intitulé DOSSIERS PARTAGES qui doit contenir l'emplacement de destination du document	Celui-ci peut être de type Texte, mais de préférence de type formule afin de rendre le dossier dynamique Exemple: `concat("TECHNIQUE/",datetime_format(field('DEPART'), "YYYY"), "/PRETS/", datetime_format(field('DEPART'), "YYYY-MM-DD"), " ", upper(field("COMPAGNIE")),"/")` Ce qui va générer un répertoire sous ce format TECHNIQUE/2024/PRETS/2024-05-13 L'AGIT/
Un champ intitulé NOM GENERIQUE qui doit contenir le nom du document généré	Celui-ci peut être de type Texte, mais de préférence de type formule afin de rendre le nom du document dynamique Exemple: Si plusieurs fichiers doivent être générés, la formule doit retourner une liste de nom séparés par des points virgules. `concat(concat( field("COMPAGNIE")," - "),join(lookup("MATRICES","NOM DU FICHIER"),concat(";", field("COMPAGNIE"), " - "))` Ce qui permet de créer plusieurs fichiers sous ce format CONTRAT FINANCIER - TEST CONTRAT BLABLA - TEST
Un champ de type Champs rapporté intitulé Template pointant vers le champs MATRICE de la table MATRICE	Ce champ doit contenir les fichiers matrice DOCX, ou XLSX .

##### **Ajout de l'automatisation** **

** ##### **Création de la matrice (template)** Après activation de l'automatisation (Webhook), un fichier **schema-table-{identifiant de votre table}.json** aura été généré dans le dossier **0-LIAISON/TEMPLATES** On y trouve tous les champs disponibles pour la matrice. Afin de le visualiser correctement, ouvrez le avec votre navigateur internent (Firefox, Chrome, Brave...) Dans votre document, vous devez insérer des balises - entre accolades **{}** - contenant le nom du champ en majuscule précédée de **d.** - les espaces sont remplacées par des espaces - les caractères spéciaux sont supprimés `{d.NOM_DE_MON_CHAMP}` Certains champs contenant plusieurs valeurs sont transformés en listes qui peuvent permettre de générer des tableaux. `{d.NOM_DE_MON_CHAMP_LISTE}` **A voir :** - la documentation des matrices [https://carbone.io/documentation.html](https://carbone.io/documentation.html) - un exemple concret [https://files.grainerie.netlib.re/s/L6RbFyX](https://files.grainerie.netlib.re/s/L6RbFyX) ##### **Test de la matrice** Vous pouvez tester votre matrice à cette adresse : [https://url.grainerie.netlib.re/s/matrice-baserow](https://url.grainerie.netlib.re/s/matrice-baserow)

Un champ de type Booléan intitulé MISE A JOUR AUTO ?	Celui-ci permet d'activer la génération automatique des documents ou de la désactiver
Un champ intitulé MATRICES	Celui-ci doit être de type Lien vers une table
Un champ intitulé DOSSIERS PARTAGES qui doit contenir l'emplacement de destination du document	Celui-ci peut être de type Texte, mais de préférence de type formule afin de rendre le dossier dynamique Exemple: `concat("TECHNIQUE/",datetime_format(field('DEPART'), "YYYY"), "/PRETS/", datetime_format(field('DEPART'), "YYYY-MM-DD"), " ", upper(field("COMPAGNIE")),"/")` Ce qui va générer un répertoire sous ce format TECHNIQUE/2024/PRETS/2024-05-13 L'AGIT/
Un champ intitulé NOM GENERIQUE qui doit contenir le nom du document généré	Celui-ci peut être de type Texte, mais de préférence de type formule afin de rendre le nom du document dynamique Exemple: Si plusieurs fichiers doivent être générés, la formule doit retourner une liste de nom séparés par des points virgules. `concat(concat( field("COMPAGNIE")," - "),join(lookup("MATRICES","NOM DU FICHIER"),concat(";", field("COMPAGNIE"), " - "))` Ce qui permet de créer plusieurs fichiers sous ce format CONTRAT FINANCIER - TEST CONTRAT BLABLA - TEST
Un champ de type Champs rapporté intitulé Template pointant vers le champs MATRICE de la table MATRICE	Ce champ doit contenir les fichiers matrice DOCX, ou XLSX .