Text-tags gebruiken binnen documenten

Tekst-tags maken en opmaken in documenten

Met tekst-tags leg je in je document vast waar handtekeningen, invulvelden en andere elementen moeten komen. Je typt de tags gewoon in de tekst van je document. ValidSign herkent ze automatisch en zet ze om in de juiste velden.

In dit artikel lees je hoe je tekst-tags opbouwt, welke opties je hebt en hoe je ze aanpast aan je situatie. Ook lees je hoe de oude tag werkt, die nog steeds ondersteund wordt.

Voordat je begint

Zorg dat je het volgende weet:

• Tekst-tags werken in documenten die je uploadt naar ValidSign.

• Namen van knoppen, opties en waarden binnen een tag laat je in het Engels staan. Ze zijn onderdeel van de code.

• Maak tekst-tags bij voorkeur eerst in Kladblok. Word gebruikt aanhalingstekens die ValidSign niet herkent. Meer hierover lees je onderaan bij Problemen oplossen.

De basis: hoe een tekst-tag eruitziet

Elke nieuwe tekst-tag begint met {{vs: en eindigt met }}.

{{vs:Ondertekenaar:Veldtype:Afmetingen}}

Werkt de standaard-tag niet in jouw document? Gebruik dan de alternatieve tag met vierkante haken:

[[vs:Ondertekenaar:Veldtype:Afmetingen]]

De oude tag met esl:

Tekst-tags die met {{esl:...}} beginnen, blijven werken. Deze tag werd voorheen gebruikt en is nog steeds volledig ondersteund. Je hoeft bestaande documenten dus niet aan te passen.

{{esl:Signer1:signature:size(200,50)}}

Voor nieuwe documenten gebruik je bij voorkeur vs:. De opties en veldtypes werken bij beide tags op dezelfde manier.

Een tekst-tag een naam geven

Geef een tekst-tag een unieke naam als je er later naar wilt verwijzen. Zet de naam direct achter vs (of esl), met een underscore ertussen.

{{vs_naam: ... }}
{{esl_Tekstveld: ... }}

Een veld verplicht maken

Zet een sterretje (*) om een veld verplicht te maken. De plek van het sterretje verschilt per tag:

• Nieuwe tag: sterretje na vs.

• Oude tag: sterretje voor esl.

{{vs*: ... }}          // nieuwe tag
{{*esl: ... }}         // oude tag

Handtekeningvelden zijn altijd verplicht. Daar hoef je geen sterretje bij te zetten. Het sterretje werkt alleen bij formuliervelden.

Handtekeningen plaatsen

ValidSign ondersteunt vier soorten handtekeningen:

De opbouw ziet er zo uit:

{{vs:Signer1:signature: ... }}
{{vs:Signer1:capture: ... }}
{{vs:Signer1:initials: ... }}
{{vs:Signer1:paraph: ... }}

Een optionele handtekening

Wil je dat de ondertekenaar zelf mag kiezen of hij tekent? Zet dan een vraagteken (?) toe. Ook hier verschilt de plek per tag:

• Nieuwe tag: vraagteken na vs.

• Oude tag: vraagteken voor esl.

{{vs?:Signer1:signature: ... }}      // nieuwe tag
{{?esl:Signer1:signature: ... }}     // oude tag

Een tag aan een ondertekenaar koppelen

Elke tag hoort bij een ondertekenaar. Je koppelt de tag door de placeholder van de ondertekenaar in te vullen.

ValidSign maakt automatisch placeholders als Signer1, Signer2 en Signer3. Je mag ook een eigen naam kiezen, bijvoorbeeld Director of Customer1.

{{vs:Signer1: ... }}
{{vs:Director: ... }}
{{vs:Customer1: ... }}

Let op: ben je zelf ook ondertekenaar van de transactie? Dan verandert de eerste placeholder van Signer1 in Owner. Zie ook Problemen oplossen verderop.

Gegevens van de ondertekenaar meegeven

Je kunt de gegevens van een ondertekenaar direct in de tag zetten. ValidSign maakt de ontvanger dan aan met deze gegevens.

Voorbeeld met alle gegevens:

{{vs:Signer1:firstname(John):lastname(Doe):email(john.doe@validsign.eu):title(Director):company(ValidSign):order(1):phone(+3161234567): ... }}

Let op: vul je firstname, lastname of email in, dan moet je alle drie deze velden invullen. De velden title, company, order en phone zijn optioneel.

Automatische velden

ValidSign kan bepaalde gegevens automatisch in het document zetten. Handig als je bijvoorbeeld de naam of de ondertekendatum wilt tonen.

De opbouw:

{{vs:Signer1:SignerName: ... }}
{{vs:Signer1:SignerTitle: ... }}
{{vs:Signer1:SignerCompany: ... }}
{{vs:Signer1:SigningDate: ... }}

Een veld koppelen aan een handtekening

Automatische velden en formuliervelden kun je koppelen aan een handtekening. Gebruik hiervoor de optie parent() met de naam van de handtekening.

{{vs:Signer1:TextField:parent(sig1): ... }}

Geef je geen parent op? Dan koppelt ValidSign het veld automatisch aan de eerste handtekening van die ondertekenaar.

Formuliervelden

Naast handtekeningen kun je verschillende invulvelden toevoegen.

De opbouw per veldtype:

{{vs:Signer1:textfield: ... }}
{{vs:Signer1:textarea: ... }}
{{vs:Signer1:list:options(optie1,optie2,optie3): ... }}
{{vs:Signer1:radio:group(naam): ... }}
{{vs:Signer1:checkbox: ... }}
{{vs:Signer1:label: ... }}
{{vs:Signer1:date: ... }}

Meerdere parameters combineren

Je kunt meerdere parameters aan één tekst-tag meegeven. Er zijn twee manieren om ze te scheiden:

• Met dubbele punten (:) — dit is de standaard bij de nieuwe tag.

• Met komma's (,) — dit werkt ook, en werd vooral bij de oude tag gebruikt.

Beide manieren blijven ondersteund.

{{vs:Signer1:textfield:size(200,50):offset(100,200)}}
{{esl:Signer1:Radio:group("2"),size(20,20)}}
{{esl:Signer1:list:options("optie 1","optie 2","optie 3"),size(400,20)}}

Standaardwaarde of hulptekst instellen

Je kunt een veld vast invullen of een hulptekst tonen aan de ondertekenaar.

• Gebruik value() om een vaste waarde in te vullen.

• Gebruik info() om een hulptekst te tonen (zoals een placeholder in een invulveld).

Voorbeelden:

{{vs:Signer1:textfield:info(Vul hier je naam in): ... }}
{{vs_hobby:Signer1:textfield:value(Tennis): ... }}
{{vs:Signer1:textarea:info(Vertel iets over jezelf): ... }}
{{vs:Signer1:list:options(optie1,optie2,optie3):value(optie1): ... }}
{{vs:Signer1:radio:group(naam):value(optie1): ... }}
{{vs:Signer1:label:value(Hallo wereld): ... }}
{{vs:Signer1:date:value(2024-01-01): ... }}

Opmaak van velden

Je kunt de opmaak van formuliervelden aanpassen met de volgende opties:

Toegestane datumformaten

Voor het format()-veld kun je een van deze datumformaten gebruiken:

• yyyy-mm-dd en yyyy-mm-dd hh:mm:ss

• yyyy-mmm-dd en yyyy-mmm-dd hh:mm:ss

• yyyy-mmmm-dd en yyyy-mmmm-dd hh:mm:ss

• dd-mm-yyyy en dd-mm-yyyy hh:mm:ss

• dd-mmm-yyyy en dd-mmm-yyyy hh:mm:ss

• dd-mmmm-yyyy en dd-mmmm-yyyy hh:mm:ss

• mm-dd-yyyy en mm-dd-yyyy hh:mm:ss

• mmm-dd-yyyy en mmm-dd-yyyy hh:mm:ss

• mmmm-dd-yyyy en mmmm-dd-yyyy hh:mm:ss

Betekenis van de afkortingen:

• mm staat voor het maandnummer, zoals 01 of 04.

• mmm staat voor de afkorting van de maand, zoals Jan of Apr.

• mmmm staat voor de volledige maandnaam, zoals January of April.

Voorbeelden van opmaak:

{{vs_address:Signer1:textfield:fontsize(12)}}
{{vs_address:Signer1:textfield:fontfamily(arial)}}
{{vs_address:Signer1:textfield:fontcolor(#f1f1f1)}}
{{vs_address:Signer1:textfield:fontcolor(#f1f1f1):fontsize(12):fontfamily(arial)}}
{{vs_dob:Signer1:date:format(yyyy-mm-dd)}}

Positie en grootte

Je kunt de positie, afmetingen en maximale lengte van een veld instellen.

Voorbeelden:

{{vs:Signer1:textfield:size(200,50)}}
{{vs:Signer1:textfield:offset(100,200)}}
{{vs:Signer1:textfield:max(8)}}
{{vs:Signer1:textfield:size(200,50):offset(100,200)}}
{{esl:Signer1:TextField:size(200,50),Maxlen(10)}}

Standaardwaarden als je iets niet invult

Vul je een optie niet in? Dan gebruikt ValidSign automatisch een standaardwaarde.

Standaard veldtype

Zet je geen veldtype in de tag? Dan wordt het een handtekeningveld. Bijvoorbeeld:

{{vs:Signer1}}

Dit levert een handtekeningveld op voor Signer1.

Standaard afmetingen per veldtype

Standaard groepsnaam voor radioknoppen

Vul je bij een radioknop geen group() in? Dan wordt de groepsnaam automatisch default.

Voorbeelden

Hieronder zie je veelvoorkomende tekst-tags met uitleg. Zowel de nieuwe (vs:) als de oude (esl:) tag zijn geldig.

Handtekeningen

{{vs:Signer1:signature:size(200,50)}}

Klik-om-te-tekenen handtekening voor Signer1 van 200 x 50 pixels.

{{vs:Signer1:capture:size(200,50)}}

Handgeschreven handtekening voor Signer1 van 200 x 50 pixels.

{{vs?:Signer1:signature:size(200,50)}}

Optionele klik-om-te-tekenen handtekening voor Signer1 van 200 x 50 pixels.

{{vs:Signer1:initials:size(50,50)}}

Initialen voor Signer1 van 50 x 50 pixels.

Automatische velden

{{vs:Signer1:SignerName:fontsize(12):size(100,20)}}

Alleen-lezen veld met de naam van de ondertekenaar. Lettergrootte 12 pixels, veld van 100 x 20 pixels.

{{vs:Signer1:SignerTitle:fontsize(12)}}

Alleen-lezen veld met de functie van de ondertekenaar.

{{vs:Signer1:SigningDate:fontsize(12)}}

Alleen-lezen veld met de ondertekendatum.

{{vs:Signer1:firstname(John):lastname(Doe):email(john.doe@validsign.eu):title(Director):company(ValidSign):order(1):signature:size(200,100)}}

Klik-om-te-tekenen handtekening voor een nieuwe ondertekenaar met alle gegevens ingevuld.

Formuliervelden

{{vs_sig1:Signer1:signature:size(200,50)}}

Klik-om-te-tekenen handtekening met de naam sig1.

{{vs_hobby:Signer1:parent(sig1):textfield:info(Wat is je hobby?):size(100,20)}}

Invulveld met de naam hobby. Hulptekst: "Wat is je hobby?". Gekoppeld aan de handtekening sig1.

{{vs*_postal:Signer1:parent(sig1):textfield:size(100,20)}}

Verplicht invulveld met de naam postal. Gekoppeld aan de handtekening sig1.

{{vs_genderMale:Signer1:parent(sig1):radio:group(gender):value(male)}}

Radioknop met de naam genderMale en waarde male. Onderdeel van de groep gender.

{{vs_color:Signer1:list:options(red,blue,green):value(red)}}

Keuzelijst met de naam color. Opties: red, blue en green. Standaardwaarde: red.

{{vs_gender:Signer1:list:options(male,female,unknown):info(Kies je geslacht)}}

Keuzelijst met hulptekst "Kies je geslacht".

{{vs*_biography:Signer1:textarea:offset(200,100)}}

Verplicht invulveld voor meerdere regels tekst. Positie: 200 pixels naar rechts en 100 pixels naar beneden.

{{vs*_phone:Signer1:textfield:size(100,20):max(10)}}

Verplicht invulveld met de naam phone. Maximaal 10 tekens.

{{vs*_terms:Signer1:checkbox}}

Verplicht aanvinkvakje met de naam terms.

{{vs:Signer1:label:value(Dit is een voorbeeld)}}

Alleen-lezen label met de vaste tekst "Dit is een voorbeeld".

{{vs_address:Signer1:textfield:fontcolor(#f1f1f1):fontsize(12):fontfamily(arial)}}

Invulveld met letterkleur #f1f1f1, lettergrootte 12 pixels, lettertype Arial.

Voorbeelden met de oude tag

Deze tags blijven werken en kun je nog steeds gebruiken:

{{esl:Signer1:SignerName:size(200,20)}}                                       // Naam ondertekenaar
{{esl:Signer1:SignerCompany:size(200,20)}}                                    // Bedrijf ondertekenaar
{{esl:Signer1:SignerTitle:size(200,20)}}                                      // Titel ondertekenaar
{{esl:Signer1:SigningDate:size(200,20)}}                                      // Ondertekendatum
{{esl:Signer1:signature:size(200,50)}}                                        // Klik-handtekening
{{esl:Signer1:capture:size(200,50)}}                                          // Grafische handtekening
{{?esl:Signer1:signature:size(200,50)}}                                       // Optionele handtekening
{{esl:Signer1:initials:size(200,50)}}                                         // Paraaf
{{*esl_Tekstvak:Signer1:TextArea:size(200,50)}}                               // Verplicht tekstvak
{{esl_Tekstveld:Signer1:TextField:size(200,20)}}                              // Tekstveld
{{esl:Signer1:TextField:size(200,50),Maxlen(10)}}                             // Tekstveld met max. 10 tekens
{{esl_Keuzelijst:Signer1:list:options("optie 1","optie 2","optie 3"),size(200,20)}}   // Lijst
{{esl:Signer1:Radio:group("1"),size(20,20)}}                                  // Radioknop
{{esl_Voorwaarden:Signer1:Checkbox:size(20,20)}}                              // Checkbox
{{esl_Contractnummer:Signer1:Label:value("PO-243566"),size(200,20)}}          // Label

Problemen oplossen

Foutmelding bij het uploaden van een document

Wat je ziet: ValidSign geeft een foutmelding als je het document uploadt.

Waarschijnlijke oorzaak: je hebt de tekst-tag rechtstreeks in Word getypt. Word gebruikt andere aanhalingstekens (") dan ValidSign verwacht ("). Het verschil is klein en valt bijna niet op.

Wat je kunt doen:

1. Open Kladblok (of een andere platte tekst-editor).

2. Typ de tekst-tag in Kladblok.

3. Kopieer de tag uit Kladblok.

4. Plak de tag op de juiste plek in je Word-document.

5. Upload het document opnieuw naar ValidSign.

De verkeerde placeholder wordt gebruikt

Wat je ziet: de eerste ondertekenaar wordt niet herkend als Signer1, maar als Owner.

Waarschijnlijke oorzaak: je hebt jezelf toegevoegd als ondertekenaar van de transactie. De aanmaker van de transactie krijgt dan de placeholder Owner in plaats van Signer1. De volgende ondertekenaars schuiven door: de tweede wordt Signer1, de derde wordt Signer2, enzovoort.

Wat je kunt doen:

• Bepaal vooraf of je zelf ook ondertekenaar bent.

• Ben je zelf ondertekenaar? Gebruik dan Owner voor je eigen tags. De overige ondertekenaars nummer je vanaf Signer1.

• Ben je alleen aanmaker en geen ondertekenaar? Gebruik dan Signer1 voor de eerste ondertekenaar, Signer2 voor de tweede, enzovoort.

Velden staan niet netjes uitgelijnd

Wat je ziet: radioknoppen, checkboxes of invulvelden verschuiven of overlappen elkaar in het document.

Waarschijnlijke oorzaak: de tekst-tag zelf neemt ruimte in beslag in je Word-document. Als je lettertype in Word groot is, wordt ook de tag groot en drukt hij andere velden weg.

Wat je kunt doen:

• Verklein het lettertype van de tekst-tag zelf in Word. De tag verdwijnt bij het uploaden, dus dit heeft geen invloed op je definitieve document.

• Zet meerdere velden naast elkaar door het lettertype van de tags klein te maken.

• Test het resultaat door een korte proeftransactie aan te maken en te controleren of alle velden op de juiste plek staan.

Wanneer neem je contact op met Support?

Neem contact op met Support als:

• de tekst-tags ook na het volgen van bovenstaande stappen niet worden herkend;

• velden op een plek worden geplaatst waar geen tag stond;

• je een foutmelding krijgt die niet in dit artikel staat.

Houd bij het contact opnemen je Word-document en (indien mogelijk) een schermafbeelding van de foutmelding bij de hand.