Créer un événement

UiPath.MicrosoftOffice365.Activities.Calendar.CreateEvent

Description

Utilise l'API de création d' événement Microsoft Graph pour créer un événement dans un calendrier spécifié (Calendar).

Lors de la création de votre événement, vous spécifiez la date et l'heure (Heure de début , Heurede finet Fuseau horaire) et le contenu que vous souhaitez inclure (Corps et Objet). De plus, vous avez la possibilité d'attribuer à cet événement une catégorie à partir de votre calendrier spécifié (Catégories).

Après avoir créé l'événement, l'activité génère un objet Event que vous pouvez utiliser comme variable d'entrée dans des activités ultérieures (par exemple, Ajouter un participant ( Add Attendee), Ajouter un emplacement (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.

Contenu l'événement

• Corps (Body ) : le corps de l'événement. Si l'option Est-ce que le corps HTML est sélectionnée, le corps doit être spécifié au format HTML. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Le corps est-il HTML - Si cette option est sélectionnée, le corps est interprété au format HTML. Ce champ prend en charge les valeurs booléennes.
• Objet (Subject) - L'objet de l'événement. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

Planification de l'événement

• Heure de fin (End Time) - L'heure de fin de l'événement. Ce champ prend uniquement en charge les variables DateTime.
• Heure de début (Start Time) - L'heure de début de l'événement. Ce champ prend uniquement en charge les variables DateTime.
  Remarque :

  • Vos valeurs DateTime doivent être au format JJ/MM/AAAA Heure:Minute:Secondes (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.
• TimeZone - Le fuseau horaire dans lequel l'heure de début et l'heure de fin sont interprétées. La valeur par défaut est le fuseau horaire de votre système (non affiché). Saisissez un String valide (par exemple, "Pacific Standard Time").

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 .
• Calendrier - Le calendrier que vous souhaitez utiliser pour créer l'événement. 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

• Catégories : les catégories associées à l'événement. Ce champ ne prend en charge que String[] variables. Votre valeur doit correspondre à un nom de la liste de catégories Calendrier que vous avez spécifiée (voir l’exemple d’image ci-dessous). Pour saisir une catégorie, incluez-la entre { } et déclarez-la avec " " (par exemple, {"Purple category"}). Pour saisir plusieurs catégories, incluez toutes entre { }, déclarez chacune avec " " et séparez chacune par une virgule (par exemple, {"A CustomCategory", "Purple category"}).
  
  

  

  
  
• Toute la journée (Is All Day) : si cette option est sélectionnée, l'événement est planifié pour la journée entière. Si cette option est sélectionnée, les valeurs que vous entrez dans les propriétés Heure de début et Heure de fin sont remplacées. La saisie de valeurs dans les propriétés Heure de début et Heure de fin est requise même lorsque vous sélectionnez cette propriété. Ce champ prend en charge les valeurs booléennes.
• Afficher en tant que : la disponibilité de l'utilisateur pendant l'événement. Sélectionnez l'une des six options : Unknown, Free, Tentative, Occupé, Oof ou WorkingElsewhere. La valeur par défaut est Libre ( Free).

Sortie

• Événement : l'événement créé. D'autres activités peuvent utiliser cet objet afin d'ajouter des participants ou de modifier des informations. 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. Vous pouvez utiliser cette variable comme variable d'entrée dans d'autres activités, telles que Ajouter un participant ( Add Attendee), Ajouter un emplacement (Add Location), etc.

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é Créer événement (Create Event) à l’intérieur de l’activité Étendue Microsoft Office 365.
5. Entrez des valeurs pour les propriétés Contenu de l'événement (Event Content) et Planification de l'événement (Event Scheduling).
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 CreateEvent.
   • L'API renvoie la valeur Event à votre variable de propriété de sortie.