Search Events

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

Beschreibung

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

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

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. Dazu kann jedes freigegebene Postfach gehören, für das der aktuelle Benutzer Zugriffsrechte hat. Wenn dieses Feld leer bleibt, wird das Konto des aktuellen Benutzers verwendet. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
  Hinweis: Das Kontofeld ist für den Authentifizierungstyp ApplicationIdAndSecret obligatorisch.
• 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 Get Calendars (Calendar oder Default Calendar). 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

• Enddatum – Das Enddatum der Ereignisse, nach denen Sie suchen möchten. Wenn angegeben, gibt die Suche nur Ereignisse zurück, die vor diesem Datum auftreten (Ereignisse, die an diesem Datum auftreten, werden nicht gesucht). Dieses Feld unterstützt nur DateTime Variablen. Ihr DateTime -Wert muss als TT/MM/JJJJ formatiert sein (z. B. 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 String-formatierte Werte.
• Max. Ergebnisse – Die maximale Anzahl von Ereignissen, die in Ihren Suchergebnissen zurückgegeben werden sollen. Dieses Feld unterstützt nur Integer- und Int32 -Variablen. Der Standardwert ist 50.
• Wiederkehrend zurückgeben – Wenn diese Option ausgewählt ist, werden auch Ereignisse in einer Reihe zurückgegeben. Dieses Feld unterstützt boolesche Werte.
• Suchabfrage – Wenn angegeben, werden nur Ereignisse zurückgegeben, deren Betreff, Textkörper, 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“).
• Startdatum – Das Startdatum der Vorgangs, nach dem Sie suchen möchten. Wenn angegeben, gibt die Suche nur Vorgänge zurück, die nach diesem Datum auftreten (Vorgänge, die an diesem Datum stattfinden, werden nicht durchsucht). Dieses Feld unterstützt nur DateTime-Variablen. Ihr DateTime-Wert muss als TT.MM.JJJJ formatiert sein (z. B. 30.10.2019).

Ausgabe

• Ereignisse – Ein Array von Ereignissen (Event -Objekte), die mit Ihrem SearchQuery- Wert übereinstimmen. 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 Locationusw. 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. Fügen Sie die Aktivität Search Events innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
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.