administration:omskrivningar [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
{{tag>omskrivningar}}
======Omskrivningar======

Funktionen för omskrivningar används för att justera innehåll och egenskaper för inkommande larm och andra events som tas emot av Orbiqs API för larmmottagning. Denna funktion påminner väldigt mycket om funktionen för hantering av utskicksprofiler med avseende på arbetsflödet. Funktionen för omskrivningar körs innan utskicksprofilerna, så att eventuella förändringar och tillägg som görs för larmmeddelandet kan användas för att påverka om/hur information om larm och events skickas ut.

Första vyn i funktionen ger en lista över befintliga omskrivningar. Via denna vy kan du skapa nya omskrivningar samt ändra status för befintliga regler (aktivera/inaktivera/radera).

====== Tidsintervall ======

Fungerar på samma sätt som för [[administration:larmprofiler:larmprofiler|Larmprofiler]].
====== Filter ======
Fungerar på samma sätt som för [[administration:larmprofiler:larmprofiler|Larmprofiler]].


====== Regler ======
Reglerna kan användas för att "tagga" en larmpunkt med metadata, bygga om någon del av meddelandet, lägga till information före eller efter någon del av meddelandet eller fritt söka ut och ersätta information med hjälp av [[tech:regex|Regular Expressions]].
===== Apply tags =====
Ange först vilken position som funktionen ska titta på för att verifiera villkoret för taggning. Möjliga positioner är:
  * Area: Information som kommer in om larmets områdestillhörighet)
  * Description: Information som kommer in som larmtext)
  * Page: Information som kommer in på larmets referensposition)
  * Priority: Information som kommer in som larmets prioritet)
  * Tag: Information som kommer in som larmets ämnesbeteckning/larmpunktens benämning. Denna position benämns refereras oftast till som "taggbeteckning" inom automationssammanhang. Det är inte att blanda ihop med Orbiq-funktionen för metadatamärkning/taggning som har införts i senare versioner av Orbiq. Vi kommer att ändra beteckningen "Tag" till "Datapunkt" i kommande versioner av Orbiq för att undvika risk för missförstånd.
{{:administration:larmprofiler:pasted:20230203-112809.png?800}}
{{:administration:larmprofiler:pasted:20230203-113108.png?800}}

När du har valt vilken position som ska användas för kontroll av villkoret, ska du ange själva villkoret med hjälp av fältet "Sök på fraser". I det fältet kan du antingen ange enkla sökord, eller använda dig av [[tech:regex|regular expressions]] för att ange mera avancerade textmatchningar.

Efter att du har angivit villkoret för matchning, anger du vilken metadata som ska appliceras genom att använda fältet "Tagga datapunkter". I det fältet kan du ange valfri kombination av [[administration/metadata|fritexttaggar]] och [[administration/metadata|ordlistetaggar]].

Om du vill matcha flera villkor mot olika uppsättningar av [[administration:metadata|metadata]], klickar du på knappen "Lägg till en till". Annars använder du knappan "Lägg till" för att spara din omskrivningsregel.

{{:administration:larmprofiler:pasted:20230203-182421.png?1000}}

Exemplet ovan återger ett avancerat scenario som taggar alla larmpunkter där larmtexten innehåller "brand" eller "brandlarm" som enskilda ord, med ordlistetaggen "larmkategorier=brand"
 och alla som inte innehåller orden "brand" eller "brandlarm" med "larmkategorier=ventilation".

{{:administration:larmprofiler:pasted:20230203-182951.png?1000}}

Exemplet ovan återger ytterligare ett avancerat scenario som taggar larmpunkter från en WDC, där WDC-specifik metadata kommer in via platshållaren för "Area", med ordlistetaggar för larmkategorisering i Orbiq. Observera hur det sista mönstret ser till att kategorisera alla larm som inte matchas av någon annan regel ovan som okategoriserade. Om en sådan regel inte användes, skulle alla övriga larmpunkter sakna den aktuella metadatataggningen.

{{:administration:pasted:20230210-120427.png?800}}
{{:administration:pasted:20230210-120454.png?800}}

Exemplet ovan visar hur larmpunkter som innehåller följande delar i sina beteckningar (VS, VV, VVC, KB, LB, VP, TA, FA, FF, TF, HEAT, COOL) ska taggas automatiskt med "Larmkategori: Ventilation", "Larmkategori: Värme", "Larmkategori: Kyla" eller "Larmkategori: Varmvatten".

{{tag>komplettera}}
===== Build =====
{{:administration:larmprofiler:pasted:20230203-112637.png?800}}

Med hjälp av funktionen för "Build/Konstruera", kan du bygga helt nya uttryck genom att kombinera fritext med platshållare som fylls i med data från Orbiq.
Här är ett par exempel på platshållare. Vi behöver komplettera med en fullständig lista FIXME

{{:administration:larmprofiler:pasted:20230203-184010.png?800}}

I det här exemplet (Om Description skulle väljas som objektet för regeln) och nedanstående text klistras in i fältet för "värde", skulle hela larmtexten byggas om med hjälp av en platshållare som Orbiq kommer att fylla med innehållet från larmkällans (resursens) beskrivningsfält inom systemet.
  Det här larmet kommer ifrån: [alarmsource-description]
===== Postpend, Prepend =====
Denna funktion är exempelvis användbar när du vill lägga till saknade fastighetsbeteckningar innan larmpunktens beteckning, alternativt lägga till en ytterligare kvalifierare efter larmpunktsbeteckningen.

{{:administration:larmprofiler:pasted:20230203-112724.png?800}}

Välj först vilken komponent som du vill justera. Följande alternativ finns:
  * Description (meddelandets beskrivningsfält)
  * Priority (meddelandets prioritet)
  * Tag (meddelandets ämnesfält/larmpunktens beteckning/larmtagg).

Därefter anger du vilket innehåll som du vill lägga till före eller efter den aktuella positionen. Exempelvis om du vill ange fastighetsbeteckningen "fast123_" före den larmpunktsbeteckning som skickas enligt hur filtret är inställt, väljer du "prepend", väljer larmpunkten som objekt och anger "fast123_" som värde. 
 
===== Reg replace =====
Den här funktionen påminner om regeln för "taggning" (se Apply tags/tagga ovan), med skillnaden att användaren i det andra fältet anger vilken text som ska ersättas av den text som matchas i det första fältet. Även i det här fallet går det bra att använda regular expressions för textmatchning.

I exemplet nedan ersätts en del av larmtexten med en utförligare beskrivning med hänvisning till en aktuell ruin som inte råkar synas, eftersom fältet har en fast bredd :-)

{{:administration:larmprofiler:pasted:20230203-183700.png?800}}