.. _orm_genropy/virtual_columns/subquerycolumn:

subQueryColumn
==============




La subQueryColumn è una  :ref:`formulaColumn<orm_genropy/virtual_columns/formulaColumn>`  di tipo ``select``, che quindi effettua sempre una *subquery*, ma oltre a prevedere una sintassi più "dedicata" prevedono anche un *output* più specifico, in formato **xml** o **json**.

::

  tbl.subQueryColumn('dettaglio_acquisti', query=dict(table='fatt.fattura_riga',
                                                                columns="$prodotto_codice,$prezzo_unitario,$quantita",
                                                                where='$fattura_id=#THIS.id'), 
                                                 mode='json', name_long='Dettaglio acquisti')
                                                                
Si noti che alla stregua di *select* nelle formulaColumn, definiamo in ``query`` un dizionario con tutti i parametri della  :ref:`query<orm_genropy/orm_genropy/lettura/query>`  (*table*, *where*, *columns*, *subtable*, ecc.)

L'output può essere in formato *xml* o *json* a seconda di quanto specificato nel ``mode``. La rappresentazione in griglia sarà differente, nel primo caso la consueta rappresentazione dei nodi della Bag, nel secondo caso una tabella appositamente creata:

.. image:: /_static/images/screenshot-2025-04-22-alle-172618.png
    :width: 311px
    :align: center
    :height: 197px

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|query                   |T     |L'attributo "query" permette di specificare il    |
|                        |      |dizionario con i parametri da passare alla query. |
|                        |      |Possono essere usati al suo interno tutti i       |
|                        |      |classici parametri delle query                    |
+------------------------+------+--------------------------------------------------+
|mode                    |T     |La modalità di restituzione dell'output, "xml" o  |
|                        |      |"json"                                            |
+------------------------+------+--------------------------------------------------+
|                           *Query parameters Parametri*                           |
+------------------------+------+--------------------------------------------------+
|table                   |T     |La tabella su cui effettuare la query             |
+------------------------+------+--------------------------------------------------+
|where                   |T     |La condizione where della query                   |
+------------------------+------+--------------------------------------------------+
|columns                 |T     |Le colonne da restituire come risultato della     |
|                        |      |query                                             |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci