Zum Inhalt springen
qualido

Ereignismanagement

Vorgangs-Bedingung - Daten an Schnittstelle senden (Webhook)

Für IO-Vorgangsarten gibt es eine neue Dann-Aktion, in den Vorgangs-Bedingungen. Bei Erfüllung einer Bedingung können Vorgangs- und Formulardaten damit automatisch per HTTP an eine externe Schnittstelle übermittelt werden (Push). Die Aktion ist möglichst universell gehalten und für beliebige REST-/Webhook-Ziele nutzbar.

1.png

Funktionen:

  • Frei konfigurierbare Ziel-URL und HTTP-Methode (POST, PUT, PATCH, GET, DELETE).
  • Authentifizierung wahlweise per Bearer-Token oder API-Key (mit frei wählbarem Header-Namen) sowie beliebigen zusätzlichen Request-Headern.
  • Zwei Payload-Formate:
    • Vollständig –> strukturiertes JSON mit Vorgangs-Metadaten (inkl. Vorgangs-ID für eine spätere Rückantwort), allen Formularfeldern und einem optionalen mapped-Block.
    • Flach –> ausschließlich die zugeordneten Schlüssel (Mapping) als JSON-Body, um das exakte Zielschema Ihrer Schnittstellen zu treffen.
  • Flexibles Feld-Mapping: Jeder JSON-Schlüssel kann aus einem Formularfeld, Daten aus dem Vorgang oder einem festen Wert befüllt werden.

2.png

  • Hilfe- und Vorschau-Fenster: Gibt Infos**,** welche Daten in welchem Aufbau gesendet werden – die Vorschau erzeugt ein Beispiel für den konkreten Request, im Kontext zur jeweiligen Vorgangsart.

hilfe.png

  • Lückenlose Protokollierung: Jeder Aufruf, der Bedingung, wird mit HTTP-Status bzw. Fehlertext im Logbuch des Vorgangs vermerkt.

logbuch.png

Hinweis: Bei geschützten Vorgangsarten werden die Feldwerte für die Übertragung entschlüsselt an die Zielschnittstelle gesendet. Die Übertragung erfolgt serverseitig – das Ziel muss vom Server aus per HTTPS erreichbar sein.

Anwendungsbeispiel: Meldungen aus IO anlegen (auch per App)

Mit der neuen Vorgangs-Bedingung „Daten an Schnittstelle senden (Webhook)" lässt sich eine Vorgangsart bauen, mit der Mitarbeiter über ein einfaches Formular Meldungen erstellen können – am Desktop und in der nativen App. Der Vorgang ruft in diesem Beispiel die qualido-API auf und legt darüber die Meldung an.

Voraussetzungen

  • qualido-API-User mit Berechtigung für Meldungen (Bearer-Token).
  • IDs der Ziel-Werte zur Hand, hier z.B.: Subportal-ID, Status-Wert, Gruppen-ID(s).

1. Vorgangsart mit Formular anlegen

Ein Formular mit den Feldern, die die Meldung benötigt – z. B.:

beispiel_3.png

2. Webhook-Bedingung konfigurieren

Wenn Vorgang eingeht - Dann "Daten an Schnittstelle senden (Webhook)"

beispiel_1.png

Resultierender Aufruf

beispiel_2.png

Ergebnis

Beim Speichern des Vorgangs legt qualido (die API) die Meldung im gewählten Subportal an und gibt sie für die angegebenen Gruppen frei. Das Ergebnis (HTTP-Status) wird im Logbuch des Vorgangs vermerkt.

Tipp: Werte, die nicht aus dem Formular stammen (feste Status-, Portal- oder Gruppen-IDs), lassen sich bequem über die Mapping-Quelle „Fester Wert (Konstante)" setzen. subportals, may_groups/target_groups erwarten z.B. numerische IDs (kommagetrennt für mehrere

Weitere Einsatzmöglichkeiten (Beispiele)

Gegen die qualido-API (REST):

  • Benutzer aktualisieren – PUT /users/{id}/update: Stammdaten oder externe IDs aus einem IO-Vorgang zurückschreiben.
  • Benutzer anlegen – POST /users: Onboarding-/Antragsformular legt neuen Mitarbeiter an.
  • Adressen/Kontakte pflegen – POST / PUT /addresses: Kontaktdaten aus einem Formular anlegen oder aktualisieren.
  • Gerätewartung dokumentieren – POST /devices/{id}/savecheck: Prüf-/Wartungs-Check aus IO in die Geräteakte schreiben.
  • Meldungen anlegen – POST /messages: Meldung aus einem IO-Formular erzeugen (siehe Hauptbeispiel oben).

Gegen externe Systeme:

  • Zeiterfassung (z. B. timecount) – Vorgangsdaten an die Personal-/Zeitwirtschaft übergeben.
  • Ticket-/Servicedesk-Systeme – aus einem Ereignis automatisch ein Ticket eröffnen.
  • ERP/CRM – Datensätze in Drittsystemen anlegen oder fortschreiben.
  • Chat-Benachrichtigungen – Hinweis per Incoming-Webhook an Teams/Slack/Matrix senden.
  • Beliebige REST-Schnittstelle – frei konfigurierbare URL, Methode (POST/PUT/PATCH/…), Bearer-/API-Key-Auth und flacher JSON-Body.

https://ideas.qualido.com/feedback/270441