Obtener correo

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

Descripción

Usa las API Obtener mensaje y Enumerar mensajes de Microsoft Graph para recuperar los mensajes coincidentes de unbuzónde correo especificado.

Después de realizar la búsqueda, la actividad devuelve una matriz de los objetos Office365Message coincidentes (Resultados) que puedes usar como variables de entrada en actividades posteriores (por ejemplo, Reenviar correo y Mover correo).

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Mail.Read AND User.Read

O

• Mail.ReadWrite AND User.Read

O

• Mail.Read.Shared AND User.Read

O

• Mail.ReadWrite.Shared AND User.Read

O

• Mail.Read AND User.ReadWrite

O

• Mail.ReadWrite AND User.ReadWrite

O

• Mail.Read.Shared AND User.ReadWrite

O

• Mail.ReadWrite.Shared AND User.ReadWrite

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Propiedades

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Cuenta : (opcional) la dirección de correo electrónico con la que interactuar. Esto puede incluir cualquier buzón compartido al que el usuario actual tenga derechos de acceso. Si se deja en blanco, se asume la cuenta del usuario actual. Esta propiedad admite variables String y valores en formato de cadena.
  Nota: El campo de lacuenta es obligatorio para los tipos de autenticación ApplicationIdAndSecret y ApplicationIdAndCertificate .
• Carpeta de correo: la carpeta de correo desde la que se recuperan los mensajes. Introduzca su carpeta tal como aparece en su aplicación de Outlook (por ejemplo, "Bandeja de entrada", "Elementos enviados", "Elementos eliminados", etc.). Las subcarpetas usan el formato "CarpetaPrincipal / Subcarpeta / OtraSubcarpeta". Esta propiedad admite variables String y valores en formato de cadena.

Otros

• Privado: si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo admite valores booleanos.

Opciones

• ID de correo electrónico : el identificador del correo electrónico a buscar. Cuando se especifica, los parámetros Cuenta, Obtener como HTMLy Marcar como leído se tienen en cuenta, mientras que los parámetros Solo mensajes no leídos, Ordenar por fecha, Consultay Principales se ignoran. Si se encuentra el correo electrónico con el ID especificado, la matriz de salida contiene exactamente un elemento. Si no se encuentra, la actividad genera una excepción. Esta propiedad admite variables String y valores en formato de cadena.
• Obtener como HTML : si se selecciona, el cuerpo del mensaje se devuelve en formato HTML. Este campo admite valores booleanos.
• Marcar como leído : si se selecciona, los mensajes devueltos se marcan como leídos. Este campo admite valores booleanos.
• Solo mensajes no leídos : si se selecciona, solo se devuelven los mensajes no leídos. Este campo admite valores booleanos. El valor predeterminado es Verdadero.
• Ordenar por fecha : los mensajes devueltos están ordenados por fecha. Las opciones disponibles son NewestFirst y OldestFirst.
• Consulta : consulta utilizada para filtrar los correos electrónicos devueltos. Si la consulta no se completa, se devuelven todos los correos electrónicos. Introduce tu String utilizando el parámetro de consulta $filter OData. A continuación se muestran algunos ejemplos de entradas:
  • "from/emailAddress/address eq '[e-mail]'"
  • "subject eq 'Office365 Quickstart'"
  • "subject eq 'Office365 Quickstart' and from/emailAddress/address eq '[e-mail]'"
  • "categories/any(a:a eq 'Red category')"
• Arriba : el número máximo de correos electrónicos que se pueden recuperar. Este campo solo admite variables enteras y Int32 . El valor predeterminado es 50 (no se muestra).

Salida

• Resultado : devuelve todos los correos electrónicos de la bandeja de entrada del usuario. Este campo solo admite Office365Message[] variables. Obligatorio si planea utilizar los datos de salida en actividades posteriores.

  La variable que creas para esta propiedad también se usa en las actividades Reenviar correo y Mover correo (como valor de la propiedad de entrada del Mensaje ). Cuando use esta variable como valor de propiedad de entrada, especifique el elemento en la matriz que desea usar (por ejemplo, FoundMessages (0)).

  Office365Messageobject incluye varias propiedades que puedes usar en otras actividades.
  La propiedad Body.Content se devuelve solo en formato HTML.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos.
2. Agrega la actividad de Ámbito de Microsoft Office 365 a tu proyecto.
3. Añade una actividad Obtener correo dentro de la actividad Ámbito de Microsoft Office 365.
4. Introduce valores para las propiedades de entrada.
5. Crea e introduce una variable Office365Message[] para tu propiedad de salida.

6. Ejecuta la actividad.

   • Los valores de tu propiedad de entrada se envían a las API GetMessage y ListMessages .
   • La API devuelve el valor Office365Message[] a su variable de propiedad de salida.