Modèles d'impression¶

En bref

Le connecteur imprime les documents Sage en PDF à partir de modèles d'impression au format .frx que vous déposez dans un dossier, choisi par dossier Sage. Le moteur d'impression FastReport est intégré au connecteur ; les modèles, eux, sont à votre main.

Comment l'impression fonctionne¶

Quand un client demande le PDF d'un document, le connecteur procède dans cet ordre :

Le PDF archivé par Sage est servi tel quel s'il existe pour ce document.
Sinon, le connecteur cherche le modèle correspondant au type de document dans le dossier des modèles du dossier Sage, le remplit et produit le PDF.
Si l'option Enregistrer les PDF générés dans le document est cochée pour ce dossier, le PDF produit est archivé dans les fichiers joints du document Sage.

Configurer le dossier des modèles¶

Chaque dossier Sage possède son propre chemin : vous pouvez ainsi séparer les modèles par société.

Ouvrez l'outil de configuration, écran Dossiers Sage.
Sélectionnez le dossier concerné.
Dans la section Modèles & options, renseignez le champ Modèles PDF avec le chemin du dossier contenant vos fichiers .frx, ou choisissez-le avec le bouton ….
Cochez si besoin Enregistrer les PDF générés dans le document.
Cliquez sur Enregistrer le dossier.

Capture à venir

Dossier des modèles d'impression dans l'écran Dossiers Sage — identifiant connecteur/report-designer. L'image sera ajoutée lors de la prochaine campagne de captures.

Pas besoin de redémarrer le service

Ajouter, modifier ou supprimer un fichier .frx dans le dossier des modèles est pris en compte immédiatement. Seul le changement de chemin passe par l'enregistrement de la configuration.

Le dossier doit être accessible au service

Le chemin est lu par le service ServeurSensaas. S'il pointe vers un lecteur réseau mappé pour votre session ou vers un emplacement non accessible au compte du service, l'impression échoue.

Nommer les fichiers de modèles¶

La règle est un fichier par type de document : le nom du fichier est la valeur du type de document Sage, suivie de .frx.

Nom du fichier	Type de document
`0.frx`	Devis
`1.frx`	Bon de commande
`2.frx`	Bon de livraison
`3.frx`	Facture

Pour créer une nouvelle base d'impression, dupliquez un fichier existant et renommez-le avec le numéro du type de document visé.

Le Report Designer¶

Les fichiers .frx s'ouvrent et se modifient avec le Report Designer (FastReport), qui permet de placer les champs, les images et le code de mise en forme du modèle. Le connecteur, lui, n'embarque que le moteur de rendu : il exécute les modèles, il ne sert pas à les dessiner.

Des modèles de démonstration et le Report Designer sont mis à disposition sur le site SenSaaS.

Les modèles de démonstration sont des exemples

Ils ne doivent pas être utilisés en production sans adaptation aux besoins et à la charte de la société.

Paramètres fournis au modèle¶

Le connecteur transmet au modèle, au moment de l'impression, le type et le numéro du document (sous plusieurs noms de paramètres, pour rester compatible avec les modèles existants) ainsi que le chemin du dossier Sage, utilisé notamment pour retrouver les images. La connexion à la base du dossier Sage est injectée automatiquement dans le modèle.

Messages d'erreur courants¶

« Le dossier des modèles n'est pas configuré pour ce dossier. »¶

Le champ Modèles PDF du dossier Sage est vide, ou le chemin qu'il contient n'existe pas (ou n'est pas accessible au service). Renseignez-le dans l'écran Dossiers Sage et vérifiez que le dossier existe bien sur la machine du connecteur.

« Modèle non trouvé pour ce type de document. »¶

Le dossier des modèles est correct, mais il ne contient pas de fichier portant le numéro du type de document demandé. Ajoutez le fichier manquant en suivant la règle de nommage ci-dessus.

Erreur de compilation du code d'un modèle¶

Certains modèles anciens contiennent, dans leur onglet Code, des appels à des méthodes qui ne sont plus autorisées à l'exécution (par exemple la vérification d'existence d'un fichier image). La génération du PDF échoue alors sur une erreur de compilation.

La correction consiste à ouvrir le modèle dans le Report Designer et à remplacer ces vérifications par une gestion d'erreur : on tente de charger l'image et, si elle est absente ou illisible, on laisse l'emplacement vide au lieu d'interrompre l'impression. La procédure détaillée, avec l'exemple de code, figure sur la page d'archive Dossier des modèles d'impression (v1), toujours valable pour cette correction.

Conversion depuis les modèles de la Gestion commerciale¶

Les modèles d'impression de la Gestion commerciale Sage (fichiers .bgc) ne sont pas exploitables directement par le connecteur. Il faut reconstituer la mise en page dans un fichier .frx en reprenant les champs du modèle d'origine.

Questions fréquentes¶

Puis-je utiliser un dossier de modèles commun à plusieurs dossiers Sage ?

Oui : renseignez le même chemin dans chaque dossier Sage. Le connecteur ne fait aucune distinction, il cherche simplement le fichier du type de document dans le chemin configuré.

L'outil de configuration propose-t-il d'initialiser les modèles ?

Pas dans l'outil de configuration actuel : l'import et la duplication automatique des modèles font partie des fonctions de l'ancien outil qui restent à porter. Dupliquez les fichiers manuellement dans le dossier des modèles.