GraphQL - Einführung in das Thema und technische Dokumentation
Was ist GraphQL (generelle Informationen)?
Frei übersetzt von der Website der "GraphQL Foundation": "GraphQL ist eine Abfragesprache für APIs und eine Laufzeitumgebung für die Erfüllung dieser Abfragen mit Ihren vorhandenen Daten. GraphQL bietet eine vollständige und verständliche Beschreibung der Daten in Ihrer API, gibt Anwendern die Möglichkeit, genau das abzufragen, was sie benötigen, und nicht mehr, erleichtert die Weiterentwicklung von APIs im Laufe der Zeit und ermöglicht leistungsstarke Entwicklerwerkzeuge."
Dadurch bietet es eine flexible und effiziente Möglichkeit, Daten aus der microtech Software über eine Schnittstelle abzufragen und zu analysieren.
Grundlegendes Konzept der Schnittstelle
Vorteile von GraphQL
Der wesentliche Vorteil von GraphQL liegt in der Einfachheit der Abfragen und der Präzision der Antworten. GraphQL liefert auf eine Abfrage exakt die angeforderten Daten; nicht benötigte Informationen werden weder geladen noch ausgegeben. Dies resultiert in einer hohen Performance bei Abfragen und Antworten, selbst bei großen Datenbanken. Das Schema ist klar strukturiert und für Entwickler gut verständlich.
FAQ von der GraphQL Foundation
Eine FAQ zu GraphQL finden Sie an dieser Stelle im Internet: Externer Link: https://graphql.org/faq/
Die Funktionsweise und generelle Anwendung von GraphQL ist auf dieser Seite der Foundation im Internet dokumentiert: Externer Link: https://graphql.org/learn/
Wofür verwendet microtech GraphQL?
Die GraphQL-Schnittstelle bildet einen essenziellen Baustein auf unserem Weg in die Cloud. Sie schafft eine einheitliche, zukunftssichere Zugangsschicht, über die unsere Software auch über das Internet genutzt werden kann. Damit legen wir die Grundlage für maximale Vernetzung, Sicherheit, Skalierbarkeit und Performance. Sie löst die COM-Aktiv-Schnittstelle ab und ermöglicht es unseren Partnern und Anwendern, mit modernen Technologien Lösungen für ihre Herausforderungen zu entwickeln.
Info
In diesem Bereich unserer microtech Hilfe erhalten Sie:
-
Einführende Informationen für Anwender der Software
-
Eine umfangreiche Entwickler-Dokumentation.
-
In der OAuth 2.0 API-Dokumentation erfahren Sie in den ersten drei Kapiteln, welche Schritte für das Anbinden von Anwendungen in microtech büro+ notwendig sind. Im weiteren Verlauf der OAuth 2.0 API-Dokumentation erhalten Sie weiterführende technische Details.
-
Informationen dazu, wie Freie Datenbank-Tabellen über GraphQL erreichbar gemacht werden, finden Sie unter Freie Datenbank-Tabellen über GraphQL nutzen.
Wie wird der GraphQL-Server in der microtech Software gestartet?
Die microtech Software stellt GraphQL-Endpunkte automatisch bereit, sobald GraphQL für einen Mandanten aktiviert wird. Eine manuelle Einrichtung von Automatisierungsdiensten ist dafür nicht erforderlich.
Ausführliche Informationen zur Einrichtung, URL-Struktur und Statusübersicht finden Sie unter GraphQL-Endpunkt - Einrichtung und Betrieb.
Info
Alternative: Manuelle Einrichtung über einen Automatisierungsdienst
Der GraphQL-Server lässt sich weiterhin manuell über einen Automatisierungsdienst einrichten. Dieser Weg wird nur noch benötigt, wenn die automatische Bereitstellung nicht genutzt werden kann; beide Varianten können parallel betrieben werden.
Der Graph-QL Server wird im Bereich der Automatisierungs-Dienste eingerichtet. Unter MEINE FIRMA - ÜBERBLICK - Register: AUTOMATISIERUNGS-DIENSTE wird der GraphQL-Server eingerichtet und verwaltet.
Weitere Infos:
An welcher Stelle in der microtech Software werden Anwendungen verwaltet?
Das Verwalten der Anwendungen erfolgt innerhalb der Software unter MEINE FIMRA - ÜBERBLICK - Register: ÜBERBLICK - Gruppe: SYSTEMEINSTELLUNGEN - ANWENDUNGEN VERWALTEN.
Auf dem Register: ANWENDUNGEN lassen sich Anwendungen hinzufügen und verwalten.
In unserer OAuth 2.0 API-Dokumentation erhalten Sie eine Einführung in das Thema OAuth 2.0 in Zusammenhang mit microtech büro+ und der Nutzung von Anwendungen über diese API. Im Kapitel Anwendung einrichten (OAuth-Client) erhalten Sie auf dieser Seite eine Benutzerdokumentation, welche die Einrichtung der Anwendungen in der Software beschreibt. Für erfahrene Anwender und insebsondere Entwickler finden Sie innerhalb dieser Dokumentation weitere technische Details und Hinweise zur API.
Übersicht über dieses Kapitel
In diesem Kapitel erhalen Sie wertvolle Grundlagen für die Nutzung der GraphQL-Schnittstelle.
Grundlagen und Einstieg
-
GraphQL Entwickler Dokumentation - Abfragen (Queries) - Zentrale Referenz für Abfragen: Tabellenzugriff, Sortierfolgen, Filter, Verlinkungen, Paginierung, Direktiven und System-Felder.
-
GraphQL Entwickler Dokumentation - Mutationen (Mutations) - Aufbauend auf den Abfragen: Datensätze anlegen, ändern, kopieren und löschen, Transaktionsmodell und Sperrenverwaltung (
@acquireLocks). -
GraphQL Beispiel Queries - Sammlung fertiger Beispielabfragen, u. a. zu Lagerbeständen, Mindestmengen und Lieferanteninformationen.
-
GraphQL FAQ - microtech ERP System - Antworten auf häufig gestellte Fragen zu Funktionsumfang, Berechtigungen, Datenkonsistenz und Integrationsmöglichkeiten.
Authentifizierung und Zugriff
-
OAuth 2.0 API-Dokumentation - Vollständige Referenz zu OAuth 2.0: Anwendungen einrichten, Authorization Code und Client Credentials Flow, Token-Verwaltung, Sicherheit und Fehlerbehandlung.
-
GraphQL-Endpunkt - Einrichtung und Betrieb - Automatische Bereitstellung der GraphQL-Endpunkte pro Mandant, URL-Struktur, Statusübersicht und Betrieb.
-
OAuth 2.0 Bearer Token Generator für microtech büro+ - Interaktives Browser-Tool zum Erzeugen von Bearer Tokens für Entwicklung und Tests.
-
Partner-Apps - Anbindung zertifizierter Partner-Lösungen an die microtech ERP über GraphQL und OAuth 2.0.
KI-Integration
- Claude mit microtech GraphQL verbinden (MCP) - Schritt-für-Schritt-Anleitung zur Anbindung von Claude Desktop und Claude Code über das Model Context Protocol (MCP).
Praxisbeispiele
-
Praxisbeispiel: Adressen, Anschriften und Ansprechpartner verwalten (GraphQL) - Vollständiges Beispiel zum Lesen, Anlegen, Ändern und Löschen verschachtelter Adressdaten inkl. Paginierung und Filterung.
-
Praxisbeispiel: Offene Posten und Beleg eines Kunden (GraphQL) - Beispiel zur Abfrage von Offenen Posten mit Bezahlstatus und zum Herunterladen zugehöriger Belegdokumente.
Vorgänge
-
Vorgänge in microtech GraphQL - Funktionsreferenz - Anlegen, Buchen, Stornieren, Wandeln und Archivieren von Vorgängen sowie Projekten.
-
Vorgänge für externe Bearbeitung per GraphQL sperren und entsperren - Workflow zum exklusiven Sperren und Entsperren von Vorgängen für externe Prozesse.
Funktionsreferenzen und Parameter
-
Funktionsreferenz: Übergreifende fn-Funktionen - Text-, Datums-, Konvertierungs- und Nachschlagefunktionen für
slowFilterund Expression-Parameter. -
ERP-Parametertabellen per GraphQL auslesen - Übersicht der wichtigsten Konfigurations- und Parametertabellen (Vorgangsarten, Zahlungsbedingungen, Steuer, Einheiten u. v. m.).
-
Freie Datenbank-Tabellen über GraphQL nutzen - Voraussetzungen und Vorgehen, um selbst angelegte Freie Datenbank-Tabellen über GraphQL erreichbar zu machen.
