Utilice el nodo EmailInput para recuperar un correo electrónico, con o sin archivos adjuntos, desde un servidor de correo electrónico que admita el protocolo POP3 (Post Office Protocol 3) o el protocolo IMAP (Internet Message Access Protocol).
Este tema contiene las secciones siguientes:
| Ubicación del elemento | Tipo de datos de elemento | Descripción |
|---|---|---|
| Root.EmailInputHeader.To | CHARACTER | Una lista de direcciones de correo electrónico separadas por comas. |
| Root.EmailInputHeader.Cc | CHARACTER | Una lista de direcciones de correo electrónico separadas por comas. |
| Root.EmailInputHeader.From | CHARACTER | Una lista de direcciones de correo electrónico separadas por comas. |
| Root.EmailInputHeader.ReplyTo | CHARACTER | Una lista de direcciones de correo electrónico separadas por comas. |
| Root.EmailInputHeader.Subject | CHARACTER | El resumen del contenido del correo electrónico o el asunto del correo electrónico. |
| Root.EmailInputHeader.Size | INTEGER | El tamaño del correo electrónico, incluidos los archivos adjuntos. |
| Root.EmailInputHeader.SentDate | CHARACTER | La fecha de entrega de envío del correo electrónico. |
Para habilitar la función que queda disponible en los IBM® Integration Bus fixpacks, utilice el parámetro -f en el mandato mqsichangebroker. Para obtener más información, consulte Mandato mqsichangebroker.
Puede configurar el nodo EmailInput utilizando las propiedades del nodo en el IBM Integration Toolkit. Un posible uso del nodo EmailInput es sondear un servidor de correo electrónico a intervalos regulares para ver si hay mensajes de correo electrónico, y recuperar un mensaje de correo electrónico cuando un correo electrónico está disponible. El flujo de mensajes recibe el correo electrónico del servidor de correo electrónico como un mensaje MIME.
En el siguiente flujo de mensajes de ejemplo, el nodo EmailInput pasa entonces el mensaje de correo electrónico, que se asocia con el analizador MIME, a un nodo Filter. El nodo Filter procesa el correo electrónico y lo dirige a un nodo MQHeader o a un nodo FileOutput en función de si el correo electrónico tiene un adjunto o no.
Si el mensaje de correo electrónico no contiene un archivo adjunto, el nodo Filter envía el correo electrónico a un nodo MQHeader para personalizar el Descriptor de mensaje MQ (MQMD). El nodo MQHeader añade una cabecera WebSphere MQ al árbol de mensajes y pasa el mensaje al nodo MQOutput. El nodo MQOutput serializa el cuerpo del mensaje, por ejemplo, el contenido de texto del correo electrónico, y coloca el cuerpo del correo electrónico en una cola de WebSphere MQ para su proceso adicional.
Si el mensaje de correo electrónico no contiene un archivo adjunto, el nodo Filter envía el correo electrónico a un nodo FileOutput. El nodo FileOutput guarda entonces el adjunto como un archivo denominado email_attachment.dat en una unidad de disco duro que especifique y, en este ejemplo, el contenido de texto del correo electrónico se descarta. Puede realizar este ejemplo creando el flujo de mensajes siguiente:

El nodo EmailInput se encuentra en la bandeja Correo electrónico de la paleta de nodos de flujos de mensajes, y se representa en IBM Integration Toolkit con el icono siguiente:

Puede ver información sobre los ejemplos sólo cuando utilice el centro de información que está integrado en IBM Integration Toolkit o el centro de información en línea. Puede ejecutar ejemplos sólo cuando utilice el centro de información que está integrado en IBM Integration Toolkit.
Utilización de servicios configurables para el nodo EmailInput
Puede configurar el nodo EmailInput para obtener la información de identidad de seguridad y el URL del servidor de correo electrónico de un servicio configurable. Para obtener más información sobre la creación, modificación, notificación y supresión de los servicios configurables, consulte Cambiar la información de conexión para el nodo EmailInput.
Utilización de una identidad de seguridad para autenticarse con un servidor de correo electrónico
Puede utilizar el mandato mqsisetdbparms para establecer un objeto de identidad de seguridad de ID de usuario y contraseña para que el nodo EmailInput o el servicio configurable EmailServer lo utilice para acceder al servidor de correo electrónico. Para obtener información detallada sobre cómo configurar el soporte de identidad de seguridad del servidor de correo electrónico, consulte Mandato mqsisetdbparms.
Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Para configurar el nodo EmailInput utilizando las propiedades de nodo IBM Integration Toolkit para recuperar un correo electrónico, con o sin adjuntos, consulte Recibir un correo electrónico.
Los terminales del nodo EmailInput se describen en la tabla siguiente.
| Terminal | Descripción |
|---|---|
| Anomalías | El terminal de salida al que se direcciona el mensaje si se detecta una anomalía en el nodo EmailInput cuando se propaga un mensaje, o un nodo EmailInput no puede acceder al servidor de correo electrónico. Conecte el terminal de anomalías de este nodo a otro nodo del flujo de mensajes para procesar errores. |
| De salida | El terminal de salida al que se direcciona el mensaje si se ha propagado satisfactoriamente. Conecte el terminal de salida de este nodo a otro nodo del flujo de mensajes para procesar adicionalmente el mensaje o enviar el mensaje a un destino adicional. |
| Catch (de captación) | El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. Las excepciones se detectan sólo si este terminal está conectado. |
En las siguientes tablas se describen las propiedades del nodo EmailInput.
La columna de la tabla con la cabecera M indica si la propiedad es obligatoria. Por ejemplo, una propiedad aparece marcada con un asterisco, lo que indica que es necesario especificar un valor si no existe ningún valor predeterminado definido.
La columna con la cabecera C indica si la propiedad es configurable. Por ejemplo, puede cambiar el valor al añadir el flujo de mensajes al archivo BAR para desplegarlo.
Las propiedades de Descripción del nodo EmailInput se describen en la siguiente tabla.
| Propiedad | M | C | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Nombre de nodo | No | No | Email Input | El nombre del nodo. |
| Descripción corta | No | No | Ninguna | Una descripción breve del nodo. |
| Descripción larga | No | No | Ninguna | Texto que describe el propósito del nodo en el flujo de mensajes. |
Las propiedades Básicas del nodo EmailInput se describen en la siguiente tabla.
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Servidor de correo electrónico | Sí | Sí | Ninguna | La propiedad Servidor de correo electrónico se
define como un nombre de servicio configurable, por ejemplo:
myEmailConfigurableServiceName o como un URL. Un URL
le permite especificar un protocolo, un nombre de host y un número de puerto,
que es la información mínima que se necesita para acceder al servidor de
correo electrónico. El URL debe estar formado por la siguiente estructura: protocolo://nombre_host:puerto donde:
Por ejemplo: pop3://myemailserver.com:12345 o imap://myemailserver.com:56789. No hay ningún valor predeterminado para esta propiedad, pero esta propiedad es obligatoria y, por lo tanto, debe configurarse con un nombre de servicio configurable o un URL. Puede obtener los valores de nombre_host y puerto del servidor de correo electrónico o el administrador del servidor de correo electrónico. |
emailServer |
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Intervalo de sondeo (en segundos) | Sí | Sí | 5 | El intervalo en el que el nodo EmailInput sondea el servidor de correo electrónico para ver si hay nuevos correos electrónicos. | waitInterval |
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Identidad de seguridad | No | Sí | Ninguna | El nombre del objeto de identidad de seguridad que
se crea y configura mediante el mandato mqsisetdbparms, que
contiene el ID de usuario y la contraseña que utilizará el intermediario
para autenticarse con el servidor de correo electrónico. Utilice el
mandato mqsisetdbparms
para establecer el ID de usuario y contraseña de la identidad de
seguridad a la que debe acceder el intermediario. El valor predeterminado para esta propiedad es Ninguno, que significa que el ID de usuario y la contraseña no se pasan al servidor de correo electrónico. Para obtener más información sobre el soporte de identidad de seguridad del servidor de correo electrónico, consulte Mandato mqsisetdbparms. |
securityIdentity |
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Mecanismo de reintento | Sí | No | Reintento corto y largo | Cómo maneja el nodo EmailInput una anomalía de flujo de mensajes. Los valores válidos son Anomalía, Reintento corto o Reintento corto y largo. | |
| Umbral de reintentos | Sí | Sí | 0 | El número de veces que se debe reintentar la transacción de flujo de mensajes cuando el valor de la propiedad Mecanismo de reintento está establecido en Reintento corto. | retryThreshold |
| Intervalo de reintento corto (en segundos) | No | Sí | 0 | El intervalo, en segundos, entre cada reintento si el valor de la propiedad Umbral de reintentos no está establecido en cero. | shortRetryInterval |
| Intervalo de reintento largo (en segundos) | No | Sí | 300 | El intervalo, en segundos, entre cada reintento, si el valor de la propiedad Mecanismo de reintento es Reintento corto y largo y se ha agotado el umbral de reintentos. | longRetryInterval |
| Acción en correo electrónico anómalo | Sí | No | Suprimir correo electrónico | La acción que el nodo EmailInput realiza con el origen de datos de entrada después de que todos los intentos de procesar el contenido fracasen. | emailFailureAction |
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Modalidad de transacción | No | Sí | No | La modalidad de transacción en el nodo EmailInput determina si el resto de los nodos del flujo de mensajes se ejecutan bajo punto de sincronismo. Los valores válidos son Sí o No. |
| Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
|---|---|---|---|---|---|
| Agrupación de instancias adicionales | No | Sí | Utilizar agrupación asociada al flujo de mensajes | La agrupación de la que se obtienen instancias adicionales. Si selecciona el valor de propiedad Utilizar agrupación asociada al flujo de mensajes, las instancias adicionales se obtienen del flujo de mensajes. Si selecciona el valor de propiedad Utilizar agrupación asociada al nodo, se asignan instancias adicionales desde las instancias adicionales del nodo, basándose en el número especificado en la propiedad Instancias adicionales. |
componentLevel |
| Instancias adicionales | No | Sí | 0 | El número de instancias adicionales que el nodo EmailInput puede iniciar si la propiedad Agrupación de instancias adicionales se establece en el valor Utilizar agrupación asociada al nodo. | additionalInstances |
| Propiedad | M | C | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Sucesos | No | No | Ninguna | Los sucesos que se han definido para el nodo se visualizan en esta pestaña. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |