Référence d'Up ! Mail Service

Cette interface décrit les Application Program Interface (API) permettant d'utiliser d'Up ! Mail Service en mode programmation. Ses paramètres et son comportement sont les mêmes qu'en mode ligne de commande.

Les formats des Uniform Resource Identifier pour un accès en Internet Message Access Protocol, Post Office Protocol ou Simple Mail Transfer Protocol sont les suivants :

imap://${NomServeur}:${Port}
pop://${NomServeur}:${Port}
smtp://${NomServeur}:${Port}

Avec :

Pour offrir ces services, Up ! Mail Service utilise un annuaire électronique qui est une vue de l'annuaire d'Up ! Object Request Broker.

Afin de réaliser des importations et des exportations aisément, un annuaire électronique est aussi une ressource conservée dans un fichier en marge des applications.

Un annuaire électronique peut être dans deux formats :

Il est possible de passer du format binaire au format Up ! 5GL en changeant le mode d'enregistrement.

Les annuaires électroniques sont usuellement conservés dans le répertoire ${UPS_HOME}/upsnet/resources/${UPS_LANGUAGE}. Le fichier conservant le contenu de l'annuaire porte le nom de celui-ci.

L'intérêt d'employer un annuaire électronique est de pouvoir gérer aisément les adresses électroniques des utilisateurs et les abonnements électroniques. Cela est d'autant plus important dans une architecture multi-programmes.

Une fois l'annuaire chargé par Up ! Object Request Broker, éventuellement mis à jour par Up ! Mail Service, ce dernier le présente sous forme d'objets du type AbonnementElectronique ou une extension du type Utilisateur.

Les annuaires électroniques sont automatiquement chargés dès leur premier accès et ils sont automatiquement enregistrés lors de l'arrêt du programme s'ils ont été modifiés.

Pour connaître les paramètres d'Up ! Mail Service, merci de se référer à la fiche Paramètres d'Up ! Mail Service.

Pour avoir un exemple complet d'usage d'Up ! Mail Service, merci de se référer à la fiche Serveur d'application.

Up ! Mail Service met en oeuvre les standards Internet Mail Acces Protocol, Post Office Protocol et Simple Mail Transfer Protocol du World Wide Web Consortium (W3C).

Enumérés

EtatCourrier

TypeOperation

Interfaces

IServeurMessagerie

Types

AbonnementElectronique AnnuaireElectronique

BoiteAuxLettresElectronique

ClientMessagerie CourrierElectronique

ServeurMessagerieImap ServeurMessageriePop

Exceptions

AbonnementElectroniqueInexistant AjoutAnnuaireElectroniqueImpossible AjoutAbonnementElectroniqueImpossible AnnuaireElectroniqueInexistant

EstDejaAbonne

FichierAnnuaireElectroniqueInexistant

NEstPasEncoreAbonne

OuvertureLectureBoiteAuxLettres OuvertureLectureCourrierElectronique

Procédure et fonctions

Fonction Habilitation Optimiser(NulAbsorbant, PasDEffetDeBord) ChercherUtilisateurProprietaire(AdresseElectronique : Nul Ou Caractere) Retourner Nul Ou Utilisateur;

Adaptateurs

Technologie tierce.Accès à la classe.Nom de la classe.
Com.fecd1b00-8a05-11d0-8e3c-e1043ebbde2bUpsMls
Corba.IDL:UpsMls:2.5UpsMls::UpsMls
Java / Ejb.upsnet.jarUpsMls.UpsMls
Pl/Sql.--
Rfc for Sap.--
Soap.--