Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

Description

Utilise l'API de recherche d'heures de réunion de Microsoft Graph pour suggérer des heures et des emplacements de réunion en fonction de la disponibilité de l'organisateur et des participants (Participants), ainsi que la plage d'heures que vous avez spécifiée pour que la réunion ait lieu (IntervalStart, IntervalEnd et Durée de la réunion).

Après avoir analysé la disponibilité du participant, l'activité renvoie un tableau d'heures, d'emplacements (le cas échéant) et de participants disponibles pendant la plage spécifiée (AvailableTimeslots). Si l’activité ne trouve aucun créneau horaire disponible, elle renvoie une raison pour que vous puissiez modifier votre plage selon vos besoins (EmptySuggestionReason).

Remarque : Les heures de recherche ne peuvent pas être utilisées avec l’authentification ApplicationIdAndSecret , car l’API Microsoft Graph FindMeetingTimes ne prend pas en charge les autorisations d’application.

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Cette propriété prend en charge les variables de chaîne 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 String[] variables. 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]"}).
• Fin de l'intervalle (Interval End ) - La fin de la période de recherche des ouvertures. Ce champ ne prend en charge que DateTime variables. La valeur par défaut est Aujourd'hui à minuit (non affiché). Vous pouvez saisir la date uniquement ou la date et l'heure. Si vous entrez uniquement une date, la recherche est limitée aux heures de travail spécifiées par les calendriers des participants.
• Début de l'intervalle (Interval Start ) - Début de la période de recherche d'ouvertures. Ce champ ne prend en charge que DateTime variables. La valeur par défaut est Heure système actuelle (non affichée). Vous pouvez saisir la date uniquement ou la date et l'heure. Si vous entrez uniquement une date, l'activité recherche les heures spécifiées dans la propriété Stratégie .
  Remarque :

  • Vos valeurs DateTime doivent être au format JJ/MM/AAAA ou JJ/MM/AAAA Heure:Minute:Seconds (par exemple, 31/10/2019 12:00:00).
  • Le format DateTime est corrigé automatiquement si vous entrez suffisamment de détails. Par exemple, si vous entrez 31/10/2019 15:00 , il se corrige automatiquement en 31/10/2019 15:00:00.
• Durée de laréunion : la durée souhaitée pour la réunion en minutes. Ce champ prend uniquement en charge les variables entières et Int32 . La valeur par défaut est 30 (non affichée).
• Fuseau horaire (Time Zone) : le fuseau horaire dans lequel interpréter le début de l' intervalle et la finde l'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

• 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

• Emplacements (Locations) : un tableau de pièces ou d'emplacements, donnés par leurs noms d'affichage, à rechercher. Si aucun emplacement n'est disponible, un autre est sélectionné. Ce champ ne prend en charge que String[] variables. Si les salles de réunion répertoriées ne sont pas disponibles, l'activité ne renvoie pas de suggestions d'heure de réunion.
• Organisateur requis : si cette option est sélectionnée, l'utilisateur doit obligatoirement participer à la réunion. Ce champ prend en charge les valeurs booléennes.

• Stratégie - Spécifie les restrictions des participants à respecter lors de la recherche des heures de réunion disponibles. Sélectionnez l'une des quatre options :

  • Inconnu (Unknown) : n’utilisez pas cette valeur car elle sera obsolète à l’avenir. Actuellement, il se comporte comme Work.
  • Travail (Work ) : les heures suggérées correspondent aux heures de travail des utilisateurs. Les heures par défaut sont du lundi au vendredi, de 8 h à 17 h.
  • Personnel (Personal ) - Les heures suggérées correspondent aux heures de travail des utilisateurs et le samedi et le dimanche. Les heures par défaut sont du lundi au dimanche, de 8 h à 17 h.

  • Illimité (Unrestricted ) : les heures suggérées peuvent inclure toutes les heures de tous les jours de la semaine. La valeur par défaut est Illimité ( Unrestricted). Les heures de travail d'un utilisateur sont définies dans la configuration de son calendrier et peuvent être personnalisées par l'utilisateur ou l'administrateur.

Sortie

• Créneaux disponibles : tableau des horaires de réunion, des participants disponibles et des emplacements (le cas échéant). Ce champ prend uniquement en charge 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.
• Raison de suggestion vide (Vide Suggestion Reason ) - Raison pour laquelle aucune suggestion de réunion n'est renvoyée. Les valeurs possibles sont participantsUnavailable, participantsUnavailableOrUnknown, locationsUnavailable, organiserUnavailable ou unknown. Cette propriété est une chaîne vide si la propriété Plages horaires disponibles n'inclut aucune suggestion de réunion. Vous pouvez également utiliser MeetingTimeSuggestion.SuggestionReason pour voir le motif de la suggestion.

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. Terminez les étapes de configuration .
2. Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
3. Ajoutez l’activité Ajouter une feuille à l’intérieur de l’activité Étendue Microsoft Office 365.
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 (Sortie).

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.