Skillnader

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

--- miner:whitepaper:oppen-integrationsplattform [2026/06/09 13:02] – raderad - extern redigering (Okänt datum) 127.0.0.1
+++ miner:whitepaper:oppen-integrationsplattform [2026/06/09 13:13] (aktuell) – [Relaterade sidor] dokuadmin
@@ Rad 1: / Rad 1: @@
+====== 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]]