.. _tablehandler/ViewResource/advanced_methods/th_condition_method:

Metodo th_condition
===================




Impostazione condizioni di selezione delle righe
------------------------------------------------

::

  def th_condition(self):

Non riceve alcun parametro e ritorna un **dizionario contenente le condizioni applicativo/logiche di esecuzione della query**

Ad esempio:

::

 return dict(condition='$cap = :cap',condition_cap='20100')

La sintassi della condition è quella classica di sql con parametri che in Genropy si traduce nel modo *condition='...:parametro'* e *condition_parametro* che imposta il valore del parametro di selezione.

Indica che la query dovrà rispettare una condizione logica di selezione dei dati molto restrittiva e applicata dal codice (e non modificabile 
dall'utente) cui si aggiungeranno eventuali condizioni impostate nel campo di ricerca.

.. image:: /_static/images/ViewResource/advanced_methods/th_query.png
    :width: 468px
    :align: center

In pratica nell'esempio saranno selezionati tutti i clienti con cap=20100 che soddisfano le eventuali ulteriori condizioni impostate dall'utente nel campo di ricerca.

Naturalmente questo è solo un esempio forse poco significativo ma se ad esempio una grid debba visualizzare "solo" i clienti attivi è possibile impostare questo criterio che vincola e limita la lista delle righe selezionate.

Nella condition può essere usato qualsiasi criterio previsto dall'sql come ad esempio una selezione con LIKE.

::

  return dict(condition='$cap LIKE :cap',condition_cap='%30%')

.. sectionauthor:: Valter Vettorello