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:
- El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).
- La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
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
Proporcione un nombre para la actividad y seleccione una carpeta. -
Paso 2: Especificar filtros
Especifique los criterios de correo electrónico para filtrar. -
Paso 3: Revisar los esquemas de datos
Se muestran los esquemas de solicitud o respuesta generados desde el punto final.
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.
-
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.
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.
-
Alias del certificado: Ingresa el alias que utilizaste para identificar el certificado cuando lo importaste al almacén de confianza predeterminado (ver Paso 8 de los Requisitos previos para el cifrado S/MIME).
-
Frase de paso de la clave privada: Ingresa la contraseña para desbloquear tu clave privada (ver Paso 7 de los Requisitos previos para el cifrado S/MIME).
-
-
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.
-
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:
- Patrón de transformación
- Patrón de archivo de dos objetivos (como la primera fuente únicamente)
- Patrón de archivo HTTP de dos objetivos (como la primera fuente únicamente)
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.