Introduction

Ce livre explique le fonctionnement des impressions commandées par les applications Harmony :

• Dans un premier temps, nous décrirons les principes généraux des impressions Windows et Harmony : gestionnaire d'impression (spouleur), imprimante par défaut, mode graphique et mode caractères, modèles d'imprimante, etc.

• Dans un deuxième temps, nous étudierons les opérations à effectuer pour obtenir une mise en œuvre optimale des impressions Harmony sous Windows.

Pour connaître les particularités de paramétrage des imprimantes en mode client léger, consultez la documentation de xDivaltoPrinters.

Principes généraux des impressions Harmony / Windows

Nous allons tout d'abord expliquer les principes gouvernant les impressions sous Windows et sous Harmony.

Gestionnaire d'impression de Windows (spouleur)

Le gestionnaire d'impression est une application fournie avec Windows qui permet :

• L'installation et la configuration des imprimantes.

• La connexion aux imprimantes du réseau.

• Le contrôle de l'impression des états.

Lorsqu'une application édite un état, elle crée un fichier d'impression. Celui-ci est envoyé dans la file d'attente du spouleur, qui procède à l'impression en arrière-plan.

Imprimante par défaut de Windows

Le gestionnaire d'impression permet de définir une imprimante "par défaut". Lors d'une édition, c'est cette imprimante qui sera automatiquement utilisée si aucune autre imprimante n'est sélectionnée auparavant.

Installation et configuration d'une imprimante Windows

Avant toute utilisation d'une imprimante sous Windows, il faut installer le pilote (driver) d'imprimante correspondant au matériel utilisé. C'est le gestionnaire d'impression qui permet cette installation.
Le gestionnaire d'impression permet aussi de configurer les imprimantes installées. Cette opération consiste à choisir différents paramètres d'impression : format du papier, bac d'alimentation, nombre d'exemplaires, résolution, intensité, etc.

Mode graphique et mode caractères

Les pilotes d'imprimante Windows peuvent travailler soit en mode graphique, soit en mode caractères :
Mode graphique

• Les programmes envoient au driver des commandes évoluées issues de l'interface graphique (GDI) de Windows : tracé de cadre, impression d'image, choix d'une police, d'une taille et d'une couleur de caractères, etc.

• Les drivers "traduisent" ces commandes pour les rendre compréhensibles par l'imprimante. Ils rendent ainsi "tout naturellement" les applications indépendantes du matériel. C'est la raison pour laquelle les applications Windows effectuent la plupart du temps leurs éditions en mode graphique.

• Les fonctions de paramétrage du gestionnaire d'impression sont accessibles.

• Les états peuvent être visualisés à l'écran par l'utilitaire Harmony DivaltoViewer.

Mode caractères

• Les programmes envoient au driver les textes, éventuellement agrémentés d'attributs d'impression simples (gras, italique, souligné, caractères comprimés, expansés, etc.).

• Les drivers se chargent de l'émission des caractères sur le port d'entrée-sortie mais n'effectuent pas de traduction des attributs d'impression. Pour que les applications restent indépendantes du matériel, leur traduction est prise en charge par Harmony (fichiers descriptifs d'imprimante).

• Les fonctions de paramétrage du gestionnaire d'impression ne sont plus accessibles.

• Les états ne peuvent pas être visualisés à l'écran.

Etats graphiques et états caractères

Sous Harmony, nous distinguerons deux types d'état imprimé :

• Les états graphiques, produits à partir de masques d'impression graphiques créés avec l'éditeur Xwin.

• Les états caractères, produits à partir de masques d'impression caractères créés avec l'éditeur Xwin.

Remarques importantes :

• Les états graphiques sont toujours édités en mode graphique.

• Les états caractères peuvent être édités aussi bien en mode graphique (mode par défaut) qu'en mode caractères : Le mode graphique permet l'utilisation des fonctions de paramétrage du gestionnaire d'impression de Windows, permet la visualisation des états caractères à l'écran et s'affranchit de la "couche driver" spécifique à Harmony. L'édition des états caractères en mode caractères reste possible pour améliorer les performances (les temps d'impression sont généralement meilleurs, surtout avec les imprimantes matricielles) ou pour conserver la possibilité (décrite par ailleurs) d'imprimer des états sans interprétation des commandes par le spouleur de Windows.

• Le mode graphique étant le mode standard d'impression sous Harmony, aussi bien pour les états graphiques que pour les états caractères, la suite de ce paragraphe lui est essentiellement consacrée. Le mode caractères est documenté dans l'annexe Impressions Harmony en mode caractères.

• En mode graphique, les attributs d'impression des états caractères sont simulés. Vous trouverez tous les renseignements concernant cette simulation dans l'annexe Simulation des attributs d'impression en mode graphique.

Paramétrage des impressions Harmony

Nous distinguerons ici deux types de paramétrage, un paramétrage "Windows" et un paramétrage spécifique à Harmony :
Choix et paramétrage "Windows" de l'imprimante

• Sauf précision contraire, une édition faite par une application Harmony utilise l'imprimante par défaut de Windows et tient compte du paramétrage effectué pour cette imprimante dans le gestionnaire d'impression. Par exemple, si vous configurez l'imprimante par défaut pour imprimer 2 exemplaires avec le format de papier A4, un état Harmony s'imprimera par défaut en 2 exemplaires et avec ce format de papier.

• Mais l'édition pourra aussi utiliser un autre paramétrage (défini au niveau d'Harmony et n'interférant pas avec le paramétrage spécifié au niveau du gestionnaire d'impression de Windows, ce qui permet de changer les paramètres d'édition des états Harmony sans toucher aux paramètres d'édition des autres applications Windows) et/ou avoir lieu sur une autre imprimante.

• Pour connaître les particularités de paramétrage des imprimantes en mode client léger, consultez la documentation de xDivaltoPrinters.

Paramétrage spécifique à Harmony

• Pour les états graphiques (et si l'application l'autorise), on peut régler la hauteur d'édition, c'est à dire indiquer le nombre de lignes pouvant être imprimées sur chaque page (hauteur papier).

• Pour les états caractères, on peut en supplément (principalement) régler la largeur d'édition, en demandant le passage automatique en "mode paysage" et/ou en caractères comprimés si l'état déborde de la page.

Réglage de la hauteur d'édition

Le concepteur d'un programme d'édition ne connaît, à priori, ni le type d'imprimante ni le format de papier qui seront utilisés. Il ne connaît donc pas la hauteur limite de l'édition.
Préciser le nombre de lignes par page au niveau du paramétrage (et non au niveau du programme) fait que l'édition s'adaptera automatiquement aux caractéristiques matérielles et ce, sans adaptation du programme. Par exemple, le même état pourra être édité indifféremment sur une imprimante matricielle avec 72 lignes par pages ou sur une imprimante laser avec 66 lignes par page.
Bien entendu, plusieurs paramétrages différents peuvent être définis pour la même imprimante physique. Ainsi, on saura par exemple éditer sur une même imprimante aussi bien des étiquettes avec 60 lignes par page que des factures avec 55 lignes par page.

Réglage de la largeur d'édition

Ce point ne concerne que les états caractères. En effet, Harmony applique automatiquement un coefficient de réduction aux états graphiques qui débordent en largeur de la feuille de papier.
Tel qu'il a été conçu par le programmeur, un état caractères peut déborder en largeur de la feuille de papier. Supposons par exemple que l'édition d'un état prévoit 120 caractères par ligne. L'état ne sera pas correct si 80 caractères seulement "tiennent" sur la page avec la police de caractères de base de l'imprimante.
Le paramétrage Harmony permet dans ce cas :

• D'éditer l'état en mode paysage (une feuille au format A4 est plus haute que large). Comme la hauteur du papier est différente en mode paysage et en mode portrait, le paramétrage Harmony permet d'indiquer un nombre maximum de lignes pour CHAQUE orientation.

• Et / ou d'éditer l'état en caractères comprimés.

Le passage (automatique) en mode paysage et/ou en caractères comprimés peut être demandé pour les états comprenant : - Plus de 132 caractères par ligne. - Entre 81 et 132 caractères par ligne. - Moins de 81 caractères par ligne.

Réglage de la taille de la page

Mise en oeuvre des impressions Harmony / Windows

Modèles d'imprimante Harmony

Si sur un site plusieurs imprimantes sont installées et/ou si plusieurs paramétrages (numéro de bac, format du papier, nombre d'exemplaires, résolution, etc.) sont nécessaires, l'utilisateur doit pouvoir aisément sélectionner le couple imprimante / paramétrage approprié avant d'effectuer une édition.
Pour ce faire, il peut bien entendu changer l'imprimante par défaut de Windows et/ou reconfigurer cette imprimante avec le gestionnaire d'impression. Mais Harmony propose une manière plus simple et plus rapide qui consiste :

• Pour l'administrateur :

  • A définir des "modèles d'imprimante" adaptés aux besoins et aux matériels.

  • A relier chaque modèle à une imprimante, déclarée dans le gestionnaire d'impressions de Windows, et à un paramétrage adéquat.

• Pour l'utilisateur, à choisir le modèle approprié, depuis le menu de son application, au moment de lancer une édition. Plus précisément et pour une tâche Harmony donnée, un modèle peut être : - Sélectionné manuellement par l'utilisateur. Il reste alors actif tant qu'un autre modèle n'est pas choisi et que l'utilisateur ne quitte pas l'application. - Activé automatiquement au lancement d'un programme d'édition. Dans ce cas, le modèle actif avant le lancement du programme est rétabli lorsque celui-ci se termine.

Nous reviendrons dans la deuxième partie de ce livre sur ces différents points (Cf. Mise en oeuvre des impressions Harmony / Windows).

Aperçus avant impression

L'utilisateur peut obtenir un aperçu à l'écran de tous les états (graphiques ou caractères) imprimés en mode graphique. Pour ce faire, cochez l'option Aperçu avant impression par défaut au piano de l'interface d'accueil ou l'option Aperçu avant impression au menu système de la fenêtre d'une application Harmony.
En mode aperçu, un état normalement édité à l'imprimante est d'abord visualisé à l'écran par le programme utilitaire DivaltoViewer. Il peut alors :

• Consulter en détails le contenu de l'état.

• Demander son impression immédiate.

• Sauvegarder l'état dans un fichier pour une consultation et/ou une impression ultérieure.

• Envoyer l'état par fax ou par une messagerie électronique (cette option n'est accessible que dans la version Harmony Plus du run-time).

• Etc.

Gestion de l'option "Aperçu avant impression"

• Le piano de l'interface d'accueil (IA) propose l'option Aperçu avant impression par défaut. Toutes les applications lancées depuis l'IA héritent de cette option par défaut. La valeur courante de l'option est automatiquement sauvegardée : si l'utilisateur quitte l'IA et la rappelle ultérieurement, il retrouve cette valeur par défaut.

• Le menu système de la fenêtre d'une application Harmony propose l'option Aperçu avant impression. A partir de ce menu, l'utilisateur peut modifier ponctuellement la valeur de l'option aperçu. La nouvelle valeur est prise en compte uniquement pour le programme en cours. Elle n'est pas sauvegardée.

Edition d'une maquette

A l'attention des développeurs
Tout programme d'édition peut être appelé pour générer une maquette qui pourra ensuite être rejouée indépendamment du programme ayant produit cette édition :

• Pour constituer une maquette, créez un modèle en lui affectant le type d'imprimante "Maquette" et sélectionnez-le. A partir de là, lorsque vous lancez un programme d'impression, celui-ci génère un fichier portant le nom du masque imprimante suffixé par "" et d'extension .xml (*). Exemple : Si le programme charge le masque MonMasque.dhoi, le fichier généré portera le nom MonMasque.xml. Si le programme charge plusieurs masques d'impression, le fichier portera le nom du masque faisant l'objet du *premier xmiPrint. (*) Si vous souhaitez générer plusieurs versions de maquette à partir d'une même édition, activez l'option "Suffixer le nom du fichier maquette avec la date" pour le modèle d'imprimante utilisé. Dans ce cas, un fichier différent sera généré à chaque appel du programme d'édition. Les différents fichiers porteront le nom du masque suffixé par "_" suivi de la date et de l'heure de l'édition. Exemple : MonMasque_20160208_1726.xml. Les fichiers "maquette" sont *stockés dans le sous-dossier "Maquettes" du dossier pointé par la clé ServeurXlogf du chapitre System de la base de registre (/Divalto/Sys/Maquettes par défaut). Le lieu de stockage dépend donc de l'environnement choisi.

• Une maquette peut être "rejouée" depuis l'atelier de développement Xwin ou depuis l'assistant de personnalisation des impressions (Cf. leur documentation respective).

Mise en oeuvre des impressions Harmony / Windows

Si sur un site plusieurs imprimantes sont installées et/ou si plusieurs paramétrages (numéro de bac, format du papier, nombre d'exemplaires, résolution, etc.) sont nécessaires, l'utilisateur doit pouvoir aisément sélectionner le couple imprimante / paramétrage approprié, avant d'effectuer une édition.
Pour ce faire, il peut bien entendu changer l'imprimante par défaut de Windows et/ou reconfigurer cette imprimante avec le gestionnaire d'impression. Mais Harmony propose une manière plus simple et plus rapide, consistant à choisir un "modèle d'imprimante" approprié, depuis le menu de son application.
Remarques :
Si plusieurs paramétrages Harmony sont nécessaires, la solution du modèle d'imprimante est de toute façon requise.
Pour une tâche Harmony donnée, un modèle peut être :

• Sélectionné manuellement par l'utilisateur. Il reste alors actif tant qu'un autre modèle n'est pas choisi et que l'utilisateur ne quitte pas l'application.

• Activé automatiquement au lancement d'un programme d'édition. Dans ce cas, le modèle actif avant le lancement du programme est rétabli lorsque celui-ci se termine.

L'administrateur doit alors définir des "modèles d'imprimante" adaptés aux besoins et aux matériels et relier chaque modèle à :

• Une imprimante déclarée dans le gestionnaire d'impressions de Windows.

• Un paramétrage Windows adéquat.

Cette deuxième partie du livre consacré aux impressions Harmony explique successivement comment :

• Gérer et sélectionner un modèle d'imprimante.

• Faire le lien entre ce modèle et un couple imprimante / paramétrage Windows.

Gestion des modèles d'imprimante

La gestion des modèles s'obtient, depuis le menu Divalto ou le menu Harmony, par la frappe de la touche Shift+F6. Cette commande lance un zoom sur le fichier des modèles Fprinters.
En suivant la procédure habituelle des zooms, vous pouvez créer de nouveaux modèles, consulter, modifier ou supprimer des modèles existants. Une fiche modèle contient les champs suivants :
Toutes impressions

Etats caractères

Remarques :

• Le fichier de stockage des modèles d'imprimante (Fprinters) est un fichier "système", unique pour toutes les applications Harmony. Le paramétrage des imprimantes de l'installation peut donc se faire à partir de n'importe quel menu (y compris le menu Harmony.dhop).

• Le mode caractères est documenté dans l'annexe Impressions caractères.

Attention :

• Pour que les cases à cocher "Caractères comprimés" et "Mode paysage" soient prises en compte lors d'une édition, il faut que le champ <Nombre de colonnes> soit renseigné dans le masque Xwin.

Modèle préconisé et modèle impératif

Au moment de choisir un modèle, l'utilisateur peut préconiser ou imposer ce modèle :

• Dans le premier cas (modèle préconisé), le modèle est pris en compte SAUF indication contraire du menu. Certains programmes conseillent en effet un paramétrage bien précis pour leurs éditions : l'administrateur peut alors décider de paramétrer les choix correspondants du menu pour leur associer un modèle adéquat. Le modèle conseillé est alors prioritaire par rapport au modèle choisi par l'utilisateur. L'utilisateur retrouvera toutefois son dernier modèle préconisé, au retour des programmes qui conseillent un modèle.

• Dans le second cas (modèle impératif), le modèle sélectionné par l'utilisateur est toujours prioritaire.

Exemple : Soit une configuration comprenant trois imprimantes : Une imprimante matricielle dédiée à la comptabilité avec du papier pré-imprimé. Une imprimante matricielle dédiée à la paye avec du papier pré-imprimé. Une imprimante laser pour les autres impressions.
Les trois modèles paramétrés par l'administrateur sont : COMPTA pour la comptabilité. PAYE pour la paye. LASER pour les éditions diverses.
Dans le menu de la comptabilité, le modèle COMPTA est associé aux choix d'édition. Ainsi, l'utilisateur n'a pas la contrainte de devoir sélectionner manuellement le modèle COMPTA avant de faire une édition comptable. De même pour le choix d'édition des bulletins de la paye.
Le tableau ci-dessous indique quel est le modèle utilisé pour l'édition, en fonction du programme et du modèle initial de l'utilisateur :

Autre programme que Compta et Paye.
(**) Tout programme, y compris Compta et Paye.
Remarque : la sélection d'un modèle en mode impératif doit rester une opération exceptionnelle. En effet, les éditions de la paye ne doivent pas être éditées sur le papier pré-imprimé de la comptabilité.

Sélection d'un modèle d'imprimante

Pour choisir un modèle d'imprimante depuis un menu, tapez la touche F6.
Les valeurs affichées dans la partie inférieure de l'écran sont les paramètres d'édition courants : libellé du modèle actif, format pour le spouleur (ce code permet de sélectionner une imprimante et ses propriétés), hauteur papier.
Pour modifier ce paramétrage :

• Dans la zone Modèle d'imprimante, entrez le nom du modèle désiré (ou tapez F8 pour faire votre choix dans la liste des modèles existants : dans ce cas, validez un modèle par F12).

• Indiquez ensuite le type du modèle en sélectionnant un bouton du groupe Mode : Impératif : c'est toujours ce modèle qui sera pris en compte lors de vos éditions ultérieures. Conseillé : ce modèle sera pris en compte, sauf si le choix du menu correspondant au programme d'édition conseille un autre paramétrage.

Remarque : Le nouveau modèle reste valable jusqu'au prochain changement ou jusqu'à ce que vous quittiez l'application.

Modèle d'imprimante par défaut

Lorsque vous entrez dans une application via son menu (et si vous n'avez pas imposé de modèle), un modèle de départ est pris par défaut. Il s'agira :

• Du modèle précisé au niveau des paramètres généraux du menu (modification par Shift+F4).

• Si aucun modèle n'est indiqué dans les paramètres généraux, du modèle précisé au niveau de Divalto.ini (clé ModeleDefaut du chapitre [System], modifiable par xDivaltoMajIni).

• Si cette clé est absente de Divalto.ini, du modèle de nom STD.

Liaison entre modèle et imprimante / paramétrage Windows

Une édition faite par une application Harmony utilise implicitement l'imprimante par défaut de Windows et tient compte du paramétrage effectué pour cette imprimante au niveau du gestionnaire d'impression.
Mais il est utile dans les cas suivants d'établir une liaison explicite entre modèle et imprimante :

• Lorsque différents paramétrages Windows de l'imprimante sont nécessaires (utilisation de divers formats de papier à partir de divers bacs d'alimentation, par exemple).

• Lorsqu'on dispose de plusieurs imprimantes.

Pour les impressions en mode graphique, cette liaison se définit au niveau du fichier Divalto.ini :

• Dans le chapitre générique [GraphPrinter] si le modèle ne précise pas de "format pour le spool".

• Dans le chapitre [GraphPrinter-xxxx] si xxxx est le format déclaré dans le modèle.

• Il est aussi possible de définir un paramétrage pour l'imprimante par défaut de Windows dans le chapitre [DefaultGraphPrinter].

Pour définir ou modifier une liaison, appelez l'utilitaire xDivaltoPrinters. Celui-ci effectue automatiquement la mise à jour des chapitres "GraphPrinter" du fichier Divalto.ini.
Voir aussi les rubriques Méthode de sélection du couple imprimante / paramétrage et Exemple de liaisons modèle / imprimante.
A titre indicatif, un chapitre [GraphPrinter] ou [GraphPrinter-xxxx] contient :

• Une commande "device=..." précisant l'imprimante, le driver et le port d'entrée / sortie. Cette ligne est obligatoire. La syntaxe de la commande <device> est la suivante : device=<nom de l'imprimante>,<nom du driver>,<port> Par exemple : device=HP LaserJet Series II,HPPCL,LPT1: device=Epson FX-80,EPSON9E,LPT1:

• Des commandes de paramétrage "Windows" facultatives que nous ne détaillerons pas.

• Une impression "Fichier" est possible en remplaçant le port d'entrée / sortie par le nom (complet) d'un fichier. Par exemple : device=Epson FX-80,EPSON9E,c:\Divalto\sys\ficimp

Le chapitre [DefaultGraphPrinter] ne contient que les commandes de paramétrage. La commande device est superflue puisque l'imprimante est connue (ce chapitre paramètre l'imprimante par défaut déclarée dans le gestionnaire d'impression de Windows).
Pour connaître les particularités de paramétrage des imprimantes en mode client léger, consultez la documentation de xDivaltoPrinters.

Méthode de sélection du couple imprimante / paramétrage

Harmony emploie la méthode suivante pour sélectionner un couple imprimante / paramétrage :

• Si le modèle précise un format d'impression (format pour le spool), Harmony recherche un chapitre [GraphPrinter-xxxx] référençant ce format. On associe ainsi un couple imprimante/ paramétrage à chaque format : [GraphPrinter-xxxx] device=... ... (commandes de paramétrage "Windows") [GraphPrinter-yyyy] device=... ... (commandes de paramétrage "Windows") Remarque : si un chapitre ne précise pas de commandes de paramétrage, Harmony utilise les paramètres définis pour l'imprimante au niveau du gestionnaire d'impression.

• Si le modèle ne précise pas de format ou si le format n'est pas référencé comme indiqué ci-dessus, Harmony recherche le chapitre générique [GraphPrinter]. On associe ainsi un couple imprimante / paramétrage aux impressions sans format : [GraphPrinter] device=... ... (commandes de paramétrage "Windows") Remarque : si ce chapitre ne précise pas de commandes de paramétrage, Harmony utilise les paramètres définis pour l'imprimante au niveau du gestionnaire d'impression.

• Enfin, si aucun de ces chapitres n'est présent dans Divalto.ini, c'est l'imprimante par défaut de Windows qui est utilisée. Dans ce cas : - Si le chapitre [DefaultGraphPrinter] est présent, Harmony utilise les paramètres d'impression définis dans ce chapitre. - Si le chapitre [DefaultGraphPrinter] est absent, Harmony utilise les paramètres d'impression définis au niveau du gestionnaire d'impressions.

Remarques :

• Lorsque vous faites figurer des paramètres d'impression "Windows" dans un chapitre [GraphPrinter], vous les définissez au niveau d'Harmony. Ce paramétrage de l'imprimante associée n'interfère pas avec le paramétrage défini au niveau du gestionnaire d'impression de Windows : ainsi, vous changez les paramètres d'édition des états Harmony mais vous ne touchez pas aux paramètres d'édition des autres applications Windows (Word, Excel, ...).

• Aucune différence n'est faite au niveau du format entre lettres minuscules et majuscules.

Exemple de liaisons modèle / imprimante

Mon installation comporte deux imprimantes : une Epson sur LPT1, une HP Laser Jet sur LPT2. Je veux imprimer tous les états caractères sur l'imprimante Epson et les états graphiques soit sur l'imprimante Epson, soit sur l'imprimante HP. Au cas où l'utilisateur ne préciserait pas de modèle particulier, je décide que, par défaut, les états sortiront sur l'EPSON :

Une solution consiste ici à :

• Installer les drivers Windows pour les deux imprimantes.

• Créer deux modèles d'impression dans Harmony : Modèle EPS : format spool = EPS (impressions EPSON) et Modèle HP : format spool = HP (impressions HP), en plus du modèle standard Modèle STD : format spool = espace (modèle par défaut).

• Créer par xDivaltoPrinters les sections : [GraphPrinter-EPS] device=Epson FX-80,EPSON9E,LPT1: [GraphPrinter-HP] device=HP laserJet Serie II,HPPCL,LPT2: [GraphPrinter] device=Epson FX-80,EPSON9E,LPT1:

Envois de message et de télécopie

Les états émis par une application Harmony peuvent être édités sur imprimante mais aussi directement faxés ou envoyés à leur destinataire via un service de messagerie électronique (messagerie locale ou distante, Internet, ...). Attention, cette fonctionnalité nécessite l'installation sous Windows des services de messagerie et/ou de télécopie voulus. Ces services doivent être compatibles MAPI (interface standard de programmation d'applications de messagerie). Exemple : le service Microsoft Mail de Microsoft Exchange.
Pour en savoir plus sur ce sujet, on se reportera au chapitre consacré à DivaltoViewer.