Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

Description

Utilise l'API Microsoft Graph Find Find Meeting Times pour suggérer des heures et des lieux de réunion en fonction de la disponibilité de l'organisateur et des participants (Participants) et de l'heure que vous souhaitez que la réunion ait lieu (IntervalStart, IntervalEnd, et MeetingDuration).

Après avoir analysé la disponibilité des participants, l'activité renvoie un tableau des heures, des emplacements (le cas échéant) et des participants disponibles pendant la plage spécifiée. Si l'activité ne trouve pas de créneaux horaires disponibles, elle renvoie une raison afin que vous puissiez modifier votre plage selon vos besoins (EmptySuggestionReason).

Remarque :

La recherche d’heures de réunion ne peut pas être utilisée avec l’authentification ApplicationIdAndSecret, car l’API Microsoft Graph FindMeetingTimes ne prend pas en charge les autorisations d’application.

Étendues

Cette activité nécessite les étendues suivantes :

• Calendars.ReadWrite

OU

• Calendars.ReadWrite.Shared

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Panneau propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité. Cette propriété prend en charge les variables de String et les valeurs au format chaîne.

Entrée

• Participants : un tableau des adresses e-mail des participants. Ce champ ne prend en charge que les variables String[] . Pour saisir une adresse e-mail, incluez-la entre { } et déclarez-la avec " " (par exemple, {"[e-mail]"}). Pour saisir plusieurs adresses e-mail, incluez toutes entre { }, déclarez chacune avec " " et séparez chacune par une virgule (par exemple, {"[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.
  Remarque :

  • 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).
• Fuseau horaire - Le fuseau horaire dans lequel interpréter le début d'intervalle et la fin d'intervalle. La valeur par défaut est le fuseau horaire de votre système (non affiché). Cette propriété prend en charge les variables String et les valeurs au format chaîne.

Divers

• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.
• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend en charge les valeurs booléennes.

Options

• 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.
• Organisateur requis : si cette option est sélectionnée, l'utilisateur est un participant requis de la réunion. Ce champ prend en charge les valeurs booléennes.
• 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.
  • Sans restriction : les horaires suggérés peuvent inclure toutes les heures de tous les jours de la semaine. La valeur par défaut est Sans restriction. Les heures ouvrées d'un utilisateur sont définies dans sa configuration du calendrier et peuvent être personnalisées par l'utilisateur ou l'administrateur.

Sortie

• Créneaux disponibles : Un tableau des horaires de réunion, des participants disponibles et des emplacements (le cas échéant). Ce champ ne prend en charge que les variables MeetingTimeSuggestion[] . Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. L'objet MeetingTimeSuggestion comprend plusieurs propriétés que vous pouvez utiliser dans d'autres activités.
• 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.

Configuration pour le multiplate-forme

Panneau propriétés

Entrée

• Organisateur requis : spécifie si l'organisateur est un participant requis. Il est défini sur True par défaut.
• Contraintes : les contraintes que les participants doivent appliquer lorsqu'ils recherchent des horaires de réunion disponibles. Sélectionnez l'une des options suivantes :
  • Professionnel : les suggestions de réunion se limitent aux heures ouvrées de l’utilisateur telles que définies dans son calendrier. Les heures par défaut sont du lundi au vendredi, de 8 h à 17 h.
  • Personnel : les suggestions de réunion couvrent la semaine entière en se basant sur vos paramètres de calendrier. Les heures par défaut sont du lundi au dimanche, de 8 h à 17 h.
  • Sans restriction : les suggestions de réunion sont disponibles à tout moment et de tous les jours, sans qu’aucune limite ne soit appliquée.
• 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.

Sortie

• Suggestion de raison vide : une raison pour laquelle aucune suggestion de réunion n'est renvoyée. Les valeurs possibles sont attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, ou unknown. Cette propriété est une chaîne vide si la propriété Créneaux disponibles n'inclut aucune suggestion de réunion. Vous pouvez également utiliser MeetingTimeSuggestion.SuggestionReason pour voir la raison de la suggestion.
• Créneaux disponibles : Un tableau des horaires de réunion, des participants disponibles et, le cas échéant, des emplacements. Ce champ ne prend en charge que les variables MeetingTimeSuggestion[] . Ce champ est obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. L'objet MeetingTimeSuggestion comprend plusieurs propriétés que vous pouvez utiliser dans d'autres activités.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Effectuez les étapes.
2. Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
3. Add the Find Meeting Times activity inside the Microsoft Office 365 Scope activity.
4. Entrez des valeurs pour les propriétés d'entrée.
5. Créez et entrez les variables MeetingTimeSuggestion[] et String pour votre propriété Output .
6. Exécutez l’activité.
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API FindMeetingTimes .
   • L'API renvoie les valeurs MeetingTimeSuggestion[] et String à votre variable de propriété de sortie.