Kundspecifik dokumentation HUSF

Om ni behöver hjälp eller har förslag på förbättringar av våra tjänster, får ni gärna höra av er till oss.

Se denna sida.

Se lathund här.

• Här finns en kort lathund.
• Viktigt att tänka på att ”teckenkodningen” vid import och export av CSV-filer ska vara UTF-8.

• building: fastighetsbeteckning, exempelvis ”6501-90001” [obligatoriskt]
• source: datakälla, exempelvis DUC-beteckning ”AS01-Fidelix” [obligatoriskt]
• system: ex: ”LB01” [obligatoriskt]
• equipment: beteckning för utrustning/komponent, ex: ”GT11” [obligatoriskt]
• qualifier: komponentkvalifierare, exempelvis ”MV” (mätvärde), ”BV” (börvärde) med mera. I enlighet med standard för märkhandling. [obligatoriskt]
• room: rumsbeteckning eller rumsfunktion, exempelvis ”211”, ”KÖK” [obligatoriskt, där det finns rum]
• floor: våningsplan
• zone: information om del av byggnad som inte kan anges via room eller floor, exempelvis ”norrfasad”
• dataAccess: berättar om punkten är skrivbar eller bara läsbar
• direction: berättar om åt vilket håll som rummet/utrymmet ligger mot, eller vilken fasad som ett värmesystem betjänar, exempelvis ”N” eller ”S”.

Vi använder dessa prefixer för att berätta hur Miner ska hantera uppladdning och ändring av metadata (eller attribut som de kallas av oss på iquest):

• #-tecknet betyder att attributet ska hanteras som en kommentar som inte laddas upp till databasen, exempelvis kan ni använda ”#import” för beteckning för en kolumn som ni använder för att välja ut de datapunkter som ska ingå i jobbet
• @-tecknet används för att ange att attributet är ”dynamisk”. Det ska laddas upp till databasen och eventuella ändringar av värdet ska bara speglas i data som laddas upp från och med ändringstillfället. Kolumnen ”@status” kan exempelvis få olika värden över tiden, såsom 1, 2, 3.
• !-tecknet används för att ange att attributet är att betrakta som ”konstant”. Det laddas upp till databasen och eventuella ändringar av värdet ska speglas till hela tidsserien. Om ni använder Miner i kombination med Orbiq, så ser Orbiq till att uppdatera hela tidsserien med det aktuella värdet för attributet. Exempelvis ”!system” som används för att ange systembeteckningen är konstant för hela tidsserien. Om vi har värdet ”!system” = ”LB01” för en viss datapunkt eller ”item”, så innebär det att hela tidsserien ska kunna filtreras fram när ”system” = ”LB01”.

Kommunikationen mellan Miner och Fidelix sker via Fidelix interna protokoll och port 1235. Ifall denna port inte kan nås ”utifrån”, det vill säga från Orbiq-molnet, kan det behövas en portmappning enligt nedan:

Fidelix:1235 <-> VPN-router:1235 <-> Miner

Vid avancerade frågor, kan ni använda filter som bygger på så kallade ”regular expressions”. Kolla här för mer information.