Skillnader

Här visas skillnader mellan den valda versionen och den nuvarande versionen av sidan.

--- administration:dedu-koppling [2023/03/08 17:54] – dokuadmin
+++ administration:dedu-koppling [2025/04/01 08:52] (aktuell) – [Uppsättning av API och behörigheter i DeDU] dokuadmin
@@ Rad 5: / Rad 5: @@
 ===== Börja med att sätta upp en DeDU koppling till ett företag i Orbiq. =====
-Gå in på Administration -> Användare -> Företag och skapa ett företag genom att klicka på den gröna knappen längst ned till höger. Vi har lagt funktionen här eftersom vi ville möjliggöra för våra kunder att kunna skicka automatiska ärenden för larm till olika underleverantörer. Genom att klicka i ”DeDU”-checkboxen väljer ni att lägga till en DeDU koppling.
+Gå in på //Administration// -> //Användare// -> //Företag// och skapa ett företag genom att klicka på den gröna knappen längst ned till höger. Vi har lagt funktionen här eftersom vi ville möjliggöra för våra kunder att kunna skicka automatiska ärenden för larm till olika underleverantörer. Genom att klicka i ”DeDU”-checkboxen väljer ni att lägga till en DeDU koppling.
   - Under //DeDU API URL// fyller ni i URL:en. Det är vanligtvis https://api.dedu.se.
   - Under //DeDU API nyckel// fyller ni i API nyckeln, denna får ni från DeDU. Genom att klicka på "Ladda API" ska informationen fyllas i nedan.
@@ Rad 27: / Rad 27: @@
   - Under //DeDU prioritet// väljer du vilken prioritet ärendet ska ha.
   - Under //DeDU kategori// väljer du kategorin för ärendet.
-  - Genom att klicka i //Skapa ej ett nytt ärende ifall okvitterat ärende för larmet redan existerar// hindrar du Orbiq från att skicka flera ärenden på samma larm inom 30 dagar. Om det finns ett ärende som är äldre än 30 dagar kommer larmet fortfarande att skicka ett nytt ärende. Denna funktion är utvecklad för att förhindra att flera ärenden skickas på mindre larm, som tillexempel uppkopplingsavbrott som skickar larm så länge avbrottet pågår.
+  - Genom att klicka i //Skapa ej ett nytt ärende ifall okvitterat ärende för larmet redan existerar// hindrar du Orbiq från att skicka flera ärenden på samma larm inom 30 dagar. Om det finns ett ärende som är äldre än 30 dagar kommer larmet fortfarande att skicka ett nytt ärende. Här har vi tänkt oss två olika scenarion:
+    * Scenario 1: Ett akut larm har gått. Då vill vi att det skapas ett ärende oavsett huruvida det har skapats ett identiskt ärende inom 30 dagar så att det kan lösas så snart som möjligt. Ett exempel på detta är ett hiss-larm som gått.
+    * Scenario 2: Ett lågprioriterat larm pågår och skickar nya larm var 10:e minut. Då vill vi inte att hundratals eller tusentals ärenden ska skapas, utan det är först efter 30 dagar som det skapas **ett** nytt ärende. Ett exempel på detta är om en sensor har tappat kontakten och det skickas ett heartbeat-larm.
   - Klicka på //Lägg till// för att skapa profilen.
   - Här kan ni skicka en testärende.
   - Här redigerar ni en existerande profil. Profilinformationen kommer då att synas i de överstående fälten och //Lägg till// byts ut mot //uppdatera//.
   - Här kan ni ta bort existerande profiler
+  - Här kan ni se informationen för den existerande profilen.
 {{:administration:pasted:20230308-163436.png}}
+===== Aktivera larmprofilen =====
+Gå in på //Administration// -> //Larmprofiler// och klicka på den gröna knappen längst ned till höger för att skapa en ny larmprofil. Ställ in //Tidsintervall// och //Filter// på respektive tabb och gå sedan till //Mottagare//.
+  - Under //Tillgängliga mottagare// väljer ni det företag ni skapade.
+  - Under //Kontaktalternativ// väljer ni den DeDU-profil ni skapade.
+Om ni lägger till mail- eller SMS-utskick kan ni lägga till att något ska skickas via en annan kanal genom att klicka på plusset till höger, men med DeDU integrationen går detta inte att göra eftersom denna inställning görs under DeDU profilen. Ni kan däremot lägga till mail- eller SMS-utskick som paralell händelse till DeDU ärendet och när ni gör det skickas även en referens till DeDU ärende-ID:et med i utskicket för uppföljning av ärendet.
+När detta är gjort kan ni spara larmprofilen högst upp till vänster.
+===== Format och innehåll för ärenden som skapas i DeDU =====
+Innehållet för ärende som skapas i DeDU är i formatet:
+"larmpunktens beteckning" - "larmhändelsens text"
+===== Uppsättning av API och behörigheter i DeDU =====
+För att funktionen ska fungera, behöver ett API-konto sättas upp i DeDU med rätt behörigheter och tillhörande API-nyckel som kan användas av Orbiq. Följande DeDU-behörigheter bör räcka:
+^Behörigheter^^^
+|Professions|Hämta utförare|GET|
+|Regions|Hämta regioner|GET|
+|Properties|Hämta fastigheter|GET|
+|Structures|Hämta byggnader|GET|
+|SpatiSystems|Hämta utrymmessystem (lokaler/lägenheter)|GET|
+|Spaces|Hämta utrymmen|GET|
+|Elements|Hämta elements (system/objekt)|GET|
+|TaskTypes|Hämta ärendetyper|GET|
+|TaskPriorities|Hämta prioritet ärenden|GET|
+|TaskSources|Hämta ärendekällor|GET|
+|Tasks|Skapa ärende|POST|
+|Tasks|Uppdatera ärende|PATCH|
+|Resources|Hämta valda resurser|GET|
+|UploadFiles|Ladda upp fil|POST|
+|DownloadFile|Ladda ner fil|GET|
+|DisplayFile|Visa fil|GET|
+|Billboards|Hämta anslagstavlan|GET|
+|TaskCategories|Hämta kategorier/underkategorier|GET|
+|TaskWaitLists|Skapa ärende i väntelista|POST|
+|AcknowledgmentJournals|Skapa kvitteringsjournal|POST|
+|Tasks|Hämta ärenden|GET|