---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideQueryCondition -- Global

# GlideQueryCondition -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die GlideQueryCondition API bietet zusätzliche `UND `Oder `ODER `Bedingungen, die der aktuellen Bedingung hinzugefügt werden können, sodass Sie komplexe Abfragen erstellen können.  
Komplexe Abfragen erstellen, z. B.:

    category='hardware' OR category='software' AND priority='2' AND priority='1'

Im Fall von AddCondition() , Implizit `UND `Wird hinzugefügt.  
Diese Klasse hat keinen Konstruktor. Ein GlideQueryCondition-Objekt wird mit den folgenden Methoden zurückgegeben:

* AddActiveQuery()
* AddInactiveQuery()
* AddJoinQuery()
* AddNotNullQuery()
* AddNullQuery()
* AddQuery()
{#c_GlideQueryConditionAPI__ul_xyz_nsg_qz}

Wenn ein komplizierter Satz von vorhanden ist `UND `Und `ODER `Abfragen, eine einzelne codierte Abfrage, die alle Bedingungen enthält, vereinfacht die Abfrageerstellung. Um die Abfrageerstellung zu vereinfachen, erstellen Sie eine Abfrage in einer Listenansicht, klicken Sie mit der rechten Maustaste auf die Abfrage, und wählen Sie aus Abfrage kopieren . Erstellt eine einzelne codierte Abfragezeichenfolge, um Ihren Ergebnissatz zurückzugeben. Verwenden Sie diese Zeichenfolge als Parameter in AddEncodedQuery() Methodenaufruf.

Testen Sie Abfragen immer auf einer Subproduktionsinstanz, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch konstruierte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, erzeugt eine ungültige Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung verworfen, und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Mit Einfügen() , Aktualisieren () , DeleteRecord() , Oder DeleteMultiple() Die Methode für fehlerhafte Abfrageergebnisse kann zu Datenverlust führen.

Sie können festlegen glide.invalid_query.returns_no_rowsSystemeigenschaft auf „wahr", damit Abfragen mit ungültigen codierten Abfragen keine Datensätze zurückgeben. In einigen Fällen kann die Abfrage weiterhin Datensätze in API-Ergebnissen zurückgeben, auch wenn glide.invalid_query.returns_no_rowsIst auf „wahr" festgelegt. Dies geschieht in Abfragen, bei denen ein ungültiger Abfragebegriff mit einem WHERE-Operator verwendet wird. In solchen Abfragen ignoriert der WHERE-Operator die ungültigen Begriffe, interpretiert jedoch den Rest der Abfrageanweisung und gibt ihn zurück. Weitere Informationen zu dieser Systemeigenschaft und ihrer Funktionalität finden Sie unter [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## GlideQueryCondition -- addCondition (Zeichenfolgenname, Zeichenfolgenoperator, Objektwert) {#ariaid-title2}

Fügt der aktuellen Bedingung eine UND-Bedingung hinzu.
{#GQC-addCondition_S_S_O__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name eines Felds. |
| betrieb | Zeichenfolge | (Optional) der Operator für die Abfrage. Wenn Sie keinen Operator angeben, verwendet die Bedingung einen gleich-Operator. |
| Wert | Objekt | Der Wert, nach dem abgefragt werden soll. |
[Tabelle : 1. Parameter]

{#GQC-addCondition_S_S_O__table_vy2_525_jq}  
{#GQC-addCondition_S_S_O__table_mxx_f5b_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Ein Verweis auf ein GlideQueryBedingung Der dem GlideRecord hinzugefügt wurde. |
[Tabelle : 2. Rückgaben]

{#GQC-addCondition_S_S_O__table_mxx_f5b_2r}  

    var now_GR = new GlideRecord('incident');
    var qc = now_GR.addQuery('category', 'Hardware');
    qc.addCondition('category', 'Network');
    now_GR.addQuery('number','INC0000003');
    now_GR.next();
    now_GR.number;
    gs.info(now_GR.getEncodedQuery());

### Bereichsbezogenes Äquivalent {#GQC-addCondition_S_S_O__section_cgd_h3n_g1b}

Zur Verwendung von AddCondition() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [AddCondition()](https://servicenow-prod.fluidtopics.net/q_iR2gj9SIaEnZW~OgtEGw#r_ScopedGlideQueryConditionAddCondition "Fügt der aktuellen Bedingung eine UND-Bedingung hinzu.").

## GlideQueryCondition -- addOrCondition (Zeichenfolgenname, Zeichenfolgenoperator, Objektwert) {#ariaid-title3}

Hängt einen 2-oder-3-Parameter ODER eine Bedingung an eine vorhandene GlideQueryCondition an.
AddOrCondition() Funktioniert in Verbindung mit einem der [AddQuery()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordAddQuery_String_String_Object "Bietet die Möglichkeit, eine Anforderung zu erstellen, die bei Ausführung die Zeilen aus der angegebenen Tabelle zurückgibt, die der Anforderung entsprechen.")Methoden bis `ODER `Die angegebenen Abfrageparameter für die zuvor mit erstellte Abfrage AddQuery() .

AddOrCondition() Wird normalerweise mit drei Parametern aufgerufen: Tabellenfeld, Operator und Vergleichswert. Es kann nur mit zwei Parametern aufgerufen werden, dem Tabellenfeld und dem Vergleichswert, z. B. `qc.addOrCondition('category', 'Software'); `. Der Operator in diesem Fall wird als „gleich" angenommen.  
{#GQC-addOrCondition_S_S_O__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Feldname |
| betrieb | Zeichenfolge | (Optional) Abfrageoperator. Die verfügbaren Werte hängen vom Datentyp von ab <var class="keyword varname">Wert </var>Parameter. Nummern: * = * != * \> * \>= * \< * \<= {#GQC-addOrCondition_S_S_O__ul_qyb_rbt_3y} Zeichenfolgen (muss in Großbuchstaben angegeben werden): * = * != * IN * STARTSWITH * ENDSWITH * ENTHÄLT * DOESNOTCONTAIN {#GQC-addOrCondition_S_S_O__ul_egz_vbt_3y} |
| Wert | Objekt | Wert, für den abgefragt werden soll (Groß-/Kleinschreibung wird nicht beachtet). Hinweis: Alle übergebenen Arrays müssen mindestens zwei Elemente enthalten. Einzelne Element-Arrays werden nicht unterstützt. |
[Tabelle : 3. Parameter]

{#GQC-addOrCondition_S_S_O__table_vy2_525_jq}  
{#GQC-addOrCondition_S_S_O__table_w2h_w2c_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Ein Verweis auf eine GlideQueryConditon, die dem GlideRecord hinzugefügt wurde. |
[Tabelle : 4. Rückgaben]

{#GQC-addOrCondition_S_S_O__table_w2h_w2c_2r}  

    var now_GR = new GlideRecord('incident');
    var qc = now_GR.addQuery('category', 'Hardware');
    qc.addOrCondition('category', 'Network');
    now_GR.addQuery('number','INC0000003');
    now_GR.next();
    now_GR.number;
    gs.info(now_GR.getEncodedQuery());

Zu Gruppieren UND/ODER Anweisungen wie `(status < 3 ODER Status > 5) UND (Priorität = 1 ODER Priorität = 5) `Verwenden Sie Code ähnlich dem folgenden:

    var myObj = new GlideRecord('incident');
    var q1 = myObj.addQuery('state', '<', 3);
    q1.addOrCondition('state', '>', 5);
    var q2 = myObj.addQuery('priority', 1);
    q2.addOrCondition('priority', 5);
    myObj.query();

### Bereichsbezogenes Äquivalent {#GQC-addOrCondition_S_S_O__section_cgd_h3n_g1b}

Zur Verwendung von AddOrCondition() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [AddOrCondition()](https://servicenow-prod.fluidtopics.net/q_iR2gj9SIaEnZW~OgtEGw#r_ScopedGlideQueryConditionAddOrCondition "Hängt einen zwei- oder drei-Parameter ODER eine Bedingung an eine vorhandene GlideQueryCondition an.").

