selection

La selection crea e ritorna un oggetto SqlSelection, contenente i dati risultato della query. Di questo oggetto SqlSelection è poi possibile richiedere un output di diversi tipi:

myquery.selection().output('pkeylist')

['syd9_cQZPm_AxELj3jJKxw','ja14mgX2P2mRQWUNMWcdKg','g8pa8wDvMIeQW0R8Chn6ZA',
 'mf_6EJbWN1unRWkVjRRTgA','pN1YrXqfPyinfCQBQ2qewQ','eXTjroRqOLqqaP5Ez4vL0g']

che restituisce la lista di pkeys oggetto di interrogazione.

 myquery.selection().output('records')

 [<gnr.sql.gnrsqldata.SqlRecordBag at 0x107663640>,
<gnr.sql.gnrsqldata.SqlRecordBag at 0x10764db80>,
<gnr.sql.gnrsqldata.SqlRecordBag at 0x107695280>,
<gnr.sql.gnrsqldata.SqlRecordBag at 0x1076c7400>,
<gnr.sql.gnrsqldata.SqlRecordBag at 0x1076e9910>,
<gnr.sql.gnrsqldata.SqlRecordBag at 0x1076de6a0>]

restituisce la lista dei record.

 myquery.selection().output('list')

 [['Mario Rossi', 'syd9_cQZPm_AxELj3jJKxw'],
['Giardini e Giardini', 'ja14mgX2P2mRQWUNMWcdKg'],
['Porcari Francesco', 'g8pa8wDvMIeQW0R8Chn6ZA'],
['Rossi Mario', 'mf_6EJbWN1unRWkVjRRTgA'],
['Bianchi Luigino', 'pN1YrXqfPyinfCQBQ2qewQ'],
['Effelunga', 'eXTjroRqOLqqaP5Ez4vL0g']]

restituisce la lista delle coppie di ragione_sociale e pkey.

myquery.selection().output('selection')

<gnr.core.gnrbag.Bag at 0x107754e50>

restituisce una Bag con chiavi le pkey, e attributi la ragione_sociale e la pkey.

Suggerimento

Abbiamo visto solo alcuni esempi più utilizzati, ma si tenga presente che gli output sono molteplici, ed è in particolare possibile richiedere: bag, baglist, grid, count, data, dictlist, distinct, distinctColumns, fullgrid, generator, json, listItems, recordlist, tabtext, template, xls, xmlgrid.


Parametri:

Nome parametro

Tipo

Descrizione

where

T

Permette di indicare la condizione «where» che individuerà i record oggetto della query (es: where=”$id=#THIS.id”)

pkey

T

Alternativamente alla where permette di fornire una pkey come criterio di ricerca (es: pkey=medico_id)

columns

T

Permette di indicare le colonne da restituire come risultato dell’interrogazione (es: columns=”$fattura_id,$protocollo,$cliente_id”)

for_update

B

Se impostato a True il risultato della query sarà predisposto per la modifica tramite un’operazione di update (es: for_update=True)

excludeDraft

B

Di default True, se impostato a False permette di includere nei risultati gli status «Bozza» (es: excludeDraft=False)

excludeLogicalDeleted

B

Di default True, se impostato a False permette di includere nei risultati i record archiviati o eliminati (es: excludeDraft=False)

Autore della sezione: Davide Paci