anvandning:kommaigang

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.
anvandning:kommaigang [2022/11/24 16:40] – [Writer] dokuadminanvandning:kommaigang [2023/09/12 12:02] (aktuell) – [Quality Stamp (qstamp)] dokuadmin
Rad 37: Rad 37:
 ==== Exporter ==== ==== Exporter ====
 Exporterjobb är en typ av Minerjobb, där dataströmmen går åt motsatt håll. Data hämtas då från Orbiq och skickas till en extern datakälla. Exporterjobb är en typ av Minerjobb, där dataströmmen går åt motsatt håll. Data hämtas då från Orbiq och skickas till en extern datakälla.
-==== Writer ==== +==== Överskrivning ==== 
-Jobb av typen Writer kan integreras i andra jobb, där miner stödjer skrivning till den aktuella datakällan. +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. +[[override|Du kan läsa mer om överskrivning här]]
-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. \\ +
-{{ :anvandning:overwrite-template.rar |}} +
-\\ +
-Öppna sedan CSV-filen i den textredigeraren du föredrar, exempelvis Microsoft Excel eller Notepad. Öppna/spara gärna i UTF-8 om möjligt. \\ +
- {{:anvandning:overwrite1.png|}} +
-Du borde få något liknande som på bilden ovan.  +
-Varje rad i CSV-filen kan ses som en överskrivningsregel. Följande är en beskrivning för varje kolumn i CSV-filen: +
-  * target: Datapunkten som vi ska skriva till. +
-  * minValue: Minimumgränsen som "value" kan ha för att överskrivningsregeln ska bli giltig. +
-  * maxValue: Maximumgränsen som "value" kan ha för att överskrivningsregeln ska bli giltig. +
-  * prio: Ordningen för överskrivningsregeln. Ju högre siffra desto högre prioritet. +
-  * duration: Varaktigheten för överskrivningen. Om datakällan har stöd för en varaktighet vid överskrivning skickas "duration" till datakällan för att meddela om hur länge vi vill att värdet ska vara giltigt. Om datakällan inte har stöd för varaktighet används "duration" tillsammans med "minValue" och "maxValue" för att se om "value" ska skrivas till datapunkten. +
-  * value: Värdet som ska skrivas till "target". Vi kan ange antingen en konstant eller värdet från en befintlig datapunkt i samma Miner.  +
- +
-När vi vet vad varje kolumn betyder kan vi börja lägga till rader: +
-{{:anvandning:overwrite2.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  +
-  För datapunkten <uuid.1> ska vi sätta värdet 4 i 30m om värdet är mellan 0 och 10. +
-Detta är den mer enkla implementationen av en överskrivningsregel, det kan göras lite mer komplicerade regler: \\ +
-{{:anvandning:overwrite3.png|}} \\ +
-Här har vi lagt till en regel och ändrat föregående regel så att den hamnar utanför "minValue" och "maxValue". +
-Reglerna säger nu följande: +
-  Om värdet 11 är mellan 0 och 10 ska vi skriva värdet till datapunkten <uuid.1> och ska vara giltig i 30m,  +
-  annars ska värdet 5 skrivas till <uuid.1> och vara giltigt i 30m om värdet är mellan 0 och 10. +
-I exemplet ovan är det alltså "prio" som sätter ordningen för överskrivningsreglerna. \\ +
-Vi kan även lägga till fler datapunkter att skriva till: \\ +
-{{:anvandning:overwrite4.png|}} \\ +
-Observera att "prio" limiteras till varje unika "target", i exemplet ovan gäller fortfarande samma prioritering för de två reglerna med **<uuid.1>**. Den nya raden med **<uuid.2>** får sin egna gruppering med "prio". \\ +
-För att visa en bredare funktionalitet kan vi göra på följande sätt: \\ +
-{{:anvandning:overwrite5.png|}} \\ +
-Här har vi gjort om regeln för **<uuid.2>** så att den hämtar en tagg från en annan datapunkt och sätter det som "minValue" och "maxValue", i exemplet har vi tagit helt ologiska taggar; meterkey och fastighet. Vi tog också ett värde från en annan datapunkt. Observera att vi behöver ha '[' i början och ']' i slutet när vi refererar till en datapunkt. Datapunkten måste existera inom Minern. +
 ==== Quality Stamp (qstamp) ==== ==== Quality Stamp (qstamp) ====
 Varje värde för en datapunkt skickas med en stämpel som informerar om kvalitén på värdet. Nedan listas samtliga qstamps som skickas med avläsningarna: Varje värde för en datapunkt skickas med en stämpel som informerar om kvalitén på värdet. Nedan listas samtliga qstamps som skickas med avläsningarna:
Rad 80: Rad 48:
     4: bad, sending last good value     4: bad, sending last good value
     5: good, overwritten value     5: good, overwritten value
 +    6: bad, sending extrapolated value
 +    7: bad, untrusted value
  • anvandning/kommaigang.1669304408.txt.gz
  • Senast uppdaterad: 2022/11/24 16:40
  • av dokuadmin