Buscar Eventos

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

Descripción

Usa la API de eventos de lista de Microsoft Graph para recuperar los eventos coincidentes del calendario especificado (calendario). Si la propiedad Calendario se deja vacía, la actividad busca eventos en su calendario predeterminado.

Tras realizar la búsqueda, la actividad devuelve los objetos Event[] coincidentes (Eventos) que puedes utilizar como variable de entrada en actividades posteriores (Modificar evento, Añadir ubicación, etc.).

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Calendarios. LeerEscribir

O

• Calendarios.LeerEscribir.Compartir

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 el tipo de autenticación ApplicationIdAndSecret .
• Calendario : el calendario en el que buscar. Esto se puede recuperar utilizando la actividad Obtener calendarios . Si no proporcionas un valor, se usará tu calendario predeterminado. Este campo solo admite variables Calendar . Si introduce un valor, use una variable de propiedad de salida de la actividad Obtener calendarios (Calendario o Calendario predeterminado). Si está utilizando la variable de propiedad de salida Calendario , especifique el elemento de la matriz que desea utilizar (por ejemplo, miCalendario (0)).

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

• Fecha de finalización: la fecha de finalización de los eventos que quieres buscar. Cuando se especifica, la búsqueda solo devuelve eventos que ocurren antes de esta fecha (los eventos que ocurren en esta fecha no se buscan). Este campo solo admite DateTime variables. Su valor DateTime debe tener el formato MM / DD / AAAA (p. Ej., 01/11/19).
• ID del Evento: el ID del evento a buscar. Cuando se especifica, se tiene en cuenta el parámetro Cuenta mientras que los otros filtros de parámetros en la categoría Opciones se ignoran. Si se encuentra el evento con el ID especificado, la matriz de salida contiene exactamente un elemento. Si no se encuentra, la actividad arrojará una excepción. Esta propiedad admite variables String y valores en formato de cadena.
• Resultados máximos: la cantidad máxima de eventos que quieres que se devuelvan en los resultados de búsqueda. Este campo solo admite variables enteras y Int32 . El valor predeterminado es 50.
• Devolver recurrentes : si se selecciona, también se devuelven los eventos de una serie. Este campo admite valores booleanos.
• Buscar Consulta : si se proporciona, solo se devuelven los eventos cuyo asunto, cuerpo, ubicaciones o asistentes contienen esta cadena. Introduce tu String utilizando los parámetros de consulta de OData o introduce el título del evento (por ejemplo, "Office365-Quickstart").
• Fecha de inicio: la fecha de inicio de los eventos que quieres buscar. Cuando se especifica, la búsqueda solo devuelve eventos que se producen después de esta fecha (no se buscan los eventos que se producen en esta fecha). Este campo solo admite variables DateTime. Tu valor DateTime debe tener formato MM/DD/YYYY (por ejemplo, 10/30/2019).

Salida

• Eventos : una matriz de eventos (Event objetos) que coinciden con tu valor de ConsultaDeBúsqueda . Este campo solo admite variables Event[] . Obligatorio si planea utilizar los datos de salida en actividades posteriores. La variable que cree para esta propiedad se puede utilizar como variable de entrada en otras actividades, como Modificar evento, Añadir ubicación, etc. Cuando use esta variable como valor de propiedad de entrada, asegúrese de especificar el elemento en la matriz que desea usar (por ejemplo, misEventos (0)). El objeto Event incluye múltiples propiedades que puede usar en otras actividades; no todas las propiedades son compatibles. 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. (Opcional) Añade una actividad o ejecuta un proceso externo que genere un objeto Calendar (por ejemplo, Obtener calendarios).
4. Añade la actividad Buscar eventos dentro de la actividad Ámbito de Microsoft Office 365.
5. Introduce valores para las propiedades de entrada.
6. Crea e introduce una variable Event[] para la propiedad Salida.

7. Ejecuta la actividad.

   • Los valores de las propiedades de entrada se envían a la API ListaDeEventos.
   • La API devuelve el valor Event[] a su variable de propiedad de salida.