Actions

Survey participants/nl: Difference between revisions

From LimeSurvey Manual

No edit summary
No edit summary
 
(358 intermediate revisions by 3 users not shown)
Line 3: Line 3:
=Inleiding=
=Inleiding=


Vaak wil je een groep mensen uitnodigen om je enquête in te vullen. Je wilt bijhouden wie de enquête heeft ingevuld en er voor zorgen dat iedereen maar een keer de enquête kan invullen. Met tokens kun je het volgende doen:
 
*Importeren van een lijst met namen en e-mailadressen van deelnemers (invoer is een CSV bestand of een LDAP query)
Deelnemers zijn mensen die je wilt uitnodigen om je enquête in te vullen. Je wilt bijhouden wie de enquête heeft ingevuld en er voor zorgen dat iedereen maar een keer de enquête kan invullen. Je kan het volgende doen:
*Importeren van een lijst met namen en e-mailadressen van deelnemers. Invoer is een [[Survey_participants/nl#Deelnemers uit een CSV-bestand importeren|CSV bestand]] of een [[Survey_participants/nl#Deelnemers uit een LDAP-query importeren|LDAP query]]
*Genereren van een unieke toegangscode voor elke gewenste deelnemer
*Genereren van een unieke toegangscode voor elke gewenste deelnemer
*Een e-mail versturen naar elke gewenste deelnemer met de uitnodiging om deel te nemen (per groep of individueel).
*Een e-mail versturen naar elke gewenste deelnemer met de uitnodiging om deel te nemen (per groep of individueel).
Line 15: Line 16:
Nadat je van je enquête een besloten enquête hebt gemaakt, (je hebt tokens ingeschakeld voor je enquête), dan kunnen '''alleen de mensen met een geldige toegangscode (token) die nog niet gebruikt is,''' de enquête invullen.
Nadat je van je enquête een besloten enquête hebt gemaakt, (je hebt tokens ingeschakeld voor je enquête), dan kunnen '''alleen de mensen met een geldige toegangscode (token) die nog niet gebruikt is,''' de enquête invullen.


Als je ''Openbare aanmeldingen'' toestaat in de enquête instellingen, dan kunnen deelnemers zichzelf als deelnemer aanmelden, er wordt dan automatisch een token aangemaakt.
Als je [[Participant settings/nl|Openbare aanmeldingen]] toestaat in de enquête instellingen, dan kunnen deelnemers zichzelf als deelnemer aanmelden, er wordt dan automatisch een token aangemaakt.
 
{{Note|Enkele toegangscode gerelateerde instellingen worden gedaan in het paneel [[Participant settings/nl|deelnemers]].}}
 
=Hoe maak je een deelnemerstabel aan?=
 
 
Om gebruik te maken van een deelnemerstabel selecteer je de enquête en klik je op de knop '''Deelnemers''' in het menu '''Instellingen'''.
 
 
<center>[[File:Survey_participants_settings_tab.png]]</center>
 
 
Je krijgt dan de volgende melding:
 
 
<center>[[File:Switch-to-closed-access-mode-2.png]]</center>
 
 
Als je een deelnemerstabel initialiseert dan is de enquête alleen in te vullen door mensen die die een toegangscode (handmatig of via URL) toegekend hebben gekregen. De enquête is dan '''besloten'''.
 
Na het initialiseren komt er een melding dan er een deelnemerstabel is aangemaakt.
 
 
==Deelnemerstabel reactiveren==
 
 
Als je een deelnemerstabel verwijderd wordt er een back-up aangemaakt. Deze kun je later weer activeren als je die deelnemerstabel in een andere enquête wilt gebruiken.
 
 
<center>[[File:Restore old token tables.png]]</center>
 
=Beheer tools deelnemerstabel=
 
 
Er wordt een samenvatting getoond als er al een deelnemerstabel is. Het standaardscherm:
 
 
<center>[[File:Survey participant summary.png]]</center>
 
 
*'''Aantal records:''' Het aantal deelnemers in de deelnemerstabel van de enquête.
*'''Aantal zonder unieke toegangscode'''
*'''Totaal aantal uitnodigingen verzonden:''' Het aantal verzonden uitnodigen via de optie [[Survey participants/nl#Uitnodigingen en herinneringen|Uitnodigingen en herinneringen]].
*'''Totaal aantal afmeldingen:''' Het aantal deelnemers dat zich heeft afgemeld voor de enquête via de optie [[Email_templates/nl#Afmelden door deelnemer|opt-out]].
*'''Aantal afgeschermd'''
Tonen en uitsluiten mogelijke deelnemers niet niet aan bepaalde criteria voldoen.
*'''Totaal aantal voltooide enquêtes:''' Aantal door deelnemers met een toegangscode voltooide responsen.
 
 
Boven de samenvatting staat een taakbalk:
 
 
<center>[[File:token-menu2.png]]</center>
 
 
*[[Survey participants/nl#Deelnemers tonen|Toon deelnemers]]: Je ziet dan alle huidige deelnemers aan de enquête, je kunt de regels daarna bewerken, verwijderen of er een aantal functies  op uitvoeren.
*[[Survey participants/nl#Aanmaken...|Aanmaken...]]: Een optie om deelnemers toe te voegen aan de tabel, dit kan ook met de optie '''Voeg deelnemer toe''' en via '''Importeer deelnemers'''.
*[[Survey participants/nl#Attributen beheren|Attributen beheren]]: De enquête-beheerder kan aanvullende velden registreren en beheren bij de deelnemers die de beheerder nodig heeft bij die enquête.
*[[Survey participants/nl#Exporteren|Exporteer gegevens]]: Je kunt de tabel exporteren in een csv-formaat.
*[[Survey participants/nl#Uitnodigingen en herinneringen|Uitnodigingen en herinneringen]]: Een handige functie op snel e-mails te versturen naar je deelnemers.
*[[Survey participants/nl#Tokens genereren|Toegangscodes aanmaken]]: de enquête-beheerder kan snel unieke toegangscodes toekennen aan de deelnemers die nog geen toegangscode hebben.
*[[Survey participants/nl#Tonen in deelnemersdatabase|In CPDB bekijken]]: een knop waarmee je snel toegang hebt tot de centrale [[Central Participant Database/nl|Deelnemersdatabase]] (CPDB). Je kunt al bekende deelnemers (van andere enquêtes) als deelnemers registreren aan jouw enquête.
 
 
==Deelnemers tonen==
 
 
Het overzicht toont alle toegangscodes in een lijstvorm. Er zijn een aantal knoppen met een 'actie' die op toegangscodes kunnen worden uitgevoerd.
*[[Survey participants/nl#Enquête deelnemers sorteren|de deelnemers sorteren]]
*[[Survey participants/nl#Enquête deelnemers filteren|de deelnemers filteren]]
*[[Survey participants/nl#Specifieke actie op een deelnemer|acties op één toegangscode]]
*[[Survey participants/nl#Specifieke actie op meerdere deelnemers|specifieke actie op meerdere toegangscodes]]
 
 
<center>[[File:token-actions.png]]</center>
 
 
===Enquête deelnemers sorteren===
 
 
De volgende regel in de tabel heeft verschillende criteria om de tokens te sorteren. Klik op de kolom om op die kolom te sorteren. Klik nog een keer om de volgorde om te draaien.
 
 
<center>[[File:Display participants - sort.png]]</center>


{{Hint/nl|Text=Enkele token instellingen worden gezet in de enquête instellingen, zie [[Creating a new survey/nl#Toegangscodes|Maken van een nieuwe enquête]]}}


==Is de enquête anoniem?==
===Enquête deelnemers filteren===
 
 
Als je de deelnemers wilt filteren, vul dan in de eerste regel onder de kopregel het veld in waarop je wilt filteren.
 
 
<center>[[File:Display participants - filter.png]]</center>
 
 
Je kunt bijvoorbeeld op e-mailstatus ''OK'' selecteren om de deelnemers te krijgen die een werkend e-mailadres hebben.
 
<div class="simplebox">[[File:help.png]] '''TIP:''' Je kunt ook operatoren gebruiken bij het filteren van de deelnemers (bijv.: >, <, >=, <=, = ). </div>
 
{{Alert|title=Attentie|text=Om te filteren op de kolommen "uitnodiging verzonden", "herinnering verzonden" en "enquête voltooid", gebruik "=N" of "<>N", wat resp. betekent "gelijk nr" en "ongelijk Nee".}}
 
===Specifieke actie op een deelnemer===
 
 
De kolom '''Actie''' bevat de acties die mogelijk zijn op de gegevens van die deelnemer. De mogelijke acties zijn:
 
 
<center>[[File:Display participants - participant action.png]]</center>
 
 
*'''Bekijk details respons:''' Bij een niet anonieme enquête is er ook een knop om de respons te bekijken.
*'''Voer de enquête uit met dit token'''
*'''Verzend uitnodiging:''' Verstuur een uitnodiging naar deze deelnemer om de enquête in te vullen.
*'''Wijzig deelnemer'''
*'''Verwijder deelnemer'''
*'''Bekijk deze persoon in de deelnemersdatabase''': Optioneel, alleen als de deelnemer daarin voorkomt.
 
===Specifieke actie op meerdere deelnemers===
 
 
Onder de tabel met deelnemers staat links de knop '''Geselecteerde deelnemer(s)...''' waarmee je acties op meerdere deelnemers tegelijk kunt uitvoeren.
 
 
<center>[[File:Display participants - participants actions.png]]</center>
 
 
*'''Verzend uitnodigingen:''' Uitnodigingen e-mailen naar de geselecteerde deelnemers.
*'''Verzend herinneringen:''' Herinneringen e-mailen naar de geselecteerde deelnemers.
*'''Voeg deelnemers toe aan de deelnemersdatabase:''' Als je de (geselecteerde) deelnemers ook in een andere enquête wilt gebruiken kun je ze toevoegen aan de [[Central Participant Database/nl|deelnemersdatabase]]. Meer informatie over [[Central_Participant_Database/nl#Deelnemer delen|deelnemers delen]].
 
 
{{Box|Als je een van deze functies gebruikt, selecteer dan eerst de deelnemers.}}
 
==Aanmaken...==
 


Ja, je kunt ook met het gebruik van toegangscodes de enquête anoniem houden. Je bepaalt bij het aanmaken van de enquête of die anoniem is of niet anoniem. Als de enquête niet anoniem is worden de toegangscodes gebruikt om de respons te koppelen aan de deelnemer. Bij een anonieme enquête met toegangscodes, wordt deze link (foreign key relatie) niet gelegd.
Als je meer deelnemers wilt toevoegen dan kun je ze handmatig toevoegen of ze importeren uit een CSV-bestand of een LDAP-query.  


=Tokens activeren=


Je kunt op twee manieren tokens activeren:
<center>[[File:Survey participants - Create....png]]</center>
#Bij het activeren enquête, krijg je de vraag of je tokens wilt activeren: [[File:Switch-to-closed-access-mode-2.png]]
# '''OF ''' klik op het icoon tokens [[File:tokens.png]] - voordat de enquête is geactiveerd.


=Beheer toegangscodes=


[[File:token-menu2.png]]
===Deelnemer toevoegen===


Na het aanmaken van de toegangscode-tabel kun je klikken op het icoon tokens om de tokens te gaan beheren. Hieronder worden beknopt de functies weergegeven:
*'''Keer terug naar beheer''': Je gaat terug naar enquête-scherm.
*'''Toon samenvatting''': Er wordt een korte samenvatting getoond over de toegangscodes in de enquête  (aantal, aantal uitnodigingen, aantal die ingevuld hebben). Ook heb je toegang tot wat functie van de administratie (zie onder). Het standaard scherm.
*'''Toon toegangscodes''': Toont alle deelnemers in de toegangscode-tabel, van hieruit kun je een specifieke toegangscode wijzigen of verwijderen, maar je kunt hier ook andere functies uitvoeren (zie onderstaande functie toon).
*'''Voeg nieuwe toegangscode toe''': je kunt een nieuwe toegangscode toevoegen.
*'''Maak dummy toegangscodes''': je kunt 1 of meer toegangscodes toevoegen.
*'''Beheer extra attributen''': Je kunt extra velden toevoegen aan de tokens om gegevens van deelnemers vast te leggen.
*'''Importeren uit CSV''': Je kunt toegangscodes importeren uit een csv-bestand.
*'''Importeer uit LDAP query''': Importeren toegangscodes uit een LDAP query (alleen getest op openLdap maar zou ook op andere LDAP vergelijkbare omgevingen, zoals ActiveDirectory, moeten werken).
*'''Exporteer tokens naar CSV''': maakt een standaard csv-bestand aan met alle deelnemers
*'''Bewerk [[Email templates/nl|e-mail sjabloon]]''': gebruikt om de ''eigen''  sjablonen voor de uitnodiging, herinneringen en registratie e-mails te beheren.
*'''Verstuur e-mail uitnodiging''': Alle deelnemers aan de enquête, die nog geen uitnodiging hebben gehad, krijgen een uitnodiging per e-mail.
*'''Verstuur e-mail herinnering''': Alle gewenste deelnemers die de enquête nog niet hebben voltooid, maar al wel een eerste uitnodiging hebben gekregen, krijgen een herinnering per e-mail.
*'''Toegangscodes aanmaken''': Elke deelnemer in de toegangscodetabel krijgt een unieke toegangscode, als die deelnemer er nog geen heeft.
*'''Bounce instellingen''':  Deze e-mail instellingen kunnen op enquête niveau of op systeem niveau worden gezet. (Toegevoegd in versie 1.91).
*'''Verwijder toegangscodetabel''': verwijderd de toegangscodetabel, de enquête wordt openbaar.


=Wijzigen/toevoegen toegangscode=
Het onderstaande scherm wordt getoond:


Je krijgt ongeveer het onderstaande scherm:


<center>[[File:token_editing2.png]]</center>
<center>[[File:token_editing2.png]]</center>
*'''Voornaam''' en '''Achternaam''': van de deelnemer (kan gebruikt worden in e-mails en enquête)
*'''E-mail''': e-mailadres van deelnemer
*'''E-mail status''': Gebruikt voor blokkeren foute e-mailadressen. Als de beheerder een bounce ontvangt van een naar deze deelnemer gestuurde e-mail, dan kan de status gewijzigd worden in iets ongelijk 'OK' (bijvoorbeeld: 'gebruiker onbekend' of 'mailbox vol'). Door iets anders dan 'OK' hier in te zetten, wordt deze deelnemer overgeslagen bij het sturen van herinneringen en uitnodigingen. NB. dit is dus een handmatig actie, behalve als je een script hebt gemaakt die dit doet.
*'''Toegangscodes''': de uitnodigingscode, aangemaakt bij het genereren van de toegangscodes.
*'''Taal''': je kunt de standaardtaal per deelnemer instellen.
*'''Uitnodiging verzonden?''': standaard een 'N', anders de datum waarop de uitnodiging is verzonden.
*'''Herinnering verzonden?''': standaard een N, anders de datum waarop de herinnering is verzonden.
*'''Voltooid?''': standaard een 'N', anders de datum waarop de enquête is ingezonden (niet anoniem) of 'Y' (anoniem)
*'''Resterend aantal pogingen''': Aantal keren dat de toegangscode nog gebruikt kan worden. ''NB.:'' Als je dit verhoogd na het afronden van de eerste keer invullen door de deelnemer, dan moet je ook "Voltooid?" op "N"zetten. (standaard 1).
*'''Geldig van''' & '''tot''' : Je kunt de periode dat de toegangscode gebruikt mag worden beperken tot deze periode. Laat deze velden leeg, als je de deelnemers niet in de periode dat ze de enquête inzenden wilt beperken. NB.: Als de periode eindigt terwijl de deelnemer bezig is met invullen, dan is het verder invullen niet meer mogelijk.
*'''Attribuut1 tot Attribuut x''': Optionele velden die door de beheerder van de enquête zijn toegevoegd (zie een volgende paragraaf).


=Dummy toegangscodes=


Dummy toegangscodes zijn toegevoegd in versie 1.91. Het scherm is ongeveer als volgt:
*'''ID:''' Een nummer dat automatisch wordt toegekend aan elke deelnemer.
*'''Voltooid?''': Standaard uitgeschakeld. Indien ingeschakeld bevat het het tijdstip van afronding van het invullen door de deelnemer.
*'''Voornaam'''
*'''Achternaam'''
*'''Toegangscode:''' Dit is het token. Het kan handmatig zijn toegekend of zijn gegenereerd.
*'''Taal:''' De standaardtaal van de enquête voor deze deelnemer.
*'''E-mail:''' het e-mailadres.
*'''E-mail status:''' Indicatie van het e-mailadres. Standaard ''OK''. Maar de enquête-beheerder kan het aanpassen als er notificaties komen bij het e-mailen, bijvoorbeeld onbekend, of mailbox vol. Bij een andere waarde dan ''OK'' wordt er geen uitnodiging of herinnering verzonden naar deze deelnemer. Als je de status niet door een script laat wijzigen dan is dit handwerk,
*'''Uitnodiging verzonden?:''' Indien ingeschakeld de datum waarop de uitnodiging is verzonden.
*'''Herinnering verzonden?:''' Indien ingeschakeld de datum waarop de herinnering is verzonden.
*'''Resterend aantal pogingen:''' Hoe vaak kan de toegangscode nog worden gebruikt. Standaard 1. ''NB:'' Als je dit veld pas ophoogt na het afronden moet je ook '''Voltooid''' op "Nee" zetten.
*'''Geldig van:''' & '''tot:''' Je kunt de geldigheid van de toegangscode beperken. Standaard zijn deze velden leeg en is er dus geen beperking op deelnemersniveau.
 
Let op, het paneel '''Deelnemer toevoegen''' heeft twee tabs: de tab '''Algemeen''' en de tab '''Additionele attributen'''. De laatste tab is voor de aangepaste [[Survey participants/nl#Attributen beheren|attributen]].
 
 
===Dummy deelnemers toevoegen===
 
 
Je kunt een dummy deelnemer gebruiken als je geen e-mail met de toegangscode wilt e-mailen maar de toegangscode op een andere manier verstrekt. Bijvoorbeeld als je studenten een formulier geeft met de toegangscode erop omdat je denkt op die manier meer reacties te krijgen.
 
Na het klikken op de knop krijg je de volgende pagina te zien:
 
 
 
<center>[[File:Survey participants - create a dummy participant.png]]</center>
 


<center>[[File:dummyToken.png]]</center>
Bij '''Aantal deelnemers:''' kun je het aantal gewenste dummy deelnemers invullen. De uitleg van de andere velden staat [[Survey participants/nl#Deelnemer toevoegen|hier]].
*'''Aantal toegangscodes''':  Aantal toe te voegen dummy toegangscodes (standaard 100).
*'''Lengte toegangscode''': Aantal tekens van de toegangscode. Standaard 15
*'''Voornaam en achternaam'''
*'''E-mail'''
*'''Taal'''
*'''Resterend aantal pogingen'''
*'''Geldig van''' & '''tot'''
*'''Attribuut1 tot Attribuut x'''


NB. alle dummy toegangscodes hebben dezelfde voornaam, achternaam, e-mailadres en taal.
Klik na het invullen op de knop '''Opslaan''' rechtsboven.


=Bounce Instellingen=


Lees ([[Email bounce tracking system/nl|deze pagina voor meer informatie]]) voor het instellen van deze functie.
Bekijk daarna de deelnemerstabel opnieuw om te zien of de dummy deelnemers zijn toegevoegd.


[[File:surveyBounseSettings.png]]
*'''Enquête bounce e-mail''':  Een geldig e-mailadres voor niet afgeleverde e-mail. Voor de snelheid van verwerken is het handig als dit e-mailadres alleen gebruikt wordt voor dit doel.
*'''Te gebruiken bounce instellingen''': Opties:  1- Geen (standaard), 2- Gebruik onderstaande instellingen (instellingen op enquête niveau), 3- Gebruik algemene instellingen (systeem niveau).
*'''Server type''': Opties: 1- Uit, 2- IMAP, 3- POP
*'''Server naam en poort''':  Host naam en poort.   Voorbeeld:  mail.example.net:25 of imap.gmail.com:995
*'''Gebruikersnaam''':  Gebruikersnaam of User ID van het e-mail account
*'''Wachtwoord''':  van het e-mail account
*'''Encryptie type''': opties:  1- Geen (standaard), 2- SSL, 3- TLS


=Extra attributen=
<center>[[File:Dummy variables - simple example.png]]</center>


Je kunt attributen toevoegen aan de toegangscodetabel om extra gegevens per deelnemer vast te leggen. Klik op de knop '''Beheer extra attributen''' in de tokens toolbar. Standaard hebben deze velden een lengte van 255 tekens. Je kunt een extra veld  ook een beschrijving geven, dat is gemakkelijker als je tokens gaat beheren / bekijken, of bij het toevoegen van [[Setting conditions/nl|condities]] op grond van deze attributen, of wanneer je resultaten van niet anonieme enquêtes gaat exporteren.
===Deelnemers uit een CSV-bestand importeren===


Een beschrijving hoe je extra attributen toevoegt en daarop condities kunt gebruiken, staat hier: [http://www.limesurvey-consulting.com/limesurvey-conditions-based-on-token-attributes/ Conditions based on token attributes].


=Gebruik overzicht en wijzigen tokens=
Met de functie importeren kun je informatie importeren uit een [[Survey participants/nl#Deelnemers uit een CSV-bestand importeren|CSV-bestand]] en uit een [[Survey participants/nl#Deelnemers uit een LDAP-query importeren|LDAP-query]].


Het overzicht toont alle toegangscodes in een lijstvorm. Er zijn een aantal knoppen met een 'actie' die op een specifieke toegangscode kan worden uitgevoerd.


De bovenste regel heeft drie onderdelen: bladeren, zoeken en selectie (aantal tonen en beginpunt).
<center>[[File:survey participants - import csv.png]]</center>


De volgende regel (zie onderstaand plaatje) geeft verschillende criteria om de tokens te sorteren. Je kunt op een groene pijl klikken om op het bijbehorende veld te sorteren.


Bij "Bewerking" staan de specifieke acties die op elke toegangscode uitgevoerd kan worden:
*'''Kies het te uploaden CSV-bestand:''' Het wordt aanbevolen om een standaard CSV-bestand (kommagescheiden) te gebruiken om fouten te vermijden. In OpenOffice en Excel wordt er optioneel dubbele aanhalingstekens gebruikt om de velden.


[[File:token-actions.png]]
'''De eerste regel moet de veldnamen bevatten'''. Het <u>moet</u> de velden : ''voornaam, achternaam en e-mailadres'' bevatten.  
*Invullen van de enquête
*Wijzigen
*verwijderen
*Verstuur een uitnodiging/herinnering
*Bij een niet anonieme enquête is er ook een knop om de respons te bekijken.
Alle acties zijn dus voor een specifieke toegangscode.


=Importeren/exporteren=
Deze velden velden moet minstens een teken bevatten. Alleen dubbele aanhalingstekens werkt dus niet!


==CSV importeren==
De andere velden (e-mailstatus, toegangscode, taal, ...) zijn optioneel.


Als je op het icoon importeren klikt, dan krijg je het volgende scherm:


[[File:uploadtoken.jpg]]
{{Hint|Text=Om een volledige lijst met veldnamen te krijgen, kun je een [[Survey participants/nl#Exporteren|bestaande tdeelnemerstabel exporteren]].}}


In je [http://nl.wikipedia.org/wiki/Kommagescheiden_bestand  CSV-bestand] geeft de eerste regel de veldnamen weer. Mogelijke velden zijn:
{{Hint|Text=Het datumformaat voor de geldigheid in het invoerbestand is "YYYY-MM-DD HH:MM".}}


    voornaam,achternaam,e-mailadres,e-mail status,token,taalcode,tid,attribuut_1,attribuut_2, attribute_...
*'''Karakterset van het bestand:''' Kies de optie van de karakterset van het CSV-bestand.
*'''Gebruikt scheidingsteken:''' Selecteer de komma of de puntkomma of laat het door LimeSurvey bepalen.
*'''Filter lege e-mailadressen:''' Indien ingeschakeld worden  deelnemers zonder e-mailadres overgeslagen bij het importeren.
*'''Sta ongeldige e-mailadressen toe:''' Indien uitgeschakeld worden een ingevuld e-mailadres gecontroleerd op structuur  (bijv..: a@a.net);
*'''Tonen attribuutwaarschuwingen:''' Indien ingeschakeld wordt er na het importeren waarschuwing(en) getoond bij foute invoer. Dit kan o.a. zijn als er een verplicht veld ontbreekt.


Om een volledige lijst met veldnamen te krijgen, kun je een bestaande toegangscodetabel exporteren.
*'''Filter dubbele records:''' Als je de optie om dubbele deelnemers te filteren aanzet, dan kun je ook bepalen hoe zo een duplicaat wordt bepaald. Standaard :  voornaam, achternaam, e-mailadres. Een duplicaat wordt bij het importeren overgeslagen.


De volgorde van de velden kan verschillen, maar ''voornaam, achternaam en e-mailadres zijn verplicht'', en moeten minstens 1 teken bevatten. Als je bij het importeren ook gegevens voor nieuwe extra attributen hebt, zorg er dan eerst voor je die extra attributen toevoegt als veld in de tabel voordat je gaat importeren.
*'''Iets is dubbel als:''' Selecteer de velden waarop volgens jou moet worden gefilterd om dubbele records te vorkomen.


Een minimaal CSV bestand zou er zo uit kunnen zien:


    voornaam,achternaam,e-mailadres
Je kunt ook aangepaste attributen toevoegen bij het importeren van het csv-bestand. Je moet ze dan wel gedefinieerd hebben. Dat gaat als volgt:
    Pietje,Puk,pietje@puk.nl


'''Datumformaat bij importeren'''


Het datumformaat voor de begin geldigheid en de eind geldigheid in het invoerbestand is "YYYY-MM-DD HH:MM", voorbeeld:
    <code>e-mail, attribuut_1 <Casenr>, token, attribuut_2 <Title,; attribuut_3 <destination>, achternaam, voornaam, attribuut_4 <Sender></code>


    2012-01-01 00:00


--betekent 1 januari 2012 12:00 VM.
Klik, als je klaar met het instellen, op de knop '''Upload'''.


'''Filteren dubbele deelnemers'''


Als je de optie om dubbele deelnemers te filteren aanzet, dan kun je ook bepalen hoe zo een duplicaat wordt bepaald. Standaard :  voornaam, achternaam, e-mailadres. Een duplicaat wordt bij het importeren overgeslagen.
====Probleemoplossing====


'''Probleemoplossing'''


Een vaak voorkomende fout bij het importeren van toegangscodes is een ongeldig CSV-bestand. Dit kan komen als je in Excel een lijst van e-mailadressen opslaat als XLS-bestand. Excel kan een bestand opslaan als CSV, maar gebruikt dan een puntkomma (dit is een instelling van het besturingssysteem per land) als scheidingsteken. Standaard is dit in CSV een komma. Als je het niet weet, controleer het scheidingsteken dan door het bestand met een standaard editor te openen. Je kunt bij het importeren (vanaf versie 2.00) het scheidingsteken kiezen.
Een vaak voorkomende fout bij het importeren van toegangscodes is een ongeldig CSV-bestand. Dit kan komen als je in Excel een lijst van e-mailadressen opslaat als XLS-bestand. Excel kan een bestand opslaan als CSV, maar gebruikt dan een puntkomma (dit is een instelling van het besturingssysteem per land) als scheidingsteken. Standaard is dit in CSV een komma. Als je het niet weet, controleer het scheidingsteken dan door het bestand met een standaardeditor te openen.  


Als u het invoerbestand eerst nog wil bewerken, dan kunt een zogenaamde free raw text editor gebruiken, bijvoorbeeld: [http://www.pspad.com/ PSPad], [http://www.flos-freeware.ch/notepad2.html NotePad2] of [http://notepad-plus-plus.org/ Notepad++] voor Windows, en [http://www.barebones.com/products/textwrangler/ TextWrangler] voor Macintosh.
Als u het invoerbestand eerst nog wil bewerken, dan kunt een zogenaamde free raw text editor gebruiken, bijvoorbeeld: [http://www.pspad.com/ PSPad], [http://www.flos-freeware.ch/notepad2.html NotePad2] of [http://notepad-plus-plus.org/ Notepad++] voor Windows, en [http://www.barebones.com/products/textwrangler/ TextWrangler] voor Macintosh.


U kunt ook  [http://www.libreoffice.org/features/calc/ LibreOffice Calc] gebruiken voor het importeren/exporteren van bestanden in de formaten XLS en CSV.


'''Extra attributen toevoegen bij importeren'''
{{Box|LimeSurvey zou puntkomma's moeten herkennen als scheidingsteken. Als het importeren mislukt probeer dan of je de komma als scheidingsteken kunt gebruiken. We bevelen aan om dubbele aanhalingstekens te gebruiken rond de waarden in het bestand.}}
Je kunt ook nieuwe aangepaste attributen toevoegen bij het importeren van het csv-bestand. Je moet ze dan wel gedefinieerd hebben. Dat gaat als volgt:
 
    <code>e-mail, attribuut_1 <Casenr>; token; attribuut_2 <Title>; attribuut_3 <destination>, achternaam; voornaam; attribuut_4 <Sender></code>
===Deelnemers uit een LDAP-query importeren===
 
{{Alert|title=Attentie|text=Gebruik deze optie alleen als je verstand hebt van LDAP-queries.}}
 
Met deze functie kun je informatie importeren uit een LDAP-query (getest op '''openLdap''', maar het zou moeten werken op elke LDAP conforme omgeving inclusief '''ActiveDirectory'''). De opties zijn:
 


==Aanmaken CSV bestand met Excel op de Mac==
<center>[[File:Import survey participants from LDAP.png]]</center>


Als je op de MAC een csv-bestand aanmaakt met Excel 2011 en de standaard "opslaan als" optie gebruikt verlies je de letters met trema's e.d. bij het importeren in LimeSurvey.
* Een query wordt handmatig door de beheerder gedefinieerd in het bestand config-ldap.php.
* Duplicaten worden bepaald op voornaam, achternaam en e-mailadres. Als je het "Filter dubbele records" aangevinkt hebt gelaten wordt elk dubbel record overgeslagen bij het importeren.


Kies er daarom voor om het bestand op te slaan als Windows tekst CSV bestand (getest op de Nederlandse Excel versie, opgeslagen als  "Door lijstscheidingstekens gescheiden Windows tekst (.CSV)").
{{Note|Meer informatie over [[LDAP settings/nl|LDAP]].}}


Kies vervolgens, bij het importeren in LimeSurvey, bij "Karakter set van het bestand" voor "Mac West Europees". De speciale tekens zouden dan goed moeten geïmporteerd.
==Attributen beheren==


Alleen getest voor LimeSurvey 2.0.
Met deze optie kun je additionele velden toevoegen/wijzigen in de deelnemerstabel. Je kunt dus zelf gegevens toevoegen:


==CSV exporteren==


Als je tokens exporteert dan is de volgorde van de velden:
<center>[[File:Survey participants - Add attributes.png]]</center>


    tid,voornaam,achternaam,e-mailadres,e-mail status,token,taalcode,attribuut_1,attribuut_2,...


==LDAP importeren==
Vul het aantal velden in dat je per deelnemer wilt toevoegen. Na het klikken op de knop '''Voeg toe''' krijg je het volgende scherm:


[[File:token-Ldap-import.png]]
* Een query wordt handmatig door de beheerder gedefinieerd in het bestand config-ldap.php.
* Duplicaten worden bepaald op voornaam, achternaam en e-mailadres. Als je het "Filter dubbele records" aangevinkt hebt gelaten, dan wordt elk dubbel record overgeslagen bij het importeren.


==TIP: veel nep e-mailadressen aanmaken==
<center>[[File:token_manage.png]]</center>
 
 
De tabel met attribuutvelden heeft de volgende velden:
*'''Attribuutveld:''' de waarde waarmee je wilt werken bij [[Setting conditions/nl|condities]] en bij het exporteren voor niet-anonieme enquêtes.
*'''Veldbeschrijving:''' Vervangt in overzichten het '''attribuutveld'''. Dus een veld puur voor de leesbaarheid.
*'''Verplicht?:''' Indien ingeschakeld, bij het registreren van een deelnemer moet het veld worden ingevuld.
*'''Tonen tijdens registratie?:''' Als de deelnemers zich moeten aanmelden dan kun je hiermee aangeven of ze dit veld ook moeten invullen. Indien uitgeschakeld wordt dit veld niet getoond bij het aanmelden.
*'''Veld tekst:''' Een toelichting over het doel/gebruik van dit veld.
*'''CPDB-koppeling:''' Koppelt het veld met een veld in de centrale deelnemersdatabase.
*'''Voorbeeld gegevens:''' Een tekst met welke gegevens je verwacht. Bij een vraag naar geslacht bijvoorbeeld: man, vrouw, gender, geen antwoord.
 
 
Klik na het invullen van de gegevens op de knop '''Bewaar''', linksonder in het scherm.
 
<div class="simplebox">[[File:help.png]] Een beschrijving hoe je extra attributen toevoegt en daarop condities kunt gebruiken, staat  [http://www.limesurvey-consulting.com/limesurvey-conditions-based-on-token-attributes/ hier].</div>
 
Onderaan het scherm staat een optie om meer velden toe te voegen. Vul dan het veld '''Aantal toe te voegen attribuutvelden''' in en klik op de knop '''Voeg toe'''.
 
Onderaan het scherm kun je ook een eigen attribuut verwijderen, selecteer het dan wel eerst. Je moet het verwijderen ook bevestigen.
 
==Exporteren==


Soms heb je een aantal nep  e-mailadressen met tokens nodig. Je kunt in een programma als Calc of Excel functies gebruiken om ze aan te maken. Stel je wilt 1000 e-mailadressen aanmaken op het werkblad : 1@test.com, 2@test.com, 3@test.com... Zet dan de oplopende nummers in de kolom A: 1 in the A1, voeg de functie =A1+1 in A2 toe, en kopieer A2 naar beneden, zo ver als je nodig hebt. In B1 gebruik je de functie om A1 en "@test.com" samen te voegen, =CONCATENATE(A1;"@test.com") of =TEKST.SAMENVOEGEN(A1;"@test.nl"). Kopieer vervolgens B1 naar beneden, net zo ver als je dat bij A hebt gedaan. Je kunt de namen op dezelfde manier maken. Sla vervolgens je werk op als CSV-bestand.


Vanaf versie 1.91 kun je dummy toegangscodes genereren.
Als je een deelnemerstabel wilt exporteren klik dan op de knop ''Exporteer gegevens'' in de taakbalk van het beheer van de toegangscodes. Selecteer voor het daadwerkelijk exporteren dan eerst de gewenste opties.


==TIP: Veel persoonlijke links met het token aanmaken==


De structuur van de enquête link is:
<center>[[File:Survey participants - export.png]]</center>


Limesurvey 2.x: http://url-to-your-limesurvey-installation/index.php/survey/index/sid/xxxx/newtest/Y/lang/EN/token/{TOKEN}


Dit gaat eigenlijk hetzelfde als het bovenstaande voorbeeld met de e-mailadressen.
*'''Enquête status:'''
*Eerste kolom: http://url-to-your-limesurvey-installation/index.php?sid=XXXX&lang;=nl&token;= (bij versie 1.x) OF http://url-to-your-limesurvey-installation/index.php/survey/index/sid/xxxx/newtest/Y/lang/EN/token/ (bij versie 2.x) (dezelfde URL allemaal gelijk, als de taal hetzelfde is!)
**''Alle toegangscodes:'' Alle deelnemers in de deelnemerstabel van de enquête.
*Tweede kolom: {TOKEN} (zet hier je tokens neer, natuurlijk zijn deze uniek)
**''Voltooid:'' Alleen deelnemers die de enquête afgerond hebben.
*Derde kolom: gebruik weer de functie voor het samenvoegen.
**''Niet volledig:'' Alleen deelnemers die de enquête nog niet afgerond hebben.
**''Niet begonnen:'' Alleen deelnemers die de enquête nog niet begonnen zijn.
**''Begonnen maar nog niet afgerond''.  
*'''Status uitnodiging:''' ''Alle'', ''Uitgenodigd'' en ''Niet uitgenodigd''.
*'''Status herinnering:''' ''Alle'', ''Herinnering(en) verzonden'', ''Geen herinnering verzonden''.
*'''Filter op taal:''' Als je de enquête in meerdere talen aanbied kun je hier de deelnemers filteren op taal.
*'''Filter op e-mailadres:''' Je kunt de deelnemers filteren op een deel van het e-mailadres, als daar bijvoorbeeld een bedrijfsnaam of een provider inzit. Tik bijvoorbeeld in ''@ziggo.nl''.
*'''Geëxporteerde deelnemers verwijderen:''' Je kunt bij het exporteren deze deelnemers verwijderen uit je deelnemerstabel.


=E-mail versturen=
Klik na het invullen van de gegevens op de knop '''CSV-bestand downloaden''', rechtsboven in het scherm


==E-mail placeholders==
<div class="simplebox">Als je tokens exporteert dan is de volgorde van de velden: <code>tid,voorname,achternaam,e-mailadres,e-mailstatus,token,taalcode,attribuut_1,attribuut_2,...</code></div>


De volgende velden kunnen in een uitnodiging/herinnering  [[Email templates/nl|e-mail sjabloon]] worden gebruikt en moeten worden gevuld bij de enquête eigenschappen. Bij het versturen worden de velden al bij het voorvertonen vervangen door de voor die e-mail geldende waarden.
==Uitnodigingen en herinneringen==


{|
Hier kun je uitnodigingen of herinneringen versturen naar de deelnemers die in de [[Survey participants/nl#Deelnemers tonen|deelnemerstabel]] staan. Het onderdeel [[Email bounce tracking system/nl|e-mail bounce tracking]] zorgt voor de registratie van niet verzonden e-mails naar de ontvangers / deelnemers.
|{ADMINEMAIL}||E-mailadres van de beheerder van de enquête
|-
|{ADMINNAME}||Naam van de beheerder van de enquête
|-
|{SURVEYNAME}||Titel van de enquête
|-
|{SURVEYDESCRIPTION}||Beschrijving van de enquête
|}


De volgende veldnamen mogen in de uitnodiging/herinnering e-mails (onderwerp/body) gebruikt worden en worden vervangen door de waarden bij het versturen van de e-mails:


{|
===Uitnodiging e-mailen===
|{EMAIL}||E-mailadres van de ontvanger
|-
|{FIRSTNAME}||Voornaam
|-
|{LASTNAME}||Achternaam
|-
|{SURVEYURL}||De URL om de enquête te kunnen invullen. Bij een HTML e-mail is dit een link.
|-
|@@SURVEYURL@@||De URL om de enquête te kunnen invullen. Je kunt deze URL (barebone link) gebruiken bij integratie in uw aangepaste  HTML. (beschikbaar vanaf versie v1.90)
|-
|{OPTOUTURL}||De URL om je als ontvanger af te melden voor e-mail behorend bij deze enquête. (Dit is een link.)
|-
|{TOKEN}||De toegangscode.
|-
|{ATTRIBUTE_1}||Attribuut 1
|-
|{ATTRIBUTE_2}||Attribuut 2 (...en dat herhalen voor elk extra attribuut)
|}


Bij een niet anonieme enquête zijn de volgende velden beschikbaar voor het toevoegen van gegevens in de tekst van de enquête en in de JavaScript. Je kunt deze velden ook gebruiken in sjabonen voor een bevestiging of een notificatie.


{|
Je kunt met deze optie in een keer een e-mail versturen naar deelnemers aan de enquête die nog geen uitnodiging ontvangen hebben.
|{TOKEN:EMAIL}||E-mail van de ontvanger
|-
|{TOKEN:FIRSTNAME}||Voornaam
|-
|{TOKEN:LASTNAME}||Achternaam
|-
|{TOKEN}||Toegangscode
|-
|{TOKEN:ATTRIBUTE_1}||Attribuut 1
|-
|{TOKEN:ATTRIBUTE_2}||Attribuut 2 (...en dat herhalen voor elk extra attribuut)
|}


===Aanvullende tips===
*Als je enquête anonieme responses gebruikt dan zullen toegangscode-gerelateerde placeholders niet werken in een notificatie sjabloon.
*Je kunt [[Expression Manager/nl|Expressie Beheer]] gebruiken om met expressies maatwerk te krijgen voor een e-mail {{NewIn/nl|1.92}}. Een voorbeeld [[Expression Manager HowTos|hoe gebruik je Expressie Beheer]].
Een ander voorbeeld van gebruik van [[Adding a question/nl#Informatie van tokens tabel|informatie van toegangscodes]].


==E-mails instellingen==
#'''Uitnodiging e-mail onderwerp''': De tekst voor het onderwerp in de e-mail met de uitnodiging indien er tokens gebruikt worden.
#'''Uitnodiging e-mail''': De tekst zelf van de uitnodiging indien er tokens gebruikt worden. Deze wordt initieel gevuld met de standaard tekst voor een uitnodiging (uit de taalbestanden) maar je kunt de tekst aanpassen. Je kunt de volgende velden in je tekst gebruiken om de e-mail een persoonlijk tintje te geven:
**'''{FIRSTNAME}''' - hier komt dan de voornaam te staan
**'''{LASTNAME}''' - de achternaam
**'''{SURVEYNAME}''' - de naam van de enquête
**'''{SURVEYDESCRIPTION}''' - de beschrijving van de enquête
**'''{ATTRIBUTE_1}''' - de waarde van attribuut_1
**'''{ATTRIBUTE_2}''' - de waarde van attribuut_2" (...en dat herhalen voor elk extra attribuut)
**'''{SURVEYURL}''' - de volledige URL om deze enquête in te vullen - in HTML e-mails is dit een link
**'''@@SURVEYURL@@''' - de URL om de enquête te kunnen invullen. Je kunt deze URL (barebone link) gebruiken bij integratie in uw aangepaste HTML. (beschikbaar vanaf versie v1.90)
**'''{OPTOUTURL}''' - de URL om je als ontvanger af te melden voor e-mail behorend bij deze enquête.


Deze velden kunnen in de volgende e-mail velden gebruikt worden, als er tokens gebruikt worden.
<center>[[File:token-invite.png]]</center>
#'''Onderwerp herinnering''': de tekst voor het onderwerp in de e-mail.
#'''E-mail herinnering''': de tekst zelf. Kijk bij de uitnodiging hoe dit veld gebruikt wordt.
#'''Onderwerp bevestiging''': de tekst voor het onderwerp in de bevestiging die deelnemers krijgen als de enquête ingezonden.
#'''E-mail bevestiging email''': de tekst zelf. Als je dit veld leeg laat, dan wordt er geen e-mail bevestiging verstuurd.
#'''Onderwerp openbare registratie''': de tekst voor het onderwerp in de uitnodiging die verstuurd wordt als iemand zich aanmeld om de enquête in te vullen.
#'''E-mail openbare registratie''': de tekst zelf.


==Versturen e-mails==


===Verstuur uitnodigingen===
Je kunt deelnemers overslaan als de e-mailstatus ongelijk 'OK' is, door de optie 'Overslaan ongeldige e-mailadressen' in te schakelen.


[[File:token-invite.png]]
Als je de [[Survey_participants/nl#Deelnemer toevoegen|controle]] wilt uitschakelen, schakel dan de optie '''Bij versturen e-mail de datumcontrole overslaan''' in. Er wordt dan niet gecontroleerd of de code op dat moment gebruikt mag worden.  


Je kunt tokens overslaan als de e-mailstatus ongelijk 'OK' is, door bij de optie 'Overslaan verkeerde e-mailadressen' te kiezen voor 'Ja'.


====Opnieuw versturen uitnodigingen====
====Opnieuw versturen uitnodigingen====


Soms wil je aan bepaalde personen de uitnodigingen opnieuw versturen. Als je de functie '''verstuur uitnodiging''' gebruikt krijgen alleen deelnemers die nog niet eerder een uitnodiging hebben gekregen, een uitnodiging. Je kunt dus je e-mails verspreid versturen als je nog niet alle deelnemers compleet hebt.


Je kunt dus ook als er een e-mail niet afgeleverd kan worden (bounce), het bijbehorende token opzoeken en het e-mailadres wijzigen en dan de functie opnieuw kiezen. Dan krijgt immers alleen deze deelnemer de e-mail. Pas wel eerst de datum in '''Uitnodiging verzonden?''' aan in een  '''N'''.
Soms wil je aan bepaalde personen/deelnemers de uitnodigingen opnieuw versturen. Als je de functie '''verzend uitnodiging''' gebruikt krijgen alleen deelnemers die nog niet eerder een uitnodiging hebben gekregen, een uitnodiging. Je kunt dus je e-mails verspreid versturen als je nog niet alle deelnemers compleet hebt.
 
Je kunt dus ook als er een e-mail niet afgeleverd kan worden (bounce), het bijbehorende token opzoeken, het e-mailadres wijzigen en dan de functie opnieuw kiezen. Dan krijgt immers alleen deze deelnemer de e-mail. Schakel wel het veld '''Uitnodiging verzonden''' uit.
 
===Herinnering versturen===


====Afmelden door deelnemer====
Hiermee kun je in één keer een e-mail versturen naar alle deelnemers die de enquête nog niet ingevuld hebben maar al wel de uitnodiging hebben gekregen.


Als je de code {OPTOUTURL} gebruikt in je uitnodiging/herinnering, dan kan een deelnemer zich afmelden voor verdere e-mails over deze enquête. Het wordt aanbevolen om de code te gebruiken. De deelnemer kan door op een link te klikken zich afmelden. De e-mailstatus van het token wordt dan 'OptOut'.


===Versturen herinneringen===
<center>[[File:token-remind.png]]</center>


[[File:token-remind.png]]


Bij het versturen van herinneringen kun je:
Bij het versturen van herinneringen kun je:
* tokens overslaan die een verkeerd e-mailadres hebben
* Tokens overslaan van deelnemers die een ongeldig e-mailadres hebben
* tokens overslaan waarvoor recent al een e-mail is verstuurd
* Tokens overslaan van deelnemers die minder dan een bepaald aantal dagen geleden een herinnering hebben ontvangen
* tokens overslaan waarvoor al een bepaald aantal e-mails is verstuurd
* Tokens overslaan van deelnemers die al het maximaal aantal herinneringen hebben ontvangen
* Tokens overslaan van deelnemers die de enquête op dat moment niet kunnen invullen vanwege een beperking van de geldigheid


NB. Een herinnering wordt alleen verstuurd naar deelnemers die de enquête nog niet afgerond hebben  ("Voltooid?" is ongelijk "N").
<div class="simplebox">[[File:help.png]] NB. Een herinnering wordt alleen verstuurd naar deelnemers die de enquête nog niet afgerond hebben  ("Voltooid?" is ongelijk "N").</div>


===Versturen e-mails in een batch===


Als het aantal te versturen e-mails groot is, dan zal LimeSurvey in een eerste batch het aantal van N e-mails versturen. Dit aantal (threshold) is bepaald door de beheerder in de instellingen met de "E-mail batch grootte".
====Versturen e-mails in een batch====


Je moet dan een aantal keren op "Volgende" klikken om een volgende batch te versturen totdat alle e-mails verstuurd zijn.
Als het aantal te versturen e-mails groot is, dan zal LimeSurvey in een eerste batch het aantal van N e-mails versturen. Dit aantal (threshold) is bepaald door de beheerder in de instellingen met de [[Global settings/nl#E-mail instellingen|E-mail batchgrootte]].


===Versturen bevestiging===
===Versturen bevestiging===


Als de deelnemer een enquête afgerond heeft en er worden tokens gebruikt, dan wordt er een bevestiging verstuurd naar zijn/haar e-mailadres.
Als de deelnemer een enquête afgerond heeft en er worden tokens gebruikt, dan wordt er een bevestiging verstuurd naar zijn/haar e-mailadres.


Als je niet wil dat dit bericht wordt gestuurd, schakel dit dan uit in de instellingen van de enquête.
Als je niet wil dat dit bericht wordt gestuurd, schakel dit dan uit in de [[Participant settings/nl|instellingen van de enquête]].
 
==Bounce verwerking starten==
 
Als er een e-mail verstuurd wordt, dan worden er automatisch identificaties van de enquête en het token toegevoegd aan de header van de e-mail die verstuurd wordt naar de deelnemers. Als er een e-mail niet afgeleverd kan worden (bounce) dan worden deze gegevens weer terug ontvangen. LimeSurvey herkent dan in de nieuwe berichten deze bounces  en markeert in de deelnemerstabel van de enquête bij deze deelnemer het e-mailadres als foutief.
 
 
===Bounce instellingen===
 
 
De beschikbare opties:
 
 
<center>[[File:surveyBounseSettings.png]]</center>
 
 
In de [[Global settings/nl#Bounce instellingen|algemene instellingen]] staat een korte beschrijving van deze velden. Als je de globale instellingen van LimeSurvey wilt gebruiken ga dan naar de '''Bounce-instellingen''' en selecteer de betreffende optie.
 
{{Note|Een uitgebreidere beschrijving van het [[Email bounce tracking system/nl|verwerken van bounces]].}}
 
Lees [[Email bounce tracking system/nl#Installatie|dit]] voor het juist instellen van deze functie.
 
==E-mail sjablonen wijzigen==
 
 
Als je meer wilt weten over beschikbare placeholders en het wijzigen van sjablonen, lees dan [[Email templates/nl|deze informatie]].
 
 
==Tokens genereren==
 
 
Met deze functie kun je unieke tokens (toegangscodes) aanmaken voor alle deelnemers in de deelnemerstabel van de enquête die nog geen token hebben.
 
 
<center>[[File:Survey participants - Generate tokens.png]]</center>
 
==Tonen in deelnemersdatabase==
 
De laatste optie in de taakbalk is het '''In CPDB bekijken'''. Hiermee kan je als enquête-beheerder de deelnemers zien die zowel in je deelnemerslijst van de eigen enquête als in de centrale deelnemersdatabase voorkomen.
 
Als dit je deelnemerslijst is:
 
 
<center>[[File:Survey participants list - view in cpdb.png]]</center>
 
 
De deelnemers met ID 1 en 2 komen ook in de centrale deelnemersdatabase voor.  Dat zie je aan het laatste veld onder Actie. Om dit te controleren klik je op op '''In CPDB bekijken''' in de taakbalk.


===SPAM===


Vaak klagen gebruikers over het niet hebben ontvangen van een uitnodiging of herinnering, doordat het spam filter van de gebruiker de e-mail ziet als spam (ongewenste e-mail).
<center>[[File:View in CPDB - filters.png]]</center>
 
 
Deze functie is dus eigenlijk een filter zodat je kunt zien welke deelnemers in de centrale deelnemersdatabase meedoen aan jouw enquête.
 
=Tabel verwijderen=
 
De de eelnemerstabel van je enquête kun je verwijderen door te klikken op de knop '''Toon deelnemers''' en daarna op de knop '''Deelnemerstabel verwijderen''', die rechtsboven in het scherm staat.
 
 
<center>[[File:Delete survey participants table.png]]</center>
 
 
Je moet op een pop-up scherm het verwijderen wel even bevestigen.
 
 
<center>[[File:Confirmation - delete survey participants table.png]]</center>
 
 
De tabel wordt overigens niet fysiek verwijderd. Er wordt een back-up gemaakt van de tabel die alleen door de hoofdbeheerder benaderbaar is.
 
Als je de tabel ook fysiek wilt verwijderen, gebruik dan de optie [[Check data integrity/nl|Controle op integriteit]] in de dialoog '''Configuratie'''.
 
=Aanvullende tips=
 
De onderstaande tips en opmerkingen zijn van de gebruikers van LimeSurvey. Vul dit aan als je nog een goede tip hebt voor andere gebruikers van LimeSurvey:
*[[Survey participants/nl#Toestaan openbare registratie|Toestaan openbare registratie]]
*[[Survey participants/nl#Captcha in openbare aanmelding|Captcha in openbare aanmelding]]
*[[Survey participants/nl#Is de enquête anoniem?|Is de enquête anoniem?]]
*[[Survey participants/nl#TIP: Veel nep e-mailadressen aanmaken|TIP: Veel nep e-mailadressen aanmaken]]
*[[Survey participants/nl#Spam problemen|Spam problemen]]
*[[Survey participants/nl#Pseudo anonieme deelname|Pseudo anonieme deelname]]
 
 
==Toestaan openbare registratie==
 
Als je je enquête openbaar wilt maken maar wel controle over de deelnemers wilt houden dan kun je tokens gebruiken. Je moet dan bij de instelling van de enquête  kiezen voor [[Participant settings/nl|Openbare aanmelding toestaan]]. Dit kun je later alsnog instellen bij de instellingen van de enquête. Mensen die de enquête bezoeken zonder token, kunnen zich dan aanmelden.
 
Als een deelnemer een e-mailadres opgeeft dat nog niet in de huidige database staat, wordt er een vermelding in de tabel met deelnemers aan de enquête aangemaakt en ontvangt hij/zij een uitnodiging per e-mail met daarin zijn unieke tokencode.
 
==Captcha in openbare aanmelding==
 
Om je enquête te beschermen tegen registratie door robots kun je de captcha functie gebruiken op alle registratie, bewaar en laad schermen. Meer [[Participant settings/nl|informatie]].
 
==Is de enquête anoniem?==
 
Ja, je kunt ook met het gebruik van toegangscodes de enquête anoniem houden. Je bepaalt bij het aanmaken van de enquête of die anoniem is of niet anoniem. Als de enquête niet anoniem is worden de toegangscodes gebruikt om de respons te koppelen aan de deelnemer. Bij een anonieme enquête met toegangscodes, wordt deze link (foreign key relatie) NIET gelegd.
 
De keuze respons is wel/niet anoniem, maak je [[Participant settings/nl|hier]].
 
==TIP: Veel nep e-mailadressen aanmaken==
 
Soms heb je een aantal nep  e-mailadressen met tokens nodig. Je kunt in een programma als Calc of Excel functies gebruiken om ze aan te maken. Stel je wilt 1000 e-mailadressen aanmaken op het werkblad : 1@test.com, 2@test.com, 3@test.com, ... Zet dan de oplopende nummers in de kolom A: ''1'' in cel A1, voeg de functie =A1+1 in A2 toe, en kopieer A2 naar beneden, zo ver als je nodig hebt. In cal B1 gebruik je de functie om cel A1 en "@test.com" samen te voegen, =CONCATENATE(A1;"@test.com") of =TEKST.SAMENVOEGEN(A1;"@test.nl"). Kopieer vervolgens B1 naar beneden, net zo ver als je dat bij A hebt gedaan. Je kunt de namen op dezelfde manier maken. Sla vervolgens je werk op als een CSV-bestand en importeer het daarna in LimeSurvey.
 
Vanaf versie 1.91 kun je dummy toegangscodes genereren. Deze bevatten echter geen e-mailadres.
 
 
==Spam problemen==
 
Vaak klagen gebruikers over het niet hebben ontvangen van een uitnodiging of herinnering, doordat het spamfilter van de gebruiker de e-mail ziet als spam (ongewenste e-mail).


Waarom een spam filter een e-mail als spam ziet, is afhankelijk van de instellingen van het filter. Het filter bekijkt van de e-mail het e-mailadres van de afzender, het onderwerp en de inhoud, dus je kunt er als enquête-beheerder wel wat aandoen.
Waarom een spam filter een e-mail als spam ziet, is afhankelijk van de instellingen van het filter. Het filter bekijkt van de e-mail het e-mailadres van de afzender, het onderwerp en de inhoud, dus je kunt er als enquête-beheerder wel wat aandoen.


Op limesurvey-consulting.com staan in deze [http://www.limesurvey-consulting.com/how-to-prevent-limesurvey-email-invitations-or-reminders-being-treated-as-spam/ blog] een aantal mogelijke problemen en oplossingen.
Op deze [https://www.survey-consulting.com/how-to-prevent-limesurvey-email-invitations-or-reminders-being-treated-as-spam/ blog] staan een aantal problemen en oplossingen.
 
===Verkeerd domein in e-mail link===


LimeSurvey probeert automatisch de URL voor de link in een e-mail te bepalen uit de URL waarmee je als beheerder bent ingelogd. Het kan voorkomen dat dit bij een foutieve instelling van de server niet goed werkt, je moet de URL voor de link dan handmatig instellen.
LimeSurvey probeert automatisch de URL voor de link in een e-mail te bepalen uit de URL waarmee je als beheerder bent ingelogd. Het kan voorkomen dat dit bij een foutieve instelling van de server niet goed werkt, je moet de URL voor de link dan handmatig instellen.


Wijzig in application/config/config.php de standaard base URL. Voeg de hostInfo property toe aan het bestaande array 'components'.
Wijzig in ''application/config/config.php''  de standaard base URL. Voeg de ''hostInfo property'' toe aan het bestaande array 'components'.


<syntaxhighlight lang="php" enclose="div">    'components' => array(
<syntaxhighlight lang="php">    'components' => array(
       ...
       ...
       'config' => array(
       'config' => array(
Line 347: Line 508:
</syntaxhighlight>
</syntaxhighlight>


De oorzaak van het probleem: LimeSurvey probeert het domein te bepalen uit de PHP variabelen $_SERVER<nowiki>[</nowiki>'HTTP_HOST'] en $_SERVER<nowiki>[</nowiki>'SERVER_NAME'].
<div class="simplebox">[[File:help.png]]Meer informatie over het wijzigen van het configuratie-bestand van je LimeSurvey installatie staat [[Optional settings/nl|hier]].</div>


Sommige webservers vullen deze informatie niet of op een eigen manier.
De oorzaak van het probleem, LimeSurvey probeert het domein te bepalen uit de PHP variabelen $_SERVER<nowiki>[</nowiki>'HTTP_HOST'] en $_SERVER<nowiki>[</nowiki>'SERVER_NAME'].


=Openbare registratie=
Enkele webservers vullen deze informatie niet of op een eigen manier.


==Toestaan openbare registratie==
==Pseudo anonieme deelname==  


Als je je enquête openbaar wilt maken maar wel controle over de deelnemers wilt houden dan kun je tokens gebruiken. Je moet dan bij de instelling van de enquête  kiezen voor "Openbare aanmelding toestaan". Mensen die de enquête bezoeken zonder token, kunnen zich dan aanmelden met een e-mailadres dat voor die enquête nog niet gebruikt is. Er wordt dan een token aangemaakt en ze krijgen een uitnodiging waarmee ze de enquête kunnen invullen. Alle tokens die op verzoek van deze bezoekers zijn aangemaakt krijgen een token beginnend met een "R".
Met dummy tokens maak je een soort van pseudo anonieme deelname mogelijk, je kunt ze exporteren en ze dan extern koppelen aan je deelnemerslijst. In LimeSurvey zijn dan persoonlijke gegevens van de deelnemers die deze tokens gebruiken niet bekend.  
 
==Captcha in openbare aanmelding==


Om je enquête te beschermen tegen registratie door robots kun je de captcha functie gebruiken op alle registratie, bewaar en laad schermen. (vanaf versie 1.48) Deze functie is alleen beschikbaar als GD-support geactiveerd is in je PHP configuratie. (lees de  [[Installation/nl|Installatie eisen]])
Een beperking is dat je de deelnemerscodes, de tokens, zelf moet verspreiden.

Latest revision as of 08:31, 5 December 2023

Inleiding

Deelnemers zijn mensen die je wilt uitnodigen om je enquête in te vullen. Je wilt bijhouden wie de enquête heeft ingevuld en er voor zorgen dat iedereen maar een keer de enquête kan invullen. Je kan het volgende doen:

  • Importeren van een lijst met namen en e-mailadressen van deelnemers. Invoer is een CSV bestand of een LDAP query
  • Genereren van een unieke toegangscode voor elke gewenste deelnemer
  • Een e-mail versturen naar elke gewenste deelnemer met de uitnodiging om deel te nemen (per groep of individueel).
  • Een herinnering e-mailen aan elke deelnemer die de enquête nog niet ingevuld heeft.
  • Bijhouden wie de enquête ingevuld heeft.
  • Voorkomen dat niet uitgenodigde mensen de enquête invullen, en zorgen dat de uitgenodigde deelnemers dat maar een keer doen.
  • Wijzigen details in je lijst.
  • Sjablonen aanmaken voor de e-mails (uitnodiging / herinnering)

Nadat je van je enquête een besloten enquête hebt gemaakt, (je hebt tokens ingeschakeld voor je enquête), dan kunnen alleen de mensen met een geldige toegangscode (token) die nog niet gebruikt is, de enquête invullen.

Als je Openbare aanmeldingen toestaat in de enquête instellingen, dan kunnen deelnemers zichzelf als deelnemer aanmelden, er wordt dan automatisch een token aangemaakt.

Enkele toegangscode gerelateerde instellingen worden gedaan in het paneel deelnemers.

Hoe maak je een deelnemerstabel aan?

Om gebruik te maken van een deelnemerstabel selecteer je de enquête en klik je op de knop Deelnemers in het menu Instellingen.



Je krijgt dan de volgende melding:



Als je een deelnemerstabel initialiseert dan is de enquête alleen in te vullen door mensen die die een toegangscode (handmatig of via URL) toegekend hebben gekregen. De enquête is dan besloten.

Na het initialiseren komt er een melding dan er een deelnemerstabel is aangemaakt.


Deelnemerstabel reactiveren

Als je een deelnemerstabel verwijderd wordt er een back-up aangemaakt. Deze kun je later weer activeren als je die deelnemerstabel in een andere enquête wilt gebruiken.


Beheer tools deelnemerstabel

Er wordt een samenvatting getoond als er al een deelnemerstabel is. Het standaardscherm:



  • Aantal records: Het aantal deelnemers in de deelnemerstabel van de enquête.
  • Aantal zonder unieke toegangscode
  • Totaal aantal uitnodigingen verzonden: Het aantal verzonden uitnodigen via de optie Uitnodigingen en herinneringen.
  • Totaal aantal afmeldingen: Het aantal deelnemers dat zich heeft afgemeld voor de enquête via de optie opt-out.
  • Aantal afgeschermd

Tonen en uitsluiten mogelijke deelnemers niet niet aan bepaalde criteria voldoen.

  • Totaal aantal voltooide enquêtes: Aantal door deelnemers met een toegangscode voltooide responsen.


Boven de samenvatting staat een taakbalk:



  • Toon deelnemers: Je ziet dan alle huidige deelnemers aan de enquête, je kunt de regels daarna bewerken, verwijderen of er een aantal functies op uitvoeren.
  • Aanmaken...: Een optie om deelnemers toe te voegen aan de tabel, dit kan ook met de optie Voeg deelnemer toe en via Importeer deelnemers.
  • Attributen beheren: De enquête-beheerder kan aanvullende velden registreren en beheren bij de deelnemers die de beheerder nodig heeft bij die enquête.
  • Exporteer gegevens: Je kunt de tabel exporteren in een csv-formaat.
  • Uitnodigingen en herinneringen: Een handige functie op snel e-mails te versturen naar je deelnemers.
  • Toegangscodes aanmaken: de enquête-beheerder kan snel unieke toegangscodes toekennen aan de deelnemers die nog geen toegangscode hebben.
  • In CPDB bekijken: een knop waarmee je snel toegang hebt tot de centrale Deelnemersdatabase (CPDB). Je kunt al bekende deelnemers (van andere enquêtes) als deelnemers registreren aan jouw enquête.


Deelnemers tonen

Het overzicht toont alle toegangscodes in een lijstvorm. Er zijn een aantal knoppen met een 'actie' die op toegangscodes kunnen worden uitgevoerd.



Enquête deelnemers sorteren

De volgende regel in de tabel heeft verschillende criteria om de tokens te sorteren. Klik op de kolom om op die kolom te sorteren. Klik nog een keer om de volgorde om te draaien.



Enquête deelnemers filteren

Als je de deelnemers wilt filteren, vul dan in de eerste regel onder de kopregel het veld in waarop je wilt filteren.



Je kunt bijvoorbeeld op e-mailstatus OK selecteren om de deelnemers te krijgen die een werkend e-mailadres hebben.

TIP: Je kunt ook operatoren gebruiken bij het filteren van de deelnemers (bijv.: >, <, >=, <=, = ).
  Attentie : Om te filteren op de kolommen "uitnodiging verzonden", "herinnering verzonden" en "enquête voltooid", gebruik "=N" of "<>N", wat resp. betekent "gelijk nr" en "ongelijk Nee".


Specifieke actie op een deelnemer

De kolom Actie bevat de acties die mogelijk zijn op de gegevens van die deelnemer. De mogelijke acties zijn:



  • Bekijk details respons: Bij een niet anonieme enquête is er ook een knop om de respons te bekijken.
  • Voer de enquête uit met dit token
  • Verzend uitnodiging: Verstuur een uitnodiging naar deze deelnemer om de enquête in te vullen.
  • Wijzig deelnemer
  • Verwijder deelnemer
  • Bekijk deze persoon in de deelnemersdatabase: Optioneel, alleen als de deelnemer daarin voorkomt.

Specifieke actie op meerdere deelnemers

Onder de tabel met deelnemers staat links de knop Geselecteerde deelnemer(s)... waarmee je acties op meerdere deelnemers tegelijk kunt uitvoeren.



  • Verzend uitnodigingen: Uitnodigingen e-mailen naar de geselecteerde deelnemers.
  • Verzend herinneringen: Herinneringen e-mailen naar de geselecteerde deelnemers.
  • Voeg deelnemers toe aan de deelnemersdatabase: Als je de (geselecteerde) deelnemers ook in een andere enquête wilt gebruiken kun je ze toevoegen aan de deelnemersdatabase. Meer informatie over deelnemers delen.


Als je een van deze functies gebruikt, selecteer dan eerst de deelnemers.


Aanmaken...

Als je meer deelnemers wilt toevoegen dan kun je ze handmatig toevoegen of ze importeren uit een CSV-bestand of een LDAP-query.



Deelnemer toevoegen

Het onderstaande scherm wordt getoond:



  • ID: Een nummer dat automatisch wordt toegekend aan elke deelnemer.
  • Voltooid?: Standaard uitgeschakeld. Indien ingeschakeld bevat het het tijdstip van afronding van het invullen door de deelnemer.
  • Voornaam
  • Achternaam
  • Toegangscode: Dit is het token. Het kan handmatig zijn toegekend of zijn gegenereerd.
  • Taal: De standaardtaal van de enquête voor deze deelnemer.
  • E-mail: het e-mailadres.
  • E-mail status: Indicatie van het e-mailadres. Standaard OK. Maar de enquête-beheerder kan het aanpassen als er notificaties komen bij het e-mailen, bijvoorbeeld onbekend, of mailbox vol. Bij een andere waarde dan OK wordt er geen uitnodiging of herinnering verzonden naar deze deelnemer. Als je de status niet door een script laat wijzigen dan is dit handwerk,
  • Uitnodiging verzonden?: Indien ingeschakeld de datum waarop de uitnodiging is verzonden.
  • Herinnering verzonden?: Indien ingeschakeld de datum waarop de herinnering is verzonden.
  • Resterend aantal pogingen: Hoe vaak kan de toegangscode nog worden gebruikt. Standaard 1. NB: Als je dit veld pas ophoogt na het afronden moet je ook Voltooid op "Nee" zetten.
  • Geldig van: & tot: Je kunt de geldigheid van de toegangscode beperken. Standaard zijn deze velden leeg en is er dus geen beperking op deelnemersniveau.

Let op, het paneel Deelnemer toevoegen heeft twee tabs: de tab Algemeen en de tab Additionele attributen. De laatste tab is voor de aangepaste attributen.


Dummy deelnemers toevoegen

Je kunt een dummy deelnemer gebruiken als je geen e-mail met de toegangscode wilt e-mailen maar de toegangscode op een andere manier verstrekt. Bijvoorbeeld als je studenten een formulier geeft met de toegangscode erop omdat je denkt op die manier meer reacties te krijgen.

Na het klikken op de knop krijg je de volgende pagina te zien:



Bij Aantal deelnemers: kun je het aantal gewenste dummy deelnemers invullen. De uitleg van de andere velden staat hier.

Klik na het invullen op de knop Opslaan rechtsboven.


Bekijk daarna de deelnemerstabel opnieuw om te zien of de dummy deelnemers zijn toegevoegd.


Deelnemers uit een CSV-bestand importeren

Met de functie importeren kun je informatie importeren uit een CSV-bestand en uit een LDAP-query.



  • Kies het te uploaden CSV-bestand: Het wordt aanbevolen om een standaard CSV-bestand (kommagescheiden) te gebruiken om fouten te vermijden. In OpenOffice en Excel wordt er optioneel dubbele aanhalingstekens gebruikt om de velden.

De eerste regel moet de veldnamen bevatten. Het moet de velden : voornaam, achternaam en e-mailadres bevatten.

Deze velden velden moet minstens een teken bevatten. Alleen dubbele aanhalingstekens werkt dus niet!

De andere velden (e-mailstatus, toegangscode, taal, ...) zijn optioneel.


 Hint: Om een volledige lijst met veldnamen te krijgen, kun je een bestaande tdeelnemerstabel exporteren.


 Hint: Het datumformaat voor de geldigheid in het invoerbestand is "YYYY-MM-DD HH:MM".


  • Karakterset van het bestand: Kies de optie van de karakterset van het CSV-bestand.
  • Gebruikt scheidingsteken: Selecteer de komma of de puntkomma of laat het door LimeSurvey bepalen.
  • Filter lege e-mailadressen: Indien ingeschakeld worden deelnemers zonder e-mailadres overgeslagen bij het importeren.
  • Sta ongeldige e-mailadressen toe: Indien uitgeschakeld worden een ingevuld e-mailadres gecontroleerd op structuur (bijv..: a@a.net);
  • Tonen attribuutwaarschuwingen: Indien ingeschakeld wordt er na het importeren waarschuwing(en) getoond bij foute invoer. Dit kan o.a. zijn als er een verplicht veld ontbreekt.
  • Filter dubbele records: Als je de optie om dubbele deelnemers te filteren aanzet, dan kun je ook bepalen hoe zo een duplicaat wordt bepaald. Standaard : voornaam, achternaam, e-mailadres. Een duplicaat wordt bij het importeren overgeslagen.
  • Iets is dubbel als: Selecteer de velden waarop volgens jou moet worden gefilterd om dubbele records te vorkomen.


Je kunt ook aangepaste attributen toevoegen bij het importeren van het csv-bestand. Je moet ze dan wel gedefinieerd hebben. Dat gaat als volgt:


   e-mail, attribuut_1 <Casenr>, token, attribuut_2 <Title,; attribuut_3 <destination>, achternaam, voornaam, attribuut_4 <Sender>


Klik, als je klaar met het instellen, op de knop Upload.


Probleemoplossing

Een vaak voorkomende fout bij het importeren van toegangscodes is een ongeldig CSV-bestand. Dit kan komen als je in Excel een lijst van e-mailadressen opslaat als XLS-bestand. Excel kan een bestand opslaan als CSV, maar gebruikt dan een puntkomma (dit is een instelling van het besturingssysteem per land) als scheidingsteken. Standaard is dit in CSV een komma. Als je het niet weet, controleer het scheidingsteken dan door het bestand met een standaardeditor te openen.

Als u het invoerbestand eerst nog wil bewerken, dan kunt een zogenaamde free raw text editor gebruiken, bijvoorbeeld: PSPad, NotePad2 of Notepad++ voor Windows, en TextWrangler voor Macintosh.


LimeSurvey zou puntkomma's moeten herkennen als scheidingsteken. Als het importeren mislukt probeer dan of je de komma als scheidingsteken kunt gebruiken. We bevelen aan om dubbele aanhalingstekens te gebruiken rond de waarden in het bestand.


Deelnemers uit een LDAP-query importeren

  Attentie : Gebruik deze optie alleen als je verstand hebt van LDAP-queries.


Met deze functie kun je informatie importeren uit een LDAP-query (getest op openLdap, maar het zou moeten werken op elke LDAP conforme omgeving inclusief ActiveDirectory). De opties zijn:


  • Een query wordt handmatig door de beheerder gedefinieerd in het bestand config-ldap.php.
  • Duplicaten worden bepaald op voornaam, achternaam en e-mailadres. Als je het "Filter dubbele records" aangevinkt hebt gelaten wordt elk dubbel record overgeslagen bij het importeren.
Meer informatie over LDAP.

Attributen beheren

Met deze optie kun je additionele velden toevoegen/wijzigen in de deelnemerstabel. Je kunt dus zelf gegevens toevoegen:



Vul het aantal velden in dat je per deelnemer wilt toevoegen. Na het klikken op de knop Voeg toe krijg je het volgende scherm:



De tabel met attribuutvelden heeft de volgende velden:

  • Attribuutveld: de waarde waarmee je wilt werken bij condities en bij het exporteren voor niet-anonieme enquêtes.
  • Veldbeschrijving: Vervangt in overzichten het attribuutveld. Dus een veld puur voor de leesbaarheid.
  • Verplicht?: Indien ingeschakeld, bij het registreren van een deelnemer moet het veld worden ingevuld.
  • Tonen tijdens registratie?: Als de deelnemers zich moeten aanmelden dan kun je hiermee aangeven of ze dit veld ook moeten invullen. Indien uitgeschakeld wordt dit veld niet getoond bij het aanmelden.
  • Veld tekst: Een toelichting over het doel/gebruik van dit veld.
  • CPDB-koppeling: Koppelt het veld met een veld in de centrale deelnemersdatabase.
  • Voorbeeld gegevens: Een tekst met welke gegevens je verwacht. Bij een vraag naar geslacht bijvoorbeeld: man, vrouw, gender, geen antwoord.


Klik na het invullen van de gegevens op de knop Bewaar, linksonder in het scherm.

Een beschrijving hoe je extra attributen toevoegt en daarop condities kunt gebruiken, staat hier.

Onderaan het scherm staat een optie om meer velden toe te voegen. Vul dan het veld Aantal toe te voegen attribuutvelden in en klik op de knop Voeg toe.

Onderaan het scherm kun je ook een eigen attribuut verwijderen, selecteer het dan wel eerst. Je moet het verwijderen ook bevestigen.

Exporteren

Als je een deelnemerstabel wilt exporteren klik dan op de knop Exporteer gegevens in de taakbalk van het beheer van de toegangscodes. Selecteer voor het daadwerkelijk exporteren dan eerst de gewenste opties.



  • Enquête status:
    • Alle toegangscodes: Alle deelnemers in de deelnemerstabel van de enquête.
    • Voltooid: Alleen deelnemers die de enquête afgerond hebben.
    • Niet volledig: Alleen deelnemers die de enquête nog niet afgerond hebben.
    • Niet begonnen: Alleen deelnemers die de enquête nog niet begonnen zijn.
    • Begonnen maar nog niet afgerond.
  • Status uitnodiging: Alle, Uitgenodigd en Niet uitgenodigd.
  • Status herinnering: Alle, Herinnering(en) verzonden, Geen herinnering verzonden.
  • Filter op taal: Als je de enquête in meerdere talen aanbied kun je hier de deelnemers filteren op taal.
  • Filter op e-mailadres: Je kunt de deelnemers filteren op een deel van het e-mailadres, als daar bijvoorbeeld een bedrijfsnaam of een provider inzit. Tik bijvoorbeeld in @ziggo.nl.
  • Geëxporteerde deelnemers verwijderen: Je kunt bij het exporteren deze deelnemers verwijderen uit je deelnemerstabel.

Klik na het invullen van de gegevens op de knop CSV-bestand downloaden, rechtsboven in het scherm

Als je tokens exporteert dan is de volgorde van de velden: tid,voorname,achternaam,e-mailadres,e-mailstatus,token,taalcode,attribuut_1,attribuut_2,...

Uitnodigingen en herinneringen

Hier kun je uitnodigingen of herinneringen versturen naar de deelnemers die in de deelnemerstabel staan. Het onderdeel e-mail bounce tracking zorgt voor de registratie van niet verzonden e-mails naar de ontvangers / deelnemers.


Uitnodiging e-mailen

Je kunt met deze optie in een keer een e-mail versturen naar deelnemers aan de enquête die nog geen uitnodiging ontvangen hebben.



Je kunt deelnemers overslaan als de e-mailstatus ongelijk 'OK' is, door de optie 'Overslaan ongeldige e-mailadressen' in te schakelen.

Als je de controle wilt uitschakelen, schakel dan de optie Bij versturen e-mail de datumcontrole overslaan in. Er wordt dan niet gecontroleerd of de code op dat moment gebruikt mag worden.


Opnieuw versturen uitnodigingen

Soms wil je aan bepaalde personen/deelnemers de uitnodigingen opnieuw versturen. Als je de functie verzend uitnodiging gebruikt krijgen alleen deelnemers die nog niet eerder een uitnodiging hebben gekregen, een uitnodiging. Je kunt dus je e-mails verspreid versturen als je nog niet alle deelnemers compleet hebt.

Je kunt dus ook als er een e-mail niet afgeleverd kan worden (bounce), het bijbehorende token opzoeken, het e-mailadres wijzigen en dan de functie opnieuw kiezen. Dan krijgt immers alleen deze deelnemer de e-mail. Schakel wel het veld Uitnodiging verzonden uit.

Herinnering versturen

Hiermee kun je in één keer een e-mail versturen naar alle deelnemers die de enquête nog niet ingevuld hebben maar al wel de uitnodiging hebben gekregen.



Bij het versturen van herinneringen kun je:

  • Tokens overslaan van deelnemers die een ongeldig e-mailadres hebben
  • Tokens overslaan van deelnemers die minder dan een bepaald aantal dagen geleden een herinnering hebben ontvangen
  • Tokens overslaan van deelnemers die al het maximaal aantal herinneringen hebben ontvangen
  • Tokens overslaan van deelnemers die de enquête op dat moment niet kunnen invullen vanwege een beperking van de geldigheid
NB. Een herinnering wordt alleen verstuurd naar deelnemers die de enquête nog niet afgerond hebben ("Voltooid?" is ongelijk "N").


Versturen e-mails in een batch

Als het aantal te versturen e-mails groot is, dan zal LimeSurvey in een eerste batch het aantal van N e-mails versturen. Dit aantal (threshold) is bepaald door de beheerder in de instellingen met de E-mail batchgrootte.

Versturen bevestiging

Als de deelnemer een enquête afgerond heeft en er worden tokens gebruikt, dan wordt er een bevestiging verstuurd naar zijn/haar e-mailadres.

Als je niet wil dat dit bericht wordt gestuurd, schakel dit dan uit in de instellingen van de enquête.

Bounce verwerking starten

Als er een e-mail verstuurd wordt, dan worden er automatisch identificaties van de enquête en het token toegevoegd aan de header van de e-mail die verstuurd wordt naar de deelnemers. Als er een e-mail niet afgeleverd kan worden (bounce) dan worden deze gegevens weer terug ontvangen. LimeSurvey herkent dan in de nieuwe berichten deze bounces en markeert in de deelnemerstabel van de enquête bij deze deelnemer het e-mailadres als foutief.


Bounce instellingen

De beschikbare opties:



In de algemene instellingen staat een korte beschrijving van deze velden. Als je de globale instellingen van LimeSurvey wilt gebruiken ga dan naar de Bounce-instellingen en selecteer de betreffende optie.

Een uitgebreidere beschrijving van het verwerken van bounces.

Lees dit voor het juist instellen van deze functie.

E-mail sjablonen wijzigen

Als je meer wilt weten over beschikbare placeholders en het wijzigen van sjablonen, lees dan deze informatie.


Tokens genereren

Met deze functie kun je unieke tokens (toegangscodes) aanmaken voor alle deelnemers in de deelnemerstabel van de enquête die nog geen token hebben.


Tonen in deelnemersdatabase

De laatste optie in de taakbalk is het In CPDB bekijken. Hiermee kan je als enquête-beheerder de deelnemers zien die zowel in je deelnemerslijst van de eigen enquête als in de centrale deelnemersdatabase voorkomen.

Als dit je deelnemerslijst is:



De deelnemers met ID 1 en 2 komen ook in de centrale deelnemersdatabase voor. Dat zie je aan het laatste veld onder Actie. Om dit te controleren klik je op op In CPDB bekijken in de taakbalk.



Deze functie is dus eigenlijk een filter zodat je kunt zien welke deelnemers in de centrale deelnemersdatabase meedoen aan jouw enquête.

Tabel verwijderen

De de eelnemerstabel van je enquête kun je verwijderen door te klikken op de knop Toon deelnemers en daarna op de knop Deelnemerstabel verwijderen, die rechtsboven in het scherm staat.



Je moet op een pop-up scherm het verwijderen wel even bevestigen.



De tabel wordt overigens niet fysiek verwijderd. Er wordt een back-up gemaakt van de tabel die alleen door de hoofdbeheerder benaderbaar is.

Als je de tabel ook fysiek wilt verwijderen, gebruik dan de optie Controle op integriteit in de dialoog Configuratie.

Aanvullende tips

De onderstaande tips en opmerkingen zijn van de gebruikers van LimeSurvey. Vul dit aan als je nog een goede tip hebt voor andere gebruikers van LimeSurvey:


Toestaan openbare registratie

Als je je enquête openbaar wilt maken maar wel controle over de deelnemers wilt houden dan kun je tokens gebruiken. Je moet dan bij de instelling van de enquête kiezen voor Openbare aanmelding toestaan. Dit kun je later alsnog instellen bij de instellingen van de enquête. Mensen die de enquête bezoeken zonder token, kunnen zich dan aanmelden.

Als een deelnemer een e-mailadres opgeeft dat nog niet in de huidige database staat, wordt er een vermelding in de tabel met deelnemers aan de enquête aangemaakt en ontvangt hij/zij een uitnodiging per e-mail met daarin zijn unieke tokencode.

Captcha in openbare aanmelding

Om je enquête te beschermen tegen registratie door robots kun je de captcha functie gebruiken op alle registratie, bewaar en laad schermen. Meer informatie.

Is de enquête anoniem?

Ja, je kunt ook met het gebruik van toegangscodes de enquête anoniem houden. Je bepaalt bij het aanmaken van de enquête of die anoniem is of niet anoniem. Als de enquête niet anoniem is worden de toegangscodes gebruikt om de respons te koppelen aan de deelnemer. Bij een anonieme enquête met toegangscodes, wordt deze link (foreign key relatie) NIET gelegd.

De keuze respons is wel/niet anoniem, maak je hier.

TIP: Veel nep e-mailadressen aanmaken

Soms heb je een aantal nep e-mailadressen met tokens nodig. Je kunt in een programma als Calc of Excel functies gebruiken om ze aan te maken. Stel je wilt 1000 e-mailadressen aanmaken op het werkblad : 1@test.com, 2@test.com, 3@test.com, ... Zet dan de oplopende nummers in de kolom A: 1 in cel A1, voeg de functie =A1+1 in A2 toe, en kopieer A2 naar beneden, zo ver als je nodig hebt. In cal B1 gebruik je de functie om cel A1 en "@test.com" samen te voegen, =CONCATENATE(A1;"@test.com") of =TEKST.SAMENVOEGEN(A1;"@test.nl"). Kopieer vervolgens B1 naar beneden, net zo ver als je dat bij A hebt gedaan. Je kunt de namen op dezelfde manier maken. Sla vervolgens je werk op als een CSV-bestand en importeer het daarna in LimeSurvey.

Vanaf versie 1.91 kun je dummy toegangscodes genereren. Deze bevatten echter geen e-mailadres.


Spam problemen

Vaak klagen gebruikers over het niet hebben ontvangen van een uitnodiging of herinnering, doordat het spamfilter van de gebruiker de e-mail ziet als spam (ongewenste e-mail).

Waarom een spam filter een e-mail als spam ziet, is afhankelijk van de instellingen van het filter. Het filter bekijkt van de e-mail het e-mailadres van de afzender, het onderwerp en de inhoud, dus je kunt er als enquête-beheerder wel wat aandoen.

Op deze blog staan een aantal problemen en oplossingen.

LimeSurvey probeert automatisch de URL voor de link in een e-mail te bepalen uit de URL waarmee je als beheerder bent ingelogd. Het kan voorkomen dat dit bij een foutieve instelling van de server niet goed werkt, je moet de URL voor de link dan handmatig instellen.

Wijzig in application/config/config.php de standaard base URL. Voeg de hostInfo property toe aan het bestaande array 'components'.

    'components' => array(
       ...
       'config' => array(
           'publicurl' => 'http://www.example.com',
       ),
   )
Meer informatie over het wijzigen van het configuratie-bestand van je LimeSurvey installatie staat hier.

De oorzaak van het probleem, LimeSurvey probeert het domein te bepalen uit de PHP variabelen $_SERVER['HTTP_HOST'] en $_SERVER['SERVER_NAME'].

Enkele webservers vullen deze informatie niet of op een eigen manier.

Pseudo anonieme deelname

Met dummy tokens maak je een soort van pseudo anonieme deelname mogelijk, je kunt ze exporteren en ze dan extern koppelen aan je deelnemerslijst. In LimeSurvey zijn dan persoonlijke gegevens van de deelnemers die deze tokens gebruiken niet bekend.

Een beperking is dat je de deelnemerscodes, de tokens, zelf moet verspreiden.