ACE et votre messagerie

Principe

La messagerie permet d'envoyer, via l'écran UDBA_1, un e-mail lors de la fin d'une édition (correctement terminée ou non).

L'e-mail est décrit à l'aide de la gestion des modèles. Dans un modèle, on définit les destinataires (adresses ou groupes), s'ils sont en copie principal ou non et si l'édition est jointe au message.

Un modèle est aussi composé d'un objet (titre du message) et d'un corps de message. Le corps de message est un fichier associé à une maquette. L'association maquette-fichier est réalisé par la fonction UFCT, sur le code fonction UMAILE2. Les maquettes peuvent y être mentionnées grâce au popup "Saisie des maquettes". Ces paramètres peuvent toujours être modifiés juste avant la validation de l'édition.

Le mécanisme de messagerie peut s'étendre à d'autres utilisations. Les APIs fournies sont publiques mais à usage uniquement interne.

La fonction UMAIL gère les adresses e-mail. Elle permet également de composer des carnets d'adresses personnels. Les adresses de ces carnets doivent tout d'abord être déclarées dans le carnet d'adresses général. Une structure hiérarchique de groupe peut être mise en place.

Aspects techniques

La messagerie se basant sur les MAPIs (Messaging Application Program Interface), les postes clients et le serveur de messagerie doivent être des postes Windows NT. Le serveur de traitement est un serveur de type Windows NT ou Unix.

Attention (1)

N'utilisez pas une librairie ("c:\winnt\system32\mapi32.dll") trop ancienne :

La version n° 5.5.1960.0 du 08/07/99 qui fait 863Ko fonctionne.
La version n°4.00.993.3 du 15/01/97 qui fait 722Ko ne fonctionne pas.

Attention (2)

Quelle que soit la version d'ACE, la messagerie ne fonctionne pas avec les versions Outlook installées avec le PACK de sécurité SR2.

Il s'agit d'un problème que rencontrent toutes les applications (hors ACE) voulant accéder à la messagerie en utilisant les MAPIs.

Mise en place

Plusieurs étapes sont nécessaires à la mise en place de la messagerie avec ACE :

Le serveur de messagerie et le profil de messagerie doivent être décrits dans le fichier « generix.ini ».
Via UMAIL , il vous faut définir les annuaires (groupe + général),

Deux compteurs (messages et modèles de messages) sont à déclarer au niveau de la fonction UCPT ,

Il est donc important que leur intervalle de valeurs possibles ne se chevauchent pas.

Exemple :

Code	Libellé	Valeur	Mini	Maxi	Icr
MODELES	Compteur de modèles de message	1	1	1000	1
MESSAGES	Compteur de messages	1001	1001	99999	1

Par la fonction UFCT : saisir les maquettes de messagerie (code fonction UMAILE2)
Créer des modèles de message (fonction UMAIL )
Intégrer dans le traitement différé UDBA

Envoi automatique d’un mail à la fin d’un traitement différé

Deux types de messages peuvent être envoyés par ACE dans votre boîte aux lettres (compatible MAPI, comme Outlook ©) :

les messages d’avertissement pour signaler le bon déroulement du traitement ou une éventuelle erreur. Ces messages sont envoyés par le scrutateur à l’agent à l’origine du traitement différé.
Les mails classiques peuvent être saisis directement à partir de l’écran UDBA_1 ou peuvent être choisis directement à partir d’un modèle existant.

Dans la fonction UEDI, il est possible de modifier le mail associé à l’édition ou d’en créer un nouveau. Les paramètres d’avertissement de fin et d’erreur peuvent également être modifiés.

Relance d’une édition

Les options choisies lors du lancement de l’édition apparaissent lors de la relance (uedi)

Mais on peut modifier ces paramètres lors de la relance de l’édition (Avertissement de fin d’édition ou avertissement si édition terminée en erreur ou modification du mail créé lors de l’édition ou création d’un mail).

UDBA (écran UDBA_4)

Description technique des champs de cet écran.

Cet écran est automatiquement activé lorsque, sur l’écran UDBA_1, vous avez choisi l’option « Envoi d’un mail en fin de batch ».

Numéro de message : automatiquement renseigné si vous avez défini au préalable un compteur de message via la fonction UCPT.

Code langue de destination : cette zone vous permet de choisir la langue du message (langue du destinataire).

Objet : saisie libre

C : copie

Niveau :

spl : résultat du contenu de l’édition.

Le message peut être envoyé au groupe ou à une liste de diffusion définie au préalable.

UEDI (Modif dans UEDI_1)

Deux zones interviennent : changement de message et choix de l’avertissement

On peut changer et relancer l’édition.