.. _widgetpedia/grids/grid/evaluationGrid:

evaluationGrid
==============




L'evaluationGrid è un component di Genropy che permette di **fornire una valutazione**, **assegnare un punteggio**, **marcare o meno la presenza** di una serie di elementi. Agli *items* della griglia (ovvero le righe) è possibile infatti assegnare, tramite dei  :ref:`radioButton<widgetpedia/elements/inputfields/radio>`  e delle  :ref:`checkbox<widgetpedia/elements/inputfields/checkbox>` , i valori riportati nelle colonne. 

.. raw:: html

 <div class="gnrexamplebox">
            <a class="gnrexamplebox_title" onclick='gnrExampleIframe(this.nextElementSibling,{"height": 200, "width": "100%", "examples_root": "https://dev.genropy.org/webpages/docu_examples", "examples_root_local": "", "example_folder": "widgetpedia/grids/grid/evaluationGrid", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "Esempio Si/No con radioButton ", "example_name": "radioButton"} );'>
                Esempio Si/No con radioButton 
            </a>
            <div></div>
        </div> 
        

È possibile indicare gli *items* da utilizzare o con una ``table`` o con l'attributo ``items``, che permetterà di indicare una stringa di valori separati da virgola.

Si noti che il risultato di tutti i risultati della griglia sarà una `Bag <https://www.genropy.org/docs/bag_book/index.html>`_ di valori, essendo di fatto l'evaluationGrid una  :ref:`bagGrid<widgetpedia/grids/grid/baggrid>`  ottimizzata per questi casi specifici.

Utilizzando un ``field_aggr``, ovvero un aggregatore (la "," per concatenare gli elementi separandoli con una virgola, il '+' per sommare i risultati e il '*' per moltiplicarli), la *evaluationGrid* utilizzerà automaticamente il widget *checkbox*.

.. raw:: html

 <div class="gnrexamplebox">
            <a class="gnrexamplebox_title" onclick='gnrExampleIframe(this.nextElementSibling,{"height": 200, "width": "100%", "examples_root": "https://dev.genropy.org/webpages/docu_examples", "examples_root_local": "", "example_folder": "widgetpedia/grids/grid/evaluationGrid", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "Esempio con checkBox ", "example_name": "checkbox"} );'>
                Esempio con checkBox 
            </a>
            <div></div>
        </div> 
        

.. hint::
  Se utilizzata in una webpage qualsiasi, al di fuori di un  :ref:`tableHandler<widgetpedia/genro/components/tablehandler>` , il component andrà importato come segue::
  
    py_requires = "gnrcomponents/framegrid:EvaluationGrid"
  

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|value                   |T     |Il path dove si collocherà la Bag dei risultati   |
+------------------------+------+--------------------------------------------------+
|title                   |T     |Il titolo della griglia, riportato nella parte    |
|                        |      |superiore                                         |
+------------------------+------+--------------------------------------------------+
|table                   |T     |Se specificata una table, verranno utilizzati come|
|                        |      |items (righe) i record della tabella              |
+------------------------+------+--------------------------------------------------+
|items                   |T     |Gli elementi da valutare, se non specificata la   |
|                        |      |table, come stringa di elementi separati da       |
|                        |      |virgola (es: items="Luciano's, Domino's, Pizza    |
|                        |      |Hut")                                             |
+------------------------+------+--------------------------------------------------+
|field_values            |T     |Le coppie chiavi:etichette che verranno utilizzate|
|                        |      |come colonne della tabella, per esprimere le      |
|                        |      |valutazioni (es:                                  |
|                        |      |field_values="1:Bad,2:Good,3:Awesome")            |
+------------------------+------+--------------------------------------------------+
|field_name              |T     |Un parametro facoltativo che permette di          |
|                        |      |specificare un nome per le colonne di valutazione,|
|                        |      |e sarà il nome del nodo della bag (es:            |
|                        |      |field_name='level')                               |
+------------------------+------+--------------------------------------------------+
|field_caption           |T     |Un parametro facoltativo che permette di          |
|                        |      |specificare un'etichetta per le colonne di        |
|                        |      |valutazione, che comparirà in cima alle colonne   |
|                        |      |(es: field_caption='Level')                       |
+------------------------+------+--------------------------------------------------+
|field_dtype             |T     |Permette di specificare il dtype del voto         |
|                        |      |assegnato, obbligatorio in caso di totalizzazione |
|                        |      |dei valori (es: field_dtype='L')                  |
+------------------------+------+--------------------------------------------------+
|field_aggr              |T     |L'aggregatore da utilizzare per gli elementi di   |
|                        |      |ogni riga, se è possibile avere più valori (es:   |
|                        |      |field_aggr=',' o field_aggr='+')                  |
+------------------------+------+--------------------------------------------------+
|field_totalize          |B     |Se impostato a True, i valori di ogni riga        |
|                        |      |verranno sommati in un campo di totalizzazione.   |
+------------------------+------+--------------------------------------------------+
|showValue               |B     |Di default False, se impostato a True permetterà  |
|                        |      |di aggiungere una colonna automatica di           |
|                        |      |somma/moltiplicazione (o semplice visualizzazione)|
|                        |      |dei voti assegnati nella riga                     |
+------------------------+------+--------------------------------------------------+
|choice_width            |T     |Permette di specificare la larghezza delle colonne|
|                        |      |dei fields (es: choice_width='6em')               |
+------------------------+------+--------------------------------------------------+
|value_width             |T     |Permette di specificare la larghezza delle colonne|
|                        |      |dei values, mostrata con showValue=True (es:      |
|                        |      |value_width='2em')                                |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci