---
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


---

# Tabellen im Skript werden abgefragt

# Tabellen im Skript werden abgefragt {#ariaid-title1}

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

Mit Methoden in der GlideRecord-API können Sie alle Datensätze aus einer Tabelle zurückgeben, Datensätze aus einer Tabelle zurückgeben, die bestimmte Bedingungen erfüllt, oder Datensätze zurückgeben, die eine Zeichenfolge aus einer einzelnen Tabelle oder aus mehreren Tabellen in einer Textindexgruppe enthalten.

Tabellen mit der GlideRecord-API abfragen. API-Referenz finden Sie unter [GlideRecord: Bereichsbezogen](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.").

## Gibt alle Datensätze aus einer Tabelle zurück {#c_UsingGlideRecordToQueryTables__section_bgd_ryw_g3b}

Um eine Tabelle abzufragen, erstellen Sie zuerst ein GlideRecord-Objekt. Um einen GlideRecord zu erstellen, erstellen Sie Folgendes im Skript:

    var target = new GlideRecord('incident');

Durch das Erstellen eines GlideRecord wird ein erstellt `Ziel `Variable, die ein GlideRecord-Objekt für die Incident-Tabelle ist.  
Fügen Sie das folgende Skript hinzu, um alle Datensätze aus der Incident-Tabelle zu verarbeiten:

    target.query(); // Issue the query to the database to get all records 
    while (target.next()) { 
      // add code here to process the incident record 
    }

Dieses Skript gibt ein Problem mit aus Abfrage() In die Datenbank. Jeder Anruf an Next() Würde den nächsten Datensatz zur Verarbeitung laden.

## Gibt Datensätze aus einer Tabelle zurück, die die Abfragebedingungen erfüllen {#c_UsingGlideRecordToQueryTables__section_thn_tyw_g3b}

Meistens möchten Sie einen bestimmten Datensatz oder einen bestimmten Satz von Datensätzen abrufen, und Sie haben einige Kriterien (Abfragebedingungen), die die Datensätze definieren, die Sie abrufen möchten. Beispiel: Sie möchten alle Incident-Datensätze abrufen, die einen Prioritätswert von 1 haben. Hier ist der Code, der das erreichen würde.

    var target = new GlideRecord('incident'); 
    target.addQuery('priority',1);
    target.query(); // Issue the query to the database to get relevant records 
    while (target.next()) { 
      // add code here to process the incident record 
    }

Beachten Sie, dass das Beispielskript enthält `Target.addQuery('Priority', 1); `. Diese Zeile gibt an, dass Sie nur die Datensätze wünschen, bei denen priorityFeld ist gleich 1. Im Allgemeinen sind die meisten Abfragen, die Sie ausführen möchten, Gleichheitsabfragen. Abfragen, bei denen Sie Datensätze mit einem Feld finden möchten, das einem Wert entspricht. Aus diesem Grund müssen Sie keinen Gleichheitsoperator angeben. Nehmen wir jedoch an, Sie wollten alle Incidents finden, bei denen priorityFeld ist größer als 1. In diesem Fall geben Sie den Operator an, den Sie auf die Abfrage anwenden möchten.

    var target = new GlideRecord('incident') ; 
    target.addQuery('priority','>',1);
    target.query(); // Issue the query to the database to get relevant records 
    while (target.next()) { 
      // add code here to process the incident record 
    }

## Gibt Datensätze aus einer Tabelle zurück, die eine Zeichenfolge enthalten {#c_UsingGlideRecordToQueryTables__section_kwq_3zw_g3b}

Verwenden Sie `„123TEXTQUERY321" `Reservierter Name zum Suchen nach Zeichenfolgenübereinstimmungen in allen Feldern einer Tabelle. Dieses Skript gibt beispielsweise Datensätze aus der Incident-Tabelle mit Feldwerten zurück, die die Zeichenfolge „E-Mail" enthalten.

    var now_GR = new GlideRecord('incident');
    gr.addQuery('123TEXTQUERY321', 'email');
    gr.query();

`„123TEXTQUERY321" `Ist eine reservierte Option für nameParameter in `AddQuery() `Methode. Sie können diese Option in einer codierten Abfragezeichenfolge verwenden. Beispiel: Anstelle von `gr.addQuery('123TEXTQUERY321', 'email'); `, Können Sie verwenden `gr.addEncodedQuery('123TEXTQUERY321=email') `.

Bei der Zeichenfolgensuche wird zwischen Groß- und Kleinschreibung unterschieden. Das System gibt die gleichen Ergebnisse zurück, unabhängig davon, nach denen Sie suchen <kbd class="ph userinput">E-Mail </kbd>, <kbd class="ph userinput">E-Mail </kbd>, Oder <kbd class="ph userinput">E-MAIL </kbd>.  
Hinweis:  
Bevor Sie mit einer Zeichenfolgensuche abfragen können, müssen Sie die Textindizierung (und optional Suchattribute) für die Tabelle konfigurieren, die Sie durchsuchen möchten. Weitere Informationen finden Sie unter [Konfigurieren Sie eine einzelne Tabelle für die Indizierung und Suche](https://www.servicenow.com/docs/access?context=configure-single-table-for-indexing&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## Gibt Datensätze aus mehreren Tabellen in einer Textindexgruppe zurück, die eine Zeichenfolge enthalten {#c_UsingGlideRecordToQueryTables__section_h2m_jzw_g3b}

Verwenden Sie `„123TEXTINDEXGROUP321" `Reservierter Name zum Suchen nach einer Zeichenfolge in einer Tabelle aus einer Textindexgruppe. Diese Option gibt Ergebnisse mit Relevanzpunktzahlen zurück, die anhand der Einstellungen der Textindexgruppe berechnet werden.  
Hinweis:  
Sie können jeweils nur eine Tabelle in der Textindexgruppe abfragen. Verwenden Sie diese Option, wenn Sie mehrere Abfragen mit einer einzelnen Tabelle ausgeben und ihre Ergebnisse zusammenführen und nach Relevanzpunktzahl sortieren möchten. Der Vorteil dieser Option besteht darin, dass die Relevanzpunktzahlen der Suchergebnisse für die einzelnen Tabellenabfragen konsistent für alle Tabellen in der Textindexgruppe normalisiert werden.  
Dieses Skript gibt beispielsweise Datensätze aus der Tabelle „Wissen" zurück, die das Stichwort „E-Mail" enthalten, wobei Relevanzpunktzahlen für die Indexgruppe „Portal" berechnet werden.

    var now_GR = new GlideRecord('kb_knowledge');
    gr.addQuery('123TEXTQUERY321', 'email');
    gr.addQuery('123TEXTINDEXGROUP321', 'portal');
    gr.query();

Sie können eine ähnliche Abfrage für jede zusätzliche Tabelle in der Indexgruppe „Portal" erstellen, die Sie durchsuchen möchten, und dann die Ergebnisse der einzelnen Abfragen zusammenführen, wobei zuerst die Ergebnisse mit den höchsten Relevanzpunktzahlen angezeigt werden. Da alle diese Suchabfragen dieselben Sucheinstellungen für Textindexgruppen verwenden, werden die Relevanzpunktzahlen für ihre Ergebnisse einheitlich normalisiert. Wenn Sie denselben Satz von Tabellen durchsucht haben, ohne zu verwenden `gr.addQuery('123TEXTINDEXGROUP321', 'Portal') `Methode: Die Relevanzpunktzahlen der einzelnen Abfragen würden anders normalisiert und wären keine nützliche Grundlage zum Sortieren des zusammengeführten Ergebnissatzes.

`„123TEXTINDEXGROUP321" `Ist eine reservierte Option für nameParameter in `AddQuery() `Methode. Sie können diese Option in einer codierten Abfragezeichenfolge verwenden. Beispiel: Anstelle von `gr.addQuery('123TEXTINDEXGROUP321', 'Portal'); `, Können Sie verwenden `gr.addEncodedQuery('123TEXTINDEXGROUP321=Portal') `.

Bei der Suche mit mehreren Tabellen wird zwischen Groß- und Kleinschreibung unterschieden. Das System gibt die gleichen Ergebnisse zurück, unabhängig davon, nach denen Sie suchen <kbd class="ph userinput">E-Mail </kbd>, <kbd class="ph userinput">E-Mail </kbd>, Oder <kbd class="ph userinput">E-MAIL </kbd>.  
Hinweis:  
Bevor Sie Tabellen in einer Indexgruppe abfragen können, müssen Sie Textindizierungs- und Suchattribute für diese Tabellen konfigurieren und in die Indexgruppe einschließen. Weitere Informationen finden Sie unter [Konfigurieren Sie mehrere Tabellen für die Indizierung und Suche](https://www.servicenow.com/docs/access?context=index-multiple-tables&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Alle Tabellen in der Indexgruppe müssen das V4-Indexierungsformat verwenden.

## Verfügbare JavaScript-Operatoren {#ariaid-title2}

Beschreibt die Operatoren, die in verwendet werden können AddQuery() Anforderung.
{#r_AvailableJavaScriptOperators__table_pc2_kqj_2p__entry__3}

| Feld | Definition | AddQuery |
|-|-|-|
| = | Feld muss dem angegebenen Wert entsprechen. | AddQuery('Priority', '=', 1); |
| \> | Das Feld muss größer als der angegebene Wert sein. | AddQuery('Priorität', '\>', 1); |
| \< | Das Feld muss kleiner als der angegebene Wert sein. | AddQuery('Priority', '\<', 3); |
| \>= | Das Feld muss gleich oder größer als der angegebene Wert sein. | AddQuery('Priorität', '\>=', 1); |
| \<= | Das Feld muss gleich oder kleiner als der angegebene Wert sein. | AddQuery('Priority', '\<=', 3); |
| != | Feld darf nicht dem angegebenen Wert entsprechen. | AddQuery('Priority', '!=', 1); |
| STARTSWITH | Feld muss mit dem angegebenen Wert beginnen. Das rechts angezeigte Beispiel gibt alle Datensätze zurück, bei denen <var class="keyword varname">Short_description </var>Feld beginnt mit dem Textfehler. | AddQuery('short_description', 'STARTSWITH', 'Fehler'); |
| ENTHÄLT | Das Feld muss den Wert enthalten, der irgendwo im Text angegeben wird. Das rechts angezeigte Beispiel gibt alle Datensätze zurück, bei denen <var class="keyword varname">Short_description </var>Feld enthält den Textfehler an beliebiger Stelle im Feld. Hinweis: Der Vorgang „GEFÄLLT MIR" wird nicht unterstützt. Administratoren müssen „ENTHÄLT" in der Abfrage verwenden. | AddQuery('short_description', 'CONTAINS', 'Error'); |
| IN | Verwendet eine Zuordnung von Werten, die Kommas zulassen, und sammelt eine Sammlung von Datensätzen, die eine andere Anforderung erfüllen. Verhält sich als `Wählen Sie * aus aus aus aus <table>Wobei „short_description" IN („Fehler", „Erfolg", „Fehler") `, Die identisch mit ist `Wählen Sie * aus aus aus aus <table>Wobei short_description='Fehler' `. Um beispielsweise alle Variablenwerte abzufragen, die zu einer bestimmten Aktivität gehören, verwenden Sie die INKlausel, und speichern Sie ihre sys_IDs in einer Karte oder einer kommagetrennten Liste. Fragen Sie dann die Variablenwerttabelle ab, und geben Sie diese Liste der sys_IDs an. | AddQuery('short_description', 'IN', 'Fehler,Erfolg,Fehler'); |
| ENDSWITH | Feld muss mit dem angegebenen Wert enden. Das rechts angezeigte Beispiel gibt alle Datensätze zurück, bei denen <var class="keyword varname">Short_description </var>Feld endet mit Textfehler. | AddQuery('short_description', 'ENDSWITH', 'Fehler'); |
| ENTHÄLT NICHT | Wählt Datensätze aus, die NICHT dem Muster im Feld entsprechen. Dieser Operator ruft keine leeren Felder ab. Verwenden Sie für leere Werte die Operatoren „ist leer" oder „ist nicht leer". Das rechts angezeigte Beispiel gibt alle Datensätze zurück, bei denen <var class="keyword varname">Short_description </var>Feld hat nicht das Wort „Fehler". | AddQuery('short_description', 'ENTHÄLT NICHT', 'Fehler'); |
| NICHT IN | Verwendet eine Zuordnung von Werten, die Kommas zulassen, und sammelt eine Sammlung von Datensätzen, die eine andere Anforderung erfüllen. Verhält sich wie: `Wählen Sie * aus aus aus aus <table>Wobei „short_description" NICHT IN („Fehler") IST `. | AddQuery('short_description', 'NICHT IN', 'Fehler,Erfolg,Fehler'); |
| INSTANZ VON | Spezieller Operator, der nur Datensätze einer angegebenen „Klasse" für erweiterte Tabellen abruft. Das Codebeispiel auf der rechten Seite zeigt, wie alle Konfigurationselemente abgerufen werden, die als Computer klassifiziert sind. | AddQuery('sys_class_Name', 'INSTANCEOF', 'cmdb_ci_Computer'); |
[Tabelle : 1. Verfügbare JavaScript-Operatoren]

{#r_AvailableJavaScriptOperators__table_pc2_kqj_2p}

Weitere Informationen zu den Operatoren, die für Filter und Abfragen verfügbar sind, finden Sie unter [Operators available for filters and queries](https://www.servicenow.com/docs/access?context=r_OpAvailableFiltersQueries&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).  
Es gibt auch einige spezielle Methoden, mit denen Sie nach Daten suchen können, die Null oder NICHT Null sind. Um nach allen Incidents zu suchen, bei denen <var class="keyword varname">Short_description </var>Feld wurde nicht angegeben (ist null). Verwenden Sie die folgende Abfrage:

    var target = new GlideRecord('incident'); 
    target.addNullQuery('short_description');
    target.query(); // Issue the query to the database to get all records 
    while (target.next()) { 
      // add code here to process the incident record 
    }

Um alle Incidents zu finden, in denen ein <var class="keyword varname">Short_description </var>Wurde angegeben. Verwenden Sie die folgende Abfrage:

    var target = new GlideRecord('incident'); 
    target.addNotNullQuery('short_description');
    target.query(); // Issue the query to the database to get all records 
    while (target.next()) { 
      // add code here to process the incident record 
    }

Für weitere Informationen zu GlideRecord API und ihre verfügbaren Methoden, siehe [GlideRecord](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.").

## GlideRecord-Abfragebeispiele {#ariaid-title3}

Diese Beispiele demonstrieren, wie Sie verschiedene Leistungen erbringen können GlideRecord Abfragen.

### query

    var rec = new GlideRecord('incident');
    rec.query(); 
    while(rec.next()) { 
      gs.print(rec.number + ' exists'); }

### Aktualisieren

    var rec = new GlideRecord('incident');
    rec.addQuery('active',true);
    rec.query(); 
    while(rec.next()) { 
      rec.active = false;
      gs.print('Active incident ' + rec.number = ' closed');
      rec.update(); }

### einfügen

    var rec = new GlideRecord('incident');
    rec.initialize();
    rec.short_description = 'Network problem'; 
    rec.caller_id.setDisplayValue('Joe Employee'); 
    rec.insert();

### löschen

    var rec = new GlideRecord('incident');
    rec.addQuery('active',false);
    rec.query(); 
    while(rec.next()) { 
      gs.print('Inactive incident ' + rec.number + ' deleted');
      rec.deleteRecord(); }

### Servicekatalog-Tabellen Werden Abgefragt

Sie können die Variablen der Tabelle „Servicekatalog-Anforderungselement" \[sc_req_item\] nicht direkt abfragen. Fragen Sie stattdessen die Variablenbesitzstabelle \[sc_item_option_mtom\] ab, indem Sie zwei Abfragen hinzufügen, eine für den Variablennamen und eine andere für den Wert. Die Abfrage gibt die viele-zu-viele-Beziehung zurück, die Sie DOT-Walk zum angeforderten Element durchführen können. Das folgende Beispiel sucht nach den Anforderungselementen, die die Variable haben <var class="keyword varname">Elementname </var>Mit einem Wert von <var class="keyword varname">Item_value </var>Und zeigt die Anforderungselementnummern an:

    var now_GR = new GlideRecord('sc_item_option_mtom');
    gr.addQuery('sc_item_option.item_option_new.name','item_name');
    gr.addQuery('sc_item_option.value','item_value');
    gr.query();
     
    while(gr.next()) {
      gs.addInfoMessage(gr.request_item.number); }

Weitere Informationen finden Sie unter [GlideRecord](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.").

