Référence d'Up ! Mail Service

• Usage en tant que client.
  La déclaration des serveurs Internet Message Access Protocol (IMAP) ou Post Office Protocol (POP) s'effectue respectivement au moyen des types ServeurMessagerieImap et ServeurMessageriePop.
  
• Usage en tant que serveur.
  Par défaut le serveur adopte le comportement de tous les serveurs Internet Message Access Protocol (IMAP), Post Office Protocol (POP) ou Simple Mail Transfer Protocol (SMTP) pour le transfert de courriers électroniques.
  Les habilitations de connexion sont contrôlées au regard des utilisateurs déclarés dans Up ! Security Manager, sachant que la connexion anonymous correspond à l'utilisateur Spoule.

  Il est possible d'intercepter toutes ou certaines requêtes :

  • Internet Message Access Protocol (IMAP).
  • Post Office Protocol (POP).
  • Simple Mail Transfer Protocol (SMTP).
    
  Les méthodes de rappel sont celles du type ClientMessagerie.
  
  L'objectif est alors par exemple de les interpréter ou de les auditer par programmation. En ce cas, le service par défaut peut être activé ou non selon la réponse de la méthode de rappel.
  

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}

• NomServeur représente le nom du serveur de communication.
  
• Port représente le numéro du port.
  Ce numéro est usuellement 143, 110 et 25 pour un serveur respectivement Imap, Pop et Smtp.
  

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 :

• Format binaire.
  Il a pour extension uml. Par exemple, l'annuaire électronique de nom mon-annuaire-electronique aura pour nom de fichier mon-annuaire-electronique.uml.
  L'avantage du format binaire est qu'il est plus rapide à charger et à enregistrer, sans nécessiter les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Mail Service. L'inconvénient est que :
  • Il n'est pas modifiable manuellement.
  • Il ne peut comporter du code en Up ! 5GL mixé.
• Format texte en Up ! 5GL.
  Il a pour extension upl. Par exemple, l'annuaire électronique de nom mon-annuaire-electronique aura pour nom de fichier mon-annuaire-electronique.upl.
  L'avantage du format texte en Up ! 5GL est que :
  • Il est modifiable manuellement.
  • Il peut comporter du code en Up ! 5GL mixé.
  L'inconvénient est qu'il est plus lent à charger et à enregistrer, nécessitant les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Mail Service.
  Pour connaître la syntaxe de ce format, merci de se référer à la fiche Syntaxe d'Up ! 5GL pour Up ! Mail Service.

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