Add files via upload

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.

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.

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")