Live-Anbindung

So arbeiten unsere Lösungen mit microtech büro+

Zwei offizielle Wege führen in Ihr ERP: die SQL-Replikation für schnelle Listen und Kennzahlen und die microtech GraphQL-API für den aktuellen Stand und jede Änderung. Wir kombinieren beide – und schicken nur das ins Internet, was ein Portal wirklich braucht.

microtech büro+ERP-SystemGraphQL-APIOAuth 2.0 · liveSQL-ReplikationPostgreSQL · nahezu EchtzeitNETLINE-BoardDashboards · ProzesseTeamBrowsermicrotech büro+ERP-SystemGraphQL-APIOAuth · liveReplikationPostgreSQLNETLINE-BoardDashboards · ProzesseTeamBrowser
  • live lesen (GraphQL)
  • zurückschreiben & buchen (GraphQL)
  • gespiegelt in Echtzeit (SQL-Replikation)
  1. Replikation

    Ihre Daten bleiben in microtech büro+. Die Replikation spiegelt sie nahezu in Echtzeit nach PostgreSQL.

  2. SQL lesen: Listen, KPIs

    Das Board rechnet Listen und Kennzahlen direkt per SQL – ohne Exporte und ohne Last auf dem ERP.

  3. Ansicht & Aktion

    Mitarbeiter sehen den aktuellen Stand im Browser oder am Tablet und lösen dort Aktionen aus.

  4. rowRead · rowNew · fnPost

    Aktionen gehen per GraphQL zurück: Der Board-Server prüft, sperrt und schreibt – der Browser spricht nie direkt mit dem ERP.

  5. live lesen & schreiben

    Der Beleg wird in microtech angelegt und gebucht; Sekunden später steht er auch in der Replikation.

  6. verschlüsselter Push

    Portale im Internet erhalten nur einen versiegelten Auszug – ohne Zugangsdaten und ohne Weg zurück ins ERP.

  7. Ed25519-signiert

    Neue Fassungen kommen signiert, werden vor dem Einspielen geprüft und lassen sich zurückrollen.

Zwei Kanäle, ein Prinzip

GraphQL, Replikation – und beides zusammen

GraphQL-API: live lesen und zurückschreiben

Über die offizielle microtech GraphQL-API lesen unsere Boards einzelne Datensätze in Echtzeit und schreiben direkt zurück – mit allen Regeln Ihres ERP für Lager, Preise und Nummernkreise.

  • Prozessfunktionen wie fnPost (buchen), fnReverse (stornieren) und fnMoveToArchive (archivieren)
  • rowNew, rowModify und rowSave für Belege, Adressen, Projekte und Kontakte
  • rowRead und rowsRead für den aktuellen Stand direkt vor einer Aktion
  • @acquireLocks, modifyLSN und ifNotExists gegen Konflikte und Doppelbuchungen

SQL-Replikation: Kennzahlen in Sekunden

Die microtech SQL-Replikation spiegelt Ihre Daten nahezu in Echtzeit in eine PostgreSQL-Datenbank. Dort rechnen unsere Boards Listen, Ranglisten und Mehrjahresvergleiche – ohne Last auf dem ERP-Betrieb.

  • Belege, Positionen, Archiv, Adressen und Artikel in einer einzigen Abfrage
  • Archiv und laufende Belege sauber zusammengeführt – keine doppelten Umsätze
  • Nur lesende, parametrisierte Abfragen auf das Mandanten-Schema
  • Typischer Verzug im Bereich weniger Sekunden

Hybrid: jeder Kanal für das, was er am besten kann

Operative Boards nutzen beide Wege: Masse und Historie kommen aus der Replikation, der frische Einzelwert, das Schreiben und die Kontrolle über GraphQL.

  • Massenprüfung zuerst in der Replikation, nur die Nicht-Treffer live per GraphQL
  • Vor jeder Änderung den Datensatz frisch aus dem ERP lesen
  • Schreiben und Verifizieren ausschließlich per GraphQL
  • Wo nötig, überbrückt eine Überlagerung den Replikationsverzug
In Zahlen

Live-Anbindung in unseren Projekten

6Lösungen schreiben per GraphQL zurückalle sechs setzen @acquireLocks ein
5lesen zusätzlich live per GraphQLimmer als Ergänzung zur Replikation
9 + 4nutzen die SQL-Replikation9 direkt, 4 Portale indirekt per verschlüsseltem Push
19GraphQL-Tabellenvon Adressen und Belegen bis zu Dokumenten und Serviceverträgen
6Prozessfunktionen im EinsatzfnPost, fnReverse, fnMoveToArchive, fnRestoreToProjects, fnSetContents, fnGetContentsAsBase64
50+Replikationstabellen53 gezählt, untere Schranke
13Lösungen mit signierten Updatesplus eigener Update-Server
Architekturmuster

Bewährte Bausteine

Diese Muster setzen wir je nach Aufgabe ein und kombinieren sie.

Live-Lesen per GraphQL5 Projekte

Für Werte, bei denen Sekunden zählen: offene Liefermengen und Buchungsstatus direkt vor einer Buchung, aktuelle Stellplatzbestände, die Existenz einer Belegnummer in Bestand und Archiv, Dokumente und Artikelbilder.

Auswertungen über die SQL-Replikation9 Projekte

Listen, Suche, KPI-Kacheln, Mehrjahresvergleiche inklusive Archiv, Ranglisten und Kandidatenlisten für Massenläufe – schnell, ohne API-Limit und ohne Last auf dem ERP.

Hybrid: Replikation für die Masse, GraphQL für Stand und Schreiben6 Projekte

Operative Boards für Lager, Service, Touren und Abrechnung zeigen aus der Replikation an und handeln über GraphQL.

Rückschreiben und Prozesse per Mutation6 Projekte

Vorgänge mit Positionen anlegen, buchen, stornieren, archivieren und wiederherstellen, Status und Selektionsfelder pflegen, Dokumente am Datensatz ablegen – vollständig in microtech.

Verschlüsselter Push in öffentliche Boards (Data-Diode)6 Projekte

Zwei interne Boards versiegeln einen vereinbarten Datenauszug und schieben ihn per ausgehendem HTTPS an den Ingest-Endpunkt von vier Portalen. Die Portale haben weder ERP-Zugangsdaten noch einen Weg ins interne Netz.

Signierte Updates14 Projekte

Neue Fassungen werden mit Ed25519 signiert, von der Kundeninstallation per signierter Anfrage abgeholt, vor dem Einspielen geprüft und mit Backup und Rollback eingespielt – gleich für Boards mit und ohne microtech.

Öffentliche Boards

Öffentliche Boards – ohne Weg ins ERP

Kundenportale, Mitarbeiter-Self-Service und Dashboards für Großkunden müssen im Internet erreichbar sein – Ihr ERP soll es nicht. Deshalb haben unsere öffentlichen Boards keinen ERP-Zugang: Ein internes System schiebt versiegelte Datenpakete per ausgehendem HTTPS an einen Ingest-Endpunkt. Mehr Verbindung gibt es nicht.

Internes NetzInternetFirewallkein Weg zurück ins interne Netzmicrotech büro+ERP & ReplikationInternes Boardliest & versiegeltIngest-Endpunktprüft & entschlüsseltPublic Boardnur eigene DatenInternes NetzInternetFirewallkein Rückwegmicrotech büro+ERP & ReplikationInternes Boardliest & versiegeltIngest-Endpunktprüft & entschlüsseltPublic Boardnur eigene Daten
  • interne Daten
  • versiegeltes Paket (authentifizierte Verschlüsselung)
  • keine Verbindung von außen nach innen
  1. Auszug festlegen

    Das interne Board liest genau den vereinbarten Feldsatz aus der SQL-Replikation – etwa Standorte, Rechnungen oder Nachweise. Was das Portal nicht braucht, wird gar nicht erst gelesen, beim Kundenportal eines Dienstleisters zum Beispiel Preise und Bankdaten der Verträge.

  2. Versiegeln

    Das Paket wird mit libsodium crypto_secretbox (XSalsa20-Poly1305) verschlüsselt und authentifiziert, mit Zeitstempel und – je nach Portal – der Kennung des Ziel-Boards. Jeder Empfänger hat seinen eigenen Schlüssel.

  3. Ausgehend senden

    Zeitgesteuert oder bei erkannten Änderungen geht das Paket per HTTPS-POST an den Ingest-Endpunkt. Die Verbindung wird immer von innen aufgebaut – das Portal kann nie zurück ins interne Netz.

  4. Prüfen

    Der Ingest-Endpunkt prüft Schlüssel und Prüfsumme, Kennung, Gültigkeitsfenster, Größe und optional die Absender-IP. Alles andere wird abgewiesen.

  5. Atomar übernehmen

    Gültige Daten landen in einer einzigen Transaktion in der eigenen Datenbank des Portals – bei einem Fehler wird vollständig zurückgerollt.

  6. Gezielt zeigen

    Rollen, Standorte oder Personalnummern bestimmen, wer was sieht. Anfragen von Kunden gehen als Mail an Ihr Team, nicht ins ERP.

Sicherheit eingebaut

  • libsodium crypto_secretbox (XSalsa20-Poly1305): Vertraulichkeit und Echtheit in einem Schritt
  • Begrenzte Gültigkeit jedes Pakets gegen wiedereingespielte Daten
  • Kennung des Ziel-Boards gegen Fehlzustellung
  • Optionale Allowlist für die Absender-IP
  • Größenlimit und Strafverzögerung bei abgewiesenen Paketen
  • Ein Schlüssel je Empfänger, verschlüsselt gespeichert, nur auf Klick angezeigt und rotierbar
  • Gehärtete Anmeldung mit Argon2id oder bcrypt, Brute-Force-Bremse und – je nach Portal – Zwei-Faktor-Code per E-Mail
  • Strikte Content-Security-Policy und HSTS; Audit-Log für Anmeldungen und Datenempfang je nach Portal
  • Keine ERP-Zugangsdaten auf dem Internet-Server
  • Kein offener Datenbank-Port: Das Portal arbeitet mit einer eigenen, lokalen Datenbank
  • Die Verschlüsselung ist zugleich die Authentisierung – ohne gültigen Schlüssel kein gültiges Paket
  • Datensparsam: Nur der vereinbarte Ausschnitt verlässt das interne Netz
  • Aktualität nach Bedarf – vom häufigen Delta-Abgleich bis zum täglichen Lauf
  • Wartung wie bei allen Boards: signierte Updates mit Rollback

Im Einsatz bei:

NETLINE-Kundenportal: Rechnungen, Angebote, Tickets und Produkte im Self-ServiceKundenportal eines Arbeitsschutz-Dienstleisters mit Dokumenten und PflichtunterweisungenMitarbeiter-Board eines Arbeitsschutz-Dienstleisters mit persönlicher LeistungsübersichtGroßkunden-Dashboard eines Arbeitsschutz-DienstleistersSender: internes Analyse- und Automatisierungs-Board, versorgt drei PortaleSender: internes NETLINE-Board, versorgt das NETLINE-Kundenportal
Absicherung

Stabil im Betrieb

Zugriff nur serverseitig

Der Browser spricht nie mit der ERP-API. Die Boards melden sich per OAuth2 Client Credentials an und halten das Token in einem geschützten Cache.

Sperren und Konflikterkennung

@acquireLocks in allen schreibenden Lösungen, optimistische Sperre über modifyLSN und fachlicher Abgleich der angezeigten Werte – fremde Änderungen werden nicht überschrieben.

Keine Doppelbuchungen

ifNotExists, mehrstufige Dublettenprüfung und ein vor der Mutation gespeicherter Buchungsstatus; unklare Ergebnisse werden nur lesend nachgeprüft, nie blind wiederholt.

Schalter, Testmodus und Trockenlauf

Schreibpfade lassen sich zentral abschalten, auf Testadressen beschränken oder als Trockenlauf mit Vorschau ausführen.

Schonend für das ERP

Drosselung, Backoff und Circuit-Breaker bei Massenläufen; Auswertungen laufen über die Replikation statt über die API.

Nur lesend auf der Replikation

Parametrisierte SELECT-Abfragen auf das konfigurierte Mandanten-Schema; in die Replikation wird nie geschrieben.

Verschlüsselte Zugangsdaten

Kennwörter und Client-Secrets liegen mit libsodium verschlüsselt auf dem Server, getrennt vom Schlüssel, und gelangen nie in den Browser.

Protokoll und Nachvollziehbarkeit

Lauf-Protokolle, Mailberichte und – je nach Lösung – ein Protokoll aller ERP-Schreibzugriffe oder ein Journal direkt am Datensatz.

Data-Diode für das Internet

Öffentliche Portale erhalten versiegelte Datenpakete, prüfen Schlüssel, Kennung und Frische und haben keinen Rückkanal ins ERP.

Signierte Auslieferung

Update-Pakete mit Ed25519-Signatur, signierte Abrufe der Installationen, Backup vor dem Einspielen und Rollback bei Fehlern.

Für die IT

Technische Vertiefung

microtech GraphQL-API im Detail

Die GraphQL-API ist der Weg für den aktuellen Stand und für jede Änderung. Unsere Boards nutzen 18 fachliche Tabellen – von Adressen, Belegen und Positionen über Lager und Projekte bis zu Serviceverträgen und Dokumenten.

  • Anmeldung per OAuth2 Client Credentials mit Token-Cache und Erneuerung bei abgelaufenem Token
  • Schreiben mit rowNew, rowModify, rowSave und rowSaveAndModify – auch verschachtelt, etwa Ticket und erster Kontakt in einer Mutation
  • Prozessfunktionen fnPost, fnReverse, fnMoveToArchive, fnRestoreToProjects, fnSetContents und fnGetContentsAsBase64
  • Grenzen eingeplant: Archivierte Vorgänge sind per API nur les- und löschbar, Korrekturen laufen deshalb als kontrollierte Kette

SQL-Replikation im Detail

Die microtech SQL-Replikation legt je Mandant ein eigenes Schema in PostgreSQL an. Wir lesen dort nur – dafür in voller Breite.

  • Archiv und Live-Tabelle werden zusammengeführt; Gutschriften und Stornos gehen mit Vorzeichen ein
  • Selektionsfelder, Vorgangsprotokoll und von microtech gepflegte Umsatz-Aggregate direkt nutzbar
  • Verbindung mit wählbarem SSL-Modus, Kennwort verschlüsselt gespeichert und in Fehlermeldungen maskiert
  • Nach einem Schreibvorgang wird nicht blind zurückgelesen, sondern per GraphQL verifiziert oder überlagert

Öffentliche Boards per Data-Diode

Was im Internet erreichbar sein muss, bekommt keinen ERP-Zugang. Ein internes Board versiegelt den vereinbarten Feldsatz und schickt ihn nur in eine Richtung.

  • libsodium crypto_secretbox (XSalsa20-Poly1305): Verschlüsselung ist zugleich Authentisierung
  • Prüfung von Kennung, Gültigkeitsfenster, Größe und optional der Absender-IP
  • Übernahme in einer atomaren Transaktion in die eigene Datenbank des Portals
  • Kundenwünsche als Anfrage an Ihr Team – nie als Schreibzugriff ins ERP

Betrieb in Ihrem Netz

Die Boards laufen auf IIS in Ihrem Netzwerk; öffentliche Portale auf einem eigenen Server ohne ERP-Verbindung.

  • Automatismen über die Windows-Aufgabenplanung im 5-Minuten-Raster
  • Webserver-Härtung für interne Ordner und sensible Dateitypen
  • Signierte Updates mit Wartungsmodus, Selbsttest und Rollback
  • Health-Check und Protokolle für die Betreuung

Das Board-Prinzip ist nicht an microtech gebunden

Dieselbe Plattform – mit Benutzerverwaltung, Sicherheit und signierten Updates – trägt auch Lösungen mit ganz anderen Datenquellen.

  • Nur Replikation: KPI-Cockpit und Lieferplanung für einen Maschinenbauer, ohne fachliche GraphQL-Nutzung
  • Nur verschlüsselter Push: Großkunden-Dashboard ohne eigenen ERP-Zugang
  • Fremddatenbank: SOLL/IST-Wandanzeigen aus der MS-SQL-Datenbank einer Zeiterfassung
  • Telefonanlage per REST-API, Produktboard direkt auf der NAS-Ablage, Plattformen mit eigener Datenbank
Jede Datenquelle

Auch ohne microtech

Das Board-Prinzip ist nicht an ein ERP gebunden: Dieselbe Plattform verarbeitet auch Daten aus anderen Quellen.

Häufige Fragen

Fragen zur Live-Anbindung

Belastet ein Board unser ERP?
Auswertungen laufen über die SQL-Replikation, also über eine laufend aktualisierte Kopie Ihrer Daten in PostgreSQL – nicht über das ERP selbst. Die GraphQL-API nutzen wir gezielt für einzelne aktuelle Werte und für Änderungen; Massenläufe werden gedrosselt.
Wie aktuell sind die Daten?
Die Replikation folgt microtech büro+ nahezu in Echtzeit, typischerweise mit wenigen Sekunden Verzug. Wo das nicht reicht – etwa direkt vor einer Buchung –, liest das Board den Datensatz live per GraphQL. Öffentliche Portale sind so aktuell wie ihr Sendeintervall, das je Lösung festgelegt wird.
Was passiert, wenn zwei Personen denselben Beleg bearbeiten?
Schreibende Lösungen sperren Belege beim Schreiben mit @acquireLocks oder erkennen gerade geöffnete Datensätze und überspringen sie; einige prüfen zusätzlich über modifyLSN, ob sich der Stand seit dem Anzeigen geändert hat. Dann erscheint ein klarer Konflikthinweis mit dem aktuellen Stand statt eines stillen Überschreibens.
Kann ein Portal im Internet auf unser ERP zugreifen?
Nein. Öffentliche Boards erhalten nur versiegelte Datenpakete, die ein internes System per ausgehendem HTTPS schickt. Auf dem Internet-Server liegen keine ERP-Zugangsdaten, und es gibt keinen Rückkanal – Kundenwünsche gehen zum Beispiel als Anfrage per Mail an Ihr Team.
Bauen Sie auch Boards ohne microtech?
Ja. Die Board-Plattform ist nicht an microtech gebunden: Wir lesen zum Beispiel aus der Datenbank einer Zeiterfassung, sprechen die REST-API einer Telefonanlage an, arbeiten direkt auf einer NAS-Ablage oder mit einer eigenen Datenbank. Sicherheit, Benutzerverwaltung und signierte Updates bleiben dieselben.
Welche Voraussetzungen braucht es?
Je nach Lösung die microtech GraphQL-API, die SQL-Replikation oder beides sowie einen Windows-Server mit IIS in Ihrem Netz. Welche Bausteine Ihre microtech-Installation bereits mitbringt, klären wir gemeinsam im Erstgespräch.
Wie kommen Updates zu uns?
Über das NETLINE-Update-Portal: Ihre Installation holt neue Fassungen per signierter Anfrage ab, prüft die Ed25519-Signatur, legt ein Backup an und spielt das Update im Wartungsmodus ein. Schlägt der Selbsttest fehl, wird zurückgerollt.
In der Praxis

Beispiele mit Live-Anbindung

Ihre Daten. Live.

Sprechen Sie mit uns darüber, welche Kennzahlen und Abläufe Sie direkt aus microtech büro+ steuern möchten.