Utilisation de filtres

Interface de ligne de commande du CADSMCMD › La commande cadsmcmd › Utilisation de filtres

Utilisation de filtres

Certaines méthodes de listage utilisent des filtres pour limiter le volume d'informations répertoriées.

Les filtres sont des expressions élaborées à partir d'expressions atomiques composées d'opérateurs de logique de proposition, comme && (et), || (ou) et ! (non), selon les règles suivantes :

Chaque expression atomique est une expression de filtre.
Si exp est une expression de filtre, !exp en est également une.
Si exp1 et exp2 sont des expressions de filtre, (exp1 && exp2) et (exp1 || exp2) en sont également.

Les expressions atomiques valides dépendent des objets à lister. La syntaxe de ces expressions atomiques est :

attributename operand value

Les noms d'attributs valides pour les méthodes de listage existantes et nouvelles sont répertoriés dans les chapitres suivants.

Il existe différents types d'attribut :

Type	Signification
Chaîne	La valeur d'attribut est de type chaîne.
Long	La valeur d'attribut est un entier de 4 octets.
Date	La valeur d'attribut est de type date AAAA-MM-JJ, où AAAA correspond à l'année, MM, au mois, et JJ, au jour.
Heure	La valeur d'attribut est de type heure hh:mm, où hh correspond aux heures (format 24 heures) et mm aux minutes
Heure/Date	Notation combinant les types date et heure AAAA-MM-JJ hh:mm conformément au standard ISO.

Les opérandes suivants sont valides et vérifiés :

Opérande	Chaîne	Long
=	Si la valeur d'attribut correspond à la valeur spécifiée.	Si la valeur d'attribut est égale à la valeur spécifiée.
!=	Si la valeur d'attribut ne correspond pas à la valeur spécifiée.	Si la valeur d'attribut est différente de la valeur spécifiée.
<	Si la valeur d'attribut est lexicographiquement inférieure à la valeur spécifiée.	Si la valeur d'attribut est inférieure à la valeur spécifiée.
>	Si la valeur d'attribut est lexicographiquement supérieure à la valeur spécifiée.	Si la valeur d'attribut est supérieure à la valeur spécifiée.

Dans le cas de = ou de !=, la valeur spécifiée peut contenir le caractère générique * pour signaler une chaîne arbitraire, voire une chaîne vide.

Les attributs de type date, heure ou date/heure sont gérés comme des attributs de type chaîne.

Parfois, les attributs permettent uniquement d'associer des valeurs distinctes. Sauf indication contraire, ces attributs sont gérés comme des attributs de type chaîne.

Syntaxe :

cadsmcmd compgroup action=list filter="(Group type=Query* && Scope=Local)"

Si le filtre est créé à l'aide d'une seule expression, vous ne devez pas utiliser les crochets.

Remarque : Si un attribut figurant dans une expression atomique est erroné ou si un attribut ne s'applique pas à un objet, l'expression atomique est considérée comme vraie, sauf indication contraire.