Provisionering

Detta är en gammal version av dokumentet!

Den här sidan beskriver vad provisionering innebär i Miner och när provisionering används som del av ett integrationsflöde.

Med provisionering menas att Miner skapar eller uppdaterar metadata, datapunkter, objekt eller relationer i ett mottagande system innan, eller i samband med, att dataöverföringen startas.

Provisionering är inte nödvändig i alla integrationer. Om mottagaren endast ska ta emot mätvärden, exempelvis till en tidsseriedatabas, kan dataöverföringen ofta startas utan ett separat provisioneringssteg.

För en övergripande beskrivning av integrationsområdet, se Integrationer.

Syftet med provisionering är att förbereda ett mottagande system så att inkommande data kan identifieras, förstås och användas på rätt sätt.

Provisionering kan exempelvis användas för att:

skapa datapunkter i ett mottagande system
ladda upp metadata till en grafdatabas
skapa objekt, exempelvis byggnader, system, komponenter eller datapunkter
skapa relationer mellan objekt
uppdatera befintliga objekt med ny metadata
förbereda en mottagande plattform innan mätvärden börjar skickas

Provisionering bygger normalt på det metadataunderlag som tas fram under Onboardingprocessen och beskrivs på sidan Metadata.

Provisionering behövs när mottagaren inte bara ska ta emot värden, utan även behöver en struktur för att förstå vilka objekt värdena hör till.

Provisionering kan vara aktuell när:

metadata ska laddas upp till en grafdatabas eller RDF-store
datapunkter ska registreras i en mottagande plattform
objekt och relationer ska skapas innan dataöverföringen startas
Miner används för provisionering mot ProptechOS
mottagaren behöver information om byggnader, system, komponenter och datapunkter genom referens till dataobjekt i andra databaser

Provisionering behövs normalt inte när data endast ska skickas som enkla tidsserier till en mottagare som inte kräver objektmodell eller relationer.

Provisionering och dataöverföring är två olika steg.

Del	Syfte	Exempel
Provisionering	Skapar eller uppdaterar struktur, metadata, objekt eller relationer i mottagande system.	Skapa datapunkter, objekt, relationer eller metadata i en plattform eller grafdatabas.
Dataöverföring	Skickar löpande mätvärden, statusvärden eller andra avläsningar till mottagaren. Miner kommer då att skicka med ytterligare metadata endast om mottagande system kan ta emot det.	Skicka avläsningar från temperaturvärden, energiavläsningar , driftstatus eller börvärden.

Innan provisionering genomförs bör följande vara klart:

relevanta datapunkter är identifierade
nödvändig metadata är ifylld
obligatoriska metadatafält är kontrollerade
data_access är verifierat
config_status är korrekt
identifierare är stabila och konsekventa
mottagande system är åtkomligt
nödvändiga anslutningar är konfigurerade

Den praktiska processen för att ta fram och kvalitetssäkra detta underlag beskrivs på sidan Onboardingprocess.

Ett generellt arbetsflöde för provisionering är:

Säkerställ att datapunkter och metadata är färdigställda.
Kontrollera att anslutning till mottagande system finns.
Kontrollera att mottagande system är åtkomligt.
Kontrollera att rätt metadatafält och identifierare används.
Kör provisioneringen.
Granska resultatet i Miner och i mottagande system.
Åtgärda eventuella fel eller avvikelser.
Kör om provisioneringen vid behov.
Starta dataöverföringen när mottagande system är förberett.

När metadata ska laddas upp till en grafdatabas kan Miner använda metadata för att beskriva integrationen som en graf.

Det kan exempelvis omfatta:

minerinstans och mottagande system, inklusive API:er
datapunkter
anslutningar
jobb
attribut
relationer
kommentarer och arbetsinformation

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, såsom från fastighetssystem, ärendehantering med mera.

Ta kontakt med oss, så berättar vi gärna mer och ger dig demonstrationer inom detta område.

ProptechOS är ett exempel på en mottagande plattform där provisionering kan behövas innan dataöverföringen startas.

Vid integration mot ProptechOS används provisionering för att skapa eller uppdatera objekt och datapunkter enligt den modell som används i ProptechOS och RealEstateCore.

Den detaljerade instruktionen finns på sidan ProptechOS / RealEstateCore - dataintegration via Miner.

Relevanta avsnitt i ProptechOS-guiden:

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, särskilt om mottagande system har historik eller relationer som är beroende av objektet.

I många fall är det bättre att avaktivera ett objekt än att radera det helt.

Innan provisionering genomförs bör metadataunderlaget kvalitetssäkras.

Kontrollera särskilt att:

rätt datapunkter är valda
nödvändiga grundattribut finns kvar
config_status är korrekt
data_access är korrekt
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 QA.

Problem	Möjlig orsak	Kontroll
Objekt skapas dubbelt	Identifierare är inte stabila eller har ändrats.	Kontrollera `UUID`, `source_label`, `label` och eventuell extern ID-logik.
Objekt saknas i mottagande system	Datapunkten är inte klarmarkerad eller saknar nödvändig metadata.	Kontrollera `config_status` och obligatoriska metadatafält.
Fel typ av objekt skapas	Klassificering eller `data_access` är felaktig.	Kontrollera metadata, klassfält och läs-/skrivbarhet.
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, användarkonton, endpoint och loggar.
Metadata visas fel	Fel fältnamn, prefix eller värdeformat.	Kontrollera attributnamn, prefix och mottagande systems krav.