Search Events

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

Beschreibung

Verwendet die Microsoft Graph List Events- API, um die übereinstimmenden Ereignisse aus dem angegebenen Kalender (Calendar) abzurufen. Wenn die Eigenschaft Calendar leer gelassen wird, durchsucht die Aktivität Ihren Standardkalender nach Ereignissen.

Nach der Suche gibt die Aktivität die übereinstimmenden Event[] -Objekte (Ereignisse) zurück, die Sie in nachfolgenden Aktivitäten als Eingabevariable verwenden können (Modify Event, Add Location usw.).

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Calendars.ReadWrite

ODER

• Calendars.ReadWrite.Shared

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Konto – (Optional) Die E-Mail-Adresse, mit der interagiert werden soll. Dies kann ein gemeinsam verwendetes Postfach beinhalten, für das der aktuelle Benutzer Zugriffsrechte hat. Wenn leer gelassen, wird das Konto des aktuellen Benutzers angenommen. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

  Hinweis:

  Account field is mandatory for ApplicationIdAndSecret authentication type.

• Kalender – Der Kalender, in dem gesucht werden soll. Dies kann mit der Aktivität Get Calendars abgerufen werden. Wenn Sie keinen Wert angeben, wird Ihr Standardkalender verwendet. Dieses Feld unterstützt nur Calendar -Variablen. Wenn Sie einen Wert eingeben, verwenden Sie eine Ausgabeeigenschaftsvariable aus der Aktivität Kalender abrufen (Kalender oder Standardkalender). Wenn Sie die Ausgabeeigenschaftsvariable Kalender verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. myCalendar(0)).

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• 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).
• Vorgangs-ID – Die ID des zu suchenden Vorgangs. Wenn angegeben, wird der Parameter Account berücksichtigt, während die anderen Parameter in der Kategorie Options ignoriert werden. Wenn die E-Mail mit der angegebenen ID gefunden wird, enthält das Ausgabe-Array genau ein Element. Wenn sie nicht gefunden wird, löst die Aktivität eine Ausnahme aus. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• 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.
• Wiederkehrende zurückgeben – Wenn diese Option ausgewählt ist, werden auch Termine in einer Serie zurückgegeben. Dieses Feld unterstützt nur boolesche Werte.
• Suchabfrage – Wenn angegeben, werden nur Termine zurückgegeben, deren Betreff, Text, Orte oder Teilnehmer diese Zeichenfolge enthalten. Geben Sie Ihre String mithilfe von OData-Abfrageparametern ein, oder geben Sie den Titel des Ereignisses ein (z. B. "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).

Ausgabe

• Ereignisse – Ein Array von Ereignissen (Event -Objekten), die Ihrem SearchQuery- Wert entsprechen. Dieses Feld unterstützt nur Event[] -Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. Die Variable, die Sie für diese Eigenschaft erstellen, kann als Eingabevariable in anderen Aktivitäten verwendet werden, z. B. Modify Event, Add Location usw. Wenn Sie diese Variable als Eingabeeigenschaftswert verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. myEvents(0)). Das Event -Objekt enthält mehrere Eigenschaften , die Sie in anderen Aktivitäten verwenden können; Nicht alle Eigenschaften werden unterstützt. Die Eigenschaft Body.Content wird nur im HTML-Format zurückgegeben.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. (Optional) Fügen Sie eine Aktivität hinzu oder führen Sie einen externen Prozess aus, der ein Calendar -Objekt ausgibt (z. B. Get Calendars).
4. Add the Search Events activity inside the Microsoft Office 365 Scope activity.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variable Event[] für die Output-Eigenschaft ein.
7. Führen Sie die Aktivität aus.
   • Ihre Eingabeeigenschaftswerte werden an die ListEvents- API gesendet.
   • Die API gibt den Wert Event[] an Ihre Ausgabeeigenschaftsvariable zurück.