Microsoft Graph ist eine umfangreiche Sammlung verschiedener RESTful-Web-APIs, mit der auf Microsoft Cloud-Dienstressourcen zugegriffen werden kann. Um Microsoft Graph mit der Aktivität “HTTP-Request senden” nutzen zu können, benötigen Sie neben einem Registrierungsschlüssel der Anwendung auch einen geheimen Schlüssel. Wie Sie dabei vorgehen, wurde bereits bei den MS SharePoint Einstellungen beschrieben, Sie können dies jedoch auch direkt in der API-Beschreibung von Microsoft Graph nachlesen.

Endpunkte:

• Microsoft Login: https://login.microsoftonline.com/<Verzeichnis-ID>/oauth2/v2.0/token

• Microsoft Graph: https://graph.microsoft.com/v1.0

Wie wird authentifiziert? Eigener Login-Endpunkt mit Token
Wo finde ich Hilfe?

• Authentifizierung: https://docs.microsoft.com/de-de/graph/auth/

• Kalender: https://docs.microsoft.com/de-de/graph/outlook-calendar-concept-overview

• Event-Beschreibung: https://docs.microsoft.com/de-de/graph/api/resources/event?view=graph-rest-1.0

Key-Features

• Verwenden von Header

• Verwenden eines Contents im Format “form-url-encoded”

• Verwenden eines durch Login ermittelten Bearer-Tokens

Voraussetzungen

• Es liegt ein Microsoft-Konto vor, um Anwendungen zu registrieren und Berechtigungen für die Anwendungen im Azure-Portal vergeben zu können

• Es wurde die Anwendung auf dem Azure-Portal registriert

• Es wurde ein geheimer Clientschlüssel auf dem Azure-Portal erstellt

• Berechtigung für die Anwendung, um auf den Kalender schreibend zugreifen zu können

Um einen Termin in den Outlook-Kalender einzutragen, müssen zwei Endpunkte konfiguriert werden. Mit dem einen Endpunkt wird über einen Login ein Bearer-Token ermittelt, welches dann für den eigentlichen Aufruf zur Terminerstellung im Header mitgegeben werden muss. Mit dem anderen Endpunkt wird dann der Termin im Kalender erstellt.

HTTP-Endpunkt für den Login

Test der Verbindung

Wurden alle Angaben korrekt eingegeben, kann die Verbindung zum Login-Endpunkt getestet werden. Hierzu muss die HTTP-Methode “POST” angegeben werden, eine relative URL ist nicht notwendig, sofern die vollständige URL bereits wie oben beschrieben angegeben wurde.

Fügen Sie Ihrem Workflow nun die Aktivität HTTP-Request senden hinzu. Damit soll zunächst ein Login erfolgen.

Ergebnis des Logins

Mit dem Senden des Requests wird ein Json-String als Ergebnis zurückgegeben. In dem Json-String befindet sich das “access_token”, welches für die weiteren Aufrufe angegeben werden muss (im Beispiel der Wert “xxx”).

{   
  "token_type": "Bearer",   
  "expires_in": 3599,   
  "ext_expires_in": 3599,   
  "access_token": "xxx"
}

Aktivität Json-Werte ermitteln

Fügen Sie nach dem HTTP-Request die Json-Werte ermitteln-Aktivität ein. Es soll aus der Antwort in strContent das access_token ermittelt werden.

Geben Sie in der Json-Aktivität die strContent-Variable an. Aus ihr soll die passende Eigenschaft ermittelt werden. Der Abfragetext lautet: “access_token”.

Im Ergebnis erhalten Sie nun die Eigenschaft access_token aus dem JSON-Ergebnis der Http-Aktivität (im Beispiel “xxx”). Komplexere Ausdrück können Sie auf der JMESPath-Seite nachlesen: https://jmespath.org/tutorial.html

Mit einem Assign können Sie das Ergebnis der strToken-Variable zuweisen: strToken = aStringList.First() oder aStringList(0).

Mit einem POST und mit Hilfe des Tokens aus dem Login-Request soll nun ein Termin im Outlook-Kalender eingetragen werden