Paramétrer DivaltoViewer

Notions de base pour l'envoi de fax ou de message

Pour envoyer un fax ou un message, un outil de messagerie a besoin de connaître les informations suivantes : 

• L'adresse du destinataire : c'est par exemple son adresse mail ou son numéro de fax
• Le type de transport : c'est le type de driver qui doit être utilisé pour envoyer le message. Il peut être différent d'un poste à l'autre et ne doit donc pas être stocké avec l'adresse du destinataire. Il faut paramétrer localement DivaltoViewer pour que celui-ci sache faire le lien avec le bon driver de message. Ce lien est contenu dans ce que nous qualifierons d'adresse finale du destinataire qui est constituée par les éléments du couple adresse du destinataire proprement dite et type de transport à utiliser.

Exemple d'un envoi de fax par le gestionnaire de fax de Windows:

Si nous voulons envoyer un fax au numéro 03 88 01 02 03 ou à Paul@03 88 01 02 03, il faudra que DivaltoViewer construise une adresse finale du type:

Exemple d'un envoi de message à l'adresse paul@wanadoo.fr avec la messagerie internet, DivaltoViewer construira une adresse finale du type:

• Le nom du profil de messagerie à utiliser ainsi que le mot de passe s'il existe. Un client comme outlook permet de créer plusieurs profils avec des paramètres différents.

Exemple : Dans les paramètres du fax pour un profil, on peut indiquer si le fax doit être envoyé Dès que possible ou A partir d'une certaine heure. On peut aussi envoyer ou non une page de garde devant chaque fax. On peut donc créer un profil dédié à DivaltoViewer, avec d'autres paramètres que le profil par défaut, demandant par exemple de ne pas envoyer de page de garde et/ou d'envoyer les fax Divalto à partir d'une certaine heure.

DivaltoViewer permet de paramétrer ces informations afin de pouvoir construire l'adresse finale d'un destinataire et se connecter à la messagerie.

Activation du menu de paramétrage

Le choix Paramètres du menu Options de DivaltoViewer permet de paramétrer les différents types d'édition d'un état dhvw.

Par défaut, ce choix n'est pas affiché par DivaltoViewer. Pour y avoir accès, on appelle l'utilitaire xDivaltoMajIni en ajoutant la clé Menu (avec la valeur 1) dans le chapitre MAPI.

L'activation de ce choix présente une liste de boutons donnant accès à une page de paramètres par type d'édition.

Impression : conditions générales et options liées à l'impression

Le bouton Impression du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres liés à l'impression des états. Les options suivantes sont proposées:

• Ne pas proposer la sauvegarde à chaque aperçu avant impression : si cette case est cochée, la question d'une éventuelle conservation de l'état n'est plus posée en quittant DivaltoViewer.
• Ne pas proposer l'envoi par mail à chaque aperçu avant impression : si cette case est cochée, la question d'un éventuel envoi par mail n'est plus posée en quittant DivaltoViewer.
• Durant l'édition, ne pas afficher la fenêtre de défilement des pages : si cette case est cochée, DivaltoViewer n'ouvre plus la fenêtre affichant la suite des pages éditées
• Journalisation des opérations : si cette case est cochée, DivaltoViewer journalise les opérations qu'il effectue, à des fins de debugging.
• Sauvegarder le sélection du choix 'Imprimer' dans la base de registre : si cette case est cochée, DivaltoViewer sauvegarde l'état de la boîte de sélection de l'imprimante afin de retrouver cet état au prochain appel de la boîte. Attention, ceci n'est valable que pour l'imprimante courante. Si on change d'imprimante dans le boîte de sélection, on repart avec les paramètres par défaut du driver de la nouvelle imprimante.

Conversion PDF : conversion au format PDF

Le bouton Conversion PDF du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres de conversion au format PDF. Les options suivantes sont proposées:

• Convertir les fichiers DivaltoViewer au format PDF lors de l'envoi par mail : demande la conversion du mail au format PDF
• Convertir les fichiers DivaltoViewer au format PDF lors de l'envoi par fax(2) : demande la conversion du fax au format PDF
• Lancer Adobe Acrobat Reader avec OPEN ou READ : Si le fichier PDF issu de la conversion doit être immédiatement affiché, cette case doit être cochée. Préciser la commande à utiliser au lancement de la lecture du fichier (OPEN, READ, EDIT...). Ceci concerne les conversions demandées à partir de DivaltoViewer
• Ajouter les fichiers joints au PDF : cette case doit être cochée si les fichiers joints doivent être ajoutés au PDF
• Lancer directement Adobe Acrobat Reader en mode aperçu : cette case doit être cochée si l'utilitaire de lecture du fichier PDF doit être appelé après la conversion, en mode Aperçu avant impression. Attention, des fonctions comme l'impression avec les paramètres d'origine ne seront plus disponibles.

Paramètres avancés - Polices de caractères

Ce bouton donne accès à un paramétrage avancé de l'utilisation des polices de caractères lors de la conversion.

Paramètres avancés - Protections

• Générer des fichiers PDF protégés par mots de passe : ce multi-choix (Jamais/ Toujours sans question/ Toujours avec question) permet de choisir si les fichiers PDF produits par DivaltoViewer doivent être protégés.

          Si oui,

                    - Mot de passe pour autoriser la lecture : si cette zone est garnie, l'utilisateur devra indiquer cette valeur de mot de passe pour pouvoir lire le fichier

crypté

                    - Mot de passe pour autoriser la modification de la protection : Par défaut, le fichier peut être lu et imprimé mais il ne peut pas être modifié et il est interdit d'en sélectionner une partie pour la copier. Si cette zone est garnie, l'utilisateur devra indiquer cette valeur de mot de passe pour pouvoir modifier le fichier (modification du texte ou des annotations) ou en sélectionner une partie pour la copier.

• PDF sécurisés : on spécifie ici les règles de sécurisation des fichiers PDF générés:

                    - Toujours générer des fichiers PDF sécurisés : cette case doit être cochée si les fichiers PDF générés par DivaltoViewer doivent être cryptés

                    - Utiliser une clé 128 bits : Par défaut, la clé de cryptage utilisée est une clé 40 bits. Cette case doit être cochée pour passer à une clé 128 bits

Demander à Adobe Acrobat Reader d'interdire permet de spécifier les fonctions interdites à l'utilisateur (copie de textes et graphiques, ajout d'annotations, modification, impression).

Paramètres avancés - Traitement des pages

Ce bouton donne accès à des options avancées concernant une éventuelle compression du contenu, conversion sous forme d'image, mise en page (marges, format, centrage).

Paramètres avancés - Traitement des images

• Toujours gérer les images en mode fichier plutôt qu'en mode mémoire : à utiliser lors de la conversion massive d'états dhvw au format PDF (plus de 100 états par exemple).

               - Mode mémoire (mode par défaut): A des fins d'optimisation, l'image du fond de chaque page de l'état est d'abord générée en mémoire. L'ensemble de ces images est stocké par Windows dans une zone mémoire spécifique, susceptible de saturer si le nombre et la taille devient très important.

               - Mode fichier : Windows peut aussi stocker les images dans des fichiers temporaires. Dans ce cas, le traitement est plus lent, mais sans limite de taille.

• Comprimer les images: cette case doit être cochée si les images doivent être compressées dans le PDF généré.

Paramètres avancés - Gestion des erreurs

• Enregistrer la liste des erreurs de conversion : cette case doit être cochée pour générer un fichier mouchard répertoriant la liste des fichiers dhvw dont la conversion ne s'est pas correctement effectuée. Auquel cas:

               - Nom du fichier log où enregistrer les erreurs : indiquer le nom du fichier mouchard (par défaut, le fichier s'appelle CompteRenduConversionPDF.log). Ce fichier se trouve dans le répertoire Divalto/DivaltoLog.

               - Répertoire de copie des fichiers erronés : indiquer le nom du dossier dans lequel les fichiers en erreur seront copiés. Par défaut, ces fichiers ne sont pas copiés.

              - Répertoire de copie des fichiers convertis sans erreur : indiquer le nom du dossier dans lequel les fichiers correctement convertis seront copiés. Par défaut, ces fichiers ne sont pas copiés.

Le fichier mouchard contient, pour chaque fichier converti en erreur, une ligne de la forme:

Pour traiter le fichier mouchard:

• Effacer le fichier avant de demander la conversion des dhvw en PDF
• A la fin du traitement, ouvrir le fichier. S'il est vide, la conversion ne comporte pas d'erreurs. Sinon, il contient les erreurs.
• Pour lire le fichier, prévoir un buffer suffisant (4096 octets par ligne)

Si les fichiers dhvw sont toujours présents sur le disque, on peut relancer la conversion en lisant chaque ligne du fichier des erreurs et en récupérant les informations (au format hmp) par hmpseek.

Exemple : 

• Délai d'attente maximum si DivaltoViewer ne répond pas (en secondes) : Un time-out est demandé par DivaltoViewer afin d'être débloqué si la conversion ne répond pas. Cette valeur permet de spécifier la durée de ce time-out, en secondes (180, par défaut).

Format des adresses : Choix du format d'adresse pour les différents types d'édition

Le bouton Format des adresses du choix Paramètres du menu Options de DivaltoViewer  donne accès au choix du format d'adresse pour les différents types d'envoi : Par défaut, Fax(2), Mail(2), Email(2), Autre(2).

Remarque : ces types correspondent aux  multi-choix Type de la boîte de dialogue Destination de l'état de Xwin (accessible depuis un masque d'impression par le choix du menu Paramètres : Masque, bouton Adresses):

• Fax

L'adresse doit alors contenir le numéro de fax du destinataire.

Exemple: 03 88 01 02 03 ou paul@03 88 01 02 03

• Mail

L'adresse doit alors contenir l'adresse mail générique du destinataire

Exemple: Pierre

• Email

L'adresse doit alors contenir l'adresse mail internet du destinataire

Exemple: Pierre@divalto.com

• Autre

L'adresse doit alors contenir l'adresse du destinataire dont le type n'est pas défini ci-dessus.

• Fax(2), Mail(2), Email(2), Autre(2)

Ces types sont identiques aux précédents mais permettent d'utiliser un deuxième transport de messagerie.

Les valeurs par défaut utilisées par DivaltoViewer sont, par type d'envoi:

Remarque : Le mot clé %ADR% représente l'adresse du destinataire.

Exemple : si l'adresse du destinataire est 03 88 01 02 03 avec comme format de l'adresse finale, alors %ADR% sera remplacé par la chaîne 03 88 01 02 03 et on obtiendra .

%ADRNOESP% peut aussi être utilisé. Dans ce cas les espaces présents dans l'adresse seront éliminés. 

Exemple : l'adresse 03 88 01 02 03 @relayfax.com sera réduite à 0388010203@relayfax.com

Protocole MAPI (client de messagerie et fax) : utiliser le protocole MAPI pour l'envoi de mail ou de fax et le CRM

Le bouton Protocole MAPI (client de messagerie et fax) du choix Paramètres du menu Options de DivaltoViewer  donne accès aux paramètres d'envoi de mail ou de fax et du CRM par l'interface MAPI. Les options suivantes sont proposées:

• Profil par défaut dans le client de messagerie : Le profil est celui défini par défaut au niveau du client de messagerie. DivaltoViewer l'utilisera pour envoyer les messages ou les fax si aucun autre profil n'est spécifié. Dans ce cas, indiquer le mot de passe à utiliser pour ce profil dans la zone Mot de passe pour ce profil
• Profil et mot de passe par défaut : on peut demander à DivaltoViewer d'utiliser un autre profil par défaut (et un mot de passe associé) que celui défini par défaut dans le client de messagerie.

Attention : Certains produits de gestion de mails (Mozilla, Thunderbird par exemple) n'acceptent pas de nom de profil lors de la connexion. Il faut dans ce cas remplir les champs Profil et mot de passe par défaut avec le mot clé conventionnel:

                 - /noprofile qui permet d'indiquer un nom de profil vide lors de la connexion ou

                 -/noprofilenull qui permet d'indiquer une adresse de nom de profil vide lors de la connexion

• Utiliser l'interface 64 bits pour dialoguer avec le client de messagerie : à cocher en utilisation 64 bits
• Toujours afficher la boîte d'envoi du client de messagerie : si cette case est cochée

                  - Lorsque le message est envoyé par programme, la boîte d'envoi de mail du client de messagerie est toujours ouverte, même si le programme ne l'a pas demandé.

                  - La case Afficher la boîte d'envoi du client de messagerie sera cochée par défaut dans la boîte de dialogue du choix Envoyer vers.

• Sinon, proposer l'affichage de cette boîte par défaut dans le choix Envoyer vers : si cette case est cochée, la case Afficher la boîte d'envoi du client de messagerie sera cochée par défaut dans la boîte de dialogue du choix Envoyer vers.

Paramètres avancés pour les mails

• Ajouter ce texte en cas d'envoi d'un fichier au format dhvw : par défaut, le texte standard spécifié dans la zone Texte par défaut (indiquant comment télécharger DivaltoViewer) est ajouté à la fin d'un message par mail. En cochant cette case, on peut remplacer le texte par défaut par un texte au choix. Garnir alors la zone Sinon, prendre ce texte.
• Ajouter cette signature à mes mails : Cocher cette case et garnir la zone associée pour ajouter une signature personnalisée.

Paramètres avancés pour MAPI

• Ne pas utiliser Extended Mapi : demande l'utilisation de l'interface simple Mapi plutôt que son extension Extended Mapi.
• Remplacer MAPI132.dll par la dll : demande d'utiliser la dll spécifiée plutôt Mapi132.dll
• Dans les mails, renommer les fichiers temporaires dhvw par : indiquer ici le nom à utiliser pour cette opération
• Ne pas entourer l'adresse par des crochets à la lecture du carnet d'adresse : élimination des crochets des noms recherchés dans le carnet d'adresse
• Oter SMTP et INTERNET à la lecture du carnet d'adresse : élimination de ces préfixes des noms recherchés dans le carnet d'adresse
• Découper une adresse du type 'aaa'<bbb@ccc> : la nécessité de découper une adresse finale de type nom+adresse en deux champs dépend du produit utilisé pour l'envoi:

               - Aucun : l'adresse finale n'est pas découpée

               - Nom/ Adresse : l'adresse finale est découpée de façon à placer le nom dans le premier champ et l'adresse proprement dite dans le second.

               - Adresse : l'adresse n'est pas découpée, mais le nom est éliminé pour ne garder que l'adresse proprement dite.

               - Nom / Nom+Adresse : l'adresse est découpée de façon à placer le nom dans le premier champ et l'adresse globale dans le second.

• Décoder les \n, \r, etc. dans la zone Adresse et Décoder les \n, \r, etc. dans la zone Message : On peut rajouter dans la zone message ou adresse des caractères tels que \n, \r,\t, \ddd, ou \xdd: 

                - \n sera remplacé par un saut de ligne (code $0a)

                - \r sera remplacé par un retour à la ligne (code $0d)

                - \t sera remplacé par une tabulation (code $09)

                - \ddd où ddd représente le caractère octal du caractère à insérer (exemple: \012 = caractère $10)

                - \xdd où dd représente le caractère hexadécimal du caractère à insérer (exemple: \x0A = caractère $10)

Certains drivers de messagerie utilisent des adresses avec plusieurs blocs séparés par des\r.

Exemple : les drivers de type MCI utilisent des adresses finales du type .

Il suffit alors d'insérer le \r dans le format de l'adresse finale.

Mais attention, si vous voulez mettre le caractère \ dans la zone adresse ou message alors que le décodage des \n, \r,\t, \ddd, ou \xdd est activé, il faut dédoubler ce caractère (mot1\\mot2).

• Fermer le fichier DivaltoViewer : le fichier à envoyer est ouvert par DivaltoViewer afin de l'afficher et de lire ses paramètres d'envoi. Si le driver de messagerie n'arrive pas à ouvrir ce fichier, il faut mettre ce paramètre à oui, ce qui obligera DivaltoViewer à fermer le fichier le temps de l'envoi du message.
• Devant le numéro de téléphone (FAX), ajouter le code : lorsque le programme d'application demande la composition automatique du numéro de téléphone, permet préfixer le numéro par la chaîne de caractères indiquée (par exemple 0). DivaltoViewer recherche le caractère @ dans l'adresse du destinataire et ajoute le code derrière ce caractère. S'il n'y a pas de 
• caractère @ dans l'adresse du destinataire, DivaltoViewer ajoute le code au début de l'adresse.

Exemple : si l'adresse de base est 03 88 01 02 03 ou paul@divalto.com et que le code à ajouter est 0, DivaltoViewer génèrera les adresses suivantes:

0 03 88 01 02 03 ou paul@0 03 88 01 02 03

• Résoudre les adresses mail avec : Permet de résoudre un nom en clair avec l'adresse internet réelle associée (cette adresse est recherchée dans la base de données du client de messagerie), en spécifiant l'interface à utiliser (Simple Mapi ou Extended Mapi)

Gestion des profils

Ouvre une boîte de dialogue permettant de gérer les profils du client de messagerie.

Protocole SMTP (par le service SMTP/ par les fonctions SMTP) : envoi de messages électroniques par le protocole SMTP

Pour l'envoi d'un message électronique par programme, Harmony utilise habituellement l'interface MAPI (Interface standard de Programmation d'Applications et de Messagerie). Le destinataire est un serveur Mapi (Outlook express, outlook...) qui stocke le message dans une base de données et l'émet (soit directement vers un fournisseur d'accès, soit par l'intermédiaire du service de messagerie Microsoft Exchange Server). Un inconvénient à cette méthode est l'obligation d'ouvrir une session utilisateur et d'y lancer le programme Microsoft Outlook.

Une alternative consiste à utiliser directement le protocole SMTP (Simple Mail Transfert Protocol).

SMTP est un protocole standard non propriétaire, utilisé pour transférer le courrier électronique vers les serveurs de messagerie et les boîtes aux lettres des destinataires, via internet. Il va nous permettre ici d'envoyer des messages sans transiter par le client Outlook.

Principe de fonctionnement

• Méthode utilisant un service SMTP : le principe ici consiste à déposer le mail dans un répertoire spécifique. Le service SMTP scrute ce répertoire en permanence et dès qu'un nouveau fichier est ajouté, il l'envoie au destinataire et le supprime du répertoire. En cas d'erreur lors de l'envoi, un rapport de non-remise est envoyé à l'expéditeur (et éventuellement à d'autres destinataires). Si l'envoi du rapport de non-remise est lui-même en erreur, le message est transféré dans un autre répertoire spécifique.

Ce service SMTP n'est pas disponible sous Vista (mais ceci n'est pas un réel problème puisque Vista tourne généralement sur un ordinateur client et on implémentera plutôt le service SMTP sur un ordinateur équipé d'un système serveur.

• Méthode sans service SMTP : ici, Divalto envoie directement le mail au destinataire, par l'intermédiaire d'une fonction du FrameWork dotnet.

Dans les deux cas, le mail peut être envoyé soit directement depuis le poste client léger (hors client léger Web), soit depuis le serveur d'applications.

Paramétrage Divalto

Le paramétrage Divalto s'effectue en deux temps : il faut demander que les envois d'e-mails fassent appel au protocole SMTP et configurer le client SMTP.

• Utilisation du protocole SMTP: le bouton Format des adresses du choix Paramètres du menu Options de DivaltoViewer donne accès au choix du format d'adresse.  Pour l'adresse Email et/ou Email2, selectionner le choix SERV_SMTP:%ADR% du multi-choix:

• Paramétrage du client avec utilisation d'un service SMTP : le bouton Protocole SMTP (par le service smtp) du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres suivants :

                    - A destination du serveur smtp : entrer ici le chemin d'accès du répertoire scruté par le serveur SMTP pour l'envoi des messages.

Exemple : //messagerie /pickup où messagerie est le nom de l'ordinateur et pickup le nom de partage Windows du répertoire.

Le répertoire physique dépend du type d'installation. Il est local à l'ordinateur sur lequel s'éxécute le service SMTP, se nomme Pickup et se situe sous le répertoire de base du serveur de messagerie (à titre indicatif : c:\Inetpub\Mailroot\PickUp ou c:\Program Files\Exchsrvr\Mailroot\vsi 1\PickUp avec Microsoft Exchange Server)

                    - Identité ou Adresse internet à placer dans le champ 'De la part de...' : Texte que les destinataires des messages recevront comme venant de la part de ...

                    - En mode connecté, le service SMTP est sur le serveur distant Divalto : cocher cette case pour utiliser le service SMTP du serveur d'application plutôt que celui du poste client local (en mode connecté uniquement).

• Répertoire de copie des mails : ce bouton donne accès aux paramètres:

                      - Répertoire de copie des mails envoyés : répertoire de stockage d'une copie du fichier généré. 

                      - Répertoire des mails en erreur : en cas d'erreur, répertoire de stockage d'une copie et d'un fichier de même nom mais d'extension .log contenant le texte de l'erreur rencontrée.

Exemple: si l'envoie du fichier 201009031428380000PORT_JPT28r5eihy86zo6ajn.eml est sorti en erreur, on trouvera aussi dans le répertoire des mails en erreur un fichier 201009031428380000PORT_JPT28r5eihy86zo6ajn.log contenant le texte de l'erreur qui a empêché l'envoi du mail.

                       - Répertoire du fichier Smtp.log : un fichier log contient, pour chaque message envoyé, la date et l'heure de l'envoi, l'objet du message, l'emetteur et le destinataire du message, un indicateur de succès ou d'erreur, le nom du fichier contenant le message.

                        - Ne journaliser que les erreurs dans Smtp.log : option permettant de ne tracer que les erreurs dans le fichier log.

Paramètres avancés

Ce bouton donne accès aux paramètres:

              - Délai de latence entre deux envois de mails : en cas d'envoi consécutifs de mails en grand nombre (par exemple, envoi de flashs ou de messages dans le CRM Divalto), certains fournisseurs d'accès SMTP bloquent l'envoi, considérant qu'il s'agit de spams. Ce paramètre permet d'espacer les envois (la valeur 15 permet par exemple de n'envoyer qu'un mail toutes les 15 secondes). Mais attention, ne fonctionne que pour un même programme Diva, mais pas entre plusieurs programmes Diva.

             - Extension du fichier temporaire à générer :  Harmony utilise l'extension .eml par défaut (Exchange 2010 exige notamment cette extension). Dans les versions précédentes, Harmony générait des fichiers avec extension .txt. Ce paramètre est utilisé pour reprendre cette extension .txt ou forcer toute autre extension.

              - Code page du corps du message par défaut :  Le code page indique le type de caractères utilisé dans Windows. En Europe du nord, c'est le type windows-1252 . Dans d'autres pays, ce code peut être différent (par exemple windows-1257 pour les pays de l'est). Il permet au destinataire du message de savoir comment interpréter les caractères spéciaux et notamment les caractères accentués.

              -  Sinon, utiliser le texte suivant : code page à utiliser

              - Autoriser l'envoi du corps du message au format HTML ou Autoriser l'envoi du corps du message au format RTF : Le format du corps du message est par défaut HTML car ce format est reconnu par la plupart des récepteurs de mails. On peut aussi sélectionner le format RTF (moins utilisé) ou texte simple (formats HTML et RTF décochés). Le logiciel CRM de Divalto génère automatiquement le texte de certains messages (par exemple à l'occasion d'un e-mailing ou d'un évènement). Pour cela, le programme interroge la DLL DhMapi pour savoir s'il peut générer du HTML, du RTF ou du texte simple. Selon la réponse du DhMapi, le programme génèrera un texte au format adapté.

              - Mettre une commande To: par destinataire : Certains fournisseurs d'accès interdisent plus d'une commande To: par mail.D'autres préfèrent avoir une commande To: par destinataire. Et certains autorisent les deux.

Par défaut, Harmony génère une seule commande To: avec les noms des destinataires sur plusieurs lignes. Ce paramètre active l'envoi d'une commande To: par destinataire.

• Paramétrage du client sans utilisation d'un service SMTP

Le bouton Protocole SMTP (par les fonctions smtp) du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres suivants:

                  - Envoyer le mail directement avec la fonction SMTP de Divalto : cocher cette case pour utiliser le mode Sans service SMTP.

                  - En mode connecté, la fonction SMTP de Divalto est sur le serveur distant Divalto : cochez cette case pour que l'envoi se fasse à partir du serveur d'applications plutôt qu'à partir du poste client local - en mode connecté uniquement - . Si DivaltoViewer n'est pas connecté et si cette case n'est pas cochée, une tentative d'envoi du mail sera tout de même faite depuis le poste local.

Remarque : DivaltoViewer est en mode connecté lorsqu'on paramètre côté client un profil de connexion non local pour dialoguer avec un serveur d'applications Divalto. Il est alors possible de générer le mail localemet ou depuis le serveur Divalto. 

Au besoin, un choix de menu de DivaltoViewer permet se se connecter/déconnecter à un serveur d'applications Divalto.

Un accès au réseau internet est nécessaire pour l'envoi du mail (sur le poste client en cas d'envoi local, sur le serveur d'applications en cas d'envoi depuis ce serveur).

                  - Identité ou Adresse Internet à placer dans le champ 'De la part de ...' : Texte que les destinataires des messages recevront comme venant De la part de...

                  - Envoyer le mail sans générer le fichier : Si cette case est cochée, aucun fichier n'est généré ni sauvegardé dans le répertoire SMTP des mails envoyés. A contrario, préciser le répertoire de stockage des mails.

                  - Nom du serveur SMTP, Port et Domaine : Adresse du fournisseur d'accès internet. Si un nom de domaine est requis, le renseigner dans le champ Domaine. Par défaut (valeur nulle), le port 25 est utilisé en mode normal et le 587 en SSL. Si un autre port est requis, le préciser dans le champ Port.

                    - Code utilisateur et mot de passe : indiquer le code utilisateur et le mot de passe enregistrés auprès du fournisseur d'accès.

                   - Le serveur SMTP utilise SSL : à cocher si la connexion est sécurisée. 

• Installation et configuration du service SMTP

La procédure d'installation et de paramétrage diffère suivant l'OS installé, le service utilisé et le fournisseur d'accès. A titre indicatif, sont donnés ici quelques éléments pour installer et paramétrer le service SMTP de Microsoft.

Remarque : Le serveur SMTP sert uniquement de relais vers le serveur SMTP du fournisseur d'accès. Ce relais doit être correcteent configuré, sinon les logicieks anti-spams des fournisseurs d'accès risquent de bloquer la remise des mails ( voir de se faire black-lister).

             - Installation du service SMTP

                       1. Aller en Ajout/Suppression de programmes

                       2. Ajouter des composants windows

                       3. Ajouter des services internet (IIS)

                       4. Dans la liste des composants des Services Internet (IIS), cocher la case Service SMTP 

                       5. Terminer l'installation

L'installation créé, au niveau du Gestionnaire des services Internet, le nœud Serveur virtuel SMTP par défaut. Ce noeud inclut la branche Domaines, dans laquelle sera créé un domaine distant.

Remarque : la session doit être ouverte en tant que membre du groupe Administrateurs sur l'ordinateur local ou être doté des droits appropriés pour être autorisé à paramétrer le gestionnaire des services internet.

             - Création d'un domaine distant

Dans le gestionnaire des Services Internet :

                        - Ouvrir la branche Serveur virtuel SMTP par défaut. 

                        - Cliquer droit sur la ligne Domaines et sélectionner le choix Nouveau→Domaine...

                         - Dans l'Assistant Nouveau domaine SMTP, sélectionner le radio bouton Distant et cliquer sur le bouton Suivant.

                           Entrer un nom de domaine (par exemple *.Societe.fr) et cliquer sur le bouton Terminer.

              - Configuration du domaine distant

Dans le gestionnaire des services internet :

                      - Cliquer droit sur la ligne affichant le nom du domaine distant et sélectionnez le choix Propriétés.

                      - Sous l'onglet Général, sélectionner l'option Transférer tout le courrier vers l'hôte actif et indiquer le nom (ou adresse IP entre crochets) du serveur SMTP du fournisseur d'accès (par exemple: smtp.fr.oleane.com).

                       - Le bouton Sécurité sortante permet de définir le mode de connexion. La case Connexion anonyme permet de se connecter sans fournir de renseignements supplémentaires mais la plupart des providers autorisent l'accès à leur serveur SMTP sous réserve d'une authentification basée au minimum sur un nom d'utilisateur et un mot de passe.

              - Configuration générale du service SMTP

Le service SMTP se paramètre globalement en cliquant droit sur la ligne Serveur virtuel SMTP par défaut puis en sélectionnant le choix Propriétés. Il est en particulier possible de spécifier d'autres destinataires que l'emetteur pour les rapports de non-remise en cas d'erreur, de modifier le port TCP ou le répertoire de stockage du courrier incorrect, d'imposer une limite de taille des messages, de configurer l'intervalle de temps entre les tentatives d'envoi, etc.

              - Site internet

Pour la mise en place et la configuration des serveurs virtuels SMTP et IIS, se référer au besoin au site http://msdn2.microsoft.com/fr-fr/library/8b83ac7t(VS.80).aspx

Exchange Web Service : Utiliser Exchange Web Service pour l'envoi de mails et le CRM

Pour l'envoi d'un message électronique par programme, Harmony utilise habituellement l'interface MAPI (Interface standard de Programmation et d'Applications de Messagerie). Le destinataire est un serveur Mapi (Outlook, outlook express...) qui stocke le message dans une base de données et l'émet (soit directement vers un fournisseur d'accès, soit par l'intermédiaire du service de messagerie Microsoft Exchange Server). Un inconvénient à cette méthode est l'obligation d'ouvrir une session utilisateur et d'y lancer le programme Microsoft Outlook.

Une alternative consiste à interfacer directement Microsoft Exchange Server via le service EWS (Exchange Web Service). De plus, EWS est la seule solution en mode client léger Web. 

Le bouton Exchange Web Service du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres d'envoi de mail et du CRM par l'interface EWS. Les options suivantes sont proposées:

• Utiliser Exchange Web Service pour l'envoi de mail et le CRM : demande que les messages habituellement traités en utilisant l'interface MAPI soient redirigés vers EWS.
• Utiliser la boîte de dialogue pour EWS pour le bouton contact de DivaltoViewer : demande l'utilisation d'une boîte de dialogue Divalto plutôt que celle du client Outlook pour accéder au carnet d'adresse.
• Accès au serveur EWS : L'installation du produit Exchange Server installe également un service Web auquel un nom est attribué. L'accès à ce service nécessite de préciser une Url Web comportant le nom du produit et sa version, le nom du service, le chemin d'accès et le nom de la page Web.

Exemple : https://Exchange2010.Divalto.local/EWS/Exchange.asmx

• Ce cadre précise la méthode devant être uilisée par DivaltoViewer pour accéder au serveur Exchange :

                       - Nom Web du serveur EWS : Pour utiliser cette première méthode d'accès, saisir ici uniquement Nom_produitVersion.Nom_Service

Dans l'exemple précédent : Exchange2010.Divalto.local

DivaltoViewer complète automatiquement cette valeur pour constituer l'Url Web complète indiquée en exemple.

                       - Sinon utiliser l'url complète du service EWS : cette deuxième méthode consiste à donner l'url complète.

Exemple : https://Exchange2010.mon_service/mon_chemin/Exchange.asmx

                       - Sinon détecter automatiquement le serveur EWS avec l'adresse Email :  cette troisième méthode consiste à indiquer l'adresse mail d'un compte utilisateur Exchange (qui peut être son propre compte utilisateur). Dans ce cas, DivaltoViewer utilise une fonction qui lui permet de détecter automatiquement le service EWS. Cette méthode est la plus simple à mettre en oeuvre car elle ne nécessite pas de connaître le paramétrage fait lors de l'installation de Exchange.

Exemple : PaulDurand@mon_domaine.fr

                      - Version de Exchange : indiquer la version de Exchange installée.

• Compte utilisateur pour la connexion à EWS et la lecture de la boîte aux lettres : indiquer votre compte, mot de passe et le cas échéant le mon du domaine.
• Compte pour la lecture des contacts dans Active Directory (si différent de celui de EWS) : indiquer votre compte, mot de passe et le cas échéant le mon du domaine.
• Code page de texte : à préciser en cas d'envoi d'un texte dans une langue non occidentale.

Lotus Notes : Utiliser Lotus Notes pour l'envoi de mails et le CRM

Le bouton Lotus Notes du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres d'envoi de mail et du CRM par Lotus Notes. Les options suivantes sont proposées:

• Utiliser Lotus Notes pour l'envoi de mail et le CRM : cocher si Lotus Notes est l'outil de messagerie.
• Gestion des profils : ouvre une boîte de dialogue permettant la gestion des profils du client de messagerie Lotus Notes.

Protocole MAILTO : Utiliser le protocole MAILTO pour l'envoi de mail en client léger Web

Le bouton Protocole MAILTO du choix Paramètres du menu Options de DivaltoViewer donne accès à l'option permettant d'utiliser le protocole Web MAILTO en client léger Web.

Ce protocole permet d'envoyer des mails simples (sans pièces jointes) en mode interactif.

Protocole OLE ( fax et com) : envoi de fax

Le bouton OLE Fax et Com du choix Paramètres du menu Options de DivaltoViewer permet, en mode connecté, de spécifier si le service utilisé se situe sur le serveur d'applications distant Divalto.

Le logiciel d'émission de fax utilisé détermine le choix du type d'adresse parmi les suivants:

• COMFAX:%ADR% ou COMFAX2:%ADR% (Service de télécopie de Windows 2003 serveur, onglet Fax ou Fax2)
• MSFAX:%ADR% ou MSFAX2:%ADR% (Service de télécopie de Windows 2000 ou XP, onglet Fax ou Fax2)
• COMMAIL:%ADR% ou COMMAIL2:%ADR% 
• (Exchange Server, Rte Fax...)

Service de télécopie de Windows XP/ 2000

A partir de Windows XP/ 2000, on peut installer le service de télécopie qui se trouve sur le CD Windows. Il suffit alors d'installer un modem fax et de le lier au service Fax de windows. Dans DivaltoViewer, on peut utiliser ce service en positionnant le type d'adresse sur MSFAX:%ADR% ou MSFAX2%:ADR%. Harmony utilise alors l'interface Fax de Windows.

Modifier le cas échéant le fichier paramètre Param_msfax.txt pour personnaliser l'interface. Il contient des valeurs par défaut et les options à fournir au service Fax de Windows, comme par exemple:

            - Le nom de la page de garde à utiliser s'il y en a une (mot clé CcoverPage = xxx). Attention à mettre le nom complet du fichier avec le chemin au format Windows

            - Le nom et l'adresse de l'entreprise

            - Attention, cette interface ne fonctionne pas en mode serveur de fax. Il s'agit toujours d'un service fax local à la machine. Le paramètre Server= du fichier  Param_msfax.txt n'est donc pas opérationnel et doit être laissé vide.     

• Le fichier Param_msfax.txt est cherché par défaut dans le répertoire de Divalto x:\Divalto\sys. Pour utiliser un autre fichier ou un autre chemin, modifier la clé file = xxxx ( xxxx au format Windows) du chapitre msfax de Divalto.ini

Exemple : file=\\derveur\partage\param_msfax.txt

L'option Propager de xDivaltoIni.exe peut être utilisée pour propager la modification de Divalti.ini sur tous les comptes utilisateur.

• Avec le type d'adresse MSFAX2%ADR%, c'est le fichier Param_msfax2.txt qui sert au paramétrage. Ce fichier n'est pas livré. Il suffit d'y copier le contenu de Param_msfax.txt.

Service de télécopie de Windows serveur 2003

Windows serveur 2003 propose aussi un service de télécopie. Il est accessible depuis toutes les machines connectées au réseau, à condition de partager le service de télécopie et de paramétrer les droits adéquats pour les postes concernés. Dans DivaltoViewer, il faut alors utiliser le type d'adresse COMFAX:%ADR% ou COMFAX2:%ADR% . L'interface utilise l'objet COM du service de télécopie, à travers des commandes OLE Automation.

Modifier le cas échéant le fichier paramètre Param_comfax.txt pour personnaliser l'interface. Ce fichier contient des valeurs par défaut et les options à fournir au serveur fax comme par exelple : 

         -  Le nom de la page de garde à utiliser s'il y en a une (mot clé CcoverPage = xxx). Attention à mettre le nom complet du fichier avec le chemin au format Windows

         - Le nom et l'adresse de l'entreprise

           - Le paramètre Server= doit être renseigné avec le chemin réseau du serveur de fax.

Exemple : server=\\mon_serveur_de_fax_2003

• La ligne File= contient le nom d'un fichier de commandes OLE Automation (ole_comfax.txt par défaut). Il contient les ordres OLE permettant de se connecter au serveur 2003.
• Pour changer le nom ou le chemin de ce fichier, modifier la clé file = xxxx ( xxxx au format Windows) du chapitre comfax de Divalto.ini

Exemple : file = \\serveur\partage\param_comfax.txt

L'option Propager de xDivaltoIni.exe peut être utilisée pour propager la modification de Divalti.ini sur tous les comptes utilisateur.

• Avec le type d'adresse COMFAX2%ADR%, c'est le fichier Param_comfax2.txt qui sert au paramétrage. Ce fichier n'est pas livré. Il suffit d'y copier le contenu de Param_comfax.txt.

Logiciels utilisant la couche SMTP (RelayFax, Rte Fax 2008...)

Pour envoyer un fax par e-mail, on dispose de 2 types de formats (NNNNNNNNNN représente le numéro de téléphone)

• Avec le format du type "NNNNNNNNNN" <fax@société.local>, le format dans Divalto sera "%ADR%"  <fax@société.local>
• Avec le format du type NNNNNNNNNN <fax@société.local>, le format dans Divalto sera %ADR%  <fax@société.local>

Logiciel RelayFax

Le logiciel RelayFax comporte les particularités suivantes : 

• Commandes du shell Print To et Print

Lorsqu'un logiciel de fax doit émettre un fichier, il est nécessaire que le propriétaire du fichier lui fournisse l'image de chaque page à faxer. Pour cela, il cherche dans la base de registres le programme associé à l'extension du fichier, le lance et lui envoie la commande PrintTo.

A l'installation, DivaltoViewer s'inscrit dans la base de registre comme étant le programme d'édition des fichiers de type .dhvw et traitant la commande PrintTo. Ainsi  DivaltoViewer permet l'édition de ce type de fichier vers l'imprimante virtuelle dédiée au logiciel de fax.

Attention, certains logiciels comme RelayFax n'envoie pas la commande PrintTo, mais Print. Dans ce cas:

                            - Appeler l'utilitaire xDivaltoPrinters.exe

                            - Sélectionner l'imprimante concernée

                            - Cliquer sur le bouton Paramètres Print To

                            - Activer l'option Traiter la commande shell Print comme si c'était PrintTo avec l'imprimante par défaut

• Mode portrait/paysage

Les éditions Divalto peuvent se faire en mode portrait ou paysage. RelayFax ne traite que le mode portrait. 

                            - Appeler l'utilitaire xDivaltoPrinters.exe

                            - Sélectionner l'imprimante concernée

                            - Cliquer sur le bouton Paramètres Print To

                            - Pour chaque imprimante RelayFax, cliquer sur le bouton Gérer l'orientation et HWCreateDC et activer l'option Si on gère l'orientation alors toujours utiliser la fonction HW_CreateDC pour ouvrir l'imprimante

Remarque : Fotowin ou Rte Fax ne nécessitent aucun paramétrage particulier car ils utilisent le fonctionnement par défaut (sans ouverture de l'imprimante par HXCreateDC)

Export tableur : paramétrage de l'export tableur des états imprimés

Le bouton Export tableur du choix Paramètres du menu Options de DivaltoViewer donne accès aux paramètres d'export des données de l'état vers un tableur. Les options suivantes sont proposées:

• Générer les données pour l'export tableur dans le dhvw : Par défaut, cette option est positionnée. Si la case est décochée, les états imprimés après invalidation de l'option ne pourront plus être exportés.

Remarque : afin d'accélérer les impressions, on pourra invalider la génération sur un poste qui produit de nombreux états non exportés (en particulier s'ils contiennent de gros fichiers. RTF)

• Ouvrir le fichier à la fin de l'export : par défaut cette option est positionnée. Si cette case est décochée, le logiciel tableur ne sera plus automatiquement exécuté à la fin de l'export. 

Remarque : inutile de positionner cette option sur un poste qui produit des exports tableur, mail qui n'est pas équipé d'un logiciel tableur.

• Utiliser l'écriture directe dans le flux XML : cette option règle le cas des grosses impressions qu'il est impossible d'exporter consécutivement à une saturation mémoire.
• Journalisation des opérations : si cette case est cochée, des informations sur les opérations d'export seront enregistrées dans le fichier \divaltolog\ExportTableur.log
• Afficher le contenu complet des messages d'erreur : à utiliser pour afficher le détail des messages d'erreur. A défaut, les messages d'erreur sont succints.

Propagations des modifications sur d'autres postes du serveur d'applications

DivaltoViewer stocke les paramètres propres à un utilisateur dans Divalto.ini. Cette section de la base de registre est liée à l'utilisateur en cours. Suite à une modification, DivaltoViewer permet de propager (seulement si DivaltoViewer est lancé par la commande Exécuter du menu Démarrer par la commande DialtoViewer/propager) les changements effectués sur tout ou partie des utilisateurs du même serveur. 

Pour ce faire, on clique sur le bouton Propager :

• En cas de réponse négative, les nouveaux paramètres ne concerneront que l'utilisateur courant (seul son Divalto.ini sera modifié)
• En cas de réponse positive, les nouveaux paramètres seront copiés dans tout ou partie des Divalto.ini du serveur.

Remarque : la copie de la section Divalto.ini d'un autre utilisateur déjà connecté n'est pas instantanée. Elle se fera lorsque cet utilisateur cliquera sur le bouton Réactualiser dans les options avancées de la boîte de connexion. A défaut, la copie se fera lorsque l'utilisateur se reconnectera au serveur et à condition qu'une heure se soit écoulée depuis sa dernière connexion.

Boutons Recharger Installlog et Recharger Installlog précédent : les mises à jour demandées sont stockées dans des fichiers log qui peuvent être exécutés. Recharger Installlog demande le chargement des fichiers log non encore chargés sur ce poste (fichiers qui ont été écrits après la dernière mise à jour). Recharger Installlog précédent fait de même, mais recharge en supplément les fichiers qui avaient été chargés à l'occasion de la dernière mise à jour.