Seitenhistorie

1. Grundlagen einrichten

1.) Navigieren Sie im Webbrowser in DIVERA 24/7 zu den Schnittstellen mit folgendem Weg: "Verwaltung > Einstellungen > Schnittstellen" (Bild 1)

2.) Klicken Sie dort dann auf "+ System-Benutzer", um einen neuen System-Benutzer anzulegen. (Bild 1)

3.) Im Reiter "Allgemeines" geben Sie alle nötigen Daten für das Konto ein. (Bild 2)

4.) Im Reiter "Berechtigungen" stellen Sie dann alle Rechte ein, die der Nutzer benötigt. Hier empfehlen wir für die Verwaltungsrechte die Vorgehensweise: "So wenig wie möglich, so viel wie nötig". Zur reinen Funktion werden hier nur die Rechte für den Bereich Personal benötigt, die anderen Verwaltungsrechte können deaktiviert werden. Nach der Einstellung der gewünschten Rechte klicken Sie auf "speichern. (Bild 3)

5.) Nun können Sie in der Übersicht den API-Key sehen, diesen können Sie später von hier kopieren. (Bild 4)

2. Anlegen der Anbindung in FLOW

1.) Klicken Sie als Admin oben rechts in FLOW auf das Zahnrad. (Bild 1, Punkt 1)

2.) Klappen Sie durch einen Klick auf "Globale Einstellungen" das Menü aus und klicken dann auf "Anbindungen" (Bild 1, Punkt 2)

3.) Nun Können Sie im nächsten Menü auf "+ Erstellen" klicken. (Bild 1, Punkt 3)

4.) Nun öffnet sich ein Popup zum hinzufügen einer Anbindung (Bild 1, Punkt 4). Hier richten Sie als erstes die "Schnittstelle Einsatzdaten" ein und klicken auf Weiter. (Bild 1, Punkt 5). Anschließend bestätigen Sie den Namen in dem Sie auf "Erstellen" klicken. (Bild 1, Punkt 6)

5.) Nun Werden Ihnen Daten angezeigt, diese sind sehr wichtig und werden nur einmal angezeigt, daher sollten Sie diese wie im Fenster angegeben sichern. (Bild 1, Punkt 7) 

6.) Nun Klicken Sie erneut auf "+Erstellen" um eine weitere Anbindung anzulegen, dieses mal die "DIVERA 24/7" Anbindung und klicken dann auf "weiter". (Bild 1, Punkt 8)

7.) Im nun geöffneten Fenster klicken Sie den Schieberegler auf "ein", damit man eigene Daten eingeben kann (falls Sie z.B. ein SERVER-Kunde sind, zur Veranschaulichung wird dies so weitergeführt). (Bild 1, Punkt 9)

8.) Gebe Sie nun bei Bedarf die Server-Adresse und den API-Key des System-Benutzers von Schritt 1.5 ein und klicken auf "erstellen". (Bild 2, Punkt 10)

9.) Nun Können Sie die gewünschten Adressaten auswählen, die mit DIVERA synchronisiert werden sollen und klicken dann auf "übernehmen". (Bild 2, Punkt 11)

10.) Sie können nun in der Tabelle die FLOW-Einheiten (links) mit den DIVERA-Einheiten (rechts) verbinden. Und klicken dann auf "speichern". (Bild 3, Punkt 12)

11.) Nun wird Ihnen folgende Tabelle angezeigt in der bei "Status" bei beiden "läuft" und beide Schieberegler auf "aktiv" stehen sollten. Ist dies nicht der Fall wie z.B. "Wird gestartet" muss einmal der jeweilige Schieberegler deaktiviert und dann wieder aktiviert werden. (Bild 3, Punkt 13)

3. Lua-Skript in DIVERA 24/7 anlegen

1.) Navigieren Sie im Webbrowser in DIVERA 24/7 zu den Schnittstellen der gewünschten Einheit mit folgendem Weg: "Verwaltung > Einheiten > Einheit ausklappen > Schnittstellen" und klicken dann im Reiter "Datenübergabe" bei den Lua-Scripts auf das Zahnrad. (Bild 1)

2.) Klicken Sie dort auf "+Vorlage" und geben dann in der Konfiguration einen gewünschten Namen ein und bei Bedarf eine kurze Beschreibung. Als Event wählen Sie "Erstellung" und "Aktualisierung". (Bild 2)

3.) Im Reiter "Script" geben Sie dann folgendes Script ein, speichern die über die Schaltfläche oben rechts. Danach können Sie direkt per "+Neue Instanz" eine Instanz zum Ausführen anlegen. (Bild 3)

local fetch = require "fetch"
local json = require "json"

local function isEmpty(string)
  return string == nil or string == '' or string == json.null
end

local response = fetch({
  url = "https://id.vomatec.app/connect/token",
  method = "POST",
  headers = {
    ["Content-Type"] = "application/x-www-form-urlencoded;charset=UTF-8"
  },
  body = "client_id=IHRE_ID&client_secret=IHR_SECRET&grant_type=client_credentials"
})

print("Alarm: " .. json.encode(event.payload))

local decoded = json.decode(response.body)
local token = decoded.access_token

local einsatzmittelArray = {}

if event.payload.vehicles then
    for _, vehicle in ipairs(event.payload.vehicles) do
        if vehicle.name then
            table.insert(einsatzmittelArray, {
                fahrzeugBezeichnung = vehicle.name,
            })
        end
    end
end

local ts = event.payload.ts_create
local beginnDatum = if not isEmpty(ts) then string.sub(ts, 1, 10) else ""
local beginnUhrzeit = if not isEmpty(ts) then string.sub(ts, 12, 19) else ""

local ermittelteEinsatznummer = if not isEmpty(event.payload.foreign_id) then event.payload.foreign_id else event.payload.id

local payloadEinsatzdaten = {
  einsatznummer = ermittelteEinsatznummer,
  stichwort = event.payload.title,
  meldebild = event.payload.text,
  einsatzleiter = "DIVERA247",
  istBeendet = if (event.payload.closed == "1") then true else false,
  istAktiv = if (event.payload.closed == "1") then false else true,
  beginnDatum = beginnDatum,
  beginnUhrzeit = beginnUhrzeit,
  
  einsatzort = {
    adresszusatz = event.payload.address,
    latitude = 0,
    longitude = 0
  },
  
  kurzbericht = event.payload.report,
  einsatzmittel = einsatzmittelArray
}

if not isEmpty(event.payload.lat) and not isEmpty(event.payload.lng) then
    payloadEinsatzdaten.einsatzort.latitude = tonumber(event.payload.lat) or 0
    payloadEinsatzdaten.einsatzort.longitude = tonumber(event.payload.lng) or 0
end

print("payloadEinsatzdaten: " .. json.encode(payloadEinsatzdaten))


local apiUrl = `https://api.flow.arigon.vomatec.app/ext/einsaetze/{ermittelteEinsatznummer}?api-version=1.0-extern`

local resultEinsatzdaten = fetch({
  url = apiUrl,
  method = "PUT",
  headers = {
    ["Content-Type"] = "application/json",
    ["Authorization"] = `Bearer {token}` 
  },
  body = json.encode(payloadEinsatzdaten) 
})

4.) In der Instanz vergeben Sie einen Namen und speichern dies direkt ab, da die Ausführung standardmäßig aktiviert ist. Dies wird nach dem Speichern auch direkt angezeigt. (Bild 4)

5.) Zum Testen kann man dann einen Testeinsatz auslösen, in diesem Fall nur mit dem persönlichen Benutzer als einzigen Adressaten, dies wurde dann automatisch an FLOW übertragen. (Bild 5)