Skillnader
Här visas skillnader mellan den valda versionen och den nuvarande versionen av sidan.
| Nästa version. | Föregående version. | ||
| miner:integrationer:provisionering [2026/06/05 11:53] – skapad dokuadmin | miner:integrationer:provisionering [2026/06/05 12:03] (aktuell) – [Förvaltning] dokuadmin | ||
|---|---|---|---|
| Rad 46: | Rad 46: | ||
| | Dataöverföring | Skickar löpande mätvärden, | | Dataöverföring | Skickar löpande mätvärden, | ||
| - | ===== Vad kan provisioneras? | ||
| - | |||
| - | Vad som kan provisioneras beror på mottagande system och integrationsprofil. | ||
| - | |||
| - | Exempel: | ||
| - | |||
| - | ^ Typ av information ^ Beskrivning ^ | ||
| - | | Datapunkter | Registrering av datapunkter eller signaler i mottagande system. | | ||
| - | | Metadata | Attribut som beskriver datapunkter och deras sammanhang. | | ||
| - | | Objekt | Exempelvis byggnader, system, komponenter, | ||
| - | | Relationer | Kopplingar mellan datapunkter och objekt, exempelvis att en datapunkt tillhör ett system eller en komponent. | | ||
| - | | Klassificeringar | Klasser, typer eller kategorier enligt ett valt metadataupplägg. | | ||
| - | | Visningsnamn | Namn och beteckningar som används i mottagande system. | | ||
| - | | Åtkomstinformation | Information om datapunkten är läsbar, skrivbar eller både och. | | ||
| - | |||
| - | Mer information om metadata, grundattribut, | ||
| ===== Förutsättningar ===== | ===== Förutsättningar ===== | ||
| Rad 98: | Rad 82: | ||
| Det kan exempelvis omfatta: | Det kan exempelvis omfatta: | ||
| + | * minerinstans och mottagande system, inklusive API:er | ||
| * datapunkter | * datapunkter | ||
| * anslutningar | * anslutningar | ||
| * jobb | * jobb | ||
| - | * objekt | ||
| * attribut | * attribut | ||
| * relationer | * relationer | ||
| - | * klassificeringar | ||
| * kommentarer och arbetsinformation | * kommentarer och arbetsinformation | ||
| - | Grafdatabasen kan användas för dokumentation, sökning, visualisering | + | Grafdatabasen kan användas för dokumentation och analys av integrationens struktur, men den kan även användas för att skapa nya datamodeller (exempelvis i enlighet med REC/Brick eller andra datamodeller) utifrån informationen från Miners grafdata. En grafdatabas kan även användas som ett generellt datalager med data från andra datakällor, |
| - | + | ||
| - | Läs mer om metadata och kunskapsmodell på sidan [[miner: | + | |
| + | Ta [[https:// | ||
| ===== Exempel: ProptechOS ===== | ===== Exempel: ProptechOS ===== | ||
| Rad 131: | Rad 113: | ||
| * [[integration: | * [[integration: | ||
| - | ===== data_access vid provisionering ===== | ||
| - | |||
| - | Attributet '' | ||
| - | |||
| - | ^ Värde ^ Betydelse ^ | ||
| - | | '' | ||
| - | | '' | ||
| - | |||
| - | I vissa mottagande system kan datapunkter med '' | ||
| - | |||
| - | Det är därför viktigt att inte alla tekniskt skrivbara datapunkter automatiskt behandlas som styrbara i mottagande system. | ||
| - | |||
| - | Läs mer på sidan [[miner: | ||
| - | |||
| - | ===== Identifierare och dubbletter ===== | ||
| - | |||
| - | Provisionering kräver stabila identifierare. | ||
| - | |||
| - | Om samma datapunkt provisioneras flera gånger behöver Miner och mottagande system kunna avgöra om objektet redan finns eller om ett nytt objekt ska skapas. | ||
| - | |||
| - | Identifiering kan baseras på exempelvis: | ||
| - | |||
| - | * '' | ||
| - | * '' | ||
| - | * '' | ||
| - | * källsystem | ||
| - | * anslutning | ||
| - | * byggnad | ||
| - | * system | ||
| - | * komponent | ||
| - | * funktion eller kvalificerare | ||
| - | * extern identifierare i mottagande system | ||
| - | |||
| - | En stabil identifieringsprincip minskar risken för dubbletter och gör det lättare att uppdatera befintliga objekt. | ||
| - | |||
| - | Läs mer på sidan [[miner: | ||
| - | |||
| - | ===== Uppdatering av redan provisionerad information ===== | ||
| - | |||
| - | Provisionering kan användas både för att skapa ny information och för att uppdatera befintlig information. | ||
| - | |||
| - | Exempel på uppdateringar: | ||
| - | |||
| - | * ändrat visningsnamn | ||
| - | * korrigerad systemtillhörighet | ||
| - | * ändrad enhet | ||
| - | * kompletterad klassificering | ||
| - | * korrigerad läs-/ | ||
| - | * tillagd relation | ||
| - | * borttagen eller avaktiverad datapunkt | ||
| - | |||
| - | Vid uppdatering är det viktigt att förstå om mottagande system stödjer uppdatering av befintliga objekt eller om ändringar kräver manuell hantering. | ||
| - | |||
| - | ===== Avaktivering och borttag ===== | ||
| - | |||
| - | I vissa fall behöver datapunkter eller objekt tas bort eller avaktiveras i mottagande system. | ||
| - | |||
| - | Det kan exempelvis bli aktuellt när: | ||
| - | |||
| - | * datapunkten inte längre används | ||
| - | * källsystemet har ändrats | ||
| - | * objektet har provisionerats felaktigt | ||
| - | * en integration har ersatts | ||
| - | * en datapunkt har bytt identifierare | ||
| - | |||
| - | Borttag bör hanteras försiktigt, | ||
| - | |||
| - | I många fall är det bättre att avaktivera ett objekt än att radera det helt. | ||
| - | |||
| - | ===== Kvalitetssäkring före provisionering ===== | ||
| - | |||
| - | Innan provisionering genomförs bör metadataunderlaget kvalitetssäkras. | ||
| - | |||
| - | Kontrollera särskilt att: | ||
| - | |||
| - | * rätt datapunkter är valda | ||
| - | * nödvändiga grundattribut finns kvar | ||
| - | * '' | ||
| - | * '' | ||
| - | * obligatoriska metadatafält är ifyllda | ||
| - | * identifierare är stabila och unika | ||
| - | * visningsnamn är rimliga | ||
| - | * enheter och mätstorheter är korrekta | ||
| - | * relationer till byggnad, system, komponent eller placering är rimliga | ||
| - | * eventuella klassificeringar följer valt metadataupplägg | ||
| - | * avvikelser är dokumenterade | ||
| - | |||
| - | Läs mer på sidan [[miner: | ||
| - | |||
| - | ===== Vanliga fel och kontroller ===== | ||
| - | |||
| - | ^ Problem ^ Möjlig orsak ^ Kontroll ^ | ||
| - | | Objekt skapas dubbelt | Identifierare är inte stabila eller har ändrats. | Kontrollera '' | ||
| - | | Objekt saknas i mottagande system | Datapunkten är inte klarmarkerad eller saknar nödvändig metadata. | Kontrollera '' | ||
| - | | Fel typ av objekt skapas | Klassificering eller '' | ||
| - | | Relationer saknas | Metadata för byggnad, system, komponent eller placering är ofullständig. | Kontrollera relationsfält och valda metadataattribut. | | ||
| - | | Provisionering misslyckas | Felaktig anslutning, behörighet eller nätverksåtkomst. | Kontrollera API-nycklar, | ||
| - | | Metadata visas fel | Fel fältnamn, prefix eller värdeformat. | Kontrollera attributnamn, | ||
| - | ===== Förvaltning ===== | ||
| - | Provisionering kan behöva köras igen när integrationen förändras. | ||
| - | Exempel: | ||
| - | * nya datapunkter läggs till | ||
| - | * datapunkter tas bort eller avaktiveras | ||
| - | * metadata korrigeras | ||
| - | * systemstruktur ändras | ||
| - | * relationer uppdateras | ||
| - | * mottagande system får nya krav | ||
| - | * integrationen migreras eller byggs om | ||
| - | Spara och förvalta metadataunderlaget så att ändringar kan spåras över tid. | ||
| ===== Relaterade sidor ===== | ===== Relaterade sidor ===== | ||