Invulvelden en handtekeningvelden

• Invulvelden en handtekeningvelden
  • Welke invulvelden kan ik gebruiken?
  • Welke handtekeningvelden kan ik gebruiken?
  • Hoe en wanneer vervangt VLOK de invulvelden en handtekeningvelden?
    • Bij het aanmaken van een document.
    • Bij het ondertekenen van een document
  • Waar haalt VLOK de gegevens om de invulvelden te vervangen?
  • Webinar 1 toepassingsbeheerders

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

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

• Zie voor een overzicht van alle invulvelden het rapport ‘Documentmodule - basisset invulvelden’ - Meer info Rapporten bekijken

• Zie Basisset invulvelden beheren

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):

• Voor iedereen beschikbaar zonder dat het object moet gekoppeld zijn aan het document - Bestemmeling.* (De bestemmeling van de brief: Gemeente, Persoon of Instantie)
  - Datum.*
  - Dienst.*
  - Document.*
  - Gebruiker.* (De gebruiker die momenteel is aangemeld)
  - Gemeente.* (indien de bestemmeling van de brief een gemeente is, kunnen de gegevens uit dit object gehaald worden)
  - Ondertekenaar.*
  - Organisatie.* (de organisatie waarmee de gebruiker die het document genereert, is aangemeld) .

• Beschikbaar voor sjablonen woningkwaliteit en de lokale besturen indien het object is gekoppeld - Persoon.*
  - Pand.*
    |- Entiteit.*
    |  |- Conformiteitsattest.*
    |  |- BesluitNGW.*
    |  |- Vivoo.*
    |  '- VrijstellingOpschorting.*
    |- Onderzoek.*
    |- Procedure.* (HoofdProcedure OO)
    |  |- Deelprocedure.* (DeelProcedure OO)
    |  |  |- Advies.*
    |  |  |- ReactieHoorplicht.*
    |  |  |- Beslissing.*
    |  |  |- DeelBeroep.*
    |  |  '- MinisterieelBesluit.*
    |  '- Beroep
    |- Procedure CA
    |  |- Deelprocedure CA
    |- Conformiteitsattest
    |- Besluit NGW
    '- Taak (Onderzoek) |- Besluit NGW  '- Taak (Onderzoek)

• Beschikbaar voor WI indien het object is gekoppeld - Dossier
    |- ProcesVerbaal.*
    |- Herstelvordering.*
    |- GerechtelijkeProcedure.*
    |  '- GerechtelijkGevolgPersoon.*
    |     |- Hypotheek.*
    |     |- Uitspraak.*
    |     '- Veroordeling.*
    |- Betaling.*
    |- Inlichting.*
  |- Instantie.*

2. Formatering van datum invulvelden.

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.

3. Transformatie van datum invulvelden.

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

4. Formatering van booleans

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

5. 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.

6. Lijsten

• Enkelvoudige invulvelden:

  • De meeste invulvelden gaan ervan uit dat u slechts één data-object koppelt aan het document bv. één pand Elk bebouwd onroerend goed dat zowel het hoofdgebouw als de bijgebouwen omvat (= gebouwen die als 1 geheel beschouwd kunnen worden), met uitzondering van bedrijfsruimten. Een pand kan één of meerdere zelfstandige en/of niet-zelfstandige entiteiten bevatten met of zonder woonfunctie., één entiteit, één onderzoek …  

  • Als u meerdere objecten koppelt van hetzelfde type, zal VLOK de enkelvoudige invulvelden vervangen door de data van het eerste gekoppelde object.  bv. Documenten voor houders zakelijk recht houder(s) zakelijk recht. Volgende rollen beschouwt VLOK als een houder zakelijk recht: volle eigenaar, vruchtgebruiker, opstalhouder, erfpachter. (HZR houder(s) zakelijk recht. Volgende rollen beschouwt VLOK als een houder zakelijk recht: volle eigenaar, vruchtgebruiker, opstalhouder, erfpachter.) kunt u in principe koppelen aan één of meerdere entiteiten en deelprocedures. Indien meerdere objecten zorg dan dat de data die VLOK zal invullen in het document hetzelfde is voor alle aan te maken documenten.  vb. einddatum hoorplicht (data uit de deelprocedure) is overal hetzelfde.

• Meervoudige invulvelden: Voor meervoudige koppelingen is het mogelijk om lijsten weer te geven. De hiervoor gebruikte syntax is [] bv. ${Entiteit[]} geeft een lijst met alle geselecteerde entiteiten.

7. 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:

• Gebruikergegevens komen uit Mijn account.  Zie Mijn account beheren

• Organisatie gegevens komen uit Mijn organisatie. Zie Mijn organisatie beheren

• Bestemmelinggegevens komen uit de het domicilie en/of correspondentieadres van de persoon. Zie Personen en adressen / documenten

• Het adres en referte van het pand en de entiteit komen uit de goederen. 

• …

Webinar 1 toepassingsbeheerders

Zie voor achtergrondinfo: