From 12c49717f56aae758e09b9a6d524125bd8423b93 Mon Sep 17 00:00:00 2001 From: Anne Husseini-Skalitz <71011059+AnneHuSKa@users.noreply.github.com> Date: Mon, 3 Jun 2024 17:27:32 +0200 Subject: [PATCH] Delete bowiedocs/docs/pogues/tutoriel directory --- .../tutoriel/10-creation-questionnaire.md | 53 ------------ .../tutoriel/11-creation-premiere-sequence.md | 82 ------------------- .../12-visualisation-questionnaire.md | 23 ------ .../pogues/tutoriel/13-creation-liste-qcu.md | 29 ------- .../tutoriel/14-elaboration-structure.md | 16 ---- .../pogues/tutoriel/15-creation-tableau.md | 39 --------- .../docs/pogues/tutoriel/16-creation-qcm.md | 12 --- .../tutoriel/17-finalisation-structure.md | 21 ----- .../tutoriel/20-mise-en-place-filtre.md | 43 ---------- .../docs/pogues/tutoriel/21-ajout-controle.md | 45 ---------- .../pogues/tutoriel/22-ajout-infobulle.md | 18 ---- .../23-utilisation-variable-calculee.md | 56 ------------- .../tutoriel/24-personnalisation-libelle.md | 26 ------ .../tutoriel/25-mise-en-place-boucle.md | 38 --------- bowiedocs/docs/pogues/tutoriel/index.md | 17 ---- 15 files changed, 518 deletions(-) delete mode 100644 bowiedocs/docs/pogues/tutoriel/10-creation-questionnaire.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/11-creation-premiere-sequence.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/12-visualisation-questionnaire.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/13-creation-liste-qcu.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/14-elaboration-structure.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/15-creation-tableau.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/16-creation-qcm.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/17-finalisation-structure.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/20-mise-en-place-filtre.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/21-ajout-controle.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/22-ajout-infobulle.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/23-utilisation-variable-calculee.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/24-personnalisation-libelle.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/25-mise-en-place-boucle.md delete mode 100644 bowiedocs/docs/pogues/tutoriel/index.md diff --git a/bowiedocs/docs/pogues/tutoriel/10-creation-questionnaire.md b/bowiedocs/docs/pogues/tutoriel/10-creation-questionnaire.md deleted file mode 100644 index e31c4aa9..00000000 --- a/bowiedocs/docs/pogues/tutoriel/10-creation-questionnaire.md +++ /dev/null @@ -1,53 +0,0 @@ -# Création d'un questionnaire - -Sur la page d'accueil de Pogues, le bouton suivant est visible : - -![Bouton de création d'un questionnaire](../../img/pogues/creation-questionnaire-go.png) - -En cliquant sur le bouton, on ouvre la fenêtre de création du questionnaire. Celle-ci permet de renseigner les informations de classement du questionnaire dans un processus statistique et les paramètres importants au fonctionnement du questionnaire lui-même. - -!!! note - - Il est possible qu'à terme les informations relatives au contexte statistique du questionnaire ne soient pas conservées ici mais dans d'autres outils de pilotage du processus d'enquête. - -## Information sur le processus - -Les champs "Série", "Opération statistique" et "Campagne" sont remplis en fonction de l'enquête correspondante. C'est un processus spécifique au contexte Insee, on ne le détaille pas ici. - -!!! tip - - Si vous êtes en train de vous autoformer, vous pouvez choisir n'importe quelles valeurs, cela n'a pas d'impact sur le reste du questionnaire - -## Identification - -Il faut donner un "Titre" et un "Identifiant" au questionnaire. Par défaut, un identifiant sera créé à partir du titre du questionnaire, vous pouvez le modifier. - -!!! tip - - Par convention, les identifiants des éléments du questionnaire (séquences, boucles, variables, etc.) seront écrits sous la forme `MON_IDENTIFIANT` - -## Modes - -Quatre modes de collecte sont disponibles : - -- CAPI, pour les enquêtes en face-à-face par l'intermédiaire d'un enquêteur -- CATI, pour les enquêtes par téléphone -- CAWI, pour les enquêtes via Internet -- PAPI, pour les enquêtes au format papier - -!!! note - - Actuellement, l'impact sur les questionnaires mêmes est mince : seule les déclarations (aide à la saisie, consigne enquêteur) sont affichées ou non selon leur mode de collecte. - -## Dynamisme - -!!! warning - - Les options "Redirection" et "XPath" sont en cours d'obsolescence et seront bientôt supprimées. - -Les dernières options permettent de définir les aspects dynamiques du parcours du questionnaire : - -- la gestion de l'affichage ou non des objets ("Redirection" ou "Filtre") -- le langage utilisé pour les contrôles, filtres, calculs de variables ("XPath" ou "VTL") - -Pour ce tutoriel, nous choisissons "Filtre" et "VTL". diff --git a/bowiedocs/docs/pogues/tutoriel/11-creation-premiere-sequence.md b/bowiedocs/docs/pogues/tutoriel/11-creation-premiere-sequence.md deleted file mode 100644 index 70ef1165..00000000 --- a/bowiedocs/docs/pogues/tutoriel/11-creation-premiere-sequence.md +++ /dev/null @@ -1,82 +0,0 @@ -# Création d'une première séquence - -Une fois le questionnaire créé, on arrive sur la vue d'ensemble (dite _vue structurelle_) du questionnaire. - -Celui-ci est vide, donnons-lui du contenu ! :smile: - -!!! tip - - Un questionnaire est composé de séquences, sous-séquences et questions. Les possibilités d'articulation sont les suivantes : - - ``` - |-séquence - |-- question - |-- sous-séquence - |--- question - ``` - - Un questionnaire doit contenir au moins une séquence et une question. - - Une séquence contient des questions ou / et des sous-séquences. Une sous-séquence peut contenir des questions. - -## Création de la séquence - -Pour créer la première séquence, il suffit de cliquer sur le bouton "+ Séquence" de la barre d'actions : - -![Création d'une séquence](../../img/pogues/barre-actions-sequence.png) - -Dans la fenêtre modale qui s'ouvre, on remplit deux champs : - -- _Libellé_ avec le titre "Participation au questionnaire" -- _Identifiant_ que l'on modifie pour qu'il soit "MODULE1" - -Les modes de collecte restent les mêmes que ceux du questionnaire. - -Pour finaliser la création, on appuie sur le bouton "Valider" en bas de la fenêtre : - -![Valider la séquence](../../img/pogues/creation-sequence-valider.png) - -![Barre d'actions](../../img/pogues/barre-actions.png) - -## Création d'une question - -Dans la barre des actions, le bouton "+ Question" permet la création d'une question. - -### Identification - -Dans la fenêtre modale qui apparaît : - -- _Libellé_ "Souhaitez-vous répondre à ce questionnaire ?" -- _Identifiant_ "OKREP" - -### Format de réponse - -Pogues propose plusieurs formats de réponse qui peuvent être ensuite paramétrés. - -Dans l'onglet "Format des réponses", on choisit comme _Type de question_ "Réponse simple" et _Type de réponse_ "Texte", ce qui va permettre de créer un champ de réponse textuel. - -On revient dans la section suivante sur le détail des options, mais terminons d'abord la création de cette première question. - -Pour cela, il reste une dernière étape, la création de la variable sous-jacente. - -### Création de la variable - -Pogues distingue la question de la réponse et de la donnée collectée - la variable. Il faut donc explicitement créer cette dernière. - -Pour cela, on se dirige vers l'onglet "Variables collectées" puis on clique sur le bouton "Générer variables collectées". - -On peut enfin valider la question en cliquant sur le plus gros bouton "Valider" en bas de la fenêtre. - -!!! Note - - Lorsque vous validez une question, une fenêtre peut apparaître avec le texte "Modifications non validées. Merci de valider toutes les actions sur l'élément.". - - Cela signifie tout simplement que certains champs à l'intérieur de la question n'ont pas été explicitement validés (à l'aide d'un bouton de validation dédié). - - Si vous êtes sûr du contenu de ces éléments, vous pouvez tout simplement cliquer sur _Valider en l'état_, l'ensemble de ce que vous avez saisi sera sauvegardé. - -## Sauvegarde du questionnaire - -Nous disposons maintenant d'un questionnaire simple, contenant une séquence et une question, il est temps de :material-content-save: __sauvegarder__ ! - -Un simple clic sur le bouton "Sauvegarder" de la barre d'action fait l'affaire. diff --git a/bowiedocs/docs/pogues/tutoriel/12-visualisation-questionnaire.md b/bowiedocs/docs/pogues/tutoriel/12-visualisation-questionnaire.md deleted file mode 100644 index a78f3602..00000000 --- a/bowiedocs/docs/pogues/tutoriel/12-visualisation-questionnaire.md +++ /dev/null @@ -1,23 +0,0 @@ -# Visualisation du questionnaire - -La promesse de Pogues c'est de permettre la visualisation rapide du questionnaire, dans des modes différents. - -Pour cela, en cliquant sur le bouton "Visualiser", on choisit le type de questionnaire que l'on veut générer. - -![Choix des visualisations](../../img/pogues/visualisation-choix.png) - -Pour cette première fois, on choisit l'option "Web V2". - -!!! note - - Pour des raisons historiques, on a aujourd'hui deux cibles de génération pour un questionnaire web. Cependant, "Web V1" disparaîtra avec la mise en place d'une filière unique de collecte. - -Après quelques secondes de création, le questionnaire _web_ est ouvert dans un nouvel onglet du navigateur. - -!!! info - - La version du questionnaire ainsi générée est très proche du rendu final mais ne dispose pas de toutes les fonctionnalités d'un questionnaire complètement intégré à la plateforme de collecte. - -Vous pouvez vérifier que le questionnaire produit est fidèle à la conception faite dans Pogues. - -Nous venons de boucler un premier cycle de conception / visualisation / validation :material-recycle: . \ No newline at end of file diff --git a/bowiedocs/docs/pogues/tutoriel/13-creation-liste-qcu.md b/bowiedocs/docs/pogues/tutoriel/13-creation-liste-qcu.md deleted file mode 100644 index 8ad66a5f..00000000 --- a/bowiedocs/docs/pogues/tutoriel/13-creation-liste-qcu.md +++ /dev/null @@ -1,29 +0,0 @@ -# Création d'une réponse basée sur une liste - -Dans notre première version de la question "OKREP", nous avons choisi comme format de réponse un champ textuel. Après coup, il semble préférable de fournir une liste fermée de réponse - "Oui" ou "Non". - -Pour modifier la question, il faut sélectionner l'élément qui matérialise cette dernière puis cliquer sur le bouton "Voir le détail" : - -![Modifier une question](../../img/pogues/modification-question-okrep.png) - -## Création d'une liste - -Modifions dans l'onglet "Format des réponses" le _Type de question_ pour choisir "Réponse à choix unique". - -On garde l'option "Créer une liste", puis on donne un nom à la liste que l'on va créer, par exemple "LISTE_OUI_NON" (champ _Nouvelle liste de code_). - -![Création liste](../../img/pogues/qcu-creation-liste.png) - -## Ajout de modalités - -Sous le champ _Nouvelle liste de code_ on trouve les modalités de la liste. Pour l'instant, cette liste est vide, créons une nouvelle modalité : - -- en cliquant sur "+ Ajouter un code" -- dans le champ qui apparaît, en renseignant "1" pour le code de la modalité et "Oui" pour le libellé. -- même chose avec le code "2" et le libellé "Non". - -![Création modalité](../../img/pogues/qcu-creation-modalite.png) - -## Finalisation - -Nous avons modifié le format de la réponse, il est donc nécessaire [de générer une nouvelle fois la variable sous-jacente](../2-creation-premiere-sequence/#creation-de-la-variable) qui a changé de nature. \ No newline at end of file diff --git a/bowiedocs/docs/pogues/tutoriel/14-elaboration-structure.md b/bowiedocs/docs/pogues/tutoriel/14-elaboration-structure.md deleted file mode 100644 index 1edf6971..00000000 --- a/bowiedocs/docs/pogues/tutoriel/14-elaboration-structure.md +++ /dev/null @@ -1,16 +0,0 @@ -# Élaboration de la structure du questionnaire - -Nous poursuivons la construction du questionnaire avec une nouvelle séquence [comme précédemment](../2-creation-premiere-sequence/#creation-de-la-sequence) dont : - -- le libellé est "En savoir plus sur vous", -- l'identifiant est "MODULE2". - -Nous créons ensuite une première question dans cette séquence : - -- avec le libellé "Quel est votre prénom ?" -- et l'identifiant "PRENOM" -- et un type de réponse simple textuelle comme ci-dessous :point_down:. - -![Question simple textuelle](../../img/pogues/question-simple-texte.png) - -Pour la question suivante, nous allons créer un tableau. diff --git a/bowiedocs/docs/pogues/tutoriel/15-creation-tableau.md b/bowiedocs/docs/pogues/tutoriel/15-creation-tableau.md deleted file mode 100644 index 35be24d5..00000000 --- a/bowiedocs/docs/pogues/tutoriel/15-creation-tableau.md +++ /dev/null @@ -1,39 +0,0 @@ -# Création d'un tableau - -La prochaine question se présente sous la forme d'un tableau dans lequel nous allons capter la ventilation des activités de la personne que l'on interroge. - -Créons la question avec : - -- le libellé "Quel pourcentage de votre temps de travail consacrez-vous en moyenne à ces différentes activités ?", -- et l'identifiant "ACTIVITES". - -Nous choisissons ensuite le type de question "Tableau". - -## Définition des lignes - -Le choix suivant du format de l'axe principal va permettre de déterminer le type de tableau que l'on va construire : - -- _Liste_ → pour la création d'un tableau dynamique, c'est à dire d'un tableau dont le nombre de lignes min et max est déterminé par des entiers numériques, -- _Liste de codes_ → pour la création d'un tableau disposant d'entêtes de lignes créés à partir d'une liste de code. - -Ici, on choisit le format "Liste de codes". - -![Tableau axe principal](../../img/pogues/tableau-axe-principal.png) - -On [charge la liste de code](../guide/liste-de-code/#chargement-a-partir-dun-fichier-csv) à partir du fichier ["entreprises-activites.csv"](../../data/entreprises-activites.csv). - -## Définition des colonnes - -Pour créer les colonnes du tableau, rendez-vous un peu plus bas dans la section "Information mesurée". Ici, nous souhaitons créer une colonne pour collecter le pourcentage de temps de travail alloué à chacune des activités de la liste. - -On remplit donc le _Libellé de l'information mesurée_ avec "Pourcentage de votre temps de travail moyen" (ce sera le titre de la colonne), puis l'on choisit : - -- _Type de mesure_ "Réponse simple" -- _Type de réponse_ "Nombre" avec un min à 0 et un max à 100 -- _Unité de mesure_ "%" - -Puis on valide. - -![Tableau colonne](../../img/pogues/tableau-colonne.png) - -Il ne reste qu'à générer les variables puis à valider la question. diff --git a/bowiedocs/docs/pogues/tutoriel/16-creation-qcm.md b/bowiedocs/docs/pogues/tutoriel/16-creation-qcm.md deleted file mode 100644 index 25878d05..00000000 --- a/bowiedocs/docs/pogues/tutoriel/16-creation-qcm.md +++ /dev/null @@ -1,12 +0,0 @@ -# Création d'une question à choix multiples - -La prochaine question sera à choix multiples. Pour cela : - -- on crée une question avec le libellé "Avez-vous déjà exercé les activités suivantes au sein de votre carrière ?" et l'identifiant "CARRIERE" -- le _Type de question_ est "Réponse à choix multiple" -- dont la réponse est basée sur une liste de code ["metiers.csv"](../../data/metiers.csv) -- pour la _Représentation des réponse_ on garde le choix par défaut "Booléen". - -!!! note - - La génération des variables ici va générer autant de variables _booléennes_ (vrai / faux) que d'éléments de la liste de codes. \ No newline at end of file diff --git a/bowiedocs/docs/pogues/tutoriel/17-finalisation-structure.md b/bowiedocs/docs/pogues/tutoriel/17-finalisation-structure.md deleted file mode 100644 index 2f238925..00000000 --- a/bowiedocs/docs/pogues/tutoriel/17-finalisation-structure.md +++ /dev/null @@ -1,21 +0,0 @@ -# Finalisation de la structure du questionnaire - -À partir des fonctionnalités vues dans les précédentes section de ce tutoriel, nous sommes capables de continuer la création de la structure du questionnaire suivant le schéma suivant :point_down:. - -| Type de structure | Description | Réalisation | -| ----------------- |:-------------------------------------------------------------------------------------------------------------------------- |:---------------- | -| Séquence | MODULE1 - "Participation au questionnaire" | :material-check: | -| Question | OKREP - "Souhaitez-vous répondre à ce questionnaire ?" - QCU Oui-Non | :material-check: | -| Séquence | MODULE2 - "En savoir plus sur vous" | :material-check: | -| Question | PRENOM - "Quel est votre prénom ?" - Texte 30 | :material-check: | -| Question | ACTIVITES - "Quel pourcentage de votre temps de travail consacrez-vous en moyenne à ces différentes activités ?" - Tableau | :material-check: | -| Question | CARRIERE - "Avez-vous déjà exercé les activités suivantes au sein de votre carrière ?" - QCM | :material-check: | -| Question | COMBIEN_QUESTIONS - "Combien de questions souhaitez-vous spécifier dans Pogues ?" - Nombre [0-200] | | -| Question | COMBIEN_PARTAGE - "Combien de personnes partagent votre bureau ?" - Nombre [0-10] | | -| Sous-Séquence | COLLEGUE - "Parlez-nous de votre collège" | | -| Question | TEMPS_PARTIEL - "Votre collègue est-il à temps partiel ?" - QCU Oui-Non | | -| Question | COLLABORATION - "Votre collègue travaille-t-il régulièrement avec vous ?" - QCU Oui-Non | | -| Séquence | MODULE3 - "Votre questionnaire" | | -| Question | DEBUT_TRAVAIL - "A quelle date avez-vous commencé à travailler" - Date [AAAA-MM-JJ - 1980-01-01 - 2022-01-01] | | -| Séquence | MODULE4 - "Avis sur l'exercice" | | -| Question | APPRECIATION - "Avez-vous apprécié l'exercice ?" - QCU Oui-Non | | diff --git a/bowiedocs/docs/pogues/tutoriel/20-mise-en-place-filtre.md b/bowiedocs/docs/pogues/tutoriel/20-mise-en-place-filtre.md deleted file mode 100644 index b4d546d4..00000000 --- a/bowiedocs/docs/pogues/tutoriel/20-mise-en-place-filtre.md +++ /dev/null @@ -1,43 +0,0 @@ -# Mise en place d'un filtre - -!!!note - - À partir de cette section, il est utile de s'être familiarisé avec VTL en parcourant [le guide dédié](../guide/vtl.md) et le consultant régulièrement. - -L'utilisation de filtres permet de déterminer l'affichage (ou non) d'une ou plusieurs séquences, sous-séquences ou questions. - -Pour cela, nous allons nous appuyer sur la fonctionnalité "Filtre" de Pogues mais aussi sur le langage VTL pour l'expression de la condition. - -Pour créer un filtre, il suffit de cliquer sur le bouton "+ Filtre" dans la barre d'action. La fenêtre modale qui s'ouvre affiche les champs : - -- _Description_ : un libellé qui sera visible sur le questionnaire papier et remplacera le filtre dynamique des questionnaires web ou enquêteur -- _Condition d'affichage_ : l'expression VTL qui si elle est __vraie__ déclenche l'affichage des éléments filtrés -- _Début_ : détermine où commence la couverture du filtre -- _Fin_ : détermine où termine la couverture du filtre. - -Le cas d'usage dans le cadre de ce tutoriel est l'affichage des modules (ou séquences) qui suivent la première question (["Souhaitez-vous répondre à ce questionnaire ?"](11-creation-premiere-sequence.md#création-dune-question)). On veut donc s'assurer que la variable associée à cette question (`OKREP`) à la bonne valeur (`"1"` ici qui est le code associé à la modalité "Oui"). - -Notre condition d'affichage est donc : - - ```vtl - $OKREP$ = "1" - ``` - -!!!tip - - Bien noter ici : - - - la variable est entourée du caractère `$` - - le code est bien du texte, il faut l'entourer par le caractère `"` - -!!!note - - En toute logique, le filtre que l'on est en train de créer va masquer les éléments choisis dès que la variable `OKREP` aura une valeur différente de "1" :nerd: - -Il nous reste à préciser que le filtre à pour champ d'action les modules 2 à 4. Il faut bien noter que les éléments choisis dans _Début_ et _Fin_ sont __inclus__ dans le périmètre du filtre. - -![Configuration du filtre](../../img/pogues/filtre-configuration.png) - -Le filtre que l'on vient de créer devient visible dans la vue d'ensemble du questionnaire (sur les éléments choisis dans _Début_ et _Fin_), on peut le modifier en cliquant dessus. - -![Résultat du filtre](../../img/pogues/filtre-resultat.png) diff --git a/bowiedocs/docs/pogues/tutoriel/21-ajout-controle.md b/bowiedocs/docs/pogues/tutoriel/21-ajout-controle.md deleted file mode 100644 index 56c4ca0a..00000000 --- a/bowiedocs/docs/pogues/tutoriel/21-ajout-controle.md +++ /dev/null @@ -1,45 +0,0 @@ -# Ajout d'un contrôle - -On souhaite pouvoir s'assurer d'une bonne qualité de réponse aux différentes questions que l'on propose. Pour cela, on peut utiliser le mécanisme de contrôle inhérent aux outils de l'atelier. - -!!!note - - Actuellement, seuls les contrôles de format - par exemple une valeur minimum dans un champ numérique - sont bloquants. Les contrôles de cohérence comme celui que l'on s'apprête à créer ne bloque pas le déroulement du questionnaire. - -Ici, on va créer un contrôle affichant un message d'incitation si l'on ne donne pas son prénom. - -Pour cela, on va modifier la question dont l'identifiant est PRENOM (en cliquant sur _Voir le détail). - -![Modification de la question PRENOM](../../img/pogues/controle-modification-question.png) - -On choisit ensuite l'onglet _Contrôles_. - -Pour créer un contrôle, il faut remplir quatre champs : - -- _Description du contrôle_ Un texte permettant de décrire le contrôle, -- _Condition d'affichage_ Une expression VTL qui déclenche le contrôle, -- _Message d'erreur_ Le texte qui s'affiche lorsque l'erreur est levée, -- _Criticité_ Un champ informatif sur le degré d'importance de l'erreur (actuellement n'a aucune incidence sur l'affichage). - -On veut déclencher le contrôle en cas de non-réponse, on va tester dans notre cas : - -- si l'on n'est jamais entré dans le champ de réponse (la variable est `null` au sens VTL), -- si l'on est entré dans le champ mais qu'on n'a rien saisi (la variable est égale à une chaîne de caractères vide, ou `""`). - -L'expression VTL sera donc : - - ```vtl - $PRENOM$ = "" or isnull($PRENOM$) - ``` - -!!!note - - On notera l'utilisation de la fonction `isnull` qui permet de détecter si une variable n'a pas été valorisée (cf. guide VTL). - -On aura une configuration sensiblement similaire à :point_down: - -![Configuration du contrôle](../../img/pogues/controle-configuration.png) - -Lors du parcours du questionnaire, si vous ne remplissez pas la réponse à la question sur le prénom vous devriez voir apparaître le message du contrôle : - -![Affichage du contrôle](../../img/pogues/controle-affichage.png) diff --git a/bowiedocs/docs/pogues/tutoriel/22-ajout-infobulle.md b/bowiedocs/docs/pogues/tutoriel/22-ajout-infobulle.md deleted file mode 100644 index 3813d175..00000000 --- a/bowiedocs/docs/pogues/tutoriel/22-ajout-infobulle.md +++ /dev/null @@ -1,18 +0,0 @@ -# Insertion d'une infobulle - -L'ajout d'une [infobulle](https://fr.wikipedia.org/wiki/Infobulle) est possible dans les libellés des questions en appliquant une syntaxe particulière : - -```md -Le texte de ma question contenant [une infobulle](. "Contenu de l'infobulle."). -``` - -Le positionnement des simples et doubles quotes, ainsi que des autres éléments typographiques est crucial ici. - -!!!tip - - Attention notamment à la position du point `.` dans la parenthèse, on doit avoir : - - parenthèse ouvrante :arrow_right: point :arrow_right: espace :arrow_right: double quote :arrow_right: texte :arrow_right: double quote :arrow_right: parenthèse fermante - :point_right: `(. "texte")` - -Pour notre questionnaire, on propose l'ajout d'une infobulle sur le terme "travailler" dans la question "A quelle date avez-vous commencer à __travailler__ ?", avec le contenu suivant pour l'infobulle : "Ne comptez pas les années de scolarité." diff --git a/bowiedocs/docs/pogues/tutoriel/23-utilisation-variable-calculee.md b/bowiedocs/docs/pogues/tutoriel/23-utilisation-variable-calculee.md deleted file mode 100644 index b665f3c4..00000000 --- a/bowiedocs/docs/pogues/tutoriel/23-utilisation-variable-calculee.md +++ /dev/null @@ -1,56 +0,0 @@ -# Utilisation d'une variable calculée - -Pogues permet la création de trois types de variables dans le questionnaire : - -1. les _variables collectées_ : celles qui sont valorisées par les réponses aux questions, -2. les _variables calculées_ : elles sont produites à partir d'une expression VTL, -3. les _variables externes_ : elles sont valorisées par des données externes qui seront injectées dans le questionnaire. - -Nous allons voir dans cette section comment mobiliser le deuxième type de variable pour mettre en place un contrôle sur la réponse à la question sur les activités professionnelles (`ACTIVITES`). - -## Création de la variable - -Pour créer une variable calculée, il suffit d'entrer dans le détail d'une question, n'importe laquelle (via le bouton _Voir le détail_), puis de sélectionner l'onglet _Variables calculées_. - -Cet onglet liste l'ensemble des variables calculées du questionnaire. - -Plusieurs champs sont à compléter : - -- _Libellé_ : un texte court pour identifier la variable -- _Identifiant_ : un identifiant de la forme `MON_IDENTIFIANT` -- _Formule_ : l'expression VTL qui valorise la variable -- _Type de réponse_ : comme pour une variable collectée, on renseigne les caractéristiques de la variable -- Autres champs associés au type de réponse -- _Portée_ : dans le cas général, la portée est _Questionnaire_, la variable est mobilisable dans l'ensemble du questionnaire. Pour des variables qui sont créées dans une occurence de boucle ou de tableau, il faut préciser que la portée se limite à cette boucle ou ce tableau. - -Notre variable aura comme identifiant `SOMME`, et aura comme valeur l'addition des variables produites par le [tableau créé précédemment](15-creation-tableau.md) : - - ```vtl - nvl($ACTIVITES11$, 0) + - nvl($ACTIVITES21$, 0) + - nvl($ACTIVITES31$, 0) + - nvl($ACTIVITES41$, 0) + - nvl($ACTIVITES51$, 0) - ``` - -!!!note - - On utilise ici la fonction `nvl` qui permet de renvoyer une valeur par défaut si la variable est nulle. En effet, si on ne valorise pas une case du tableau, la variable correspondante aura comme valeur `null` ce qui ne permet pas de faire la somme. - - On lit `nvl($ACTIVITES11$, 0)` ainsi : si la variable `$ACTIVITES11$` est `null`, on renvoie `0` sinon on renvoie sa valeur. - -## Utilisation de la variable - -On peut maintenant ajouter un contrôle sur la question `ACTIVITES` pour s'assurer que la ventilation est égale à 100%. Vous pouvez pour cela vous appuyer sur ce que l'on a vu [précédemment](21-ajout-controle.md) et sur le [guide VTL](../guide/vtl.md)... Pour les plus pressés d'entre vous, vous pouvez regarder la solution ci-dessous. :smiley: - -??? example "Solution" - - La formule pour le contrôle pourra être `$SOMME$ <> 100`, l'opérateur `<>` signifiant "différent de". - - Par ailleurs, le message du contrôle pourra inclure la somme des ventilations déjà fournies : - - ```vtl - "Votre total doit être égal à 100% (" || - cast($SOMME$, string) || - ")" - ``` diff --git a/bowiedocs/docs/pogues/tutoriel/24-personnalisation-libelle.md b/bowiedocs/docs/pogues/tutoriel/24-personnalisation-libelle.md deleted file mode 100644 index 44f45f0c..00000000 --- a/bowiedocs/docs/pogues/tutoriel/24-personnalisation-libelle.md +++ /dev/null @@ -1,26 +0,0 @@ -# Personnalisation d'un libellé - -Vous l'avez remarqué, le champ qui permet la création d'un libellé de question n'est pas un champ texte ordinaire. Il s'agit en effet d'un éditeur de code VTL ! - -Cela signifie que l'on peut utiliser le langage VTL pour personnaliser le libellé, le rendre dynamique. - -On propose ici de créer une variable calculée permettant d'afficher le prénom du répondant s'il a été renseigné et de proposer un présentation plus générique si ce n'est pas le cas (pour rappel, le contrôle posé sur la remplissage du prénom n'est pas bloquant !). - -## Création de la variable calculée `PERSOLIB` - -Comme précédemment, au sein d'une question, dans l'onglet _Variables calculées_, on crée la variable `PERSOLIB` dont la valeur est : - -- la variable PRENOM si elle est renseignée -- le texte "Cher répondant, " si ce n'est pas le cas. - -??? example "Solution" - - `if nvl($PRENOM$, "") = "" then "Cher répondant, " else $PRENOM$ || " ,"` - -## Personnalisation du libellé de la question `APPRECIATION` - -On peut retourner sur la question dont l'identifiant est `APPRECIATION`, pour modifier son libellé de manière à commencer par le texte produit par la variable `PERSOLIB`. - -??? example "Solution" - - `"" || $PERSOLIB$ || " avez-vous apprécié l'exercice ?"` diff --git a/bowiedocs/docs/pogues/tutoriel/25-mise-en-place-boucle.md b/bowiedocs/docs/pogues/tutoriel/25-mise-en-place-boucle.md deleted file mode 100644 index a073540e..00000000 --- a/bowiedocs/docs/pogues/tutoriel/25-mise-en-place-boucle.md +++ /dev/null @@ -1,38 +0,0 @@ -# Mise en place d'une boucle - -Une boucle permet de répéter une partie du questionnaire (au niveau séquence ou sous-séquence), à partir de valeurs prédéterminées ou de variables du questionnaire. - -Dans notre cas d'usage, on souhaite répéter la sous-séquence "Parlez-nous de votre collègue autant de fois que le nombre de collègue qui a été donné à la questions précédente "Combien de personnes partagent votre bureau ?". - -On va donc mobiliser la variable `COMBIEN_PARTAGE` dans une boucle. - -Pour créer la boucle, on clique sur le bouton "+ Boucle" dans la barre d'actions. - -La fenêtre qui s'ouvre propose plusieurs champs que l'on va mobiliser de deux manières différentes : - -1. pour une boucle utilisant des valeurs fixes ou des variables du questionnaire -2. pour une boucle s'appuyant sur une structure répétée comme une autre boucle ou un tableau dynamique. - -Dans ce tutoriel, on va mettre en place le premier cas uniquement. - -!!! warning - - Pour le deuxième type d'utilisation, la section du guide est en cours de création :sweat: - -## Création de la boucle - -Nous allons remplir les champs suivants : - -- _Identifiant_ avec comme toujours un identifiant de la forme `MON_IDENTIFIANT` -- _Minimum_ le nombre minimum d'itérations, qui peut être une valeur fixe (par exemple `2`, ou une variable) -- _Maximum_ le nombre maximum d'itération, là aussi une valeur fixe ou une variable -- _Début_ la séquence ou la sous-séquence à partir de laquelle commence la répétition -- _Fin_ la séquence ou la sous-séquence sur laquelle termine la boucle ; comme pour les filtres, cet élément de fin est inclus dans la boucle. - -Dans notre cas, on spécifiera ces valeurs : - -- _Identifiant_ `BOUCLE` (oui, on fait simple :smile:) -- _Minimum_ le chiffre `1` -- _Maximum_ l'expression VTL `nvl($COMBIEN_PARTAGE$, 1)`, ce qui permet d'avoir `1` si la question précédente n'a pas été répondue ou la valeur de la réponse si on l'a obtenue -- _Début_ la sous-séquence `COLLEGUE` -- _Fin_ la sous-séquence `COLLEGUE` diff --git a/bowiedocs/docs/pogues/tutoriel/index.md b/bowiedocs/docs/pogues/tutoriel/index.md deleted file mode 100644 index d90540b5..00000000 --- a/bowiedocs/docs/pogues/tutoriel/index.md +++ /dev/null @@ -1,17 +0,0 @@ -# Apprendre à utiliser Pogues - -!!! note - - 27/07/2023 - Le guide de référence pour les enquêtes entreprises de la filière historique Coltrane reste [celui-ci](https://inseefr.github.io/Pogues/fr/guide-utilisateur/guide-utilisateur.html). - -!!! tip - - Pour bénéficier pleinement de ce tutoriel, nous vous encourageons à créer vos propres questionnaires sur cet [espace d'exploration](https://conception-questionnaires.demo.insee.io/). - -Pogues est l'interface graphique permettant de créer des questionnaires utilisables à travers l'ensemble de l'écosystème Bowie. Un triple principe est au coeur de cette interface : - -- parler le langage du concepteur, -- permettre des itérations rapides, -- produire le modèle du questionnaire à travers des standards de métadonnées. - -Débutons par la création d'un questionnaire.