1. Wichtige Informationen

In diesem Beitrag können Sie nachlesen, wie Redash, ein Monitoring Tool, an die ERPNext API angebunden werden kann.

Hierbei wird sich zwar explizit auf die Anbindung an Redash bezogen, allerdings sollten sich die vorgestellten Methoden relativ ähnlich auch auf andere Monitoring Tools, wie beispielsweise Grafana, anwenden lassen.

Es lässt sich zu den vorgestellten Methoden dieses Beitrages ergänzen, dass diese verwendet werden können um nahezu jede API an Redash anzubinden (Voraussetzung hierfür ist, dass JSON als Ergebnis einer Abfrage zurückgibt).

Sollten Sie Interesse haben eine JSON Quelle mit Redash zu visualisieren, kann sich dieser Blogbeitrag ebenfalls für Sie lohnen!

Möchten Sie die Datenbank von ERPNext direkt an Redash anzubinden, bitten wie Sie unseren anderen Blogbeitrag (LINK) zu besuchen.

2. Die Anbindung

2.1. Voraussetzungen

Um die ERPNext API via Redash zu nutzen, müssen zwei Voraussetzungen erfüllt werden, bevor sich Queries erstellen lassen können. In diesem Kapitel werden diese beiden Voraussetzungen vorgestellt.

Voraussetzung 1: 

Einen ERPNext Benutzer / User der die nötigen Leseberechtigungen für die Daten besitzt, die man Abfragen möchte.

Es ist von Vorteil einen API User anzulegen und diesem die notwendigen Leseberechtigungen zu geben. Der Administrator Account funktioniert selbstverständlich auch, ist allerdings nicht zu empfehlen, da dieser zu viele Rechte für reine Leseaufgaben besitzt und auch für Methodenaufrufe über die API misshandelt werden kann.

Voraussetzung 2: 

Ein neu angelegte Redash Data Source. 

Diese kann man unter “Settings“ – „Data Sources“ – „New Data Source“ anlegen.

Unter der Auswahl welche Daten Ressource nun angeschlossen wird, wählt man nun „JSON“ aus, da die ERPNext-API Objekte immer im JSON Format zurückgibt.

Im nächsten Schritt gibt man der Daten Ressource einen Namen und setzt die Anmeldedaten des gewünschten ERPNext Benutzers ein, in unserem Fall (gute Tugend) der API Account.

Nun sind die Vorbereitungen für die eigentlichen Abfragen abgeschlossen und es kann gezeigt werden wie neue Queries in Redash mit der API als Data Source erstellt werden können.

2.2 Erstellung von Queries mit der API als Quelle

Um die API erfolgreich am besten für sich nutzen zu können, empfiehlt es sich, zumindestens in Redash, zwei Queries zu erstellen.

2.2.1 Syntax einer ERPNext Abfrage & Dokumentation

Syntax: https://ERPNEXTURL.de/api/resource/DOCTYPE ?OPTIONALE_FILTER

Dokumentation: https://frappeframework.com/docs/user/en/guides/integration/rest_api

Wir persönlich empfehlen Ihnen den Filter “limit_page_length=HIER_ANZAHL” mit anzugeben. Der Grund hierfür ist, dass die Standard ERPNext Api ohne Angabe dieses Filters, die zurückgegebene Anzahl von Objekten auf 20 reduziert.

Erste Query

Die erste Query ist die eigentliche API Abfrage und wird verwendet um die Daten von der ERPNext API abzufragen und somit in Redash vorliegen zu haben. Eine API Abfrage mit anschließender JSON Antwort kann beispielsweise so ausschauen, wie in der nächsten Abbildung.

Zweite Query

In der ersten Query wurde festgestellt, dass aus den JSON Ergebnissen keine Visualisierungen erstellt werden können. Hierfür ist nun die zweite Redash Query verantwortlich.

Die zweite Query funktioniert nun wie gewohnt in SQL Syntax. (Siehe nächste Abbildung)

Wo finde ich heraus Welche Query die richtige für „Query Nummer zwei“ ist?

Hierfür einfach in die “JSON Query” rein gehen und in der URL schauen! (Rot unterstrichen)

3. Fazit

Ziel dieses Blog Beitrages war es unser Wissen weiterzugeben und zu zeigen wie Redash an die ERPNext API angebunden werden kann. Hierfür wurden erstmals Voraussetzungen vorgestellt, welche die Basis für die im Anschluss die notwendigen Queries darstellen werden. Im Hauptteil dieses Blog Beitrages wurden Syntax von ERPNext API Anfragen, sowie die Erstellung von Query eins & zwei behandelt.

Somit wären in diesem die wichtigsten Aspekte einer Anbindung von Redash an die ERPNext API beschrieben worden. In unserem nächsten Blogbeitrag stellen wir eine andere Methode vor wie Redash an ERPNext angebunden werden kann, nämlich über die direkte Anbindung der Datenbank.

Haben Sie sonstige Fragen oder Interesse an Redash oder ERPNext? Dann zögern Sie nicht und kontaktieren Sie unser Team von K&K Software. Wir unterstützen Sie gerne in Ihren Vorhaben!

Screenshotupdate

Alle Screenshots in diesem Blogpost sind auf Version 13 von ERPNext aktualisiert.

Letzter Stand der Aktualisierung: 02.09.2021