Skip to content

Commit

Permalink
add roundabout control doc + VAS on aggr op
Browse files Browse the repository at this point in the history
  • Loading branch information
JulienCarmona committed Dec 16, 2024
1 parent 30a708d commit 762174e
Show file tree
Hide file tree
Showing 4 changed files with 47 additions and 7 deletions.
4 changes: 2 additions & 2 deletions bowiedocs/docs/1._Pogues/Le guide/24-boucles.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,13 @@ Pour créer une boucle liée, je remplis :

## Portée des variables

Les variables calculées ou externes possédent un paramètre de _Portée_. A quoi cela correspond-il ?
Les variables calculées ou externes possèdent un paramètre de _Portée_. A quoi cela correspond-il ?

Il s'agit de préciser si une variable est calculée ou injectée (dans le cas d'une variable externe) au sein d'une boucle.

Imaginons une boucle `B1` sur un ensemble de questions relatives à des individus. Je veux pouvoir pour chacun d'eux créer une indicatrice permettant de savoir si l'individu est dans le champs en vérifiant son âge (variable collectée `AGE`) et sa nationalité (`NATIONALITE`).

Pour cela, je crée une variable calculée `INDICATRICE` de portée `B1` dont la formule s'appuie pour chaque occurence de la boucle (chaque individu) sur les variables `AGE` et `NATIONALITE` (de chaque individu).
Pour cela, je crée une variable calculée `INDICATRICE` de portée `B1` dont la formule s'appuie pour chaque occurrence de la boucle (chaque individu) sur les variables `AGE` et `NATIONALITE` (de chaque individu).

![Variable avec portée boucle](../../img/pogues/guide-boucle-portee.png)

Expand Down
30 changes: 28 additions & 2 deletions bowiedocs/docs/1._Pogues/Le guide/27-rond-point.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,37 @@ donnera ce visuel:

![Visuel d'un libellé pour un item du Rond-point](../../img/pogues/rond-point-web-libelle.png)

#### Usage des contrôles

Comme pour les questions, il est possible de définir des contrôles sur un rond point.
Ces contrôles peuvent être à un niveau `rond-point` ou `occurrence`.

#### Niveau `rond-point` :

Le contrôle considère les variables avec un niveau questionnaire : les variables de portée/niveau boucle sont considérés comme des vecteurs. (Ex: `PRENOMS = ["prénom1", "prénom2", "prénom3",...]`)

**Ex de contrôle :** `sum($SALAIRE$) > 10000` avec pour message "La somme des salaires de votre ménage dépasse 10 000 euros."
et ici `SALAIRE = [2900, 3500, 5000]`

#### Niveau `occurrence` :

- Le contrôle considère les variables avec un niveau boucle (la même boucle qui est lié au rond point) : les contrôle s'applique sur **chaque** occurrence !

**Ex de contrôle :** `AGE > 35` avec pour message "L'individu x a plus de 35 ans."
et ici `AGE = [40, 30, 50]` <br>
Le contrôle apparaîtra donc 2 fois, 1 fois pour ind1 (40) et une fois pour ind3(50).

???+ example "Affichage de contrôles sur un rond-point"

![controles sur un rond-point](../../img/pogues/control-ront-point.png)

### Dans le questionnaire web

!!!warning

Le Rond-point est uniquement disponible pour les questionnaires web avec Stromae DSFR. Il n'est pas supporté par les autres visualisations dont les questionnaires enquêteurs
Le Rond-point est uniquement disponible pour les questionnaires web. Il n'est pas supporté par les autres visualisations dont les questionnaires enquêteurs

Voici une vue du Rond-point dans Stromae DSFR:
Voici une vue du Rond-point :

![Anatomie du Rond-point dans Stromae DSFR](../../img/pogues/rond-point-web-anatomie.png)

Expand All @@ -72,3 +96,5 @@ Le bouton en `4.` a le comportement suivant:
- s'il est achevé, "Modifier".

Enfin, on voit que le sous-questionnaire de Charlie n'existe pas car nous avons appliqué un filtre grâce au champ _Sauf_ (voir plus haut).

##
20 changes: 17 additions & 3 deletions bowiedocs/docs/SAV/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Problèmes les plus fréquents

## Souci de génération : à la visualisation depuis Pogues, un message "Une erreur a été rencontrée"
## **Souci de génération : à la visualisation depuis Pogues, un message "Une erreur a été rencontrée"**

Tenter de générer le questionnaire séquence par séquence

- si une séquence pose souci, descendre sous-séquence par sous-séquence, voire question par question et identifier la question qui pose souci.
- si toutes les séquences se génèrent, il y a probablement un problème de boucles ou de doublons. En effet, des listes (dans les QCM ou QCU) peuvent avoir le même nom, notamment pour les questionnaires qui font appel à la composition.

## Affichage à tort de questions filtrées
## **Affichage à tort de questions filtrées**
Principe général : si un filtre ne se valorise pas ou pas bien, la question est affichée donc si la question s'affiche "à tort", le filtre est probablement faux.

Contrôler le filtre :
Expand All @@ -16,5 +16,19 @@ Contrôler le filtre :
- ajouter des déclarations contenant les variables impliquées dans le filtre afin de contrôler leurs valeurs


### (Non)Affichage des déclarations
## **(Non)Affichage des déclarations**
Les déclarations s'affichent en fonction des modes décrits dans Pogues : pas de mode, pas d'affichage et réciproquement si pas d'affichage, il manque probablement le mode

## **VTL avec opérations d’agrégation**
Dans le cas où l'on veut définir une expression VTL **faisant des opérations sur les éléments d'une variable vecteur**, hors d'un tableau ou d'une boucle (à un niveau questionnaire), il faut passer par une variable calculée, sinon **le VTL est en erreur**

??? example "Exemple avec un contrôle"
Prenons une variable `SALAIRE` qui est collecté dans une boucle de 4 occurrences. <br>
À la fin de la boucle, on a : `SALAIRE=[2500, 1300, 2000, 4000]`.<br>
Si on veut faire un contrôle sur la somme des salaires, il faut d'abord **créer une variable calculée** `SUM_SALAIRE=sum($SALAIRE$)` de niveau questionnaire, puis définir un contrôle avec cette dernière.

Expression VTL du contrôle | Affichage du contrôle
-- | --
`sum($SALAIRE$) > 5000` | :x:
`$SUM_SALAIRE$ > 5000` | :white_check_mark:

Binary file added bowiedocs/docs/img/pogues/control-ront-point.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 762174e

Please sign in to comment.