Utiliser le protocole MAPI pour l'envoi de mail ou de fax et le CRM

Owned by Bertrand Littel
Last updated: 20/09/2024
6 min read

Le bouton Protocole MAPI (client de messagerie et fax) 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, indiquez 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.
    Vous pouvez aussi 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 NULL lors de la connexion).
     

  • Utiliser l'interface 64 bits pour dialoguer avec le client de messagerie.
    Cochez cette case en cas d'utilisation de la version 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.
    En cochant cette case, vous pouvez ajouter un texte de votre choix aux envois de pièces jointes de type dhhw. Garnissez alors la zone "Message". 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.
    Cochez cette case et garnissez la zone associée pour ajouter une signature personnalisée.

 

Paramètres avancés pour MAPI

  1. Ne pas utiliser Extended Mapi.
    Demande l'utilisation de l'interface "simple" Mapi plutôt que son extension Extended Mapi.

  2. Forcer le mode Extended Mapi.
    Cocher cette case force l'utilisation du mode Extended Mapi.

  3. En mode Extended Mapi, ne pas utiliser la fonction Html to Rtf, mais laisser Outlook le faire.
    Laisse la conversion des messages au format html en rtf aux soins de Outlook et non de l'interface Mapi.

  4. Remplacer MAPI32.dll par la dll.
    Demande d'utiliser la dll spécifiée plutôt que MAPI32.dll.

  5. Dans les mails, renommer les fichiers temporaires dhvw par.
    Indiquez ici le nom à utiliser pour cette opération.

  6. Ne pas entourer l'adresse par des crochets [] à la lecture du carnet d'adresses.
    Pour éliminer les crochets des noms cherchés dans le carnet d'adresses.

  7. Oter [SMTP:] et [INTERNET:] à la lecture du carnet d'adresses.
    Pour éliminer ces préfixes des noms cherchés dans le carnet d'adresses.

  8. Découpez 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 manière à placer le nom dans le 1er 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 manière à placer le nom dans le 1er champ et l'adresse globale dans le second.

Décoder les \n,\r, etc. dans la zone Adresse
Décoder les \n,\r, etc. dans la zone Message.
On peut ajouter 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 code octal du caractère à insérer (exemple : "\012" = caractère $10).

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

Certains drivers de messageries utilisent des adresses avec plusieurs blocs séparés par des "\r".
Exemple : les drivers de type MCI utilisent des adresses finales du type : [MCI: xxx \r EMS: xxx \r MBX: xxx].
Il suffit alors d'insérer le code "\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", etc. est activé, il faut doubler ce caractère par un autre "\".
Exemple : au lieu d'écrire "mot1\mot2", il faut écrire "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 de préfixer le numéro par la chaîne de caractères indiquée (par exemple "0,").
DivaltoViewer recherche alors 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 du destinataire.
Exemple :
Si l'adresse de base est "03 88 01 02 03" ou "paul@03 88 01 02 03" et que le code à ajouter est "0,", DivaltoViewer générera les adresses suivantes :
"03 88 01 02 03" ==> "0,03 88 01 02 03"
"paul@03 88 01 02 03" ==> "paul@0,03 88 01 02 03"

Résoudre les adresses email 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.

 

Paramétrage Outlook MAPI

L'envoi de flash via Outlook peut poser des problèmes de gestion des caractères accentués.

Il convient alors de cocher “En mode Extended, ne pas utiliser la fonction HTML to RTF mais laisser Outlook le faire” et de paramétrer la composition des messages au format HTML et de demande la conversion RTF en HTML dans le format de message Outlook.

 

Debug

En cas de problèmes, il est recommandé d'activer le debug Depuis les options de messagerie, lancer le menu Divers/Activer le debug MAPI Divalto (fonctionne pour tous les protocoles)

image-20240613-085120.png

Exemple d’utilisation:

  • Activer le debug mapi Divalto (par l’entrée de menu)

  • Réaliser les actions à tester

  • Dssactiver le debug mapi Divalto (par l’entrée de menu)

  • Charger les fichiers de debug (par l’entrée de menu)

  • Consulter la trace dans l’onglet correspondant