====== Integrationer ======

Den här sidan ger en översikt över integrationsområdet i Miner och leder vidare till de sidor som beskriver respektive del mer detaljerat.

Miner används för att skapa dataflöden mellan datakällor, tekniska system, databaser, plattformar och digitala tjänster. En integration består normalt av en eller flera anslutningar, ett eller flera jobb, ett urval av datapunkter, metadata och ett eller flera mottagande system.

För en övergripande introduktion till produkten, se [[miner:oversikt|Produktöversikt]].

===== Integrationsmodell =====

Miner bygger på principen att koppla samman datakällor med mottagare.

<mermaid>
flowchart LR
    A["Datakällor<br/>styrsystem, databaser, API:er, sensorer"]
    B["Miner<br/>anslutning, jobb, metadata, leverans"]
    C["Mottagare<br/>databaser, plattformar, tjänster"]

    A --> B
    B --> C
</mermaid>

Miner ansvarar för att hämta, strukturera, komplettera och leverera data enligt den konfiguration som har gjorts i respektive integration.

===== Centrala delar =====

^ Del ^ Kort beskrivning ^ Läs mer ^
| Anslutning | Beskriver hur Miner kommunicerar med ett externt system, exempelvis via API, databas, protokoll eller filbaserat gränssnitt. | [[miner:integrationer:systemintegration|Systemintegration]] |
| Jobb | Definierar hur data ska hämtas, behandlas eller levereras. | [[miner:integrationer:systemintegration|Systemintegration]] |
| Datapunkter | Signaler, mätvärden eller objekt som ingår i integrationen. | [[miner:integrationer:onboardingprocess|Onboardingprocess]] |
| Metadata | Beskrivande information som gör datapunkter begripliga, sökbara och användbara i andra system. | [[miner:integrationer:metadata|Metadata]] |
| Provisionering | Skapande eller uppdatering av metadata, objekt eller struktur i ett mottagande system. | [[miner:integrationer:provisionering|Provisionering]] |
| Drift och arkitektur | Beskriver var och hur Miner kan köras i olika tekniska miljöer. | [[miner:integrationer:drift-och-arkitektur|Drift och arkitektur]] |
| QA | Kvalitetssäkring av datapunkter, metadata, dataflöden och provisionering. | [[miner:admin:qa|QA]] |
| Integrationsprofil | En färdig eller anpassad koppling mot ett visst system, protokoll, API eller dataformat. | [[integration:start|Dokumenterade integrationsprofiler]] |

===== Övergripande process =====

En typisk integrationsprocess i Miner kan beskrivas enligt följande:

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

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

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

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

Provisionering är endast aktuellt i vissa integrationsflöden, exempelvis när metadata ska laddas upp till en grafdatabas eller när Miner används för att provisionera data till ProptechOS.

För en mer detaljerad beskrivning av arbetsgången, se [[miner:integrationer:onboardingprocess|Onboardingprocess]].

===== Fördjupningssidor =====

==== Systemintegration ====

Sidan [[miner:integrationer:systemintegration|Systemintegration]] beskriver den tekniska integrationslogiken i Miner.

Där beskrivs bland annat:

  * anslutningar
  * jobb
  * dataflöden
  * historikhämtning
  * kontinuerlig avläsning
  * export
  * läsning och skrivning
  * integrationsprofiler

Den sidan ska användas när läsaren vill förstå hur Miner tekniskt kommunicerar med källsystem och mottagare.

==== Metadata ====

Sidan [[miner:integrationer:metadata|Metadata]] beskriver hur datapunkter kan kompletteras med metadata och hur metadata används för att skapa struktur, sökbarhet och sammanhang.

Där beskrivs bland annat:

  * egna metadatafält
  * standardiserade metadatauppsättningar
  * kundspecifika scheman
  * metadata-listor
  * klassificering
  * relationer mellan objekt
  * kunskapsmodell och export till grafdatabas

==== Onboardingprocess ====

Sidan [[miner:integrationer:onboardingprocess|Onboardingprocess]] beskriver arbetsprocessen för att identifiera, välja ut, klassificera och kvalitetssäkra datapunkter innan de tas i drift.

Där beskrivs bland annat:

  * export eller inläsning av datapunkter
  * inventering av system
  * urval av prioriterade datapunkter
  * komplettering med metadata
  * kvalitetssäkring
  * eventuell provisionering
  * start av dataöverföring

==== Provisionering ====

Sidan [[miner:integrationer:provisionering|Provisionering]] beskriver när och hur Miner kan skapa eller uppdatera metadata, objekt eller struktur i ett mottagande system.

Provisionering kan exempelvis vara aktuellt när:

  * metadata ska laddas upp till en grafdatabas
  * datapunkter ska skapas i en mottagande plattform
  * objekt och relationer ska skapas i ett externt system
  * Miner används för provisionering mot ProptechOS

==== Drift och arkitektur ====

Sidan [[miner:integrationer:drift-och-arkitektur|Drift och arkitektur]] beskriver hur Miner kan placeras och köras i olika tekniska miljöer.

Där beskrivs bland annat:

  * lokal drift nära källsystem
  * drift i kundens egen IT-miljö
  * privat moln
  * publikt moln
  * hybridmiljö
  * nätverksåtkomst
  * säkerhets- och driftsaspekter

==== QA ====

Sidan [[miner:admin:qa|QA]] beskriver hur integrationer kvalitetssäkras innan och efter driftsättning.

Där beskrivs bland annat kontroll av:

  * valda datapunkter
  * metadata
  * dataAccess och skrivbarhet
  * provisionering
  * dataflöde till mottagare
  * datakvalitet
  * kvalitetsstämplar

===== Dokumenterade integrationsprofiler =====

Dokumenterade integrationer, protokoll och anslutningstyper underhålls på sidan [[integration:start|Dokumenterade integrationsprofiler]].

Listan bäddas in nedan för att undvika att samma integrationstabell behöver underhållas på flera sidor:

{{page>integration:start&noheader&nofooter&noeditbtn}}

===== Relaterade sidor =====

  * [[miner:oversikt|Produktöversikt]]
  * [[miner:anvandning:kommaigang|Komma igång]]
  * [[miner:integrationer:systemintegration|Systemintegration]]
  * [[miner:integrationer:metadata|Metadata]]
  * [[miner:integrationer:onboardingprocess|Onboardingprocess]]
  * [[miner:integrationer:provisionering|Provisionering]]
  * [[miner:integrationer:drift-och-arkitektur|Drift och arkitektur]]
  * [[miner:admin:qa|QA]]