Integrationer

Detta är en gammal version av dokumentet!

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 Produktöversikt.

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.

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

Miner ansvarar för att hämta, strukturera, komplettera och leverera data enligt den konfiguration som har gjorts i respektive 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.	Systemintegration
Jobb	Definierar hur data ska hämtas, behandlas eller levereras.	Systemintegration
Datapunkter	Signaler, mätvärden eller objekt som ingår i integrationen.	Onboardingprocess
Metadata	Beskrivande information som gör datapunkterna begripliga, sökbara och användbara i andra system.	Metadata
Provisionering	Uppladdning eller skapande av metadata, objekt eller struktur i ett mottagande system.	Provisionering
Dataöverföring	Det löpande dataflödet från datakälla till mottagare.	Systemintegration
Integrationsprofil	En färdig eller anpassad koppling mot ett visst system, protokoll, API eller dataformat.	Dokumenterade integrationsprofiler

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

flowchart TD A["1. Skapa anslutning
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

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 Onboardingprocess.

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 Systemintegration.

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.

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 Systemintegration.

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 Metadata.

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 Onboardingprocess.

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 Provisionering.

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:

Dokumenterade integrationsprofiler

Om DokuWikis include-plugin är aktiverad kan listan bäddas in här med följande syntax:

Om tabellen inte visas här är include-plugin sannolikt inte aktiverad. Använd då länken till Dokumenterade integrationsprofiler i stället.

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 Drift och arkitektur.

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 QA.

Fördjupad information finns på följande sidor:

Systemintegration – tekniska integrationer, anslutningar, jobbtyper och dataflöden
Metadata – metadata, scheman, klassificering och informationsmodellering
Onboardingprocess – metodiskt arbetssätt för att identifiera, klassificera och onboarda datapunkter
Provisionering – uppladdning och skapande av metadata eller objekt i mottagande system
Drift och arkitektur – driftmiljöer, infrastruktur och övergripande arkitektur