Skillnader

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

--- miner:integrationer [2026/06/04 10:53] – [Övergripande process] dokuadmin
+++ miner:integrationer [2026/06/12 10:59] (aktuell) – raderad dokuadmin
@@ Rad 1: / Rad 1: @@
-====== Integrationer ======
-Den här sidan ger en översikt över hur integrationer fungerar 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 i Miner 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.
-En datakälla kan exempelvis vara ett styrsystem, en databas, en mätplattform, ett API eller en extern tjänst. En mottagare kan exempelvis vara en tidsseriedatabas, en grafdatabas, en analysplattform, ett datalager eller en annan digital tjänst.
-<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 i en integration =====
-En integration i Miner består vanligtvis av följande delar:
-^ Del ^ 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 datapunkterna begripliga, sökbara och användbara i andra system. | [[miner:integrationer:metadata|Metadata]] |
-| Provisionering | Uppladdning eller skapande av metadata, objekt eller struktur i ett mottagande system. | [[miner:integrationer:provisionering|Provisionering]] |
-| Dataöverföring | Det löpande dataflödet från datakälla till mottagare. | [[miner:integrationer:systemintegration|Systemintegration]] |
-| Integrationsprofil | En färdig eller anpassad koppling mot ett visst system, protokoll, API eller dataformat. | [[integration:lista|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]].
-===== Datakällor =====
-Miner kan användas för att samla in data från flera typer av datakällor.
-Exempel på datakällor:
-  * styr- och övervakningssystem
-  * mätinsamlingssystem
-  * IoT-plattformar
-  * sensorer och gateways
-  * databaser
-  * externa API:er
-  * väder- och marknadsdata
-  * andra system som innehåller historik, mätvärden, larm eller metadata
-Vilka funktioner som är tillgängliga beror på vad källsystemet stödjer. Vissa system kan exempelvis tillåta historikavläsning, medan andra kräver kontinuerlig pollning av datapunkter.
-Läs mer på sidan [[miner:integrationer:systemintegration|Systemintegration]].
-===== Mottagare =====
-Miner kan leverera data till ett eller flera mottagande system.
-Exempel på mottagare:
-  * tidsseriedatabaser
-  * relationsdatabaser
-  * analysplattformar
-  * visualiseringsverktyg
-  * grafdatabaser och triplestores
-  * datalager
-  * IoT- och dataplattformar
-  * externa API:er
-  * AI- och optimeringstjänster
-Samma datakälla kan leverera data till flera mottagare och flera datakällor kan samlas i samma mottagande plattform.
-===== Jobbtyper och dataflöden =====
-Miner kan hantera olika typer av dataflöden beroende på källsystemets egenskaper och syftet med integrationen.
-Exempel på dataflöden:
-  * hämtning av historisk data från system med egen lagring
-  * kontinuerlig avläsning av datapunkter
-  * export av data från en plattform till ett externt system
-  * överföring av metadata till mottagande system
-  * skrivning eller överskrivning tillbaka till källsystem, om integrationen stödjer det
-Detaljer kring jobbtyper, dataflöden, läsning, skrivning och systemstöd beskrivs på sidan [[miner:integrationer:systemintegration|Systemintegration]].
-===== Metadata i integrationer =====
-Metadata används för att göra data begriplig och användbar utanför det system där den skapades.
-Metadata kan beskriva exempelvis:
-  * byggnad
-  * system
-  * komponent
-  * datapunkt
-  * funktion
-  * mätstorhet
-  * enhet
-  * placering
-  * ursprung
-  * relationer mellan objekt
-Miner är inte låst till någon särskild metadatauppsättning. En integration kan använda egna metadatafält, standardiserade scheman, kundspecifika mallar eller metadata som hämtas från andra system.
-Vissa anslutningar kan även tillhandahålla metadata-listor, klasslistor eller mallar som förenklar arbetet med att klassificera datapunkter.
-Läs mer på sidan [[miner:integrationer:metadata|Metadata]].
-===== Onboarding av datapunkter =====
-I många integrationsprojekt behöver datapunkter gås igenom, väljas ut och kompletteras innan dataöverföringen startas.
-Onboarding omfattar vanligtvis:
-  - export eller inläsning av datapunkter
-  - inventering av system och signaler
-  - urval av prioriterade datapunkter
-  - komplettering med metadata
-  - kvalitetssäkring
-  - eventuell provisionering
-  - start av dataöverföring
-För detaljerade arbetssteg, se [[miner:integrationer:onboardingprocess|Onboardingprocess]].
-===== Provisionering =====
-Provisionering innebär att Miner skapar eller uppdaterar metadata, objekt eller struktur i ett mottagande system.
-Provisionering kan exempelvis användas när:
-  * metadata ska laddas upp till en grafdatabas
-  * datapunkter ska skapas eller uppdateras i en mottagande plattform
-  * Miner används för provisionering mot ProptechOS
-  * ett mottagande system behöver objekt, relationer eller klassificeringar innan dataöverföringen startar
-Provisionering är inte nödvändig i alla integrationer. Om mottagaren endast ska ta emot mätvärden eller tidsseriedata kan dataöverföringen ofta startas utan ett separat provisioneringssteg.
-Läs mer på sidan [[miner:integrationer:provisionering|Provisionering]].
-===== Dokumenterade integrationsprofiler =====
-Dokumenterade integrationer, protokoll och anslutningstyper bör underhållas på en separat sida, så att samma tabell kan återanvändas på flera ställen utan att kopieras.
-Den centrala listan bör ligga på sidan:
-  * [[integration:lista|Dokumenterade integrationsprofiler]]
-Om DokuWikis include-plugin är aktiverad kan listan bäddas in här med följande syntax:
-{{page>integration:lista&noheader&nofooter&noeditbtn}}
-Om tabellen inte visas här är include-plugin sannolikt inte aktiverad. Använd då länken till [[integration:lista|Dokumenterade integrationsprofiler]] i stället.
-===== Drift och arkitektur =====
-Integrationer kan köras i olika driftmiljöer beroende på krav på nätverk, säkerhet, prestanda och förvaltning.
-Miner kan exempelvis placeras:
-  * nära källsystemen
-  * i kundens egen IT-miljö
-  * i privat moln
-  * i publikt moln
-  * i hybridmiljö
-Driftmodell, nätverksåtkomst och arkitektur påverkar hur integrationen bör utformas.
-Läs mer på sidan [[miner:integrationer:drift-och-arkitektur|Drift och arkitektur]].
-===== Kvalitetssäkring =====
-En integration bör kvalitetssäkras innan den tas i full drift.
-Kvalitetssäkring kan omfatta:
-  * kontroll av att rätt datapunkter har valts
-  * kontroll av metadata
-  * kontroll av läs- och skrivbehörighet
-  * kontroll av dataAccess och andra styrande egenskaper
-  * kontroll av att provisionering har genomförts korrekt
-  * kontroll av att data kommer fram till mottagaren
-  * kontroll av datakvalitet och kvalitetsstämplar
-Läs mer på sidan [[miner:admin:qa|QA]].
-===== Undersidor =====
-Fördjupad information finns på följande sidor:
-  * [[miner:integrationer:systemintegration|Systemintegration]] – tekniska integrationer, anslutningar, jobbtyper och dataflöden
-  * [[miner:integrationer:metadata|Metadata]] – metadata, scheman, klassificering och informationsmodellering
-  * [[miner:integrationer:onboardingprocess|Onboardingprocess]] – metodiskt arbetssätt för att identifiera, klassificera och onboarda datapunkter
-  * [[miner:integrationer:provisionering|Provisionering]] – uppladdning och skapande av metadata eller objekt i mottagande system
-  * [[miner:integrationer:drift-och-arkitektur|Drift och arkitektur]] – driftmiljöer, infrastruktur och övergripande arkitektur
-===== Relaterade sidor =====
-  * [[miner:oversikt|Produktöversikt]]
-  * [[miner:anvandning:kommaigang|Komma igång]]
-  * [[miner:integrationer:metadata|Metadata]]
-  * [[miner:integrationer:onboardingprocess|Onboardingprocess]]
-  * [[miner:integrationer:provisionering|Provisionering]]
-  * [[miner:admin:qa|QA]]