Les questionnaires - Valeurs dynamiques


Definition

Une valeur dynamique permet de définir une condition ou une contrainte dynamique sur les questions dont le résultat est basé sur des requêtes SQL évaluées au moment de l'appel de la variable. 

EndDefinition
  • Les valeurs dynamiques peuvent être utilisées dans les questionnaires standard et les questionnaires multi-sections.
  • Suivant leur nature, elles peuvent identifier une date, une chaîne de caractères, une durée ou un nombre. Seules des questions de même nature peuvent les utiliser.

exemple  Date d'arrivée supérieure ou égale à la date du jour

Exemple

Définir une contrainte pour s’assurer que la date de rendez-vous est prise dans les 15 jours suivant la date courante.

1. Créer la valeur dynamique @now dans la table de référence : requête permettant d'évaluer la date et heure courante au moment de l'appel de la variable.

2. Associer la valeur dynamique au questionnaire.

3. Définir la contrainte sur la question Rendez-vous pris le Example - Date entry.png, via une comparaison sur la valeur dynamique @now : erreur si la date saisie par l'utilisateur est supérieure à "@now + 15 jours"

4. Au moment de l'exécution du questionnaire :

  • la valeur @now est évaluée et est égale à la date du jour ;
  • si l'utilisateur indique un rendez-vous qui n'est pas dans les 15 jours suivant la date du jour, le message d'erreur La date de rendez-vous doit être prise dans les 15 jours est affiché.

Remarques

  • Chaque variable est automatiquement précédée du caractère @.

exemple  @now : Date/heure courante

  • Une liste de valeurs dynamiques est fournie par EasyVista. Vous ne pouvez pas supprimer ces valeurs.
  • Une valeur dynamique peut être associée à plusieurs questionnaires. Si l'association avec l'un d'entre eux est supprimée, l'association avec les autres questionnaires n'est pas supprimée.
  • Si le type d'une valeur dynamique est modifiée via un questionnaire, l'association avec les conditions/contraintes est automatiquement supprimée.

Attention

  • Si vous modifiez le type d'une valeur dynamique utilisée par une condition ou une contrainte, l'association avec cette condition ou contrainte est automatiquement supprimée.

Bonnes pratiques

  • En mode Liste, la vue par défaut est Questionnaire. Lorsque aucune valeur dynamique n'est associée à un questionnaire, utilisez la vue Liste.

Accès menu

  • Références > Autres références > Questionnaire : Valeurs dynamiques

Description de l'écran

   Dynamic value editor.png

Nom : Identifiant unique de la valeur dynamique.

Type : Nature de la valeur dynamique, qui peut être Chaîne, Date et Heure, Décimal, Durée.

Description : Libellé de la valeur dynamique.

Contenu : Requête SQL exécutée au moment de l'appel de la valeur dynamique par une question -  Open url.png voir Exemples de requêtes SQL

Procédures et Assistants

Comment créer une valeur dynamique

1. Allez sur l'écran Operation > Références > Questionnaire : Valeurs dynamiques  ou  Transition > Références > Questionnaire : Valeurs dynamiques.

2. Cliquez sur Add icon.png.

3. Renseignez les informations de la nouvelle valeur dynamique.

4. Cliquez sur Enregistrer.

La valeur dynamique devient disponible pour l'ensemble des questionnaires, quel que soit le menu depuis lequel elle a été créée.

Comment utiliser les valeurs dynamiques dans un questionnaire

Étape 1 : Association des valeurs dynamiques au questionnaire

Note : Toutes les valeurs dynamiques étant calculées au lancement du questionnaire, associez uniquement celles que vous souhaitez utiliser au niveau des contraintes/conditions sur des questions.

1. Allez sur le questionnaire souhaité.

2. Allez sur la section souhaitée s'il s'agit d'un questionnaire multi-sections.

3. Lancez l'assistant Gérer les questions.
        Manage the questions wizard.png

4. Cliquez sur Associer les valeurs dynamiques.

5. Ajoutez les valeurs souhaitées via Add icon.png.

     Notes

  • La liste affiche les valeurs déjà associées au questionnaire.
            Dynamic value association.png
  • Si vous créez une nouvelle valeur dynamique directement depuis le questionnaire, celle-ci est automatiquement associée au questionnaire. Elle est également ajoutée dans les tables de référence et devient disponible pour l'ensemble des questionnaires.
     

Étape 2 : Définition des contraintes et conditions sur les questions

Définition d'une contrainte

1. Cliquez sur Constraint icon.png ou No constraint icon.png dans la colonne Contrainte de la question.

2. Sélectionnez l'option Comparée à une valeur dynamique.

3. Renseignez la condition ou la valeur qui s'appliquent.

Note : Seules les valeurs dynamiques de même nature que le type de question sont proposées.

Définition d'une condition

1. Cliquez sur Condition icon.png ou No condition icon.png dans la colonne Condition de la question.

2. Sélectionnez l'une des 4 options disponibles : Contient/Ne contient pas la valeur dynamique, Commence/Ne commence pas par la valeur dynamique.

3. Renseignez la condition ou la valeur qui s'appliquent.

Notes

  • Seules les valeurs dynamiques de même nature que le type de question sont proposées.
  • Vous pouvez utiliser des expressions régulières  - Open url.png voir Exemples

Au moment de l'exécution du questionnaire via un workflow, chaque valeur dynamique est évaluée dans les contraintes et conditions qui l'utilisent.

Les assistants

Modifier
Supprimer

Exemples de requêtes SQL

  • Rechercher le 1er jour du mois dernier ==> variable 1stDayOfLastMonth
SELECT DATEADD(MONTH, DATEDIFF(MONTH, 0, DATEADD(MONTH, -1, GETUTCDATE())), 0)
  • Rechercher le 1er jour du prochain trimestre ==> variable 1stDayOfNextQuarter
SELECT DATEADD(QUARTER, DATEDIFF(QUARTER, 0, DATEADD(QUARTER, 1, GETUTCDATE())), 0)
  • Rechercher le dernier jour du mois courant ==> variable lastDayOfTheMonth
SELECT DATEADD(DAY, -1, DATEADD(MONTH, DATEDIFF(MONTH, 0, DATEADD(MONTH, 1, GETUTCDATE())), 0))
Tags :
Powered by XWiki © EasyVista 2022