Invulvelden en handtekeningvelden

Welke invulvelden kan ik gebruiken?

Sinds de release van november 2019 voorziet VLOK 20.000 beschikbare invulvelden. 

Deze invulvelden haalt VLOK dynamisch automatisch op van de dataobjecten (bv. Entiteit Een entiteit is een deel van een pand. Er zijn 3 entiteitstypes: niet-woonfunctie (NWF), een niet-zelfstandige woning (NZW) en een zelfstandige woning (ZW). Zie voor uitgebreide definitie' Hoe voeg ik een nieuwe entiteit toe?', Onderzoek, …) of zijn geprogrammeerd door de ontwikkelaars om meer functionaliteit mogelijk te maken bv. lijsten van gekoppelde entiteiten.

Volgende principes zijn van toepassing:

  1. Basisset invulvelden

  2. Om het overzichtelijk te houden kunt u in sjablonen enkel de invulvelden gebruiken die door de toepassingsbeheerder (Wonen) zijn toegevoegd aan de basisset invulvelden.

    Een toepassingsbeheerder (gemeente)  zal bij het toevoegen van de invulvelden aan sjablonen enkel de invulvelden kunnen selecteren uit deze basisset.  ZieHoe beheer ik sjablonen en pas ze aan aan de huisstijl van mijn organisatie?  Als een gewenst invulveld of formatering niet beschikbaar is in de basisset kunt u het aanvragen via vlok@vlaanderen.be

    De invulvelden zijn onderverdeeld in 3 groepen onderwerpen (dataobjecten):

  3. Formatering van datum invulvelden.

  4. Datum en tijd kunnen we weergeven op verschillende manieren. De verschillende formateringen moeten wel voorkomen in de basisset.  Als uw gewenst format er nog niet tussen staat, vraag het aan vlok@vlaanderen.be om het toe te voegen.

    Voorbeelden:

    • Onderzoek.Datum à 17/07/2019

    • Onderzoek.Datum.d MMMM y à 17 juli 2019

      Tip - we kunnen de datum weergeven op alle mogelijk manieren als standaard format specifier. Zie volgende link voor alle mogelijkheden.

  5. Transformatie van datum invulvelden.

  6. Het is ook mogelijk om een tijdspanne op of af te trekken van een bepaalde datum. Deze transformatie begint steeds met een + of en eindigt met een karakter. Deze laatste, niet hoofdletter gevoelige, karakter geeft aan hoeveel dagen, maanden of jaren de datum gewijzigd moet worden.

    Volgende mogelijke karakters bestaan:

    • D of d àDagen

    • M of m à Maanden

    • Y of y à Jaren

    De getransformeerde datum velden moeten ook voorkomen in de basisset als u ze wilt gebruiken in sjablonen.

    Voorbeelden:

    • Advies.Datum à Geen transformatie à  01/01/2000

    • Advies.Datum.+1D à  02/01/2000

    • Advies.Datum.-1D à  31/12/1999

    • Advies.Datum.+1M à  01/02/2000

    • Advies.Datum.+1Y -à  01/01/2001

    • Advies.Datum.+1D.+1M.+1Y à 02/02/2001

  7. Formatering van booleans

  8. Booleans zijn datavelden die slechts twee waarden kunnen hebben zoals bijvoorbeeld ja of nee. U kunt ze herkennen door opname van ‘is’ in het invulveld bv. Persoon.IsActief

    We kunnen voor deze velden zelf bepalen welke tekst VLOK toont afhankelijk van de waarde door achteraan het invulveld TekstIndienWaar_TekstIndienNietWaar

    Voorbeelden:

    • Persoon.IsActief à geen true/false string àgeeft Ja indien actief en Nee indien niet actief

    • Persoon.IsActief.OK_NOK à geeft OK indien actief en NOK indien niet actief

    • Persoon.IsActief.Alive_Dead à geeft Alive indien actief en Dead indien niet actief

  9. Formatering van getallen

    Voor getallen kunnen we zelf het aantal decimalen bepalen. Voeg bijvoorbeeld 0.00 toe op het einde van het invulveld voor 2 cijfers na de komma. De verschillende formateringen moeten wel voorkomen in de basisset.  Als uw gewenst format er nog niet tussen staat, vraag het aan vlok@vlaanderen.be om het toe te voegen.

    Tip - we kunnen getallen weergeven op alle mogelijk manieren als standaard format specifier. Zie volgende link voor alle mogelijkheden.

  10. Lijsten

  11. Onderscheid tussen een standaard en een optioneel invulveld.

    • Naast een standaardinvulveld ${standaardinvulveld} kunt u vanaf de release van augustus 2019 ook optionele invulvelden bv #{optioneel invulveld} gebruiken in uw sjablonen.

    • Het verschil zit in het al dan niet vervangen van het invulveld indien de waarde in het data-object leeg is. Zie verder.

Welke handtekeningvelden kan ik gebruiken?

De toepassingsbeheerder (gemeente)kan enkel handtekeningvelden selecteren die de toepassingsbeheerder (Wonen)  heeft geconfigureerd op elke documenttype afzonderlijk. Als een gewenst handtekeningveld niet beschikbaar is in de configuratie kunt u het aanvragen via vlok@vlaanderen.be

Hoe en wanneer vervangt VLOK de invulvelden en handtekeningvelden?

Bij het aanmaken van een document.

VLOK vervangt invulvelden op het moment dat u documenten aanmaakt op basis van een sjabloon als volgt:

  • Met de waarde uit het dataobject indien zowel:

    • en het invulveld voorkomt in de basisset,

    • en het benodigde dataobject is geselecteerd indien een koppeling noodzakelijk is

    • en het veld niet leeg is.

Als u een enkelvoudig invulveld gebruikt (bv. Entiteit.Adres) in een document waarvoor u meerdere dataobjecten selecteert van hetzelfde type (bv. meerdere entiteiten), vervangt VLOK het veld met de waarde uit het eerste dataobject.

  • Invulveld blijft staan: noch verwijderen, noch vervangen indien ofwel:

    • of het invulveld niet voorkomt in de basisset

    • of het data-object van het standaardinvulveld niet is gekoppeld indien nodig

    • of de waarde voor het standaardinvulveld is leeg

    • of het is een handtekeningveld of een invulveld van het object Ondertekenaar

    • of de formatering is niet eenvormig voor het ganse veld.

  • Verwijderen van het invulveld zonder te vervangen indien

    • of het data-object van het optionele invulveld uit de basisset is niet gekoppeld indien een koppeling noodzakelijk is

    • of de waarde voor het optionele invulveld is leeg

Bij het ondertekenen van een document

VLOK vervangt:

  • het handtekeningveld

  • de invulvelden van het object Ondertekenaar.

Waar haalt VLOK de gegevens om de invulvelden te vervangen?

De invulvelden komen van verschillende plaatsen in VLOK:

Webinar 1 toepassingsbeheerders

Zie voor achtergrondinfo: