Met de komst van versie 11.2 hebben we grote aanpassingen aangebracht aan de datastructuur van Vabi EPA. Deze aanpassing is een belangrijke stap richting een toekomstbestendige Cloud versie van Vabi EPA. Het Word rapportage voor het Maatwerkadvies maakt gebruik van dezelfde datastructuur, waardoor enkele codes die in de template gebruikt worden aangepast zijn. Wat betekent dit voor jou als gebruiker? Lees hier wat er verandert rondom de Word-rapportages en templates voor het maatwerkadvies én hoe je eenvoudig met de nieuwe datastructuur aan de slag gaat.
Waarom deze wijziging?
De onderliggende datastructuur van Vabi EPA is aangepast om klaar te zijn voor toekomstige online toepassingen (‘cloud’). Hierdoor zijn ook de codes waarmee Word-rapportages maatwerkadvies genereren op veel punten gewijzigd. Werk je met aangepaste templates? Lees dan verder. Gebruik je standaard templates? Zorg dat je vanaf versie 11.2 de nieuwe versie daarvan gebruikt.
Dit is er veranderd: nieuwe resultatenlijst
De resultaten van een maatwerkadvies zijn altijd tweeledig:
- Energielabelberekening: het effect van maatregelen op het energielabel.
- Maatwerkadviesberekening: het effect op energieverbruik, waarin gerekend wordt met het gekozen klimaatstation en de fitparameters.
Daarnaast worden de berekeningen op verschillende niveaus gemaakt:
- Op niveau van het basis object (de start situatie)
- Op niveau van een maatregel (het effect van een individuele maatregel)
- Op niveau van een variant (het effect van een pakket aan maatregelen)
Al deze resultaten zitten in de modelstructuur nu samen in één lijst. Dat betekent dat er gebruik gemaakt moet worden van filters om de gewenste resultaten van de juiste berekening van het juiste onderdeel te tonen.
Zo werken de nieuwe filters
De wijziging zijn terug te vinden in de handleiding die bij de templates hoort. Voorheen waren de resultaten van een object of variant terug te halen via ..Object[*] of ..Energieplan[*] gevolgd door Nta8800Resultaten of Nta8800MaatwerkResultaten voor de energielabel of maatwerkadviesberekening respectievelijk.
Zoals te zien is in de kolom 11.2.0 is die code nu aangepast. Alle resultaten worden nu uit dezelfde nieuwe resultatenlijst gehaald `Nta8800ResultatenList.Nta8800Resultaten. De code die daarop volgt zijn de toegepaste filters, voorafgaand door ?(@. De filter “@.CalculationType” geeft het verschil tussen de energielabelberekening (Standaard) en maatwerkadvies (Maatwerk). De eerste gebruik je voor alle resulaten met betrekking tot het energielabel, de tweede voor alles wat te maken heeft met de energieverbruiken en resulterende besparingen.
De tweede filter is op Id van een variant of maatregel. Hierin zijn drie variaties:
- EnergieplanId == “ “ & MaatregelId== “ “
- EnergieplanId != “ “ & MaatregelId == “ “
- EnergieplanId == “ “ & MaatregelId != “ “
De eerste geeft aan dat er gefilterd wordt op een situatie waarbij zowel het Id van de variant als de maatregel leeg is. Dit geeft de resultatbasis , de huidige situatie.
De twee filter geeft aan dat het Id van de variant niet leeg mag zijn, maar die van de maatregel wel. dit geeft de resultaten van de varianten.
De derde is een nieuwe toevoeging, namelijk de filter waarbij het Id van de varianten leeg moet zijn maar voor de maatregel niet. Dit geeft de resultaten van de individuele maatregelen. Vanaf de 11.2 versie is het dus mogelijk om de resultaten van de individuele maatregelen te tonen.
Varianten
Om uiteindelijk het gewenste dataveld te tonen, moet de hele code inclusief filters nog gevolgd worden door de code van het veld zelf. Dit leidt tot erg lange codes waarmee de opmaak onoverzichtelijk kan worden. Om die reden is het mogelijk gemaakt om variabelen in de template te definiëren. Dit zijn eigen naamgevingen die je kan geven aan een hele stuk code en vervolgens in de onderliggende tekst kan hergebruiken. Zo kan bijvoorbeeld het hele stuk code waarmee er in de resultatenlijst gefilterd wordt op de standaard resultaten van het object vervangen worden door bijvoorbeeld de tekst “objectStandaardResultaten”. Dit is ook zo gedaan in de voorbeeldtemplates. Om variabelen te gebruiken in de template is de volgende syntax beschikbaar:
Syntax:
Definitie: #V:{variabele_naam}={query}#
Gebruik: #V: {variabele_naam}:{subquery}#
Voorbeeld:
Om zo bijvoorbeeld de code van het energielabel van het object te genereren, kan de variabele als volgt gebruikt worden:
Definitie:
#V:objectStandaardResultaten = $..Nta8800ResultatenList.Nta8800Resultaten[?(@.EnergieplanId == ‘‘ & @.MaatregelId == ‘‘ & @.CalculationType == “Standaard”)]#
Gebruik:
#V:objectStandaardResultaten:$..EnergieLabel#
In de standaard templates worden deze op verschillende plaatsen gebruikt, die je ook als voorbeeld kan gebruiken in je eigen template.
Alles in een overzicht in de handleiding
Bij de installatie van Vabi EPA wordt altijd de laatste versie van de handleiding van de templates mee geïnstalleerd. Deze staat in dezelfde map waar ook de templates in staan opgeslagen. Het makkelijkste terug te vinden via de knop in het Word rapportage venster:
Hierin zijn alle beschikbare codes terug te vinden voor het ophalen van gegevens uit je Maatwerkadvies project. Ook staat hier beschreven wat er in elke versie gewijzigd is.
Vragen of hulp nodig? Neem contact op!
Kom je er niet uit? Neem gerust contact op met ons supportteam. Wij helpen je graag verder zodat je snel weer optimaal gebruikmaakt van Vabi EPA!
