Get Calendars

UiPath.MicrosoftOffice365.Activities.Calendar.GetCalendars

Beschreibung

Verwendet die Microsoft Graph Get calendar- API, um die Eigenschaften und Beziehungen eines Kalenders abzurufen. Der Kalender kann der Kalender eines Benutzers oder der Standardkalender einer Office 365-Gruppe (Benutzer) sein.

Nach dem Abrufen der Kalender gibt die Aktivität ein Calendar -Objekt aus, das den Standardkalender des Benutzers (Default Calendar) darstellt, und ein Array von Calendar[] -Objekten, das alle Kalender des Benutzers darstellt (Calendars). Diese Ausgabe- Calendar -Objekte können als Eingabeeigenschaftsvariablen in den Aktivitäten Create Event und Search Events verwendet werden.

Diese Aktivität ist nicht auf das Abrufen Ihres Kalenders beschränkt. Sie können auch den Kalender eines anderen Benutzers abrufen, wenn die registrierte Anwendung im Microsoft Office 365-Scope (AnwendungsID) über Berechtigungen oder die entsprechenden delegierten Berechtigungen des Benutzers verfügt.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Kalender.Lesen

ODER

• Calendars.Read.Shared

ODER

• Calendars.ReadWrite

ODER

• Calendars.ReadWrite.Shared

ODER

• Group.Read.All

ODER

• Group.ReadWrite.All

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 and ApplicationIdAndCertificate authentication types.

• Benutzer – Die E-Mail-Adresse der Person, deren Kalender abgerufen wird. Wenn keiner angegeben ist, wird der eigene Kalender des Benutzers verwendet. Der Benutzer muss über API-Berechtigungen verfügen, um Kalender lesen zu können. Weitere Informationen finden Sie in der Einrichtungsanleitung. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

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.

Ausgabe

• Kalender – Ein Array der Kalender des Benutzers. Dieses Feld unterstützt nur Calendar[] -Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. Sie können diese Variable als Eingabevariable in anderen Aktivitäten verwenden (z. B. Create Event and Search Events).
• Standardkalender – Der Standardkalender des authentifizierten Benutzers, falls die User- Eigenschaft leer ist. Dieses Feld unterstützt nur Calendar -Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. Sie können diese Variable als Eingabevariable in anderen Aktivitäten verwenden (z. B. Create Event and Search Events).

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. Add the Get Calendars activity inside the Microsoft Office 365 Scope activity.
4. Geben Sie Werte für die Eingabeeigenschaften ein.
5. Erstellen und geben Sie die Variablen Calendar und Calendar[] für Ihre Output- Eigenschaft ein.
6. Führen Sie die Aktivität aus.
   • Ihre Eingabeeigenschaftswerte werden an die GetCalendar -API gesendet.
   • Die API gibt die Werte Calendar und Calendar[] an Ihre Ausgabeeigenschaftsvariable zurück.