Skillnader

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

--- miner:integrationer:onboardingprocess [2026/06/05 08:16] – [Läsning, skrivning och dataAccess] dokuadmin
+++ miner:integrationer:onboardingprocess [2026/06/05 08:37] (aktuell) – [1. Förbered integration] dokuadmin
@@ Rad 86: / Rad 86: @@
 ===== 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:
@@ Rad 188: / Rad 189: @@
 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.
@@ Rad 213: / Rad 214: @@
 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, 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.
@@ Rad 229: / Rad 230: @@
 ===== 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:
@@ Rad 243: / Rad 244: @@
 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]].
@@ Rad 248: / Rad 251: @@
 ===== 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:
   * 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
-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]].
@@ Rad 264: / Rad 266: @@
 ===== 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:
@@ Rad 272: / Rad 276: @@
   * data skickas till rätt mottagare
   * tidsstämplar och värden ser rimliga ut
-  * eventuella kvalitetsstämplar hanteras korrekt
   * 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 =====
@@ Rad 299: / Rad 302: @@
 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.