{{tag>miner systemdokumentation}}
====== Komma igång ======

Den här sidan beskriver ett första grundflöde i Miner.

Målet är att skapa ett jobb som hämtar data från en input och skickar vidare data till en eller flera outputs.

===== Grundflöde =====

<mermaid>
flowchart TD
    A["1. Skapa anslutning<br/>till input"]
    B["2. Skapa anslutning<br/>till output"]
    C["3. Skapa jobb"]
    D["4. Välj input<br/>och en eller flera outputs"]
    E["5. Lägg till datapunkter"]
    F["6. Klarmarkera datapunkter"]
    G["7. Starta jobbet"]
    H["8. Kontrollera dataflöde<br/>och loggar"]

    A --> B
    B --> C
    C --> D
    D --> E
    E --> F
    F --> G
    G --> H
</mermaid>

===== 1. Skapa anslutningar =====

Börja med att skapa de anslutningar som behövs.

Minst en anslutning används som input. En eller flera anslutningar kan användas som outputs.

Exempel:

^ Roll ^ Exempel ^
| Input | Larmia, Modbus TCP, databas, Orbiq, API |
| Output | Orbiq, InfluxDB, ProptechOS, Microsoft Azure, leverantör av överstyrningstjänst, extern dataplattform |

Läs mer på [[miner:anvandning:anslutningar|Anslutningar]].

===== 2. Skapa jobb =====

Skapa ett jobb och välj jobbtyp.

Vanliga jobbtyper är:

^ Jobbtyp ^ Beskrivning ^
| Datahämtningsjobb | Hämtar data från en input och laddar upp till en eller flera outputs. |
| Beräkningsjobb | Hämtar data, bearbetar mätvärden via script och laddar upp resultat till output. |
| Graphjobb | Bygger Miners graf och laddar upp till en grafdatabas. |

Läs mer på [[miner:anvandning:jobb|Jobb]].

===== 3. Lägg till datapunkter =====

När jobbet är skapat kan du lägga till datapunkter.

I datapunktsvyn kan du normalt:

  * söka efter datapunkter
  * filtrera datapunkter
  * välja datapunkter som ska ingå
  * läsa in ett aktuellt värde
  * exportera datapunkter till CSV
  * [[.:referens:config_status|klarmarkera datapunkter]]

Läs mer på [[miner:anvandning:datapunkter|Datapunkter]].

===== 4. Komplettera attribut vid behov =====

Datapunkter kan kompletteras med attribut. Attribut används för att beskriva datapunktens sammanhang och för att styra hur informationen används i outputs.

Läs mer på [[miner:referens:metadata-attribut|Metadata och attribut]].

===== 5. Klarmarkera och starta =====

Datapunkter som ska användas behöver klarmarkeras.

Klarmarkering motsvarar normalt:

  * ''config_status=Done''

Starta jobbet när datapunkterna är klara.

Läs mer på [[miner:referens:config_status|config_status]].

===== 6. Kontrollera resultatet =====

Efter start bör du kontrollera att:

  * jobbet körs
  * datapunkter läses
  * värden sparas
  * outputs tar emot data
  * loggar inte visar återkommande fel

Läs mer på [[miner:anvandning:loggar-backup|Loggar och backup]] och [[miner:faq|FAQ]].