Get Calendars

UiPath.MicrosoftOffice365.Activities.Calendar.GetCalendars

Description

Utilise l'API Microsoft Graph Get calendar pour obtenir les propriétés et les relations d'un calendrier. Le calendrier peut être celui d'un utilisateur ou le calendrier par défaut d'un groupe Office 365 (Utilisateur).

Après avoir récupéré les calendriers, l'activité génère un objet Calendar qui représente le calendrier par défaut de l'utilisateur (Default Calendar) et un tableau d'objets Calendar[] qui représente tous les calendriers de l'utilisateur (Calendars). Ces objets de sortie Calendar peuvent être utilisés comme variables de propriété d'entrée dans les activités Créer un événement ( Create Event ) et Rechercher des événements ( Search Events) .

Cette activité ne se limite pas à récupérer votre calendrier. Vous pouvez également récupérer le calendrier d'un autre utilisateur si l'application enregistrée dans l' étendue Microsoft Office 365 (IDApplication) dispose des autorisations ou des autorisations déléguées appropriées de la part de l'utilisateur.

Étendues

Cette activité nécessite les étendues suivantes :

• Calendars.Read

OU

• Calendars.Read.Shared

OU

• Calendars.ReadWrite

OU

• Calendars.ReadWrite.Shared

OU

• Group.Read.All

OU

• Grouper.Lecture.Écriture.Tout

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

• Compte (Compte) - (Facultatif) L'adresse e-mail avec laquelle interagir. Cela peut inclure n'importe quelle boîte aux lettres partagée à laquelle l'utilisateur actuel a des droits d'accès. Si ce champ est laissé vide, le compte de l'utilisateur actuel est utilisé. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
  Remarque : Le champCompte est obligatoire pour les types d'authentification ApplicationIdAndSecret et ApplicationIdAndCertificate .
• Utilisateur (User) : l’adresse e-mail de la personne dont le calendrier est récupéré. Si aucun n’est fourni, le propre calendrier de l’utilisateur est fourni. L’utilisateur doit disposer des autorisations d’API pour lire les calendriers. Pour plus d’informations, consultez le guide de configuration. Cette propriété prend en charge les variables de 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.

Sortie

• Calendriers : un tableau des calendriers de l'utilisateur. Ce champ prend uniquement en charge les variables Calendar[] . Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. Vous pouvez également utiliser cette variable comme variable d'entrée dans d'autres activités (par exemple, Create Event et Search Events).
• Calendrier par défaut (Default Calendar ) : le calendrier par défaut de l'utilisateur authentifié, au cas où la propriété Utilisateur (User) serait vide. Ce champ prend uniquement en charge les variables Calendar . Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. Vous pouvez également utiliser cette variable comme variable d'entrée dans d'autres activités (par exemple, Create Event et Search Events).

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. Ajoutez l’activité Ajouter un participant à 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 Calendar et Calendar[] 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 GetCalendar.
   • L'API renvoie les valeurs Calendar et Calendar[] à votre variable de propriété de sortie.