| Börjar med Föregående version. Nästa version. | Föregående version. |
| integrationer:proptechos [2025/03/28 13:56] – dokuadmin | integrationer:proptechos [2025/03/31 11:38] (aktuell) – dokuadmin |
|---|
| | {{tag>miner rec "real estate core" proptechOs}} |
| ====== Dataöverföring till/från ProptechOS via RealEstateCore ====== | ====== Dataöverföring till/från ProptechOS via RealEstateCore ====== |
| Miner kan användas för att föra över data som läses in via strömmande eller pollande indataanslutningar, till [[https://proptechos.com/|ProptechOS]] via formatet [[https://www.realestatecore.io/|REC (RealEstateCore)]]. | Miner kan användas för att föra över data som läses in via strömmande eller pollande indataanslutningar, till [[https://proptechos.com/|ProptechOS]] via formatet [[https://www.realestatecore.io/|REC (RealEstateCore)]]. Du kan läsa mer om REC [[https://www.realestatecore.io/introduction/|här]]. |
| På denna sida kan du läsa hur du ställer in en anslutning mot ProptechOS för provisionering av devices, för överföring av strömmande data och för inställning av överskrivningar som initieras från ProptechOS. | På denna sida kan du läsa hur du ställer in en anslutning mot ProptechOS för provisionering av devices, för överföring av strömmande data och för inställning av överskrivningar som initieras från ProptechOS. |
| |
| Överföring av data till ProptechOS kräver att data provisioneras enligt ontologin Real Estate Core (REC). Detta innebär att datapunkter taggas upp med metadata som beskriver dem på ett sådant sätt att ProptechOS kan hantera dem och knyta dem till fysiska sensorer. Du kan läsa mer om REC här: https://www.realestatecore.io/introduction/ | Överföring av data till ProptechOS kräver att data provisioneras enligt API:erna som föreskrivs av Real Estate Core (REC). Detta innebär att datapunkter (items) i minerjobb behöver förses med med metadata (attributes) som beskriver dem på ett sådant sätt att ProptechOS kan hantera dem och knyta dem till fysiska sensorer. |
| | |
| | För att en datapunkt (item i ett minerjobb, motsvarande Sensor eller Actuator inom REC3.2) ska kunna provisioneras till en REC-graf, behöver ett antal egenskaper anges och i många fall behöver även flera objekt (Devices) och relationer mellan befintliga objekt skapas inom REC-grafen. Miner hanterar samtliga egenskaper och objekt i form av Attribut som anges på datapunkten (Item). Konfigurationen av attribut kan ske via Miners webbgränssnitt eller genom export och import av CSV-filer från Miner till ett externt redigeringsverktyg (exempelvis MS Excel). |
| | |
| | Inom REC v3.2 kan datapunkter (sensors, actuators) organiseras i en hierarki av Devices. Miner stödjer en organisering av datapunkter (Items) i två nivåer som vi kallar för Device (underliggande nivå) och SuperDevice (överliggande nivå). Användaren kan antingen själv ange nivåerna och benämna enheterna (PopularName, Littera), eller så kan Miner gruppera datapunkterna i två nivåer beroende av värden för andra obligatoriska Attributes. |
| | |
| | ==== Attribut som kan förekomma vid provisionering ==== |
| | Tabellen nedan beskriver de attribut som kan förekomma för datapunkter i minerjobb, i de fall där integration sker mot någon plattformslösning via REC 3.2. Vissa av attributen anges av användaren, medan andra sätts av Miner i anslutning till provisioneringen och kan användas för senare referens och felsökning. De REC-specifika attributen börjar med prefixen "rec:". |
| | |
| | Förutom de rec-specifika attributen, behöver användaren ange ett antal obligatoriska attribut för samtliga items som ska provisioneras till ProptechOS. Anledningen till detta framgår av tabellen nedan. |
| | * building |
| | * equipment |
| | * system |
| | |
| | Användaren kan lägga även lägga till egna attribut vid behov. Alla attribut av typen Constant eller Dynamic, som inte är bland de REC-specifika attributen nedan (se attributen vars namn börjar med rec:), kommer att provisioneras till ProptechOS som så kallad "Source information". Det gäller även de obligatoriska attributen "building", "equipment", "system". Om användaren inte vill att dessa attribut ska synas i ProptechOS som "Source information" och ej heller skickas till andra OutputConnections för jobbet, kan de markeras som "Comments" för att stanna lokalt i Miner. REC-specifika attribut som markeras som Constant eller Dynamic, kommer att skickas till andra OutputConnections för jobbet, men inte tas upp under "Source information" inom ProptechOS. |
| | |
| | Tabellen nedan anger även hur attributen sätts i grundutförandet, det vill säga om typen är "Comment" eller "Constant". Som vi nämnde ovan, kan användaren ändra typen beroende av om de ska skickas till mottagande system eller ej. |
| | |
| | ^ Attribut ^ Obligatorisk ^ [[miner:anvandning:miner:datapunkter#olika_typer_av_attributmetadata|Typ]] (skapas som) ^ Beskrivning ^ |
| | | building | Ja | Constant | Beteckning/benämning för aktuell byggnad (ex: "Skatan1" eller "5400"). Används för att skapa en hierarki av Devices och SuperDevices. | |
| | | equipment | Ja | Constant | Beteckning/benämning för aktuell utrustning (ex: "GT11"). Används för att skapa en hierarki av Devices och SuperDevices. | |
| | | system | Ja | Constant | Beteckning/benämning för aktuellt system (ex: "LB01", "RUM", "Elmätning"). Används för att skapa en hierarki av Devices och SuperDevices. | |
| | | rec:Device.Alias | | Constant | Skapas av Miner vid provisionering, byggs genom att ange Miners "Base-URL" /item/uuid-för-datapunkten-i-miner | |
| | | rec:Device.Class | | Comment | Skapas av Miner vid provisionering. Möjliga klasser: Sensor, Actuator. Klassen avgörs av egenskapen i datapunkten (dataAccess: r => Sensor, rw => Actuator) | |
| | | rec:Device.hasDefaultActuationInterface.Id | | Comment | Skapas av Miner vid provisioneringen, för Actuators för att identifiera tillåtna värden som skickas till/från denne. | |
| | | rec:Device.Id | | Comment | Skapas av Miner vid lyckad provisionering av Device. | |
| | | rec:Device.isMountedInBuildingComponent.Id | Ja | Constant | Obligatoriskt, anges av användaren | |
| | | rec:Device.Littera | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: samma värde som för orbiq_tag. | |
| | | rec:Device.MeasurementUnit | | Constant | Frivillig | |
| | | rec:Device.PlacementContext | | Constant | Frivillig | |
| | | rec:Device.PopularName | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: samma värde som för orbiq_tag | |
| | | rec:Device.QuantityKind | Ja | Constant | Obligatoriskt, anges av användaren | |
| | | rec:SuperDevice.Alias | | Constant | Skapas av Miner vid provisionering, byggs genom att ange Miners "Base-URL" /connection/uuid-för-connection-i-miner/Superdevice.Littera | |
| | | rec:SuperDevice.Id | | Comment | Skapas av Miner vid lyckad provisionering av SuperDevice | |
| | | rec:SuperDevice.isMountedInBuildingComponent.Id | | Comment | Skapas av Miner vid provisionering. Den tar samma värde som Devices isMountedInBuildingComponent.id. Om flera värden, så tar den det första. | |
| | | rec:SuperDevice.Littera | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: byggs med hjälp av värden för "building" - "system" - "equipment" | |
| | | rec:SuperDevice.PopularName | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: byggs med hjälp av värden för "building" - "system" - "equipment" | |
| | | rec:Version | | Comment | Skapas av Miner, för att ange vilka värdelistor som används vid provisioneringen. | |
| ===== Processbeskrivning ===== | ===== Processbeskrivning ===== |
| | Integration mot ProptechOS kan ske enligt två scenarion: |
| | * Miner ska provisionera och överföra mätdata |
| | * Provisionering är redan gjord och miner ska endast överföra mätdata. |
| | |
| | Nedan följer en guide där provisioneringen sker i Miner. |
| |
| Ett dataöverföringsjobb till ProptechOS kräver fler steg än överföring till exempelvis Orbiq. Användaren: | Ett dataöverföringsjobb till ProptechOS kräver fler steg än överföring till exempelvis Orbiq. Användaren: |
| * Skapar anslutning mot datakällan från vilken data skall hämtas | * Skapar anslutning mot datakällan från vilken data skall hämtas |
| * Skapar en anslutning mot ProptechOS för slutlig dataöverföring | * Skapar en anslutning mot ProptechOS för slutlig dataöverföring |
| * Skapar en MQTT anslutning för att kunna föra över data till ProptechOS i rätt format | * Skapar en MQTT anslutning för att kunna föra över uppmätt data till ProptechOS i rätt format och även ta emot överskrivningar från ProptechOS |
| * Skapar ett överföringsjobb från datakällan till MQTT-anslutningen. | * Skapar ett överföringsjobb från datakällan till MQTT-anslutningen |
| * Laddar värdelistor med förbestämda attribut från ProptechOS-anslutningen. | * Laddar värdelistor med förbestämda attribut från ProptechOS-anslutningen |
| * Taggar upp valda datapunkter med attribut från de laddade värdelistorna. | * Taggar upp valda datapunkter med attribut från de laddade värdelistorna |
| * Skapar ett grafjobb där jobbet mot datakällan väljs som input och ProptechOS-anslutningen väljs som output. | * Skapar ett grafjobb där jobbet mot datakällan väljs som input och ProptechOS-anslutningen väljs som output |
| * Startar grafjobbet för att provisionera datapunkterna som valdes i jobbet mot datakällan. | * Startar grafjobbet för att provisionera datapunkterna som valdes i jobbet mot datakällan |
| * Startar jobbet mot datakällan för att skicka upp data till ProptechOS. | * Startar jobbet mot datakällan för att skicka upp data till ProptechOS |
| | |
| Integration mot ProptechOS kan ske enligt två scenarion: | |
| * Provisioneringen är redan gjord och miner ska endast överföra mätdata | |
| * Miner ska provisionera och överföra mätdata. | |
| |
| Nedan följer en guide där användaren provisionerar data i Miner för överföring till ProptechOS. | Nedan redovisas en detaljerad beskrivning av de olika arbetsmomenten: |
| |
| ==== Inställning av anslutning mot ProptechOS för överföring av strömmande data ==== | ==== Inställning av anslutning mot ProptechOS för överföring av strömmande data ==== |
| |
| Det rekommenderas att låta provisioneringen bli klar innan dataöverföringen startas. | Det rekommenderas att låta provisioneringen bli klar innan dataöverföringen startas. |
| |
| ====== Organisering av devices och superdevices, namngivning av sensorer med mera ====== | |
| |
| Inom REC v3.2 kan datapunkter (sensors, actuators) organiseras i en hierarki av Devices. Miner stödjer en organisering av datapunkter (Items) i två nivåer som vi kallar för Device (underliggande nivå) och Superdevice (överliggande nivå). Användaren kan antingen själv ange nivåerna och benämna enheterna (PopularName, Littera), eller så kan Miner gruppera datapunkterna i två nivåer beroende av värden för andra obligatoriska Attributes. | |
| |
| ==== Attribut som kan förekomma vid provisionering ==== | |
| ^ Attribut ^ Obligatorisk ^ Typ (skapas som) ^ Beskrivning | |
| | egnaAttribut | | Valfritt | Användaren kan lägga till egna attribut vid behov. Alla attribut av typen Constant eller Dynamic, som inte är bland de REC-specifika attributen nedan (se attributen vars namn börjar med rec:), kommer att provisioneras till ProptechOS som så kallad "Source information". Det gäller även de obligatoriska attributen "building", "equipment", "system". Om användaren inte vill att dessa attribut ska synas i ProptechOS som "Source information", alternativt skickas till andra OutputConnections för jobbet, behöver de markeras som "Comments" för att stanna lokalt i Miner. REC-specifika attribut som markeras som Constant eller Dynamic, kommer att skickas till andra OutputConnections för jobbet. | | |
| | building | Ja | Constant | Beteckning/benämning för aktuell byggnad (ex: "Skatan1" eller "5400"). Används för att skapa en hierarki av Devices och SuperDevices. | | |
| | equipment | Ja | Constant | Beteckning/benämning för aktuell utrustning (ex: "GT11"). Används för att skapa en hierarki av Devices och SuperDevices. | | |
| | system | Ja | Constant | Beteckning/benämning för aktuellt system (ex: "LB01", "RUM", "Elmätning"). Används för att skapa en hierarki av Devices och SuperDevices. | | |
| | rec:Device.Alias | | Constant | Skapas av Miner vid provisionering, byggs genom att ange Miners "Base-URL" /item/uuid-för-datapunkten-i-miner | | |
| | rec:Device.Class | | Comment | Skapas av Miner vid provisionering. Möjliga klasser: Sensor, Actuator. Klassen avgörs av egenskapen i datapunkten (dataAccess: r => Sensor, rw => Actuator) | | |
| | rec:Device.hasDefaultActuationInterface.Id | | Comment | Skapas av Miner vid provisioneringen, för Actuators för att identifiera tillåtna värden som skickas till/från denne. | | |
| | rec:Device.Id | | Comment | Skapas av Miner vid lyckad provisionering av Device. | | |
| | rec:Device.isMountedInBuildingComponent.id | Ja | Constant | Obligatoriskt, anges av användaren | | |
| | rec:Device.Littera | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: samma värde som för orbiq_tag. | | |
| | rec:Device.MeasurementUnit | | Constant | Frivillig | | |
| | rec:Device.PlacementContext | | Constant | Frivillig | | |
| | rec:Device.PopularName | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: samma värde som för orbiq_tag | | |
| | rec:Device.QuantityKind | Ja | Constant | Obligatoriskt, anges av användaren | | |
| | rec:SuperDevice.Alias | | Constant | Skapas av Miner vid provisionering, byggs genom att ange Miners "Base-URL" /connection/uuid-för-connection-i-miner/Superdevice.Littera | | |
| | rec:SuperDevice.Id | | Comment | Skapas av Miner vid lyckad provisionering av SuperDevice | | |
| | rec:SuperDevice.isMountedInBuildingComponent.id | | Comment | Skapas av Miner vid provisionering. Den tar samma värde som Devices isMountedInBuildingComponent.id. Om flera värden, så tar den det första. | | |
| | rec:SuperDevice.Littera | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: byggs med hjälp av värden för "building" - "system" - "equipment" | | |
| | rec:SuperDevice.PopularName | Ja | Constant | Obligatoriskt, kan anges av användaren. Default: byggs med hjälp av värden för "building" - "system" - "equipment" | | |
| | rec:Version | | Comment | Skapas av Miner, för att ange vilka värdelistor som används vid provisioneringen. | | |