Nodo EmailInput

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:

Finalidad

El nodo EmailInput recibe 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). El cuerpo del mensaje de correo electrónico, y cualquier archivo adjunto, se propagan en el dominio MIME (Multipurpose Internet Mail Extensions). El resto de la información relacionada con el correo electrónico se almacena en el árbol lógico MIME Root.EmailInputHeader. Los campos de esta estructura se describen en la siguiente tabla:
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.
Esta estructura se propaga con cada mensaje grabado en el terminal Out (de salida) del nodo EmailInput. Para obtener más información sobre el árbol lógico MIME, consulte el apartado Analizador y dominio MIME.

Utilización del nodo EmailInput en un flujo de mensajes

Para habilitar la función que queda disponible en los WebSphere Message Broker 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 WebSphere Message Broker 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 diagrama muestra cómo puede utilizar un nodo EmailInput para recibir un mensaje de correo electrónico, con o sin adjuntos, desde un servidor de correo electrónico, y cómo puede procesar el correo electrónico.

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

Esta imagen muestra el icono del nodo EmailInput.

Consulte el siguiente ejemplo para ver cómo utilizar el nodo EmailInput:

Puede ver información sobre los ejemplos sólo cuando utilice el centro de información que está integrado en WebSphere Message Broker 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 WebSphere Message Broker 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.

Configuración del nodo EmailInput

Cuando haya colocado una instancia del nodo EmailInput en un flujo de mensajes, podrá configurarlo. Para obtener más información, consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades.

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 WebSphere Message Broker Toolkit para recuperar un correo electrónico, con o sin adjuntos, consulte Recibir un correo electrónico.

Terminales y propiedades

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:

  • protocolo puede ser pop3 o imap.
  • nombre_host es la dirección TCP/IP de Protocolo Internet versión 4 (IPv4) o el nombre de host que DNS puede resolver del host de correo electrónico.
  • puerto es el número de puerto en el que el servidor de correo electrónico está a la escucha de conexiones a través del protocolo POP3 o el protocolo IMAP. Puede especificar un entero en el intervalo 1-65535.

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
Las propiedades de Sondeo del nodo EmailInput se describen en la siguiente tabla.
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
Las propiedades de Seguridad del nodo EmailInput se describen en la siguiente tabla.
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
Las propiedades de Reintento del nodo EmailInput se describen en la siguiente tabla. Para obtener más información acerca de las propiedades de reintento del nodo EmailInput, consulte el apartado Recibir un correo electrónico.
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
Las propiedades de Transacciones del nodo EmailInput se describen en la siguiente tabla.
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.  
Las propiedades de Instancias del nodo EmailInput se describen en la siguiente tabla.
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
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
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.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-09-23 03:02:56


Tema de referenciaTema de referencia | Version 8.0.0.3 | bc16200_