Cet article traite du format des variables et ce que vous pouvez en faire. Si vous souhaitez en savoir plus sur où utiliser vos variables consultez cet article.
Oktave vous permet de jouer avec le contenu des vos créations grâce aux variables.
Mais ces variables sont plus puissantes que vous le pensez.
Le format d'une variable
$$[_DECORATEUR:]VARIABLE[:VALEUR]$$
Une variable est définie par ses bornes "$$" ce qui forme "l'enveloppe".
Elle se compose de 3 éléments dont 2 optionnels (entre crochet pour l'illustration)
le décorateur [_DECORATEUR:], qui vous permet d'agir sur le contenu de la variable (majuscule, minuscule ...)
le nom de la variable VARIABLE
la valeur par défaut [:VALEUR]
Les décorateurs
Ce composant de variable vous permet d'agir sur le contenu à afficher. Il existe différents décorateurs qui sont :
_TITLE : Fonction titre, qui permet de forcer le contenu de la variable en minuscule avec la première lettre en majuscule.
_UPPER : Fonction majuscule, qui permet de forcer tout le contenu de la variable en majuscule.
_LOWER : Fonction minuscule, qui permet de forcer tout le contenu de la variable en minuscule.
_URL : Fonction URL, qui permet de forcer tout le contenu de la variable afin que celle-ci puisse être utilisée dans une URL.
Exemple :
Les exemples suivants utiliseront la variable VAR avec le contenu : "Oktave Questionnaires en ligne"
$$_TITLE:VAR$$ = "Oktave questionnaires en ligne"
$$_UPPER:VAR$$ = "OKTAVE QUESTIONNAIRES EN LIGNE"
$$_LOWER:VAR$$ = "oktave questionnaires en ligne"
$$_URL:VAR$$ = "Oktave+Questionnaires+en+ligne"
Notez qu'il n'est pas possible de multiplier les décorateurs dans une même "enveloppe", ainsi $$_UPPER:_URL:VAR$$ n'est pas correcte.
La variable
La variable est mot représentant la donnée fournie comme "nom", "prenom" ...
Elle est définie avec des lettres (sans accent), des chiffres et éventuellement un underscore ("tiret du bas").
Elle ne peut commencer que par une lettre.
Exemple:
prenom : Valide
prenom2 : Valide
_prenom : Invalide
contact_id : Valide
contact-id : Invalide
La valeur (par défaut)
Cette valeur est utilisée si la variable ne contient pas de variable.
Elle s'écrit directement après le nom de la variable suivi du séparateur ":".
Par exemple vous avez pour vos contacts lors d'un envoi email une colonne "nom client" qui sera affecté à la variable "nm_client".
Si dans votre contenu vous utilisez la variable comme ceci : "Bonjour $$nm_client$$," et que votre contact n'a pas de nom dans votre fichier le résultat sera le suivant "Bonjour ,".
Or si vous utilisez une variable par défaut alors l'exemple précédent deviendrait :
"Bonjour $$nm_client:Madame, Monsieur$$," = "Bonjour Madame, Monsieur,"
Pour les clients ayant un nom exemple "Mr Dupont" alors :
"Bonjour $$nm_client:Madame, Monsieur$$," = "Bonjour Mr Dupont,"
Notez que les valeurs renseignées en tant que valeur par défaut sont libres.
Les variables systèmes
Ces variables sont utilisées à différents endroits tels que les alertes, les partages SMS ... Elles permettent d'utiliser des données qui ne sont pas gérées directement par l'utilisateur.
On retrouve par exemple _SURVEY_URL pour afficher l'URL du questionnaire dans un partage SMS. Ou encore _ANSWER:X qui permet d'afficher le contenu d'une réponse via son numéro dans le questionnaire (exprimé par X ici).
Ces variables systèmes s'utilisent comme ceci $$_VAR_SYSTEM$$, elles n'acceptent ni décorateur, ni valeur par défaut.
Exemples d'utilisation:
$$_TITLE:EVENEMENT$$
https://mon-url-de-redirection.fr?clientID=$$_URL:client_id$$
Un client vous a donné la note de $$_ANWSER:3$$ (ou 3 est la 3ème question du questionnaire)
Bonjour $$nm_client:Madame, Monsieur$$,