miner:integrationer:onboardingprocess

Skillnader

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

Länk till den här jämförelsesidan

Börjar med Föregående version.
Nästa version.		 Föregående version.
miner:integrationer:onboardingprocess [2026/06/05 07:02] – [1. Förbered integration] dokuadminminer:integrationer:onboardingprocess [2026/06/05 08:37] (aktuell) – [1. Förbered integration] dokuadmin
Rad 41: Rad 41:
  
 <mermaid> <mermaid>
-flowchart TD+flowchart LR
     A["1. Förbered integration<br/>och skapa anslutning"]     A["1. Förbered integration<br/>och skapa anslutning"]
     B["2. Skapa jobb<br/>och hämta datapunkter"]     B["2. Skapa jobb<br/>och hämta datapunkter"]
Rad 86: Rad 86:
 ===== 1. Förbered integration ===== ===== 1. Förbered integration =====
  
-Börja med att klarlägga vilket eller vilka system som ska integreras och vad det finns för krav med avseende på omfattningen av integrationen.+Börja med att klarlägga vilket eller vilka system som ska integreras och vad det finns för krav med avseende på omfattningen av integrationen. Inför uppdatering och ändring av Miners konfiguration är det alltid bra att ta en backup av den nuvarande konfigurationen vid eventuellt behov av senare referens. 
  
 Exempel på frågor: Exempel på frågor:
Rad 93: Rad 94:
   * Hur ser specifikationen ut för vilken typ av data som ska ingå i datainsamlingen? Vilka signaler letar vi efter i källsystemet?   * Hur ser specifikationen ut för vilken typ av data som ska ingå i datainsamlingen? Vilka signaler letar vi efter i källsystemet?
   * Vilket eller vilka system ska data från källsystemet levereras till?   * Vilket eller vilka system ska data från källsystemet levereras till?
-  * Vilka typer av [[miner:integrationer:start|miner-anslutningar]] är lämpliga att använda och konfigurera för integrationen?+  * Vilka typer av [[integration:start|miner-anslutningar]] är lämpliga att använda och konfigurera för integrationen?
   * Finns nödvändiga användarkonton, API-nycklar, certifikat med mera på plats för att konfigurera anslutningarna?   * Finns nödvändiga användarkonton, API-nycklar, certifikat med mera på plats för att konfigurera anslutningarna?
   * Finns möjlighet till kommunikation med avseende på uppkoppling och nätverksåtkomst till nödvändiga IP-adresser och portar?   * Finns möjlighet till kommunikation med avseende på uppkoppling och nätverksåtkomst till nödvändiga IP-adresser och portar?
Rad 112: Rad 113:
  
   * Miner läser in datapunkter från källsystemet   * Miner läser in datapunkter från källsystemet
-  * datapunkter exporteras från Miner +  * datapunkter väljs via Miners webbgränssnitt, eller 
-  * datapunktlistor importeras från fil +    * datapunkter väljs genom export/import av CSV-filer, eller 
-  * metadata-listor hämtas från en ansluten plattform +    * datapunktlistor importeras från fil -- gäller exempelvis vid dataintegration mot Modbus-system 
-  * kompletterande underlag sammanställs manuellt+  * metadatalistor för databerikning hämtas från en ansluten plattform. Se [[integration/proptech_os?s[]=proptechos#ladda_lista_med_byggnadskomponenter_infoer_instaellning_av_provisioneringen| exempel för integration mot ProptechOS]]. 
 +  * eventuellt kompletterande underlag sammanställs manuellt
  
 Om integrationen tillhandahåller färdiga metadata-listor, klasslistor eller mallar kan dessa användas som stöd i onboardingarbetet. Om integrationen tillhandahåller färdiga metadata-listor, klasslistor eller mallar kan dessa användas som stöd i onboardingarbetet.
Rad 127: Rad 129:
   * vilka system som ingår   * vilka system som ingår
   * hur datapunkterna är namngivna   * hur datapunkterna är namngivna
-  * vilka punktbeteckningar som används +  * om det finns beskrivningstexter eller andra tekniska attribut (metadata) som kompletterar beskrivningen 
-  * om det finns beskrivningstexter eller tekniska attribut +  * om det finns någon särskild ''nyckel'' som kan användas för identifiering av unika datapunkter 
-  * om samma typ av datapunkt förekommer i flera system +    * exempelvis särskilt attribut, eller kombination av andra attribut som kan utvinnas ur tillgänglig data, exempelvis en kombination av beteckningar för byggnadsbeteckning, systembeteckning, komponentbeteckning och så kallad kvalificerare 
-  * om det finns mönster som kan användas för klassificering+  * om det finns särskilda mönster som kan användas för klassificering
  
-Vid behov kan kompletterande underlag tas fram från källsystemet, exempelvis systembilder, larmlistor, funktionsbeskrivningar eller andra dokument som gör det lättare att förstå datapunkternas sammanhang.+Vid behov kan kompletterande underlag tas fram från källsystemet, exempelvis systembilder, funktionsbeskrivningar eller andra dokument som gör det lättare att förstå datapunkternas sammanhang.
  
 ===== 4. Identifiera och prioritera datapunkter ===== ===== 4. Identifiera och prioritera datapunkter =====
Rad 142: Rad 144:
 Urvalet kan baseras på exempelvis: Urvalet kan baseras på exempelvis:
  
-  * användningsfall 
-  * systemtyp 
-  * datakvalitet 
-  * tillgänglighet 
   * krav från mottagande system   * krav från mottagande system
   * kundens prioriteringar   * kundens prioriteringar
   * behov för analys, visualisering eller styrning   * behov för analys, visualisering eller styrning
 +  * förväntad nytta: varför sker systemintegrationen? Vilken nytta förväntas insamlad data generera för verksamheten?
  
 Det är ofta lämpligt att markera datapunkter med en särskild status eller flagga i arbetsunderlaget. Det är ofta lämpligt att markera datapunkter med en särskild status eller flagga i arbetsunderlaget.
Rad 160: Rad 159:
  
 Exakta kolumnnamn och statusvärden kan anpassas efter projektets arbetssätt. Exakta kolumnnamn och statusvärden kan anpassas efter projektets arbetssätt.
 +
 +**Tips:** Markera kolumnen för onboardingflagga som en kommentar (namnet föregås av "#", det vill säga exakt beteckning: "#onboarding"). Klicka här för beskrivning av olika prefix som kan användas för benämning av attribut.
  
 ===== 5. Komplettera datapunkter med metadata ===== ===== 5. Komplettera datapunkter med metadata =====
  
-När relevanta datapunkter har identifierats kompletteras de med metadata.+När relevanta datapunkter har identifierats kan de kompletteras med ytterligare metadata (attribut), för att ge dem mera mening och kontext och göra det enklare att aggregera data från datapunkterna inom mottagande system.
  
-Metadata kan beskriva exempelvis:+Utökad metadata (attribut) kan exempelvis beskriva:
  
   * byggnad eller anläggning   * byggnad eller anläggning
-  * tekniskt system +  * tekniskt system (beteckning och/eller klassificering) 
-  * utrustning eller komponent+  * utrustning eller komponent (beteckning och/eller klassificering)
   * datapunktens funktion   * datapunktens funktion
-  * mätstorhet +  * mätstorhet och enhet
-  * enhet+
   * placering   * placering
   * läs-/skrivbarhet   * läs-/skrivbarhet
Rad 183: Rad 183:
   * kundspecifika scheman   * kundspecifika scheman
   * standardiserade metadatauppsättningar   * standardiserade metadatauppsättningar
-  * metadata-listor från anslutna system+  * metadatalistor från anslutna system
   * projektspecifika mallar   * projektspecifika mallar
-  * manuella klassificeringar+  * manuella klassificeringssystem
  
 Läs mer på sidan [[miner:integrationer:metadata|Metadata]]. Läs mer på sidan [[miner:integrationer:metadata|Metadata]].
  
-===== Namn, beteckningar och visning =====+==== Namn, beteckningar och visning ====
  
 I många integrationer behöver tekniska punktbeteckningar kompletteras med mer läsbara namn. I många integrationer behöver tekniska punktbeteckningar kompletteras med mer läsbara namn.
Rad 207: Rad 207:
 ^ Typ av information ^ Exempel ^ ^ Typ av information ^ Exempel ^
 | Teknisk beteckning | ''LB01-GT11-PV'' | | Teknisk beteckning | ''LB01-GT11-PV'' |
-| System | ''LB01'' | +| Systembeteckning | ''LB01'' | 
-| Komponent | ''GT11'' |+| Komponentbeteckning | ''GT11'' |
 | Funktion | ''Mätvärde'' | | Funktion | ''Mätvärde'' |
 | Visningsnamn | ''Tilluftstemperatur'' | | Visningsnamn | ''Tilluftstemperatur'' |
Rad 214: Rad 214:
 Exakt vilka fält som används beror på metadataupplägg och mottagande system. Exakt vilka fält som används beror på metadataupplägg och mottagande system.
  
-===== Läsning, skrivning och dataAccess =====+==== Läsning, skrivning och dataAccess ====
  
-För datapunkter som kan styras eller skrivas till behöver läs-/skrivbarhet kontrolleras särskilt. +För datapunkter som kan styras eller skrivas till, kan läs-/skrivbarhet kontrolleras särskilt. Miner anger information om läs-/skrivbarhet via attributet "data_access" som kan ha värden enligt tabellen nedan.
- +
-En datapunkt kan exempelvis vara:+
  
 ^ Värde ^ Betydelse ^ ^ Värde ^ Betydelse ^
Rad 224: Rad 222:
 | ''rw'' | Datapunkten kan både läsas och skrivas. | | ''rw'' | Datapunkten kan både läsas och skrivas. |
  
-Det är viktigt att inte alla tekniskt skrivbara datapunkter automatiskt behandlas som styrbara i mottagande system. +**OBS!** Det är inte alla tekniskt skrivbara datapunkter som är eller behöver anges som styrbara i mottagande system. Till exempel tillåter API på Webport, att alla datapunkters värden kan ändras. Men, bara för att Miner kan ändra värdet på en datapunkt, betyder det inte att värdet för just den datapunkten skrivs ned till PLC-systemet som Webport i sin tur kommunicerar med. Miner kan med andra ord ändra värdet för en uppmätt sensor, men det avlästa värdet kommer att skrivas över direkt av PLC som läser av värdet från sensorn från sin analoga ingång. I fallet med Webport kommer Miner att ange alla datapunkter med "data_access=rw", så det är upp till systemintegratören att kontrollera vilka datapunkter som //egentligen// är skrivbara och ändra förinställda värden i kolumnen, så att dessa bättre stämmer överens med verkligheten.
- +
-I många projekt bör endast vissa typer av datapunkter betraktas som skrivbara, exempelvis: +
- +
-  * börvärden +
-  * styrsignaler +
-  * kurvpunkter +
-  * driftlägen +
-  * andra uttryckligt godkända styrvärden+
  
 Felaktig klassificering av läs-/skrivbarhet kan påverka hur datapunkter visas, provisioneras eller används i mottagande system. Felaktig klassificering av läs-/skrivbarhet kan påverka hur datapunkter visas, provisioneras eller används i mottagande system.
Rad 240: Rad 230:
 ===== 6. Validera och kvalitetssäkra ===== ===== 6. Validera och kvalitetssäkra =====
  
-När metadata har kompletterats behöver underlaget kvalitetssäkras.+När metadata har kompletterats, är det bra om underlaget kvalitetssäkras innan jobbet startas.
  
 Kontrollera exempelvis att: Kontrollera exempelvis att:
Rad 254: Rad 244:
  
 Det är ofta lämpligt att gå igenom underlaget system för system och dokumentera avvikelser i en separat lista. Det är ofta lämpligt att gå igenom underlaget system för system och dokumentera avvikelser i en separat lista.
 +
 +När datapunktens urval och egenskaper är kvalitetssäkrade, kan detta anges genom att "färdigmarkera" datapunkten för dataöverföring. Antingen via Miners webbgränssnitt, eller genom att ange flaggan "config_status=Done" i konfigurationsunderlaget som läses in via CSV-import.
  
 Läs mer på sidan [[miner:admin:qa|QA]]. Läs mer på sidan [[miner:admin:qa|QA]].
Rad 259: Rad 251:
 ===== 7. Provisionera metadata eller objekt ===== ===== 7. Provisionera metadata eller objekt =====
  
-Provisionering är aktuellt när Miner ska skapa eller uppdatera information i ett mottagande system.+Provisionering är aktuellt när Miner ska skapa eller uppdatera information i ett mottagande system eller databas ''innan'' överföring av själva mätdata startas.
  
 Det kan exempelvis handla om att: Det kan exempelvis handla om att:
  
   * ladda upp metadata till en grafdatabas   * ladda upp metadata till en grafdatabas
-  * skapa datapunkter i en mottagande plattform +  * registrera eller uppdatera datapunkter i en mottagande plattform 
-  * skapa objekt och relationer +  * registrera eller uppdatera objekt och relationer
-  * uppdatera metadata i ett externt system+
   * förbereda mottagaren innan dataöverföringen startas   * förbereda mottagaren innan dataöverföringen startas
  
-Provisionering är inte nödvändig i alla integrationer. Om mottagaren endast ska ta emot mätvärden kan dataöverföringen ofta startas utan detta steg.+Provisionering är inte nödvändig i alla integrationer. Om mottagaren endast ska ta emot mätvärden, kan dataöverföringen ofta startas utan detta steg.
  
 Läs mer på sidan [[miner:integrationer:provisionering|Provisionering]]. Läs mer på sidan [[miner:integrationer:provisionering|Provisionering]].
Rad 275: Rad 266:
 ===== 8. Starta dataöverföring ===== ===== 8. Starta dataöverföring =====
  
-När datapunkter, metadata och eventuell provisionering är klara kan dataöverföringen startas.+När urval och konfiguration av datapunkter och eventuell provisionering är klara, kan dataöverföringen startas. **Observera** att Miner endast sparar avläsningar från datapunkter som är ''klarmarkerade'' i jobbet. Klarmarkering görs via Miners webbgränssnitt, eller genom att sätta "config_status=Done" i integrationsunderlaget via CSV-import. 
 + 
 +Inför uppdatering och ändring av Miners konfiguration är det alltid bra att ta en backup av den nuvarande konfigurationen vid eventuellt behov av senare referens.
  
 Kontrollera vid start att: Kontrollera vid start att:
Rad 283: Rad 276:
   * data skickas till rätt mottagare   * data skickas till rätt mottagare
   * tidsstämplar och värden ser rimliga ut   * tidsstämplar och värden ser rimliga ut
-  * eventuella kvalitetsstämplar hanteras korrekt 
   * loggar inte visar återkommande fel   * loggar inte visar återkommande fel
  
-Vid behov kan jobbet först köras i begränsad omfattning innan hela integrationen aktiveras.+Vid behov kan jobbet först köras i begränsad omfattning innan hela integrationen aktiveras. I så fall kan du börja med att ''klarmarkera'' ett fåtal datapunkter först och säkerställa att allting fungerar som det ska, innan samtliga datapunkter klarmarkeras.
  
 ===== 9. Följ upp och förvalta ===== ===== 9. Följ upp och förvalta =====
Rad 310: Rad 302:
 Ett arbetsunderlag kan exempelvis innehålla: Ett arbetsunderlag kan exempelvis innehålla:
  
-^ Kolumn/område ^ Beskrivning ^ +^ Arbetsblag ^ Beskrivning ^ 
-| Ursprunglig datapunkt | Datapunktens namn, ID eller beteckning i källsystemet. | +| Import_ååmmdd | Den ursprungliga import som gjordes från källsystemet | 
-| Beskrivning | Text eller attribut från källsystemet. | +| Arbetsblad | Underlaget där systemintegratören har arbetat med urval och metadatasättning. Arbetsbladet kan innehålla fler kolumner (exempelvis resultat från formler och eventuella noteringar och kommentarer) än det underlag som exporteras till Miner inför start av jobb. | 
-| Onboardingstatus | Anger om datapunkten ska onboardas eller behöver kontrolleras. | +| Export_ååmmdd | Det underlag som exporterades i CSV-format för start av minerjobb |
-| System | Vilket tekniskt system datapunkten tillhör. | +
-| Utrustning eller komponent | Vilken utrustning datapunkten hör till. | +
-| Funktion | Vad datapunkten representerar. | +
-| Enhet | Mätenhet eller datatyp. | +
-| Placering | Rum, zon, byggnad eller annan placering. | +
-| Läs-/skrivbarhet | Anger om datapunkten kan läsas eller skrivas. | +
-| Visningsnamn | Namn som ska användas i mottagande system. | +
-| Kommentar | Noteringar, osäkerheter eller avvikelser. |+
  
 Vilka kolumner som används beror på projektets metadataupplägg och mottagande system. Vilka kolumner som används beror på projektets metadataupplägg och mottagande system.
  • miner/integrationer/onboardingprocess.1780642946.txt.gz
  • Senast uppdaterad: 2026/06/05 07:02
  • av dokuadmin