la utilització de filtres en vistes llistat permet realitzar consultes o cerques de manera que els registres resultants compleixin amb un conjunt de condicions.

l'ús de filtres ens permetrà obtenir llistats que compleixin condicions com p.ex.:
-. llistar registres ... amb "data" major que ...
-. llistar registres ... que continguin en camp "titol" la paraula clau ...
-. llistar registres ... amb camp "nom" = ...
-. llistar registres ... on camp "preu" > ...

l'establiment de filtres en llistats està disponible per als mòduls:
• News (Actualitat).
• Registries (Registres).
• Newsletters (Circulars).
• Generics (Planes genèriques).
• Products (Productes).

per utilitzar filtres és necessari facilitar els paràmetres de definició del filtre prèvia construcció del llistat.

els paràmetres de definició del filtre podran enviar-se mitjançant un dels següents mètodes (o combinació d'aquests):

1.- enviant els paràmetres en la mateixa url que cridarà al llistat. pe.: (per consultar les noticies d'actualitat d'inte amb data superior (gt: great than) a 1/3/2003) index.php?date=20030301&scm_date=gt

2.- enviant els paràmetres de filtre utilitzant un formulari:

< ?php
$_REQUEST['date'] = '2003-03-01';
$_REQUEST['scm_date'] = 'gt';

# Configuration
$uid = '123412341234123412341234';
$NewsListLanguage='2';
$NewsListNumItems='3';
$NewsListNumLinks='5';

## new class news list
include_once('genb/Cnews.inc');
$news_list = new Cnews($uid,$NewsListLanguage,$NewsListNumItems,$NewsListNumLinks);

? >
< HTML>
< HEAD>
...
...

els paràmetres que es poden utilitzar en la definició de filtres són de tres tipus:



1.- la variable camp/etiqueta a utilitzar en el filtre. Aquesta variable s'encarregarà de transportar el valor a utilitzar en la comparació o filtre (p.ex la data a partir de la qual volem veure noticies index.php?date=20030301 ...). Poden utilitzar-se els tipus de camps següents:



camps de tipus variable o definits en model de dades:

-. text: designar utilitzant etiqueta.

-. text curt: designar utilitzant etiqueta.

-. llista oberta: designar utilitzant etiqueta.

-. llista tancada: designar utilitzant etiqueta.



camps de tipus fix:

-. nom o referència interna: designar com "internal_ref".

-. data: designar com "date".

-. data d'alta del registre: designar com "date_ini".

-. data de modificació del registre: designar com "date_mod".



2.- la variable que especifica el tipus de filtre. En la definició d'un filtre cal indicar la manera en què es compara el contingut del filtre amb els valors emmagatzemats al conjunt de registres gestionats pel sistema.



el nom del paràmetre encarregat d'indicar el tipus de filtre, es construeix afegint el prefix "scm_" (search comand method) al nom del camp o etiqueta utilitzat al filtre.



p.ex. si es desitja obtenir el conjunt de registres amb data "date" major que (grate than) "2003-03-03", el paràmetre que indicarà el tipus de filtre portarà per nom "scm_date".



els diferents valors (tipus de filtre) que les variables scm_... podran prendre són:

-.neq: (not equal) no igual a ...

-.eq: (equal) igual a ...

-.gt: (grate than) major que ...

-.gte: (grate than or equal) major que o igual que ...

-.lt: (less than) menor que ...

-.lte: (less than or equal) menor que o igual que ...

-.cn: (contains)[valor per defecte] conté ...

-.bw: (between) entre dos valors separats per coma

-.ew: (ends with) acaba per ...

-.sw: (starts with) comença per ...

-.in: (in) està en la llista de valors separats per coma ...

-.nin: (not in): no està en la llista de valors separats per coma ...



NOTA: els filtres sobre camps 'llista tancada' nomes admeten els tipus de filtre in i nin. Als filtres amb camps de tipus 'llista tancada' sempre s'utilitza el valor de l'identificador de l'item de la llista, mai el contingut textual del mateix.



3.- 's_field_operator' la variable que especifica el tipus d'unió entre diferents filtres. Quan s'utilitza més d'un filtre al mateix temps s'aplicarà per defecte l'operador d'unió 'AND' ('i'). Indicant que tots els filtres s'han de complir per cada un dels ítems resultants.



els diferents valors (tipus d'operador entre filtres) que la variable 's_field_operator' podrà prendre són:

-.or: (ó) amb el pas d'un dels filtres en cada registre resultant és suficient.

-.and: (i) el pas de tots els filtres és necessari en cada un dels registres resultants.

tot seguit es descriuen alguns exemples de com aplicar filtres en llistats (a títol d'exemple s'utilitza el llistat d'actualitat d'inte:



1.- llistat d'ítems actualitat amb 'data' > 1-1-2003:



index.php?date=2003-01-01&scm_date=gt



2.- llistat d'ítems actualitat on 'data' > 1-1-2003 i el cos de la noticia 'Text' conté 'GenB':



index.php?date=2003-01-01&scm_date=gt&Text=GenB



NOTA: no és necessari especificar scm_Text=cn a l'ésser aquest el tipus de filtre utilitzat per defecte.



3.- llistat d'ítems actualitat on 'data' > 1-1-2003 o el cos de la noticia 'Text' conté 'GenB':



index.php?date=2003-01-01&scm_date=gt&Text=GenB&s_field_operator=or