Enkele modules werken binnen AllUnited met codegebruik. Om het onze gebruikers makkelijker te maken proberen wij hier een overzicht te geven van alle codes en de betekenis hiervan. Ook zullen we uitleggen hoe ze toe te passen. Let op, dit is een traject in ontwikkeling, dus dit zal de komende tijd uitgebreid worden.

Standaard veldnaamvertalingen:

Eigengemaakte velden bij inschrijfformulieren

Bij de diverse inschrijfformulieren heb je het blok 'Vragen', waarin je zelf van alles kan weergeven, vragen. Wil je het antwoord op deze vragen terugzien?

Zet dan de veldnaam die behoort bij het 'antwoord' dat je terug wilt laten komen bij je rapportage of afdrukformulier hier neer met een onderliggend streepje ervoor, bijv. _akkoord_machtiging

Let wel op dat je bij het inschrijfformulier zorgt dat bij de veldnamen geen hoofdletters staan en ook liever geen spaties of aparte tekens.

Gebruik bij Lijst & Bestandsopmaak (te vinden onder Communicatie & Rapportages >> Instellingen):

De velden die via het opmaakbestand naar voren moeten komen geef je in door de veldcodes ',-gescheiden' in te voeren. Een eigen beschrijving voor de codes? Voer dan achter de veldcode de 'vertaling' hiervan ':-gescheiden' in. De ',' volgt dan achter de vertaling.

Gebruik bij Afdrukformulieren (o.a. te vinden onder Relaties >> Instellingen):

Een relatiegebonden veld voer je hier in door de veldcode tussen rechthoekige haakjes te zetten: [ ]

Opmaak velden beïnvloeden

Het is mogelijk om de opmaak van velden te beïnvloeden. Denk hierbij aan het omzetten van de datum naar een leesbare tekst of het omzetten van het veld in hoofdletters. Dit kan door achter de veldnaam ';-gescheiden' een code toe te voegen. 

Welke codes kan je allemaal gebruiken?

• A - bijvoorbeeld [amount;A2] >> 2000 wordt dan 2000,00 (2 staat voor het aantal decimalen achter de ',')
• C - bijvoorbeeld [city;CU] of [prelastname;CL] >> Amsterdam wordt AMSTERDAM of Van wordt van (CU zorgt voor hoofdletters en CL voor kleine letters)
• D - bijvoorbeeld [birthdate;D] >> de geboortedatum wordt dan omgezet van 2017-04-29 naar 29-04-2017
• I - bijvoorbeeld [counter;I] >> 2000.0 wordt 2000 (decimalen worden verwijderd)
• F - bijvoorbeeld [counter;F2] >> 2000.0 wordt 2000,00 (de punt wordt omgezet in ',' en de 2 zorgt voor het aantal getoonde decimalen)
• P - bijvoorbeeld [counter;P1] >> 0.153 wordt 15,3% (P zorgt voor de omzet in een percentage en de 1 zorg voor het aantal getoonde decimalen)
• T - bijvoorbeeld [eventtime;T] >> 14:30:00 wordt 14:30 (T zorgt voor de basis weergave van een tijdstip)
• S - bijvoorbeeld [editdate;S] >> 2017-04-29 12:15:23 wordt 29-04-2017 12:15:23 (het vastgelegde tijdstip wordt hierdoor omgezet in standaard schrijfwijze)

Binnen AllUnited kan je allerlei pdf-documenten maken. Dit doe je o.a. via Relaties >> Instellingen >> Afdrukformulieren.

Hier wordt veel codetaal gebruikt. Hier een aantal tips.

Fonts/lettertypes

Binnen de formulieren zijn maar een beperkt aantal fonts te gebruiken. Een font geef je als volgt aan:

• <font arial>soort lettertype
• <fontsize 10> lettergrootte
• <b>vet</b> dik gedrukt
• <u>onderstreept</u> onderstreept
• <i>schuin gedrukt</i>
• <fontcolor #FFFFFF> hiermee kan je via de html kleurcode de kleur van het lettertype bepalen
  voor het beëindigen van de kleur gebruik je dezelfde code maar dan met de oorspronkelijke kleur, over het algemeen <fontcolor #000000>.

We kennen de volgende soorten lettertypes:

• arial
• kix
• times
• ocr

Tabs instellen

Tabinstellingen kan je op drie manieren aangeven: met een L (links uitgelijnd), een R (rechts uitgelijnd) of een C (midden uitgelijnd) ervoor. Daarnaast geeft je een getal in. Welk getal je moet nemen hangt van veel factoren af, dus dit is vaak een kwestie van uitproberen.

Hoe verwerk je een tabset in het document? Hieronder twee voorbeelden:

• <tabset C70> (een tab, midden uitgelijnd) 
• <tabset L25;L50;R157> (drie tabs (;-gescheiden), waarvan de eerste twee links uitgelijnd zijn en de laatste rechts uitgelijnd is)

Let op, de instellingen voor Centrering en Recht uitlijnen werkt niet bij afbeeldingen en/of lijnen (in dat geval moet zelf even gepuzzeld worden waar de tab het best kan vallen)

N.B. Tabinstellingen in Koptekst of Voettekst worden niet overgenomen in Body1, Subbody1, Body2, Subbody2 of Body3 en andersom ook niet.

Andere veelgebruikte codes

• <tab> Hiermee maak je tab zoals hierboven omschreven is ingesteld, dus afhankelijk van de positie waar je iets wilt hebben zal je zoveel keer het veld <tab> ervoor moeten plaatsen. Dus bij <tabset L25;L50;R157> wil je een tekst op de positie L50 laten beginnen, dan zet je hier <tab><tab> voor.
• <hline 180;0.2;T>  Horizontale lijn waarbij het getal '180' de lengte aangeeft, '0.2' de dikte (vul je dit niet in dan is de standaard 0.2) en 'T' de positie (je kan kiezen uit T (bovenaan), C (gecentreerd) of B (onderaan) - vul je dit niet in dan zal de lijn altijd gecentreerd weergegeven worden)
• <vline 0.1;30;T> Verticale lijn waarbij het getal '0.1' de dikte aangeeft en '30' de lengte, verder geldt hetzelfde als bij de horizontale lijn, alleen kennen we hier de positie C niet en wel F (staat voor hele regelhoogte en is de standaard)
• <image Logo_HCC_zw.jpg;30>   Afbeelding, waarbij het getal de grootte (breedte) aangeeft
• <logo 30> Logo, waar het getal de grootte (breedte) aangeeft.
• <newpage> Nieuwe pagina
• <contactimage;30> Foto van de relatiekaart, getoond in een bepaalde breedte
• <fields> zorgt voor de vertoning van alle beschikbare velden die je in het afdrukformulier kunt gebruiken.

Link aanmaken binnen een formulier

Dit kan. Hierbij een voorbeeld: <u><link hier;https://tinyurl.com/y6w7kdo9></u> of <u><link info@allunited.nl;mailto:info@allunited.nl></u>. Het middelste gedeelte zorgt voor de link. De buitenste codes zorgen dat de link zichtbaar te onderscheiden is in het formulier.  

Verdere uitleg over het linkgedeelte: 'link' staat voor het maken van de link, vervolgens plaats je een spatie met daarachter de tekst waaronder je de link wilt plaatsen. Dan volgt de ';' met direct daarachter de bijbehorende link.

Afbeeldingen toevoegen aan een formulier

Je kan afbeeldingen toevoegen aan een formulier. Daarvoor moet je eerst een afbeelding opladen in de backoffice. Dit gaat via Systeembeheer >> Alle instellingen >> Blok Algemeen >> Afdrukformulieren >> Tab Afbeeldingen.  Let wel op dat het een afbeelding is met jpg.formaat. Andere formaten zorgen voor foutmeldingen.

Deze afbeelding kan je toevoegen aan het afdrukformulier. Stel de foto heet clubfoto.jpg, dan voeg je de foto toe als volgt: <image clubfoto.jpg;40>.  Het getal achter de ';' bepaalt de grootte. Let ook op dat je afhankelijk van de gekozen grootte voldoende lege regels toevoegt onder de foto.

Afbeelding als standaard logo aanwijzen

Het is nu ook mogelijk het logo standaard in het afdrukformulier op te nemen. Door hiervoor te kiezen hoef je niet bij verandering van het logo elk afdrukformulier aan te passen. Klik hiervoor bij de afbeelding de checkbox in de kolom Logo aan bij de instellingen van de afbeeldingen. Voeg vervolgens het logo toe aan het afdrukformulier via <logo 30> of <logo 30;40>. De laatste als je zelf de breedte en de hoogte wilt beïnvloeden. Dit zal wel de verhouding van de afbeelding beïnvloeden. 30 staat voor de breedte en 40 voor de hoogte in dit geval.

Standaard verenigingsvelden opnemen

Het is nu mogelijk om standaard verenigingsvelden op te nemen in het afdrukformulier. Deze velden kun je invullen bij Systeembeheer >> Alle instellingen >> Systeeminfo. De volgende velden kunnen hiervoor in het afdrukformulier opgenomen worden:

Naam: [sy_name]
Lange naam organisatie: [sy_name_long]
Oprichtingsdatum: [sy_incorpdate;D]
Club adres 1: [sy_street1] - [sy_housenumber1] - [sy_postalcode1] - [sy_city1] - [sy_country1]
Club adres 2: Zie 1 maar dan met een 2 erachter
Club adres 3: Idem, maar dan met een 3 erachter
E-mail: [sy_email]
Webformulier e-mail: [sy_webformemail]
Website: [sy_website_url]
Club telefoon 1: [sy_phonenumber1]
Club telefoon 2: [sy_phonenumber2]
Club telefoon 3: [sy_phonenumber3]
Belastingnummer: [sy_taxnumber_org]
BTW nummer: [sy_taxnumber]
KvK nummer: [sy_cocnumber]
KvK plaats: [sy_coccity]
IBAN nr: [sy_iban]

Standaard functionarisvelden opnemen in het afdrukformulier

Het is nu ook mogelijk velden op te nemen in het afdrukformulier, zoals bijvoorbeeld de naam en functiegegeven van de voorzitter, penningmeester, secretaris of ledenadministrateur. Deze velden starten allemaal met sy_ tussen blokhaakjes. Dit zal zijn:

Voorzitter: [sy_chairman_veldnaam]
Penningmeester: [sy_treasurer_veldnaam]
Secretaris: [sy_secretary_veldnaam]
Ledenadministrateur: [sy_memberclerk_veldnaam]

Voor veldnaam heb je de volgende opties: name1, name2, name3, name4, email, street, housenumber, postalcode, city, phone, function, dus je krijgt dan bijvoorbeeld een veld als deze: [sy_memberclerk_function]

N.B. Om deze gegevens te zien moet de functionaris gekoppeld zijn aan de bijbehorende bondsfunctie als jouw vereniging gekoppeld is via AllUnited aan een sportbond. Ben je als vereniging niet verbonden aan een sportbond, dan zal de functie de volgende code moeten bevatten:
Voorzitter: BESVZ
Penningmeester: BESPEN
Secretaris: BESSEC
Ledenadministrateur: VERLDM

Verenigingsid vanuit de bijbehorende bond opnemen in het afdrukformulier:

Gebruik hier ook sy_ als voorloper voor, daarna de bondsnaam gevolgd door _leagueclubid, zie hiervoor de twee onderstaande voorbeelden:

KNHB verenigingsnummer: [sy_knhb_leagueclubid]
KLTB verenigingsnummer: [sy_knltb_leagueclubid]

Barcode aanmaken

Via de tag <barcode128> of <barcode39>is het mogelijk om een barcode op basis van een veld te maken in het afdrukformulier. Voorbeelden van een dergelijke opbouw:<barcode128 contactid;20;1> of <barcode39 contactid;40;1>

Uitleg:

• barcode128 of barcode39 staan voor de daadwerkelijke barcodes
• contactid staat voor het veld (relatienummer in dit geval) waarvoor de een barcode wilt maken (kan ook een ander veld zijn)
• 20;1 of 40;1 staan voor de breedte resp. hoogteverhoudingen waarop de barcode getoond gaat worden

QR Code aanmaken

Via de tag <qrcode> is het mogelijk om een QR code op basis van een veld te maken in het afdrukformulier. Voorbeelden van een dergelijke opbouw zijn:

<qrcode contactid;M;4> of <qrcode md5_contactid;M;4>

Uitleg:

• qrcode staat voor de standaard QR code
• contactid staat voor het veld waarvan de QR code wordt gemaakt (zet je hier 'md5_' voor, dan wordt dit veld eerst gecodeerd voordat de QR code ervan wordt gemaakt)
• M staat voor de kwaliteit van de resolutie van de QR-code (je kan kiezen - van laag naar hoog - tussen L, M, Q of H)
• 4 staat voor de grootte waarin de QR code getoond wordt

Veldcodes vanuit inschrijfformulieren

Bij inschrijfbevestigingen kan je de opgegeven antwoorden in het inschrijfformulier laten komen. Daarbij moet je wel zorgen dat bij de opmaak van het inschrijfformulier de opmaak van de opgegeven veldnamen aan de volgende eisen voldoen:

• Maak geen gebruik van diakritische tekens op '-' en '_' na
• Maak geen gebruik van hoofdletters
• Maak geen gebruik van spaties
• Zorg dat de veldnamen uniek zijn (op de veldnamen voor radiobuttons na, deze moeten juist identiek zijn als het om het beantwoorden van dezelfde vraag gaat)

Om de antwoorden terug te laten komen in de inschrijfbevestiging voeg je nu de veldnaam tussen brackets toe met een voorliggend underscore teken, dus bijvoorbeeld [_veldnaam_formuliervraag]

Mocht je syntax formules willen gebruiken specifiek voor deze formuliervelden, voeg dan ook in de syntax de underscore toe, bijv. <if _veldnaam_formuliervraag;=;ja>Tekst 1<else>Tekst 2<endif>. Kijk hiervoor verder naar het kopje 'Formules voor afdrukformulieren' hieronder.

Veldcodes specifiek voor meest voorkomende afdrukformulieren (meer in detail, maar zeker niet uitputtend vind je in het vorige artikel 'Woordenboek'

Formules voor afdrukformulieren

Om teksten flexibeler op te kunnen zetten, zodat je de juiste tekst bij het de juiste persoon krijgt, wordt gebruik gemaakt van if-statements'.

Binnen de if-statements kennen we de volgende vergelijkingstypes:

• = >> Gelijk aan, voorbeeld <if sex;=;'M'>
• <> of != of NE >> Niet gelijk aan, voorbeeld <if sex;!=;'M'>, <if sex;<>;'M'> of <if sex;NE;'M'>
• < >> Kleiner dan, voorbeeld <if age;<;18>
• <= of LE >> Kleiner dan of gelijk aan, voorbeeld <if age;<=;18> of <if age;LE;18>
• GT >> Groter dan, voorbeeld <if age;GT;18>
• => of GE >> Groter dan of gelijk aan, voorbeeld <if age;=>;18> of <if age;GE;18>
• NULL >> Veld is leeg, voorbeeld <if email;NULL>
• !NULL >> Veld is niet leeg, voorbeeld <if email;!NULL>

Hier enkele voorbeelden, die gebruikt kunnen worden.

Adressering/Persoonlijk aanschrijven van relaties

Aanhef:
[salutation_name2] - Dit werkt niet via een if-statement, maar je stelt dit in via Systeembeheer >> Alle instellingen >> Club bij het blok 'Aanhef'

Adressering

Elk type afdrukformulier kent wel zo zijn eigen regels qua adressering. Hieronder staat beschreven welk type adressering je gebruikt bij welk type formulier

Naamregel adres bij afdrukformulieren voor Algemene brieven/etiketten:
[salutation_name1] - Dit werkt niet via een if-statement, maar je stelt dit in via Systeembeheer >> Alle instellingen >> Club bij het blok 'Aanhef'

Het verdere adres zet je er als volgt in:

[mailaddress1]
[mailaddress2]
[mailaddress3]

Let op: Bij afdrukformulieren voor facturen werkt de adressering als volgt:

[address1]
[address2]
[address3]
[address4]

Bij afdrukformulieren voor inschrijfbrieven weer als volgt:

[name1]
[address1]
[address2]
[address3] 

Andere manieren zijn:

 <if age;<;18>Aan de ouders of verzorgers van [firstname],<else>Beste [firstname],<endif> 

Factuurregels

Creditnota aangeven

<if amount;<;0>Dit is een creditnota

Nulfactuur aangeven

<if amount;=;0>

Debetfactuur aangeven

<if amount;>;0>

BTW onderscheid maken 21% versus 0%

<if salestaxcode;=;'BH'>21%<else>0%<endif>

Let op: If-statements moeten altijd afgesloten worden door <endif>

Formaattips

Adres in vensterenvelop:
tab: tussen L5 en L10
Eerste lijn op regel 10 bij kop. Is de kop ingesteld op 30, dan op regel 2 bij body 1.