Avant de lancer l'adaptateur pour e-mail, vous devez le configurer. Procédez comme suit :
Une fois ces méta-objets configurés, vous devez ajouter leur prise en charge à la définition de l'adaptateur. Pour configurer une définition d'adaptateur, vous utiliserez Connector Configurator (que vous lancerez depuis System Manager si votre courtier d'intégration est ICS), ou Connector Configurator (si votre courtier d'intégration est WebSphere MQ Integrator Broker).
L'adaptateur obtient ses valeurs de configuration lors du démarrage. En cours d'exécution, vous pourrez avoir besoin de changer la valeur d'une ou de plusieurs propriétés. Selon la propriété et le système d'intégration, ces changements peuvent prendre effet immédiatement, nécessiter un redémarrage de l'adaptateur ou bien un redémarrage complet du système d'intégration. Pour savoir dans quelles conditions les modifications prennent effet, consultez la colonne Update Method de l'onglet Properties approprié, dans l'outil de configuration de l'adaptateur.
Les propriétés standard de configuration fournissent des informations utilisées par tous les connecteurs. Voir l'Annexe A. Propriétés standard de configuration pour les adaptateurs pour plus d'informations sur ces propriétés.
Le tableau 4 donne des informations spécifiques à cet adaptateur et concernant les propriétés de configuration de l'annexe.
Propriété | Important |
---|---|
CharacterEncoding |
Cet adaptateur n'utilise pas cette propriété. |
ApplicationName |
Avant de lancer l'adaptateur, vous devez indiquer une valeur pour cette propriété de configuration. |
Locale |
Cet adaptateur étant internationalisé, vous pouvez modifier la valeur de cette propriété. Voir les notes d'informations concernant l'adaptateur pour connaître les paramètres régionaux pris en charge. |
Les propriétés de configuration spécifiques à l'adaptateur donnent des informations spécifiques à l'application ou à la technologie intégrée par l'adaptateur. Vous pouvez utiliser ces propriétés pour modifier le comportement de l'adaptateur sans avoir à recoder et reconstituer le composant spécifique à l'application.
Le tableau 5 présente les propriétés de configuration spécifiques à l'adaptateur pour e-mail. Pour obtenir une explication des propriétés, voir les sections suivantes.
Nom | Valeurs possibles | Valeur par défaut | Obligatoire |
---|---|---|---|
ApplicationPassword | le mot de passe correspondant à ApplicationUserName | Oui, si
Application UserName est défini |
|
ApplicationUserName | le nom d'utilisateur requis par le serveur SMTP | Non | |
BusinessObjectMimeCharset | une valeur valide pour un jeu de caractères | Non | |
BusinessObjectMimeEncoding | une valeur valide pour un codage de données | Non | |
DataHandlerConfigMO | le nom du méta-objet du gestionnaire de données | MO_DataHandler_Default | Oui |
DebugMode | true ou false |
false |
Non |
DefaultVerb | une instruction valide pour les objets métier gérés par l'adaptateur | Create | Non |
InboundWrapperBO | le nom de l'objet métier encapsuleur pour les communications entrantes | Non | |
MailsPerMailBox | Un entier positif |
1 |
Non |
MessageContentMimeCharset | une valeur valide pour un jeu de caractères | Non | |
MessageContentMimeEncoding | une valeur valide pour un codage de données | Non | |
MessageHeaderMimeCharset | une valeur valide pour un jeu de caractères | Non | |
MessageHeaderMimeEncoding | une valeur valide pour un codage de données | Non | |
PollConfigMO | le nom du méta-objet | Non | |
PollQuantity | Un entier positif |
1 |
Non |
SMTP_MailPort | Le numéro de port pour l'hôte SMTP | Non | |
UseDefaults | définit la valeur par défaut pour un attribut obligatoire | False | Non |
le mot de passe qui est associé à la valeur indiquée pour ApplicationUserName.
Le nom d'utilisateur requis pour l'authentification par le serveur SMTP.
Le jeu de caractères des objets métier contenus dans l'e-mail. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Il peut s'agir par exemple de iso-8859-1, le jeu de caractères Latin 1 pour les langues d'Europe de l'Ouest.
Le codage des objets métier contenus dans l'e-mail. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Par exemple, vous indiqueriez Q pour signifier "Quoted-Printable" ou B pour "Base64". Si cette propriété est définie, les objets métier sont envoyés comme parties du message. Si elle n'est pas définie, ils sont envoyés comme fichiers joints.
Le nom du méta-objet utilisé par le gestionnaire de données pour définir les propriétés de configuration. Sert également à la classe de base DataHandler pour déterminer quelle classe DataHandler utiliser pour un type particulier de contenu. Voir Meta-objets du gestionnaire de données pour plus d'informations sur ce méta-objet.
Indique si les messages de débogage JavaMail sont envoyées sur STDOUT.
Indique la valeur insérée dans l'attribut Verb pour les objets métier de premier niveau créés par l'adaptateur pendant la notification d'événement, si cet attribut est vide. Dans certains cas, l'adaptateur peut interroger un événement et créer un objet métier, mais la source de données (comme un document XML) peut ne pas contenir d'informations qui corresponde directement à l'attribut Verb de la définition d'objet métier. Si l'objet métier est envoyé au courtier d'intégration sans une instruction (Verb) valide, il est considéré comme sans abonnement, et n'est pas traité. Vous pouvez indiquez ici une instruction valide (comme Create), afin de remplir cette propriété au cas où l'attribut Verb serait vide ou de valeur null.
La valeur par défaut est Create.
Indique au connecteur d'assembler tous les objets métier créés à partir des pièces jointes, et de les envoyer ensemble au courtier d'intégration. La structure de l'objet métier possède également des attributs comme FromAddress et ToAddress, qui sont renseignés par le connecteur.
Indique le nombre de messages traités dans chaque boîte aux lettres avant que l'adaptateur passe au traitement de la boîte aux lettres suivante.
Le jeu de caractères du contenu du message. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Il peut s'agir par exemple de iso-8859-1, le jeu de caractères Latin 1 pour les langues d'Europe de l'Ouest.
Le codage du contenu du message. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Par exemple, vous indiqueriez Q pour signifier "Quoted-Printable" et B pour "Base64".
Le jeu de caractère de l'en-tête du message. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Il peut s'agir par exemple de iso-8859-1, le jeu de caractères Latin 1 pour les langues d'Europe de l'Ouest.
Le codage de l'en-tête du message. Voir les RFC d'e-mail pour déterminer la valeur convenant à l'environnement. Par exemple, vous indiqueriez Q pour signifier "Quoted-Printable" ou B pour "Base64".
Le nom du méta-objet utilisé par l'adaptateur pour e-mail pour ses interrogations. Pour plus d'informations sur le méta-objet adaptateur pour e-mail, voir Utilisation des méta-objets de l'adaptateur pour e-mail.
Indique le nombre maximal d'événements interrogés pendant un seul appel d'interrogation.
Le numéro de port utilisé par l'hôte de courrier SMTP pour envoyer le courrier électronique.
Lorsque cette propriété est définie sur true, les attributs obligatoires recevront une valeur par défaut. Lorsque cette propriété est définie sur false, les valeurs par défaut ne seront pas utilisées. La valeur par défaut est False.