.. _gnrextra/srvy/srvy_questions:

Le domande di una survey
========================

.. toctree::
   :maxdepth: 1
   :hidden:
   :titlesonly:


   questions_type
   questions_condition



All'interno della Form di una *survey* è possibile inserire domande di diversa tipologia e sottoposte o meno a delle condizioni, secondo la consueta struttura delle  `tabelle gerarchiche <https://www.genropy.org/docs/manuale_utente_genropy/th_hierarchical_tbl/th_hierarchical_tbl.html>`_ di Genropy. 

.. image:: /_static/images/srvy/srvy_questions/new-question.png
    :width: 400px
    :align: center
    
Cliccando quindi sul "+" accanto al titolo della *survey* sarà possibile aprire un dialog per l'inserimento della prima domanda, dove andremo a compilare:

- la ``Question class``, ovvero la classe di appartenenza della domanda (domanda di classe *input*, *folder*, *media*, ecc)

.. image:: /_static/images/srvy/srvy_questions/question-class.png
    :width: 300px
    :align: center

- il ``Question type``, dipendente dalla classe scelta (ad es. testo, scelta multipla, numero, data, ecc, utilizzando molti dei classici `Widget <https://www.genropy.org/docs/widgetpedia/index.html>`_ di Genropy)

.. image:: /_static/images/srvy/srvy_questions/question-type.png
    :width: 300px
    :align: center
    
.. hint::
  Una volta identificata una classe e un tipo di domanda, in caso di modifica sarà possibile solo modificare il tipo e non più la classe (es: scegliere un tipo di risposta numerica invece di un testo, ma non una scelta multipla). 
  
- il ``Title``, che poi comparirà nella parte superiore della schermata, e che permetterà di identificare la domanda
- anche qui un ``Code``, ovvero un codice univoco per la domanda, popolato automaticamente sulla base del titolo inserito ma modificabile a piacere
    
A quel punto sarà possibile compilare gli altri campi, all'interno del tab ``Question``, in particolare:

- il flag ``Mandatory``, che renderà la domanda obbligatoria (non sarà quindi possibile proseguire nell'intervista senza prima aver dato una risposta)
- il ``Condition type``, ovvero il tipo di condizione che determinerà se mostrare la domanda o meno (si rimanda alla sezione dedicata  :ref:`Domande condizionate<gnrextra/srvy/srvy_questions/questions_condition>` )

Nella parte inferiore sarà poi possibile visualizzare o definire:

- i ``Question parameters``, ovvero tutto ciò che riguarda la domanda
- gli ``Attachments``, ovvero gli eventuali allegati alla domanda
- la ``Preview``, ovvero l'anteprima della domanda

.. image:: /_static/images/srvy/srvy_questions/preview_01.png
    :width: 250px
    :align: center

I parametri della *question*
----------------------------
La sezione più folta è quella dei ``Question parameters``, dove sarà possibile specificare:

- il testo della domanda, nel campo ``Question``
- in alternativa, un *template*, con il consueto meccanismo del `templateChunk <https://www.genropy.org/docs/widgetpedia/components/templateChunk.html>`_

.. image:: /_static/images/srvy/srvy_questions/question.png
    :width: 500px
    :align: center

- nel box ``Parameters`` sarà possibile indicare i vari parametri dei widget, che cambieranno a seconda del *question type* prescelto

.. image:: /_static/images/srvy/srvy_questions/parameters.png
    :width: 500px
    :align: center

- nel box ``Choices``, invece, sarà possibile inserire le risposte multiple disponibili, assegnando loro un *codice* univoco e una *descrizione*.

.. image:: /_static/images/srvy/srvy_questions/choices.png
    :width: 600px
    :align: center
    
.. hint::  
  Si noti che è possibile ordinare a piacimento le risposte tramite semplice trascinamento.

.. sectionauthor:: Davide Paci