Saltar al contenido

Actividad Leer Correo Electrónico en Jitterbit Studio

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, proporciona un nombre para la actividad y selecciona una carpeta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

  • Menú de puntos finales: Si tienes múltiples puntos finales del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del punto final actual. Haz clic en el menú para cambiar a un punto final diferente. Para más información, consulta Cambiar el punto final asignado en Pantallas de configuración.

    • Editar punto final: Aparece cuando pasas el cursor sobre el nombre del punto final actual. Haz clic para editar la configuración de conexión del punto final seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Email Leer correo electrónico y no debe contener barras diagonales / o 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 dentro de la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar las carpetas del 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 del punto final de Email. Esto puede ser útil si se han agregado carpetas al Email. Esta acción actualiza todos los metadatos utilizados para construir la tabla de carpetas mostrada en la configuración.

    • Seleccionando 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, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

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

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Especificar filtros

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

Nota

Si ingresa 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 sus 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. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.

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

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

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

  • CC: Ingrese 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: Ingrese la fecha de inicio del correo electrónico, en el formato aaaa-mm-dd.

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

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

  • Incluir archivos adjuntos: Selecciona para 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 usando un certificado S/MIME. S/MIME (Extensiones de Correo de Internet Seguro/Múltiples Propósitos) es un estándar para el cifrado de clave pública y la firma de correos electrónicos. Aunque 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 usando un proveedor en la 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 en la nube.

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

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

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

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

Paso 3: Revisar los esquemas de datos

Cualquier esquema de solicitud o respuesta generado desde el punto final se muestra. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

  • Esquemas de Datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante 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

    Puede 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 los ajustes de la operación, que incluyen 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.