Centre d'assistance

CSL – Variables d’enquête

Pas de commentaire

CheckMarket offre un langage de script très puissant pour améliorer vos enquêtes et vos rapports, appelé le CheckMarket Scripting Language ou CSL.

À son niveau le plus élémentaire, le CSL est facile à utiliser. Vous pouvez l’utiliser pour ajouter des variables à vos enquêtes en les sélectionnant d’un menu déroulant.

Cet article liste les variables disponibles dans l’interface d’enquête (IE), y inclus les endroits suivants :

  • Enquête : l’enquête-même pendant que le répondant la remplisse
  • E-mails : les invitations, les rappels et les e-mails de remerciement
  • Notifications : tous les différents types de notifications

Le contexte par défaut est toujours l’enquête actuelle, le répondant actuel, le contact actuel et la langue actuelle.

Concepts de base

Syntaxe

Les variables dans le langage de script sont entourées de doubles accolades, comme ceci : {{nomDuVariable}}. Elles sont insensibles à la casse, alors {{NomduVariable}} est identique à {{nomduvariable}}.

Hiérarchie

Les variables sont hiérarchiques, vous pouvez donc les parcourir en utilisant la notation par points. Voici les objets de niveau supérieur dans l’interface d’enquête :

  • Enquête : les détails de l’enquête et la collection de toutes les questions dans l’enquête
  • Répondant : les réponses et les autres métadonnées pour le répondant qui est actuellement en train de remplir l’enquête
  • Contact : les métadonnées pour le contact qui remplit l’enquête. Tous les répondants ne sont pas également des contacts

Liste des variables dans l’interface d’enquête

VariableDescription
{{survey.id}}
l’ID de l’enquête
{{survey.title}}
le titre de l’enquête dans la langue actuelle
{{survey.clientRef}}
obtenez la référence de l’enquête
{{survey.maxScore}}
obtenez le meilleur score possible pour l’enquête
{{survey.dateCreated}}
montrez la date de création de l’enquête
{{survey.startDate}}
montrez la date de début de l’enquête
{{survey.endDate}}
montrez la date de fin de l’enquête
{{survey.status}}
     {{survey.status.id}}
obtenez l’étiquette de texte de l’état de l’enquête dans la langue actuelle -ajoutez “id” pour obtenir l’ID de l’état
{{survey.defaultLanguage}}
     {{survey.defaultLanguage.code}}
retourne le nom de la langue par défaut – vous pouvez ajoutez “code” pour obtenir le code de langue
{{survey.url}}
     {{survey.url.en}}
     {{survey.url.languageSelection}}
     {{survey.url.otherLanguages}}
l’URL “Live” de l’enquête dans la langue actuelle – vous pouvez aussi ajouter un code de langue spécifique à l’URL pour cette langue
{{survey.signInUrl}}
     {{survey.signInUrl.en}}
l’URL de la page de connexion pour l’enquête dans la langue actuelle – vous pouvez aussi ajouter un code de langue spécifique à l’URL pour cette langue
{{survey.privacyNoticeUrl}}
     {{survey.privacyNoticeUrl.en}}
l’URL de l’avis de confidentialité de l’enquête dans la langue actuelle – vous pouvez aussi ajouter un code de langue spécifique à l’URL pour cette langue
{{survey.printingUrl}}
     {{survey.printingUrl.en}}
l’URL de la version imprimable de l’enquête dans la langue actuelle – vous pouvez aussi ajouter un code de langue spécifique à l’URL pour cette langue
{{survey.editUrl}}
l’URL de la page de modification des questions dans l’outil de CheckMarket
{{survey.notifications.editUrl}}
l’URL de la page de gestion des notifications dans l’outil de CheckMarket
{{notification}}
     {{notification.id}}
     {{notification.name}}
fonctionne seulement dans une notification

Notez que “Questions” est pluriel. Cela signifie qu’il s’agit d’une collection de questions dans une enquête. Mais comment trouver la question que vous cherchez ? Eh bien, il y a trois manières :

  • Numéro : utilisez le numéro de la question (ne pas recommandée)
    c’est facile à utiliser, mais moins sûr et plus susceptible de changer. Quand une question est ajoutée ou supprimée avant la question dont vous avez besoin, le numéro changera
  • ID : utilisez l’ID unique de la question
    elle ne changera jamais même si des questions sont ajoutées, supprimées ou déplacées
  • Étiquette de données : utilisez une étiquette de données (recommandée)
    comme l’ID, l’étiquette de données ne changera pas si la question est déplacée, ou si d’autres questions sont ajoutées ou supprimées – son principal avantage est que l’étiquette de données peut transmettre un sens – “questions.nps” est plus facile à lire qu’un certain nombre
VariableDescription
{{survey.questions}}
une collection de toutes les questions dans une enquête – utilisé le plus souvent dans des opérateurs “each
{{survey.questions.1}}
référencez à la question qui à le numéro de question 1
{{survey.questions.id-1}}
référencez à la question qui a l’ID 1
{{survey.questions.monEtiquette}}
référencez à la question avec l’étiquette de données “monEtiquette” (manière recommandée)
{{survey.questions.monEtiquette.id}}
l’ID de la question avec l’étiquette de données “monEtiquette”
{{survey.questions.monEtiquette.text}}
     {{survey.questions.monEtiquette.text.unformatted}}
le texte de la question dans la langue actuelle – utilisez le suffixe .unformatted pour supprimer tout le formatage
{{survey.questions.monEtiquette.questionNumber}}
le numéro de question de la question
{{survey.questions.id-1.dataLabel}}
l’étiquette de données de la question avec ID 1
{{survey.questions.monEtiquette.pageNumber}}
le numéro de la page où se trouve la question
{{survey.questions.monEtiquette.maxScore}}
le score maximum possible pour la question
{{survey.questions.monEtiquette.isHidden}}
Retourne la valeur “true” si la question est cachée – sinon il retourne “false” – utilisé souvent dans des opérateurs “if”
{{survey.questions.monEtiquette.subQuestions}}
     {{survey.questions.monEtiquette.subQuestions.1}}
     {{survey.questions.monEtiquette.subQuestions.id-123}}
la collection des sous-questions d’une matrice. Pour obtenir une sous-question spécifique vous pouvez utiliser le numéro d’ordre ou l’ID de la sous-question – si vous savez l’étiquette de données de la sous-question, vous pouvez l’utiliser directement comme une question régulière – une fois que vous arrivez à la sous-question, vous pouvez utiliser toutes les autres propriétés d’une question mentionnées dessus
{{survey.questions.monEtiquette.answerChoices}}
collection des choix de réponses de la question – vous pouvez référencer à des choix de réponses spécifiques en vous basant sur leur numéro d’ordre ou leur ID
{{survey.questions.monEtiquette.answerChoices.1.id}}
l’ID du premier choix de réponse de la question
{{survey.questions.monEtiquette.answerChoices.id-1.orderNumber}}
le numéro d’ordre du choix de réponse avec ID 1 de la question
{{survey.questions.monEtiquette.answerChoices.1.text}}
     {{survey.questions.id-1.answerChoices.1.text.unformatted}}
le texte du premier choix de réponse de la question – utilisez le suffixe .unformatted pour supprimer tout le formatage
{{survey.questions.monEtiquette.answerChoices.1.scaleValue}}
retourne la valeur d’échelle du choix de réponse – dans une échelle d’évaluation ou une matrice l’échelle de la question peut commencer de “0 (zéro)” ou elle peut être une valeur entre -3 et +3 – la valeur d’échelle retournera cette valeur – par exemple, dans une question NPS le premier choix de réponse a un numéro d’ordre de “1” mais une valeur d’échelle de “0 (zéro)” car l’échelle d’une question NPS va de 0 à 10
{{survey.questions.monEtiquette.answerChoices.1.score}}
     {{survey.questions.monEtiquette.answerChoices.1.score.percentage}}
retourne le score du premier choix de réponse de la question
{{survey.questions.monEtiquette.answerChoices.1.isNotApplicable}}
retourne “true” si le choix de réponse est une option “Non Applicable”
{{survey.questions.monEtiquette.answerChoices.1.isOther}}
retourne “true” si le choix de réponse est une option “Autre”
{{survey.questions.monEtiquette.answerChoices.1.isHidden}}
retourne “true” si le choix de réponse est caché

Obtenez les résultats de tous les répondants de l’enquête entière, d’une question, d’une sous-question ou d’un choix de réponse.

Nous recommandons vivement d’utiliser l’étiquette de données d’une question pour référencer à une question car l’étiquette de données ne change pas lorsque une enquête est modifiée, et l’étiquette clarifie le contenu de la variable.

VariableDescription
{{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}}
Le nombre total de personnes ayant répondu à l’enquête, à la question ou au choix de réponse. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.
{{survey.questions.myDataLabel.results.average}}
     {{survey.questions.myDataLabel.results.average.completed}}
La valeur d’échelle moyenne d’une question pour tous les répondants. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.
{{survey.results.averageScore}}
     {{survey.results.averageScore.completed}}

{{survey.questions.myDataLabel.results.averageScore}}
     {{survey.questions.myDataLabel.results.averageScore.completed}}
Le score moyen pour une question spécifique ou pour l’ensemble de l’enquête. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.
{{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}}
La somme de toutes les valeurs pour une question ou un choix de réponse pour tous les répondants. Cela fonctionne pour les sliders, les zones de texte avec validation numérique et les questions avec des valeurs d’échelle. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.
{{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}}
La somme de tous les résultats d’une enquête, d’une question ou d’un choix de réponse pour tous les répondants. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.
{{survey.questions.myDataLabel.results.nps}}
     {{survey.questions.myDataLabel.results.nps.completed}}
Le NPS global pour une question. Ajoutez ‘.completed’ pour ne compter que les répondants qui ont atteint la fin.

Ces variables concernent le répondant actuel.

VariableDescription
{{respondent.id}}
l’ID du répondant actuel
{{respondent.hash}}
le hash unique du répondant
{{respondent.score}}
le score total du répondant
{{respondent.score.percentage}}
le pourcentage du score du répondant au score maximum possible de l’enquête
{{respondent.dateResponded}}
la date que le répondant ait répondu à l’enquête
{{respondent.language}}
     {{respondent.language.code}}
le nom de la langue du répondant dans la langue actuelle – vous pouvez ajouter “.code” pour obtenir le code de langue au lieu du nom
{{respondent.status}}
     {{respondent.status.id}}
l’état du répondant : répondu partiellement, répondu complètement, exclu – vous pouvez ajouter “.id” pour obtenir l’ID de l’état :
  • 0 = répondu partiellement
  • 1 = répondu complètement
  • 2 = exclu
  • 3 = quota rempli
{{respondent.channel}}
     {{respondent.channel.id}}
le canal que le répondant a utilisé pour remplir l’enquête : Web, E-mail, Borne multimédia, SMS, etc. – vous pouvez ajouter “.id” pour obtenir l’ID du canal
{{respondent.browser}}
le navigateur utilisé par le répondant pour répondre à l’enquête : Google Chrome, Mozilla Firefox, etc.
{{respondent.os}}
le système d’exploitation utilisé par le répondant pour répondre à l’enquête : Windows, Android, etc.
{{respondent.reportUrl}}
     {{respondent.reportUrl.en}}
     {{respondent.reportUrl.internal}}
l’URL vers le rapport du répondant du répondant actuel – vous pouvez spécifier la langue ou ajouter ‘.internal’ afin que seuls les utilisateurs de l’outil ayant accès à l’enquête puissent voir le rapport, ce qui est souvent utilisé dans les notifications
{{respondent.ipLocation}}
     {{respondent.ipLocation.city}}
     {{respondent.ipLocation.country}}
          {{respondent.ipLocation.country.code}}
     {{respondent.ipLocation.latitude}}
     {{respondent.ipLocation.longitude}}
la localisation du répondant basée sur son adresse IP – vous pouvez ajouter “city” ou “country” pour donner juste une partie de la localisation
{{respondent.timing.totalDuration}}
le temps total (en secondes) que le répondant a passé dans l’enquête

Obtenez les réponses du répondant actuel.

Nous recommandons vivement d’utiliser l’étiquette de données d’une question pour référencer à une question car l’étiquette de données ne change pas lorsque une enquête est modifiée, et l’étiquette clarifie le contenu de la variable.

VariableDescription
{{respondent.questions}}
collection des questions auxquelles le répondant a répondu – vous pouvez référencer à une question spécifique en utilisant le numéro, l’ID ou l’étiquette de données de la question – vous pouvez aussi les parcourir en utilisant l’opérateur “each”
{{respondent.questions.1}}
la réponse du répondant à la question avec numéro 1 – s’il s’agit d’une question ouverte la variable retournera la réponse ouverte que le répondant ait tapé – si non, elle retournera le texte du choix de réponse – pour des questions avec une échelle, la valeur d’échelle – si plus d’une réponse peut être donnée, comme dans une question avec des cases à cocher, une liste délimitée par des virgules sera retournée – si le répondant n’a pas répondu à cette question la variable ne retournera rien, et elle sera remplacée par une chaîne à la longueur zéro
{{respondent.questions.id-1}}
réponse du répondant à la question avec ID 1
{{respondent.questions.monEtiquette}}
réponse du répondant à la question avec l’étiquette de données “monEtiquette” (méthode recommandée)
{{respondent.questions.monEtiquette.openAnswer}}
le texte ouvert que le répondant a tapé comme réponse
{{respondent.questions.monEtiquette.scaleValue}}
la valeur d’échelle du choix de réponse choisi par le répondant – par exemple certaines questions ont une échelle de 0 à 10 ou de -3 à +3
{{respondent.questions.monEtiquette.text}}
le texte du choix de réponse sélectionné par le répondant dans la question – si plus d’une réponse peut être donnée, comme dans une question avec des cases à cocher, une liste délimitée par des virgules sera retournée
{{respondent.questions.monEtiquette.orderNumber}}
le numéro d’ordre du choix de réponse sélectionné par le répondant dans la question
{{respondent.questions.monEtiquette.score}}
     {{respondent.questions.monEtiquette.score.percentage}}
le score obtenu par le répondant dans la question
{{respondent.questions.monEtiquette.npsType}}
le type de NPS : détracteur (0-6), passif (7-8) ou promoteur (9-10) du répondant basé sur leur réponse
{{respondent.questions.monEtiquette.subQuestions}}
la collection des réponses du répondant actuel aux sous-questions de la question matrice
{{respondent.questions.monEtiquette.subQuestions.1}}
     {{respondent.questions.monEtiquette.subQuestions.id-123}}
     {{respondent.questions.monEtiquette.subQuestions.monEtiquette2}}
Pour obtenir une sous-question spécifique vous pouvez utiliser le numéro d’ordre ou l’ID de la sous-question – si vous savez l’étiquette de données de la sous-question, vous pouvez l’utiliser directement comme une question régulière – une fois que vous arrivez à la sous-question, vous pouvez utiliser toutes les autres propriétés d’une question mentionnées ici.
{{respondent.questions.monEtiquette.answerChoices}}
la collection des réponses aux choix de réponses de la question – celle-ci est utilisée si vous souhaitez référencer à une réponse spécifique d’un répondant
{{respondent.questions.monEtiquette.answerChoices.1}}
retourne la réponse au premier choix de réponse de la question – si le répondant n’a pas sélectionné ce choix de réponse la variable ne retourne rien.
{{respondent.questions.monEtiquette.answerChoices.id-123}}
retourne la réponse au choix de réponse avec ID 123 de la question
{{respondent.questions.monEtiquette.answerChoices.nth-1}}
retourne la réponse au choix de réponse “n” sélectionné par le répondant – par exemple, si un répondant a sélectionné les choix 2 et 5 dans une question avec des cases à cocher “nth-1” sera le choix de réponse 2 et “nth-2” le choix de réponse 5
VariableDescription
{{contact.id}}
l’ID du contact actuel
{{contact.firstName}}
le prénom du contact
{{contact.lastName}}
le nom de famille du contact
{{contact.fullName}}
le prénom et le nom de famille du contact
{{contact.status}}
     {{contact.status.id}}
l’état du contact
{{contact.language}}
     {{contact.language.code}}
le nom de la langue du contact – ajoutez “code” pour obtenir le code de langue
{{contact.street}}
la rue du contact
{{contact.houseNumber}}
le numéro de maison du contact
{{contact.apartmentOrSuite}}
le numéro de l’appartement ou suite (boîte) du contact
{{contact.postalCode}}
le code postal du contact
{{contact.city}}
la localité du contact
{{contact.province}}
le province du contact
{{contact.state}}
     {{contact.state.code}}
l’état ou l’abréviation de l’état du contact
{{contact.country}}
     {{contact.country.code}}
le nom du pays ou le code du pays du contact
{{contact.email}}
l’adresse e-mail du contact
{{contact.phone}}
le numéro de téléphone du contact
{{contact.gender}}
     {{contact.gender.code}}
     {{contact.gender.isMale}}
     {{contact.gender.isFemale}}
la sexe du contact ou quelques tests qui retournent “true” ou “false”
{{contact.dateOfBirth}}
la date de naissance du contact
{{contact.isOptedOut}}
retourne “true” si le contact s’est désabonné
{{contact.isBounced}}
retourne “true” si l’adresse e-mail du contact a rebondi
{{contact.dateAdded}}
la date que le contact a été ajouté à l’enquête
{{contact.dateInvited}}
la date que le contact a été invité à l’enquête
{{contact.dateSawEmail}}
la date que le contact a vu l’invitation par e-mail ou le rappel
{{contact.dateClickedThrough}}
la date que le contact a cliqué sur le lien pour arriver à l’enquête
{{contact.dateReminded}}
la date qu’un rappel a été envoyé au contact
{{contact.dateRemindedPartial}}
la date qu’un rappel “répondu partiellement” a été envoyé au contact
{{contact.dateSecondReminder}}
la date qu’un deuxième rappel a été envoyé au contact
{{contact.dateToExpire}}
la date d’expiration de l’invitation du contact
{{contact.dateResponded}}
la date que le répondant a répondu à l’enquête
{{contact.dateSentThankYouEmail}}
la date qu’un e-mail de remerciement a été envoyé au contact
{{contact.dateToBeInvited}}
la date et le temps d’invitation du contact
{{contact.dateLastModified}}
la date et le temps que le contact a été modifié
{{contact.customFields}}
la collection de tous les champs personnalisés – utile pour des opérateurs “each”
{{contact.customFields.1}}
     {{contact.customFields.2}}
     {{contact.customFields.3}}
     ...
retourne le contenu d’un champ personnalisé – changez le “1” à la fin pour référencer aux autres champs personnalisés
{{contact.customFields.custom_field_name}}
     {{contact.customFields.custom_field_name_2}}
utilisez le nom du champ personnalisé au lieu du numéro – cela rend la variable plus lisible et compréhensible – des espaces dans le nom du champ seront remplacés par des caractères de soulignement (méthode recommandée)
{{contact.surveyUrl}}
     {{contact.surveyUrl.en}}
     {{contact.surveyUrl.languageSelection}}
     {{contact.surveyUrl.otherLanguages}}
l’URL “live” de l’enquête pour ce contact
{{contact.reportUrl}}
     {{contact.reportUrl.en}}
     {{contact.reportUrl.internal}}
l’URL vers le rapport du répondant pour ce contact – vous pouvez spécifier la langue ou ajouter .internal’ afin que seul les utilisateurs de l’outil ayant accès à l’enquête peuvent voir le rapport, ce qui est souvent utilisé dans des notifications
{{contact.optOutUrl}}
     {{contact.optOutUrl.en}}
l’URL de la page de désinscription de ce contact
{{contact.showEmailInBrowserUrl}}
     {{contact.showEmailInBrowserUrl.en}}
l’URL pour montrer l’invitation par e-mail dans le navigateur
VariableDescription
{{querystring.parameterName}}
     {{querystring.q1}}
     ...
la valeur d’un paramètre dans la chaîne de requête de l’URL de l’enquête
{{currentDate}}
     {{currentDate.date}}
     {{currentDate.time}}
     {{currentDate.utc}}
     {{currentDate.iso}}
la date actuelle, y compris l’heure – vous pouvez optionnellement sélectionner uniquement la date ou l’heure.

également disponible: la date en temps universel coordonné (UTC) et la date au format conforme à ISO 8601

remarque : toutes ces propriétés de date sont également disponibles pour toute autre date (par exemple, respondent.dateResponded)

Besoin d’aide ?

Notre langage de script CheckMarket offre d’énormes possibilités qui ne peuvent bien entendu pas toutes être couvertes gratuitement par notre service d’assistance. L’utilisation de notre langage de script (CSL) par vous-même est incluse dans toutes nos formules de prix et nous offrons des services de consultation par un spécialiste aux clients qui en ont besoin.

Voulez-vous créer des enquêtes / rapports avancés, mais le temps vous manque ? Laissez l’un de nos responsables de projet faire la rédaction pour vous !

Demandez une offre

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.