Auswahlkriterien

Auswahlkriterien können aus Attributen, Operatoren und Werten bestehen, die in einer Suchklausel kombiniert werden.

Wenn Sie einem Skript eine Klausel mit Auswahlkriterien hinzufügen, beachten Sie die folgenden Richtlinien:

  • Setzen Sie die gesamten Auswahlkriterien in doppelte Anführungszeichen und die einzelnen Zeichenfolgewerte in einzelne Anführungszeichen.

  • Durch die Gruppierung von Werten können komplexe Klauseln erstellt werden. Beispielsweise “(Job.ID > 100000015) and ((Job.Duplex = ‘Yes’) or (Job.TotalPages > 100))”

  • Job- und Dokumentattribute können nicht in derselben Klausel kombiniert werden.

  • Werte für Datum und Uhrzeit müssen in einem Format angegeben werden, das von einer Textzeichenfolge in einen Zeitstempel konvertiert werden kann. Das entsprechende Format lautet YYYY-MM-DD HH:MI:SS:FFFFFF. Der vollständige Zeitstempel kann gekürzt werden, beispielsweise auf YYYY-MM-DD oder YYYY-MM-DD HH:MI.

Operatoren

In der folgenden Tabelle werden die Operatoren beschrieben, die Sie in Klauseln für Auswahlkriterien verwenden können.

Bediener Beschreibung Beispiel
=, !=, <>, >, >=, <, <= Das sind die verfügbaren Vergleichsoperatoren. “Job.ID = ‘100000015’”
and Gibt Ergebnisse zurück, die alle angegebenen Kriterien erfüllen. In diesem Beispiel werden nur Jobs zurückgegeben, die sowohl eine Job.ID von 100000015 und einen Job.Name haben, der auf "AcmeMortgage" lautet. “Job.ID = ‘100000015’ and Job.Name = ‘AcmeMortgage’”
in Gibt Ergebnisse für Werte zurück, die einer Zugehörigkeit unterliegen. In dem Beispiel werden nur die Ergebnisse für Jobs zurückgegeben, die als Job.ID den Wert 10000015, 10000020 oder 10000023 haben. “Job.ID in (‘10000015’, ‘10000020’, ‘10000023’)”
like Gibt einen Wert zurück, der einem angegebenen Muster entspricht. Sie können die folgenden Platzhalter verwenden.

  • Verwenden Sie den Platzhalter %, um nach der Übereinstimmung mit einer Gruppe von Zeichen zu filtern. In dem Beispiel würde "test%" die Ergebnisse "test", "tests", "tester", "tested" und "testing" zurückgeben.

  • Verwenden Sie den Platzhalter _, um nach der Übereinstimmung mit einer bestimmten Anzahl von Zeichen zu filtern. "test_" würde beispielsweise nur "tests" zurückgeben, "test__" dagegen nur "tester" und "tested".

Ein leerer Wert oder ein leeres Muster wird als leere Zeichenfolge behandelt. 		“Job.Name like ‘test%’”
not Gibt Ergebnisse zurück, die die angegebenen Kriterien nicht erfüllen. Der Operator kann zusammen mit anderen Operatoren verwendet werden. In dem Beispiel werden alle Jobs zurückgegeben, deren Job.ID größer ist als 100000015, mit Ausnahme von 10000020. “Job.ID > ‘100000015’ and not Job.ID = ‘10000020’”
oder Gibt Ergebnisse zurück, die eines oder mehrere der angegebenen Kriterien erfüllen. Für eine Rückgabe müssen die Jobs nicht alle angegebenen Kriterien erfüllen. In dem Beispiel werden Jobs mit dem Job.Name "AcmeMortgage" oder "AcmeInsurance" zurückgegeben. Ein Job müsste nicht zwei Werte für Job.Name enthalten, um die angegebenen Kriterien zu erfüllen. “Job.Name = ‘AcmeMortgage’ or Job.Name = ‘AcmeInsurance’”
Übergeordnetes Thema: Fernzugriff – Grundlagen