====== Provisionering ====== 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 [[miner:integrationer|Integrationer]]. ===== Syfte ===== 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 [[miner:integrationer:onboardingprocess|Onboardingprocessen]] och beskrivs på sidan [[miner:integrationer:metadata|Metadata]]. ===== När behövs provisionering? ===== 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. ===== Skillnad mellan provisionering och dataöverföring ===== 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. | ===== Förutsättningar ===== 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 [[miner:integrationer:onboardingprocess|Onboardingprocess]]. ===== Generellt arbetsflöde ===== 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. ===== Provisionering till grafdatabas ===== 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 [[https://iquest.se/kontakta-oss|kontakt med oss]], så berättar vi gärna mer och ger dig demonstrationer inom detta område. ===== Exempel: ProptechOS ===== 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 [[integration:proptech_os|ProptechOS / RealEstateCore - dataintegration via Miner]]. Relevanta avsnitt i ProptechOS-guiden: * [[integration:proptech_os#dataoeverfoering_till_fraan_proptechos_via_realestatecore|Dataöverföring till/från ProptechOS via RealEstateCore]] * [[integration:proptech_os#attribut_som_kan_foerekomma_vid_provisionering|Attribut som kan förekomma vid provisionering]] * [[integration:proptech_os#processbeskrivning|Processbeskrivning]] * [[integration:proptech_os#ladda_lista_med_byggnadskomponenter_infoer_instaellning_av_provisioneringen|Ladda lista med byggnadskomponenter inför inställning av provisioneringen]] * [[integration:proptech_os#staell_in_noedvaendig_metadata_foer_valda_datapunkter|Ställ in nödvändig metadata för valda datapunkter]] * [[integration:proptech_os#konfigurera_jobb_foer_provisionering_av_datapunkter_inom_proptechos|Konfigurera jobb för provisionering av datapunkter inom ProptechOS]] * [[integration:proptech_os#skapande_av_anpassade_collections_foer_definition_av_installationstekniska_system|Skapande av anpassade Collections]] * [[integration:proptech_os#starta_jobbet_foer_provisionering|Starta jobbet för provisionering]] * [[integration:proptech_os#starta_jobbet_foer_dataoeverfoering|Starta jobbet för dataöverföring]] ===== Relaterade sidor ===== * [[miner:integrationer|Integrationer]] * [[miner:integrationer:systemintegration|Systemintegration]] * [[miner:integrationer:metadata|Metadata]] * [[miner:integrationer:onboardingprocess|Onboardingprocess]] * [[miner:admin:qa|QA]] * [[integration:proptech_os|ProptechOS / RealEstateCore - dataintegration via Miner]] * [[integration:start|Dokumenterade integrationsprofiler]]