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
Exemple de méta-objet pour l'adaptateur pour e-mail

Copyright IBM Corp. 2003, 2005