miner:anvandning:override

Skillnader

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

Länk till den här jämförelsesidan

Börjar med Föregående version.
Nästa version.		 Föregående version.
miner:anvandning:override [2025/03/11 15:18] – dokuadminminer:anvandning:override [2025/11/24 16:48] (aktuell) – dokuadmin
Rad 1: Rad 1:
-==== Överskrivning ====+{{tag>överskrivning miner}} 
 +====== Överskrivning av datapunkter via Miner ======
 Vissa integrationer ger möjligheten att skriva ett värde till en datapunkt, vi kallar detta för överskrivning.\\ 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 |}} {{ :miner:anvandning:overwrite-template.zip |}}
 \\ \\
Rad 19: Rad 42:
  
 När vi vet vad varje kolumn betyder kan vi börja lägga till rader: När vi vet vad varje kolumn betyder kan vi börja lägga till rader:
 +
 {{:miner:anvandning:pasted:20250311-151556.png}} \\ {{: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  **<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 
Rad 38: Rad 62:
 När du känner dig klar med CSV-filen behöver den sparas i UTF-8 (kontrollera att det inte finns några tomma rader), vi kan därefter gå tillbaka till jobbet som har alla datapunkter som du har definierat i "target". Klicka på plus-ikonen längst ned till höger och välj sedan "Importera skrivpunkter från CSV". \\ När du känner dig klar med CSV-filen behöver den sparas i UTF-8 (kontrollera att det inte finns några tomma rader), vi kan därefter gå tillbaka till jobbet som har alla datapunkter som du har definierat i "target". Klicka på plus-ikonen längst ned till höger och välj sedan "Importera skrivpunkter från CSV". \\
 {{:miner:anvandning:pasted:20250311-151721.png}} \\ {{:miner:anvandning:pasted:20250311-151721.png}} \\
-''Observera att programvaran tar extra lång tid på sig för att verifiera och spara skrivregler. Det kan därför ta lång tid mellan att du trycker på någon knapp tills du får någon reaktion från programvaran. Vi är medvetna om detta och jobbar på att göra funktionen snabbare i kommande releaser.''\\ 
 Välj sedan den CSV-fil som du precis sparat och följ stegen tills du kommer tillbaka till jobbet. \\ Välj sedan den CSV-fil som du precis sparat och följ stegen tills du kommer tillbaka till jobbet. \\
 Du kan kontrollera de datapunkter som du satte en överskrivning på genom att trycka på den, du bör få en panel på höger sida med datapunktens detaljer. Om det ser liknande ut som på bilden nedan så har allt gått bra, du kan nu starta jobbet. Det kan vara bra att även kontrollera i datakällan om värden faktiskt skrivs till rätt punkt.\\ Du kan kontrollera de datapunkter som du satte en överskrivning på genom att trycka på den, du bör få en panel på höger sida med datapunktens detaljer. Om det ser liknande ut som på bilden nedan så har allt gått bra, du kan nu starta jobbet. Det kan vara bra att även kontrollera i datakällan om värden faktiskt skrivs till rätt punkt.\\
 {{:miner:anvandning:pasted:20250311-151728.png}} {{:miner:anvandning:pasted:20250311-151728.png}}
  • miner/anvandning/override.1741706311.txt.gz
  • Senast uppdaterad: 2025/03/11 15:18
  • av dokuadmin