Verwenden von Filtern

CADSMCMD Befehlszeilenschnittstelle › Der Befehl "cadsmcmd" › Verwenden von Filtern

Verwenden von Filtern

Filter werden in einigen Auflistungsmethoden verwendet, um den Umfang der aufgelisteten Informationen einzugrenzen.

Sie sind Ausdrücke, die aus Atomic-Ausdrücken mit Operatoren der Aussagenlogik, wie && (und), || (oder) und ! (nicht) zusammengesetzt werden. Dabei gelten folgende Regeln:

Jeder elementare Ausdruck ist ein Filterausdruck.
Wenn exp ein Filterausdruck ist, ist auch !exp ein Filterausdruck.
Wenn "exp1" und "exp2" Filterausdrücke sind, sind auch "(exp1 && exp2)" und "(exp1 || exp2)" Filterausdrücke.

Welche elementaren Ausdrücke gültig sind, ist von den aufzulistenden Objekten abhängig. Die elementaren Ausdrücke haben die folgende Syntax:

attributename operand value

Gültige Attributnamen für neue und bereits vorhandene Auflistungsmethoden finden Sie in den folgenden Kapiteln.

Es gibt verschiedene Attributarten:

Typ	Bedeutung
Zeichenfolge	Der Attributwert ist eine Zeichenfolge.
Long	Der Attributwert ist eine 4-Byte-Ganzzahl.
Datum	Der Attributwert ist ein Datum mit der Struktur JJJJ-MM-TT wobei JJJJ für das Jahr, MM für den Monat und TT für den Tag steht.
Uhrzeit	Der Attributwert ist eine Uhrzeit mit der Struktur "HH:MM", wobei HH die Stunden im 24-Stunden-Format und MM die Minuten bezeichnet.
DateTime	Der Attributwert ist eine zusammengesetzte Angabe von Uhrzeit und Datum nach ISO-Standard mit der Struktur JJJJ-MM-TT HH:MM.

Die folgenden Operanden sind gültig und wahr:

Operand	Zeichenfolge	Long
=	Wenn der Attributwert mit dem angegebenen Wert übereinstimmt.	Wenn der Attributwert mit dem angegebenen Wert identisch ist.
!=	Wenn der Attributwert mit dem angegebenen Wert nicht übereinstimmt.	Wenn der Attributwert mit dem angegebenen Wert nicht identisch ist.
"<"	Wenn der Attributwert lexikografisch geringer als der angegebene Wert ist.	Wenn der Attributwert geringer als der angegebene Wert ist.
">"	Wenn der Attributwert lexikografisch größer als der angegebene Wert ist.	Wenn der Attributwert größer als der angegebene Wert ist.

Bei Verwendung der Operanden "=" oder "!=" darf der angegebene Wert das Platzhalterzeichen '*' enthalten, um die Zeichenfolge als beliebig oder leer zu kennzeichnen.

Attribute des Typs Date, Time und DateTime werden wie Attribute des Typs string behandelt.

In einigen Fällen sind für Attribute nur Kombinationen eindeutiger Werte zulässig. Sofern nichts Gegenteiliges festgelegt ist, werden diese Attribute wie Attribute des Typs "string" behandelt.

Verwendung:

cadsmcmd compgroup action=list filter="(Group type=Group && Scope=local)"

Falls der Filter mit einem einzelnen Ausdruck erstellt wird, müssen keine Klammern verwendet werden.

Hinweis: Falls ein Attribut in einem elementaren Ausdruck fehlerhaft ist oder ein Attribut nicht für ein Objekt gilt, ist der Wert des elementaren Ausdrucks TRUE, sofern nichts Gegenteiliges festgelegt ist.