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


---

# GlideRecord -- Umfang

# GlideRecord -- Umfang {#ariaid-title1}

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

Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.
Die GlideRecord API ist das primäre Mittel für die Verbindung mit der Datenbank auf dem serverseitigen Code. Ein GlideRecord ist ein Objekt, das Datensätze aus einer einzelnen Tabelle enthält. Verwenden Sie die API, um ein GlideRecord-Objekt zu instanziieren und Abfrageparameter, Filter, Grenzwerte und Reihenfolge hinzuzufügen.

Siehe [GlideRecord](https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord)artikel mit Details zum Erstellen und Ausführen von Abfragen.

Für Informationen zu einer Klasse, die dieselben Funktionen wie ausführt GlideRecord Und erzwingt ACLs, siehe [Mit GlideRecordSecure](https://www.servicenow.com/docs/access?context=p_GlideServerAPIs&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

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

## Ruft Werte aus Datensätzen ab {#c_GlideRecordScopedAPI__id_tvw_lbc_npb}

Verwenden Sie in den meisten Fällen kein Dot-Walking, um Werte aus einem Datensatz abzurufen. DOT-Walking ruft das gesamte Objekt anstelle des Feldwerts ab. Das Abrufen des Objekts verwendet mehr Speicher und kann bei Verwendung in Arrays oder zu unerwünschten Ergebnissen führen Serviceportal.{#c_GlideRecordScopedAPI__gr-api-dot-walk-recommendations-p1}

Anstatt das gesamte Objekt abzurufen, können Sie eine der folgenden Methoden verwenden, um die Feldwerte zu kopieren:{#c_GlideRecordScopedAPI__gr-api-dot-walk-recommendations-p2}

* [GetValue()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordGetValue_String "Ruft den Zeichenfolgenwert eines zugrunde liegenden Elements in einem Feld ab.")
* [GetDisplayValue()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordGetDisplayValue "Ruft den Anzeigewert für den aktuellen Datensatz ab.")

{#c_GlideRecordScopedAPI__gr-api-dot-walk-recommendation-lnx}  
Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die Manager-sys_ID des aktuellen Anrufers, um ein anderes Referenzfeld festzulegen. Das folgende Beispiel zeigt, wie der Zeichenfolgenwert anstelle des gesamten Objekts abgerufen wird:

    var mgr = current.caller_id.manager.toString();

Siehe auch:

* [GlideAggregat](https://servicenow-prod.fluidtopics.net/aD6zULgUJntUCYyTZz592Q#c_GlideAggregateScopedAPI "Die GlideAggregat API ermöglicht das Erstellen von Datenbankzusammenfassungsabfragen.")
* [GlideElement](https://servicenow-prod.fluidtopics.net/KE~S6OltJSBoK4CG8haHCw#c_GlideElementScopedAPI "Der Umfang ist festgelegt GlideElement Die API bietet eine Reihe praktischer Skriptmethoden für den Umgang mit Feldern und ihren Werten. Bereichsbezogen GlideElement Methoden sind für die Felder des aktuellen Glide-Datensatzes verfügbar.")
* [GlideQuery](https://servicenow-prod.fluidtopics.net/HnOBGn4sQE9zFCIlhCGCFw#GlideQueryGlobalAPI "Die GlideQuery Die Skripteinbindung ist eine Alternative zu GlideRecord API zum Ausführen von CRUD-Vorgängen für Datensatzdaten aus serverseitigen Skripts.")
{#c_GlideRecordScopedAPI__ul_mky_nkd_npb}

## Bereichsbezogener GlideRecord -- addActiveQuery() {#ariaid-title2}

Fügt einen Filter hinzu, um aktive Datensätze zurückzugeben.
{#SGR-addActiveQuery__table_n2r_tdq_fz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#SGR-addActiveQuery__table_n2r_tdq_fz} {#SGR-addActiveQuery__table_o2r_tdq_fz__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Filter, um aktive Datensätze zurückzugeben. |
[Tabelle : 2. Rückgaben]

{#SGR-addActiveQuery__table_o2r_tdq_fz}  

    var inc = new GlideRecord('incident');
    inc.addActiveQuery();
    inc.query();

## Bereichsbezogener GlideRecord -- addEncodedQuery(Zeichenfolgenabfrage, boolescher enforceFieldACL) {#ariaid-title3}

Fügt anderen Abfragen, die möglicherweise festgelegt wurden, eine codierte Abfrage hinzu.
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).
{#r_ScopedGlideRecordAddEncodedQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Ein [Codierte Abfragezeichenfolge](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). |
| EnforceFieldACL | Boolean | Optional. Kennzeichnung, die angibt, ob Feld-ACL-Regeln (Zugriffssteuerungsliste) erzwungen werden sollen. Gültige Werte: * Wahr: Feld-ACLs erzwingen. * Falsch: Feld-ACLs nicht erzwingen. Standard: Falsch |
[Tabelle : 3. Parameter]

{#r_ScopedGlideRecordAddEncodedQuery_String__table_vy2_525_jq} {#r_ScopedGlideRecordAddEncodedQuery_String__table_up3_d5b_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

{#r_ScopedGlideRecordAddEncodedQuery_String__table_up3_d5b_2r}  

    var queryString = "priority=1^ORpriority=2";
    var now_GR = new GlideRecord('incident');
    now_GR.addEncodedQuery(queryString);
    now_GR.query();
    while (now_GR.next()) {
      gs.addInfoMessage(now_GR.getValue('number'));
    }

## Bereichsbezogener GlideRecord -- addFunction(Objektfunktion) {#ariaid-title4}

Wendet ein vordefiniertes GlideDBFunctionBuilder-Objekt auf einen Datensatz an.
Verwenden Sie GlideDBFunctionBuilder Bereichsbezogene Klasse zum Definieren einer Funktion. Nachdem die Funktion definiert wurde, verwenden Sie AddFunction (Objektfunktion) Methode zum Anwenden der Funktion auf einen Datensatz.
{#r_ScopedGlideRecordAddFunction_O__table_mkh_dnk_kbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Funktion | Objekt | GlideDBFunctionBuilder-Objekt, das einen SQL-Vorgang definiert. |
[Tabelle : 5. Parameter]

{#r_ScopedGlideRecordAddFunction_O__table_mkh_dnk_kbb} {#r_ScopedGlideRecordAddFunction_O__table_nkh_dnk_kbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 6. Rückgaben]

{#r_ScopedGlideRecordAddFunction_O__table_nkh_dnk_kbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();

    // Query incidents in which order + priority is less than 5 and display that added value
    var now_GR = new GlideRecord('incident');
    now_GR.addFunction(myAddingFunction);
    now_GR.addQuery(myAddingFunction, '<', 5);
    now_GR.query();
    while(now_GR.next())
      gs.info(now_GR.getValue(myAddingFunction));

Ausgabe:

    1
    4
    3
    1
    1
    2
    1

## Bereichsbezogener GlideRecord -- addJoinQuery (Zeichenfolge verknüpfungTabelle, Zeichenfolge primaryField, Zeichenfolge verknüpfungTableField) {#ariaid-title5}

Fügt einen Filter hinzu, um Datensätze basierend auf einer Beziehung in einer Tabelle zurückzugeben, die sich auf den aktuellen GlideRecord bezieht.
Sie können diese Methode verwenden, um alle Anwender in der Datenbankgruppe über die Tabelle „Gruppenmitglied" \[sys_user_grmember\] zu finden, oder um alle Probleme zu finden, denen ein Incident über die Beziehung „incident.problem_id zugewiesen ist.

Dies ist kein echter Datenbank-Join. AddJoinQuery() Fügt eine Unterabfrage hinzu. Obwohl der Ergebnissatz basierend auf dem Join eingeschränkt ist, haben Sie Zugriff auf die einzigen Felder in der Basistabelle (diejenigen, die sich in der Tabelle befinden, mit der der GlideRecord initialisiert wurde).

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).
{#r_ScopedGlideRecordAddJoinQuery_String_Object_Object__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| JoinTable | Zeichenfolge | Name der Tabelle, die im Join verwendet werden soll, z. B. 'incident'. |
| PrimaryField | Zeichenfolge | Optional. Name des Felds im GlideRecord, das zum Verbinden des in angegebenen Felds verwendet werden soll joinTableFieldParameter. Standard: sys_ID |
| Feld „JoinTableField" | Zeichenfolge | Optional. Name des Felds in der in angegebenen Tabelle joinTableZur Verwendung zum Verbinden der Tabellen. Standard: Erstes Feld in der in angegebenen Tabelle joinTableDies ist ein Referenzfeld zur aktuellen GlideRecord-Tabelle. |
[Tabelle : 7. Parameter]

{#r_ScopedGlideRecordAddJoinQuery_String_Object_Object__table_vy2_525_jq} {#r_ScopedGlideRecordAddJoinQuery_String_Object_Object__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Filter, der Datensätze auflistet, bei denen die Beziehungen übereinstimmen. |
[Tabelle : 8. Rückgaben]

{#r_ScopedGlideRecordAddJoinQuery_String_Object_Object__table_qpt_3f5_jq}  
Suchen Sie nach Problemen, an die ein Incident angehängt ist. Dieses Beispiel gibt Probleme zurück, denen Incidents zugeordnet sind. Es werden jedoch keine Werte aus den Incidents abgerufen, die als Teil der Abfrage zurückgegeben werden.

    var prob = new GlideRecord('problem');
    prob.addJoinQuery('incident');
    prob.query();

Suchen Sie inaktive Probleme mit zugehörigen Incidents.

    // Look for Problem records that have associated Incident records
    var now_GR = new GlideRecord('problem');
    var grSQ = now_GR.addJoinQuery('incident');
     
    // Where the Problem records are "active=false"
    now_GR.addQuery('active', 'false');
     
    // And the Incident records are "active=true"
    grSQ.addCondition('active', 'true');
     
    // Query
    now_GR.query();
     
    // Iterate and output results
    while (now_GR.next()) {
    gs.info(now_GR.getValue('number'));
    }

Suchen Sie Probleme, denen Incidents zugeordnet sind, denen der Incident zugeordnet ist caller_idDer Feldwert stimmt mit dem des Problems überein opened_byFeld.

    var now_GR = new GlideRecord('problem'); 
            now_GR.addJoinQuery('incident', 'opened_by', 'caller_id'); 
            now_GR.query();

## Bereichsbezogener GlideRecord -- addNotNullQuery(String fieldName) {#ariaid-title6}

Ein Filter, der Datensätze angibt, bei denen der Wert des im Parameter übergebenen Felds nicht null ist.
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).
{#r_ScopedGlideRecordAddNotNullQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Name des zu prüfenden Felds. |
[Tabelle : 9. Parameter]

{#r_ScopedGlideRecordAddNotNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideRecordAddNotNullQuery_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Ein Filter, der Datensätze angibt, bei denen der Wert des im Parameter übergebenen Felds nicht null ist. |
[Tabelle : 10. Rückgaben]

{#r_ScopedGlideRecordAddNotNullQuery_String__table_qpt_3f5_jq}  

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

## Bereichsbezogener GlideRecord -- addNullQuery(String fieldName) {#ariaid-title7}

Fügt einen Filter hinzu, um Datensätze zurückzugeben, bei denen der Wert des angegebenen Felds null ist.
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).
{#r_ScopedGlideRecordAddNullQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Name des zu prüfenden Felds. |
[Tabelle : 11. Parameter]

{#r_ScopedGlideRecordAddNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideRecordAddNullQuery_String__table_sp2_b5b_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Die Abfragebedingung, die dem GlideRecord hinzugefügt wurde. |
[Tabelle : 12. Rückgaben]

{#r_ScopedGlideRecordAddNullQuery_String__table_sp2_b5b_2r}  

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

## Bereichsbezogener GlideRecord -- addQuery(Zeichenfolgenabfrage) {#ariaid-title8}

Fügt einen Filter hinzu, um Datensätze mithilfe einer codierten Abfragezeichenfolge zurückzugeben.
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).
{#r_ScopedGlideRecordAddQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Ein [Codierte Abfragezeichenfolge](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). |
[Tabelle : 13. Parameter]

{#r_ScopedGlideRecordAddQuery_String__table_vy2_525_jq} {#r_ScopedGlideRecordAddQuery_String__table_nqz_ztb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Die Abfragebedingung, die dem GlideRecord hinzugefügt wurde. |
[Tabelle : 14. Rückgaben]

{#r_ScopedGlideRecordAddQuery_String__table_nqz_ztb_2r}  

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

## Bereichsbezogener GlideRecord -- addQuery(Zeichenfolgenname, Objektwert) {#ariaid-title9}

Erstellen Sie eine Suchabfrage, und geben Sie die Zeilen zurück, die der Anforderung entsprechen.
Wenn Sie mit SQL vertraut sind, ähnelt diese Methode der Klausel „Where". Mindestens eins AddQuery() Aufrufe können in einer einzelnen Abfrage erfolgen. In diesem Fall sind die Abfragen UND'ed. Wenn eine der Abfrageanweisungen ODER sein muss, verwenden Sie GlideQueryCondition 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.").

Wann AddQuery() Wird mit nur zwei Parametern aufgerufen, Tabellenname und Vergleichswert, z. B. `MyObj.addQuery('category','Hardware'); `, Der Operator wird als „gleich" angenommen.

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).
{#r_ScopedGlideRecordAddQuery_String_Object__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des abzufragenden Tabellenfelds oder einer der folgenden reservierten Namen: * 123TEXTQUERY321: Fügt der Abfrage einen Zeichenfolgensuchbegriff hinzu. Geben Sie die Zeichenfolge an, die Sie als Wert abgleichen möchten. Verwenden Sie diese Option, um Datensätze mit Feldwerten zurückzugeben, die die Suchzeichenfolge enthalten. Diese Option sucht nach allen Feldern in der Tabelle, die für die Indizierung und Suche konfiguriert werden müssen. Weitere Informationen zum Konfigurieren von Tabellen für die Indizierung und Suche 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). * 123TEXTINDEXGROUP321: Fügt der Abfrage eine Textindexgruppe hinzu. Geben Sie den Namen der Textindexgruppe aus der Tabelle „Textindexgruppen" \[ts_index_Group\] an, die Sie als Wert abfragen möchten. Verwenden Sie diese Option, um Suchergebnisse aus einer der Tabellen in einer Textindexgruppe zurückzugeben, wobei die Ergebnisrelevanzpunktzahlen mithilfe der Einstellungen dieser Textindexgruppe normalisiert werden. Weitere Informationen zum Konfigurieren von Textindexgruppen 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). {#r_ScopedGlideRecordAddQuery_String_Object__ul_e5c_slk_xhb} Hinweis: Weitere Informationen zur Verwendung der reservierten Namen finden Sie unter [Tabellen im Skript werden abgefragt](https://servicenow-prod.fluidtopics.net/Ei8H4_Ts5cukzzD~KWm7GQ#c_UsingGlideRecordToQueryTables "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."). |
| Wert | Objekt | Wert, für den abgefragt werden soll (Groß-/Kleinschreibung wird nicht beachtet). |
[Tabelle : 15. Parameter]

{#r_ScopedGlideRecordAddQuery_String_Object__table_vy2_525_jq} {#r_ScopedGlideRecordAddQuery_String_Object__table_pd3_ytb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Abfragebedingung wurde dem GlideRecord hinzugefügt. |
[Tabelle : 16. Rückgaben]

{#r_ScopedGlideRecordAddQuery_String_Object__table_pd3_ytb_2r}  
Dieses Codebeispiel zeigt, wie die aktiven Datensätze in der Incident-Tabelle abgefragt und dann alle auf „inaktiv" festgelegt werden.

    var rec = new GlideRecord('incident');
    rec.addQuery('active', true);
    rec.query();
    while (rec.next()) {
      rec.setValue('active', false);
      rec.update();
    }

Dieses Codebeispiel fügt eine Abfrage für Datensätze hinzu, die mit „E-Mail-Server" in der Tabelle „kb_Knowledge" übereinstimmen, wobei Suchergebnisrelevanzwerte anhand von Einstellungen aus der Portaltextindexgruppe berechnet werden.

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

## Bereichsbezogener GlideRecord -- addQuery(Zeichenfolgenname, Zeichenfolgenoperator, Objektwert) {#ariaid-title10}

Bietet die Möglichkeit, eine Anforderung zu erstellen, die bei Ausführung die Zeilen aus der angegebenen Tabelle zurückgibt, die der Anforderung entsprechen.
Wenn Sie mit SQL vertraut sind, ähnelt diese Methode der Klausel „Where". Mindestens eins AddQuery() Aufrufe können in einer einzelnen Abfrage erfolgen. In diesem Fall sind die Abfragen UND'ed. Wenn eine der Abfrageanweisungen ODER sein muss, verwenden Sie GlideQueryCondition 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.").

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).
{#r_ScopedGlideRecordAddQuery_String_String_Object__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Tabellenfeldname. |
| operator | Zeichenfolge | Abfrageoperator. Die verfügbaren Werte hängen vom Datentyp von ab <var class="keyword varname">Wert </var>Parameter. Nummern: * = * != * \> * \>= * \< * \<= {#r_ScopedGlideRecordAddQuery_String_String_Object__ul_qyb_rbt_3y} Zeichenfolgen (muss in Großbuchstaben angegeben werden): * = * != * IN * NICHT IN * STARTSWITH * ENDSWITH * ENTHÄLT * ENTHÄLT NICHT * INSTANZ VON {#r_ScopedGlideRecordAddQuery_String_String_Object__ul_egz_vbt_3y} Hinweis: Verwenden Sie „ENTHÄLT" anstelle des „GEFÄLLT MIR"-Operators. |
| Wert | Objekt | Wert, für den abgefragt werden soll (Groß-/Kleinschreibung wird nicht beachtet). |
[Tabelle : 17. Parameter]

{#r_ScopedGlideRecordAddQuery_String_String_Object__table_vy2_525_jq} {#r_ScopedGlideRecordAddQuery_String_String_Object__table_gty_wtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Die Abfragebedingung, die dem GlideRecord hinzugefügt wurde. |
[Tabelle : 18. Rückgaben]

{#r_ScopedGlideRecordAddQuery_String_String_Object__table_gty_wtb_2r}  

    var rec = new GlideRecord('incident');
    rec.addQuery('active',true);
    rec.addQuery('sys_created_on', ">", "2010-01-19 04:05:00");
    rec.query();
    while (rec.next()) {
      rec.setValue('active', false);
      gs.info('Active incident ' + rec.getValue('number') + ' closed');
      rec.update();
    }

Mit dem Operator IN.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('number','IN','INC00001,INC00002');
    now_GR.query();
    while(now_GR.next()) {
      //do something....
    }

## Bereichsbezogener GlideRecord -- addValue(Zeichenfolgenfeld, Zahlenwert) {#ariaid-title11}

Stellt atomare Add- und Subtraktionsvorgänge für ein angegebenes Nummernfeld auf Datenbankebene für das aktuelle GlideRecord-Objekt bereit.
Normalerweise wird ein GlideRecord-Objekt als ein Datensatz in einer Datenbank geschrieben. Einzelne Feldwerte werden wie definiert gespeichert. Für Code, der einem GlideRecord-Feld einen Wert hinzufügt, wird das Feld einfach mit dem neuen Wert in der Datenbank gespeichert, anstatt es atomar zu erhöhen.  
Wenn beispielsweise der folgende Code ausgeführt wird, der Wert von <var class="keyword varname">u_count </var>Feld in der Datenbank ist 2.

    gs.info(now_GR.u_count); // "1" 
    now_GR.u_count += 1;
    now_GR.update();
    now_GR.get(now_GR.sys_id);
    gs.info(now_GR.u_count); // "2"

Wenn ein anderer Anwender gleichzeitig identischen Code ausführt, anstelle der beiden Vorgänge, die jeweils 1 zu hinzufügen <var class="keyword varname">u_count </var>, Der Nettoeffekt ist das <var class="keyword varname">u_count </var>Enthält nur 2, wobei das Update eines Vorgangs tatsächlich verloren geht.  
Umgekehrt wird AddValue() Die Methode führt die Hinzufügung/Subtraktion in der Datenbank durch, wenn der Datensatz als atomarer Vorgang aktualisiert wird. Zwei Vorgänge, die gleichzeitig ausgeführt werden, aktualisieren das Feld ordnungsgemäß.

    gs.info(now_GR.u_count); // "1" 
    now_GR.addValue("u_count", 1); 
    now_GR.update(); 
    now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
    gs.info(now_GR.u_count); // "3", if executed concurrently with another user 

Hinweis:  
Der neue Wert wird nicht aus der Datenbank zurückgelesen, es sei denn, dies wurde explizit getan.

Gefällt Mir SetWert() , AddValue() Änderungen werden erst nach einem nachfolgenden Aufruf von in der Datenbank wirksam Aktualisieren () Oder Einfügen() . Wenn Einfügen() Wird aufgerufen, wird das angegebene Feld mit initialisiert valueParameter an übergeben AddValue() .  
Hinweis:  
Wenn SetWert() Wird für das angegebene Feld vor dem Aufruf aufgerufen AddValue() , AddValue() Methode wird nicht verarbeitet, und eine Fehlermeldung wird protokolliert.
{#SGR-addValue_S_N__table_h43_tjt_hlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Name des Felds in diesem GlideRecord, das geändert werden soll. Hinweis: Der Datentyp des zugeordneten Felds muss eine Ganzzahl sein. Diese Methode unterstützt keine anderen Datentypen wie Longs. |
| Wert | Ganzzahl | Betrag, der dem Wert hinzugefügt werden soll, wenn der Datensatz gespeichert wird. Um einen Subtraktionsvorgang auszuführen, übergeben Sie einfach einen negativen Wert. |
[Tabelle : 19. Parameter]

{#SGR-addValue_S_N__table_h43_tjt_hlb} {#SGR-addValue_S_N__table_i43_tjt_hlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 20. Rückgaben]

{#SGR-addValue_S_N__table_i43_tjt_hlb}  
Zeigt einen hinzugefügten Wert an.

    gs.info(now_GR.u_count); // "1" 
    now_GR.addValue("u_count", 1); 
    now_GR.update(); 
    now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
    gs.info(now_GR.u_count);

Ausgabe:

    2

Zeigt einen subtrahierten Wert an.

    gs.info(now_GR.u_count); // "4" 
    now_GR.addValue("u_count", -1); 
    now_GR.update(); 
    now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
    gs.info(now_GR.u_count);

Ausgabe:

    3

## Bereichsbezogener GlideRecord -- applyEncodedQuery(Zeichenfolge QueryString) {#ariaid-title12}

Legt die Werte der angegebenen codierten Abfragebegriffe fest und wendet sie auf den aktuellen GlideRecord an.
{#SGR-applyEncodedQuery_S__table_p5j_nfg_rmb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Abfragezeichenfolge | Zeichenfolge | Codierte Abfrage, die auf den aktuellen GlideRecord angewendet werden soll. |
[Tabelle : 21. Parameter]

{#SGR-applyEncodedQuery_S__table_p5j_nfg_rmb} {#SGR-applyEncodedQuery_S__table_q5j_nfg_rmb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 22. Rückgaben]

{#SGR-applyEncodedQuery_S__table_q5j_nfg_rmb}  
<br />

    function createAcl(table, role) {
      gs.info("Checking security on table " + table);
      var now_GR = new GlideRecord("sys_security_acl");
      now_GR.addQuery("name", table);
      now_GR.addQuery("operation", "read");
      now_GR.query();
      var encQuery = now_GR.getEncodedQuery();
      if (now_GR.next()) {
      // existing acl found so use it
        createAclRole(now_GR.getValue('sys_id'), role);
        return;
      } else {
        now_GR.initialize();
        now_GR.applyEncodedQuery(encQuery);
        var acl = now_GR.insert();
        gs.info("Added read access control on " + table);
        createAclRole(acl, role);
      }
    }

## Bereichsbezogener GlideRecord -- canCreate() {#ariaid-title13}

Bestimmt, ob die Zugriffssteuerungsregeln, die die Rollen des Anwenders enthalten, das Einfügen neuer Datensätze in diese Tabelle zulassen.
{#r_ScopedGlideRecordCanCreate__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 23. Parameter]

{#r_ScopedGlideRecordCanCreate__table_vy2_535_jq} {#r_ScopedGlideRecordCanCreate__table_g2l_vtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Rollen des Anwenders die Erstellung von Datensätzen in dieser Tabelle zulassen. Gültige Werte: * Wahr: Erstellen zulässig * Falsch: Erstellen ist nicht zulässig {#r_ScopedGlideRecordCanCreate__ul_vtm_pf2_t3b} |
[Tabelle : 24. Rückgaben]

{#r_ScopedGlideRecordCanCreate__table_g2l_vtb_2r}  
Dieses Codebeispiel schreibt, ob der aktuelle Anwender Datensätze in der Incident-Tabelle im Systemprotokoll erstellen kann.

    var now_GR = new GlideRecord('incident');
    gs.info(now_GR.canCreate());

## Bereichsbezogener GlideRecord -- canDelete() {#ariaid-title14}

Bestimmt, ob die Zugriffssteuerungsregeln, die die Rollen des Anwenders enthalten, das Löschen von Datensätzen in dieser Tabelle zulassen.
{#r_ScopedGlideRecordCanDelete__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 25. Parameter]

{#r_ScopedGlideRecordCanDelete__table_vy2_535_jq} {#r_ScopedGlideRecordCanDelete__table_pdw_ftb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Rollen des Anwenders das Löschen von Datensätzen in dieser Tabelle zulassen. Gültige Werte: * Wahr: Löschen zulässig * Falsch: Löschen ist nicht zulässig {#r_ScopedGlideRecordCanDelete__ul_vtm_pf2_t3b} |
[Tabelle : 26. Rückgaben]

{#r_ScopedGlideRecordCanDelete__table_pdw_ftb_2r}  
Dieses Codebeispiel schreibt, ob der aktuelle Anwender Datensätze in der Incident-Tabelle im Systemprotokoll löschen kann.

    var att = new GlideRecord('sys_attachment');
    gs.info(att.canDelete());

## Bereichsbezogener GlideRecord -- canRead() {#ariaid-title15}

Bestimmt, ob die Zugriffssteuerungsregeln (ACLs) das Lesen von Datensätzen in dieser Tabelle zulassen. Diese Methode wertet alle ACL-Typen aus, z. B. Anwenderrollen, geskriptete ACLs, ACLs mit geskripteten Bedingungen usw.
{#r_ScopedGlideRecordCanRead__table_vy2_5335_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 27. Parameter]

{#r_ScopedGlideRecordCanRead__table_vy2_5335_jq} {#r_ScopedGlideRecordCanRead__table_zmp_ttb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Rollen des Anwenders das Lesen von Datensätzen in dieser Tabelle zulassen. Gültige Werte: * Wahr: Lesen zulässig * Falsch: Lesen ist nicht zulässig {#r_ScopedGlideRecordCanRead__ul_vtm_pf2_t3b} |
[Tabelle : 28. Rückgaben]

{#r_ScopedGlideRecordCanRead__table_zmp_ttb_2r}  
Dieses Codebeispiel schreibt, ob der aktuelle Anwender Datensätze in der Incident-Tabelle im Systemprotokoll lesen kann.

    var now_GR = new GlideRecord('incident');
    gs.info(now_GR.canRead());

## Bereichsbezogener GlideRecord -- canWrite() {#ariaid-title16}

Bestimmt, ob die Zugriffssteuerungsregeln, die die Rollen des Anwenders enthalten, die Bearbeitung von Datensätzen in dieser Tabelle zulassen.
{#r_ScopedGlideRecordCanWrite__table_vxy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 29. Parameter]

{#r_ScopedGlideRecordCanWrite__table_vxy2_535_jq} {#r_ScopedGlideRecordCanWrite__table_sq3_ttb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Rollen des Anwenders das Schreiben von Datensätzen in dieser Tabelle zulassen. Gültige Werte: * Wahr: Schreiben zulässig * Falsch: Schreiben ist nicht zulässig |
[Tabelle : 30. Rückgaben]

{#r_ScopedGlideRecordCanWrite__table_sq3_ttb_2r}  
Dieses Codebeispiel schreibt, ob der aktuelle Anwender Datensätze in der Incident-Tabelle im Systemprotokoll schreiben kann.

    var now_GR = new GlideRecord('incident');
    gs.info(now_GR.canWrite());

## Bereichsbezogener GlideRecord -- select seWindow(Nummer firstRow, Nummer lastRow, boolescher ForceCount) {#ariaid-title17}

Legt einen Zeilenbereich fest, der von nachfolgenden Abfragen zurückgegeben werden soll.
{#r_ScopedGlideRecordChooseWindow_Number_Number_Boolean__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Erste Zeile | Nummer | Null-basierter Index der Startzeile für den Bereich, einschließlich. (Ein Wert von 0 gibt die erste Zeile zurück.) |
| LastRow | Nummer | Null-basierter Index der Endzeile für den Bereich, exklusiv. Beispiel: Wenn firstRow= 1 und lastRow= 5, vier Datensätze werden zurückgegeben (2--5). |
| ForceCount | Boolean | Optional. Kennzeichnung, die angibt, ob eine Abfrage der Zeilenanzahl erzwungen werden soll. In den meisten Implementierungen dieses Aufrufs wird die Zeilenanzahl durchgeführt. Es gibt einige angrenzende Fälle, z. B. Textsuchen, in denen keine Zeilenanzahl durchgeführt wird. Durch das Festlegen dieser Kennzeichnung wird sichergestellt, dass die Zeilenanzahl auftritt. Gültige Werte: * Wahr: Zeilenanzahl tritt immer auf. * Falsch: Die Zeilenanzahl tritt auf, wenn sie in der normalen Ausführung der Methode implementiert wird. {#r_ScopedGlideRecordChooseWindow_Number_Number_Boolean__ul_fgp_42j_gqb} Standard: Falsch |
[Tabelle : 31. Parameter]

{#r_ScopedGlideRecordChooseWindow_Number_Number_Boolean__table_vy2_525_jq} {#r_ScopedGlideRecordChooseWindow_Number_Number_Boolean__table_rhg_rtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 32. Rückgaben]

{#r_ScopedGlideRecordChooseWindow_Number_Number_Boolean__table_rhg_rtb_2r}  
Dieses Beispiel zeigt, wie Datensätze 3 und 4 aus der Tabelle „Incident" \[Incident\] zurückgegeben werden.

    var now_GR = new GlideRecord('incident');
    now_GR.orderBy('number');
    now_GR.chooseWindow(2, 4);
    now_GR.query();
    while (now_GR.next()) {
      gs.info(now_GR.getValue('number') + ' is within window');
    }

Ausgabe:

    *** Script: INC0000003 is within window
    *** Script: INC0000004 is within window

## Bereichsbezogener GlideRecord -- deleteMultiple() {#ariaid-title18}

Löscht alle Datensätze, die die Abfrage erfüllen.
Mit dieser Methode werden keine Anhänge gelöscht.

Nicht verwenden DeleteMultiple() In Tabellen mit Währungsfeldern. Löschen Sie jeden Datensatz immer einzeln. Verwenden Sie diese Methode auch nicht mit Select Window() Oder SetLimit() Methoden bei der Arbeit mit großen Tabellen. Die SetLimit() Die Methode beschränkt die Anzahl der Datensätze, die mit gelöscht werden DeleteMultiple() . Alle von der Abfrage zurückgegebenen Datensätze werden unabhängig von gelöscht SetLimit() .

Die glide.db.forced.chunk.thresholdDie Systemeigenschaft legt den Schwellenwert fest, über dem das Löschen und Aktualisieren von Blockdatensätzen erzwungen wird. Durch das Blockieren wird verhindert, dass nicht primäre Schlüssel in großen Tabellen zu Replikationsproblemen führen. Weitere Informationen 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).
{#r_ScopedGlideRecordDeleteMultiple__table_vy2_51_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 33. Parameter]

{#r_ScopedGlideRecordDeleteMultiple__table_vy2_51_jq} {#r_ScopedGlideRecordDeleteMultiple__table_fpr_qtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 34. Rückgaben]

{#r_ScopedGlideRecordDeleteMultiple__table_fpr_qtb_2r}  
Dieses Beispiel zeigt, wie alle inaktiven Datensätze aus der Incident-Tabelle gelöscht werden.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('active','false');
    now_GR.query();
    now_GR.deleteMultiple();

## Bereichsbezogener GlideRecord -- deleteRecord() {#ariaid-title19}

Löscht den aktuellen Datensatz.
{#r_ScopedGlideRecordDeleteRecord__table_vxy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 35. Parameter]

{#r_ScopedGlideRecordDeleteRecord__table_vxy2_535_jq} {#r_ScopedGlideRecordDeleteRecord__table_rrm_4tb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Datensatz erfolgreich gelöscht wurde. Gültige Werte: * Wahr: Datensatz wurde gelöscht. * Falsch: Es wurde kein Datensatz zum Löschen gefunden. {#r_ScopedGlideRecordDeleteRecord__ul_hkn_5bj_s3b} |
[Tabelle : 36. Rückgaben]

{#r_ScopedGlideRecordDeleteRecord__table_rrm_4tb_2r}  
Dieses Beispiel zeigt, wie ein angegebener Datensatz aus der Incident-Tabelle gelöscht wird.

    var now_GR = new GlideRecord('incident');
    //to delete one record
    if (now_GR.get('99ebb4156fa831005be8883e6b3ee4b9'))
        now_GR.deleteRecord();

Dieses Beispiel zeigt, wie ein Datensatz unmittelbar nach dem Einfügen aus der Incident-Tabelle gelöscht wird. Der Incident GlideRecord Muss nach dem Einfügen neu geladen werden, bevor es gelöscht werden kann.

    var grTicket = new GlideRecord('incident');
    grTicket.initialize();
    grTicket.short_description = 'Example ticket';
    grTicket.work_notes = 'An update about the ticket';
    var ins_sys_id = grTicket.insert(); // Insert the record
    grTicket.get(ins_sys_id); // Reload the inserted record
    gs.info(grTicket.deleteRecord()); // Delete the record

Ausgabe:

    true

## Bereichsbezogener GlideRecord -- disableSysIdInOptimization() {#ariaid-title20}

Deaktiviert die Standardoptimierung, die verhindert, dass eine zusätzliche Datenbankabfrage ausgeführt wird, wenn ein Anwender eine große Anzahl von sys_IDs übergibt, z. B. `GrIncident.addQuery('sys_ID', 'IN', listOf200SysIds) `.
Diese Methode wirkt sich nur auf den GlideRecord aus, auf dem sie aufgerufen wird. Um die sys_ID-Limitoptimierung für alle GlideRecords zu ändern, passen Sie den Wert in an glide.db.first_pass_sys_id_list_size.maxSystemeigenschaft (Standard 100).

Wenn Sie diese Methode nicht aufrufen oder anpassen glide.db.first_pass_sys_id_list_size.maxSystemeigenschaft und übergeben eine Liste, die mehr sys_ID-Einträge enthält, als in definiert glide.db.first_pass_sys_id_list_size.max, Der zurückgegebene Wert von GlideRecord.getRowCount() Ist möglicherweise falsch.
{#SGR-disableSysIdInOptimization__table_ilp_2cg_zcc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 37. Parameter]

{#SGR-disableSysIdInOptimization__table_ilp_2cg_zcc} {#SGR-disableSysIdInOptimization__table_jlp_2cg_zcc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 38. Rückgaben]

{#SGR-disableSysIdInOptimization__table_jlp_2cg_zcc}  
Das folgende Codebeispiel zeigt, wie verwendet wird DisableSysIdInOptimierung() Methode zum Deaktivieren der sys_ID-Limitoptimierung beim Übergeben einer sys_ID-Liste für Incidents, die 200 Einträge enthält.

    var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
    var grIncident = new GlideRecord('incident');
    grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
    grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
    grIncident.query();
    if (grIncident.next())
        gs.info("Rowcount: " + grIncident.getRowCount());

Ausgabe:

    Rowcount: 200

## Bereichsbezogener GlideRecord -- GET (Objektname, Objektwert) {#ariaid-title21}

Gibt den angegebenen Datensatz im aktuellen GlideRecord-Objekt zurück.
Diese Methode akzeptiert entweder einen oder zwei Parameter. Wenn nur ein einzelner Parameter übergeben wird, geht die Methode davon aus, dass es sich um die sys_ID des gewünschten Datensatzes handelt. Wenn nicht gefunden, wird versucht, den Wert mit dem Anzeigewert abzugleichen. Wenn zwei Parameter übergeben werden, ist der erste der Name der Spalte im GlideRecord, die gesucht werden soll. Der zweite ist der Wert, nach dem gesucht werden soll. Wenn mehrere Datensätze gefunden werden, verwenden Sie Next() Um auf die zusätzlichen Datensätze zuzugreifen.
{#r_ScopedGlideRecordGet_Object_Object__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Objekt | Optional. Name der instanziierten GlideRecord-Spalte, nach der gesucht werden soll valueParameter. Wenn nur ein einzelner Parameter übergeben wird, geht die Methode davon aus, dass dieser Parameter die sys_ID oder den Anzeigewert ist. |
| Wert | Objekt | Wert, der abgeglichen werden soll. Bei berechneten Feldern wird der Wert unverändert abgeglichen, anstatt eine Berechnung für einen geskripteten Standardwert für ein Feld im Datensatz auszuführen. |
[Tabelle : 39. Parameter]

{#r_ScopedGlideRecordGet_Object_Object__table_vy2_525_jq} {#r_ScopedGlideRecordGet_Object_Object__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Gibt an, ob der angeforderte Datensatz gefunden wurde: * Wahr: Datensatz wurde gefunden * Falsch: Datensatz wurde nicht gefunden {#r_ScopedGlideRecordGet_Object_Object__ul_ngs_clw_qfb} |
[Tabelle : 40. Rückgaben]

{#r_ScopedGlideRecordGet_Object_Object__table_qpt_3f5_jq}  
Dieses Beispiel zeigt, wie Sie einen Incident-Datensatz erhalten, indem Sie die sys_ID übergeben

    var grIncident = new GlideRecord('incident');
    var returnValue = grIncident.get('99ebb4156fa831005be8883e6b3ee4b9');
    gs.info(returnValue); // logs true or false
    gs.info(grIncident.short_description); // logs Incident Short description

Dieses Beispiel zeigt, wie ein Incident-Datensatz abgerufen werden kann, indem das Feld zur Suche (caller_id.name) übergeben wird, und der Wert, der innerhalb dieses Felds abgeglichen werden soll.

    var grIncident = new GlideRecord('incident');
    var returnValue = grIncident.get('caller_id.name','Sylivia Wayland');
    gs.info(returnValue); // logs true or false
    gs.info(grIncident.getValue('number')); // logs Incident Number

## Bereichsbezogener GlideRecord -- getAttribute(String fieldName) {#ariaid-title22}

Gibt die Wörterbuchattribute für das angegebene Feld zurück.
{#SGR-getAttribute_S__table_xqs_wfq_fz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Feldname, für den die Wörterbuchattribute zurückgegeben werden sollen |
[Tabelle : 41. Parameter]

{#SGR-getAttribute_S__table_xqs_wfq_fz} {#SGR-getAttribute_S__table_yqs_wfq_fz__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wörterbuchattribute |
[Tabelle : 42. Rückgaben]

{#SGR-getAttribute_S__table_yqs_wfq_fz}  

    doit();
    function doit() {
      var now_GR = new GlideRecord('sys_user');
      now_GR.query("user_name","admin");
      if (now_GR.next()) {
        gs.info("we got one");
        gs.info(now_GR.location.getAttribute("tree_picker"));
      }
    }

## Bereichsbezogener GlideRecord -- getClassDisplayValue() {#ariaid-title23}

Gibt die Bezeichnung der aktuellen Tabelle zurück.
{#SGR-getClassDisplayValue__table_ltd_ydr_dt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 43. Parameter]

{#SGR-getClassDisplayValue__table_ltd_ydr_dt} {#SGR-getClassDisplayValue__table_mtd_ydr_dt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Bezeichnung, die die Tabelle identifiziert. |
[Tabelle : 44. Rückgaben]

{#SGR-getClassDisplayValue__table_mtd_ydr_dt}  
In diesem Beispiel wird die Bezeichnung der übergebenen Tabelle gedruckt.

    // Display the incident table label
    var now_GR = new GlideRecord("incident");
    var value = now_GR.getClassDisplayValue();
    gs.info("The table label is " + value + ".");

Ausgabe:

    The table label is Incident.

## Bereichsbezogener GlideRecord -- getDisplayValue() {#ariaid-title24}

Ruft den Anzeigewert für den aktuellen Datensatz ab.
Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.  
Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.

* Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
* Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
* Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
* Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.
{#r_ScopedGlideRecordGetDisplayValue__ul_ok1_cbv_hsb}
{#r_ScopedGlideRecordGetDisplayValue__table_dgk_dtb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 45. Parameter]

{#r_ScopedGlideRecordGetDisplayValue__table_dgk_dtb_2r} {#r_ScopedGlideRecordGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Anzeigewert für den aktuellen Datensatz. |
[Tabelle : 46. Rückgaben]

{#r_ScopedGlideRecordGetDisplayValue__table_qpt_3f5_jq}  
Dieses Beispiel schreibt den Anzeigewert eines angegebenen Incident-Datensatzes in das Protokoll.

    var now_GR = new GlideRecord('incident');
    now_GR.get('sys_id','<sys_id>');
    gs.info(now_GR.getDisplayValue());

Ausgabe:

    INC0000050

## Bereichsbezogener GlideRecord -- getED() {#ariaid-title25}

Gibt den Deskriptor des Elements zurück.
{#SGR-getED__table_xvc_xjq_fz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 47. Parameter]

{#SGR-getED__table_xvc_xjq_fz} {#SGR-getED__table_qpq_p2r_dt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideElementdeskriptor | Der Deskriptor des Elements. |
[Tabelle : 48. Rückgaben]

{#SGR-getED__table_qpq_p2r_dt}  
Dieses Beispiel zeigt, wie das Namensfeld für einen Incident-GlideRecord abgerufen wird.

    var grInc = new GlideRecord('incident');
    grInc.get('sys_id','ef43c6d40a0a0b5700c77f9bf387afe3');

    var field = grInc.getElement('priority');
    var ed = field.getED();

    var isEdge = ed.getLabel();
    gs.info("Label is - " + isEdge);

Ausgabe:

    Label is - Priority

## Bereichsbezogener GlideRecord -- getElement(String fieldName) {#ariaid-title26}

Ruft das GlideElement-Objekt für das angegebene Feld ab.
Der von dieser Methode zurückgegebene Wert ist ein vollständiges GlideElement-Objekt. Die Ergebnisse entsprechen dem Dot-Walking eines Feldwerts. Beispiel: `Now_GR.getElement('short_description') `Liefert das gleiche Ergebnis wie `NowGR.short_description `.

Verwenden Sie in den meisten Fällen kein Dot-Walking, um Werte aus einem Datensatz abzurufen. DOT-Walking ruft das gesamte Objekt anstelle des Feldwerts ab. Das Abrufen des Objekts verwendet mehr Speicher und kann bei Verwendung in Arrays oder zu unerwünschten Ergebnissen führen Serviceportal.

Anstatt das gesamte Objekt abzurufen, können Sie eine der folgenden Methoden verwenden, um die Feldwerte zu kopieren:  
* [GetValue()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordGetValue_String "Ruft den Zeichenfolgenwert eines zugrunde liegenden Elements in einem Feld ab.")
* [GetDisplayValue()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordGetDisplayValue "Ruft den Anzeigewert für den aktuellen Datensatz ab.")
{#r_ScopedGlideRecordGetElement_String__ul_lgx_d2d_zpb}  
Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die Manager-sys_ID des aktuellen Anrufers, um ein anderes Referenzfeld festzulegen. Das folgende Beispiel zeigt, wie der Zeichenfolgenwert anstelle des gesamten Objekts abgerufen wird:

    var mgr = current.caller_id.manager.toString();

Siehe auch:

* [GlideElement -- toString()](https://servicenow-prod.fluidtopics.net/KE~S6OltJSBoK4CG8haHCw#r_ScopedGlideElementToString "Konvertiert den Wert eines GlideRecord-Felds in eine Zeichenfolge.")
* [GetElements()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#SGR-getElements "Gibt ein Array von GlideElement-Objekten zurück. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.")
{#r_ScopedGlideRecordGetElement_String__ul_mmb_3h3_npb}
{#r_ScopedGlideRecordGetElement_String__id_xzl_rpn_mpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Spaltenname, für den das GlideElement-Objekt zurückgegeben werden soll. |
[Tabelle : 49. Parameter]

{#r_ScopedGlideRecordGetElement_String__id_xzl_rpn_mpb} {#r_ScopedGlideRecordGetElement_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideElement | Das GlideElement für die angegebene Spalte des aktuellen Datensatzes. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord. |
[Tabelle : 50. Rückgaben]

{#r_ScopedGlideRecordGetElement_String__table_qpt_3f5_jq}  
Das folgende Beispiel zeigt, wie ein neuer Incident-Datensatz mit Details in hinzugefügt wird Kurzbeschreibung Feld.

    var elementName = 'short_description'; 
    var now_GR = new GlideRecord('incident'); 
    now_GR.newRecord(); 
    now_GR.setValue(elementName, "My DB is not working");
    now_GR.insert();
     
    var sdesc = now_GR.getElement('short_description');
    gs.info(sdesc.getValue());

Ausgabe:

    My DB is not working

## Bereichsbezogener GlideRecord -- getElements() {#ariaid-title27}

Gibt ein Array von GlideElement-Objekten zurück. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.
Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die Manager-sys_ID des aktuellen Anrufers, um ein anderes Referenzfeld festzulegen. Das folgende Beispiel zeigt, wie der Zeichenfolgenwert anstelle des gesamten Objekts abgerufen wird:

    var mgr = current.caller_id.manager.toString();

Siehe auch:

* [GlideElement -- toString()](https://servicenow-prod.fluidtopics.net/KE~S6OltJSBoK4CG8haHCw#r_ScopedGlideElementToString "Konvertiert den Wert eines GlideRecord-Felds in eine Zeichenfolge.")
* [GetElement()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordGetElement_String "Ruft das GlideElement-Objekt für das angegebene Feld ab.")
{#SGR-getElements__ul_mmb_3h3_npb}
{#SGR-getElements__table_qcv_tfp_pnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 51. Parameter]

{#SGR-getElements__table_qcv_tfp_pnb} {#SGR-getElements__table_rcv_tfp_pnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Array von [GlideElement](https://servicenow-prod.fluidtopics.net/KE~S6OltJSBoK4CG8haHCw#c_GlideElementScopedAPI "Der Umfang ist festgelegt GlideElement Die API bietet eine Reihe praktischer Skriptmethoden für den Umgang mit Feldern und ihren Werten. Bereichsbezogen GlideElement Methoden sind für die Felder des aktuellen Glide-Datensatzes verfügbar.")Objekte. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord. |
[Tabelle : 52. Rückgaben]

{#SGR-getElements__table_rcv_tfp_pnb}  
Das folgende Beispiel zeigt den Wert des Namensfelds für die fünf neuesten Datensätze an, die in der Tabelle „Frage" \[Frage\] erstellt wurden.

    var now_GR = new GlideRecord('question');
    var elementArr = now_GR.getElements();
    now_GR.orderByDesc('sys_created_on');
    now_GR.setLimit(5);
    now_GR.query();

    while (now_GR.next()){
      var qNames = now_GR.name.toString();
      elementArr.push(qNames);
      gs.info(qNames);
    }

Ausgabe:

    delivery_time_var
    delivery_time
    sequence
    priority
    assigned_group

## Bereichsbezogener GlideRecord -- getEncodedQuery() {#ariaid-title28}

Ruft die Abfragebedingung des aktuellen Ergebnissatzes als codierte Abfragezeichenfolge ab.
Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) .{#r_ScopedGlideRecordGetEncodedQuery__link_encoded_query_strings}
{#r_ScopedGlideRecordGetEncodedQuery__table_pyd_dtb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 53. Parameter]

{#r_ScopedGlideRecordGetEncodedQuery__table_pyd_dtb_2r} {#r_ScopedGlideRecordGetEncodedQuery__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge |   |
[Tabelle : 54. Rückgaben]

{#r_ScopedGlideRecordGetEncodedQuery__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident'); 
    now_GR.addQuery('active', true);
    now_GR.addQuery('priority', 1); 
    now_GR.query(); 
    var encodedQuery = now_GR.getEncodedQuery(); 
    gs.info(encodedQuery);

Ausgabe:

    active=true^priority=1

## Bereichsbezogener GlideRecord -- getLabel() {#ariaid-title29}

Gibt die Bezeichnung des Felds zurück.
{#SGR-getLabel__table_edc_vkq_fz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 55. Parameter]

{#SGR-getLabel__table_edc_vkq_fz} {#SGR-getLabel__table_fdc_vkq_fz__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Bezeichnung des Felds |
[Tabelle : 56. Rückgaben]

{#SGR-getLabel__table_fdc_vkq_fz}  

    template.print("Summary of Requested items:\n");  
    var now_GR = new GlideRecord("sc_req_item");
    now_GR.addQuery("request", current.sysapproval);
    now_GR.query();
    while(now_GR.next()) {
    var nicePrice = now_GR.price.toString();
      if (nicePrice != '') {
        nicePrice = parseFloat(nicePrice);
        nicePrice = nicePrice.toFixed(2);
      }
      template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() 
        + " at $" + nicePrice + " each \n");
      template.print("    Options:\n");
      for (key in now_GR.variables) {
      var now_V = now_GR.variables[key];
        if(now_V.getGlideObject().getQuestion().getLabel() != '') {
          template.space(4);
          template.print('     ' +  now_V.getGlideObject().getQuestion().getLabel() + " = " 
            + now_V.getDisplayValue() + "\n");  
        }
      }
    }

## Bereichsbezogener GlideRecord -- getLastErrorMessage() {#ariaid-title30}

Ruft die letzte Fehlermeldung ab. Wenn keine letzte Fehlermeldung vorhanden ist, wird Null zurückgegeben.
{#r_ScopedGlideRecordGetLastErrorMessage__table_cfw_ctb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 57. Parameter]

{#r_ScopedGlideRecordGetLastErrorMessage__table_cfw_ctb_2r} {#r_ScopedGlideRecordGetLastErrorMessage__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die letzte Fehlermeldung als Zeichenfolge. |
[Tabelle : 58. Rückgaben]

{#r_ScopedGlideRecordGetLastErrorMessage__table_qpt_3f5_jq}  

    // Setup a data policy where short_description field in incident is mandatory
    var now_GR = new GlideRecord('incident');
    now_GR.insert(); // insert without data in mandatory field
    var errormessage = now_GR.getLastErrorMessage(); 
    gs.info(errormessage);

Ausgabe:

    Data Policy Exception: Short description is mandatory

## Bereichsbezogener GlideRecord -- getLink(boolescher noStack) {#ariaid-title31}

Ruft den Link zum aktuellen Datensatz ab.
{#r_ScopedGlideRecordGetLink_Boolean__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NoStack | Boolean | Kennzeichnung, die angibt, ob der Parameter „sysparm_Stack" an den zurückgegebenen Link angehängt werden soll. Dieser Parameter gibt die Seite an, die nach dem Schließen des aktuellen Links aufgerufen werden soll. Gültige Werte: * Wahr: Hängen Sie den Parameter „sysparm_Stack" nicht an. * Falsch: Hängen Sie den Parameter „sysparm_Stack" an. {#r_ScopedGlideRecordGetLink_Boolean__ul_fsf_wpz_1nb}Bei „wahr" wird der Parameter „sysparm_Stack" nicht an den Link angehängt. |
[Tabelle : 59. Parameter]

{#r_ScopedGlideRecordGetLink_Boolean__table_vy2_525_jq} {#r_ScopedGlideRecordGetLink_Boolean__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Link zum aktuellen Datensatz. |
[Tabelle : 60. Rückgaben]

{#r_ScopedGlideRecordGetLink_Boolean__table_qpt_3f5_jq}  
Dieses Beispiel fragt alle Incident-Datensätze mit der Priorität „1" ab und schreibt den Servlet-URI und den Link des aktuellen Datensatzes in das Systemprotokoll.

    var now_GR = new GlideRecord('incident');
    now_GR.addActiveQuery();
    now_GR.addQuery("priority", 1);
    now_GR.query();
    now_GR.next();
    gs.info(gs.getProperty('glide.servlet.uri') + now_GR.getLink(false));

Ausgabe:

    https://instance.service-now.com/incident.do?sys_id=46e2fee9a9fe19810049b49dee0daf58&sysparm_stack=incident_list.do?sysparm_query=active=true

## Bereichsbezogener GlideRecord -- getRecordClassName() {#ariaid-title32}

Ruft den Klassennamen für den aktuellen Datensatz ab.
{#r_ScopedGlideRecordGetRecordClassName__table_srq_ctb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 61. Parameter]

{#r_ScopedGlideRecordGetRecordClassName__table_srq_ctb_2r} {#r_ScopedGlideRecordGetRecordClassName__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Klassenname. |
[Tabelle : 62. Rückgaben]

{#r_ScopedGlideRecordGetRecordClassName__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident'); 
    var recordClassName = now_GR.getRecordClassName(); 
    gs.info(recordClassName);

Ausgabe:

    incident

## Bereichsbezogener GlideRecord -- getRowCount() {#ariaid-title33}

Ruft die Anzahl der Zeilen (Datensätze) im aktuellen GlideRecord-Objekt ab.
Hinweis:  
GlideRecord Gibt übereinstimmende Datensätze zurück, daher ist es möglicherweise nicht so effizient wie GlideAggregat Wenn Sie nur die Anzahl der Datensätze benötigen. Wenn Sie nur eine Datensatzanzahl benötigen und nicht über die übereinstimmenden Datensätze iterieren, verwenden Sie GlideAggregat .  

Abrufen der Zahlendatensätze in GlideRecord oder GlideAggregat
:   Die GlideRecord getRowCount() Und [GlideAggregat getAggregat()](https://servicenow-prod.fluidtopics.net/aD6zULgUJntUCYyTZz592Q#c_GlideAggregateScopedAPI "Die GlideAggregat API ermöglicht das Erstellen von Datenbankzusammenfassungsabfragen.")APIs bieten ähnliche Informationen. Verwenden Sie die folgenden Kriterien, um zu bestimmen, welche Option für Sie am besten geeignet ist.

    * Die GlideRecord getRowCount() Die Methode gibt an, wie viele Datensätze von einer Abfrage zusammen mit den Datensätzen selbst zurückgegeben wurden. Wenn Sie die Anzahl der Datensätze im Ergebnissatz vor oder nach der Iteration des Satzes benötigen, um Aktionen für die Datensätze auszuführen, verwenden Sie diese Methode.
    * Die GlideAggregat getAggregat() Die Methode ruft nur eine Anzahl von Datensätzen ab, die der Abfrage entsprechen, mit Ausnahme der tatsächlichen Datensätze. Das Aggregat muss auf festgelegt werden GlideAggregat Objekt vor Ausgabe der Abfrage.
    {#r_ScopedGlideRecordGetRowCount__ul_wdq_fmn_nyb}
:   Datensätze und Anzahl werden mit GlideRecord getRowCount() abgerufen  
    Das folgende Beispiel zeigt, wie die Gesamtzahl der aktiven Incidents mit abgerufen wird GlideRecord getRowCount() :

        var incident = new GlideRecord("incident");
        incident.addQuery("active", true);
        incident.query();
         
        gs.info("*** Total number of active incidents: {0}", incident.getRowCount());

:   Es wird nur die Anzahl der Datensätze mit GlideAggregate getAggregate() abgerufen.  
    Das folgende Beispiel zeigt, wie nur die Anzahl der Datensätze zurückgegeben wird. Da diese Methode nicht die übereinstimmenden Datensätze verwendet, ist es viel effizienter, eine Aggregatabfrage zu verwenden und nur die Anzahl zurückzugeben.

        var incident = new GlideAggregate("incident");
        incident.addQuery("active", true);
        incident.addAggregate("COUNT");
        incident.query();
         
        if (incident.next())
            gs.info("*** Total number of active incidents: {0}", incident.getAggregate("COUNT"));

:   Entscheidung, welche Option für Ihre Lösung am besten geeignet ist

Wenn Sie nur die Anzahl der Datensätze abrufen möchten, wird GlideAggregat getAggregat() Methode ist die beste Option. Verwenden Sie, um die einzelnen Datensätze zu verwenden und die Anzahl der Ergebnisse abzurufen GlideRecord getRowCount() , Da eine einzelne Abfrage diese Funktionalität bereitstellt.  
Hinweis:  
Wenn Sie verwenden möchten GetRowCount() Methode bei Verwendung `sys_ID IN `Mit mehr als 100 sys_ID-Werten, z. B. `GrIncident.addQuery('sys_ID', 'IN', listOf200SysIds) `, Sie müssen entweder:

* Rufen Sie an DisableSysIdInOptimization() Methode im GlideRecord.
* Oder passen Sie an glide.db.first_pass_sys_id_list_size.maxSystemeigenschaft auf einen Wert höher als die Anzahl der sys_IDs in der Liste.

{#r_ScopedGlideRecordGetRowCount__ul_j1v_ztm_zcc} Stellen Sie außerdem sicher, dass Sie anrufen .Next() Methode, bevor aufgerufen wird GetRowCount() Methode.
{#r_ScopedGlideRecordGetRowCount__table_dxv_hkr_dt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 63. Parameter]

{#r_ScopedGlideRecordGetRowCount__table_dxv_hkr_dt} {#r_ScopedGlideRecordGetRowCount__table_exv_hkr_dt__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Anzahl der Zeilen im aktuellen GlideRecord. |
[Tabelle : 64. Rückgaben]

{#r_ScopedGlideRecordGetRowCount__table_exv_hkr_dt}  
Das folgende Beispiel zeigt, wie Sie die Anzahl der Incidents aus der Tabelle „Incidents \[Incident\]" abrufen.

    var numberOfIncidents = new GlideRecord('incident');
    numberOfIncidents.query();
    gs.info("Records in incident table: " + numberOfIncidents.getRowCount());

Ausgabe:

    Records in incident table: 6920

Das folgende Codebeispiel zeigt, wie verwendet wird DisableSysIdInOptimierung() Methode zum Deaktivieren der sys_ID-Limitoptimierung beim Übergeben einer sys_ID-Liste für Incidents, die 200 Einträge enthält.

    var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
    var grIncident = new GlideRecord('incident');
    grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
    grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
    grIncident.query();
    if (grIncident.next())
        gs.info("Rowcount: " + grIncident.getRowCount());

Ausgabe:

    Rowcount: 200

## Bereichsbezogener GlideRecord -- getTableName() {#ariaid-title34}

Ruft den Namen der Tabelle ab, die dem GlideRecord zugeordnet ist.
{#r_ScopedGlideRecordGetTableName__table_z5p_btb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 65. Parameter]

{#r_ScopedGlideRecordGetTableName__table_z5p_btb_2r} {#r_ScopedGlideRecordGetTableName__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Tabellenname |
[Tabelle : 66. Rückgaben]

{#r_ScopedGlideRecordGetTableName__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident');
    gs.info(now_GR.getTableName());

## Bereichsbezogener GlideRecord -- getUniqueValue() {#ariaid-title35}

Ruft den primären Schlüssel des Datensatzes ab, der normalerweise die sys_ID ist, sofern nicht anders angegeben.
{#r_ScopedGlideRecordGetUniqueValue__table_t5k_btb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 67. Parameter]

{#r_ScopedGlideRecordGetUniqueValue__table_t5k_btb_2r} {#r_ScopedGlideRecordGetUniqueValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der eindeutige primäre Schlüssel als Zeichenfolge oder null, wenn der Schlüssel null ist. |
[Tabelle : 68. Rückgaben]

{#r_ScopedGlideRecordGetUniqueValue__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('kb_knowledge');
    now_GR.query();
    now_GR.next();
    var uniqueid = now_GR.getUniqueValue();
    gs.info(uniqueid);

## Bereichsbezogener GlideRecord -- getValue(Zeichenfolgenname) {#ariaid-title36}

Ruft den Zeichenfolgenwert eines zugrunde liegenden Elements in einem Feld ab.
Hinweis:  
Wenn Feldverschlüsselung EnterprisePlugin ist aktiviert, und die Instanz hat Zugriff auf den Schlüssel. Diese Methode gibt Klartextwerte aus verschlüsselten Feldern zurück. Wenn die Instanz keinen Zugriff auf den Schlüssel hat, gibt diese Methode den verschlüsselten Wert zurück. Weitere Informationen finden Sie unter [Plattformverschlüsselung](https://www.servicenow.com/docs/access?context=now-platform-encryption&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
{#r_ScopedGlideRecordGetValue_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des Felds, aus dem der Wert abgerufen werden soll. |
[Tabelle : 69. Parameter]

{#r_ScopedGlideRecordGetValue_String__table_vy2_525_jq} {#r_ScopedGlideRecordGetValue_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Zeichenfolgenwert des zugrunde liegenden Elements. Gibt Null zurück, wenn das Feld leer ist oder das Feld nicht vorhanden ist. Boolesche Werte geben als zurück <kbd class="ph userinput">„0“ </kbd>Und <kbd class="ph userinput">„1“ </kbd>Zeichenfolgenwerte anstelle von „falsch" und „wahr". |
[Tabelle : 70. Rückgaben]

{#r_ScopedGlideRecordGetValue_String__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident'); 
    now_GR.orderBy('number');
    now_GR.query('active','true'); 
    now_GR.next(); 
    gs.info(now_GR.getValue('number'));

Ausgabe:

    INC0000002

## Bereichsbezogener GlideRecord -- GlideRecord(Zeichenfolge tableName) {#ariaid-title37}

Erstellt eine Instanz der GlideRecord-Klasse für die angegebene Tabelle.
{#r_ScopedGlideRecordGlideRecord_S__table_hlc_w5j_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Die zu verwendende Tabelle. |
[Tabelle : 71. Parameter]

{#r_ScopedGlideRecordGlideRecord_S__table_hlc_w5j_3v}  

    var now_GR = new GlideRecord('incident');

## Bereichsbezogener GlideRecord -- hasNext() {#ariaid-title38}

Bestimmt, ob das GlideRecord-Objekt weitere Datensätze enthält.
{#r_ScopedGlideRecordHasNext__table_nmb_btb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 72. Parameter]

{#r_ScopedGlideRecordHasNext__table_nmb_btb_2r} {#r_ScopedGlideRecordHasNext__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Abfrageergebnissatz weitere Datensätze enthält. |
[Tabelle : 73. Rückgaben]

{#r_ScopedGlideRecordHasNext__table_qpt_3f5_jq}  

    var rec = new GlideRecord('incident'); 
    rec.query(); 
    if (rec.hasNext()) { 
      gs.info("Table is not empty"); 
    }

## Bereichsbezogener GlideRecord -- insert() {#ariaid-title39}

Fügt einen neuen Datensatz mithilfe der Feldwerte ein, die für den aktuellen Datensatz festgelegt wurden.
{#r_ScopedGlideRecordInsert__table_sks_1tb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 74. Parameter]

{#r_ScopedGlideRecordInsert__table_sks_1tb_2r} {#r_ScopedGlideRecordInsert__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des eingefügten Datensatzes oder null, wenn der Datensatz nicht eingefügt wird. |
[Tabelle : 75. Rückgaben]

{#r_ScopedGlideRecordInsert__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident');
    now_GR.initialize();
    now_GR.setValue('name', 'New Incident');
    now_GR.setValue('description', 'Incident description');
    now_GR.insert();

Ausgabe:

    138fb4111b4d4d907cf30d03cd4bcb57

## Bereichsbezogener GlideRecord -- initialize() {#ariaid-title40}

Erstellt einen leeren Datensatz, der für die Auffüllung vor dem Einfügen geeignet ist.
{#r_ScopedGlideRecordInitialize__table_onw_1tb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 76. Parameter]

{#r_ScopedGlideRecordInitialize__table_onw_1tb_2r} {#r_ScopedGlideRecordInitialize__table_gnr_mtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 77. Rückgaben]

{#r_ScopedGlideRecordInitialize__table_gnr_mtb_2r}  

    var grIncident = new GlideRecord('incident');
    grIncident.initialize();
    grIncident.setValue('short_description', 'New Incident');
    grIncident.setValue('description', 'Incident description');
    grIncident.insert();

## Bereichsbezogener GlideRecord -- isActionAborted() {#ariaid-title41}

Überprüft, ob die aktuelle Datenbankaktion abgebrochen werden soll.
IsActionAborted() Wird für neue Threads und von initialisiert (auf „falsch" festgelegt) Next() Methode.
{#r_ScopedGlideRecordIsActionAborted__table_gqg_mvt_vr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 78. Parameter]

{#r_ScopedGlideRecordIsActionAborted__table_gqg_mvt_vr} {#r_ScopedGlideRecordIsActionAborted__table_hqg_mvt_vr__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die aktuelle Datenbankaktion abgebrochen werden soll. Gültige Werte: * Wahr: Die aktuelle Datenbankaktion muss abgebrochen werden. * Falsch: Die aktuelle Datenbankaktion darf nicht abgebrochen werden. {#r_ScopedGlideRecordIsActionAborted__ul_l5r_kjq_kpb} |
[Tabelle : 79. Rückgaben]

{#r_ScopedGlideRecordIsActionAborted__table_hqg_mvt_vr}  

    var now_GR = new GlideRecord('incident');
     
    gs.info(now_GR.isActionAborted());

Ausgabe:

    false

## Bereichsbezogener GlideRecord -- isEncodedQueryValid (Zeichenfolgenabfrage) {#ariaid-title42}

Überprüft, ob die angegebene codierte Abfrage gültig ist.
Wenn die angegebene codierte Abfrage gültig ist, wird die Abfrage angewendet, so als hätten Sie aufgerufen [AddEncodedQuery()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordAddEncodedQuery_String "Fügt anderen Abfragen, die möglicherweise festgelegt wurden, eine codierte Abfrage hinzu."). Wenn die angegebene codierte Abfrage ungültig ist, dann `sys_idNotValidnull `Wird als codierte Abfrage hinzugefügt.  
Hinweis:  
Diese Methode wurde veraltet und durch ersetzt [IsValidEncodedQuery()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#SGR-isValidEncodedQuery_S "Überprüft, ob die Syntax der codierten Abfrage korrekt ist.")Methode, die die Abfrage nicht ausführt.
{#SGR-isEncodedQueryValid_S__table_nbb_bv4_2gb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Codierte Abfrage zur Validierung. Siehe [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). |
[Tabelle : 80. Parameter]

{#SGR-isEncodedQueryValid_S__table_nbb_bv4_2gb} {#SGR-isEncodedQueryValid_S__table_obb_bv4_2gb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene codierte Abfrage gültig ist. * Wahr: Die übergebene codierte Abfrage ist gültig. * Falsch: Die übergebene codierte Abfrage ist ungültig. |
[Tabelle : 81. Rückgaben]

{#SGR-isEncodedQueryValid_S__table_obb_bv4_2gb}  
Dieses Codebeispiel zeigt, wie eine codierte Abfrage validiert und dann Logik ausgeführt wird, wenn die Abfrage gültig ist.

    var now_GR = new GlideRecord('incident_sla');
    var isValidQuery = now_GR.isEncodedQueryValid('inc_impact=1^taskslatable_active=true');
    if (isValidQuery) {
      now_GR.query();
      .
      .
      .
    }

## Bereichsbezogener GlideRecord -- isNewRecord() {#ariaid-title43}

Überprüft, ob der aktuelle Datensatz ein neuer Datensatz ist, der noch nicht in die Datenbank eingefügt wurde.
{#r_ScopedGlideRecordIsNewRecord__table_lhn_1tb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 82. Parameter]

{#r_ScopedGlideRecordIsNewRecord__table_lhn_1tb_2r} {#r_ScopedGlideRecordIsNewRecord__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Datensatz neu ist und nicht in die Datenbank eingefügt wurde. |
[Tabelle : 83. Rückgaben]

{#r_ScopedGlideRecordIsNewRecord__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord("x_app_table"); 
    now_GR.newRecord(); // create a new record and populate it with default values
    gs.info(now_GR.isNewRecord());

## Bereichsbezogener GlideRecord -- isValid() {#ariaid-title44}

Bestimmt, ob die aktuelle Tabelle gültig ist oder ob der Datensatz erfolgreich abgerufen wurde.
{#r_ScopedGlideRecordIsValid__table_ub3_1tb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 84. Parameter]

{#r_ScopedGlideRecordIsValid__table_ub3_1tb_2r} {#r_ScopedGlideRecordIsValid__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Tabelle gültig ist oder ob der Datensatz erfolgreich abgerufen wurde. Mögliche Werte: * Wahr: Tabelle ist gültig, oder der Datensatz wurde erfolgreich abgerufen. * Falsch: Tabelle ist ungültig, oder der Datensatz wurde nicht erfolgreich abgerufen. {#r_ScopedGlideRecordIsValid__ul_rr1_3m4_pnb} |
[Tabelle : 85. Rückgaben]

{#r_ScopedGlideRecordIsValid__table_qpt_3f5_jq}  

    var comment_GR = new GlideRecord('cf_comment');
    var commentId = '99ebb4156fa831005be8883e6b3ee4b9';
    comment_GR.get(commentId);
    gs.info(comment_GR.isValid());

## Bereichsbezogener GlideRecord -- isValidEncodedQuery (Zeichenfolgenabfrage) {#ariaid-title45}

Überprüft, ob die Syntax der codierten Abfrage korrekt ist.
Beim Übergeben einer leeren Zeichenfolge ( `„" `) Als Abfrage angeben:

* Die leere Zeichenfolge ( `„" `) Stellt die Abwesenheit einer Abfrage dar und gibt „falsch" zurück.
* Wird Aufgerufen `GlideRecord.addEncodedQuery(„") `Gefolgt von `GlideRecord.Abfrage() `Gibt alle Zeilen zurück. Die Abfragemethode ähnelt einer SQL-SELECT-Anweisung. In SQL stellt der Wert X bei Verwendung von „SELECT \* FROM foo WHERE X" die Abfrage dar. Wenn kein Abfragewert angegeben wird, werden alle Datensätze zurückgegeben (z. B. \* AUS foo AUSWÄHLEN).
{#SGR-isValidEncodedQuery_S__ul_trc_ldy_hcc}
{#SGR-isValidEncodedQuery_S__table_urg_zqs_j5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Codierte Abfrage zur Validierung. Siehe [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). |
[Tabelle : 86. Parameter]

{#SGR-isValidEncodedQuery_S__table_urg_zqs_j5b} {#SGR-isValidEncodedQuery_S__table_vrg_zqs_j5b__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene codierte Abfrage gültig ist. * Wahr: Die übergebene codierte Abfrage ist gültig. * Falsch: Die übergebene codierte Abfrage ist ungültig. {#SGR-isValidEncodedQuery_S__ul_xcw_xcy_hcc} |
[Tabelle : 87. Rückgaben]

{#SGR-isValidEncodedQuery_S__table_vrg_zqs_j5b}  
Dieses Codebeispiel zeigt, wie überprüft wird, ob die codierte Abfrage gültig ist.

    var queryString = "priority=1^ORpriority=2";
    var now_GR = new GlideRecord('incident');
    var isValidQuery = now_GR.isValidEncodedQuery(queryString);
    if (isValidQuery) {
      now_GR.addEncodedQuery(queryString);
      now_GR.query();
      .
      .
      .
    }

## Bereichsbezogener GlideRecord -- isValidField(Zeichenfolge spaltenName) {#ariaid-title46}

Bestimmt, ob das angegebene Feld in der aktuellen Tabelle definiert ist.
{#r_ScopedGlideRecordIsValidField__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| columnName | Zeichenfolge | Der Name des Felds. |
[Tabelle : 88. Parameter]

{#r_ScopedGlideRecordIsValidField__table_vy2_525_jq} {#r_ScopedGlideRecordIsValidField__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das Feld für die aktuelle Tabelle definiert ist. |
[Tabelle : 89. Rückgaben]

{#r_ScopedGlideRecordIsValidField__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('incident'); 
    now_GR.initialize(); 
    gs.info(now_GR.isValidField("short_description"));

## Bereichsbezogener GlideRecord -- isValidRecord() {#ariaid-title47}

Bestimmt, ob ein Datensatz tatsächlich vom Vorgang „Abfrage/Datensatz abrufen" zurückgegeben wurde.
{#r_ScopedGlideRecordIsValidRecord__table_o1w_zsb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 90. Parameter]

{#r_ScopedGlideRecordIsValidRecord__table_o1w_zsb_2r} {#r_ScopedGlideRecordIsValidRecord__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob ein Datensatz tatsächlich vom Abfrage-/GET-Vorgang zurückgegeben wurde. Gültige Werte: * Wahr: Datensatz, der vom Abfrage-/GET-Vorgang zurückgegeben wird. * Falsch: Ende des Datensatzes, kein Datensatz zurückgegeben. {#r_ScopedGlideRecordIsValidRecord__ul_xzx_jnh_s3b} |
[Tabelle : 91. Rückgaben]

{#r_ScopedGlideRecordIsValidRecord__table_qpt_3f5_jq}  

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

## Bereichsbezogener GlideRecord -- isView() {#ariaid-title48}

Überprüft, ob der Datensatz in einer Ansicht oder Tabelle erstellt wurde.
{#SGR-isView__table_nbb_bv4_2gb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 92. Parameter]

{#SGR-isView__table_nbb_bv4_2gb} {#SGR-isView__table_obb_bv4_2gb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Datensatz in der Tabelle erstellt wurde, die eine Ansicht ist. * Wahr: Der Datensatz wurde in einer Ansicht erstellt. * Falsch: Der Datensatz wurde in einer Tabelle erstellt. |
[Tabelle : 93. Rückgaben]

{#SGR-isView__table_obb_bv4_2gb}  
Dieses Codebeispiel zeigt, wie bestimmt wird, ob ein GlideRecord in einer Ansicht oder Tabelle erstellt wurde.

    var mySLA = new GlideRecord('incident_sla');

    if (mySLA.isView() == true){
       gs.info('This record was created in a view.');
    } else {
       gs.info('This record was created in a table.');
    }

Ausgabe:

    This record was created in a view.

## Bereichsbezogener GlideRecord -- newRecord() {#ariaid-title49}

Erstellt einen neuen GlideRecord-Datensatz, legt die Standardwerte für die Felder fest und weist dem Datensatz eine eindeutige ID zu.
{#r_ScopedGlideRecordNewRecord__table_ls4_zsb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 94. Parameter]

{#r_ScopedGlideRecordNewRecord__table_ls4_zsb_2r} {#r_ScopedGlideRecordNewRecord__table_sgv_ktb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 95. Rückgaben]

{#r_ScopedGlideRecordNewRecord__table_sgv_ktb_2r}  

    var now_GR = new GlideRecord("x_app_table"); 
    now_GR.newRecord(); 
    gs.info(now_GR.isNewRecord());

Ausgabe:

    true

## Bereichsbezogener GlideRecord -- next() {#ariaid-title50}

Wechselt zum nächsten Datensatz im GlideRecord-Objekt.
Hinweis:  
Diese Methode schlägt fehl, wenn in der Tabelle ein Feld mit dem Namen „Next" vorhanden ist. Wenn dies der Fall ist, verwenden Sie die Methode [_Next()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#SGR-_next "Wechselt zum nächsten Datensatz im GlideRecord. Bietet die gleiche Funktionalität wie Next() , Verwenden Sie diese Methode, wenn der GlideRecord eine Spalte mit dem Namen „Next“ hat.").
{#r_ScopedGlideRecordNext__table_nmg_zsb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 96. Parameter]

{#r_ScopedGlideRecordNext__table_nmg_zsb_2r} {#r_ScopedGlideRecordNext__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob im GlideRecord ein „Next"-Datensatz vorhanden ist. Gültige Werte: * Wahr: Der Wechsel zum nächsten Datensatz war erfolgreich. * Falsch: Keine weiteren Datensätze im Ergebnissatz. {#r_ScopedGlideRecordNext__ul_anq_km4_s3b} |
[Tabelle : 97. Rückgaben]

{#r_ScopedGlideRecordNext__table_qpt_3f5_jq}  

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

Ausgabe:

    INC0010112 exists
    INC0010114 exists
    INC0010119 exists
    INC0010127 exists

## Bereichsbezogener GlideRecord -- _next() {#ariaid-title51}

Wechselt zum nächsten Datensatz im GlideRecord. Bietet die gleiche Funktionalität wie Next() , Verwenden Sie diese Methode, wenn der GlideRecord eine Spalte mit dem Namen „Next" hat.
{#SGR-_next__table_e3x_4yj_my__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 98. Parameter]

{#SGR-_next__table_e3x_4yj_my} {#SGR-_next__table_f3x_4yj_my__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Abfragesatz weitere Datensätze enthält. Mögliche Werte: * Wahr: Weitere Datensätze im Abfragesatz. * Falsch: Keine weiteren Datensätze im Abfragesatz. {#SGR-_next__ul_nzg_xkm_knb} |
[Tabelle : 99. Rückgaben]

{#SGR-_next__table_f3x_4yj_my}  
Das folgende Beispiel zeigt, wie die einzelnen Datensätze in der Tabelle „Incidents \[Incident\]" aufgelistet werden.

    var rec = new GlideRecord('incident');
    rec.query();
    while (rec._next()) {
      gs.info(rec.getValue('number') + ' exists');
    }

Ausgabe:

    INC0000060 exists
    INC0009002 exists
    INC0000009 exists
    INC0000010 exists
    INC0000011 exists
    INC0000012 exists
    ...

## Bereichsbezogener GlideRecord -- Vorgang() {#ariaid-title52}

Bestimmt, ob ein Vorgang „Einfügen", „Aktualisieren" oder „Löschen" ist.
Wenn Sie den Vorgang kennen, können Sie verwenden Current.Operation() Dient zum Erstellen einer generischen Business-Regel, die jeden Vorgang eindeutig verarbeiten kann.

Für Informationen zur Verwendung der globalen Variable Aktuell , Siehe [Globale Variablen in Business-Regeln](https://www.servicenow.com/docs/access?context=c_BusinessRules&version=yokohama&pubname=yokohama-application-development&section=c_UsingPredefinedGlobalVariables&ft:locale=en-US).
{#r_ScopedGlideRecordOperation__table_tfc_zsb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 100. Parameter]

{#r_ScopedGlideRecordOperation__table_tfc_zsb_2r} {#r_ScopedGlideRecordOperation__gr-operation-returns__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der aktuelle Vorgang. Mögliche Werte: * löschen * einfügen * Aktualisieren {#r_ScopedGlideRecordOperation__ul_bnp_xs3_bpb} |
[Tabelle : 101. Rückgaben]

{#r_ScopedGlideRecordOperation__gr-operation-returns}  
Das folgende Beispiel zeigt, wie diese Methode in einer Business-Regel verwendet wird. Die Vorgang () Die Methode erkennt, welcher Vorgang ein Ereignis ausgelöst hat, und führt je nach Update- und Einfügevorgängen eine andere Aktion aus.

    if(current.operation() == "update") {
      current.updates ++; } 
    if(current.operation() == "insert") {
      current.updates = 0; }

## Bereichsbezogener GlideRecord -- orderBy(Zeichenfolgenname) {#ariaid-title53}

Gibt eine orderBy-Spalte an.
Rufen Sie diese Methode mehrmals auf, um nach mehreren Spalten zu sortieren. Ergebnisse werden in aufsteigender Reihenfolge angeordnet. Informationen zum Anordnen von Datensätzen in absteigender Reihenfolge finden Sie unter [Bereichsbezogener GlideRecord -- orderByDesc(Zeichenfolgenname)](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordOrderByDesc_String "Gibt eine absteigende Sortierungspalte an.").
{#r_ScopedGlideRecordOrderBy_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Spaltenname, der zum Sortieren der Datensätze in diesem GlideRecord-Objekt verwendet werden soll. |
[Tabelle : 102. Parameter]

{#r_ScopedGlideRecordOrderBy_String__table_vy2_525_jq} {#r_ScopedGlideRecordOrderBy_String__table_ts3_ktb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 103. Rückgaben]

{#r_ScopedGlideRecordOrderBy_String__table_ts3_ktb_2r}  
Das folgende Beispiel zeigt, wie Incident-Datensätze in aufsteigender Reihenfolge nach Kurzbeschreibung angeordnet werden.

    var queryString = "priority=2";
    var now_GR = new GlideRecord('incident');
    now_GR.orderBy('short_description'); // Ascending Order
    now_GR.addEncodedQuery(queryString);
    now_GR.query();
    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Ausgabe:

    Can't launch 64-bit Windows 7 virtual machine
    Can't log into SAP from my laptop today
    Network storage unavailable
    Please remove the latest hotfix from my PC

## Bereichsbezogener GlideRecord -- orderByDesc(Zeichenfolgenname) {#ariaid-title54}

Gibt eine absteigende Sortierungspalte an.
Rufen Sie diese Methode mehrmals auf, um nach mehreren Spalten zu sortieren. Ergebnisse werden in absteigender Reihenfolge angeordnet. Informationen zum Anordnen von Datensätzen in aufsteigender Reihenfolge finden Sie unter [Bereichsbezogener GlideRecord -- orderBy(Zeichenfolgenname)](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#r_ScopedGlideRecordOrderBy_String "Gibt eine orderBy-Spalte an.").
{#r_ScopedGlideRecordOrderByDesc_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Spaltenname, der zum Sortieren der Datensätze in einem GlideRecord-Objekt verwendet werden soll. |
[Tabelle : 104. Parameter]

{#r_ScopedGlideRecordOrderByDesc_String__table_vy2_525_jq} {#r_ScopedGlideRecordOrderByDesc_String__table_lpd_ktb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 105. Rückgaben]

{#r_ScopedGlideRecordOrderByDesc_String__table_lpd_ktb_2r}  
Das folgende Beispiel zeigt, wie Incident-Datensätze in absteigender Reihenfolge nach Kurzbeschreibung angeordnet werden.

    var queryString = "priority=2";
    var now_GR = new GlideRecord('incident');
    now_GR.orderByDesc('short_description'); //Descending Order
    now_GR.addEncodedQuery(queryString);
    now_GR.query();
    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Ausgabe:

    Please remove the latest hotfix from my PC
    Network storage unavailable
    Can't log into SAP from my laptop today
    Can't launch 64-bit Windows 7 virtual machine

## Bereichsbezogener GlideRecord -- Abfrage (Zeichenfolgenfeld, Zeichenfolgenwert) {#ariaid-title55}

Führt eine Abfrage für die Tabelle basierend auf den in den Abfragemethoden angegebenen Filtern aus, z. B. AddQuery() Und AddEncodedQuery() .
Diese Methode fragt die GlideRecord-Tabelle sowie alle Referenzen der Tabelle ab. Weitere Informationen finden Sie unter [Tabellen im Skript werden abgefragt](https://servicenow-prod.fluidtopics.net/Ei8H4_Ts5cukzzD~KWm7GQ#c_UsingGlideRecordToQueryTables "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.").  
Hinweis:  
Diese Methode schlägt fehl, wenn in der Tabelle ein Feld mit der Bezeichnung „Abfrage" vorhanden ist. Wenn dies der Fall ist, verwenden Sie [_Query()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#SGR-_query_O_O "Führt eine Abfrage für die Tabelle basierend auf den in den Abfragemethoden angegebenen Filtern aus, z. B. AddQuery() Und AddEncodedQuery() . Diese Methode soll für Tabellen verwendet werden, in denen sich eine Spalte mit dem Namen „query“ befindet, was zu Fehlern beim Ausführen der query()-Methode führen kann.")Stattdessen Methode.

Siehe [GlideRecord](https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord)artikel mit Details zum Erstellen und Ausführen von Abfragen.  
Siehe auch:

* [GlideAggregat -- Umfang](https://servicenow-prod.fluidtopics.net/aD6zULgUJntUCYyTZz592Q#c_GlideAggregateScopedAPI "Die GlideAggregat API ermöglicht das Erstellen von Datenbankzusammenfassungsabfragen.")
* [GlideQuery: Bereichsbezogen, global](https://servicenow-prod.fluidtopics.net/HnOBGn4sQE9zFCIlhCGCFw#GlideQueryGlobalAPI "Die GlideQuery Die Skripteinbindung ist eine Alternative zu GlideRecord API zum Ausführen von CRUD-Vorgängen für Datensatzdaten aus serverseitigen Skripts.")
* [GlideQueryCondition -- Umfang](https://servicenow-prod.fluidtopics.net/q_iR2gj9SIaEnZW~OgtEGw#c_GlideQueryConditionScopedAPI "Der Umfang ist festgelegt 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.")
{#r_ScopedGlideRecordQuery_Object_Object__ul_u5g_4gd_lpb}
{#r_ScopedGlideRecordQuery_Object_Object__id_nxt_s5d_lpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Optional -- muss auch einen Wertparameter angeben. Name des Felds, in dem nach dem im Wertparameter angegebenen Wert gesucht werden soll. Hinweis: Diese Methode wird normalerweise ohne Argumente ausgeführt, Sie können jedoch ein Name-Wert-Paar angeben, um Datensätze zu filtern, die die angegebenen Werte enthalten. Wenn die Parameter angegeben sind, wird der Abfrage die Bedingung „Name=Wert" hinzugefügt. |
| Wert | Zeichenfolge | Optional -- muss auch einen Feldparameter angeben. Wert, nach dem im angegebenen Feldparameter gesucht werden soll. |
[Tabelle : 106. Parameter]

{#r_ScopedGlideRecordQuery_Object_Object__id_nxt_s5d_lpb} {#r_ScopedGlideRecordQuery_Object_Object__table_bkz_jtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 107. Rückgaben]

{#r_ScopedGlideRecordQuery_Object_Object__table_bkz_jtb_2r}  
Das folgende Beispiel zeigt, wie das Systemwörterbuch \[sys_dictionary\] nach Tabellen mit einem Abfragefeld gescannt wird.

    var tableArr = [];

    var now_GR = new GlideRecord('sys_dictionary');
    now_GR.addQuery('element', 'query');
    now_GR.setLimit(6);

    now_GR.query();

    while(now_GR.next()){
       tableArr.push(now_GR.name.getValue());
    };

    gs.info('The following tables have a field column called "query":');

    for (i = 0; i < tableArr.length; i++) {
       gs.info(tableArr[i]);
    };

Ausgabe:

    The following tables have a field column called "query":
    cmdb_convert_bulk_services
    cmdb_multisource_query_status
    cmdb_qb_result_base
    cmdb_qb_table_mapping
    discovery_probes_cim_query
    kb_feedback

## Bereichsbezogener GlideRecord -- _query(Zeichenfolgenfeld, Zeichenfolgenwert) {#ariaid-title56}

Führt eine Abfrage für die Tabelle basierend auf den in den Abfragemethoden angegebenen Filtern aus, z. B. AddQuery() Und AddEncodedQuery() .
Diese Methode soll für Tabellen verwendet werden, in denen sich eine Spalte mit dem Namen „query" befindet, was zu Fehlern beim Ausführen der query()-Methode führen kann.
Diese Methode fragt die GlideRecord-Tabelle sowie alle Referenzen der Tabelle ab. Weitere Informationen finden Sie unter [Tabellen im Skript werden abgefragt](https://servicenow-prod.fluidtopics.net/Ei8H4_Ts5cukzzD~KWm7GQ#c_UsingGlideRecordToQueryTables "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.").

Siehe [GlideRecord](https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord)artikel mit Details zum Erstellen und Ausführen von Abfragen.  
Siehe auch:

* [GlideAggregat -- Umfang](https://servicenow-prod.fluidtopics.net/aD6zULgUJntUCYyTZz592Q#c_GlideAggregateScopedAPI "Die GlideAggregat API ermöglicht das Erstellen von Datenbankzusammenfassungsabfragen.")
* [GlideQuery: Bereichsbezogen, global](https://servicenow-prod.fluidtopics.net/HnOBGn4sQE9zFCIlhCGCFw#GlideQueryGlobalAPI "Die GlideQuery Die Skripteinbindung ist eine Alternative zu GlideRecord API zum Ausführen von CRUD-Vorgängen für Datensatzdaten aus serverseitigen Skripts.")
* [GlideQueryCondition -- Umfang](https://servicenow-prod.fluidtopics.net/q_iR2gj9SIaEnZW~OgtEGw#c_GlideQueryConditionScopedAPI "Der Umfang ist festgelegt 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.")
{#SGR-_query_O_O__ul_u5g_4gd_lpb}
{#SGR-_query_O_O__id_a3y_t5d_lpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Optional -- muss auch einen Wertparameter angeben. Name des Felds, in dem nach dem im Wertparameter angegebenen Wert gesucht werden soll. Hinweis: Diese Methode wird normalerweise ohne Argumente ausgeführt, Sie können jedoch ein Name-Wert-Paar angeben, um Datensätze zu filtern, die die angegebenen Werte enthalten. Wenn die Parameter angegeben sind, wird der Abfrage die Bedingung „Name=Wert" hinzugefügt. |
| Wert | Zeichenfolge | Optional -- muss auch einen Feldparameter angeben. Wert, nach dem im angegebenen Feldparameter gesucht werden soll. |
[Tabelle : 108. Parameter]

{#SGR-_query_O_O__id_a3y_t5d_lpb} {#SGR-_query_O_O__table_whc_pcq_fz__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 109. Rückgaben]

{#SGR-_query_O_O__table_whc_pcq_fz}  
Das folgende Beispiel zeigt, wie Sie die Tabelle „Wissensfeedback" \[kb_Feedback\] abfragen und KB-Artikel mit Kommentaren auflisten, die Excel enthalten.

    var rec = new GlideRecord('kb_feedback');
    rec.addQuery('comments', 'CONTAINS', 'Excel');
    rec._query();
    while (rec.next()) { 
     gs.info(rec.getDisplayValue('article') + " comment: " + rec.getValue('comments'));
    }

Ausgabe:

    KB0000005 comment: 
    	     Can you please add the version of Excel this applies to? All?
    		
    KB0000005 comment: 
    	     Does this work for all Excel versions? OSX and Windows alike?

## Bereichsbezogener GlideRecord -- setAbortAction (boolescher Wert b) {#ariaid-title57}

Legt eine Kennzeichnung fest, die angibt, ob die nächste Datenbankaktion (Einfügen, Aktualisieren, Löschen) abgebrochen werden soll. Dies wird häufig in Business-Regeln verwendet.
Verwenden Sie in `OnBefore `Business-Regel, um zu verhindern, dass die Datenbankaktion ausgeführt wird. Die Business-Regel wird nach weiterhin ausgeführt SetAbortAktion() Wird aufgerufen. Wird Aufgerufen SetAbortAktion() Verhindert nicht, dass nachfolgende Business-Regeln ausgeführt werden. Das Aufrufen dieser Methode verhindert nur, dass die Datenbankaktion ausgeführt wird.
{#r_ScopedGlideRecordSetAbortAction_Boolean__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| b | Boolean | „Wahr", um die nächste Aktion abzubrechen. „Falsch", wenn die Aktion zulässig sein soll. |
[Tabelle : 110. Parameter]

{#r_ScopedGlideRecordSetAbortAction_Boolean__table_vy2_525_jq} {#r_ScopedGlideRecordSetAbortAction_Boolean__table_yv5_jtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 111. Rückgaben]

{#r_ScopedGlideRecordSetAbortAction_Boolean__table_yv5_jtb_2r}  

    // Often used in business rule to check whether the current operation should be aborted.
    if (current.size > 16) {
      current.setAbortAction(true);
    }

## Bereichsbezogener GlideRecord -- setLimit(Number maxNumRecords) {#ariaid-title58}

Legt den Grenzwert für die Anzahl der Datensätze fest, die von der GlideRecord-Abfrage abgerufen werden.
{#r_ScopedGlideRecordSetLimit_Number__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| MaxNumRecords | Nummer | Die maximale Anzahl der abzurufenden Datensätze. |
[Tabelle : 112. Parameter]

{#r_ScopedGlideRecordSetLimit_Number__table_vy2_525_jq} {#r_ScopedGlideRecordSetLimit_Number__table_owp_jtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 113. Rückgaben]

{#r_ScopedGlideRecordSetLimit_Number__table_owp_jtb_2r}  

    var now_GR = new GlideRecord('incident');
    now_GR.orderByDesc('sys_created_on');
    now_GR.setLimit(10);
    now_GR.query(); // this retrieves latest 10 incident records created

## Bereichsbezogener GlideRecord -- setNewGuidValue(Zeichenfolge GUID) {#ariaid-title59}

Legt den sys_ID-Wert für den aktuellen Datensatz fest.
{#r_ScopedGlideRecordSetNewGuidValue_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| guid | Zeichenfolge | GUID, die dem aktuellen Datensatz zugewiesen werden soll. |
[Tabelle : 114. Parameter]

{#r_ScopedGlideRecordSetNewGuidValue_String__table_vy2_525_jq} {#r_ScopedGlideRecordSetNewGuidValue_String__table_akk_jtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 115. Rückgaben]

{#r_ScopedGlideRecordSetNewGuidValue_String__table_akk_jtb_2r}  

    var now_GR = new GlideRecord('incident');
    now_GR.setValue('short_description', 'The third floor printer is broken');
    now_GR.setNewGuidValue('eb4636ca6f6d31005be8883e6b3ee333');
    now_GR.insert();
    gs.info(now_GR.getValue('sys_id'));

## Bereichsbezogener GlideRecord -- setValue (Zeichenfolgenname, Objektwert) {#ariaid-title60}

Legt den Wert des Felds mit dem angegebenen Namen auf den angegebenen Wert fest.
Normalerweise führt das Skript einen aus `now_GR.category = Wert `. Wenn der Elementname jedoch selbst eine Variable ist, können Sie verwenden `now_GR.setValue(elementName, Wert) `. Stellen Sie beim Festlegen eines Werts sicher, dass der Datentyp des Felds mit dem Datentyp des eingegebenen Werts übereinstimmt.  
Hinweis:  
Wenn Feldverschlüsselung EnterprisePlugin ist aktiviert, und die Instanz hat Zugriff auf den Schlüssel. Diese Methode kann verschlüsselte Daten in verschlüsselte Felder einfügen. Wenn die Instanz keinen Zugriff auf den Schlüssel hat, gibt diese Methode einen Fehler zurück. Weitere Informationen finden Sie unter [Plattformverschlüsselung](https://www.servicenow.com/docs/access?context=now-platform-encryption&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).  

Nicht für Authentifizierung mit Passwort2-Feldern
:   Die SetWert() Die Methode übergibt Passwort2-Daten als Klartext, was zu einem Fehler beim erwartet verschlüsselter Daten führt. Darüber hinaus werden durch die Verwendung der setValue()-Methode für Passwort2-Felder Daten verfügbar gemacht, die verschlüsselt werden sollen.

    Verwenden Sie für die Passwort2-Authentifizierung SetDisplayWert() Stattdessen Methode.  
    Siehe auch:

    * [Deprecate GlideEncrypter usage of 3DES for password2 fields](https://www.servicenow.com/docs/access?context=password2-3des-deprecation&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)
    * [Alternativen zur Nutzung von GlideEncrypter im Knowledge Base-artikel KB1320986](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1320986)
    * [Password2 encryption with the Key Management Framework (KMF)](https://www.servicenow.com/docs/access?context=password-2way-encrypted-fields&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)
    {#r_ScopedGlideRecordSetValue_String_Object__ul_m1z_5js_12c}
{#r_ScopedGlideRecordSetValue_String_Object__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des Felds. |
| Wert | Objekt | Wert, der dem Feld zugewiesen werden soll. |
[Tabelle : 116. Parameter]

{#r_ScopedGlideRecordSetValue_String_Object__table_vy2_525_jq} {#r_ScopedGlideRecordSetValue_String_Object__table_bp2_jtb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 117. Rückgaben]

{#r_ScopedGlideRecordSetValue_String_Object__table_bp2_jtb_2r}  

    var elementName = 'short_description'; 
    var now_GR = new GlideRecord('incident'); 
    now_GR.initialize(); 
    now_GR.setValue(elementName, "My DB is not working");
    now_GR.insert();

## Bereichsbezogener GlideRecord -- setWorkflow (boolescher Wert aktivieren) {#ariaid-title61}

Aktiviert oder deaktiviert die Ausführung von Business-Regeln, Skript-Engines und Audit.
Warnung:  
Das Deaktivieren der Ausführung von Business-Regeln, Skript-Engines und Audit kann erhebliche Auswirkungen auf haben ServiceNow®Instanz und Funktionsweise. Stellen Sie sicher, dass Sie diesen Change gründlich testen, bevor Sie ihn in der Produktion bereitstellen.  
Hinweis:  
Diese Methode kann nicht für bereichsübergreifende Anwendungen festgelegt werden. Weitere Informationen finden Sie im folgenden KB-artikel [https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB0820691](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0820691).
{#r_ScopedGlideRecordSetWorkflow_Boolean__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| enable | Boolean | Kennzeichnung, die angibt, ob die Ausführung von Business-Regeln, Skript-Engines und Audit aktiviert oder deaktiviert werden soll. Gültige Werte: * Wahr: Aktivieren Sie die Ausführung von Business-Regeln, Skript-Engines und Audit. * Falsch: Deaktivieren Sie die Ausführung von Business-Regeln, Skript-Engines und Audit. {#r_ScopedGlideRecordSetWorkflow_Boolean__ul_rb1_bwx_zqb} Standard: Wahr |
[Tabelle : 118. Parameter]

{#r_ScopedGlideRecordSetWorkflow_Boolean__table_vy2_525_jq} {#r_ScopedGlideRecordSetWorkflow_Boolean__table_cdx_3tb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 119. Rückgaben]

{#r_ScopedGlideRecordSetWorkflow_Boolean__table_cdx_3tb_2r}  

    //Enable business rules, scripts engines for x_app_table
    var now_GR = new GlideRecord("x_app_table"); 
    now_GR.setWorkflow(true);

## Bereichsbezogener GlideRecord -- Update (Zeichenfolgengrund) {#ariaid-title62}

Aktualisiert den GlideRecord mit allen vorgenommenen Änderungen. Wenn der Datensatz noch nicht vorhanden ist, wird er eingefügt.
{#r_ScopedGlideRecordUpdate_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Grund | Zeichenfolge | Optional. Grund für die Aktualisierung. Der Grund wird im Audit-Datensatz angezeigt. |
[Tabelle : 120. Parameter]

{#r_ScopedGlideRecordUpdate_String__table_vy2_525_jq} {#r_ScopedGlideRecordUpdate_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des neuen oder aktualisierten Datensatzes. Gibt Null zurück, wenn das Update fehlschlägt. |
[Tabelle : 121. Rückgaben]

{#r_ScopedGlideRecordUpdate_String__table_qpt_3f5_jq}  
Das folgende Beispiel zeigt, wie das Feld „Kurzbeschreibung" eines Incidents aktualisiert wird.

    var now_GR = new GlideRecord('incident');
    now_GR.get('99ebb4156fa831005be8883e6b3ee4b9');
    now_GR.setValue('short_description', 'Update the short description');
    now_GR.update();
    gs.info(now_GR.getElement('short_description'));

Ausgabe:

    Update the short description.

## Bereichsbezogener GlideRecord -- updateMultiple() {#ariaid-title63}

Aktualisiert jeden GlideRecord in einer angegebenen Abfrage mit einem angegebenen Satz von Änderungen.
Diese Methode unterstützt das Hinzufügen mehrerer Journaleinträge nicht.

Die glide.db.forced.chunk.thresholdDie Systemeigenschaft legt den Schwellenwert fest, über dem das Löschen und Aktualisieren von Blockdatensätzen erzwungen wird. Durch das Blockieren wird verhindert, dass nicht primäre Schlüssel in großen Tabellen zu Replikationsproblemen führen. Weitere Informationen 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).
Hinweis:  
Um die erwarteten Ergebnisse sicherzustellen, verwenden Sie SetWert() Methode anstelle von direkten Zuweisungen. Das heißt, verwenden `gr_Now.setValue('<field_name>", „4"); `Anstelle von `gr_now.<field_name> = 4 `.  
Hinweis:  
Verwenden Sie diese Methode nicht mit Select Window() Oder SetLimit() Methoden bei der Arbeit mit großen Tabellen.

Diese Methode legt neue Werte fest und löscht keine vorhandenen Werte. Verwenden Sie zum Löschen eines vorhandenen Werts SetWert() Methode und legen Sie das Feld auf fest Null .
{#r_ScopedGlideRecordUpdateMultiple__table_qwk_ysb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 122. Parameter]

{#r_ScopedGlideRecordUpdateMultiple__table_qwk_ysb_2r} {#r_ScopedGlideRecordUpdateMultiple__table_fj2_htb_2r__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 123. Rückgaben]

{#r_ScopedGlideRecordUpdateMultiple__table_fj2_htb_2r}  
Dieses Beispiel zeigt, wie der Status aller aktiven Incidents auf 4 -- „Warten auf Anwenderinformationen" aktualisiert wird.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('active', true);
    now_GR.setValue('state',  4);
    now_GR.updateMultiple();

## Bereichsbezogener GlideRecord -- updateWithReferences (Objekturgrund) {#ariaid-title64}

Aktualisiert einen Datensatz und fügt auch alle zugehörigen Datensätze mit den bereitgestellten Informationen ein oder aktualisiert sie.
{#SGR-updateWithReferences_O__id_hhh_2fd_3zb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Grund | Objekt | Grund für die Updates. Der Grund wird im Audit-Datensatz angezeigt. |
[Tabelle : 124. Parameter]

{#SGR-updateWithReferences_O__id_hhh_2fd_3zb} {#SGR-updateWithReferences_O__id_l3b_ffd_3zb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die sys_ID für den zu aktualisierenden Datensatz. |
[Tabelle : 125. Rückgaben]

{#SGR-updateWithReferences_O__id_l3b_ffd_3zb}  
Bei der Verarbeitung eines Incidents, bei dem die Anrufer-ID auf den sys_user-Datensatz „John Doe" festgelegt ist, würde der folgende Code den Anwenderdatensatz von John Doe aktualisieren. Bei der Verarbeitung eines Incidents, bei dem keine Anrufer-ID angegeben ist, erstellt der folgende Code einen neuen sys_user-Datensatz mit den angegebenen Informationen (first_Name, Last_Name) und legt den Wert der Anrufer-ID auf den neu erstellten sys_user-Datensatz fest.

    var inc = new GlideRecord('incident');
    inc.get(inc_sys_id);  // Looking up an existing incident record where 'inc_sys_id' represents the sys_id of a incident record
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.updateWithReferences();
    }


