Skillnader

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

--- anvandning:kommaigang [2021/11/22 11:57] – dokuadmin
+++ anvandning:kommaigang [2022/11/24 17:29] – [Överskrivning] dokuadmin
@@ Rad 9: / Rad 9: @@
 **Använd gärna backupfunktionen ofta**, exempelvis innan du påbörjar förändring eller uppdatering av ett jobbs inställningar. Backupfunktionen laddar ned en kopia av minerns inställningar som en zip-fil, som du kan spara på ditt system. Om du behöver återställa en backup, behöver du just nu hjälp av oss på [[https://helpdesk.iquest.se|iquest]]. Vi planerar att införa en återställningsfunktion i kommande versioner av miner.
+===== Anslutningar =====
+Du kan skapa nya anslutningar genom att klicka på plusknappen längst ned till höger på översiktssidan och därefter välja alternativet "Anslutning". Du kan även klicka på pennsymbolen uppe till vänster på översiktssidan, till höger om rubriken "anslutningar". Därefter startar en guide som låter dig välja typ av anslutning och ange nödvändiga uppgifter med hjälp av ett formulär som skiljer sig åt beroende av vald anslutningstyp.
-===== Skapa ett jobb =====
+Om du vill redigera befintliga anslutningar, får du gå via den vänstra panelen och pennsymbolen till höger om rubriken "Anslutningar".
-  - Inne i översiktsvyn, skapa miner genom att klicka på plus knappen i högra hörnet. {{:anvandning:create-miner.png?direct&200|}}
-  - Efter att du klickat på knappen öppnas ett litet fönster. Du kan då välja att skapa ett nytt "Jobb" eller en ny "Anslutning" till en datakälla **Skapa ny**. [[anvandning:miner#datakällor|Läs mer om hur man konfigurerar datakällor.]] {{:anvandning:create-miner-p2.png?direct&200|}}
- Kom ihåg att alla fält med (*) är obligatoriska fält. **Denna sektion kommer möjligtvis inte stämma överens med din nuvarande miner version.**
+===== Jobb =====
-==== Testkör en miner ====
+Nya jobb konfigureras genom att klicka på plussymbolen nere till höger på översiktssidan.
-Efter skapat en egen miner är det dags för en testkörning. Inne i översikt vyn ser du alla miners. Nu ska vi köra igång miner.
+Redigering av befintliga jobb sker genom att först stoppa jobbet via översiktssidan, och därefter klicka på jobbet och därefter klicka sig in i jobbet för att göra ändringar och justeringar, genom att klicka på tabellraden för jobbet på översiktssidan.
-  - Bredvid önskad miner som du vill köra finns en ikon indikerar om miner körs eller inte.
+**Glöm inte att** starta jobbet igen, efter att ha gjort dina ändringar.
-  * Om miner har en röd fyrkantig stop ikon menas att miner körs, stoppa den genom att klicka på knappen.
-  * Om miner har en grön trekantig start ikon körs den inte, starta den genom att klicka på knappen.
-{{:anvandning:run-miner.png?direct&200|}}
-===== Datakällor =====
-==== Skapa en datakälla ====
-Navigera till översikt vyn, där kan du se alla datakällor genom att klicka på knappen i högra hörnet.
+I miner skiljer vi mellan fyra typer av jobb. Idag redovisas jobb av typen Poller för sig, medan Miner och Exporter visas i samma tabell. I kommande versioner av miner, kommer samtliga jobb att visas via en och samma tabell och jobbtyperna "Miner" och "Poller" kommer successivt att bakas ihop i smarta generella Jobb som kombinerar funktionerna hos "Miner" och "Poller", beroende av de möjligheter som finns hos datakällan.
-Under denna guide går vi igenom hur man skapar en datakälla av typen MySQL.
+==== Miner ====
+Vissa datakällor har egna databaser med historiklagring och tillåter bulkhämtningar av data. Med en bulkhämtning (eller batchhämtning) menas att minern kan koppla upp sig vid valfri tidpunkt och fråga efter all data som har lagrats i datakällan sedan senaste hämtningen. Förutsatt att datakällan (exempelvis ett överordnat styrsystem) kontinuerligt lagrar data från anslutna system (exempelvis DUC/PLC), så kan en minerinstans som körs inom ett annat nätverk (exempelvis inom en molnmiljö), koppla upp sig med jämna mellanrum och ladda över önskat urval av data som har lagrats inom datakällan.
-  - Efter följt steget ovanför öppnas en modal. Klicka på **skapa ny** knappen.
+Dylika jobb, som kan hämta bulkdata, kallar vi för "miners". Vi är medvetna om att det kan uppstå viss förvirring eftersom själva produkten också kallas för miner
-  - Välj sedan en datakälla från dom olika alternativen som finns.
+==== Poller ====
-  - Klicka på **NÄSTA**
+Om datakällan inte har en egen databas, alternativt inte har stöd för bulkhämtning av data, kan minern kontinuerligt och enligt inställda intervaller, läsa av varje datapunkt, bygga en egen databas samt ladda över dataavläsningarna till Orbiq. Vi pratar då om att plocka "polla" datapunkterna i jobbet. I anslutning till varje körcykel, går miner igenom samtliga datapunkter och läser av värden från datakällan i enlighet med inställd intervall. I pollerjobb finns det möjlighet att anpassa läsfrekvens och sparintervall med hjälp av följande inställningar som kan anges för var och en av datapunkterna i ett jobb.
-  - Välj en profil
+=== poll_interval_sec: Pollningsintervall ===
-  - Sätt namn för datakällan.
+Anger hur ofta data ska __läsas__ från datapunkten. Anges i hela sekunder.
-  - Sätt adressen som källan finns på.
+=== cov: ChangeOfValue ===
-  - Skriv in användarnamn för mysql
+Anger hur stor förändringen av datapunktens värde ska vara, i relation till det senast __sparade__ värdet, för att nytt värde ska sparas. Kan anges i decimalformat (**OBS! Använd punkt som decimaltecken**) om cov anges via import/export av CSV-filer.
-  - Skriv in lösenord för mysql
+=== minimal_save_interval: Största "hålet" mellan två sparade avläsningar i databasen ===
-  - Skriv in databasens namn som ska användas.
+Anger maxtiden som ska gå mellan två __sparade__ värden och anges i sekunder. minimal_save_interval rekommenderas att anges, om ni väljer att använda ChangeOfValue. Tänk er exempelvis, att en poller läser av statusen för en pumps driftindikering, där pumpen är i drift i flera dygn. Om vi inte använder "minimal_save_interval" tillsammans med "cov", så kommer miner endast att spara värden när pumpen slås på/av. I en visualisering som endast visar den senaste veckan, kommer då driftindikeringen att se ut att sakna data.
-  - Klicka på **SPARA** för att spara all data. Se bilden nedan som ett exempel.
+==== Exporter ====
-{{:anvandning:create-data-source.png?direct&200|}}
+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.
+==== Överskrivning ====
+Vissa integrationer ger möjligheten att skriva ett värde till en datapunkt, vi kallar detta för överskrivning.\\
+[[override|Du kan läsa mer om överskrivning här]]
-==== Radera datakälla ====
+==== 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:
-Navigera till [[anvandning:kommaigang#oeversikt|översikt vyn]], där kan du se alla datakällor genom att klicka på knappen i högra hörnet.
+: unknown
+: good
-  - Efter följt steget ovan, öppnas en modal. Här kan du se alla datakällor listade.
+: bad, sending interpolated value
-{{:anvandning:delete-data-source.png?direct&200|}}
+: bad, sending null
-  - Till höger om datakälla som du vill ta bort, klicka på **papperskorgen**.
+: bad, sending last good value
-{{:anvandning:delete-data-source-p2.png?direct&200|}}
+: good, overwritten value
-  - I fönstret klicka på **TA BORT**.
-{{:anvandning:delete-data-source-p3.png?direct&200|}}
-==== Redigera datakälla ====
-Navigera till [[anvandning:kommaigang#oeversikt|översikt vyn]], där kan du se alla datakällor genom att klicka på knappen i högra hörnet.
-  - Efter först steget öppnas en modal med alla datakällor, välj datakälla som ska redigeras genom att klicka på den.
-{{:anvandning:modify-data-source.png?direct&200|}}
-  - Nu visas en modal med all data från datakällan. Efter redigerat färdigt klicka på **SPARA**.
-{{:anvandning:save-modified-data-source.png?direct&200|}}
-===== Datapunkter =====
-Läs mer om [[anvandning:miner:datapunkter|datapunkter]].
-==== Översiktlig vy för miner ====
-Övergripande information om miner visas i den högra kolumnen.
-**Filter för datapunkter**
-Använd sökfunktionen för att hitta datapunkt. **OBS!** går endast att söka på datapunktens **OrigTag** d.v.s. originalbeteckning.
-==== Redigera datapunkter ====
-Redigera nuvarande datapunkter för att t.ex. sätta villkor, taggar.
-  - Gå in den miners datapunkter du vill redigera.
-  - Inuti miner visas alla datapunkter, klicka på <faicon fa fa-pencil> till höger om datapunkten.{{:anvandning:modify-data-points.png?direct&200|}}
-  - En modal öppnas med all information om datapunkten.
-  - Efter ändrat data, klicka på **SPARA** knappen längst ner i modalen.
-[[anvandning:miner:datapunkter|Läs mer detaljerat om datapunkternas fält.]]