Actividad Obtener correo electrónico

La actividad Obtener correo electrónico es una actividad de iniciador. Cuando en el Dispositivo de integración se despliega una orquestación que comienza con la actividad Obtener correo electrónico, el Dispositivo de integración sondea el servidor POP3 en busca de los mensajes de correo electrónico para la cuenta especificada en un determinado intervalo de tiempo.

El servidor POP3 sondeado y la cuenta de correo electrónico se definen en el punto final de correo electrónico asociado con la actividad Obtener correo electrónico.

Durante el tiempo de ejecución, la actividad Obtener correo electrónico sondea un servidor POP3 en busca de los mensajes de correo electrónico entrantes de una determinada cuenta de correo electrónico, como se muestra en el siguiente diagrama.

Figura 1.

Si no se encuentra ningún mensaje de correo electrónico, se producirá la siguiente acción para cada uno de ellos: la expresión regular definida para el campo Asunto se comprobará con el asunto del mensaje de correo electrónico entrante y la expresión regular definida para el campo De se comprobará con la cuenta de correo electrónico del remitente del mensaje de correo electrónico entrante. Si las dos expresiones regulares coinciden, se creará un trabajo de orquestación para procesar el correo electrónico y este se marcará para suprimir en el servidor POP3. Para obtener información sobre la coincidencia de las expresiones regulares, consulte Para configurar el procedimiento de la actividad.
Nota: Dos actividades Obtener correo electrónico no deberían sondear el mismo servidor POP3 al mismo tiempo utilizando la misma cuenta de correo electrónico, aunque sean distintas las expresiones regulares especificadas en la tarea Configurar de la actividad. Si dos actividades Obtener correo electrónico intentan obtener el correo electrónico utilizando la misma cuenta de correo electrónico, cuando la primera actividad Obtener correo electrónico procese el correo electrónico del servidor POP3 y lo elimine, la segunda actividad Obtener correo electrónico seguirá intentando obtener el correo electrónico del servidor POP3 y es posible que se emita la siguiente excepción:
Protocol exception: com.jscape.inet.pop.PopException: Error in TOP 671 0: -ERR The requested message is no longer available; it may have been deleted.

Acceder al archivo adjunto de un mensaje de correo electrónico

Para acceder al archivo adjunto de un mensaje de correo electrónico entrante, deberá añadir la actividad Leer MIME a la orquestación después de la actividad Obtener correo electrónico, como se muestra en la ilustración anterior. Además, deberá correlacionar los dos parámetros de salida de la actividad Obtener correo electrónico con las variables de la orquestación y, a continuación, correlacionar esas variables con los parámetros de entrada de la actividad Leer MIME. Durante el tiempo de ejecución, la actividad Leer MIME lee la cabecera MIME y el cuerpo del mensaje, separa los archivos adjuntos incluidos en el cuerpo del mensaje y coloca el resultado en el parámetro de salida XML de los componentes. Para obtener más información, consulte la actividad Leer MIME.

Añadir una actividad Obtener correo electrónico a la orquestación

  1. Cree o abra una orquestación. Se visualiza una representación gráfica de la orquestación.
  2. Seleccione el separador Actividades y expanda la carpeta Correo electrónico.
  3. Arrastre la actividad Obtener correo electrónico a la orquestación.
  4. Seleccione la actividad. Se mostrará la Lista de comprobación.

Crear, seleccionar o editar un punto final de correo electrónico

  1. Pulse la tarea Elegir punto final en Lista de comprobación y seleccione una de las siguientes acciones:
    • Seleccione un punto final existente:
      1. Seleccione Examinar.Se mostrará el Explorador de proyectos.
      2. Seleccione un punto final existente y pulse Aceptar. Complete los pasos de Configuración de la actividad.
    • Seleccione un punto final existente y edítelo:
      1. Seleccione Examinar.Se mostrará el Explorador de proyectos.
      2. Seleccione un punto final existente y pulse Aceptar.
      3. Pulse Editar. Se mostrará el panel Editar punto final.
    • Cree un punto final. Seleccione Nuevo. Se mostrará el panel Crear punto final.
  2. Cree o edite un punto final de correo electrónico. Para obtener más información, consulte Creación o edición de un punto final de correo electrónico.

Configuración de la actividad

  1. Seleccione la tarea Configurar en Lista de comprobación. Se mostrará el panel Configurar.
  2. Configure todos los campos del panel como se describe en la siguiente tabla. En esta tarea, especifique las expresiones regulares utilizadas para comparar los campos Asunto y De de los mensajes de correo electrónico sondeados. Es necesario especificar una expresión regular para ambos campos, incluso aunque la expresión regular equivalga a *, que significa que todas las series coinciden. Para procesar un correo entrante, las series de los campos Asunto y De del correo deben coincidir con sus expresiones regulares respectivas. Cada uno de los campos de expresión regular admite los siguientes comodines:
    • * (asterisco) - para cero caracteres o más
    • ? (interrogación) - para cero caracteres o uno
    Tabla 1.
    Campo Descripción
    Coincidencias de Asunto Especifique una expresión regular que coincida con los asuntos de los mensajes de correo electrónico que inician un trabajo de orquestación para procesar el mensaje de correo electrónico. En la expresión regular, deberá especificar una combinación de caracteres y comodines.
    Coincidencias de De   Especifique una expresión regular que defina la dirección de correo electrónico del remitente de los mensajes de correo electrónico que inician un trabajo de orquestación para procesar el mensaje de correo electrónico. En la expresión regular, deberá especificar una combinación de caracteres y comodines.
    La siguiente tabla incluye algunas expresiones regulares de ejemplo y el resultado de cotejar las expresiones regulares con el texto de muestra.
    Tabla 2.
    Expresión regular Texto de muestra Resultado
    *hello* hello coincide
    *hello* hhhellooo coincide
    hello hello coincide
    hello hhhellooo no coincide; tiene que coincidir exactamente con la serie de la expresión regular: hello
    hello ello no coincide; tiene que coincidir exactamente con la serie de la expresión regular: hello
    ?ello hello coincide
    ?ello jello coincide
    ?ello ello coincide

Especificar las reglas de entrega

  1. Seleccione la tarea Reglas de entrega en Lista de comprobación. Se mostrará el panel Reglas de entrega.
  2. Especifique el intervalo de tiempo para sondear el servidor POP3 en busca de mensajes de correo electrónico nuevos:
    1. Seleccione una unidad de tiempo en el menú: segundos, minutos, horas o días.
    2. Especifique el intervalo de tiempo mediante una de las siguientes opciones de entrada:
      • Pulsando en el campo Sondear cambios cada y escribiendo un nuevo valor.
      • Mediante las flechas arriba y abajo
Para obtener más información, consulte Comportamiento del intervalo de sondeo.

Especificación de opciones de reintento

  1. Seleccione la tarea Reintentar en Lista de comprobación. Se mostrará el panel Reintentar.
  2. Configure las opciones de reintento para conectarse a un servidor POP3. En la siguiente tabla se definen las opciones de reintento de una conexión a un servidor POP3:
    Tabla 3.
    Campo Descripción
    Reintentar  
    1) Esperar __ segundo(s) entre cada reintento. Especifica el número de segundos que el Dispositivo de integración espera antes de intentar establecer una conexión con el servidor POP3.
    2) Intentar conectar __ veces antes de generar un error. Especifica el total de reintentos: el número máximo de veces que el Dispositivo de integración intenta establecer una conexión con el servidor POP3 antes de emitir un error.

    Si se despliega una orquestación que comienza con una actividad Obtener correo electrónico y el Dispositivo de integración no puede conectarse con el servidor POP3 especificado, el Dispositivo registra los errores de conexión como avisos en el registro del sistema hasta que se alcanza el total de reintentos. Cuando se alcanza el total de reintentos, el Dispositivo de integración registra un error en el registro del sistema, restablece el recuento de errores de conexión a cero y continúa intentando establecer una conexión con el servidor POP3.

    Por ejemplo, supongamos que establece el total de reintentos en 3. El primero, el segundo y el tercer error de conexión aparecen en el registro del sistema como avisos. El Dispositivo de integración registra el cuarto error de conexión como un error y restablece el recuento de errores de conexión a cero. Por lo tanto, el quinto error de conexión generará un aviso en el registro del sistema. El Dispositivo de integración continuará intentando establecer una conexión con el servidor POP3.

Correlacionar la salida de la actividad

  1. Seleccione la tarea Correlacionar salidas en Lista de comprobación. Los parámetros de salida de la actividad se mostrarán en el panel Desde actividad.
  2. En esta tarea, correlacione los parámetros de salida mailheader (de tipo XML) y body (de tipo serie) con variables. Para que la orquestación sea válida, es necesario correlacionar los parámetros de salida de la actividad. Consulte Creación de una correlación para obtener instrucciones generales sobre las correlaciones. El parámetro de salida mailheader contiene metainformación sobre el mensaje de correo electrónico; por ejemplo, las direcciones de correo electrónico a las que se envía el mensaje y la cabecera MIME del propio mensaje. El parámetro de salida body contiene el cuerpo del mensaje de correo electrónico y los archivos adjuntos asociados.
    PRECAUCIÓN:
    El orden de los archivos adjuntos y del cuerpo dependen del cliente de correo electrónico que envía el mensaje y del tipo de mensaje (texto sin formato o HTML).