Composant d'imprimante Jasper
Ce composant permet d'imprimer automatiquement un document en fonction d'un événement. En outre, vous pouvez également générer l'objet PDF ou RTF d'un document. Il s'agit d'un composant XML standard: il accepte XML comme entrée et fournit un XML de sortie identique.
Par exemple, l'impression d'une liste de prélèvement dans un magasin pour le prélèvement en magasin est un exemple où le magasin ne gère pas le stock. Dans ce cas, le site Web sur lequel la commande est passée ou un centre d'appels capture les commandes pour le ramassage en magasin. Ces commandes sont envoyées au magasin pour traitement. Un associé de contrôle de stock du magasin vérifie régulièrement s'il y a des commandes à prélever. Si tel est le cas, l'associé peut imprimer une liste de prélèvement papier pour extraire les produits requis du commerce de détail. Dans certains cas, l'impression peut être déclenchée automatiquement lorsqu'une commande est reçue au magasin.
Un document peut être imprimé facilement en un seul clic à partir de la console. Cette opération est prise en charge à l'aide de l'exécution de flux et du composant d'imprimante.
Le composant Jasper Print peut être utilisé pour générer un rapport PDF et le diffuser via la réponse HTTP . Pour ce faire, vous pouvez configurer un service avec un composant Jasper Print et sélectionner l'option "Jasper Print Object". Ce service est maintenant invoqué en faisant un appel HTTP au servlet "InteropJasperServlet" et en passant l'entrée XML "locale" au service et le nom du service que vous avez créé pour générer des objets PDF. Ces services sont créés dans la structure de définition de service (SDF). Pour plus d'informations sur SDF et pour savoir comment créer un service, voir Service definition framework.
Vous pouvez également contrôler la réussite et l'échec des événements d'impression à l'aide de la transaction d'impression définie sous le type de processus général. Cette transaction est configurable et comporte deux événements: Print.ON_SUCCESS et Print.ON_FAILURE. L'événement ON_FAILURE est émis uniquement pour les exceptions d'interruption de service telles que les échecs d'impression.
Le tableau suivant fournit les propriétés de configuration de l'impression Jasper:
| Zone | Descriptif |
|---|---|
| Onglet Général | |
| Rapport Jasper | Il s'agit d'un fichier Jasper compilé. Le nom de fichier prend en charge les variables dans un format de variable standard et amélioré. |
| Élément principal du rapport | Indiquez l'élément à envoyer en tant que racine du rapport. Par défaut, la totalité du code XML est utilisée. Une erreur est générée si cette zone est indiquée mais qu'elle n'est pas résolue en élément. |
| Env. local | Indiquez l'environnement local pour la traduction des littéraux dans le rapport. Les données du XML peuvent être localisées à l'aide du composant par défaut décrit dans Composant par défaut. |
| Utilisez le pack de ressources logicielles du systèm Sterling™ Order Management | Si cette option est cochée, tous les littéraux du rapport sont traduits dans la langue demandée à l'aide du lot de ressources logicielles du système d' Sterling Order Management. |
| Onglet Sortie | |
| Imprimante | Cette option permet d'indiquer une imprimante à utiliser. |
| Nom d'imprimante | Entrez le chemin XML pointant vers l'imprimante à utiliser. |
| Nombre de copies | Entrez le nombre de copies que vous souhaitez imprimer. |
| Onglet Variables | |
| Nom de la variable | Nom du paramètre à transmettre à la méthode du valideur. |
| Valeur de variable | Valeur du paramètre à transmettre à la méthode du valideur. |
Pour autoriser les formats d'impression personnalisés, la configuration du composant d'impression prend en charge la modification des noms de fichier de rapport en fonction d'un code XML d'entrée. Par exemple, si le fichier XML d'entrée contient le nom de fichier:
${jasperfolder}/compiled/${orgcode}/report.${doctype}.jasper
Tout d'abord, toutes les variables sont résolues par rapport aux variables définies dans l'onglet Variables:
orgcode g xml:/Order/@OrganizationCode
doctype g xml:/Order/@DocumentType
Les variables restantes sont résolues par rapport au fichier yfs.properties . Dans ce cas, la variable ${jasperfolder} est résolue à partir de la définition yfs.properties : jasperFolder=/someCustomJasperFolder. Pour modifier cette propriété, ajoutez une entrée correspondante dans le fichier <INSTALL_DIR>/properties/customer_overrides.properties .
Ainsi, avec l'entrée de <Order
OrganizationCode="DEFAULT" DocumentType="0001" .... /> , l'expression se résout en: /someCustomJasperFolder/compiled/DEFAULT/report.0001.jasper.
Une exception est émise si une erreur se produit lors du traitement du rapport. Par exemple, une exception est émise si le nom de fichier n'est pas valide. Une exception d'interruption de service est émise lors de l'impression du rapport, ce qui permet de mettre en pause un service asynchrone.