Search Events

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

Description

Utilise l'API d' événements Microsoft Graph List pour récupérer les événements correspondants à partir du calendrier spécifié (Calendar). Si la propriété Calendrier est laissée vide, l'activité recherche des é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 des activités ultérieures (Modify Event, Add Location, 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 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 le type d'authentification ApplicationIdAndSecret .
• Calendrier - Le calendrier dans lequel effectuer la recherche. Cela peut être récupéré à l'aide de l'activité Get Calendars . 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 (Calendrier ou Calendrier par défaut). Si vous utilisez la variable de propriété de sortie Calendar (Calendrier), 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

• Date de fin - La date de fin des événements que vous souhaitez rechercher. Lorsqu'elle est spécifiée, la recherche ne renvoie que les événements qui se produisent avant cette date (les événements qui se produisent à cette date ne sont pas recherchés). Ce champ ne prend en charge que DateTime variables. Votre valeur DateTime doit être au format JJ/MM/AAAA (par exemple, 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 tableau de type chaîne String et les valeurs de tableau au format chaîne.
• Résultats max. (Max Results ) : le nombre maximal d'événements que vous souhaitez voir apparaître dans les résultats de votre recherche. Ce champ prend uniquement en charge les variables entières et Int32 . La valeur par défaut est 50.
• Retourner Périodicité (Return Recurring ) : si cette option est sélectionnée, 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 cette option est fournie, seuls les événements dont l'objet, le corps, les emplacements ou les participants contiennent cette chaîne sont renvoyés. Saisissez votre String à l'aide des paramètres de requête OData ou saisissez le titre de l'événement (par exemple, "Office365-Quickstart").
• Date de début (Start Date) - la date de début des événements que vous souhaitez rechercher. Lorsque cela est spécifié, la recherche ne renvoie que les événements qui se produisent après cette date (les événements qui se produisent à cette date ne sont pas recherchés). Ce champ prend uniquement en charge les variables DateTime. Votre valeur DateTime doit être au format JJ/MM/AAAA (par exemple, 30/10/2019).

Sortie

• Événements : tableau d'événements (objetsEvent ) qui correspondent à la valeur RequêteRecherche . 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 ( Modify Event) , Ajouter un emplacement (Add Location), 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, Get Calendars).
4. Ajoutez l’activité Rechercher événement (Search Event) à l’intérieur de l’activité Étendue Microsoft Office 365.
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.