Généralités sur l’agent d’impression
L'agent d'impression est un outil visant (initialement) à compenser certaines limitations du client html : celui-ci, "bridé" par le navigateur, ne permet pas aux programmes diva d'accéder au matériel de la machine locale, et en particulier aux imprimantes.
En temps normal, lors d'une impression, le client html commandera la génération d'un document PDF sur le serveur, et en proposera le téléchargement, ce qui, entre autres, requiert une action utilisateur pour chaque document.
Ce fonctionnement convient aux clients nomades, mais peut avoirs ses limites (impression des payes par exemple) pour les utilisateurs d'un site cloud, ou les utilisateurs d'un site pour lequel seul le client html a été choisit.
Pour ces cas-ci, l'agent d'impression est mis à disposition.
Le principe est le suivant :
après activation de ce mode, les éditions à imprimer sont centralisées sous forme de documents .dhvw dans un répertoire sur le serveur.
l'agent d'impression en lui-même est un programme exécuté par un client WPF sur un poste dédié du site (physique) concerné et qui scrute le dossier où sont centralisés les éditions générées par les utilisateurs du site. Cet agent déclenche les impressions sur l'imprimante paramétrée puis efface les documents du répertoire après impression.
...
Paramétrage d'un format pour le spool en mode "Agent d'impression"
Il faut créer ou modifier dans xDivaltoPrinters un format pour le spool (comme indiqué dans la documentation xDivaltoPrinters) et cocher la case "Agent Impression".
...
Un sous-répertoire peut être précisé et sera notamment indispensable si plusieurs sites physiques d'une même entité sont desservis en mode "Agent d'impression".
Ce format pour le spool doit être propagé pour tout les utilisateurs du site concerné.
Lorsque ce format est utilisé, les impressions sont alors centralisées sur le serveur d'application dans le répertoire
C:\divalto\DivaltoPrintAgent\Local\Tmp
Pour chaque impression un fichier .dhvw et un aperçu (image du même non avec l'extension .PNG) sont stockées.
Mise en oeuvre de l'agent d'impression.
Agent local
Sur le poste local qui sert d’agent d’impression, il faut toujours l’indiquer via la coche des paramètres locaux.
...
afficher l'aperçu du document en cours de traitement,
lancer DivaltoViewer en mode "impression directe" pour ce document,
DivaltoViewer va détecter pour le format pour le spool stocké dans le document ".dhvw" lui-même, et utilisera le format pour le spool du même nom (celui que l'on a créé spécifiquement pour le poste dédié à l'agent d'impression) pour lancer l'impression sur l'imprimante réelle
Ré-impression
Pour ré-imprimer un document il faut lancer le programme xdivaltoagentimpreprint.dhop
Les documents peuvent êtres parcouru grâce au bouton "Suivant".
Persistance des documents et maintient de l'agent en cas d'erreur
Par défaut les documents sont supprimés définitivement après n jours.
Cette valeur est indiquée dans les paramètres de l’agent d’impression, ainsi que la durée de synchonisation
...
Paramétrage du service de l’agent d’impression, mode redémarrage en cas d’arrêt après un erreur grave
Le service d’agent d’impression est paramétré comme ceci pour faire du redémarrage automatique en cas d’erreur grave.
...
Choix de l'emplacement de stockage des documents centralisés
Par défaut, les documents sont stockés dans un répertoire construit comme suit :
"CheminUL1\DivaltoPrintAgent\Local\Tmp" et "CheminUL1\DivaltoPrintAgent\Local\Printed"
Ce qui donne C:\divalto\DivaltoPrintAgent\Local\Tmp et C:\divalto\DivaltoPrintAgent\Local\Printed dans le cas d'une installation par défaut.
Ces chemins peuvent être changé par l'ajout d'une clef DivaltoPrintAgent dans le chapitre "Local machine\SOFTWARE\Divalto\Divalto.ini\system" du registre avec pour valeur le chemin souhaité.
Impression en mode caractères
Pour l'impression en mode caractères il faut utiliser le chapitre Printer (et non GraphPrinter) du format pour le spool.
Pour le poste dédié à l'agent d'impression il faut apporter quelques attentions particulières :
il faut que le fichier FIHxxxx soit correctement paramétré en fonction de l'imprimante réelle qui devra imprimer les pages.
Comme pour les impressions en mode graphique, le nom du format pour le spool utilisé par les clients pour générer les documents doit correspondre au format pour le spool du poste éxécutant l'agent d'impression (lequel référence l'imprimante réelle).
Utilisation sur plusieurs sites physiques
Dans le cas où plusieurs sites physiques d'une même entité, et dépendant d'un même serveur d'application, doivent chacun être desservis en mode "Agent d'impression", il convient de faire les ajustements suivants :
...