Een formulier is een scherm met elementen waar de gebruiker gegevens kan invoeren die een verschillend formaat mogen hebben en/of uit keuzen kunnen bestaan. Een dergelijk formulier wordt opgebouwd met zeven standaardelementen die in een lijstbestand gedefinieerd worden. CDLJava start dit lijstbestand met een openingsscherm zoals ook vragenlijsten en andere tests gestart worden. Reeds bekende gegevens in het formulier worden automatisch ingevuld en kan men wijzigen.
Een formulier is ook in een onderzoek op te nemen. Na afname worden
de gegevens gerapporteerd (indien de feedback optie aanstaat) en direct
in het databestand opgeslagen (alleen in CDLJava als applicatie!!!).
De gegevens van een formulier zijn als variabelen beschikbaar voor
rapportage in een tekst; niet alleen in de rapportgenerator van het betreffende
formulier maar voor alle rapportgenerators!!! Kies daarom steeds unieke variabelnamen.
In het onderstaande worden de elementen beschreven, uitgelegd hoe een
formulier gemaakt kan worden en hoe de data uit een formulier gebruikt
kunnen worden in een rapportgenerator. Tot slot volgt er een toelichting
op de wijze waarop de data van een formulier in het databestand staan.
Het formulier kan samengesteld worden met zeven elementen die door elkaar
en meermaals in een formulier gebruikt mogen worden. CDLJava kent de volgende
elementen:
Onderstaand voorbeeld in CDLJava geeft een formulier met alle elementen
weer. Start de toepassing, vul enige gegevens in, na het invullen van de
personalia, en zie hoe de data door de rapportgenerator worden gerapporteerd.
Een formulier wordt gedefinieerd in een lijstbestand. Het lijstbestand bestaat uit zes velden die gescheiden worden door een tilde (~). De velden bevatten respectievelijk tekst voor:
Het scherm van een formulier kan men opvatten als een tabel met twee kolommen,
die rij
voor rij van links naar rechts gevuld worden. Het aantal rijen in het formulier
wordt bepaald door het aantal opgegeven elementen. Standaard voegt CDLJava
de knop "Klaar" aan het formulier toe. De grootte van de cel wordt bepaald
door het aantal rijen: de beschikbare ruimte op het scherm wordt verdeeld
over de rijen. Een formulier met twee elementen bestaat dus uit één rij
die het hele scherm beslaat exclusief de ruimte voor de knop "Klaar".
De syntax voor het opgeven van de elementen list, choice, checkbox
en checkboxgroup is als volgt:
list|<naam element>|<aantal keuzes>|<keuze1>|<keuze2>......
choice|<naam element>|<aantal keuzes>|<keuze1>|<keuze2>......
checkbox|<naam element>|<aantal keuzes>|<keuze1>|<keuze2>......
checkboxgroep|<naam element>|<aantal keuzes>|<keuze1>|<keuze2>......
Bij checkbox wordt de naam van het element achter de checkbox geplaatst.
Bij checkboxgroup worden, in een cel, de keuzen als tekst achter de keuzeboxen
geplaatst.
Een label heeft een naam die tevens de tekst is die op het scherm geplaatst
wordt. De syntax is:
label|<tekst>
De tekst wordt rechts gecentreerd. Bijvoorbeeld: label|Dit is een
label
De tekst-invoervelden textfield en textarea hebben een naam en respectievelijk
een en twee getallen om de grootte van de velden aan te geven. De syntax
is als volgt:
textfield|<naam>|<aantal karakters>
textarea|<naam>|<aantal karakters>|<aantal regels>
Het voorbeeldformulier bij deze uitleg bevat links op het scherm steeds
een label met rechts een element. Het zesde veld van het lijstbestand "formuliervoorbeeld.lijst"
definieert het formulier als volgt:
een formuliervoorbeeldDe tekst tot aan de "#" is vrije tekst voor commentaar en wordt door CDLJava niet gelezen. De lay-out verdient aandacht om plezierig te kunnen werken in het formulier. Daarom enige tips:
#
label|een keuze vak met 4 velden
choice|choice1|4|keuze1|keuze2|keuze3|keuze4
label|een tekstveld met 40 posities
textfield|textfield1|40
label|een memoveld van 40 bij 5 regels
textarea|textarea1|40|5
label|een checkboxgroep met twee keuzes
checkboxgroup|geslacht|2|man|vrouw
label|een checkbox....
checkbox|checkbox1|check indien accoord
label|een list met vijf keuzes
list|list1|5|1|2|3|4|5
De data van een element in een formulier wordt bewaard in een variabel.
De naam van de variabel is de naam van het element en de waarde bevat
de keuze, true/false of tekst afhankelijk van het element. De variabelen
kunnen tijdens het rapportgenereren gebruikt worden bij het scoren. Zie
CDLJavavullen.html 3. Rapportgenereren
. De variabelen mogen na afname van het formulier in alle rapportteksten
gebruikt worden.
Een formulier kan een eigen rapporttekst hebben die dan in het lijstbestand
waarin het formulier staat in veld vier opgenomen worden. In tegenstelling
tot bij een vragenlijst wordt bij een formulier alleen een rapporttekst
gedefinieerd in veld vier door het opgeven van een tekstbestand. Het
tekstbestand zelf staat in map "cdljava/lijst/rap".
Het voorbeeldformulier van deze uitleg bevat voor rapportgenereren
de volgende regels in het lijstbestand:
rapportgenerator voor dit formulier rapporteer alle waarden van de veldenDe tekst tot "#" is vrije tekst voor commentaar en wordt door CDLJava niet gelezen. Vervolgens wordt de naam van het tekstbestand gegeven; na "|" volgt eventueel nog commentaar die door CDLJava niet gelezen wordt.
#formulier1.rap |altijd rapporteren
+++++++++++++++Formulier2 rapportage+++++++++++++++++++
Deze rapportage bevat alle velden waarover gerapporteerd
kan worden.
De actuele waarden worden tijdens rapportgeneratie
ingevuld.
choice1 bevatte 4 keuzes: keuze1|keuze2|keuze3|keuze4 en de gekozen is: $choice1$
textfield1 werd ingevuld met: $textfield1$
textarea1 kon meerder regels bevatten
maar die zijn op een regel gezet:
$textarea1$
checkboxgroup geslacht bevatte twee keuzes (man en
vrouw)
de waarde is $geslacht$
checkbox1 met de tekst "check indien accoord"
en heeft de waarde $checkbox1$
list1 bevatte 5 keuzes |1|2|3|4|5
en gekozen is: $list1$
de standaardvariabelen zijn:
naam: $naam$
sexe: $sexe$
leeftijd: $leeftijd$
opleiding: $opleiding$
groep: $groep$
++++++++++++++Formulier1 rapportage einde+++++++++++++++
De tekst tussen de $-tekens zijn de variabelnamen die gelijk zijn aan de elementnamen
van het formulier. CDLJava vult de ingevoerde tekst of keuzes tijdens het
rapporteren automatisch in. Niet ingevulde tekstvelden krijgen de waarde
null.
De standaardvariabelen zijn altijd aanwezig en komen uit de opgegeven
personalia.
De rapportage van formulieren volgt direct na het scoreoverzicht voor
de rapporttekst van de vragenlijsten.
4. De gegevens in het databestand
De data van een formulier worden bewaard in variabelen. In CDLJava als applicatie worden deze variabelen automatisch in het databestand behorende bij de opgegeven personalia, bewaard. Iedere keer als een databestand bij het opgeven van de personalia gebruikt wordt, worden de variabelen ingelezen en zijn ze voor rapportage met een rapportgenerator beschikbaar.
Na afname van het voorbeeldformulier staan deze regels in het databestand:
variabel: naam = RenéHet sleutelwoord "variabel" geeft aan dat er een variabel volgt. Eerst de naam dan "=" waarna de waarde.
variabel: sexe = Man
variabel: leeftijd = 44
variabel: opleiding = LO
variabel: groep = Geen
variabel: choice1 = keuze2
variabel: textfield1 = eweqf
variabel: textarea1 = ce ewqe cw qec ewqw
variabel: geslacht = vrouw
variabel: checkbox1 = true
variabel: list1 = 1formulier formuliervoorbeeld :
!!Wijzig deze datafiles nooit zelf !!
CDLJava weigert alle diensten bij corrupte datafiles en de juiste
werking van het programma is niet meer gegarandeerd. Werk dus altijd met
kopieën van de datafiles.