Search Events

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

Description

Utilise l'API d'événements de liste Microsoft Graph pour récupérer les événements correspondants du calendrier spécifié (Calendrier). Si la propriété Calendrier est laissée vide, l’activité recherche les événements dans votre calendrier par défaut.

Après avoir effectué la recherche, l'activité renvoie les objets Event[] correspondants (Events) que vous pouvez utiliser comme variable d'entrée dans les activités suivantes (Modifier l'événement, Ajouter un emplacement, etc.).

Étendues

Cette activité nécessite les étendues suivantes :

• Calendars.ReadWrite

OU

• Calendars.ReadWrite.Shared

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 String et les valeurs au format chaîne.

Entrée

• Compte - (Facultatif) L'adresse e-mail avec laquelle interagir. Cela peut inclure toute boîte aux lettres partagée à laquelle l'utilisateur actuel a des droits d'accès. S’il 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 :

  Account field is mandatory for ApplicationIdAndSecret authentication type.

• Calendrier - Le calendrier dans lequel effectuer la recherche. Cela peut être récupéré à l'aide de l'activité Récupérer calendriers . Si vous ne fournissez pas de valeur, votre calendrier par défaut est utilisé. Ce champ prend uniquement en charge les variables Calendar . Si vous saisissez une valeur, utilisez une variable de propriété de sortie de l'activité Get Calendars (Calendar ou Default Calendar). Si vous utilisez la variable de propriété de sortie Calendar , spécifiez l'élément du tableau que vous souhaitez utiliser (par exemple, myCalendar(0)).

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

• End Date - The end date of the events that you want to search. When specified, the search only returns events that occur before this date (events occurring on this date are not searched). This field supports only DateTime variables. Your DateTime value must be formatted as MM/DD/YYYY (e.g., 11/01/2019).
• ID d'événement (Event ID) - l'ID de l'événement à rechercher. Lorsqu'il est spécifié, le paramètre Account (Compte) est pris en compte tandis que les autres paramètres de filtre de la catégorie Options sont ignorés. Si l'e-mail comportant l'ID spécifié est trouvé, le tableau de sortie contiendra exactement un élément. S'il n'est pas trouvé, l'activité générera une exception. Cette propriété prend en charge les variables de String et les valeurs au format chaîne.
• Max Results - The maximum amount of events that you want to be returned in your search results. This field supports only integer and Int32 variables. The default value is 50.
• Renvoyer les événements récurrents : si sélectionné, les événements d'une série sont également renvoyés. Ce champ prend en charge les valeurs booléennes.
• Requête de recherche : si fourni, seuls les événements dont l'objet, le corps, les emplacements ou les participants contiennent cette chaîne sont renvoyés. Entrez votre String à l'aide des paramètres de requête OData ou entrez le titre de l'événement (par ex., « Office365-Quickstart »).
• Start Date - The start date of the events that you want to search. When specified, the search only returns events that occur after this date (events occurring on this date are not searched). This field supports only DateTime variables. Your DateTime value must be formatted as MM/DD/YYYY (e.g., 10/30/2019).

Sortie

• Événements : un tableau d'événements (objets Event ) correspondant à votre valeur SearchQuery . Ce champ prend uniquement en charge les variables Event[] . Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. La variable que vous créez pour cette propriété peut être utilisée comme variable d'entrée dans d'autres activités, telles que Modifier l'événement, Ajouter un emplacement, etc. Lorsque vous utilisez cette variable comme valeur de propriété d'entrée, veillez à spécifier l'élément du tableau que vous souhaitez utiliser (par exemple, myEvents(0)). L'objet Event comprend plusieurs propriétés que vous pouvez utiliser dans d'autres activités ; toutes les propriétés ne sont pas prises en charge. La propriété Body.Content est renvoyée au format HTML uniquement.

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. (Facultatif) Ajoutez une activité ou exécutez un processus externe qui génère un objet Calendar (par exemple, Obtenir calendriers).
4. Add the Search Events activity inside the Microsoft Office 365 Scope activity.
5. Entrez des valeurs pour les propriétés d'entrée.
6. Créez et entrez une variable Event[] pour la propriété Output (Sortie).
7. Exécutez l’activité.
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API ListEvents .
   • L'API renvoie la valeur Event[] à votre variable de propriété de sortie.