Saltar al contenido

Actividad Leer Correo Electrónico

Introducción

Una actividad de correo electrónico Leer Correo Electrónico, utilizando su conexión de correo electrónico, recupera correos electrónicos no leídos utilizando el Protocolo de Acceso a Mensajes de Internet (IMAP) y está destinada a ser utilizada como una fuente para proporcionar datos a una operación.

Crear una actividad Leer Correo Electrónico

Una instancia de una actividad de correo electrónico Leer Correo Electrónico se crea a partir de una conexión de correo electrónico utilizando su tipo de actividad Leer Correo Electrónico.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de correo electrónico Leer Correo Electrónico existente se puede editar desde estas ubicaciones:

Configurar una actividad Leer Correo Electrónico

Siga estos pasos para configurar una actividad de correo electrónico Leer Correo Electrónico:

Paso 1: Ingrese un nombre y seleccione una carpeta

En este paso, proporcione un nombre para la actividad y seleccione una carpeta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Email read email activity configuration step 1

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Email Leer Email y no debe contener barras diagonales / ni dos puntos :.

  • Seleccionar una Carpeta: Esta sección muestra las carpetas disponibles en el punto final de Email.

    • Carpeta Seleccionada: Después de seleccionar una carpeta, se lista aquí.

    • Buscar: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de carpetas. La búsqueda no distingue entre mayúsculas y minúsculas. Si las carpetas ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar las carpetas desde el punto final al buscar, ingresa criterios de búsqueda y luego actualiza, como se describe a continuación.

    • Actualizar: Haz clic en el ícono de actualizar o en la palabra Actualizar para recargar las carpetas desde el punto final de Email. Esto puede ser útil si se han agregado carpetas a Email. Esta acción actualiza todos los metadatos utilizados para construir la tabla de carpetas mostrada en la configuración.

    • Seleccionar una Carpeta: Dentro de la tabla, haz clic en cualquier parte de una fila para seleccionar una carpeta. Solo se puede seleccionar una carpeta. La información disponible para cada carpeta se obtiene del punto final de Email:

      • Nombre: El nombre de la carpeta.

    Consejo

    Si la tabla no se llena con las carpetas disponibles, la conexión de Email puede no ser exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Guardar y Salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

Paso 2: Especificar filtros

En este paso, especifica los criterios de correo electrónico para filtrar. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad de lectura de correo electrónico paso 2

Nota

Si ingresas valores en una combinación de los campos De, Asunto, Para, CC, Fecha de inicio o Fecha de finalización, solo se recuperarán los correos electrónicos que coincidan con todos tus criterios de filtro. No se admiten caracteres comodín.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes de las que elegir.

  • De: Ingresa una única dirección de correo electrónico del remitente o un fragmento de una dirección de correo electrónico del remitente.

  • Asunto: Ingresa una única línea de asunto o un fragmento de una línea de asunto.

  • Para: Ingresa una única dirección de correo electrónico del destinatario o un fragmento de una dirección de correo electrónico del destinatario.

  • CC: Ingresa una única dirección de correo electrónico del destinatario en copia o una parte de una dirección de correo electrónico del destinatario en copia.

  • Fecha de inicio: Ingresa la fecha de inicio del correo electrónico, en el formato aaaa-mm-dd.

  • Fecha de finalización: Ingresa la fecha de finalización del correo electrónico, en el formato aaaa-mm-dd.

  • Número máximo de devoluciones: Ingresa el número máximo de correos electrónicos no leídos que se devolverán en la respuesta. Deja este campo en blanco para devolver todos los mensajes no leídos disponibles.

  • Incluir archivos adjuntos: Selecciona incluir archivos adjuntos de correo electrónico en la respuesta (seleccionado por defecto).

  • Habilitar S/MIME: (Funcional solo al usar agentes privados.) Cuando se selecciona, puedes recuperar correos electrónicos que están cifrados o firmados utilizando un certificado S/MIME. S/MIME (Extensiones de correo de Internet seguro/multipropósito) es un estándar para el cifrado de clave pública y la firma de correos electrónicos. Si bien la configuración de S/MIME debería ser similar para otros proveedores, Jitterbit ha validado S/MIME solo con Microsoft Outlook.

    Importante

    Necesitas tu propio certificado S/MIME para leer correos electrónicos cifrados. Para instrucciones sobre cómo obtener un certificado S/MIME autofirmado, sigue los pasos en Requisitos previos para el cifrado S/MIME.

    Si estás utilizando un proveedor de nube, como Microsoft 365 Outlook con una cuenta de Exchange Online, necesitas un certificado S/MIME de una autoridad de certificación (CA) confiable, como Let's Encrypt. Los certificados autofirmados no funcionarán con proveedores de nube.

    Aunque el proceso para configurar S/MIME debería ser similar para otros proveedores, Jitterbit ha validado S/MIME únicamente con Microsoft Outlook.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

Paso 3: Revisar los esquemas de datos

Se muestran los esquemas de solicitud o respuesta generados desde el punto final. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad de correo electrónico leído paso 3

  • Esquemas de Datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformaciones.

    El esquema de datos de respuesta consiste en estos nodos y campos:

    Nodo/Campo del Esquema de Respuesta Descripción
    readEmailResponse Nodo de la respuesta del correo electrónico
    item Nodo del ítem de los destinatarios del correo electrónico
    recipients Nodo de los destinatarios del correo electrónico
    to Nodo de los destinatarios del campo "to" del correo electrónico
    item Nodo del ítem de los destinatarios del campo "to" del correo electrónico
    #text Valor de cadena de una sola dirección de correo electrónico "to"
    cc Nodo de los destinatarios del campo "cc" del correo electrónico
    item Nodo del ítem de los destinatarios del campo "cc" del correo electrónico
    #text Valor de cadena de una sola dirección de correo electrónico "cc"
    dateTime Cadena de la fecha y hora en que se envió el correo electrónico
    from Cadena del campo "from" del correo electrónico
    subject Cadena del campo "subject" del correo electrónico
    mailBody Cadena del campo "body" del correo electrónico
    attachments Nodo de los archivos adjuntos del correo electrónico
    item Nodo del ítem de los archivos adjuntos del correo electrónico
    fileName Cadena del nombre del archivo adjunto del correo electrónico
    base64content Cadena del contenido del archivo adjunto codificado en base64

    Consejo

    Puedes usar la función Base64Decode de Jitterbit para decodificar el contenido de los archivos adjuntos.

    fileSize Cadena del tamaño del archivo binario para el archivo adjunto del correo electrónico
    fileBase64Length Cadena de la longitud de caracteres codificados en base64 para el archivo adjunto del correo electrónico
  • Actualizar: Haz clic en el ícono de actualizar o en la palabra Actualizar para regenerar esquemas desde el punto final de Email. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Regresar: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad de Email Leer Email, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de operación. También puedes configurar la configuración de la operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Email Leer Email pueden ser utilizadas como fuente con estos patrones de operación:

Para utilizar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego utiliza esa ubicación temporal en la función de scripting.

Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de la operación.