Skillnader

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

--- miner:anvandning:override [2025/09/03 08:25] – dokuadmin
+++ miner:anvandning:override [2025/11/24 16:48] (aktuell) – dokuadmin
@@ Rad 3: / Rad 3: @@
 Vissa integrationer ger möjligheten att skriva ett värde till en datapunkt, vi kallar detta för överskrivning.\\
-För att kunna skriva till datakällan behöver datapunkten i första hand vara överskrivningsbar, vissa integrationer visar detta som en tagg och till vissa integrationer behöver man logga in på datakällan för att se vilka datapunkter som är överskrivningsbara.
+För att kunna skriva till datakällan behöver datapunkten i första hand vara överskrivningsbar. Det brukar framgå via egenskapen (kolumnen) "dataAccess" som visar "rw" för de datapunkter som är överskrivningsbara. Denna information går att få fram genom en CSV-export av datapunkter i ett jobb, eller i anslutning till bläddring av en datakälla.
-För varje datapunkt som ska skrivas över så kan Miner hantera minimum- och maximumgränser, prioritet för överskrivning, varaktighet och själva värdet som ska skrivas till datakällan. Som värde kan man välja att sätta en konstant eller hämta ett värde från en annan datapunkt inom samma Miner.
-Miner stödjer i dagsläget enbart en CSV-importering för att skapa skrivpunkter. Enklaste sättet att skapa CSV-filen är att ladda ned filen overwrite-template.zip och packa upp den. \\
+För varje datapunkt som ska skrivas över så kan Miner hantera minimum- och maximumgränser, prioritet för överskrivning, varaktighet och själva värdet som ska skrivas till datakällan. Som värde kan man välja att sätta en konstant eller hämta ett värde från en annan datapunkt inom samma Miner. Nedan följer en beskrivning av varje fält:
+  * **Prioritet**: Överskrivningsreglerna försöker verkställas i prioritetsordning. Om den regeln med högst prioritet returnerar ett giltigt värde, kommer det värdet att skrivas till datapunkten med den giltighetstid som framgår det värde för "varaktighet" som har angivits för regeln. Om det returnerade värdet är felaktigt, exempelvis utanför gränserna för min- och maxvärde för regeln, blir den aktuella regeln ogiltig och Miner försöker att verkställa regeln med näst högst prioritet och så vidare.
+  * **Värde**: Här anges det värde som ska skrivas till datapunkten. Värdet kan vara en konstant, eller hämtas från en annan datapunkt (antingen avläst värde, eller attribut/metadata) från valfritt jobb i Minern.
+  * **Min-värde/Max-värde**: Här anges det förväntade minsta respektive högsta värdet som får skrivas till datapunkten. Inför varje överskrivning, kommer Miner att kontrollera värdet som ska skrivas till datapunkten mot angivna min- och maxvärdet. Om värdet hamnar utanför intervallet, kommer regeln att misslyckas och Miner kommer att försöka verkställa nästa regel enligt angiven prioritetsordning.
+  * **Varaktighet**: Här anges information om **hur gammalt** ett värde får vara. Miner kommer då att kontrollera tidstämplen för värdet och jämföra mot tidstämpeln för senaste överskrivningen från den aktuella regeln. Om värdet är för gammalt, kommer regeln att misslyckas och Miner kommer att försöka verkställa nästa regel enligt angiven prioritetsordning.
+Inställning och redigering av överskrivningsregler kan göras via det grafiska användargränssnittet, eller via import av CSV-filer.
+===== Inställning av överskrivningar via det grafiska gränssnittet =====
+{{.:pasted:20251124-160609.png?800px}}
+  * Gå in på den aktuella datapunkten som du vill skriva över och aktivera redigeringsläget. Om det inte går att aktivera redigeringsläget, kan det bero på att jobbet håller på att köras. Se till att stoppa jobbet först och försök därefter igen.
+  * Bläddra ned till avsnittet under inställning av attribut. Du ser rubriken "Överskrivningsregler", klicka på "Lägg till" [1].
+  * Fyll i de olika fälten för "Prioritet", "Värde", "Min-värde", "Max-värde" och "Varaktighet".
+    * Om du för pekaren till höger i respektive fält, ser du en symbol för förstoringsglas [2]. Om du klickar på denna symbol, dyker ett sökfält upp och du kan då söka dig fram till de Jobb som finns i Minern. Skriv del av namnet på jobbet i sökrutan, eller bläddra dig fram till jobbet och klicka på jobbets namn.
+      * Då laddas listan med alla datapunkter som ingår i jobbet. Sök eller bläddra dig fram till aktuell datapunkt och klicka på den.
+      * Du får då upp en lista, där du kan välja bland värdet för datapunkten (value), eller någon av de attribut som är tillgängliga för datapunkten [3].
+  * Om du vill ta bort någon överskrivningsregel, klickar du på knappen "Ta bort" till höger om den aktuella raden.
+  * När du är klar med inställningen av dina regler, är det bara att spara datapunkten.
+  * Glöm inte att starta jobbet igen, om du har fått stoppa ett pågående jobb för att kunna påbörja dina redigeringar.
+===== Inställning av överskrivningar via CSV-filer =====
+Enklaste sättet att skapa CSV-filen är att ladda ned filen overwrite-template.zip och packa upp den. \\
 {{ :miner:anvandning:overwrite-template.zip |}}
 \\
@@ Rad 20: / Rad 42: @@
 När vi vet vad varje kolumn betyder kan vi börja lägga till rader:
 {{:miner:anvandning:pasted:20250311-151556.png}} \\
 **<uuid.1>** ska självklart bytas ut till UUID för datapunkten som man vill överskriva. I exemplet ovan ser vi att "minValue" är satt till **0** och "maxValue" till **10**, "prio" är satt till **15**, "duration" till **30m** (30 minuter) och "value" är **4**. Med denna rad säger vi till Miner att