miner:whitepaper:oppen-integrationsplattform [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
====== Fördjupning: Miner som leverantörsneutral integrationsplattform ======

Den här sidan beskriver Miner ur ett mer övergripande och strategiskt perspektiv.

Sidan är avsedd som en fördjupning för den som vill förstå varför Miner används, vilka principer plattformen bygger på och hur den bidrar till öppna och långsiktigt förvaltningsbara dataflöden.

För praktisk användning av Miner, se [[miner:kommaigang|Komma igång]] och [[miner:anvandning:start|Användning]].

===== Sammanfattning =====

Miner är en leverantörsneutral integrationsplattform för insamling, bearbetning, berikning och distribution av data från fastighetssystem, mätare, sensorer, databaser, API:er och externa tjänster.

Plattformen är utformad för att ge öppenhet, transparens och handlingsfrihet i arbetet med fastighetsdata. Miner kan användas tillsammans med Orbiq, men är inte begränsad till Orbiq som mottagande plattform. Data kan även levereras till andra databaser, grafdatabaser, analysplattformar, externa API:er eller digitala tjänster.

===== Miner och Orbiq =====

Miner och Orbiq används ofta tillsammans.

I ett sådant upplägg ansvarar Miner för datainsamling, integration, metadatahantering och dataöverföring, medan Orbiq används för lagring, analys, visualisering och operativ användning av data.

En förenklad arkitektur kan beskrivas som:

  * tekniska system och datakällor
  * datainsamling och integration via Miner
  * lagring, analys och visualisering i Orbiq eller annan mottagande plattform

Orbiq är därmed ett vanligt exempel på output från Miner, men inte en förutsättning för att använda Miner.

===== Målgrupp =====

Miner riktar sig främst till organisationer och roller som arbetar med integration, datainsamling och digitalisering av tekniska system.

Exempel på målgrupper:

  * systemintegratörer
  * energitekniker
  * tekniska förvaltare
  * digitaliseringsansvariga
  * utvecklare
  * fastighetsägare
  * tjänsteleverantörer inom analys, optimering och visualisering

Miner kan användas både av organisationer som själva vill konfigurera integrationer och av externa parter som arbetar med integration och dataplattformar.

===== Centrala begrepp =====

^ Begrepp ^ Beskrivning ^
| Anslutning | Beskriver hur Miner kommunicerar med ett externt system. |
| Jobb | Konfiguration som anger vilken input som ska användas och vilka outputs som ska ta emot data, metadata eller objekt. |
| Input | Den anslutning som jobbet hämtar data från. |
| Output | En anslutning som jobbet skickar data, metadata eller objekt till. Ett jobb kan ha flera outputs. |
| Datapunkt | En signal, ett mätvärde, ett statusvärde, ett börvärde eller annan information som kan läsas eller skrivas. |
| Attribut | Metadata som beskriver datapunkter och deras sammanhang. |
| Dataflöde | Flödet från input via Miner till en eller flera outputs. |
| Integrationsprofil | En färdig eller anpassad koppling mot ett visst system, protokoll, API eller dataformat. |

Läs mer i [[miner:referens:start|Referens]].

===== Övergripande arbetssätt =====

Miner används i praktiken genom att konfigurera anslutningar, jobb, datapunkter och outputs.

Ett typiskt flöde är:

  * skapa anslutning till en input
  * skapa anslutning till en eller flera outputs
  * skapa ett jobb
  * välja input och outputs
  * identifiera och välja datapunkter
  * komplettera datapunkter med attribut vid behov
  * klarmarkera datapunkter
  * starta jobbet och följa upp dataflödet

<mermaid>
flowchart LR
    A["1. Input<br/>system, databas eller API"]
    B["2. Jobb<br/>konfiguration och urval"]
    C["3. Datapunkter<br/>värden och signaler"]
    D["4. Attribut<br/>metadata och struktur"]
    E["5. Outputs<br/>en eller flera mottagare"]
A --> B
B --> C
C --> D
D --> E

</mermaid>

Läs mer på [[miner:kommaigang|Komma igång]] och [[miner:anvandning:jobb|Jobb]].

===== Kärnvärden =====

Miner bygger på följande grundprinciper:

  * **Öppenhet** – plattformen ska minska inlåsning och göra det möjligt att integrera flera system, fabrikat och plattformar.
  * **Leverantörsneutralitet** – kunden ska kunna välja mottagande system, driftmiljö och förvaltningsmodell.
  * **Transparens** – dataflöden, datapunkter och attribut ska kunna dokumenteras och förstås över tid.
  * **Självservice** – användaren ska kunna konfigurera anslutningar, jobb och datapunkter via ett webbaserat gränssnitt.
  * **Flexibel driftsättning** – Miner kan placeras nära källsystem, i kundens miljö, i moln eller i hybridmiljö.
  * **Förvaltningsbarhet** – konfiguration, metadata och dataflöden ska kunna underhållas, justeras och återanvändas.

===== Öppenhet och leverantörsneutral integration =====

Miner är utvecklad för heterogena miljöer där flera olika system, fabrikat, protokoll och plattformar behöver samverka.

Plattformen kan användas för att integrera data från exempelvis:

  * styr- och övervakningssystem
  * mätinsamlingssystem
  * HVAC-system
  * IoT-plattformar
  * sensorer och gateways
  * databaser
  * API:er
  * larm- och driftssystem
  * externa datakällor

Miner använder integrationsprofiler för att hantera olika system, protokoll och dataformat. Färdiga integrationsprofiler kan återanvändas mellan projekt och nya integrationer kan tas fram vid behov.

Se [[miner:integrationsprofiler|Integrationsprofiler]].

===== Transparens genom attribut och metadata =====

Data från olika källsystem kan kompletteras med attribut som beskriver datapunkternas sammanhang.

Attribut kan exempelvis beskriva:

  * byggnad
  * system
  * komponent
  * funktion
  * enhet
  * datatyp
  * läs- och skrivbarhet
  * visningsnamn
  * ursprung
  * relationer till andra objekt

Miner är inte låst till en viss metadatastandard. Attribut kan komma från källsystem, användarens egna fält, kundspecifika mallar, standardiserade listor eller mottagande systems krav.

Läs mer på [[miner:referens:metadata-attribut|Metadata och attribut]].

===== Kunskapsmodell och graf =====

Miner kan använda metadata och attribut för att beskriva integrationer som en kunskapsmodell.

Det innebär att anslutningar, jobb, datapunkter, attribut och relationer kan dokumenteras på ett mer strukturerat sätt än enbart som konfigurationsfiler eller tabeller.

En sådan modell kan användas för att:

  * dokumentera integrationer
  * söka efter datapunkter och attribut
  * förstå relationer mellan system, komponenter och datapunkter
  * publicera information till grafdatabas eller RDF-store
  * skapa underlag för analys, automatisering och AI-tillämpningar

Läs mer på [[miner:anvandning:admin-installningar|Admin och inställningar]] och [[miner:integrationsprofiler|Integrationsprofiler]].

===== Självservice och enkel utrullning =====

Miner har ett webbaserat användargränssnitt där användaren kan konfigurera anslutningar, jobb, datapunkter, attribut och outputs.

Det innebär att många integrationsflöden kan konfigureras utan specialutvecklad kod.

Användaren kan exempelvis:

  * skapa anslutningar till system och plattformar
  * skapa jobb med input och outputs
  * hämta eller välja datapunkter
  * läsa in aktuella värden
  * exportera och importera datapunkter via CSV
  * komplettera datapunkter med attribut
  * klarmarkera datapunkter
  * starta och stoppa jobb
  * följa upp loggar och dataflöden

Läs mer på [[miner:anvandning:start|Användning]].

===== Plattformsneutral driftsättning =====

Miner kan driftsättas på olika sätt beroende på krav på nätverk, säkerhet, prestanda och förvaltning.

Exempel på driftmiljöer:

  * nära källsystemen
  * i kundens egen IT-miljö
  * i privat moln
  * i publikt moln
  * i hybridmiljö

Miner är inte beroende av en specifik molnleverantör eller mottagande plattform. Kunden kan välja driftmodell utifrån tekniska, organisatoriska och säkerhetsmässiga krav.

===== Data till flera outputs =====

Ett jobb i Miner kan leverera data till en eller flera outputs.

Exempel:

  * tidsseriedatabas
  * relationsdatabas
  * grafdatabas eller RDF-store
  * Orbiq
  * ProptechOS
  * extern dataplattform
  * analys- eller optimeringstjänst
  * API eller meddelandekö

Samma input kan därmed användas för flera syften utan att hela integrationsarbetet behöver göras om.

===== Robust insamling och obrutna tidsserier =====

Miner kan hantera olika insamlingslogiker beroende på källsystem och datapunkt.

Exempel på funktioner:

  * avläsning enligt intervall
  * Change of Value, COV
  * minsta sparintervall
  * historikhämtning när input stödjer det
  * hantering av kvalitetsstämplar
  * buffring eller återupptagning beroende på integrationsupplägg

Exempel:

  * Läs data varje minut.
  * Spara när värdet har ändrats med minst 0,5.
  * Spara minst ett värde per timme även om värdet inte har ändrats.

Läs mer på [[miner:referens:pollning-cov-sparintervall|Pollning, COV och sparintervall]] och [[miner:referens:qstamp|qstamp]].

===== Styrning och överskrivningar =====

Där källsystemet och integrationsprofilen stödjer det kan Miner även hantera skrivning tillbaka till system.

Det kan exempelvis handla om:

  * börvärden
  * styrsignaler
  * driftlägen
  * andra datapunkter som uttryckligen ska vara skrivbara

Skrivning bör hanteras kontrollerat. Attributet ''data_access'' används för att ange om en datapunkt kan läsas eller både läsas och skrivas.

Läs mer på [[miner:referens:data_access|data_access]] och [[miner:anvandning:overskrivningar|Överskrivningar]].

===== Dataägande och långsiktig handlingsfrihet =====

Miner är utformad för att kunden ska kunna behålla kontrollen över data, metadata och integrationslogik.

Det innebär bland annat att:

  * data kan levereras till valda mottagare
  * metadata kan exporteras och återanvändas
  * integrationer kan dokumenteras och förvaltas över tid
  * flera system och plattformar kan användas parallellt
  * beroendet av enskilda leverantörer kan minska

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

  * [[miner:oversikt|Översikt]]
  * [[miner:kommaigang|Komma igång]]
  * [[miner:anvandning:start|Användning]]
  * [[miner:referens:start|Referens]]
  * [[miner:faq|FAQ]]
  * [[miner:integrationsprofiler|Integrationsprofiler]]
  * [[integration:orbiq|Orbiq]]
  * [[integration:proptech_os|ProptechOS]]
  * [[integration:rdf-store|RDF Store]]