From 1be2d5843e65a66ac324efc0e9c1c790f74e6939 Mon Sep 17 00:00:00 2001 From: Anne Husseini-Skalitz <71011059+AnneHuSKa@users.noreply.github.com> Date: Fri, 31 May 2024 16:20:54 +0200 Subject: [PATCH] Add files via upload --- .../Variables - divers/1-generer-variables.md | 9 ++++++ .../Variables - divers/nommage.md | 28 +++++++++++++++++++ .../Variables - divers/variables-externes.md | 24 ++++++++++++++++ 3 files changed, 61 insertions(+) create mode 100644 bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/1-generer-variables.md create mode 100644 bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/nommage.md create mode 100644 bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/variables-externes.md diff --git a/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/1-generer-variables.md b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/1-generer-variables.md new file mode 100644 index 00000000..8ef3f6e5 --- /dev/null +++ b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/1-generer-variables.md @@ -0,0 +1,9 @@ +# Générer les variables collectées + +Pour toute question créée, il faut générer les variables collectées : aller dans l'onglet "Variables collectées", cliquer sur le bouton "Générer les variables collectées" et modifier les libellés et identifiants proposés par défaut par l'application par un libellé signifiant (penser à vos successeurs) et l'identifiant métier de la ou des variables collectées. + +**Dans le cas où certaines cellules d'un tableau ou d'une question à choix multiples ne sont pas à collecter car sans objet ou destinées par exemple à rappeler un total calculé, collecté ou en dur (par exemple 100%), décocher pour chaque cellule concernée le booléen Collectée associée à la variable collectée ad hoc.** + +Au fur et à mesure de vos modifications, cliquer sur le bouton "Valider" affiché le plus haut et le plus à droite de votre écran (en bas à droite de l'écran grisé). + +A la fin de vos modifications, cliquer sur le bouton "Valider" au milieu un peu plus bas dans la partie blanche de l'écran pour valider l'ensemble de vos modifications. diff --git a/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/nommage.md b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/nommage.md new file mode 100644 index 00000000..65b5b56f --- /dev/null +++ b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/nommage.md @@ -0,0 +1,28 @@ +# Nommage des variables + +Une convention simple doit être appliquée pour le nommage des variables dans Pogues : + +- on utilise des lettres simples en majuscule et des chiffres, +- on sépare les sections du nom par des tirets bas `_`, +- on n'utilise aucun espace. + +Des exemples de bon usage : + +```vtl +AGE + +PROFESSION_CONJOINT + +ACTIVITES_1 +``` + +Par ailleurs, lorsqu'elles sont utilisées dans du code VTL, les noms des variables sont encadrés par des `$`. Par exemple, une variable nommée dans Pogues `AGE`, sera mobilisée en VTL par `$AGE$`. + +!!!note "Plus de contraintes en VTL" + + À la convention de nommage décrite plus haut il faut ajouter les contraintes mêmes du langage VTL: + + - un nom peut contenir des caractères alphanumériques et des `_` (**mais pas des** `-`), + - il ne peut débuter avec un caractère spécial, + - doit contenir au moins un caractère alphabétique, + - ne peut être un mot réservé de VTL. diff --git a/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/variables-externes.md b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/variables-externes.md new file mode 100644 index 00000000..bcf7b97d --- /dev/null +++ b/bowiedocs/docs/pogues/Quelques cas pratiques/Variables - divers/variables-externes.md @@ -0,0 +1,24 @@ +# Les variables externes + +Pogues permet de référencer dans le questionnaire des variables externes, c'est à dire des variables qui sont fournies au chargement du questionnaire lors de la collecte, en provenance d'un fichier de données produit à partir de données connues et attachées à l'unité enquêtée. + +Si le _typage_ disponible dans Pogues pour ces variables est celui disponible par ailleurs pour les variables collectées et calculées, on n'a en fait pas le choix : l'ensemble des variables externes injectées dans le questionnaire sont du __texte__. + +L'impact : si ces variables doivent être utilisées comme numériques, il faut alors [les transformer](../../guide/vtl.md#transtypage). Par exemple : + +```vtl +cast($VAR_EXT$, integer) +``` + +## Ajouter des variables externes de portée Boucle + +Dans certains protocoles complexes, on peut vouloir intégrer des variables externes correspondant à des variables collectées précédemement dans un autre questionnaire à l'intérieur d'une boucle. + +Imaginons par exemple que dans le premier questionnaire, on ait demandé le nombre d'habitants du logement (variable `NBHAB`), puis, à l'intérieur d'une boucle répétée pour chaque habitant on ait collecté les prénoms et ages (respectivement les variables `PRENOM` et `AGE`). + +Afin de récupérer ces variables dans le second questionnaire : + +- je crée dans celui-ci la boucle `BOUCLE_PRINCIPALE`, avec un min et max dont la valeur est la variable `NBHAB` (à créer, voir ci-dessous), +- je crée les variables externes `NBHAB` (Portée Questionnaire), `PRENOM` et `AGE` (portée `BOUCLE_PRINCIPALE`). + +Il faudra ensuite fournir à l'intégration un fichier CSV contenant les variables et valeurs ad hoc (voir [ici](../../../public-enemy/guide/1-guide-pe-echantillon.md), section "Variables de portée Boucle")