| Börjar med Föregående version. Nästa version. | Föregående version. |
| miner:integrationer:metadata [2026/06/05 09:15] – [Grundattribut som inte bör tas bort] dokuadmin | miner:integrationer:metadata [2026/06/05 10:45] (aktuell) – [Namn, beteckningar och visningsnamn] dokuadmin |
|---|
| * kombinationer av flera olika källor | * kombinationer av flera olika källor |
| |
| Exempel på standardiserade eller återanvändbara metadataupplägg kan vara klasslistor, komponentlistor, systembeteckningar, namngivningsregler eller scheman som används för en viss mottagande plattform. | Exempel på standardiserade eller återanvändbara metadataupplägg kan vara klasslistor, komponentlistor, klasslistor ur ontologier, systembeteckningar, namngivningsregler eller scheman som används för en viss mottagande plattform. |
| |
| Vissa anslutningar kan också tillhandahålla metadatalistor eller mallar som stöd i onboardingarbetet. Det kan exempelvis handla om listor över byggnader, rum, komponenter, klasser eller andra objekt som datapunkter kan kopplas till. | Vissa anslutningar kan också tillhandahålla metadatalistor eller mallar som stöd i onboardingarbetet. Det kan exempelvis handla om listor över byggnader, rum, komponenter, klasser eller andra objekt som datapunkter kan kopplas till. |
| * eventuellt ett prefix eller en struktur som anger hur attributet ska tolkas | * eventuellt ett prefix eller en struktur som anger hur attributet ska tolkas |
| |
| Exempel: | Exempel för att illustrera principen: |
| |
| ^ Attribut ^ Exempelvärde ^ Beskrivning ^ | ^ Attribut ^ Exempelvärde ^ Typ av attribut ^ Beskrivning ^ |
| | ''source_label'' | ''LB01-GT11-PV'' | Ursprunglig beteckning eller etikett från källsystemet. | | | ''source_label'' | ''VS01-EM01-PV'' | Grundattribut | Ursprunglig beteckning eller etikett från källsystemet. | |
| | ''data_access'' | ''r'' | Anger om datapunkten kan läsas eller skrivas. | | | ''label'' | ''2455_A-VS01-EM01-E'' | Grundattribut | Kundspecifik standard, där beteckningen ska anges enligt standarden: fastighetsbeteckning_byggnadsbetecking-systembeteckning-komponentbeteckning-komponentkvalificerare. Komponentkvalificerarna ska vidare baseras på en standardiserad lista, där "E" representerar "Energianvändning". | |
| | ''building'' | ''Hus A'' | Anger byggnad eller anläggning. | | | ''data_access'' | ''r'' | Grundattribut | Anger om datapunkten kan läsas eller skrivas. | |
| | ''system'' | ''LB01'' | Anger tekniskt system. | | | ''config_status'' | ''Done'' | Grundattribut | Anger att datapunkten är färdigkonfigurerad. | |
| | ''equipment'' | ''GT11'' | Anger utrustning eller komponent. | | | ''!building'' | ''Hus A'' | Konstant | Anger byggnad eller anläggning. | |
| | ''qualifier'' | ''PV'' | Anger datapunktens funktion eller kvalificerare. | | | ''!system'' | ''VS01'' | Konstant | Anger tekniskt system. | |
| | ''unit'' | ''°C'' | Anger enhet. | | | ''!equipment'' | ''EM01'' | Konstant | Anger utrustning eller komponent. | |
| | ''quantity_kind'' | ''Temperatur'' | Anger vilken typ av mätstorhet datapunkten representerar. | | | ''!qualifier'' | ''E'' | Konstant | Anger datapunktens funktion eller kvalificerare. | |
| | ''display_name'' | ''Tilluftstemperatur'' | Namn som kan visas i mottagande system. | | | ''!unit'' | ''kWh'' | Konstant | Anger enhet. | |
| | ''config_status'' | ''Done'' | Anger att datapunkten är färdigkonfigurerad. | | | ''!brick:PointClass'' | ''Energy_Usage_Sensor'' | Konstant | Anger klassificering av datapunkten enligt Brick Schema. | |
| | | ''!brick:SystemClass'' | ''Radiation_Hot_Water_System'' | Konstant | Anger klassificering av systemet enligt Brick Schema. | |
| | | ''!brick:EquipmentClass'' | ''Hot_Water_Meter'' | Konstant | Anger klassificering av komponenten enligt Brick Schema. | |
| | | ''!description'' | ''Energimätning VS01'' | Konstant | Namn som kan visas i mottagande system. | |
| | | ''@qa_status'' | ''0'' | Dynamisk | Anpassad flagga för att ange om värdet för mätarens räkneverk har kontrollerats mot den fysiska mätaren eller ej. | |
| |
| Fältnamn och värden kan anpassas efter projektets behov. I vissa integrationer används särskilda prefix eller scheman för att skilja mellan olika typer av attribut. | Fältnamn och värden kan anpassas efter projektets behov. I vissa integrationer används särskilda prefix eller scheman för att skilja mellan olika typer av attribut. |
| | ''@'' | Dynamiskt attribut | Attribut vars värde kan ändras över tid och hanteras som dynamisk information. | Status, driftläge eller annan metadata som kan förändras. | | | ''@'' | Dynamiskt attribut | Attribut vars värde kan ändras över tid och hanteras som dynamisk information. | Status, driftläge eller annan metadata som kan förändras. | |
| | ''!'' | Konstant attribut | Attribut som ska behandlas som fast metadata. | Byggnad, system, komponent, enhet eller annan metadata som ska gälla som konstant information. | | | ''!'' | Konstant attribut | Attribut som ska behandlas som fast metadata. | Byggnad, system, komponent, enhet eller annan metadata som ska gälla som konstant information. | |
| | inget prefix | Grundattribut eller vanligt attribut | Attribut som hanteras direkt av Miner eller av aktuell integration. | ''io_label'', ''cov'', ''config_status'', ''data_access'' med flera. | | | inget prefix | Grundattribut | Attribut som hanteras direkt av Miner eller av aktuell integration. | ''source_label'', ''cov'', ''config_status'', ''data_access'' med flera. | |
| |
| Exakt hur prefixen används kan bero på integration och mottagande system. Kontrollera därför alltid aktuellt arbetsflöde och integrationsprofil. | Exakt hur prefixen används kan bero på integration och mottagande system. Kontrollera därför alltid aktuellt arbetsflöde och integrationsprofil. |
| | ''#onboarding'' | ''9'' | Datapunkten behöver kontrolleras eller diskuteras vidare. | | | ''#onboarding'' | ''9'' | Datapunkten behöver kontrolleras eller diskuteras vidare. | |
| | ''#comment'' | ''Kontrollera placering'' | Intern notering. | | | ''#comment'' | ''Kontrollera placering'' | Intern notering. | |
| | ''#building'' | ''Hus A'' | Arbetsfält för byggnad. | | | ''#building'' | ''Hus A'' | Arbetsfält för byggnad. Värdet ska inte sparas med avläsningen. | |
| | ''#system'' | ''LB01'' | Arbetsfält för systembeteckning. | | | ''#system'' | ''LB01'' | Arbetsfält för systembeteckning. Värdet ska inte sparas med avläsningen. | |
| | ''#equipment'' | ''GT11'' | Arbetsfält för komponentbeteckning. | | | ''#equipment'' | ''GT11'' | Arbetsfält för komponentbeteckning. Värdet ska inte sparas med avläsningen. | |
| | ''#qualifier'' | ''PV'' | Arbetsfält för datapunktens funktion eller kvalificerare. | | | ''#qualifier'' | ''PV'' | Arbetsfält för datapunktens funktion eller kvalificerare. Värdet ska inte sparas med avläsningen. | |
| |
| Prefixet ''#'' är särskilt användbart i kalkylblad och CSV-underlag där man vill ha med arbetskolumner som stöd för klassificering, formler eller QA utan att dessa nödvändigtvis ska bli metadata i mottagande system. | Prefixet ''#'' är särskilt användbart i kalkylblad och CSV-underlag där man vill ha med arbetskolumner som stöd för klassificering, formler eller QA utan att dessa nödvändigtvis ska bli metadata i mottagande system. |
| | |
| | **Observera** att attribut med prefixet ''#'' kommer att överföras till grafdatabaser som del av Miners graf, om det aktuella jobbet är del av ett dataöverföringsjobb till en grafdatabas. I grafdatabasen kommer det däremot att anges att attributet är att anse som just en kommentar. |
| |
| ===== Prefixet @ ===== | ===== Prefixet @ ===== |
| |
| * ''UUID'' | * ''UUID'' |
| * ''io_label'' | * ''source_label'' |
| * ''orbiq_label'' | * ''label'' |
| * ''poll_interval_sec'' | * ''poll_interval_sec'' |
| * ''cov'' | * ''cov'' |
| Vilken metadata som är obligatorisk beror på användningsfallet. | Vilken metadata som är obligatorisk beror på användningsfallet. |
| |
| En enkel dataöverföring till en tidsseriedatabas kan fungera med relativt lite metadata, medan provisionering till en mottagande plattform eller grafdatabas ofta kräver mer strukturerad information. | En enkel dataöverföring till en tidsseriedatabas kan fungera med relativt lite metadata, medan provisionering till en mottagande plattform eller grafdatabas kan kräva strukturerad information. |
| |
| Exempel på metadata som ofta är viktig: | Exempel på metadata som ofta är viktig: |
| * kommentarer | * kommentarer |
| * kvalitetssäkringsstatus | * kvalitetssäkringsstatus |
| | * systemspecifika attribut |
| * kundspecifika attribut | * kundspecifika attribut |
| |
| | Komponentbeteckning | Anger vilken komponent datapunkten hör till. | ''GT11'' | | | Komponentbeteckning | Anger vilken komponent datapunkten hör till. | ''GT11'' | |
| | Funktion | Anger datapunktens roll. | ''Mätvärde'' | | | Funktion | Anger datapunktens roll. | ''Mätvärde'' | |
| | Visningsnamn | Användarvänligt namn i mottagande system. | ''Tilluftstemperatur'' | | | Visningsnamn | Användarvänligt namn i mottagande system. | ''Tilluftstemperatur LB01'' | |
| |
| En bra princip är att bevara teknisk metadata för spårbarhet och samtidigt komplettera med läsbara namn för användning i gränssnitt, rapporter och analyser. | En bra princip är att bevara teknisk metadata för spårbarhet och samtidigt komplettera med läsbara namn för användning i gränssnitt, rapporter och analyser. |