Encontrar horas de reunión

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

Descripción

Usa la API Buscar horas de reunión de Microsoft Graph para sugerir horas y ubicaciones de reuniones según la disponibilidad del organizador y los asistentes (Asistentes) y el intervalo de hora especificado en el que desea que se produzca la reunión (IntervalStart, IntervalEndy ReuniónDuration).

Después de analizar la disponibilidad de los asistentes, la actividad devuelve una matriz de horas, ubicaciones (si corresponde) y asistentes que están disponibles durante tu intervalo especificado (availableTimeslots). Si la actividad no encuentra ningún intervalo de tiempo disponible, devuelve un motivo para que puedas modificar el intervalo según sea necesario (VaciarSuggestionReason).

Nota: Buscar horas de reunión no se puede usar con la autenticación ApplicationIdAndSecret porque la API FindMeetingTimes de Microsoft Graph no admite permisos de aplicación.

Á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

• Asistentes : una matriz de direcciones de correo electrónico de los asistentes. Este campo solo admite String[] variables. Para introducir una dirección de correo electrónico, inclúyela entre {} y declárala con "" (p. Ej., {"[e-mail]"}). Para introducir varias direcciones de correo electrónico, incluye todas las que hay entre {}, declara cada una con "" y separa cada una con una coma (p. Ej., {"[e-mail]", "[e-mail]"}).
• Final del intervalo : el final del período de tiempo en el que se buscarán oportunidades. Este campo solo admite DateTime variables. El valor predeterminado es Hoy a medianoche (no se muestra). Puede introducir solo la fecha o la fecha y la hora. Si introduce solo una fecha, la búsqueda se limita a las horas de trabajo especificadas por los calendarios de los asistentes.
• Inicio del intervalo : el comienzo del período de tiempo en el que se buscarán las oportunidades. Este campo solo admite DateTime variables. El valor predeterminado es la hora actual del sistema (no se muestra). Puede introducir solo la fecha o la fecha y la hora. Si ingresas solo una fecha, la actividad busca las horas especificadas en la propiedad Política .
  Nota:

  • Sus valores DateTime deben tener el formato MM / DD / AAAA o MM / DD / AAAA Hora: Minuto: Segundos (p. Ej., 31/10/19 12:00:00).
  • El formato DateTime se corrige automáticamente si introduces suficientes detalles. Por ejemplo, si introduce 31/10/19 3 p . M., Se corrige automáticamente hasta 31/10/19 15:00:00.
• Duración de la reunión : la duración deseada para la reunión en minutos. Este campo solo admite variables enteras y Int32 . El valor predeterminado es 30 (no se muestra).
• Zona horaria : la zona horaria en la que se debe interpretar el inicio del intervalo y el final del intervalo. El valor predeterminado es la zona horaria de su sistema (no se muestra). 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

• Ubicaciones : una matriz de salas o ubicaciones, dadas por sus nombres para mostrar, para buscar. Si no hay ubicaciones disponibles, se selecciona otra. Este campo solo admite String[] variables. Si las salas de reuniones indicadas no están disponibles, la actividad no devuelve sugerencias de horas de reunión.
• Organizador obligatorio : si se selecciona, el usuario es un asistente obligatorio para la reunión. Este campo admite valores booleanos.

• Política : especifica las restricciones de los asistentes a seguir mientras se buscan horas de reunión disponibles. Seleccione una de las cuatro opciones:

  • Desconocido : no utilices este valor ya que quedará obsoleto en el futuro. Actualmente, se comporta igual que Work.
  • Trabajo : los tiempos sugeridos están dentro de las horas de trabajo de los usuarios. El horario predeterminado es de lunes a viernes de 8 a. M. A 5 p. M.
  • Personal : las horas sugeridas están dentro de las horas de trabajo de los usuarios y los días Sábado y Domingo. El horario predeterminado es de lunes a domingo de 8 a. M. A 5 p. M.

  • No restringido : los tiempos sugeridos pueden incluir todas las horas de todos los días de la semana. El valor predeterminado es Sin restricciones. Las horas de trabajo de un usuario se definen en su configuración de calendario y pueden ser personalizadas por el usuario o el administrador.

Salida

• Intervalos de tiempo disponibles : una variedad de horas de reunión, asistentes disponibles y ubicaciones (si corresponde). Este campo solo admite MeetingTimeSuggestion[] variables. Obligatorio si planea utilizar los datos de salida en actividades posteriores. El objeto MeetingTimeSuggestion incluye varias propiedades que puedes usar en otras actividades.
• Razón de la sugerencia vacía : una razón para no devolver ninguna sugerencia de reunión. Los posibles valores son asistentesNoDisponibles, asistentesNoDisponiblesODesconocidos, ubicacionesNoDisponibles, organizadorNoDisponible o desconocido. Esta propiedad es una cadena vacía si la propiedad Intervalos de tiempo disponibles no incluye ninguna sugerencia de reunión. También puede utilizar MeetingTimeSuggestion.SuggestionReason para ver el motivo de la sugerencia.

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 la actividad Encontrar horas de reunión dentro de la actividad Ámbito de Microsoft Office 365.
4. Introduce valores para las propiedades de entrada.
5. Crear e introducir variables MeetingTimeSuggestion[] y String para tu propiedad Salida.

6. Ejecuta la actividad.

   • Los valores de las propiedades de entrada se envían a la API EncontrarHorasDeReunión.
   • La API devuelve los valores MeetingTimeSuggestion[] y String a tu variable de propiedad de salida.