Skillnader

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

--- miner:whitepaper:oppen-integrationsplattform [2026/06/09 13:02] – ↷ Sida flyttad och namnändrad från miner:funktionsbeskrivning till miner:whitepaper:oppen-integrationsplattform dokuadmin
+++ miner:whitepaper:oppen-integrationsplattform [2026/06/09 13:13] (aktuell) – [Relaterade sidor] dokuadmin
@@ Rad 1: / Rad 1: @@
-====== Miner – Öppen och plattformsneutral integrationsplattform för fastighetsdata ======
+====== Fördjupning: Miner som leverantörsneutral integrationsplattform ======
-Miner är en leverantörsneutral integrationsplattform för insamling, berikning, distribution och (där relevant) styrning av data från fastighetssystem, mätare, sensorer och externa tjänster.
+Den här sidan beskriver Miner ur ett mer övergripande och strategiskt perspektiv.
-Lösningen är utformad för att ge **öppenhet**, **transparens**, **självständighet** och **frihet i driftsättning** – oavsett underliggande system, leverantörer eller IT-plattform.
+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.
-Miner används normalt tillsammans med plattformen [[/funktionsbeskrivning|Orbiq]], där Miner ansvarar för datainsamling och integration medan Orbiq används för lagring, analys, visualisering och operativ användning av data.
+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 som delar av samma plattform.
+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 enligt följande:
+En förenklad arkitektur kan beskrivas som:
   * tekniska system och datakällor
-  * datainsamling via Miner
+  * datainsamling och integration via Miner
-  * lagring, analys och visualisering i Orbiq
+  * lagring, analys och visualisering i Orbiq eller annan mottagande plattform
-Miner ansvarar för kommunikationen med olika system, protokoll och API:er, medan Orbiq fungerar som den operativa plattformen där data används för drift, analys och integration med andra system.
+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 användare som arbetar med integration och datainsamling från tekniska system, exempelvis:
+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
@@ Rad 28: / Rad 38: @@
   * digitaliseringsansvariga
   * utvecklare
+  * fastighetsägare
+  * tjänsteleverantörer inom analys, optimering och visualisering
-Lösningen kan användas både av organisationer som själva vill konfigurera integrationer och av externa parter som arbetar med integration och dataplattformar.
+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 ansluter till ett externt system |
+| Anslutning | Beskriver hur Miner kommunicerar med ett externt system. |
-| Minerjobb | Konfiguration för att hämta data från ett system |
+| Jobb | Konfiguration som anger vilken input som ska användas och vilka outputs som ska ta emot data, metadata eller objekt. |
-| Datapunkt | En signal eller ett mätvärde från ett system |
+| Input | Den anslutning som jobbet hämtar data från. |
-| Metadata | Beskrivande information om datapunkter |
+| Output | En anslutning som jobbet skickar data, metadata eller objekt till. Ett jobb kan ha flera outputs. |
-| Dataström | Ett dataflöde från ett system till en eller flera målmiljöer |
+| 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. |
-Miner arbetar i praktiken i flera steg:
+Läs mer i [[miner:referens:start|Referens]].
-  - definiera anslutning till ett system
+===== Övergripande arbetssätt =====
-  - konfigurera ett eller flera minerjobb
-  - identifiera och välja datapunkter
+Miner används i praktiken genom att konfigurera anslutningar, jobb, datapunkter och outputs.
-  - komplettera datapunkter med metadata och leveransregler
+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. Anslutning<br>(protokoll/API/DB)"] --> B["2. Minerjobb<br>(insamling & schema)"]
+    A["1. Input<br/>system, databas eller API"]
-  B --> C["3. Datapunkter<br>urval & normalisering"]
+    B["2. Jobb<br/>konfiguration och urval"]
-  C --> D["4. Metadata<br>semantik & struktur"]
+    C["3. Datapunkter<br/>värden och signaler"]
-  D --> E["5. Leverans<br>Orbiq och/eller annan målmiljö"]
+    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 =====
-  * **Öppet:** Minimerar inlåsning och bryter silos via många integrationsprofiler. Nya integrationer kan tas fram vid behov och produktifieras för att bli tillgängliga för samtliga kunder. För en förteckning över integrationerna, kolla [[:start#miner|här]].
+Miner bygger på följande grundprinciper:
-  * **Transparent:** Standardiserar data till ett neutralt format och kan kompletteras med metadata/semantik för enhetliga datapipelines och dokumentation.
-  * **Kunna göra själv:** Webbaserad konfiguration gör att kunden kan genomföra integrationer själv eller anlita valfri part – utan krav på särskild programvara eller programmeringskompetens.
+  * **Öppenhet** – plattformen ska minska inlåsning och göra det möjligt att integrera flera system, fabrikat och plattformar.
-  * **Köra i moln eller i egen miljö:** Plattformsoberoende driftsättning utan krav på specifik molnleverantör eller extern plattform.
+  * **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 =====
-  * Lösningen kan integrera data från ett brett och heterogent fastighetsbestånd, med varierande fabrikat och systemtyper (automation/BMS, mätinsamling, HVAC, IoT-sensorer, larm, säkerhet m.m.).
+Miner är utvecklad för heterogena miljöer där flera olika system, fabrikat, protokoll och plattformar behöver samverka.
-  * Stöd finns för flera integrationssätt beroende på källsystem och användningsfall, exempelvis protokollbaserad kommunikation och integration via API (öppna eller leverantörsspecifika).
-  * Integrationsprofiler kan återanvändas mellan fastigheter/objekt och skapar en standardiserad integrationsmodell, vilket minskar risken för silos och speciallösningar.
+Plattformen kan användas för att integrera data från exempelvis:
-  * Om en färdig integration saknas kan en ny integration tas fram inom projekt. Den kan därefter produktifieras och göras tillgänglig för fler, vilket ger en kontinuerligt växande integrationsbas över tid.
+  * 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:
-===== Transparens via neutral datamodell och semantisk metadata =====
+  * 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
-  * Data från olika källsystem och format kan normaliseras till ett neutralt, enhetligt format så att kunden kan bygga konsekventa datapipelines oberoende av underliggande systemlösning.
+Läs mer på [[miner:anvandning:admin-installningar|Admin och inställningar]] och [[miner:integrationsprofiler|Integrationsprofiler]].
-  * Datapunkter och dataströmmar kan berikas med strukturerad metadata, exempelvis:
-    * fastighet/byggnad/zon (eller motsvarande struktur)
-    * tekniskt system/tillhörighet
-    * mätpunktstyp/roll
-    * enhet och datatyp
-    * ursprung/källa samt relevant versions-/konfigurationsinformation
-  * Metadata kan kombineras från flera källor, t.ex.:
-    * källsystemets egna attribut
-    * externa register/masterdata
-    * manuella regler/mallar
-    * automatiska regler (t.ex. mönster/regex/regelverk)
-  * Lösningen möjliggör spårbarhet (data lineage) från källa till leverans, inklusive information om transformeringar och konfigurations-/versionshistorik.
-  * Metadata och dokumentation kan göras åtkomlig i öppna och maskinläsbara format. Stöd för semantisk modellering och utbyte i öppna standardformat (t.ex. RDF/JSON-LD eller likvärdigt) möjliggör integration med grafdatabaser/RDF-stores och framtida användningsfall såsom avancerad metadatasökning, livedokumentation och AI-stöd.
 ===== Självservice och enkel utrullning =====
-  * Ett webbaserat användargränssnitt möjliggör konfiguration av integrationer och dataflöden utan krav på särskild programvara eller programmeringskunskap.
+Miner har ett webbaserat användargränssnitt där användaren kan konfigurera anslutningar, jobb, datapunkter, attribut och outputs.
-  * Anslutningar (in/ut), urval av datapunkter, mappningar, insamlingsparametrar och leveransmål kan hanteras genom konfiguration.
-  * Lösningen kan stödja inventering/discovery av datapunkter från anslutna system i den utsträckning källsystemet medger, inklusive teknisk metadata (namn/identifierare, datatyp, enhet, läs-/skrivbarhet).
+Det innebär att många integrationsflöden kan konfigureras utan specialutvecklad kod.
-  * Datapunkter och metadata kan hanteras kontrollerat över tid (skapa/aktivera, ändra, versionssätta/spåra, avaktivera), vilket underlättar förvaltning och revision.
-  * Kunden kan göra arbetet själv eller anlita valfri part för integrationerna, utan att vara beroende av en specifik leverantör eller specialistkedja.
+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 =====
-  * Lösningen kan driftsättas edge-nära (i eller nära fastigheten) och/eller centralt (on-prem, privat moln eller publikt moln), inklusive hybridupplägg.
+Miner kan driftsättas på olika sätt beroende på krav på nätverk, säkerhet, prestanda och förvaltning.
-  * Drift kan ske på standardiserad infrastruktur (t.ex. container-/VM-baserat eller motsvarande) utan krav på proprietär specialhårdvara.
-  * Inget krav finns på specifik molnleverantör eller extern plattform. Kunden kan välja driftmodell utifrån säkerhet, policy, efterlevnad och kostnadsbild.
-  * Data kan levereras till valfri målmiljö och flera måltyper, exempelvis:
-    * tidsseriedatabaser
-    * relationsdatabaser
-    * datalake/object storage
-    * meddelandeköer/streamingplattformar
-    * grafdatabaser/triplestores
-    * IoT-/dataplattformar via öppna API:er och protokoll
-  * Samma dataströmmar kan levereras till flera parallella mål utan att integrationsarbetet behöver dupliceras.
-===== Robust insamling, avbrottstålighet och obrutna tidsserier =====
+Exempel på driftmiljöer:
-==== Insamlingspolicy och datalogik ====
+  * nära källsystemen
+  * i kundens egen IT-miljö
+  * i privat moln
+  * i publikt moln
+  * i hybridmiljö
-  * Insamling och lagring kan konfigureras flexibelt per datapunkt/dataström, inklusive stöd för:
+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.
-    * givna tidsstämplar vid datahämtning
-    * Change of Value (COV) med inställbara trösklar
+===== Data till flera outputs =====
-    * kombination av händelsebaserad logik och fasta intervaller
+Ett jobb i Miner kan leverera data till en eller flera outputs.
 Exempel:
-  * "Läs data varje minut, spara när värdet har ändrats med minst 0,5 – men spara minst ett värde per timme."
+  * tidsseriedatabas
+  * relationsdatabas
+  * grafdatabas eller RDF-store
+  * Orbiq
+  * ProptechOS
+  * extern dataplattform
+  * analys- eller optimeringstjänst
+  * API eller meddelandekö
-==== Hantering av kommunikationsavbrott ====
+Samma input kan därmed användas för flera syften utan att hela integrationsarbetet behöver göras om.
-  * Vid avbrott nedströms (t.ex. vid uppladdning/leverans) kan data buffras lokalt och återöverföras automatiskt när uppkoppling återkommer (store-and-forward).
+===== Robust insamling och obrutna tidsserier =====
-  * Om ett källsystem har egen historiklagring kan lösningen även hämta historisk data för att fylla luckor i scenarier där kommunikationen till källsystemet påverkas indirekt.
-==== Datakvalitet och driftsäkerhet ====
+Miner kan hantera olika insamlingslogiker beroende på källsystem och datapunkt.
-  * Databehandling nära källan kan användas för att normalisera, filtrera, enhetskonvertera, aggregera och kvalitetstesta data vid behov.
+Exempel på funktioner:
-  * Lösningen är utformad för att hantera stora datavolymer och varierande insamlingsfrekvenser.
-  * Stöd finns för att hantera flera typer av informationsflöden, exempelvis mätvärden/telemetri, metadata och larm.
-===== Styrning och extern optimering =====
+  * 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
-  * Där källsystemet stödjer det kan lösningen hantera både läsning (read) och skrivning/överstyrning (write) tillbaka till system i fastigheten.
+Exempel:
-  * Externa tjänster (t.ex. optimering/AI) kan använda lösningen som kontrollerad brygga för att:
-    * konsumera data
-    * skicka styrkommandon
-    * få status/kvittens tillbaka
-  * Styrhändelser kan göras spårbara och kontrollerade, inklusive loggning och stöd för återställning/fallback-principer där det är relevant.
-===== Enkel och förutsägbar prismodell =====
+  * 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ösningen tillämpar en tydlig och enhetlig prissättning per Miner-instans eller per dataöverföringsjobb.
+Läs mer på [[miner:referens:pollning-cov-sparintervall|Pollning, COV och sparintervall]] och [[miner:referens:qstamp|qstamp]].
-  * Prissättningen är oberoende av:
-    * antal datapunkter
-    * antal mätvärden
-    * datavolym
-    * kvadratmeter
-    * antal anslutna fastighetssystem
-Detta innebär att kunden kan:
+===== Styrning och överskrivningar =====
-  * skala upp användningen utan att kostnadsmodellen blir komplex
+Där källsystemet och integrationsprofilen stödjer det kan Miner även hantera skrivning tillbaka till system.
-  * undvika kostnadsdrivande incitament kopplade till ökad datakvalitet
-  * budgetera långsiktigt utan risk för oväntade kostnadsökningar
+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 =====
-  * Kunden har full rådighet över rådata, berikad data, metadata och relevanta loggar.
+Miner är utformad för att kunden ska kunna behålla kontrollen över data, metadata och integrationslogik.
-  * Data och metadata kan exporteras i öppna och dokumenterade format.
-  * Lösningen är utformad för att minimera teknisk och kommersiell inlåsning.
+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]]