Die Reporting API ermöglicht es Ihnen, Meisterplan-Daten direkt aus Microsoft Excel abzufragen. Mit nur wenigen Angaben laden Sie die Daten, die Sie für die Berichtserstellung benötigen, in eine MS Excel-Datei.
Voraussetzungen
Folgende Voraussetzungen müssen erfüllt sein, um mit MS Excel auf Meisterplan-Daten zugreifen zu können:
- Erstellen Sie ein API-Token in Ihrem Meisterplan-Benutzerprofil und speichern Sie es an einem sicheren Ort ab.
- Installieren Sie MS Excel 2019. Frühere Versionen unterstützen die notwendige Abfrage nicht.
Meisterplan-Daten in MS Excel laden
Laden Sie Ihre Meisterplan-Daten in eine Excel-Datei und erstellen Sie daraus Pivotberichte, importieren Sie sie in andere Tools oder kombinieren Sie sie mit Daten aus anderen Quellen.
Daten abfragen
Um die Daten eines API-Endpunkts in Excel zu laden, befolgen Sie die folgenden Schritte:
- Öffnen Sie eine leere Excel-Datei und speichern Sie sie ab. Wählen Sie dann im Reiter Daten > Daten abrufen > Aus anderen Quellen > Aus dem Web:
- Wählen Sie im Fenster Aus dem Web die Option Weitere aus, und geben Sie dann im Feld URL-Teile die URL des gewünschten API-Endpunktes ein. Geben Sie unter Parameter des HTTP-Anforderungsheaders "Authorization" ein und daneben "Bearer <api-token>" mit Ihrem API-Token:
- Klicken Sie auf OK, dann ruft MS Excel die Daten ab und öffnet sie im Power Query Editor, wo Sie sie nur noch in eine Tabelle umwandeln müssen.
Filtern mit Query-Parametern
Query-Parameter sind Filter, die beschreiben, welche Informationen eines API-Endpunktes abgerufen werden sollen. Das sind beispielsweise der Datumsbereich mit den Query-Paramenter startDate und finishDate, oder das gewünschte Szenario mit dem Parameter scenario. Wenn keine Filter definiert sind, werden default-Werte genommen.
So fügen Sie die Filter zu Ihrer URL für die Abfrage hinzu:
"<URL-Endpunkt>?<queryparameter>=<value>"
Zum Beispiel:
"https://api-reporting.eu.meisterplan.com/v1/milestones?startDate=2020-01-01&finishDate=2020-12-31"
Aus Datenschutzgründen empfehlen wir, die Authentifizierung wie oben beschrieben über den HTTP-Header auszuführen. Für einen schnellen Start können Sie Ihr API-Token aber auch als Teil der URL übergeben, wenn Sie sie nach diesem Schema erweitern:
"https://api-reporting.<location>.meisterplan.com/v1/<apiendpoint>?access_token=<api-token>"
Zum Beispiel:
"https://api-reporting.eu.meisterplan.com/v1/projects?access_token=api-123456789abcdefghijk"
Daten umwandeln
Der Endpunkt der Reporting-API gibt die Daten im sogenannten JSON-Format zurück. Im Power Query Editor von MS Excel können Sie die Daten in drei einfachen Schritten in eine Tabelle umwandeln.
- Klicken Sie auf List. Das ursprüngliche JSON-Objekt wird dadurch in eine Liste umgewandelt, die die Elemente der nächsten Ebene enthält:
- Klicken Sie auf Zu Tabelle, lassen Sie im neuen Fenster die Voreinstellungen stehen und klicken Sie OK. Dadurch wird die Liste in eine Tabelle umgewandelt. Zunächst enthält jede Zeile ein JSON-Objekt, das die Werte der einzelnen Spalten enthält:
- Klicken Sie auf das Doppelpfeil-Symbol oben rechts in der Spalte und klicken Sie dann OK. Damit extrahieren Sie die verfügbaren Felder und wandeln sie in Spalten der Tabelle um. Den Haken bei Ursprüngliche Spaltennamen als Präfix verwenden können Sie entfernen, bei diesen Daten ist das nicht nötig:
Empfehlenswert ist es außerdem, die Tabelle umzubennen, zum Beispiel in Projects im Bild unten:
Wenn Sie einen oder mehrere der oben beschriebenen Schritte rückgängig machen wollen, können Sie das hier tun:
Damit sind die Daten zur weiteren Verarbeitung bereit. Klicken Sie Schließen und Übernehmen oben rechts im Fenster, um die Daten zu laden und zum Hauptfenster zurückzukehren.
Wiederholen Sie diese Schritte für jeden Endpunkt, dessen Daten Sie in MS Excel laden möchten. Alle API-Endpunkte mit einer Kurzbeschreibung und der jeweiligen URL finden Sie in der API-Dokumentation.
Abfrage mit einer Berichtsvorlage
Mit unserer MS Excel-Vorlage als Einstiegshilfe laden Sie die Daten von drei Endpunkten: Projects, Allocation Slices und Resources. Zwei Pivottabellen zeigen beispielhaft, wie Sie diese Rohdaten für Ihre Berichtserstellung kombinieren können, etwa, um Allokationen nach Ressourcen oder Projekten aufzulisten.
Geben Sie nur Ihr API-Token und den Server-Standort an und klicken Sie im Reiter Daten auf Alle aktualisieren. Aktualisieren Sie dann noch die beiden Pivotblätter, oder erstellen Sie Ihre eigenen Pivot-Berichte aus den Rohdaten.