Skip to main content

Chapitrre 8 : « Fichiers spéciaux (masques PDF et traitements) »

y3.png

Principe

Un « fichier spécial » est un masque PDF (formulaire, attestation, page degarde…) rempli automatiquement avec les données du document puis fusionné au PDF généré. Il est composé de deux éléments de même nom :

  • Le masque PDF, importé dans documents/infraspackplus/specialfiles/ 
  • Un fichier PHP de traitement, importé dans custom/infraspackplus/core/modules/specialfiles/, qui décrit comment remplir le masque.

Le bloc « Gestion des fichiers spéciaux » de l'onglet Paramètres InfraS permet d'importer l'un et l'autre et affiche la liste des masques. Un masque n'est « utilisable » que si son fichier PHP homonyme existe.

Activation par type de document 

Pour chaque masque utilisable, des cases indiquent sur quels documents il sera proposé comme fichier à fusionner : Devis, Commandes, Interventions, Factures, Projets, Projets Auto., Contrats, Contrats Auto., Utilisateurs (constantes INFRASPLUS_PDF_SPECIAL_FILE_<TYPE>_<NOM>, suffixe _AUTO pour les variantes automatiques).

  • Mode manuel : le masque apparaît dans la liste « fichiers à fusionner » des options avant génération, l'utilisateur le coche s'il le souhaite.
  • Mode « Auto. » : le masque est toujours fusionné, sans choix.

Les deux modes s'excluent pour un même masque et un même type de document. Les modèles InfraSPlus_CTS (dossier de contrat), PJ_Dossier et PJ_Docs (dossiers de projet) et User_Contrat (contrat employé) reposent sur ce mécanisme.