INFORMATION FRÅN VITEC VITEC Nyhetsdokument Vitec Energiuppföljning Version 1.64 april 2018 VITEC Affärsområde Fastighet www.vitec.se infofastighet@vitec.se Växel 090-15 49 00 GÖTEBORG: REDEG 1 B, 426 77 V. FRÖLUNDA KALMAR: SVENSKNABBEVÄGEN 25, BOX 751, 391 27 KALMAR, VÄXEL: 0480-43 45 00 LINKÖPING: SNICKAREGATAN 20, BOX 472, 581 05 LINKÖPING MALMÖ: RUNDELSGATAN 16, 211 36 MALMÖ STOCKHOLM: LINDHAGENSGATAN 116, BOX 30206, 104 25 STHLM, VÄXEL: 08-705 38 00 UMEÅ: TVISTEVÄGEN 47, BOX 7965, 907 19 UMEÅ VÄSTERÅS: KOPPARBERGSVÄGEN 17, BOX 209, 721 06 VÄSTERÅS ÖSTERSUND: PRÄSTGATAN 51, 831 34 ÖSTERSUND, VÄXEL: 08-705 38 00
Innehåll Inledning... 3 Ny funktionalitet Energiuppföljning... 4 Inställning för summering från timme till månad... 4 Omräkning, Export, Import, Radering av timvärden... 4 Steg 1. Välj export... 5 Steg 2: Inställningar... 6 Steg 3: Kör... 9 Steg 4: Spara och avsluta... 10 Schemalagd export... 11 Själva exporten... 12 Filexport... 12 Radera timmesavläsningar/ räkna om till månadsavläsning... 13 Redigering av mätarbyten via mätardialogen... 13 Varning vid drag and drop av mätare och räkneverk via trädet... 14 Ny funktionalitet generella funktioner... 15 Programrättningar... 15 Energiuppföljning... 15
Inledning I Vitec Energiuppföljning 1.64 har hantering av timvärden varit fokusområdet. En ny exportfunktionalitet har lagts till i programmet där det ges möjlighet att räkna om timvärden till månadsförbrukningsavläsningar och sedan ta bort timmesavläsningarna. Anledningen till denna nya funktionalitet är att spara lagringsyta för timvärden då dessa över tid skapar många rader i databasen och dessutom sällan behöver sparas mer än 3 år. Förutom export, radering och omräkning av timvärden finns hantering av mätarbyte nu i egenskapsdialogen för mätare. 3
Ny funktionalitet Energiuppföljning INSTÄLLNING FÖR SUMMERING FRÅN TIMME TILL MÅNAD Det är nu möjligt att via alternativdialogen för Vitec Energiuppföljning att ställa in dag från månadsskifte som timmesavläsningar kommer att summeras till månadsförbrukningar. Vid inställningen ovan så kommer timmesavläsningar att börjar summeras och räknas om till månadsförbrukningar från den 4:e dagen efter månadsskiftet. Detta är användbart i de fall där man vet att timmesavläsningar kommer in men det kan vara eftersläpning ett par dagar in i den nya månaden. OMRÄKNING, EXPORT, IMPORT, RADERING AV TIMVÄRDEN Omräkning, radering och export av timvärden görs som är en export specifik för Vitec Energiuppföljning. Exporten används till att hantera/rensa historiska timavläsningar. Eftersom timavläsningar genererar stora mängder data och dessutom normalt är en färskvara för kunderna så finns det behov av att kunna rensa bort historiska timavläsningar. Så exportens huvudsyfte är att kunna radera historiska timavläsningar, men med möjlighet att exportera dem till exportfiler som backup. Exporten kan även generera månadsvisa förbrukningsavläsningar utifrån motsvarande månads timavläsningar. På detta sätt behåller kunden månadsstatistiken men tar bort timmesstatistiken. Som komplement till exporten av timavläsningar så finns det ett importformat Energiuppföljning Import som kan läsa tillbaka exporterade timavläsningar. Exportformatet ingår i exportmodulen och kan därför köras manuellt via dess guide. 4
STEG 1. VÄLJ EXPORT Första steget i guiden är att välja vilken export som ska köras. Man kan antingen välja att skapa en ny export eller köra en befintlig export sparad sedan tidigare. Om du vill skapa en ny timmesexport så markerar du Ny export och formatet Omräkning/radering/export timavläsningar i underliggande lista. Om du vill använda en export med förvalda inställningar så markerar du Använd befintlig export och väljer en redan sparad timmesexport ur listan. 5
STEG 2: INSTÄLLNINGAR Steg 2 i exporten hanterar alla inställningar som styr vad exporten ska göra. Detta steg består av fyra flikar med inställningar som man ska gå igenom. Exporten har automatiska kontroller som varnar längst ned i fönstret (1) ifall man inte har matat in alla obligatoriska inställningar korrekt. När man gjort alla inställningar korrekt kan man gå vidare till steg 3. INSTÄLLNINGAR Under denna flik ligger de formatspecifika inställningarna Exportperiod (2) är en inställning som bara används vid manuella exporter och sparas därför inte mellan körningar. Inställningen anger för vilka perioder som exporten ska köra. Standardvärdet på T.o.m. styrs utifrån antalet månader för den schemalagda exportperioden. Detta innebär att om du angett 36 månader så kommer T.o.m. att initieras till 36 månader bakåt i tiden. Schemalagd exportperiod (3) däremot används enbart för schemalagda exporter och kommer därför att sparas. Till skillnad mot den manuella exportperioden så anger man här istället att exporten ska hantera alla timmesavläsningar äldre än ett antal månader. Som standard är denna gräns satt till 36 månader. Ex: Om man har sparat en export med gränsen 12 månader så kommer timmesavläsningar t.o.m. 2017-Feb att hanteras om exporten körs under 2018-Mar. Export anger om man vill exportera timmesavläsningarna till en exportfil. Som standard är denna inställning påslagen. Med denna funktion påslagen skapar exporten en exportfil med timmesavläsningar per mätare. Varje fil namnges utifrån mätarens importnyckel, mätarnamn samt en tidsstämpling. Om man har slagit på filexport så har man möjlighet att även skapa importnycklar på timmesmätare som saknar importnyckel. Detta är en bra funktion ifall man vill ha möjlighet att importera dessa timavläsningar till databasen igen, importen kräver nämligen en koppling via importnyckel. Skapade importnycklar består av en unik GUID för varje 6
mätare. Mätare med befintliga importnycklar lämnas orörda. Exporten kan exportera till olika varianter av textfiler och excelfiler. Det finns även en möjlighet att packa ihop alla skapade exportfiler till en gemensam zip-fil. Efter avslutad export kan man välja att radera hanterade timmesavläsningar. Denna inställning är inte vald som standard. Om man valt att radera timmesavläsningar så kommer användaren att få en varning för detta vid manuell export. Kryssar man i Skapa månadsavläsningar utifrån exporterade timmesavläsningar så kommer exporten att försöka skapa månadsvisa förbrukningsavläsningar utifrån ingående timmesavläsningar. Detta kan bara göras i samband med att man raderar timmesavläsningar. Månadsavläsningar skapas bara ifall det inte finns någon månadsavläsning sedan tidigare. Framräknad månadsförbrukning baseras på summan av månadens ingående timmesförbrukningar. Om det saknas några timmesförbrukningar så flaggas månadsavläsningen som ofullständig och om den baseras på någon uppskattad timmesavläsning så sätts den till uppskattad. Alla månadsavläsningar som skapats utifrån timmesavläsningar får en speciell flagga som anger detta. TRÄDFILTER Fliken trädfilter innehåller en lista med entiteter som utgår från vald trädnod i huvudfönstret i VE. Listan visar vald trädnod samt kopplade noder på underliggande nivå. Exporten körs på samtliga underliggande timmesmätare till markerade noder. EXPORTFIL Fliken Exportfil anger vart man vill lagra exporterade timmesfiler. En lagringsplats måste anges även om inga exportfiler ska skapas. Förutom att man anger vart filer ska lagras så kan man även skicka exportfilerna via e-post och/eller lägga upp filerna på en ftp. 7
LOGGNING Flik med inställningar som anger vart logfiler från exporten ska lagras. Hur loggfilerna ska lagras styrs utifrån hur man valt att lagra exportfilerna. Om man har valt Lagring i lokal/delad mapp men inte angivit någon sökväg så kommer inga logfiler att sparas. Det finns möjlighet att skicka de sparade logfilerna via e-post efter avslutad export och man kan även välja att de bara ska skickas ifall något gått fel vid exporten. 8
STEG 3: KÖR Steg 3 är till för att köra tillfälliga exporter eller för att testa en export som man vill spara som favorit. Om man kryssar i Visa exportfil efter avslutad export så kommer den sist skapade exportfilen i körningen att visas. Om man valt att packa ihop exportfilerna så är det zip-filen som öppnas. Om exporten är inställd för att radera timmesavläsningar så får användaren en varning innan det sker med möjlighet att avbryta. Flikarna Exporterat/Fellista innehåller statusen på körningen och är samma information som sedan sparas i logfilerna. 9
STEG 4: SPARA OCH AVSLUTA Sista steget ger möjlighet att spara exporten om den ska kunna köras flera gånger, antingen manuellt eller som en schemalagd tjänst. Alla sparade exporter visas med sitt sparade Namn och Beskrivning i listan med befintliga exporter i guidens första steg. I samband med att man sparar en export kan man direkt lägga upp exporten som en schemalagd tjänst om man kryssar i Gå vidare till schemaläggning efter att exporten har sparats. Hur schemaläggningen går till finns beskrivet i ett eget kapitel. 10
SCHEMALAGD EXPORT Schemaläggningen av denna export sköts via det generella verktyget för schemalagda tjänster. 1. Skapa en ny schemalagd tjänst genom att trycka Ny. 2. Välj tjänsten Exportmodul i steg 1 och ge tjänsten ett lämpligt namn, gå sedan vidare med Nästa >>. 3. Ange om du vill skicka status på kört tjänst i steg 2 4. Ange när och hur ofta tjänsten ska köras under steg 3 till 4 5. I steg 5 väljer du export som du vill köra. Observera att listan med exportfavoriter visas med sparat namn och beskrivning. 6. Spara och avsluta i steg 6 till 7. 11
SJÄLVA EXPORTEN Exporten kan köras antingen manuellt utifrån aktuella inställningar i exportguiden eller som en schemalagd tjänst via sparade inställningar. Den stora skillnaden består i vilka perioder som hanteras. Vid den manuella körningen så kan man ställa in exakt vilka perioder som ska ingå medan den schemalagda körningen avser alla perioder äldre än sparat antal månader. Exporten börjar med att plocka ut samtliga mätare som har timmesförbrukningar för valda perioder och som ingår i valt trädfilter. Detta för att exporten inte ska behöva jobba med mer data än nödvändigt. Om användaren valt att exportera timmesförbrukningar så görs detta först. Därefter körs steget med att räkna om timmesförbrukningar till månadsavläsningar och att kasta timmesavläsningar. FILEXPORT Filexporten används som säkerhetskopiering av timmesavläsningarna eller som export till ett annat externt system. Om man använder den som säkerhetskopiering finns det ett motsvarande importformat som kan läsa dessa filer direkt under förutsättning att mätarna i filen har importnycklar. Om mätarna i VE saknar importnycklar så kan exporten generera dessa som ett steg innan exportfilerna skapas, vilket säkerställer att filerna kan importeras. De genererade importnycklarna består av en unik nyckel av typen GUID. Endast timmesmätare som ingår i exporten kan få importnycklar skapade. Exporten skapar en fil per mätare med ett namn på formen Importnyckel_Mätarnamn_Datum_Tid.ext. Filen består av en överskriftsrad och ett antal rader med en avläsning per räkneverk och timme. Kolumn Namn Beskrivning 1 Fastighet Fastighetens inställda visningsnamn i VE 2 Byggnad Byggnadens inställda visningsnamn i VE 3 Objekt Objektets inställda visningsnamn i VE 4 Mätare Mätarens inställda visningsnamn i VE 5 Importnyckel Mätarens importnyckel som används vid import 6 Abonnemangsnummer Mätarens abonnemangsnummer 7 MätarId Mätarens databas-id 8 VerkId Räkneverkets databas-id 9 Position Räkneverkspositionen 10 FSlag Id Databas-Id till räkneverkets förbrukningsslag 11 FSlag namn Förbrukningsslagets namn 12 Enhet Avläst enhet 13 År Avläsningsperiod år 14 Månad Avläsningsperiod månad (1-12) 15 Dag Avläsningsperiod dag (1-31) 16 Timme Avläsningsperiod timme (0-23) 17 Mätarställning Avläst mätarställning. -1 om förbrukningsavläsning 12
18 Förbrukningsavläsning Avläst förbrukning. -1 om mätarställningsavläsning 19 Förbrukning Framräknad förbrukning för perioden 20 Basförbrukning Framräknad förbrukning i basenhet 21 Låst Är avläsningen låst för omräkning i VE (True/False) 22 Flaggor Databasflaggor på avläsningen. Se specifikation i programkod Ex: RADERA TIMMESAVLÄSNINGAR/ RÄKNA OM TILL MÅNADSAVLÄSNING Radering av timmesavläsningar för valda perioder med möjlighet att räkna om timmesavläsningarna till månadsavläsning. Vid manuell körning så får användaren en varning om att timmesavläsningar är på väg att kastas, med möjlighet att avbryta. Vid schemalagd körning så finns givetvis inte denna möjlighet. Omräkning av timmesförbrukningar till månadsavläsningar genererar en förbrukningsavläsning med ett avläsningsdatum per den 1:e i efterföljande månad. Förbrukningen beräknas som summan av månadens alla timförbrukningar avrundat till 5 decimaler. Förbrukningen markeras för omräkning samt att den härstammar från timmesförbrukningar. Om någon timmesförbrukning är satt som uppskattad så sätts även månadsavläsningen som uppskattad och om månaden saknar någon timmesförbrukning så sätts den även som ofullständig. Om en mätare redan har en befintlig månadsavläsning så kommer den inte att bytas ut. Endast mätare med saknade månadsavläsningar kan alltså en framräknad månadsavläsning. Alla nya månadsavläsningar loggas. REDIGERING AV MÄTARBYTEN VIA MÄTARDIALOGEN I mätardialogen är det nu möjligt att under räkneverksfliken markera ett räkneverk där det skett ett mätarbyte och redigera det valda mätarbytet. 13
I den dialog som öppnas via Redigera mätarbyte kan datum för mätarbyte, slut- och startavläsning, konstant, siffror, mätarnummer och ofullständigt mätarbyte ändras. VARNING VID DRAG AND DROP AV MÄTARE OCH RÄKNEVERK VIA TRÄDET I Vitec Energiuppföljning är det möjligt att dra och släppa mätare mellan fastigheter och byggnader. Räkneverk kan dra och släppas på andra mätare. Vid en flytt i trädet av ett räkneverk eller en mätare kommer systemet att begära ett svar innan flytten genomförs. Huruvida denna fråga ska visas eller ej vid en flytt finns som en användarinställning under fliken objektträd. Som grundinställning ställer systemet alltid frågan. 14
Ny funktionalitet generella funktioner Förutom nyheter som är direkt kopplade till Energiuppföljning finns det några nya funktioner som är införda i generella delar som används i Hyra, Teknisk Förvaltning, Verksamhetsanalys och Energiuppföljning. Läs om detta på: http://help.fastighet.vitec.net/vitecgemensamt/news/1.64/versionsnyheter%20gemensamt%2 0x.64.pdf Programrättningar ENERGIUPPFÖLJNING 47519 Listan över mätare att läsa av kan inte visas på fastighetswebben (ver x.63-180307). Problemet är åtgärdat 47117 Funktioner-tabben i ribbon blir större och större Åtgärdat. 46684 Exportformatet 'Månadsförbrukningar och avläsningar' (flera månader) hämtar inte korrekt vid glesa avläsningar på förbrukningsmätare (ver x.62-180207). Ifall man väljer fler månader än 1 och mätaren har glesa förbrukningsavläsningar exporteras data bara fram till första månaden där förbrukning inte finns. Åtgärdat. 46604 Avläsningsimport Metry: Uppläsning av mätare misslyckas vid skapande av nya mätare (ver x.62-180207). Problemet berodde på utläsning av dublettmätare hos Metry. Detta är nu hanterat så att uthämtningen av mätare tar nu hänsyn till mätarnas alla "generationer" så att endast en instans av varje mätare plockas ut. 46523 Import Metry: Avläsningar för fjärrvärme och flöde på olika mätare hämtar inte ut flödet (ver x.62-180207). 15
Om man ställt in att man har energi och flöde separerade på olika mätare så kommer importen att kontrollera om det finns en separat mätare för flödet i VE. Om separat mätare finns så kommer flödet att hämtas ut. 44979 Tvåspråkig VE, Formatproblem vid inmatning i historiska avläsningar (ver x.62-180221). Vi har ändrat så att culture på maskinen inte sätts om längre. 16