Skillnader

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

--- administration:larmkategorisering [2023/02/21 16:47] – [Tagga via webbgränssnittet] dokuadmin
+++ administration:larmkategorisering [2023/02/21 18:31] (aktuell) – dokuadmin
@@ Rad 1: / Rad 1: @@
+{{tag>metadatamärkning, larmkategorisering, metadata, taggning, omskrivningar}}
 ====== Kategorisering av larmpunkter ======
 Det är enkelt att arbeta med kategorisering av larmpunkter i Orbiq. Kategoriseringen sker genom applicering av metadata. Kolla [[administration:metadata|här]] för en övergripande genomgång av hur funktionen för metadatasättning fungerar.
+För att kunna kategorisera larmpunkter med hjälp av metadata behöver du har rätt behörigheter i Orbiq, så om du inte kan se de funktioner som hänvisas till i denna artikel, behöver du börja med att säkerställa dina behörigheter i systemet.
 Du kan kategorisera genom att applicera metadata från fördefinierade ordlistor samt genom att använda fritexttaggning. Nedan visar vi hur du manuellt kan applicera metadata på en stor mängd befintliga larmpunkter.
 ===== Kategorisera befintliga larmpunkter ======
+==== Via användargränssnittet ====
+Det går bra att applicera metadata på larmpunkter via överblicken över aktiva larm i Orbiq. Du kan välja ett eller flera larm i listan och applicera metadata via larmpunktens översikt, eller genom att välja "Tagga valda" via menyn för mängduppgifter.
+Nedan visas hur enskilda larmpunkter kan märkas med metadata via vyn över aktiva larm.
+{{:administration:pasted:20230221-174832.png?800}}
+==== Via administratörsgränssnittet ====
 Navigera till adminsektionens överblick över larmpunkter.
 {{:administration:pasted:20230221-154127.png?800}}
-Via denna vy kan du metadatamärka enskilda larmpunkter genom att klicka på dem så att de öppnas i en modal och därefter applicera önskad kombination av metadata från termlistor och fritexttagar. När du börjar skriva på ny taggning, så presenteras en lista över befintliga matchningar. Välj då helst ur den listan för att undvika oavsiktliga felstavningar och dylikt.
+Via denna vy kan du metadatamärka enskilda larmpunkter genom att klicka på dem så att de öppnas i en modal och därefter applicera önskad kombination av metadata från [[administration:metadata|termlistor]] och fritexttagar. När du börjar skriva på ny taggning, så presenteras en lista över befintliga matchningar. Välj då helst ur den listan för att undvika oavsiktliga felstavningar och dylikt. När du taggar med begrepp ur termlistor, så visas de i formatet "Listbeteckning: termbeteckning" som exemplet nedan "Fabrikat: orbiq".
 {{:administration:pasted:20230221-155739.png?800}}
@@ Rad 27: / Rad 39: @@
 {{:administration:pasted:20230221-161716.png?800}}
-==== Tagga via webbgränssnittet ====
+=== Tagga via webbgränssnittet ===
 I det här exemplet har vi filtrerat fram alla datapunkterna för testbyggnaden "Coop" (51 st), valt att visa alla raderna i listan, klickat på knappen för att markera alla rader som syns och därefter klickat på alternativet "Tagga" och slutligen på "Utför".
@@ Rad 39: / Rad 51: @@
 När du taggar med begrepp ur termlistor, så visas de i formatet "Listbeteckning: termbeteckning" som exemplet ovan "Larmkategorier: brand".
-==== Exportera för extern taggning ====
+=== Exportera för extern taggning ===
 I det här exemplet har vi filtrerat fram alla datapunkterna för testbyggnaden "Coop" (51 st), valt att visa alla raderna i listan, klickat på knappen för att markera alla rader som syns och därefter klickat på alternativet "Exportera" och slutligen på "Utför".
@@ Rad 55: / Rad 67: @@
 När du har klickat på det önskade formatet laddas filen ned via din webbläsare. Leta upp filen och ladda upp den till din favoriteditor. I det här fallet har vi valt Google Sheets.
+I Google Sheets öppnar vi filen och kan bland annat märka att det finns en del inomhusklimatrelaterade larm från rumsgivare som vi skulle vilja märka med "Larmkategorier: klimat".
+{{:administration:pasted:20230221-172510.png?800}}
+Vi filtrerear fram de aktuella raderna och fyller i med märkningen "klimat" under rätt kolumn.
+**TIPS!** Om inte den aktuella märkningen hade funnits på någon av datapunkterna, hade vi fått lägga till en kolumn med beteckningen "Larmkategorier" och därefter fylla i med rätt kategorisering för de berörda datapunkterna.
+**OBSERVERA!** Alla fritexttaggningar hamnar i en egen kolumn med benämningen "free_text_tags". De olika fritextmärkningarna skiljs åt med kommatecken ",". Även i detta fall skulle det gå bra att lägga till en ny kolumn med benämningen "free_text_tags" och därefter fylla i med värden för fritextmärkning av de berörda punkterna.
+{{:administration:pasted:20230221-172531.png?400}}
+{{:administration:pasted:20230221-172548.png?800}}
+När märkningen med hjälp av editorn är slutförd, laddar vi ned filen i xslx-format och laddar upp den till Orbiq för uppdatering av larmpunkterna.
+Klicka då på plustecknet längst ned på sidan till höger och välj därefter alternativet "Importera larmpunkter".
+{{:administration:pasted:20230221-173249.png}}
+Leta fram den editerade filen och dra och släpp den i den markerade ytan i det fönster som öppnas.
+{{:administration:pasted:20230221-173509.png?800}}
+Du kan då se en förhandsvy av några rader i dokumentet och kan då välja att påbörja importen eller avbryta och justera innehållet vid behov inför ett nytt försök.
+Om du vill köra importen klickar du på knappen "Kör import" nere till vänster.
+{{:administration:pasted:20230221-173644.png?800}}
+Efter avslutad import får du se en sammanfattning. Om det blir några fel så kan du även se det i sammanfattningen och då ha underlag till felsökning åt åtgärd.
+{{:administration:pasted:20230221-173804.png?800}}
+Sådär, krångligare än så var det nog inte!
+=== Automatiserad metadatamärkning ===
+I vårt exempel ovan kan den uppmärksamme läsaren tänka på att vi borde göra en automatiserad märkning av klimatlarmpunkterna genom att skapa en regel för [[administration:omskrivningar#apply_tags|automatiserad märkning med metadata]] beroende av innehållet i larmpunkternas beteckningsfält. Det går naturligtvis hur bra som helst att göra!
+===== Importera kategorisering med hjälp av externa "tagglistor"=====
+Nya larmpunkter skapas inom Orbiq i anslutning till att första larmet från dessa registreras i systemet. I exemplen ovan har vi utgått från scenariot //kategorisering av larmpunkter som redan finns//. Ibland kan vi däremot vilja importera förteckningar över larmpunkter som inte redan finns i Orbiq. I dessa fall går det bra att använda admin-funktionen för export/import av larmpunkter för att istället registrera färdigkategoriserade larmpunkter inom Orbiq.
+  * Kolla ovan för att se hur du kan exportera enskilda larmpunkter
+  * Välj en larmpunkt och exportera den i Excel-format (eller som CSV om du föredrar det), för att få en importmall
+    * För enkelhetens skull, välj en larmpunkt från det aktuella systemet och den tillhörande byggnaden för att få referenserna till dessa rätt
+    * Om inte den aktuella resursen (DUC, PLC eller annan larmkälla) inte finns registrerat i Orbiq, måste du börja med att registrera systemet för att därefter fortsätta enligt denna instruktion
+  * Öppna filen i din editor (exempelvis Excel) och radera den larmpunkt som du valde i exemplet ovan
+  * Klistra in innehållet från den tagglista/databas som du har fått eller skapat
+  * Säkerställ att fältet för "Id" är tomt, samt att "published" = 1 ifall du vill att Orbiq ska registrera nya inkomna händelser på den aktuella punkten
+  * Säkerställ att du har fyllt i den rätta beteckningen på tillhörande byggnad (beteckning och/eller kortbeteckning) i enlighet med motsvarande fält för Objektet, såsom du ser det på översiktssidan för objektet, eller via Admin->Objekt och översikt
+  * Säkerställ att du har fyllt i den rätta beteckningen på tillhörande resurs (beteckning) i enlighet med motsvarande fält för resursen, såsom det framgår via Administration->Resurser->Beteckning
+  * När du är klar, exporterar du filen i lämpligt format (CSV med UTF8 teckenkodning, alternativt XSLX) och läser in den igen till Orbiq, på samma sätt som när du gör en extern datamärkning av befintliga larmpunkter
+  * De nya larmpunkterna kommer då att synas via Orbiqs admingränssnitt för larmhantering och om det blir något fel vid dataimporten kommer du att få information om det i anslutning till importen.
+{{:administration:pasted:20230221-180859.png?800}}
+I exemplet ovan importerar vi tio nya larmpunkter som vi kopplar till larmkällan för testbyggnaden "Coop". Observera att Id-fältet har lämnats tomt för att skapa nya larmpunkter istället för att uppdatera befintliga.
+  * Kolumnen "description" innehållet larmtext/beskrivning av larmpunkten
+  * Kolumnen "published" = 1 för att larmpunkten ska användas av Orbiq för nya events som matchar aktuell resurs och beteckningen för larmpunkten ska kopplas till den aktuella larmpunkten
+  * Kolumnen "object_name" är satt till ett värde som motsvarar den aktuella byggnaden såsom den är benämnd i Orbiq
+  * Kolumnen "server_name" är satt till ett värde som motsvarar den aktuella resursens beteckning i Orbiq.
+  * Kolumnerna "Larmkategorier" och "Fabrikat" är satta till de värden som gäller för kategorisering av de aktuella larmpunkterna.