Utilisation des méta-objets de l'adaptateur pour e-mail
Les méta-objets sont des objets métier conçus pour contenir les informations
de configuration des adaptateurs. Un méta-objet est nécessaire pour configurer l'adaptateur
pour e-mail pour la notification d'événement.
L'adaptateur pour e-mail extrait le nom du méta-objet de premier niveau depuis
la propriété PollConfigMO de l'adaptateur. Vous devez créer la définition de ce méta-objet
en respectant la structure décrite dans Structure du méta-objet de l'adaptateur pour e-mail. Indiquez
ensuite son nom dans la propriété PollConfigMO.
Pour plus d'informations sur la création d'une définition d'objet métier, voir
Business Object Development Guide.
Important :
Pour que l'adaptateur de messagerie puisse utiliser les informations de configuration
du méta-objet, vous devez créer la définition du méta-objet et l'ajouter à la liste des objets
métier pris en charge par l'adaptateur.
Structure du méta-objet de l'adaptateur pour e-mail
Le méta-objet de l'adaptateur pour e-mail est un objet métier hiérarchique dont
l'objet de premier niveau peut contenir n'importe quel nombre d'objets enfants. Chaque
objet enfant représente un emplacement d'interrogation. Pour configurer l'adaptateur
de façon à contrôler un ou plusieurs emplacements d'interrogation, vous devez
paramétrer le méta-objet avec un nombre correspondant de méta-objets enfants.
La figure 5 illustre la définition d'un méta-objet.
Attributs de méta-objet de premier niveau
Tous les attributs du méta-objet de premier niveau sont des attributs
de conteneur dont la cardinalité est égale à 1. Par exemple, si l'adaptateur a deux
emplacements d'interrogation, Location1 et Location2, les types d'attributs peuvent être
MO_PollLocation1 et MO_PollLocation2.
Attributs de méta-objets enfants
Un méta-objet enfant est un objet plat doté des attributs indiqués dans
le tableau 15.
Tableau 15. Attributs de méta-objets enfants
Nom |
Description |
PollHostName |
Nom de la machine hôte qui héberge le serveur de messagerie.
La boîte aux lettres est située sur ce serveur. JavaMail doit connaître ce nom pour se connecter au magasin de messages. |
UserName |
Nom de l'utilisateur. L'adaptateur interroge la boîte aux lettres de cet
utilisateur. JavaMail doit connaître ce nom pour authentifier l'utilisateur. |
Password |
Le mot de passe de l'utilisateur. JavaMail doit connaître
cette valeur pour authentifier l'utilisateur. |
PollFolder |
Nom du dossier dans la boîte aux lettres. L'adaptateur interroge ce dossier.
Ce dossier doit exister dans la boîte aux lettres de l'utilisateur.
La valeur par défaut est PollFolder.
BiDi pris en charge par Windows. Toutes les propriétés conformes BiDi seront converties
depuis le format Windows BiDi dans le format BiDi.Metadata, qui est une propriété standard de connecteur E-mail. |
ArchiveFolder |
Nom du dossier dans la boîte aux lettres. L'adaptateur archive les
messages qui ont abouti (événements réussis) dans ce dossier. Ce dossier doit exister
dans la boîte aux lettres de l'utilisateur.
Si aucune valeur n'est indiquée pour cet attribut, l'adaptateur supprime les messages qui
ont abouti après les avoir traités.
BiDi pris en charge par Windows. Toutes les propriétés conformes BiDi seront
converties depuis le format Windows BiDi dans le format BiDi.Metadata, qui est une
propriété standard de connecteur E-mail. |
FailFolder |
Nom du dossier dans la boîte aux lettres. L'adaptateur archive dans ce dossier les messages
qui n'ont pas abouti (événements d'échec). Si aucune valeur n'est indiquée pour cet attribut,
l'adaptateur supprime les messages qui ont échoué.
BiDi pris en charge par Windows. Toutes les propriétés conformes BiDi seront
converties depuis le format Windows BiDi dans le format BiDi.Metadata, qui est une
propriété standard de connecteur E-mail. |
ExternalProperty |
Chemin absolu du nom du fichier de propriété utilisé lorsque
l'adaptateur se connecte au serveur de messagerie pour l'interrogation. Exemple : mail.imap.partialfetch=false |
InDoubtEvents |
Les valeurs valides pour cet attribut sont Reprocess,
FailOnStartUp, LogError et Ignore. En cas d'événements
en attente de validation dans cet emplacement d'interrogation, l'adaptateur les traite
au cours de l'initialisation en fonction de la valeur par défaut définie pour cet
attribut. Si la valeur est définie sur Reprocess, l'adaptateur réinitialise
l'indicateur SEEN des événements en attente de validation dans le dossier d'interrogation,
et prélève ces messages dans les appels d'interrogation suivants. Si la
valeur est définie sur FailOnStartUp et s'il y a des transactions en attente
de validation dans ce dossier d'interrogation, l'adaptateur échoue. Si la valeur
est définie sur LogError et s'il y a des transactions en attente de validation
dans ce dossier d'interrogation, l'adaptateur consigne l'erreur et continue. Si
la valeur est définie sur Ignore et s'il y a des transactions en attente
de validation dans ce dossier d'interrogation, l'adaptateur les ignore. La valeur par défaut est Reprocess. |
Reconnect |
Les valeurs possibles pour cet attribut sont True ou False.
Cette valeur est utilisée pour déterminer si une tentative de reconnexion
doit être effectuée pour chaque cycle d'interrogation, en cas de perte de connexion. |
Exemple de méta-objet
La figure 5 présente un exemple de méta-objet de premier niveau
nommé MO_Email_Default. L'adaptateur pour e-mail utilise ce méta-objet
pour interroger deux emplacements, indiqués dans les deux méta-objets enfants
MO_PollLocation1 et MO_PollLocation2.
Dans l'exemple, la valeur de l'attribut EventRecovery de MO_PollLocation1 est Resubmit,
et la valeur de cet attribut dans MO_PollLocation2 est Ignore. La valeur
de l'attribut EventRecovery indique à l'administrateur de l'adaptateur de soumettre de nouveau
les événements en attente de validation et de les ignorer pour Location2.
Figure 5. Exemple de méta-objet pour l'adaptateur pour e-mail
