====== Komma igång ======

Den här guiden beskriver hur du skapar din första integration i Miner.

En typisk integrationsprocess består av följande steg:

  - Skapa en anslutning till datakällan
  - Skapa ett jobb
  - Välj vilka datapunkter som ska ingå
  - Komplettera datapunkterna med metadata
  - Starta dataöverföringen

<mermaid>
flowchart LR
    A["1. Skapa anslutning<br/>till datakälla"]
    B["2. Skapa jobb"]
    C["3. Välj datapunkter"]
    D["4. Komplettera med metadata"]
    E{"Behövs provisionering?"}
    F["5. Provisionera metadata eller objekt"]
    G["6. Starta dataöverföring"]

    A --> B
    B --> C
    C --> D
    D --> E

    E -->|Ja| F
    F --> G

    E -->|Nej| G
</mermaid>

Provisionering är endast aktuellt i vissa integrationsflöden, exempelvis när metadata ska laddas upp till en [[integration:rdf-store|grafdatabas]] eller när Miner används för att provisionera data till [[integration:proptech_os|ProptechOS]].

För en mer detaljerad beskrivning av onboarding och metadatahantering, se [[miner:integrationer:onboardingprocess|Onboardingprocess]].

===== Översikt =====

När Miner startas läses samtliga anslutningar och jobb in automatiskt.

På startsidan visas:

  * konfigurerade jobb
  * anslutningar
  * statusinformation
  * loggar
  * systemfunktioner

Via toppmenyn kan du:

  * administrera anslutningar
  * administrera jobb
  * hantera grundinställningar
  * ladda ned loggfiler
  * skapa backup av konfigurationen

===== Backup =====

Vi rekommenderar att backup skapas regelbundet, särskilt innan större förändringar görs.

Backupfunktionen skapar en zip-fil som innehåller Miner-instansens konfiguration.

===== Steg 1 – Skapa en anslutning =====

En anslutning beskriver hur Miner kommunicerar med ett externt system.

För att skapa en ny anslutning:

  - Klicka på plusknappen längst ned till höger
  - Välj ''Anslutning''
  - Välj anslutningstyp
  - Ange nödvändiga parametrar

Olika anslutningstyper kräver olika uppgifter beroende på protokoll, API eller datakälla.

Läs mer på sidan [[miner:integrationer:systemintegration|Systemintegration]].

===== Steg 2 – Skapa ett jobb =====

När anslutningen är skapad kan ett jobb konfigureras.

Ett jobb definierar:

  * vilken data som ska hämtas
  * vilka datapunkter som ska användas
  * hur data ska behandlas
  * vart data ska skickas

Nya jobb skapas via plusknappen på översiktssidan.

===== Steg 3 – Välj datapunkter =====

Efter att jobbet skapats identifieras de datapunkter som ska ingå i integrationen.

Beroende på anslutning kan Miner:

  * läsa in datapunkter automatiskt
  * importera datapunktlistor
  * låta användaren konfigurera datapunkter manuellt

===== Steg 4 – Lägg till metadata =====

För att göra datapunkterna användbara över flera system rekommenderas att de kompletteras med metadata.

Metadata kan användas för att beskriva:

  * byggnader
  * system
  * utrustning
  * funktioner
  * mätvärdestyper

Läs mer på sidan [[miner:integrationer:metadata|Metadata]].

===== Steg 5 – Provisionering =====

När datapunkterna har klassificerats och kompletterats med metadata kan de provisioneras till mottagande system.

Provisioneringen skapar den struktur som behövs för att datapunkterna ska kunna användas i målplattformen.

Läs mer på sidan [[miner:integrationer:provisionering|Provisionering]].

===== Steg 6 – Starta dataöverföringen =====

När konfigurationen är klar kan jobbet startas.

Miner börjar då läsa, bearbeta och distribuera data enligt jobbets inställningar.

===== Nästa steg =====

När den första integrationen är igång rekommenderas följande sidor:

  * [[miner:integrationer:onboardingprocess|Onboardingprocess]]
  * [[miner:integrationer:metadata|Metadata]]
  * [[miner:integrationer:systemintegration|Systemintegration]]
  * [[miner:integrationer:provisionering|Provisionering]]