Encontrar horas de reunión

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

Descripción

Utiliza la API Buscar horas de reunión de Microsoft Graph para sugerir horas y ubicaciones de reunión en función de la disponibilidad del organizador y los asistentes (Asistentes) y el intervalo de tiempo especificado en el que desea que se produzca la reunión (IntervalStart, IntervalEnd y MeetingDuration).

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 (AvailabilityTimeslots). Si la actividad no encuentra ningún intervalo de tiempo disponible, devuelve un motivo para que puedas modificar tu rango según sea necesario (EmptySuggestionReason).

Nota:

Buscar horas de reunión no se puede utilizar con la autenticación IDYSecretoDeAplicación porque la API BuscarHorasDeReunión 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

Panel de propiedades

Común

• NombreParaMostrar : el nombre para mostrar de la actividad. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Asistentes : una matriz de las direcciones de correo electrónico de los asistentes. Este campo solo admite variables String[] . Para introducir una dirección de correo electrónico, inclúyela entre { } y declárala con " " (por ejemplo, {"[e-mail]"}). Para introducir varias direcciones de correo electrónico, incluya todas entre { }, declare cada una con " " y sepárelas con una coma (por ejemplo, {"[e-mail]","[e-mail]"}).
• Interval End - The end of the time period in which to search for openings. This field supports only DateTime variables. The default value is Today at midnight (not shown). You may enter the date only or the date and time. If you enter a date only, the search is limited to the working hours specified by the attendee calendars.
• Interval Start - The beginning of the time period in which to search for openings. This field supports only DateTime variables. The default value is Current system time (not shown). You may enter the date only or the date and time. If you enter a date only, the activity searches for times as specified in the Policy property.
  Nota:

  • Your DateTime values must be formatted as MM/DD/YYYY or MM/DD/YYYY Hour:Minute:Seconds (e.g., 10/31/2019 12:00:00).
  • The DateTime format is auto-corrected if you enter enough details. For example, if you enter 10/31/19 3pm it auto-corrects to 10/31/2019 15:00:00.
• Meeting Duration - The desired duration for the meeting in minutes. This field supports only integer and Int32 variables. The default value is 30 (not shown).
• Zona horaria : la zona horaria en la que se interpretará el inicio del intervalo y el final del intervalo. El valor predeterminado es la zona horaria de tu sistema (no se muestra). Esta propiedad admite variables String y valores en formato de cadena.

Otros

• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.
• Privado : si se selecciona, los valores de las variables y los argumentos ya no se registran en el nivel Detallado. Este campo admite valores booleanos.

Opciones

• Locations - An array of rooms or locations, given by their display names, to search. If no locations are available, another is selected. This field supports only String[] variables. If the listed meeting rooms are not available, the activity does not return meeting time suggestions.
• Organizador requerido : si se selecciona, el usuario es un asistente necesario para la reunión. Este campo admite valores booleanos.
• Policy - Specifies the attendees' restrictions to abide by while searching for available meeting times. Select one of the four options:
  • Unknown - Do not use this value as it will be deprecated in the future. Currently, it behaves as same as Work.
  • Work - Suggested times are within the users' work hours. Default hours are Mon-Fri, 8am to 5pm.
  • Personal - Suggested times are within the users' work hours and Saturday and Sunday. Default hours are Mon-Sun, 8am to 5pm.
  • Sin restricciones : los horarios 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 matriz de horarios de reunión, asistentes disponibles y ubicaciones (si corresponde). Este campo solo admite variables MeetingTimeSuggestion[] . Obligatorio si planeas utilizar los datos de salida en actividades posteriores. El objeto MeetingTimeSuggestion incluye varias propiedades que puedes utilizar en otras actividades.
• Empty Suggestion Reason - A reason for not returning any meeting suggestions. The possible values are attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the Available Timeslots property does not include any meeting suggestions. You can also use MeetingTimeSuggestion.SuggestionReason to see the suggestion reason.

Configuración para multiplataforma

Panel de propiedades

Entrada

• Organizador obligatorio : especifica si el organizador es un asistente obligatorio. Está establecido en True de forma predeterminada.
• Restricciones : las restricciones que los asistentes deben seguir al buscar horas de reunión disponibles. Selecciona una de las siguientes opciones:
  • Trabajo : las sugerencias de reunión se limitan a las horas de trabajo del usuario según lo establecido en su calendario. El horario predeterminado es de lunes a viernes, de 8:00 a 17:00.
  • Personal : las sugerencias de reunión abarcan toda la semana en función de la configuración de tu calendario. El horario predeterminado es de lunes a domingo, de 8:00 a 17:00.
  • Sin restricciones : las sugerencias de reunión están disponibles en cualquier momento y cualquier día sin limitaciones.
• Locations - An array of rooms or locations, given by their display names, to search. If no locations are available, another is selected. This field supports only String[] variables. If the listed meeting rooms are not available, the activity does not return meeting time suggestions.

Salida

• Motivo de sugerencia vacía : un motivo para no devolver ninguna sugerencia de reunión. Los valores posibles son attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable o unknown. Esta propiedad es una cadena vacía si la propiedad Intervalos de tiempo disponibles no incluye ninguna sugerencia de reunión. También puedes utilizar MeetingTimeSuggestion.SuggestionReason para ver el motivo de la sugerencia.
• Intervalos de tiempo disponibles : una matriz de horas de reunión, asistentes disponibles y, si corresponde, ubicaciones. Este campo solo admite variables MeetingTimeSuggestion[] . El campo es obligatorio si planeas utilizar los datos de salida en actividades posteriores. El objeto MeetingTimeSuggestion incluye varias propiedades que puedes utilizar en otras actividades.

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. Añade la actividad Ámbito de Microsoft Office 365 a tu proyecto.
3. Add the Find Meeting Times activity inside the Microsoft Office 365 Scope activity.
4. Introduce valores para las propiedades de entrada.
5. Crea e introduce variables MeetingTimeSuggestion[] y String para tu propiedad Salida .
6. Ejecuta la actividad.
   • Los valores de propiedad de entrada se envían a la API BuscarHorasDeReunión .
   • La API devuelve los valores MeetingTimeSuggestion[] y String a tu variable de propiedad de salida.