Detta är en gammal version av dokumentet!
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 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.
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.
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. | 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 |
Övergripande process
En typisk integrationsprocess i Miner kan beskrivas enligt följande:
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.
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 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 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 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 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 Provisionering.
Dokumenterade integrationsprofiler
OBS! Vi håller ständigt på med utveckling av nya integrationsprofiler. Hör gärna av dig till oss via hemsidan så får du en komplett lista.
| Fabrikat/Protokoll | Kommentar |
|---|---|
| Abelko Ultrabase | Läsning och skrivning till datapunkter i DUC via API |
| Abelko Webmaster Pro | Läsning och skrivning till datapunkter i DUC via API |
| Alliance CRF | Datahämtning från DUC |
| Apache Kafka | Hämtning av data, finns parser för REC 3.2. Nya parsers utvecklas vid behov. |
| Azure IoT Hub | Dataöverföring via ett flertal scheman, device twin med mera |
| Bastec BAS2 | Läsning och skrivning till datapunkter i DUC via API |
| Elvaco CME3100 | Datahämtning via REST-API |
| Entso-e | Datahämtning via API |
| Fidelix | Läsning och skrivning till datapunkter i DUC via fältprotokoll |
| Filuppladdning via SFTP/FTP | Filformat för Greenview, Vitec Energi med fler |
| Greenview | Överföring av mätdata via filöverföring till FTP/SFTP |
| HAN Porten SE MQTT | Datahämtning enligt HAN-porten protokollet via MQTT |
| HubApp | Dataöverföring (läs/skriv) |
| iCalendar (delade kalendrar) | Nedladdning av kalender till grafdatabas och sparande i RDF-format |
| Iconics | Datahämtning via databas |
| IMAP (e-post) | Hämtning av larm från inkorg för e-post via IMAP, inklusive authentisering via Oauth2 för Office365 och Google Apps. |
| InfluxDB | Läsa och skriva data till tidsseriedatabasen InfluxDB |
| Keytalk | Läsning och skrivning till datapunkter via API |
| Kiona Webport | Läsning och skrivning till datapunkter via API |
| Larmia | Läsning och skrivning till datapunkter via API |
| Lindinvent Lindinspect | Datahämtning via REST-protokoll |
| Malthe Winje SAIA | Via Modbus TCP |
| Modbus TCP | Stöd för läsning/skrivning till coils och registers |
| MQTT | Dataöverföring (läs/skriv) via flera scheman. Nya utvecklas vid behov. |
| MSSQL | Datahämtning via databas |
| Myrspoven | Överföring av mätdata och hämtning av börvärden via API |
| MySQL | Datahämtning via databas |
| Nordomatic Kabona WDC | Läsning och skrivning till datapunkter i DUC via API |
| WebFactory | Datahämtning via databas |
| Orbiq | Dataöverföring (läs/skriv) via API, device twin via RDF-store |
| Piigab PS900 | Hämtning av data via MQTT |
| Piscada | Läsning av datapunkter via API |
| ProptechOS | Provisionering, läsning, skrivning via RealEstateCore |
| RDF Store (grafdatabas) | Sparande av metadata i Miner, datahämtning via SPARQL, sparande av kalendrar med mera |
| RealEstateCore | Provisionering, läsning, skrivning (REC 3.2) |
| SaveBySolar | Överföring av data via API |
| Schneider Electric Citect | Dataöverföring via kompletterande klientprogram |
| Schneider Electric Vista | Datahämtning via databas |
| SMHI Väderprognosdata | Hämtning av väderprognosdata |
| Swegon Gold | Via Modbus TCP |
| Tridium/JACE | Via Obix-XML, fungerar även för DUC från Distec med fler som bygger på Tridium-plattformen. |
| Vitec Energi | Överföring av mätdata via filöverföring till FTP/SFTP |
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 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 QA.
Undersidor
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