Installatiehandleiding Vabi Assets Energie 6.11

Transcriptie

1 Installatiehandleiding Vabi Assets Energie 6.11

2 Inhoudsopgave Vabi Assets Energie installeren... 3 Voordat u gaat installeren... 3 Systeemeisen... 3 De installatiestappen... 4 Het Installatie-Menu... 4 Installeren van de database server... 6 Aanmaken van een database... 6 Installeren van Assets Energie op een cliënt Aanmaken van een DSN op een cliënt... 8 Configureren van connectie, beheer- en adviseursgegevens... 9 Instellen van de connectie... 9 Instellen van de beheergegevens Instellen van de adviseursgegevens Instellen van de firewall voor het afmelden bij RVO.nl Optioneel: bestandslocaties Elementen vastgoed_files.xml Automatisch afmelden Automatische registratiemomenten Inlezen labelhistorie Updates Update database Update applicatie Belangrijke wijzigingen Templates, bibliotheken en andere bestanden Woonlasten webservice en calculator updaten Versie Versie Versie Bijlage A Update templates en andere bestanden Installatiehandleiding Pagina 2 van 24

3 Vabi Assets Energie installeren Voordat u gaat installeren Voordat u Vabi Assets Energie gaat installeren is het belangrijk deze paragraaf goed te begrijpen. Zeker voor het installeren van een update over een bestaande versie worden hier een aantal belangrijke zaken beschreven. Zoals u verderop (in paragraaf Optioneel: bestandslocaties ) kunt lezen maakt Vabi Assets Energie gebruik van extra bestanden zoals XML- en Word documenten. Bij de configuratie van Vabi Assets Energie kunt u zelf opgeven waar deze bestanden geplaatst worden. Dit is in principe een eenmalige actie, alleen bij installatie, maar bijvoorbeeld ook bij migratie naar een nieuwe server. Bij de meeste updates van Vabi Assets Energie worden deze bestanden weer verder uitgebreid of verbeterd. Het installatieprogramma van Vabi Assets Energie gaat echter altijd uit van de standaard locaties. Dus wanneer u deze locaties handmatig heeft aangepast, en de bijbehorende bestanden ook naar de nieuwe locatie heeft verplaatst, zullen ze bij het installeren van een update niet automatisch op de juiste locatie worden bijgewerkt. Ook kan het voorkomen dat er nieuwe bestanden en/of hulpprogramma s worden toegevoegd, waar misschien weer extra op gelet moet worden bij installatie. Per versie (vanaf 3.0x) volgt een overzicht van extra aandachtspunten bij het installeren van een update van Vabi Assets Energie. Systeemeisen Vabi Assets Energie heeft de volgende systeemeisen: Processor Geheugen Scherm Besturingssysteem Office* PDF reader Database server.net Framework Aanbevolen is een Multi-core processor Minimaal 1024 MB intern geheugen, aanbevolen is 2048 MB Minimaal 800x600 resolutie, aanbevolen is 1280x1024 (of hoger) Microsoft Windows 32/64 bit MS Office 2007 (of hoger), lokaal geïnstalleerd Microsoft SQL Server 2008 Express (of hoger) Versie (of hoger) * Voor een volledige werking van Vabi Assets Energie moet MS Office en een PDF reader op de client beschikbaar zijn. Bij gebruik van Vabi Assets Energie moet u rekening houden met de opslagcapaciteit voor: Database Documenten History dir Alternatieve locatie Woningdossier De grootte van de database zal, afhankelijk van het aantal woningen, circa 0,5 tot 1 GB zijn. Houdt rekening met ongeveer 0,5 tot 1 MB per VHE, wanneer alle woningen uiteindelijk zijn afgemeld. Houdt hierbij rekening met ongeveer 1 tot 2 MB per VHE (na 5 jaar historie). Wanneer dit veld uitgevinkt is (default), dan wordt er geen historie bijgehouden. Houdt rekening met ongeveer 0,5 tot 1 MB per VHE, wanneer alle woningen uiteindelijk zijn afgemeld. In eigen beheer van de corporatie. Installatiehandleiding Pagina 3 van 24

4 De installatiestappen Voor het installeren van Vabi Assets Energie dient u een aantal stappen te doorlopen. Aangezien de applicatie met een database server werkt, worden twee installatieprocessen onderscheiden: de installatie van de database server en de installatie van de applicatie op de cliënt. De stappen voor het installeren van de database server zijn als volgt: installeren van de database server; aanmaken van een database instantie voor Vabi Assets Energie. De stappen voor het installeren van de applicatie op de cliënt zijn als volgt: installeren van de applicatie; installeren van de juiste ODBC-driver voor de database connectie; aanmaken van een DSN voor de database instantie; configureren van connectie, beheer- en adviseursgegevens; instellen van de firewall voor het afmelden bij; optioneel: bestandslocaties. Het Installatie-Menu Download de installatie bestanden van de Supportpagina en pak het zip-bestand uit. U kunt de installatie starten door 'installatiescherm.exe' te openen. Het installatiescherm bestaat uit het dialoogvenster zoals in, met een tabblad voor Installatie en voor Update. Figuur 1: Installatie menu - Installatie Installatiehandleiding Pagina 4 van 24

5 Figuur 2: Installatie menu - Update Vanaf het tabblad Update (zie figuur 2) kunt u de acties uitvoeren bij installatie van een update van Vabi Assets Energie: Update Database (op server): Klik hier om de bestaande Vabi Assets Energie (of voorheen Vabi Vastgoed) database op de server bij te werken naar de meest recente versie. Mocht er bij deze release van Vabi Assets Energie geen database-update nodig zijn, dan zal het programma dit melden. Wat is er veranderd: Hiermee opent u een document waarin de wijzigingen sinds de vorige versie(s) van Vabi Assets Energie (en Vabi Vastgoed) beschreven staan. Update Vabi Assets Energie (op cliënt): Hiermee installeert u de nieuwe versie van Vabi Assets Energie op een cliënt PC. Deze installatie wordt beschreven in de paragraaf Installeren van Assets Energie op een cliënt. Aanmaken taak voor maandelijks registratiemoment: Hiermee wordt een hulpprogramma gestart voor het instellen van de Windows Task Manager voor het maandelijks aanmaken van een registratiemoment. Installatiehandleiding Pagina 5 van 24

6 Installeren van de database server Heeft u al één van de genoemde ondersteunde database servers in uw bedrijfsnetwerk geïnstalleerd staan? Dan kunt u ook gebruikmaken van uw bestaande database server. Bij het installeren van een database server kunt u gebruik maken van: MS SQL Server 2008 (Express); MS SQL Server 2008 r2 (Express); MS SQL Server 2012 (Express); MS SQL Server 2012 r2 (Express); MS SQL Server 2014 (Express). Aanmaken van een database Voor gebruik van Vabi Assets Energie dient u een eigen database instantie aan te maken. Wanneer u als corporatie zelf de database beheert, dan hoeft u slechts één database aan te maken. Bent u een adviesbureau die voor meerdere corporaties de woningen beheert, dan dient u voor elke klant (woningcorporatie) een aparte database aan te maken. Om een database aan te maken op de database server, klikt u in het Installatie-Menu op de knop [Maak nieuwe klantdatabase (op database server)]. U krijgt het onderstaande scherm: Figuur 3: Maak een nieuwe klantdatabase Installatiehandleiding Pagina 6 van 24

7 Wanneer u dit schermt niet krijgt, kunt u deze tool ook direct via de Windows Verkenner opstarten met het uitvoerbare bestand Assets Energie\tools\creeerdatabase.exe op de Installatie bestand. U vult in dit scherm de volgende eigenschappen in: Klantnaam Hier vult u de naam van de woningcorporatie in waarvoor deze database instantie wordt aangemaakt. Klantnummer Hier vult u het klantnummer in van de woningcorporatie dat u van Vabi Assets Energie per heeft ontvangen. Aantal VHE Hier vult u het aantal VHE in waarvoor u een licentie heft, en in de keuzelijst selecteert u het bijbehorende licentietype. Produktsleutel: Hier vult u de Product Key in van de woningcorporatie die u van Vabi Assets Energie per heeft ontvangen. sa user Hier vult u de administrator van de database server in. Voor MSSQL is dit standaard sa. Hierdoor heeft deze tool voldoende rechten om de database op de database server aan te maken. Wachtwoord Hier vult u het wachtwoord van de administrator in van de database server. Server Hier vult u de servernaam(\instance) in waarop de database server is geïnstalleerd. U kunt hiervoor het IP-adres / de servernaam gebruiken. Default user Hier vult u de standaard gebruiker in die vanuit de Vabi Assets Energie applicatie verbinding maakt met de Vabi Assets Energie database. User wachtwoord Het wachtwoord van de hierboven ingevulde standaard gebruiker. Tenslotte klikt u op de knop [Maak script aan] om de database instantie aan te maken. Op de database server wordt dan een database instantie aangemaakt met de prefix vabi_ met daaraan vastgeplakt de ingevoerde Klantnaam. Installeren van Assets Energie op een cliënt. Nadat u de database server en de database instantie(s) heeft geïnstalleerd, kunt u de Vabi Assets Energie applicatie op de cliënt van de gebruikers installeren. Hiervoor volgt u de stappen van de setup om de applicatie te installeren. Installatiehandleiding Pagina 7 van 24

8 Aanmaken van een DSN op een cliënt Om de Vabi Assets Energie applicatie op de cliënt te verbinden met de database instantie op de database server dient u een DSN aan te maken op de cliënt. U kunt een DSN op twee manieren aanmaken: met behulp van de DSN-tool in het Installatie-Menu; met behulp van de DSN Manager van Windows. In deze handleiding wordt alleen de DSN-tool uitgelegd. Wanneer u gebruik wilt maken van de DSN Manager van Windows, dan kunt u de handleiding van Windows raadplegen. Figuur 4: DSN tool Ga als volgt te werk: Start de DSN-tool op via het Installatie-Menu met behulp van de knop [Maak dsn naar database aan (op cliënt) ]. Wanneer u geen nieuw scherm krijgt (zie hierboven), kunt u de tool ook via de Windows Verkenner opstarten: Assets Energie\tools\dsn-creator.exe. Links ziet u een lijst met bestaande DSN s op de computer. Dubbelklik op een DSN om deze aan te passen. Als u alleen een nieuwe DSN wilt aanmaken, dan kunt u deze lijst negeren. DSN type: kies het type DSN. Een User -DSN is alleen beschikbaar voor de huidig ingelogde user. Een System -DSN is beschikbaar voor alle users op de PC. DSN naam: kies een naam voor de DSN. Gebruik bij voorkeur de naam van de woningcorporatie (zonder spaties). Server: Hier vult u de server in waarop de database server is geïnstalleerd. U kunt hiervoor het IP-adres, de computernaam of localhost (wanneer deze tool op de server zelf wordt uitgevoerd) gebruiken. Database: Hier vult u de naam van de database instantie in. Dit is de prefix vabi_ met daaraan vast de klantnaam die u heeft gebruikt bij het aanmaken van de database instantie (zie paragraaf Aanmaken van een database ). Een voorbeeld is vabi_klant. Omschrijving: Geef een beschrijving van de DSN. Dit veld is optioneel. Type: Selecteer hier het type database server waar u connectie mee wilt maken. Bij een MSSQL Server dient u hier SQL Server te kiezen. Klik op de knop [Test DSN] om de DSN te testen. Klik op de knop [Maak DSN] om de DSN aan te maken. Installatiehandleiding Pagina 8 van 24

9 Configureren van connectie, beheer- en adviseursgegevens Voordat u aan de slag kunt gaan met Vabi Assets Energie dient u eerst de basis instellingen van de applicatie op de cliënt te configureren. Instellen van de connectie U dient op elke cliënt de connectie eenmalig te configureren. Start hiervoor op een cliënt de Vabi Assets Energie applicatie op. Na het opstartscherm krijgt u een configuratiescherm voor de connectie (zie figuur 5). Figuur 5: Connectie configureren Wanneer u het bovenstaande scherm niet krijgt, dan klikt u in beheer menu [Database] op menu-item [Instellingen database connectie]. Vul hier de volgende velden in: DSN: Kies de DSN voor de gewenste database connectie. Voor meer informatie over DSN s, kunt u paragraaf Aanmaken van een DSN op een client raadplegen. Gebruiker: Hier vult u de user naam in voor het inloggen op de database server. Wachtwoord: Vul hier het wachtwoord (behorende bij de user) in voor het inloggen op de database server. Type: Dit veld wordt automatisch ingevuld. Klik op de knop [OK] om de connectie op te slaan. Deze connectie instellingen worden bewaard in een configuratiebestand (standaard wordt deze bewaard in application data van de user, zie sub paragraaf over bestandslocaties). Wanneer u als adviesbureau meerdere databases voor woningcorporaties beheert, kunt u via dit scherm wisselen van database instantie. Installatiehandleiding Pagina 9 van 24

10 Instellen van de beheergegevens U dient eenmalig via één cliënt de beheergegevens voor een database instantie te configureren. Deze gelden vervolgens voor alle cliënt pc s die gebruikmaken van de betreffende database instantie. Start hiervoor de Vabi Assets Energie applicatie op een cliënt. Klik in het menu [Tools] op het menuitem [Licentie en beheergegevens]. U krijgt vervolgens het onderstaande scherm. Figuur 6: licentie en beheergegevens Vul de volgende gegevens in: Bestandsdirectory: Dit is de directory voor het documentbeheersysteem waar alle EPBDdocumenten worden opgeslagen. Gebruik hiervoor een directory waar alle gebruikers toegang tot hebben. U kunt bijvoorbeeld een gedeelde netwerkschijf of een UNC-pad gebruiken. Houdt hierbij rekening met ongeveer 0,5 tot 1 MB per VHE, wanneer alle woningen uiteindelijk zijn afgemeld. Gebruik sub mappen in het documentbeheersysteem (o.b.v. 6 e karakter van postcode): Als deze optie is aangevinkt worden de EPBD-documenten onderverdeeld in sub mappen, waarbij de naam van iedere submap het 6 e teken van de postcode is. Bij een grotere woningvoorraad wordt geadviseerd om gebruik te maken van sub mappen, dit omdat Windows traag reageert bij grote aantallen bestanden in een map. Historie dir: Dit is een optionele directory voor het bijhouden van de geschiedenis van EPBDdocumenten. Gebruik hiervoor een directory waar alle gebruikers toegang tot hebben. U kunt bijvoorbeeld een gedeelde netwerkschijf of een UNC-pad gebruiken. Houdt hierbij rekening met ongeveer 1 tot 2 MB per VHE (na 5 jaar historie). Wanneer dit veld uit gevinkt is (default), dan wordt er geen historie bijgehouden. Installatiehandleiding Pagina 10 van 24

11 Alternatieve locatie voor documentbeheer: Dit is een optionele directory waar de energiecertificaten en bijlagen voor eigen, afwijkende doeleinden worden opgeslagen. Alternatieve naamgeving: De naamgeving voor de documenten op alternatieve locatie is naar wens op te geven. Een aantal codes is hiervoor te gebruiken. Bestandsdirectory Woning dossier: Dit is de directory voor Woning dossier waar alle toe te voegen bestanden worden opgeslagen. Er worden bij het toevoegen van bestanden aan Woning dossier automatisch sub mappen aangemaakt (o.b.v. 6 e karakter van postcode). Google Key: Indien u gebruik wilt maken van de export functionaliteit naar Google Maps, dient u een gratis Google Key aan te vragen. Klik hiervoor op de knop naast het tekstveld, dan opent de aanvraag website van Google. Standaard heeft elke gebruiker alle rechten. Het wijzigen van de autorisatie per gebruiker wordt uitgelegd in Vabi Assets Energie handleiding hoofdstuk 3 Gebruikers en rechten. Instellen van de adviseursgegevens De gebruikers die woningen mogen afmelden (gecertificeerde adviseurs), moeten voordat ze woningen kunnen afmelden eenmalig hun adviseursgegevens invoeren. Het is mogelijk om gegevens van meerdere adviseurs op te geven. Per deelvoorraad kunnen er meerdere adviseurs verantwoordelijk worden gesteld voor het afmelden van de woningen in de betreffende deelvoorraad. Start hiervoor de Vabi Assets Energie applicatie op een cliënt. Klik in menu [Tools] op menu-item [Instellingen voor adviseur]. U krijgt vervolgens het scherm zoals in figuur 7. Figuur 7: Instellingen adviseursgegevens Installatiehandleiding Pagina 11 van 24

12 Figuur 8: Adviseursgegevens Vul hier de volgende gegevens in: Gebruiker: Windows gebruikersnaam. De adviseursgegevens worden gekoppeld aan de Windows-gebruikers. Dus de inlognaam van de Windows-gebruiker bepaalt welke gegevens worden gebruikt voor het aanmaken van EPBD-documenten. Bedrijfsnaam: de naam van het gecertificeerde bedrijf (NL-EPBD certificaathouder). Contractor ID: dit is het 3-cijferig nummer dat de certificaathouder van Agentschap NL heeft gekregen voor verificatie bij het afmelden van uw woningen in hun afmeldsysteem EP-online. Dit nummer is ook wel bekend als verificatiecode. Bij onduidelijkheden over dit nummer, raadpleeg Agentschap NL. Inschrijvingsnummer: dit is het nummer dat de certificaathouder van de certificerende instelling heeft gekregen. Dit nummer is ook terug te vinden op het BRL 9500 (NL-EPBD) certificaat. Raadpleeg hiervoor de certificerende instelling. Bedrijfslogo: geef hier de bestandslocatie van het bedrijfslogo van de certificaathouder voor op het energielabel (een jpg of bmp bestand). Handtekening: geef hier de bestandslocatie van de digitale handtekening van de EPAadviseur voor op het energielabel (een jpg of bmp bestand). Installatiehandleiding Pagina 12 van 24

13 Het Bedrijfslogo en de Handtekening zullen door het programma automatisch worden ingevoerd op het energielabel. Het formaat zal worden aangepast aan de maximaal toelaatbaar gestelde afmetingen. Wanneer u deze velden leeg laat, blijven de daarvoor gereserveerde ruimten op het certificaat leeg. figuur 2: Maximaal formaat van het bedrijfslogo figuur 10: Maximaal formaat van de handtekening Na het toevoegen van een adviseur, kunt u onder de tekst (Deel)voorraden beschikbare deelvoorraden aan het account toewijzen. Als u op [Toevoegen] klikt, wordt een scherm met alle beschikbare deelvoorraden getoond. U wijst de deelvoorraden aan het account toe door op de betreffende deelvoorraden en vervolgens op [OK] te klikken. U kunt ook alle deelvoorraden aan het account toewijzen door de optie Account heeft toegang tot alle (deel)voorraden aan te vinken. Door in het overzicht (zie figuur 11) op [Bewerken] te klikken, kunt u een reeds opgegeven account bewerken. Door een aangemaakt account te selecteren en vervolgens op [Verwijderen] te klikken, wordt de aangemaakte account weer verwijderd. Tenslotte kunt u bij bij Gebruikers en rechten aangegeven of de betreffende adviseur alleen eigen gegevens kan beheren of ook de gegevens voor alle adviseurs kan beheren (zie figuur 11). Figuur 11: Gebruikers en rechten voor Adviseursgegevens Installatiehandleiding Pagina 13 van 24

14 Instellen van de firewall voor het afmelden bij RVO.nl Voor het automatisch afmelden van energielabels wordt een aparte executabel gebruikt: epa_auto.exe. Deze executabel maakt gebruik van het.net 2.0 framework. Verder maakt deze executabel voor het afmelden van energielabels een verbinding met de web service van RVO.nl. Raadpleeg hierbij de documentatie van de leverancier van uw Firewall. Voor het openzetten van een firewall zijn onderstaande gegevens nodig: Applicatie: epa_auto.exe Protocol: SOAP Interne poort: bepaalt Windows Externe poort: 80 (HTTP) Extern adres: webservice.ep-online.nl Installatiehandleiding Pagina 14 van 24

15 Optioneel: bestandslocaties Voor eventuele tijdelijke bestanden wordt de standaard tijdelijke directory van de user gebruikt. Hiervoor wordt de omgevingsvariabele %TMP% van Windows geraadpleegd (indien afwezig wordt %TEMP% geraadpleegd, zie Alle overige bestanden kunt u instellen met behulp van vastgoed_files.xml in de programma map. U kunt dit XML-document bewerken met bijvoorbeeld Notepad of een XML-editor, of het bijgeleverde hulpprogramma VastgoedConfig.exe. Hierbij kunt u gebruik maken van enkele macro s voor bijvoorbeeld de programma map, de username en de map voor de application settings van de user. Elementen vastgoed_files.xml Standaard ziet de inhoud van het vastgoed_files.xml bestand er als volgt uit: <EPA-W-FILES> <!-- You can these aliasses in the paths below --> <!-- Local temp directory : $temp$ --> <!-- application data of user : $appdata$ --> <!-- application data of all users : $appdatall$ --> <!-- program directory of epa-w : $prog$ --> <!-- user name of current windows account : $user$ --> <!-- domain name of current windows account : $domain$ --> <!-- config files for settings, database and defaults --> <Config>$prog$\epaw_config.xml</Config> <SqlConfig>$prog$\epaw_sql_config.vabi</SqlConfig> <Defaults>$appdata$\vabi\vastgoed\epaw_defaults.xml</Defaults> <Talen>$prog$\Vastgoed_Talen.xml</Talen> <Libraries>$appdata$\vabi\vastgoed\EPA-W Lib.xml</Libraries> <!-- manuals --> <ProgHandleiding>$prog$\Assets Energie Handleiding.pdf</ProgHandleiding> <HandleidingOpnForm>$prog$\Templates\Handleiding Opnameformulier.doc</HandleidingOpnForm> <HandleidingSjablonen>$prog$\Templates\Handleiding Sjablonen.doc</HandleidingSjablonen> <HandleidingBeleidsanalyse>$prog$\Templates\Beslisdiagram maatregelen Assets Energie.pdf</HandleidingBeleidsanalyse> <!-- hulpdirectories --> <DirImportverslag>$temp$</DirImportverslag> <DirKolomselectie>$appdata$\Vabi\Vastgoed</DirKolomselectie> <!-- report files --> <MutatieNV>$prog$\Templates\Mutatieformulier 2015.doc</MutatieNV> <OpnameNV>$prog$\Templates\Opnameformulier 2015.doc</OpnameNV> <BRL-Bijlage5>$prog$\Templates\BRL Bijlage 5.doc</BRL-Bijlage5> <GoogleMaps>$prog$\Templates\googlemaps.html</GoogleMaps> <Voorraadanalyse>$prog$\Templates\Vabi Voorraadanalyse met WWS.doc</Voorraadanalyse> <Beleidsadvies>$prog$\Templates\Vabi Beleidsadvies.doc</Beleidsadvies> <Registratie>$prog$\Templates\Vabi Registratie.doc</Registratie> <VHERapport>$prog$\Templates\VHE-rapport.doc</VHERapport> <ComplexRapport>$prog$\Templates\Complex-rapport.doc</ComplexRapport> <WoonlastenWoningRapport>$prog$\Templates\Woonlastenrapport woning 2015.doc</WoonlastenWoningRapport> <WoonlastenComplexRapport>$prog$\Templates\Woonlastenrapport complex 2015.doc</WoonlastenComplexRapport> </EPA-W-FILES> Installatiehandleiding Pagina 15 van 24

16 Hierbij kunt komen de volgende instellingen voor: XML-element Omschrijving Standaard waarde <Config> <SqlConfig> <Defaults> <Talen> Bestand voor de programma-instellingen voor het maatwerkadvies Bestand voor de database connectie instellingen Bestand met standaard waarden voor velden zoals Bron, vermogens, oppervlaktes, et cetera. Bestand met alle teksten uit de Assets Energie applicatie. $prog$\epaw_config.xml $prog\epaw_sql_config.vabi $appdata$\vabi\vastgoed\epaw _defaults.xml $prog$\vastgoed_talen.xml <Libraries> Bibliotheken maatwerkadvies $appdata$\vabi\vastgoed \EPA-W Lib.xml <ProgHandleiding> <HandleidingOpnForm> <HandleidijngSjablonen> <HandleidingBeleidsanalyse> <DirImportverslag> <DirKolomselectie> Naam en locatie van de programmahandleiding. Naam en locatie van de handleiding voor het opnameformulier. Naam en locatie van de handleiding voor de te gebruiken sjablooncodes. Naam en locatie van de toelichting van de maatregelen voor scenario s en energieplannen Map waar het html-importverslag wordt geplaatst dat wordt aangemaakt bij het importeren van woningen. Map waar de geselecteerde kolommen voor woning- en constructielijst worden opgeslagen. $prog$\assets Energie Handleiding.pdf $prog$\templates\handleiding Opnameformulier.doc $prog$\templates\handleiding Sjablonen.doc $prog$\templates\beslisdiagra m maatregelen Assets Energie.pdf $temp$ $appdata$\vabi\vastgoed <MutatieNV> Word-Sjabloon voor het mutatieformulier $prog$\templates\mutatieform ulier 2015.doc <OpnameNV> Word-sjabloon voor het opnameformulier $prog$\templates\opnamefor mulier 2015.doc <BRL-Bijlage5> Word-Sjabloon voor de BRL Bijlage $prog$\templates\brl Bijlage 5.doc <GoogleMaps> HTML-sjabloon voor Google Maps export $prog$\templates\googlemaps.html <Voorraadanalyse> Word-Sjabloon voor Voorraadanalyse $prog$\templates\vabi Voorraadanalyse.doc <Beleidsadvies> Word-Sjabloon voor Energiebeleidsadvies $prog$\templates\vabi Beleidsadvies.doc <Registratie> Word-Sjabloon voor Registratie $prog$\templates\vabi Registratie.doc <VHERapport> Word-sjabloon voor de VHE-rapportage $prog$\templates\vherapport.doc <ComplexRapport> Word-sjabloon voor complex-rapportage $prog$\templates\complexrapport.doc Installatiehandleiding Pagina 16 van 24

17 XML-element Omschrijving Standaard waarde <WoonlastenWoningRapport> Word-sjabloon voor woonlastenrapportage op woning-niveau $prog$\templates\woonlasten rapport woning 2015.doc <WoonlastenComplexRapport> Word-sjabloon voor woonlastenrapportage op complex-niveau $prog$\templates\woonlasten rapport complex 2015.doc In de bestandsnamen van de verschillende XML-elementen kunt u de volgende variabele namen gebruiken: Variabele Omschrijving Voorbeeld waarde (afhankelijk van systeem en user) $temp$ Temporary Folder van user C:\Users\ janssen\appdata\local\temp\ $appdata$ Application Data Folder van user C:\Users\ janssen\appdata\roaming\ $appdatall$ Application Data Folder van alle users C:\ProgramData\ $prog$ Application Folder C:\Program Files\Vabi\Assets\ $user$ User name van Windows account janssen $domain$ User domain van Windows account VABI Automatisch afmelden Het bestand waarin de instellingen voor automatisch afmelden zijn vastgelegd (instellingen.xml) staat standaard in %appdata%\vabi\epa-auto. De locatie van dit bestand is te configureren met behulp van 'vastgoed_files.xml' in de programma map. De locatie van de map kunt u opgeven met het element 'Afmelder', door het toevoegen van de regel, bijvoorbeeld: <Afmelder>$appdata$\vabi\auto-epa\</Afmelder> Geef een directory op, NIET een bestandsnaam. Als u de locatie van instellingen.xml wijzigt, dan moet het bestand ook daadwerkelijk verplaatst worden van de standaardlocatie naar de door u opgegeven locatie. Als u het bestand niet verplaatst, wordt automatisch een leeg bestand aangemaakt en zullen eerder ingevoerde instellingen verloren gaan. Automatische registratiemomenten Het is ook mogelijk om de registratiemomenten automatisch, zonder tussenkomst van de gebruiker, vast te leggen. Dit kan door Vabi Assets Energie op te starten middels een extra parameter: C:\Program Files\Vabi\Assets\Assets Energie.exe regmoment Vabi Assets Energie wordt dan opgestart zonder gebruikersinterface. Vervolgens wordt er een registratiemoment vastgelegd op dezelfde manier als bij de handmatige actie, en wordt Vabi Assets Energie weer afgesloten. Door deze extra optie is het ook mogelijk om iedere maand automatisch een registratiemoment vast te laten leggen. Hiervoor kan de Windows Task Scheduler (Windows Taakbeheer) worden gebruikt op een PC of server die altijd aan staat, én waarop toegang is tot de Assets Energie applicatie. Als u bekend bent met de Windows Task Scheduler kunt u deze handmatig instellen voor het uitvoeren van bovenstaande opdrachtregel. Het is ook mogelijk om dit middels een bijgeleverd hulpprogramma te doen. Dit kan worden opgestart vanuit het CD-menu (zie paragraaf Het Installatie- Menu ), of door het programma RegScheduler.exe in de map Tools van de setup te starten. Wanneer u het hulpprogramma gebruikt, krijgt u het volgende venster te zien: Installatiehandleiding Pagina 17 van 24

18 Bij Locatie Assets Energie vult u het volledige pad naar de executable van Assets Energie in. Bij Tijdstip van uitvoeren vult u een geschikt tijdstip in voor het vastleggen van het registratiemoment. Bij voorkeur is dit een moment waarop de database wel beschikbaar is, maar er nog niemand met de applicatie werkt. Als datum wordt de 1 ste van iedere maand genomen. Er kan maar één instantie van deze taak in de Task Scheduler bestaan. Mocht er al een zijn gedefinieerd, dan is de knop [Verwijder taak] ook beschikbaar, en kunt u daarmee de oude taak verwijderen alvorens de nieuwe toe te voegen. Met een druk op de knop [Maak taak aan] wordt er een taak gemaakt in de Task Scheduler. Figuur 13: Automatisch registratiemoment aanmaken Als u hiermee bekend bent kunt u daar de taak eventueel nog bekijken of wijzigen Figuur 14: Windows Taakplanner Installatiehandleiding Pagina 18 van 24

19 Inlezen labelhistorie Om een overzicht van de labelhistorie te kunnen genereren, zullen de benodigde gegevens hiervoor moeten worden opgeslagen in de database. Vanaf versie 4.30 worden deze gegevens automatisch opgeslagen wanneer woningen worden afgemeld. Om deze gegevens initieel te vullen met de gegevens van reeds afgemelde woningen gebruikt u een hulpprogramma dat de energielabels (pdfbestanden) uit het documentbeheersysteem leest en de gegevens in de databse opslaat. Dit hulpprogramma (PDF Certificaten Leestool.exe) is inclusief handleiding beschikbaar in de map Assets Energie\Tools van de Suite_Assets_Energie. Updates Maak altijd eerst een back-up van de database voordat u een update uitvoert. Voor het installeren van de updates kunt u ook het Installatie-menu gebruiken zoals beschreven in hoofdstuk Het Installatie-Menu. U kiest dan het tabblad Update. Figuur 15: Installatiescherm updates Update database In de meeste gevallen moet bij installatie van een update ook de database worden bijgewerkt. Voor sommige tussentijdse versie van Vabi Assets Energie is dit niet nodig, maar omdat het updateprogramma zelf aangeeft of een update van de database nodig is of niet, kan deze het beste altijd gekozen worden. U krijgt dan onderstaand venster te zien. Figuur 16: Update database Installatiehandleiding Pagina 19 van 24

20 Door de juiste klantnaam op te geven, wordt ook automatisch de databasenaam ingevuld. Dit kan doordat we bij installatie de databasenaam altijd volgens een standaard manier opgeven. Vervolgens vult u de root user en bijbehorende wachtwoord in. Tenslotte geeft u nog de naam van de server op waar de database is geïnstalleerd. Wanneer u nu op de knop [haal db versie op] klikt, zal het programma de huidige versie ophalen uit de opgegeven database, en deze invullen. Wijkt de versie af van de versie die behoort bij de meest recente versie van Vabi Assets Energie, dan is de knop [Upgrade] beschikbaar. Met een druk op die knop zal de database worden bijgewerkt. Dit kan enige tijd duren, afhankelijk van het aantal woningen dat in de database aanwezig is. Om technische redenen kan er tijdens deze update geen voortgang worden getoond; u zult dus moeten wachten tot de update is voltooid en het scherm weer actief wordt. Wanneer u van een verouderde versie naar de meest recente gaat, kan het zijn dat er meerdere updates achter elkaar uitgevoerd moeten worden. Als alle benodigde updates zijn uitgevoerd, of wanneer er geen update nodig is, zal het programma hiervan een melding geven, zie figuur 17. Figuur 17: Melding geen nieuwere database versie Mocht u de voorkeur geven aan het handmatig updaten van de database, dan kunt u de betreffende script voor MSSQL vinden in de map Assets Energie\Tools van de installatie-folder. Update applicatie Wanneer u de applicatie gaat installeren, zult u altijd een melding krijgen dat er nog een andere versie is geïnstalleerd, zie figuur 18. Figuur 18: Update applicatie Om de nieuwe versie te kunnen installeren dient u eerst de oude te verwijderen. Eigen instellingen zullen hierbij bewaard blijven. Als u bovenstaande vraag bevestigd, krijgt u nog een vraag om het verwijderen te bevestigen. Deze vraag komt van de un-installer van de oudere versie. Wanneer u die vraag met [Nee/No] beantwoordt, zal de oude versie niet verwijderd worden, maar zal de nieuwe versie hier wel overheen worden geïnstalleerd. Dit kan echter leiden tot een incorrect werkend programma. Vandaar dat u beide vragen met [Ja/Yes] dient te beantwoorden. Nadat de oude versie is verwijderd, zal de nieuwe worden geïnstalleerd. We raden u aan deze in dezelfde directory te installeren als de vorige versie, omdat dan meteen alle instellingen goed staan. Wanneer de installatie succesvol is afgerond, en u heeft ook de database-update succesvol uitgevoerd, dan is uw nieuwe versie klaar voor gebruik! Installatiehandleiding Pagina 20 van 24

21 Belangrijke wijzigingen Met de laatste knop uit het Installatie-Menu [Wat is er veranderd] kunt u nog een overzicht krijgen van alle wijzigingen sinds uw vorige versie. Hierin staan ook belangrijke waarschuwingen met betrekking tot belangrijke bestanden zoals rapportage-sjablonen, nieuwe of gewijzigde programma-instellingen, etc. Templates, bibliotheken en andere bestanden Met een update kunnen nieuwe templates, bibliotheken en andere bestanden worden meegeleverd. Een aantal bestanden worden automatisch vervangen, zie Bijlage A Update templates en andere bestanden. Bij update worden de aangepaste bestanden automatisch op de standaard locatie geplaatst, zie paragraaf Optioneel: bestandslocaties. Heeft u in vastgoed_files.xml een afwijkende locatie opgegeven, dan zult u de betreffende bestanden handmatig naar opgegeven locatie moeten kopiëren. Andere bestanden (mutatieformulier en Word rapportage sjablonen) worden niet overschreven, omdat deze door de corporatie vrij aan te passen zijn. Deze aanpassingen mogen nooit door een automatische update worden overschreven. In de release notes wordt aangegeven welke aanpassingen er gedaan zijn. U kunt kiezen om het nieuwe sjabloon over te nemen, deze kunt u uit de installatie map kopiëren naar de betreffende map. Woonlasten webservice en calculator updaten Toont u de woonlasten via het woonruimteverdeelsysteem of via uw eigen website? Vergeet dan niet de woonlasten web service en de woonlasten calculator te updaten Woonlasten calculator Indien u de woonlasten calculator dient te updaten, dient u alle bestanden, met uitzondering van het bestand WoonlastenCalculator.exe.config, uit de setup map te kopiëren naar de huidige programma map van de woonlasten calculator. Woonlasten webservice Voor het updaten van de woonlasten webservice dient u de volgende stappen uit te voeren: Hierna voert u de installer Vabi woonlasten Webservice-*.*.*.exe uit. Hierna zal de woonlasten webservice volledig geüpdatet zijn naar de meest recente versie. Installatiehandleiding Pagina 21 van 24

22 Versie 6.00 Belangrijkste nieuwe functionaliteit in deze versie is de mogelijkheid energieplannen aan te maken. o Hiervoor zijn de definities van een aantal scenariomaatregelen gewijzigd. Wel zijn de bestaande maatregelen zoveel mogelijk geconverteerd. o De prijzenbibliotheek is uitgebreid en zal opnieuw gevuld moeten worden. Bij het opstarten van Assets Energie is er een controle toegevoegd die kijkt of dit de eerste keer is dat deze versie van de software wordt opgestart. Als dat zo is, worden alle woningen uit de gehele voorraad gemarkeerd voor herberekenen. Dit doen we omdat er in een nieuwe versie aanpassingen kunnen zijn gedaan die van invloed zijn op de rekenresultaten. En op deze manier wordt de gebruiker verplicht alles met de nieuwste versie van de software door te rekenen. Wanneer deze berekening wordt gestart kan de gebruiker altijd nog zelf kiezen. Bij het opstarten van Assets Energie wordt gecontroleerd of de prijzenbibliotheek gevuld is. Is dat niet het geval, dan wordt er een melding gegeven, en worden -mits de gebruiker hiertoe geautoriseerd is- de meegeleverde standaard prijzen ingelezen. Voor deze versie is ook een upgrade van de database nodig. Versie 6.01 Er zijn voor deze versie geen speciale vereisten als 6.00 al geïnstalleerd is. Het is voldoende de Assets Energie cliënt te installeren. Versie 6.10 Voor deze versie is ook een upgrade van de database nodig. Bij deze nieuwe versie van Vabi Assets Energie dient u ook een update uit te voeren van de Vabi Connector. Maakt u gebruik van de Woonlasten Calculator en/of Woonlasten Webservice, update u deze dan ook naar de laatste versie. De templates van het opnameformulier en mutatieformulier zijn aangepast. Deze aanpassing moet door de hoofdgebruiker overgenomen worden naar de eigen sjablonen. Of -als er geen eigen sjablonen gebruikt worden- het bestand moet op de opgegeven locatie in vastgoed_files.xml vervangen worden door de meegeleverde templates. Versie 6.11 Voor deze versie GEEN database upgrade nodig als u al met versie 6.10 werkt. Bij deze nieuwe versie van Vabi Assets Energie dient u ook een update uit te voeren van de Vabi Connector. Maakt u gebruik van de Woonlasten Calculator en/of Woonlasten Webservice, update u deze dan ook naar de laatste versie. Werkt u met Assets Webmutatie, dan moet deze ook geupdate worden. De templates van het opnameformulier en mutatieformulier zijn NIET aangepast. Als u al met versie 6.10 werkt hoeft er geen aanvullende actie genomen te worden. Installatiehandleiding Pagina 22 van 24

23 Bijlage A Update templates en andere bestanden De volgende bestanden worden, indien gewijzigd, overschreven: "Templates\Handleiding Sjablonen.doc" "Templates\googlemaps.html" "Templates\Beslisdiagram maatregelen Assets Energie.pd" "Templates\BRL Bijlage 5.doc" "Templates\BRL Bijlage 5 CERTOUD.doc" "Templates\EPA-W Template Manual.pdf" "Prijzen\Assets Energie Energieprijzen.xls" "Prijzen\Assets Energie Prijzen Gevelisolatie Binnen.xls" "Prijzen\Assets Energie Prijzen Gevelisolatie Spouw.xls" "Prijzen\Assets Energie Prijzen Hellend Dak Isolatie.xls" "Prijzen\Assets Energie Prijzen Overig Bouwkundig.xls" "Prijzen\Assets Energie Prijzen Paneelisolatie Binnen.xls" "Prijzen\Assets Energie Prijzen Paneelisolatie Spouw.xls" "Prijzen\Assets Energie Prijzen Plat Dak Isolatie.xls" "Prijzen\Assets Energie Prijzen Ventilatie.xls" "Prijzen\Assets Energie Prijzen Verwarming.xls" "Prijzen\Assets Energie Prijzen Tapwater.xls" "Prijzen\Assets Energie Prijzen Vloerisolatie.xls" "Prijzen\Assets Energie Prijzen Zonneenergie.xls" "Prijzen\Assets Energie Prijzen Koeling.xls" "Assets Energie Handleiding.pdf" "WwsPuntenTabel.xml" "Vastgoed_Talen.xml" IssoRekenkern_talen.xml "OudCert_Talen.xml" "WinAPI_Talen.xml" "AssetsProfielIntegraal.xml" "AssetsProfielBeheer.xml" "AssetsProfielBeleid.xml" De bestanden worden in de hierboven aangegeven directories geplaatst. Als door middel van de vastgoed_files.xml deze locatie wordt gewijzigd, dienen bovenstaande bestanden handmatig naar de juiste directory gekopieerd te worden. Alle andere templates die we bijleveren zijn voorbeeldbestanden, en worden bij een update niet overschreven. Installatiehandleiding Pagina 23 van 24

24 Vabi Software Kleveringweg 6-8 Postbus AA Delft (015) Installatiehandleiding Pagina 24 van 24