WHERE criteria [;]

où :

criteria

Sont les critères utilisés pour sélectionner les enregistrements à inclure dans le rapport. Les critères doivent être définis dans une expression valable qui évalue en tant que TRUE ou FALSE (c'est-à-dire, une expression booléenne). Les expressions sont décrites en détail à la rubrique Utilisation d'expressions. Les opérateurs pouvant être utilisés dans les expressions WHERE (y compris CONTAINS, IS et GT, sont décrites à la rubrique Opérateurs pris en charge avec les tests WHERE et IF.

;

est un point-virgule que vous pouvez insérer facultativement dans une requête pour en augmenter la lisibilité. Le point-virgule n'affecte pas le rapport.

La phrase WHERE peut comprendre :

• La plupart des expressions qui seraient valides sur le côté droit d'une expression DEFINE. Cependant, l'expression logique IF ... THEN ... ELSE ne peut pas être utilisée.
• Des champs réels, des champs temporaires et des champs dans les fichiers joints. Si un nom de champ est entouré de guillemets simples ou doubles, il est traité comme une chaîne littérale, non comme une référence de champ.
• Les opérateurs EQ, NE, GE, GT, LT, LE, CONTAINS, OMITS, FROM ... TO, NOT-FROM ... TO, INCLUDES, EXCLUDES, LIKE, et NOT LIKE.
• Tous les opérateurs arithmétiques (+, -, *, /, **), ainsi que les fonctions (MIN, MAX, ABS, et SQRT, par exemple).
• Une expression alphanumérique, qui peut être littérale, ou une fonction produisant un résultat alphanumérique ou numérique avec EDIT ou DECODE.

  Notez que les fichiers utilisés avec les expressions DECODE peuvent contenir deux colonnes, l'une pour les valeurs de champ et l'autre pour les valeurs de décodage numériques.

• Les littéraux alphanumériques et de date entre guillemets simples et les littéraux date-heure au format DH (littéral date-heure).
• Un littéral de date utilisé dans un test de sélection pour un champ de date ne peut pas comporter le jour de la semaine comme valeur.
• Champs de texte. Cependant, les seuls opérateurs pris en charge pour l'utilisation avec les champs de texte sont CONTAINS et OMITS.
• Toutes les fonctions.

Vous pouvez générer des critères de sélection complexes en liant des expressions simples à l'aide des opérateurs logiques AND et OR et, à titre d'option, en ajoutant des parenthèses afin de spécifier explicitement l'ordre de l'évaluation. Cette méthode est plus facile que celle utilisant la phrase IF, car celle-ci peut exiger l'utilisation d'une autre commande DEFINE. Pour plus d'informations, consultez Utiliser les expressions composées dans la sélection d'enregistrements.

Pour afficher que les noms et salaires des employés gagnant plus de $20 000 par an, lancez la requête suivante :

TABLE FILE EMPLOYEE
PRINT LAST_NAME AND FIRST_NAME AND CURR_SAL
BY LAST_NAME NOPRINT
WHERE CURR_SAL GT 20000
END

Dans cet exemple, CURR_SAL est un champ sélectionné, et CURR_SAL GT 20000 est le critère de sélection. Seuls les enregistrements avec un salaire actuel supérieur à 20 000 $ sont récupérés. Tous les autres enregistrements sont ignorés.

La sortie est :

Vous pouvez utiliser autant de phrases WHERE que nécessaire pour définir vos critères de sélection. Cette requête utilise des phrases WHERE multiples pour que seuls les employés des services MIS ou Production dont le nom est Cross ou Banning soient compris dans le rapport.

TABLE FILE EMPLOYEE
PRINT EMP_ID LAST_NAME
WHERE SALARY GT 20000
WHERE DEPARTMENT IS 'MIS' OR 'PRODUCTION'
WHERE LAST_NAME IS 'CROSS' OR 'BANNING'
END

La sortie est :

Pour plus d'informations, consultez Utiliser les expressions composées dans la sélection d'enregistrements.

Lorsque vous reportez d'une source de données à chemins multiples, un segment parent peut avoir des enfants sur certains chemins, mais pas sur d'autres. Le paramètre MULTIPATH vous permet de déterminer si un tel segment parent est omis de la sortie de rapport.

Le paramètre MULTIPATH a une incidence sur le traitement des tests de sélection sur les chemins indépendants. Si MULTIPATH égale :

• Les tests COMPOUND, WHERE ou IF sur différents chemins sont traités comme s'ils étaient connectés par un opérateur AND. C'est-à-dire, tous les chemins doivent réussir les tests de présélection pour que le parent soit inclus dans les résultats de la procédure de rapport.
• SIMPLE, WHERE ou IF testent sur différents chemins et sont traités indépendamment, comme s'ils étaient connectés par un opérateur OR. Par conséquent, une instance parent est comprise dans le rapport si au moins un des chemins réussit le test de présélection. Un message d'avertissement est généré, indiquant que si la requête comprend un test sur un chemin, des données sont aussi récupérées d'un autre chemin indépendant. Les enregistrements sur le chemin indépendant sont récupérés, que la condition soit remplie ou non sur le chemin testé.

Les paramètres MULTIPATH s'appliquent à tout type de source données et à tout environnement de reporting (TABLE, TABLEF, MATCH, GRAPH et les requêtes aux commandes d'affichage multiples). MULTIPATH fonctionne également avec d'autres vues, des vues indexées, des filtres, DBA et les structures jointes.

SET MULTIPATH = {SIMPLE|COMPOUND}

ON TABLE SET MULTIPATH {SIMPLE|COMPOUND}

SET ALL = OFF
SET MULTIPATH = SIMPLE
TABLE FILE EMPLOYEE 
PRINT GROSS DATE_ATTEND COURSE_NAME
BY LAST_NAME BY FIRST_NAME
WHERE PAY_DATE EQ 820730
WHERE COURSE_CODE EQ '103'
END

(FOC144) WARNING. TESTING IN INDEPENDENT SETS OF DATA

LAST_NAME       FIRST_NAME            GROSS  DATE_ATTEND  COURSE_NAME      
---------       ----------            -----  -----------  -----------      
JONES           DIANE             $1,540.00     82/05/26  BASIC REPORT PREP FOR PROG
SMITH           MARY              $1,100.00     81/11/16  BASIC REPORT PREP FOR PROG

SET ALL = OFF
PRINT EMP_ID PAY_DATE DATE_ATTEND

SET ALL = ON
PRINT EMP_ID PAY_DATE DATE_ATTEND

SET ALL = OFF
PRINT EMP_ID PAY_DATE DATE_ATTEND
WHERE PAY_DATE EQ 980115

SET ALL = ON
PRINT EMP_ID PAY_DATE DATE_ATTEND
WHERE PAY_DATE EQ 980115

SET ALL = OFF 
PRINT ALL.EMP_ID DATE_ATTEND
WHERE PAY_DATE EQ 980115

SET ALL = ON or OFF
PRINT EMP_ID PAY_DATE DATE_ATTEND
WHERE PAY_DATE EQ 980115 AND COURSE_CODE EQ  '103'