Datenquellen
Microsoft Graph API Extension
Um die Datenquelle Microsoft Graph API Extension nutzen zu können sind folgende Mindestvoraussetzungen notwendig:
- Microsoft Konto und gültige Office 365 Lizenz inkl. Microsoft Graph
- Microsoft Azure Konto
Damit du loslegen kannst musst du zuerst eine App in Microsoft Azure registrieren.
Eine App zur Kommunikation zwischen Peakboard und Microsoft Graph registrieren
- Logge dich in dein Azure-Konto ein und wähle den Azure-Dienst Azure Active Directory aus.
- Wähle im linken Menü den Punkt [App-Registrierungen] (1) aus und klicke oben auf das Plus-Symbol [Neue Registrierung] (2).
- Vergib einen passenden Namen (3) und wähle als unterstützten Kontotyp den Typ [einzelner Mandant] (4) aus.
- Unter Umleitungs-URI wählst du [Öffentlicher Client/nativ (mobil und Desktop)] (5) aus.
- Klicke auf den Button [Registrieren] (6).
Anpassen der App
- Die Übersicht der App öffnet sich nach der Registrierung automatisch. Wähle im Menü links den Punkt [Authentifizierung] (1)
- Setze unter [Erweiterte Einstellungen] den Schieberegler [Öffentliche Clientflows zulassen] auf [Ja] (2).
- Klicke nun auf den Button [Speichern] (3).
- Wechsle über das Menü links in den Bereich [API-Berechtigungen] (4) um diese zu prüfen. Welche Rechte jeweils benötigt werden findest du in der Microsoft Graph Dokumentation zur jeweiligen Abfrage.
- Nimm entsprechende Anpassungen vor falls nötig oder hole dir von einem Administrator noch die benötigten Administratoreinwilligungen ein.
- Wechsle nun über das Menü links in den Bereich [Übersicht] (5).
- Für den nächsten Schritt benötigst du die IDs [Anwendungs-ID (Client)] (6) und [Verzeichnis-ID (Mandant)] (7) sowie den geheimen Clientschlüssel (8). Wenn du die App neu registriert hast musst du diesen erst noch erzeugen.
Microsoft Graph API Extension installieren
Nach dem Download und der Installation der Microsoft Graph API Extension stehen dir unter [Datenquellen] drei verschiedene Zugriffsarten (1) zur Verfügung.
Microsoft Graph User-Delegated Access
Bei dieser Variante greifst du auf die Microsoft Graph Daten mit dem Namen und den entsprechenden Rechten eines bestimmten Benutzers zu. Um diese Variante zu nutzen musst du dich mit deinem gewünschten Nutzer authentifizieren. Es handelt sich dabei um die am häufigsten benötigte Art des Zugriffs.
Microsoft Graph App-Only Access
Im Unterschied zum user-delegated access greifst du bei dieser Variante nur mit dem Namen und den Rechten der App auf die Daten zu. Dabei ist nicht jedes mal eine separate Authentifizierung notwendig.
Microsoft Graph User Functions
Die User Functions nutzt du wenn es darum geht bestimmte Funktionen aufzurufen um eine Aktion auszuführen anstatt nur eine Liste abzufragen. Zur Nutzung dieser Variante ist wieder eine Authentifizierung nötig wie beim User-Delegated Access.
Microsoft Graph Explorer
Da die Auswahl an Abfragen und Funktionen extrem umfangreich ist bietet Microsoft ein praktisches Tool um die Microsoft Graph Funktionen zu durchsuchen und zu testen, den Graph Explorer.
In der dazugehörigen Dokumentation findest du außerdem viele Beispiel-Abfragen die du nutzen kannst.
Eine Abfrage im Peakboard Designer hinzufügen
Als Beispiel rufen wir einen Nutzungsreport aus Office 365 ab. Der Report listet die aggregierte Outlook-Aktivität pro Tag für das gesamte Unternehmen auf. Reports wie dieser sind nützlich um beispielsweise Systemadministratoren Einblicke in die Vorgänge in ihrem Office 365 Tenant zu geben. Hier findest du die zugehörige Dokumentation
Datenquelle konfigurieren
Für die Abfrage nutzt du am besten den App-Only Access. Stelle sicher dass du der App die entsprechende Berechtigung [Reports.Read.All] gegeben hast. Gib der Datenquelle zuerst einen Namen. Trage deine IDs und das Client Secret in die entsprechenden Felder ein (1) und verbinde dich mit dem [Connect] Button. Setze dann den Haken bei [Custom Call] (2) und füge die URL für den Report aus dem Graph Explorer ein (3):
https://graph.microsoft.com/beta/reports/microsoft.graph.getEmailActivityCounts(period='D30')
Mit dem zusätzlichen Parameter [period=‘D30‘] rufen wir die Daten der letzten 30 Tage ab. Klicke auf [Check] (4) um zu verifizieren, dass die Abfrage möglich ist. Nach positiver Bestätigung klickst du auf [Daten laden] im rechten Bereich um dir eine Vorschau der Daten anzeigen zu lassen.
Daten für die Nutzung vorbereiten
Die Daten werden im Falle von Reports, oder allen Abfragen die in Form einer csv-Datei geliefert werden, als String geliefert. In diesem Zustand ist es schwierig sie in einem Diagramm weiterzuverarbeiten. Zur Vorbereitung der Daten legst du einen Dataflow auf der Datenquelle an (5).
Mit diesem Dataflow konvertierst du den Datentyp der Spalten [Send] (6) und [Receive] (7) von String zu Number.
Danach löschst du alle nicht benötigten Spalten, also alle außer [Report_Date], [Send] und [Receive]. Die Daten sind nun aufbereitet für die weitere Nutzung.
Diagramm erstellen
Für die Darstellung der Daten eignet sich beispielsweise eine Mischung aus Flächendiagramm (8) für die gesendeten E-Mails und Liniendiagramm (9) für die empfangenen E-Mails.
Die X-Achse ist dabei jeweils das Datum. Die restliche Konfiguration ist selbsterklärend und dank der gut vorbereiteten Daten einfach umzusetzen.
Wenn alles geklappt hat sieht das Ergebnis beispielsweise so aus
