GraphQL Konfiguration

 

GraphQL in Büro+ einrichten

Hier finden sie eine Kurzanleitung für die Einrichtung der GraphQL API in Büro+ und die Konfiguration in Workflow+. Eine ausführliche Beschreibung über GraphQL finden sie in der microtech Hilfe

 

Automatisierungsdienst

Richten sie zuerst einen Automatisierungsdienst mit der Art "GraphQL-Server" ein. Weisen sie einen Benutzer mit den nötigen Rechten hinzu.

 

 

Für den Zugriff auf GraphQL benötigen wir die URL des Dienstes. Diese findet man nach dem Start des Dienstes im Ereignisprotokoll:

 

 

Die URL ist wie folgt aufgebaut:

https://<HostName oder IP>:<Port>/microtech/erp/<GraphQL Server Pfad>/graphql/v1

Über diese URL kann im Browser auch den GraphQL Playground geöffnet werden.

 

 

 

OAuth2 einrichten

Wechseln sie in Büro+ zu "Anwendungen" und richten sie dort eine neue Anwendung ein. Die Client-Secret ist nur beim Neuanlegen der Anwendung sichtbar, danach nicht mehr. Für die Anbindung in Workflow+ benötigen wir die Client-ID und die URL.

Wichtig: Kopieren sie die URL vom Automatisierungsdienst in das Feld "Redirect URI". Achtung! Achten sie auf korrekte Gross-/Kleinschreibung!

 

 

 

 

 

Konfiguration in Workflow+

Fügen sie in der Workflow+ Konfiguration unter Verbindungen eine neue Verbindung vom Typ GraphQL ein.

 

Als Authentifizierungsmethode wird OAuth2 empfohlen. Wählen sie dazu OAuth2 (Simple). OAuth2 (Fortgeschritten) wird nur benötigt, falls die verschiedenen URL's auf Seiten microtech ändern und angepasst werden müssen.

 

Einstellungen:

•Verbindungsname: Name der GQL Verbindung. Diese muss Eindeutig sein und darf keine Sonderzeichen und Leerzeichen enthalten.

•Verbinungs-URL: Komplette URL des Automatisierungsdienstes.

•Authentifizierungsart: Basic, OAuth2 (Simpel) oder OAuth2 (Fortgeschritten)

•Base URL: Basis URL des Automatisierungsdienstes

•GQL Server Pfad: Diesen kann man aus der URL entnehmen oder findet man im Automatisierungsdienst (32 Stelliger Code)

•Client ID: Client ID von der Anwendungseinrichtung.

 

Klicken sie auf Login via OAuth um die Authentifizierung vorzunemen. Dabei wird ein Authentifizierungs- und Refresh Token generiert und gespeichert.

 

 

Klicken sie auf Erlauben. Wenn alle Schritte erfolgreich durchgeführt wurden, wird auf dem Login Button ein grünes Häkchen angezeigt.