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 (User) 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 Calendar -Ausgabeobjekte 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 (ApplicationId) über Berechtigungen oder die entsprechenden delegierten Berechtigungen vom Benutzer 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. 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 die Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate obligatorisch.
• 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 und Search Events).
• Standardkalender – Der Standardkalender des authentifizierten Benutzers, falls die Benutzereigenschaft 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 und 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. Fügen Sie die Aktivität Get Calendars innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
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.