Helpcentrum

CSL – Enquête variabelen

Geen reacties

CheckMarket biedt een krachtige scriptingtaal aan om je enquêtes en rapporten te verbeteren, genoemd de CheckMarket Scripting Language of CSL.

Op het meest eenvoudige niveau is de CSL laagdrempelig en eenvoudig te gebruiken. Je kan de scriptingtaal gebruiken om variabelen in je enquêtes en rapporten te plaatsen door ze te selecteren in een drop-down menu.

Dit artikel lijst alle variabelen op die beschikbaar zijn in de Enquête Interface (EI), en dit op volgende plaatsen:

  • Enquête: de enquête zelf als de respondent deze invult
  • E-mails: de uitnodiging, herinnering en dankmail
  • Meldingen: alle verschillende soorten meldingen

De standaard context is steeds de huidige enquête, huidige respondent, huidige contact en huidige taal.

Basisbegrippen

Syntax

Variabelen in deze scriptingtaal worden ingesloten door dubbele accolades, zoals deze: {{eenVariabele}}. Deze zijn niet hoofdlettergevoelig, dus {{EenVariabele}} is hetzelfde als {{eenVariabele}}.

Hiërarchie

De variabelen zijn hiërarchisch, je kunt er dus doorheen navigeren door een puntnotatie te gebruiken. Dit zijn de topniveaus in de Enquête Interface:

  • Enquête: details van de enquête en de collectie van alle vragen in een enquête.
  • Respondent: antwoorden en andere metadata van de huidige respondent die de enquête invult.
  • Contact: metadata van het contact dat de enquête invult. Niet alle respondenten zijn ook contacten.

Lijst met variabelen in de Enquête Interface

VariabeleOmschrijving
{{survey.id}}
ID van de enquête
{{survey.title}}
enquêtetitel in de huidige taal
{{survey.clientRef}}
de referentie naar de enquête
{{survey.maxScore}}
de hoogst mogelijke score voor de enquête
{{survey.dateCreated}}
datum waarop de enquête gecreëerd werd
{{survey.startDate}}
startdatum van de enquête
{{survey.endDate}}
einddatum van de enquête
{{survey.status}}
     {{survey.status.id}}
het tekstlabel van de status van de enquête in de huidige taal
voeg ‘id’ toe om de ID van de status te verkrijgen
{{survey.defaultLanguage}}
     {{survey.defaultLanguage.code}}
naam van de standaardtaal in de huidige taal
voeg ‘code’ toe om de taalcode te verkrijgen
{{survey.url}}
     {{survey.url.en}}
     {{survey.url.languageSelection}}
     {{survey.url.otherLanguages}}
Live‘ link van de enquête in de huidige taal
voeg een specifieke taalcode toe om de URL voor die taal te verkrijgen
{{survey.signInUrl}}
     {{survey.signInUrl.en}}
URL van de aanmeldpagina van de enquête in de huidige taal
voeg een specifieke taalcode toe aan de URL voor die taal
{{survey.privacyNoticeUrl}}
     {{survey.privacyNoticeUrl.en}}
URL van de privacykennisgeving van de enquête in de huidige taal
voeg een specifieke taalcode toe aan de URL voor die taal
{{survey.printingUrl}}
     {{survey.printingUrl.en}}
URL van de afdrukbare versie van de enquête in de huidige taal
voeg een specifieke taalcode toe aan de URL voor die taal
{{survey.editUrl}}
URL van de vragen-editor in het CheckMarket platform
{{survey.notifications.editUrl}}
URL van de beheerpagina van de meldingen in het CheckMarket platform
{{notification}}
     {{notification.id}}
     {{notification.name}}
werken enkel in een melding

Merk op dat ‘Questions’ meervoud is. Dit betekent dat het gaat om een collectie van de vragen in de enquête. Maar hoe vind je de vraag die je zoekt? Welnu, er zijn drie manieren:

  • Nummer: gebruik het vraagnummer (niet aanbevolen)
    gemakkelijk om te gebruiken, maar het is ook de minst veilige en meest veranderlijke optie – als er een vraag wordt toegevoegd of verwijderd boven de vraag die je nodig hebt, zal het vraagnummer wijzigen
  • ID: gebruik de unieke ID van een vraag – deze verandert nooit, zelfs niet wanneer er vragen toegevoegd, verwijderd of verplaatst worden
  • Gegevenslabel: gebruik het gegevenslabel (aanbevolen)
    zoals de ID, wijzigt ook het gegevenslabel niet wanneer de vraag verplaatst wordt, of wanneer er andere vragen toegevoegd of verwijderd worden – het grootste voordeel is dat het gegevenslabel een betekenis kan overbrengen – zo is ‘questions.nps’ gemakkelijker te lezen dan een of ander getal
VariabeleOmschrijving
{{survey.questions}}
een collectie van alle vragen in de enquête, meestal gebruikt in ‘each‘ loops
{{survey.questions.1}}
verwijs naar de vraag in de enquête met vraagnummer 1
{{survey.questions.id-1}}
verwijs naar de vraag in de enquête met ID 1
{{survey.questions.mijnLabel}}
verwijs naar de vraag in de enquête met het gegevenslabel ‘mijnlabel’ (aanbevolen methode)
{{survey.questions.mijnlabel.id}}
ID van de vraag met het gegevenslabel ‘mijnlabel’
{{survey.questions.mijnlabel.text}}
     {{survey.questions.mijnlabel.text.unformatted}}
tekst van de vraag in de huidige taal
gebruik het suffix ‘unformatted’ om alle opmaak te verwijderen
{{survey.questions.mijnlabel.questionNumber}}
vraagnummer van de vraag
{{survey.questions.id-1.dataLabel}}
gegevenslabel van de vraag met ID 1
{{survey.questions.mijnlabel.pageNumber}}
paginanummer van de vraag
{{survey.questions.mijnlabel.maxScore}}
hoogst mogelijke score van de vraag
{{survey.questions.mijnlabel.isHidden}}
geeft ‘true’ als resultaat als de vraag verborgen is, zo niet geeft deze variabele ‘false’ terug – vaak gebruikt bij ‘if’ operatoren
{{survey.questions.mijnlabel.subQuestions}}
     {{survey.questions.mijnlabel.subQuestions.1}}
     {{survey.questions.mijnlabel.subQuestions.id-123}}
collectie van de subvragen van een matrix-vraag – om een specifieke subvraag te verkrijgen, kan je ofwel het nummer van de volgorde, het gegevenslabel of ID  van de subvraag gebruiken. Eens je de subvraag hebt, kan je alle andere vraag-eigenschappen gebruiken die hierboven opgelijst staan
{{survey.questions.mijnlabel.answerChoices}}
collectie van de antwoordopties van de vraag – je kunt verwijzen naar specifieke antwoordopties gebaseerd op hun volgorde-nummer of hun ID
{{survey.questions.mijnlabel.answerChoices.1.id}}
ID van de eerste antwoordoptie van de vraag
{{survey.questions.mijnlabel.answerChoices.id-1.orderNumber}}
volgorde-nummer van de antwoordoptie met ID 1 van de vraag
{{survey.questions.mijnlabel.answerChoices.1.text}}
     {{survey.questions.mijnlabel.answerChoices.1.text.unformatted}}
tekst van de eerste antwoordoptie van de vraag – gebruik het suffix .unformatted om alle opmaak te verwijderen
{{survey.questions.mijnlabel.answerChoices.1.scaleValue}}
de schaalwaarde van de antwoordoptie – in een waarderingsschaal of matrix-vraag kan de schaal van een vraag starten vanaf ‘0 (nul)’ of deze kan gaan van  -3 tot +3 – de schaalwaarde zal die waarde teruggeven – bijvoorbeeld in een NPS-vraag heeft de eerste antwoordoptie een volgorde-nummer van ‘1’, maar een schaalwaarde van ‘0 (nul)’ aangezien de schaal van een NPS-vraag gaat van 0 tot 10
{{survey.questions.mijnlabel.answerChoices.1.score}}
     {{survey.questions.mijnlabel.answerChoices.1.score.percentage}}
geeft de score terug van de eerste antwoordoptie van de vraag
{{survey.questions.mijnlabel.answerChoices.1.isNotApplicable}}
geeft ‘true’ als resultaat als de antwoordkeuze de optie ‘Niet van toepassing’ is
{{survey.questions.mijnlabel.answerChoices.1.isOther}}
geeft ‘true’ als resultaat als de antwoordkeuze de optie ‘Andere’ is
{{survey.questions.mijnlabel.answerChoices.1.isHidden}}
geeft ‘true’ als resultaat als de antwoordkeuze verborgen is

 

Haal de resultaten op van alle respondenten voor de volledige enquête, een specifieke vraag, een subvraag of een antwoordoptie.
We raden ten sterkste aan het gegevenslabel van een vraag te gebruiken om naar een vraag te verwijzen, aangezien het gegevenslabel niet verandert als een enquête wordt bewerkt en het duidelijker maakt wat de variabele bevat.

VariabeleOmschrijving
{{survey.results.respondentCount}}
     {{survey.results.respondentCount.completed}}

{{survey.questions.myDataLabel.results.respondentCount}}
     {{survey.questions.myDataLabel.results.respondentCount.completed}}

{{survey.questions.myDataLabel.answerChoices.1.results.respondentCount}}
     {{survey.questions.myDataLabel.answerChoices.1.results.respondentCount.completed}}
Het totale aantal personen dat de enquête, vraag of antwoordoptie heeft ingevuld. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.
{{survey.questions.myDataLabel.results.average}}
     {{survey.questions.myDataLabel.results.average.completed}}
De gemiddelde schaalwaarde voor een vraag, overheen alle respondenten. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.
{{survey.results.averageScore}}
     {{survey.results.averageScore.completed}}

{{survey.questions.myDataLabel.results.averageScore}}
     {{survey.questions.myDataLabel.results.averageScore.completed}}
De gemiddelde score voor een specifieke vraag of voor de gehele enquête. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.
{{survey.questions.myDataLabel.results.sum}}
     {{survey.questions.myDataLabel.results.sum.completed}}

{{survey.questions.myDataLabel.answerChoices.1.results.sum}}
     {{survey.questions.myDataLabel.answerChoices.1.results.sum.completed}}
De som van alle waarden voor een vraag of antwoordoptie, overheen alle respondenten. Dit werkt voor sliders, tekstvakken met numerieke validatie en vragen met schaalwaarden. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.
{{survey.results.scoreSum}}
     {{survey.results.scoreSum.completed}}

{{survey.questions.myDataLabel.results.scoreSum}}
     {{survey.questions.myDataLabel.results.scoreSum.completed}}

{{survey.questions.myDataLabel.answerChoices.1.results.scoreSum}}
     {{survey.questions.myDataLabel.answerChoices.1.results.scoreSum.completed}}
De som van alle scores voor een enquête, vraag of antwoordoptie, overheen alle respondenten. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.
{{survey.questions.myDataLabel.results.nps}}
     {{survey.questions.myDataLabel.results.nps.completed}}
De gecombineerde NPS voor een vraag. Voeg ‘.completed’ toe om enkel respondenten te tellen die het einde van de enquête bereikt hebben.

Deze variabelen hebben betrekking op de huidige respondent.

VariabeleOmschrijving
{{respondent.id}}
ID van de huidige respondent
{{respondent.hash}}
unieke hash van de respondent
{{respondent.score}}
totale score van de respondent
{{respondent.score.percentage}}
het percentage van de score van de respondent ten opzichte van de hoogst mogelijk haalbare score in de enquête
{{respondent.dateResponded}}
de datum waarop de respondent de enquête beantwoord heeft
{{respondent.language}}
     {{respondent.language.code}}
de naam van de taal van de respondent in de huidige taal – je kunt ‘.code’ toevoegen om de taalcode te verkrijgen in plaats van de naam
{{respondent.status}}
     {{respondent.status.id}}

de status van de respondent: gedeeltelijk beantwoord, volledig beantwoord, afgedank – je kunt ‘.id’ toevoegen om de ID van de status te verkrijgen

  • 0 = gedeeltelijk beantwoord
  • 1 = volledig beantwoord
  • 2 = afgedankt
  • 3 = quotum gevuld
{{respondent.channel}}
     {{respondent.channel.id}}
het kanaal dat de respondent gebruikt heeft om de enquête in te vullen: Web, E-mail, Kiosk, SMS, enz. – je kunt ‘.id’ toevoegen om de numerieke ID van het kanaal te verkrijgen
{{respondent.browser}}
de webbrowser die de respondent gebruikt heeft om de enquête in te vullen: Google Chrome, Mozilla Firefox, of dergelijke.
{{respondent.os}}
het besturingssysteem dat de respondent gebruikt heeft om de enquête in te vullen: Windows, Android, of dergelijke.
{{respondent.reportUrl}}
     {{respondent.reportUrl.en}}
     {{respondent.reportUrl.internal}}
URL van het respondentverslag van de huidige respondent  – je kunt de taal specificeren of je kunt ‘.internal’ toevoegen, zodat enkel tool gebruikers met toegang tot de enquête het rapport kunnen zien, hetgeen vaak gebruikt wordt in meldingen
{{respondent.ipLocation}}
     {{respondent.ipLocation.city}}
     {{respondent.ipLocation.country}}
          {{respondent.ipLocation.country.code}}
     {{respondent.ipLocation.latitude}}
     {{respondent.ipLocation.longitude}}
de locatie van de respondent gebaseerd op hun IP-adres – je kunt ‘city’, of ‘country’ toevoegen om maar een deel van de locatie weer te geven
{{respondent.timing.totalDuration}}
totale tijd (in seconden) die de respondent gespendeerd heeft in de enquête

Haal de antwoorden op van de huidige respondent.
We raden ten zeerste aan het gegevenslabel van een vraag te gebruiken om naar een vraag te verwijzen, aangezien het gegevenslabel niet verandert als een enquête wordt bewerkt en het duidelijker maakt wat de variabele bevat.

VariabeleOmschrijving
{{respondent.questions}}
collectie van de vragen die een respondent beantwoord heeft – je kunt naar een specifieke vraag refereren door het vraagnummer, ID of gegevenslabel te gebruiken – je kunt er ook doorheen gaan met behulp van een ‘each’ operator
{{respondent.questions.1}}
het antwoord van de respondent op de vraag met vraagnummer 1 – als dit een open vraag is, zal deze variabele het open antwoord tonen zoals de respondent dit in de vraag ingetikt heeft – voor andere vragen krijg je de tekst van de antwoordoptie terug – voor vragen met een lege antwoordoptie met een schaal krijg je de schaalwaarde terug – voor andere vragen krijg je de tekst van de antwoordoptie terug – wanneer meer dan één antwoord kon gekozen worden, zoals bij een vraag met checkboxes, wordt een door komma’s gescheiden lijst teruggegeven – als de respondent deze vraag niet beantwoord heeft, wordt er niets teruggegeven en wordt de variabele vervangen door een tekenreeks met de lengte nul
{{respondent.questions.id-1}}
antwoord van de respondent op de vraag met ID 1
{{respondent.questions.mijnlabel}}
antwoord van de respondent op de vraag met het gegevenslabel ‘mijnlabel’ (aanbevolen methode)
{{respondent.questions.mijnlabel.openAnswer}}
de tekst van het open antwoord zoals de respondent deze ingetikt heeft
{{respondent.questions.mijnlabel.scaleValue}}
de schaalwaarde van de antwoordoptie die de respondent heeft gekozen – sommige vragen hebben bijvoorbeeld een schaal van 0 tot 10 of van -3 tot +3
{{respondent.questions.mijnlabel.text}}
de tekst van de antwoordkeuze die de respondent geselecteerd heeft – wanneer er meer dan één antwoord kon gekozen worden, zoals in vragen met checkboxes, wordt een door komma’s gescheiden lijst teruggegeven
{{respondent.questions.mijnlabel.orderNumber}}
het volgorde-nummer van de antwoordkeuze die de respondent heeft geselecteerd
{{respondent.questions.mijnlabel.score}}
     {{respondent.questions.mijnlabel.score.percentage}}
de score die de respondent op de vraag behaalde
{{respondent.questions.mijnlabel.npsType}}
het NPS-type: criticaster (0-6), passief tevredene (7-8) of promotor (9-10) van de respondent gebaseerd op hun antwoord
{{respondent.questions.mijnlabel.subQuestions}}
collectie van de antwoorden van de huidige respondent op de subvragen van de matrix-vraag
     {{respondent.questions.mijnlabel.subQuestions.1}}
     {{respondent.questions.mijnlabel.subQuestions.id-123}}
     {{respondent.questions.mijnlabel.subQuestions.mijnlabel2}}
Om een specifieke subvraag te verkrijgen, kan je ofwel het nummer van de volgorde, het gegevenslabel of ID van de subvraag gebruiken. Eens je de subvraag hebt, kan je alle andere vraag-eigenschappen gebruiken die hier opgelijst staan zoals ‘.answerChoices’.
{{respondent.questions.mijnlabel.answerChoices}}
collectie van de antwoordkeuzes – deze wordt gebruikt wanneer je wil refereren naar een specifiek antwoord van een respondent
{{respondent.questions.mijnlabel.answerChoices.1}}
geeft het antwoord terug op de eerste antwoordoptie – als de respondent deze antwoordoptie niet gekozen heeft, wordt er niets getoond
{{respondent.questions.mijnlabel.answerChoices.id-123}}
geeft het antwoord terug op antwoordoptie 123
{{respondent.questions.mijnlabel.answerChoices.nth-1}}
geeft het antwoord op de n-de antwoordoptie die de respondent gekozen heeft – in een vraag met checkboxes, bijvoorbeeld, en de respondent kiest de 2de en 5de antwoordkeuze, dan zal ‘nth-1’ de 2de antwoordoptie weergeven en ‘nth-2’ de 5de
VariabeleOmschrijving
{{contact.id}}
de contact ID van het huidige contact
{{contact.firstName}}
de voornaam van het contact
{{contact.lastName}}
de achernaam van het contact
{{contact.fullName}}
de voor- en achternaam van het contact
{{contact.status}}
     {{contact.status.id}}
de status van het contact
{{contact.language}}
     {{contact.language.code}}
de naam van de taal van het contact – voeg ‘code’ toe om de taalcode te verkrijgen
{{contact.street}}
de straat van het contactd
{{contact.houseNumber}}
het huisnummer van het contactd
{{contact.apartmentOrSuite}}
de bus van het contact
{{contact.postalCode}}
de postcode van het contact
{{contact.city}}
de woonplaats van het contact
{{contact.province}}
de provincie van het contact
{{contact.state}}
     {{contact.state.code}}
de staat of afkorting van de staat waar het contact woont
{{contact.country}}
     {{contact.country.code}}
de naam of code van het land van het contact
{{contact.email}}
het e-mailadres van het contact
{{contact.phone}}
het telefoonnummer van het contact
{{contact.gender}}
     {{contact.gender.code}}
     {{contact.gender.isMale}}
     {{contact.gender.isFemale}}
het geslacht van het contact of enkele tests die ‘true’ of ‘false’ als resultaat zullen geven
{{contact.dateOfBirth}}
de geboortedatum van het contact
{{contact.isOptedOut}}
geeft ‘true’ als resultaat wanneer het contact zich uitgeschreven heeft
{{contact.isBounced}}
geeft ‘true’ als resultaat wanneer het e-mailadres gebouncet is
{{contact.dateAdded}}
de datum waarop het contact toegevoegd werd aan de enquête
{{contact.dateInvited}}
de datum waarop het contact uitgenodigd werd voor de enquête
{{contact.dateSawEmail}}
dat datum waarop het contact de e-mailuitnodiging of herinnering gezien heeft
{{contact.dateClickedThrough}}
de datum waarop het contact geklikt heeft op de link naar de enquête
{{contact.dateReminded}}
de datum waarop een herinnering naar het contact gestuurd werd
{{contact.dateRemindedPartial}}
de datum waarop een herinnering ‘gedeeltelijk geantwoord’ naar het contact gestuurd werd
{{contact.dateSecondReminder}}
de datum waarop een tweede herinnering naar het contact gestuurd werd
{{contact.dateToExpire}}
de vervaldatum van de e-mailuitnodiging van het contact
{{contact.dateResponded}}
de datum waarop het contact de enquête beantwoord heeft
{{contact.dateSentThankYouEmail}}
de datum waarop een dankmail naar het contact werd gestuurd
{{contact.dateToBeInvited}}
de uitnodigingsdatum en -tijd van het contact
{{contact.dateLastModified}}
de laatste datum en tijd waarop het contact bewerkt werd
{{contact.customFields}}
collectie van alle gepersonaliseerde velden. Handig voor ‘each’ loops
{{contact.customFields.1}}
     {{contact.customFields.2}}
     {{contact.customFields.3}}
     ...
geeft de inhoud van een gepersonaliseerd veld weer – wijzig de ‘1’ op het einde om de inhoud van andere velden te verkrijgen
{{contact.customFields.naam_veld}}
     {{contact.customFields.naam_veld_2}}
gebruik de naam van het gepersonaliseerde veld in plaats van het nummer, dit maakt de variabele leesbaarder en begrijpelijker – spaties in veldnamen vervang je door een liggend streepje of ‘underscore’ (aanbevolen methode)
{{contact.surveyUrl}}
     {{contact.surveyUrl.en}}
     {{contact.surveyUrl.languageSelection}}
     {{contact.surveyUrl.otherLanguages}}
de ‘live‘ enquête URL voor dit contact
{{contact.reportUrl}}
     {{contact.reportUrl.en}}
     {{contact.reportUrl.internal}}
URL naar het respondentverslag van dit contact – je kunt de taal specificeren of ‘.internal’ toevoegen, zodat enkel tool gebruikers met toegang tot de enquête het rapport kunnen zien, hetgeen vaak wordt gebruikt in meldingen
{{contact.optOutUrl}}
     {{contact.optOutUrl.en}}
URL naar de uitschrijf-pagina voor dit contact
{{contact.showEmailInBrowserUrl}}
     {{contact.showEmailInBrowserUrl.en}}
URL om de e-mailuitnodiging in de browser te tonen
VariableDescription
{{querystring.parameterNaam}}
     {{querystring.q1}}
     ...
de waarde van een parameter in de querystring van de enquête-URL
{{currentDate}}
     {{currentDate.date}}
     {{currentDate.time}}
     {{currentDate.utc}}
     {{currentDate.iso}}

de huidige datum, inclusief tijd – je kunt ook enkel de datum of tijd selecteren

ook beschikbaar: de datum in UTC (gecoördineerde wereldtijd) en de datum in het ISO 8601-formaat

opmerking: al deze datumeigenschappen zijn ook beschikbaar voor andere datums (bijv. respondent.dateResponded)

Hulp nodig?

De CheckMarket Scripting Language biedt zeer vele toepassingsmogelijkheden, die wij uiteraard niet allemaal gratis kunnen ondersteunen. Het eigen gebruik van onze scriptingtaal (CSL) is inbegrepen in al onze prijsformules, en daarnaast bieden onze specialisten graag ondersteuning aan klanten die dat wensen.

Wil je geavanceerde enquêtes en/of enquêterapporten maken maar heb je hier zelf geen tijd voor? Heb je hulp nodig met het programmeren van een enquête of een rapport? Laat gerust een van onze projectmanagers dit voor je doen!

Vraag een prijsofferte

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.