miner:referens:provisionering [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
====== Provisionering ======

Provisionering innebär 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 behövs inte i alla integrationer. Om en output endast ska ta emot mätvärden som tidsserier kan dataöverföringen ofta startas utan ett separat provisioneringssteg.

===== När behövs provisionering? =====

Provisionering behövs när mottagande system behöver mer än själva värdena för att kunna använda data på rätt sätt.

Det kan exempelvis vara aktuellt när:

  * datapunkter ska registreras i en mottagande plattform
  * metadata ska laddas upp till en grafdatabas eller RDF-store
  * objekt som byggnader, system, komponenter eller datapunkter ska skapas
  * relationer mellan objekt ska skapas
  * befintliga objekt ska uppdateras med ny metadata
  * Miner används för provisionering mot ProptechOS
  * mottagande system behöver en objektmodell innan mätvärden börjar skickas

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

===== Skillnad mellan provisionering och dataöverföring =====

^ 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 en eller flera outputs. | Skicka temperaturvärden, energivärden, driftstatus eller börvärden. |

Provisionering handlar alltså om att förbereda mottagaren.

Dataöverföring handlar om att skicka värden.

===== Vad kan provisioneras? =====

Vad som kan provisioneras beror på integrationsprofil och mottagande system.

Exempel:

  * datapunkter
  * metadata
  * byggnader
  * tekniska system
  * komponenter
  * relationer mellan objekt
  * information om läs- och skrivbarhet
  * kopplingar mellan datapunkter och objekt

===== Förutsättningar =====

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

  * relevanta datapunkter är valda
  * nödvändiga attribut är ifyllda
  * obligatoriska fält för mottagande system är kontrollerade
  * identifierare är stabila och konsekventa
  * ''data_access'' är rimligt
  * mottagande system är åtkomligt
  * nödvändiga anslutningar är konfigurerade

Praktiskt arbete med datapunkter och attribut beskrivs på:

  * [[miner:anvandning:datapunkter|Datapunkter]]
  * [[miner:anvandning:import-export|Import och export]]
  * [[miner:referens:metadata-attribut|Metadata och attribut]]

===== ProvisioningStatus =====

Attributet ''ProvisioningStatus'' används för att ange om en datapunkt har provisionerats till relevant output.

Vanliga värden är:

^ Värde ^ Betydelse ^
| ''Done'' | Datapunkten har provisionerats. |
| ''NotDone'' | Datapunkten har inte provisionerats. |

Exakt betydelse kan bero på integrationsprofil och mottagande system.

Läs mer på [[miner:referens:grundattribut|Grundattribut]].

===== 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:

  * Miner-instans
  * anslutningar
  * jobb
  * datapunkter
  * attribut
  * relationer
  * kommentarer och arbetsinformation

Grafdata kan användas för dokumentation, sökning, analys och vidare modellering, exempelvis mot RDF-store, RealEstateCore, Brick eller andra datamodeller.

===== 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.

Detaljerad instruktion finns på:

  * [[integration:proptech_os|ProptechOS / RealEstateCore - dataintegration via Miner]]

===== Relaterade sidor =====

  * [[miner:referens:metadata-attribut|Metadata och attribut]]
  * [[miner:referens:grundattribut|Grundattribut]]
  * [[miner:referens:data_access|data_access]]
  * [[miner:anvandning:datapunkter|Datapunkter]]
  * [[miner:anvandning:import-export|Import och export]]
  * [[miner:integrationsprofiler|Integrationsprofiler]]
  * [[miner:faq|FAQ]]
  * [[integration:proptech_os|ProptechOS / RealEstateCore - dataintegration via Miner]]