Questionnaire - Assistant "Gérer les questions"


Cet assistant permet de définir le contenu d'un questionnaire (standard et multi-sections) en sélectionnant les questions parmi celles disponibles dans la table de référence, et en renseignant leurs propriétés suivant le contexte d'utilisation :

  • définition de contraintes permettant d'établir des règles à respecter avant de valider la réponse à une question ;
  • définition de conditions permettant d'établir des règles d'affichage des questions ;
  • possibilité de stocker les réponses dans la table SD_REQUEST en vue d'une réutilisation ultérieure ;
  • arrangement suivant l'ordre d'affichage souhaité.

Remarques

  • Sur un questionnaire multi-sections, l'assistant est disponible au niveau des sections.
  • Une même question peut être utilisée sur plusieurs questionnaires mais ne peut pas être ajoutée plusieurs fois sur le même questionnaire.
  • Lorsqu'une question est utilisée par une autre question via une contrainte ou une condition, son libellé, son type et son rang ne peuvent pas être modifiés.
  • Lorsqu'une question est utilisée par une autre question via une contrainte ou une condition, elle ne peut pas être supprimée.
  • Les contraintes ne sont pas disponibles pour les questions de type Bouton radio, Case à cocher, Commentaire, Entête de tableau, Grille, Liste, Signature, URL.

Best Practice big icon.pngBonnes pratiques

  • Formatez le questionnaire pour le rendre plus lisible :
    • Utilisez des questions de type Commentaires pour ajouter des recommandations ou précisions -  Open url.png  voir Liste des types de questions
    • Ajoutez des questions de type Système pour enrichir la présentation du questionnaire (ex. : ligne horizontale). 
    • Utilisez le langage Html pour afficher les valeurs.

Description de l'écran

       Manage the questions wizard.png

Add icon.png : Permet d'ajouter une question au questionnaire, sélectionnée parmi celles existantes dans la table de référence. 

  • Cliquez sur [ CRÉER UNE NOUVELLE QUESTION ] pour en définir une nouvelle. Celle-ci est automatiquement ajoutée dans la table de référence et associée au questionnaire.
  • Vous pouvez ajouter des questions utilisées dans un autre questionnaire.
  • Vous ne pouvez pas ajouter 2 fois la même question.
     

Delete icon.png (Note : Uniquement si la question n'est pas utilisée par une autre question via une contrainte ou une condition) : Permet de ne plus afficher la question sur le questionnaire courant.

  • La question n'est pas supprimée de la table de référence : seule l'association avec le questionnaire est supprimée.
  • Lorsque la question est utilisée par un autre questionnaire, elle reste associée à celui-ci.
     

Edit icon.png (Note : Uniquement si la question n'est pas utilisée par une autre question via une contrainte ou une condition) : Permet de modifier le code, le libellé, le type de la question, ainsi que les valeurs proposées comme réponse -  Open url.png  voir Éditeur de question.

Question : Libellé de la question.

Type : Nature de la question, permettant de formater la zone de réponse -  Open url.png  voir Liste des types de questions.

Code : Identifiant unique de la question.

Obligatoire (Note : Non modifiable pour certains types de questions, tel Commentaire) : Indique si l'utilisateur doit obligatoirement donner une réponse à la question (case cochée) ou s'il s'agit d'une question facultative (case non cochée).

Contrainte (Note : Sauf pour les types de questions Bouton radio, Case à cocher, Commentaire, Entête de tableau, Grille, Liste, Signature, URL) : Indique si une contrainte est définie pour la question (Constraint icon.png) ou non (No constraint icon.png) -  Open url.png voir Gestion des contraintes

Seul sur la ligne : Indique si la prochaine question est affichée sur la ligne suivante du questionnaire (case cochée - obligatoire pour certains types de questions tels Bouton radio, Grille, Memo du fait de leur longueur, et pour les questions avec condition) ou sur la même ligne (case non cochée).

Condition : Indique si l'affichage de la question dépend d'une condition (Condition icon.png) ou non (No condition icon.png) -  Open url.png voir Gestion des conditions

Destinations : Indique si la réponse à la question est stockée dans des champs précis (dits champs Cible) de la table SD_REQUEST (Target icon.png) ou non (No target icon.png) -  Open url.png voir Gestion des destinations

Spécifique Apps : Indique si la question est affichée uniquement lorsque le questionnaire est lancé depuis une application Product name - ev sas.png (case cochée) ou si elle est toujours affichée, que le questionnaire soit lancé depuis une application Product name - ev sas.png ou depuis un écran Product name - ev itsm.png (case non cochée).

Up arrow.png et Down arrow.png : Permettent de définir l'ordre d'affichage des questions lors de l'exécution du questionnaire. Note : Sur l'onglet Questions, l'ordre d'affichage correspond à la colonne Rang.

  • Les questions avec condition et les questions avec contrainte ne peuvent pas être déplacées en-deça des questions qu'elles utilisent.
  • Une question utilisée par une condition ne peut pas être déplacée au-delà de la question sur laquelle est définie la condition.
     

[ PRÉVISUALISATION ] : Permet de visualiser le questionnaire tel que le verra l'utilisateur.

  • Les questions avec condition sont affichées en rouge.
  • Les questions obligatoires sont précédées du caractère *.
     

[ CRÉER UNE NOUVELLE QUESTION ] : Permet de créer une question directement depuis le questionnaire, sans retourner sur la table de référence.

  • L'éditeur de question est automatiquement ouvert.
  • La nouvelle question devient disponible pour l'ensemble des questionnaires.
     

[ ASSOCIER LES VALEURS DYNAMIQUES ] : Permet de sélectionner les valeurs dynamiques utilisées par les contraintes et conditions du questionnaire courant.
         Dynamic value association.png

  • [ CRÉER UNE NOUVELLE VALEUR DYNAMIQUE ] : Permet de créer une valeur dynamique directement depuis le questionnaire, sans retourner sur la table de référence.
    • L'éditeur est automatiquement ouvert.
    • La nouvelle valeur dynamique est automatiquement associée au questionnaire courant et devient disponible pour l'ensemble des questionnaires.

Gestion des contraintes de saisie

Une contrainte permet de vérifier que la réponse à une question respecte bien certaines règles avant d'être validée. 

  • Les règles portent sur des comparaisons par rapport à des valeurs (fixes / dynamiques / expression régulière) et/ou par rapport aux réponses à des questions précédentes.
  • Elles sont combinées entre elles par des opérateurs logiques (et/ou).
  • La contrainte est évaluée immédiatement après la saisie de la réponse à la question : un message d'erreur bloquant est affichée si elle n'est pas vérifiée, empêchant la poursuite du questionnaire.
     
Erreur de saisie sur le questionnaire Message d'erreur affiché
Constraint - Error example.png Constraint - Error message example.png

Exemples

    Open url.png voir d'autres exemples

  • Vérifier que la réponse à la question Date de départ est supérieure ou égale à la réponse de la question Date d'arrivée ET supérieure ou égale à la date du jour (valeur dynamique @today).
  • Vérifier que la réponse à la question Heure du rendez-vous est comprise dans la plage horaire de 8h à 20h
    voir le paramétrage

    1. Créer une question Heure du rendez-vous de type Date/Heure

    2. Définir la contrainte de saisie sur cette question via 2 règles :

    • 1ère règle : option Comparée à une valeur fixe - question Heure du rendez-vous - Valeur : >= 6h
    • opérateur ET
    • 2ème règle : option Comparée à une valeur fixe - question Heure du rendez-vous - Valeur : <= 20h
  • Vérifier le bon format d'une pièce jointe : contrainte portant sur les extensions de fichiers autorisées (.png, .gif) ET sur la taille maximum du fichier (1Mo).
  • Vérifier que la réponse à la question Description ne contient pas la valeur script.

Remarques

  • Icônes de la colonne Contrainte :
    • Constraint icon.png indique une question pour laquelle une contrainte est définie.
    • No constraint icon.png indique une question pour laquelle aucune contrainte est définie.
    • Aucune icône est affichée pour les questions pour lesquelles il n'est pas possible de saisir de contrainte : questions de type Bouton radio, Case à cocher, Commentaire, Entête de tableau, Grille, Liste, Signature, URL.
  • Une contrainte peut contenir au maximum 10 règles, combinées entre elles par les opérateurs logiques ET ; OU.
  • La liste des options disponibles pour chaque règle d'une contrainte est contextuelle au type de question et est définie par Logo - EasyVista.png. Vous ne pouvez pas en ajouter.

Comment définir une contrainte sur une question

1. Ouvrez le questionnaire souhaité puis lancez l'assistant Gérer les questions pour afficher les questions.

2. Cliquez sur No constraint icon.png en regard de la question pour laquelle vous souhaitez créer une contrainte.
        Constraint editor.png

3. Dans l'éditeur, cliquez sur Plus icon.png et définissez chaque règle de la contrainte. Vous pouvez vous aider des exemples (1) qui sont contextuels au type de question.

  • Sélectionnez le mode de comparaison souhaité dans la colonne Option (Note : Les options proposées sont contextuelles au type de question) puis renseignez les condition / valeur qui s'appliquent.
  • Sélectionnez à chaque fois l'opérateur logique avec la règle précédente via la liste déroulante Séparateur :
    • AND : la réponse à la question avec contrainte est validée uniquement si les 2 règles sont vérifiées ;
    • OR : la réponse à la question avec contrainte est validée si au moins l'une des 2 règles est vérifiée.
  • Saisissez le message d'erreur (2) à afficher lorsque la contrainte n'est pas respectée.

4. Cliquez sur [ ENREGISTRER ] : le pictogramme en regard de la question avec contrainte est automatiquement remplacé par Constraint icon.png.

Gestion des conditions d'affichage

Une condition permet d'afficher une question en fonction de certaines règles.

  • Les règles peuvent porter sur des réponses données à des questions précédentes et/ou sur le résultat d'une requête SQL. 
  • Elles sont combinées entre elles par des opérateurs logiques (et/ou).

Exemples

  • Afficher la question Nouveau nom uniquement si la réponse à la question précédente Type de demande est Changement de nom.
  • Afficher la question Prochaine date de commande uniquement si le résultat de la requête SQL Nombre d'imprimantes en stock < 3 renvoie une réponse positive.

Remarques

  • Icônes de la colonne Condition :
    • Condition icon.png indique une question pour laquelle une condition est définie.
    • No condition icon.png indique une question pour laquelle aucune condition est définie.
    • Aucune icône est affichée pour les questions pour lesquelles il n'est pas possible de saisir de condition.
  • Une condition peut contenir au maximum 10 règles, combinées entre elles par les opérateurs logiques ET ; OU.
  • La liste des options disponibles pour chaque règle d'une condition est contextuelle au type de question et est définie par Logo - EasyVista.png. Vous ne pouvez pas en ajouter.
  • Une requête SQL est considérée comme réalisée si la valeur de retour est supérieure à 0 (au moins un enregistrement renvoyé par la requête : SELECT COUNT(*) > 0).
  • Une question utilisée par une question avec condition :
    • ne peut pas être supprimée ;
    • ne permet pas une modification de son type ni de ses valeurs.
  • En mode Prévisualisation, une question avec condition est affichée en rouge.

Comment définir une condition sur une question

1. Ouvrez le questionnaire souhaité puis lancez l'assistant Gérer les questions pour afficher les questions.

2. Cliquez sur No condition icon.png en regard de la question pour laquelle vous souhaitez créer une condition.
        Condition editor.png

3. Dans l'éditeur, cliquez sur Plus icon.png et définissez chaque règle de la condition :

  • Si la règle porte sur une question posée précédemment :
    • sélectionnez celle-ci dans la liste déroulante Question
    • dans la liste déroulante Condition, sélectionnez l'opérateur de comparaison s'appliquant à cette question - Note : Pour les types de questions Bouton radio, Grille et Liste, les opérateurs proposés sont les réponses possibles à la question ;
    • suivant l'opérateur sélectionné, renseignez la valeur de comparaison dans le champ s'affichant à la suite de l'opérateur.

Example documentation icon FR.png

  • Question Nom ?  ==>  opérateur Commence par ; valeur de comparaison SMIT
  • Question Type de clavier souhaité ?  ==>  opérateurs = valeurs des 2 boutons radio azerty et qwerty
  • Si la règle dépend du résultat d'une requête SQL :
    • sélectionnez l'option Condition SQL dans la liste déroulante Question et cliquez sur Edit icon.png ; 
    • renseignez le formulaire d'aide à la saisie de la requête - Note : Vous pouvez utiliser la variable @ID@ représentant le champ REQUEST_ID qui identifie l'incident/demande sur lequel porte le questionnaire ;
    • cliquez sur [ ENREGISTRER ] : la colonne Condition prend la valeur SELECT > 0.
  • Sélectionnez à chaque fois l'opérateur logique avec la règle précédente via la liste déroulante Séparateur :
    • AND : la question avec condition est affichée uniquement si les 2 règles sont vérifiées ;
    • OR : la question avec condition est affichée si au moins l'une des 2 règles est vérifiée.

4. Cliquez sur [ ENREGISTRER ] : le pictogramme en regard de la question avec condition est automatiquement remplacé par Condition icon.png.

5. Vérifiez votre questionnaire en cliquant sur [ PRÉVISUALISATION ] : la question avec condition est affichée en rouge.

Gestion des destinations

Une destination identifie un champ de la table SD_REQUEST dans lequel est sauvegardée la réponse à une question. Chaque réponse peut être stockée :

  • dans un champ de type Texte ou Memo : résultat brut ou non typé - généralement, il s'agit des champs libres et des champs externes ;
  • dans un champ de même type que la question : résultat typé.

    Open url.png voir Exemples

Remarques

  • Icônes de la colonne Destination :
    • Target icon.png indique une question pour laquelle la réponse est stockée dans la table SD_REQUEST.
    • No target icon.png indique une question pour laquelle la réponse n'est pas stockée dans la table SD_REQUEST.
    • Aucune icône est affichée pour les questions pour lesquelles il n'est pas possible de stocker dans la table SD_REQUEST : questions de type Commentaire, Entête de tableau, Signature, Téléchargement d'un fichier, URL.
  • Les champs pouvant être sélectionnés comme destination dépendent du type de question.
  • Pour les types de questions Date et Date et Heure, la réponse à la question peut être stockée uniquement dans un champ de type Date non suffixé par _UT.
  • Les champs système ne sont pas proposés comme destination.
        Example documentation icon FR.png  RFC_NUMBER, SLA_ID, REQUEST_ID
  • Certains champs sont utilisés par des assistants dans des contextes particuliers et ne peuvent alors pas être utilisés comme destination dans ces mêmes contextes.

    Example documentation icon FR.png  Le champ REQUESTOR_PHONE est utilisé par l'assistant Transfert d'une demande de changement. Il peut être utilisé comme destination sur un questionnaire d'un processus Incident mais pas sur un questionnaire d'un processus Demande de changement.

    Liste des champs concernés :
    • Contexte Incident : champs EXPECTED_START_DATE_UT, EXPECTED_END_DATE_UT, DESCRIPTION
    • Contexte Demande de changement : champ REQUESTOR_PHONE
    • Contexte Demande de changement Multi-panier : champ CI_ID
  • Les réponses stockées dans la table SD_REQUEST :
    • peuvent être affichées sur les fiches Incident/Demande/Action/Problème, à condition que les champs Cible soient apparents ;
    • peuvent être utilisées au niveau des reportings.

Best Practice big icon.pngBonnes pratiques

  • Lorsque vous souhaitez stocker les réponses aux questions dans des champs de la table SD_REQUEST :
    • Vérifiez que le champ Cible n'est pas un champ utilisé par l'assistant affichant la question, sous peine de perdre l'information saisie dans la question.
    • Assurez-vous de la cohérence d'utilisation lorsque le champ Cible est modifié par des étapes de mise à jour interne de règles métier.

Destinations de l'enregistrement de la réponse

        Target editor.png

Cible du résultat brut : Liste de tous les champs de type Texte ou Memo, quel que soit le type de question. Sélectionnez le champ en fonction du type de traitement à réaliser sur la réponse.

Cible du résultat typé : Liste de tous les champs de même type que celui de la question. Note : Le champ sélectionné peut être différent du champ sélectionné dans la liste Cible du résultat brut.

Best Practice icon.png Renseignez de préférence le champ Cible du résultat typé.

 

Action (Note : Uniquement pour une question de type Mémo) : Indique comment sont stockées les nouvelles informations lorsque le champ Destinations n'est pas vide dans la table SD_REQUEST :

  • Les informations peuvent écraser les informations existantes.
  • Les informations peuvent être insérées avant/après celles existantes.

 

Exemples de cibles

Type de question Réponse Cible
Bouton radio Oui   (Valeur du 1er bouton radio)
  • Cible Résultat brut : 1
  • Cible Résultat typé : Index 1
Date et Heure 03/02/2017   Calendar icon.png 10:00:00
  • Cible Résultat brut : 03/02/2017 10:00:00
  • Cible Résultat typé : 03/02/2017 10:00:00
Décimal 1000,99
  • Cible Résultat brut : 1000.99
  • Cible Résultat typé : 1000,99
Durée 1:25
  • Cible Résultat brut : 85
  • Cible Résultat typé : 85
Grille Laboratoire   (2ème valeur de la liste)
  • Cible Résultat brut : 2
  • Cible Résultat typé : Index 2
Tags:
Modifié par Utilisateur inconnu le 2017/03/31 19:54
Créé par Administrator XWiki le 2017/03/31 19:54

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020