GlideRecord – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 81 Minuten Lesedauer
  • Die GlideRecord API wird für Datenbankvorgänge verwendet.

    Die GlideRecord API ist das primäre Mittel für die Verbindung mit der Datenbank im 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.

    Um diese API zum Erstellen dynamischer Attribute zu verwenden, müssen Sie über die Rolle Dynamic_Schema_Writer verfügen. Um dynamische Daten mit dieser API zu lesen, müssen Sie über die Rolle Dynamic_Schema_Reader verfügen.

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Siehe GlideRecord artikel mit Details zum Erstellen und Ausführen von Abfragen.

    Für Informationen zu GlideRecordSecure , Von der eine Klasse geerbt wird GlideRecord Das die gleichen Funktionen wie ausführt GlideRecord Und erzwingt auch ACLs, siehe GlideServer-APIs .

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Ruft Werte aus Datensätzen ab

    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:

    Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die 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();

    Dynamische Attribute

    In dieser API gibt es Methoden, die dieselbe Funktionalität wie dynamische Schemamethoden in haben GlideDynamicAttributeStore – Global API. Verwenden Sie die dynamischen Attributmethoden in dieser API, um Aktionen für einen angegebenen GlideRecord auszuführen. Verwenden Sie die Methoden in GlideDynamicAttributeStore API, wenn Sie dieselbe Gruppe dynamischer Attribute für mehrere Datensätze festlegen möchten. Mit dieser API können Sie ein GlideDynamicAttributeStore-Objekt mit den gewünschten Attributen bereitstellen und dieses Objekt dann mithilfe der verschiedenen in mehrere GlideRecords kopieren SetDynamicAttributeValues() Methoden.

    GlideRecord – GlideRecord(String tableName)

    Erstellt eine Instanz der GlideRecord-Klasse für die angegebene Tabelle.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Zu verwendende Tabelle.
    var now_GR = new GlideRecord('incident');

    GlideRecord – addActiveQuery()

    Fügt einen Filter hinzu, um aktive Datensätze zurückzugeben.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Filter, um aktive Datensätze zurückzugeben.
    var inc = new GlideRecord('incident');
    inc.addActiveQuery();
    inc.query();

    Bereichsbezogenes Äquivalent

    Um die addActiveQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addActiveQuery().

    GlideRecord – addDomainQuery(Object glideRecord)

    Ändert die für die Abfrage verwendete Domäne von der Domäne des Benutzers in die Domäne des bereitgestellten GlideRecord.

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Diese Funktion erfordert das Plugin Domänenunterstützung – Domänenerweiterungs-Installationsprogramm (com.glide.domain.msp_extensions.installer).

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    glideRecord Objekt GlideRecord, aus dem die Domäne abgerufen werden kann.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    void
    //This example requires the Domain plugin be active, the Group table is the specified 
    //Domain table, and the ITIL user is in the Database Atlanta domain
    //From any domain (using queryNoDomain()) look up the incidents that an ITIL user can only see 
    //who is in the Database Atlanta domain, should expect all incidents with the global or the
    //Database Atlanta domain specified.
    var domain = new GlideRecord('sys_user');
    domain.addQuery('user_name', 'itil');
    domain.queryNoDomain();
    if (domain.next()) {
        var domainQuery = new GlideRecord('incident');
        domainQuery.addQuery('active', true);
        domainQuery.addDomainQuery(domain);
        domainQuery.query();
        gs.print('Number of Incidents for ITIL user: ' + domainQuery.getRowCount());
        while (domainQuery.next())
            gs.print(domainQuery.number);
    }

    Bereichsbezogenes Äquivalent

    Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

    GlideRecord – addEncodedQuery(Zeichenfolgenabfrage, boolescher Wert enforceFieldACL)

    Fügt eine codierte Abfrage anderen Abfragen hinzu, die möglicherweise festgelegt wurden.

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Ein Codierte Abfragezeichenfolge .
    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.

    Standardwert: false

    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    void
    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.number);
     }

    Bereichsbezogenes Äquivalent

    Um die addEncodedQuery()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: addEncodedQuery().

    GlideRecord – addExtraField(Zeichenfolge dotWalkedField)

    Fragt ein oder mehrere Dot-Walking-Felder aus einem Formular oder Skript in einer einzelnen Anforderung ab.

    Die AddExtraField() Mit der Methode können Sie Dot-Walking-Felder in einer einzelnen Datenbankanforderung abfragen, anstatt mehrere Abfragen pro Dot-Walking-Element in einem Formular oder Skript auszuführen (was mehrere Round-Trips zur Datenbank erfordert).

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    DotWalkedField Zeichenfolge Der Feldname für DOT-Walking. Ebenen von Feldnamen werden durch Punkte (Zeiträume) getrennt. Geben Sie beispielsweise den Wert ein Caller.Company Wenn Sie abfragen möchten Unternehmen > Anrufer Bedingung in der Tabelle „Incident“ [Incident].

    Das Format von dotWalkedFieldFolgt der Reihenfolge von Feldern von links nach rechts in einem Dotwalk-Formular oder Skript.

    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Keine
    Hinweis:
    Die AddExtraField() Die Methode wirkt sich nicht auf die Ausgabeergebnisse aus. Die Ausgabe ist immer dieselbe, unabhängig davon, ob Sie diese Methode in Ihrem Skript verwenden.
    Das folgende Beispiel zeigt, wie das Feld „Kontaktname“ von „cmn_location“ abgefragt wird (referenziert aus dem Referenzfeld „Standort“ in einem cmdb_ci-Feld).
    Hinweis:
    Der dotWalkedField-Wert in diesem Beispiel cmdb_ci.location.contact.name , Sieht wie „cmdb_ci-Felder“ => „cmn_location-Felder“ => „sys_user-Felder“ in aus ServiceNow® UI beim Auswählen von Feldern in einer Liste.
    var gliderecord = new GlideRecord("incident");
    gliderecord.addQuery("number", "INC0041457");
    gliderecord.addExtraField("cmdb_ci.location.contact.name");
    gliderecord.query();
    gliderecord.next();
    gs.print(gliderecord.cmdb_ci.location.contact.name);

    Die Ausgabe ist mit identisch gs.print(gr.cmdb_ci.location.contact.name) Ohne zu verwenden AddExtraField() . Die AddExtraField() Die Methode optimiert die Abfrage der Dot-Walking-Felder. Beispielausgabe:

    Abel Tuter

    GlideRecord – addFunction(Object function)

    Wendet ein vordefiniertes GlideDBFunctionBuilder-Objekt auf einen Datensatz an.

    Verwenden Sie die bereichsbezogene GlideDBFunctionBuilder-Klasse, um eine Funktion zu definieren. Nachdem die Funktion definiert wurde, verwenden Sie die addFunction(Object function)-Methode, um die Funktion auf einen Datensatz anzuwenden.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    function Objekt Ein GlideDBFunctionBuilder- oder GlideDBCaseStatementBuilder-Objekt, das einen SQL-Vorgang definiert.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    void
    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();
    
    var now_GR = new GlideRecord('incident');
    now_GR.addFunction(myAddingFunction);
    now_GR.addQuery(myAddingFunction, '<', 5);
    now_GR.query();
    while(now_GR.next())
    gs.log(now_GR.getValue(myAddingFunction));
    

    Ausgabe:

    *** Script: 1
    *** Script: 4
    *** Script: 3
    *** Script: 1
    *** Script: 1
    *** Script: 2
    *** Script: 1
    *** Script: 1

    GlideRecord – addUserQuery (Zeichenfolgenname, Objektanbieter, Objektwert)

    Bietet die Möglichkeit, eine ACL-Prüfung für eine angegebene Abfragezeichenfolge zu erzwingen.

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Tabellenfelds.
    operator Objekt Abfrageoperator. Die verfügbaren Werte sind vom Datentyp des value-Parameters abhängig.
    Zahlen:
    • =
    • !=
    • >
    • >=
    • <
    • <=
    Zeichenfolgen (in Großbuchstaben):
    • =
    • !=
    • IN
    • NOT IN
    • STARTSWITH
    • ENDSWITH
    • CONTAINS
    • DOES NOT CONTAIN
    • INSTANCEOF
    Hinweis:
    Verwenden Sie „ENTHÄLT“ anstelle des „GEFÄLLT MIR“-Operators.
    Dynamische Schemaoperatoren:
    • =
    • !=
    • <
    • >
    • <=
    • >=
    • BETWEEN
    • CONTAINS
    • NICHT_ENTHALTEN
    • ENDSWITH
    • GT_FIELD
    • GT_OR_EQUALS_FIELD
    • IN
    • ISEMPTY
    • ISNOTEMPTY
    • IST_NOT_NULL
    • IST_NULL
    • GEFÄLLT MIR
    • LT_FIELD
    • LT_OR_EQUALS_FIELD
    • STIMMT ÜBEREIN
    • NOT_IN
    • NOT_LIKE
    • NOT_MATCHES
    • NSAMEAS
    • SAMEAS
    • STARTSWITH
    Wert Objekt Wert, nach dem abgefragt werden soll (Groß- und Kleinschreibung wird nicht berücksichtigt).
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Dem GlideRecord hinzugefügte Abfragebedingung.
    var rec = new GlideRecord('sys_user');
    rec.addUserQuery("first_name", "=", "Fred");
    rec.query();
    while (rec.next()) {
      gs.info('Active user ' + rec.getValue('last_name'));
    }

    Bereichsbezogenes Äquivalent

    Zur Verwendung von AddUserQuery() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: AddUserQuery() .

    GlideRecord – addInactiveQuery()

    Fügt einen Filter hinzu, um inaktive Datensätze zurückzugeben. Inaktive Datensätze weisen „false“ für das aktive Flag auf.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Zeichnet auf, wo das aktive Flag „false“ ist.
    var inc = new GlideRecord('incident');
    inc.addInactiveQuery();
    inc.query();

    Bereichsbezogenes Äquivalent

    Verwenden Sie in bereichsbezogenen Anwendungen die bereichsbezogene Methode addQuery("active","false").

    GlideRecord – addJoinQuery(String table)

    Fügt einen Filter hinzu, um Datensätze basierend auf einer Beziehung in einer verknüpften Tabelle zurückzugeben.

    Suchen Sie beispielsweise alle Benutzer in der Datenbankgruppe (Benutzer über sys_user_grmember-Tabelle). Ein anderes Beispiel wäre das Suchen aller Probleme, denen ein Incident zugewiesen wurde (Probleme über die incident.problem_id-Beziehung).

    Dies ist kein echter Datenbank-Join, sondern addJoinQuery() fügt eine Unterabfrage hinzu. Während der Ergebnissatz auf der Grundlage des Joins begrenzt ist, haben Sie nur auf die Felder der Basistabelle Zugriff (diejenigen, die sich in der Tabelle befinden, mit der GlideRecord initialisiert wurde).

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Tabellenname
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Zeichnet auf, wo die Beziehungen übereinstimmen.

    Suchen Sie Probleme, denen ein Incident zugeordnet ist. In diesem Beispiel werden Probleme mit zugeordneten Incidents zurückgegeben. 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 active=false-Probleme mit zugeordneten Incidents.

    // Look for Problem records
    var now_GR = new GlideRecord('problem');
     
    // That have associated Incident records
    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 print results
    while (now_GR.next()) {
        gs.print(now_GR.getValue('number'));
    }

    Bereichsbezogenes Äquivalent

    Um die addJoinQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addJoinQuery().

    GlideRecord – addJoinQuery(String table, String primaryField)

    Fügt einen Filter hinzu, um Datensätze basierend auf einer Beziehung in einer verknüpften Tabelle zurückzugeben.

    Suchen Sie beispielsweise alle Benutzer in der Datenbankgruppe (Benutzer über sys_user_grmember-Tabelle). Ein anderes Beispiel wäre das Suchen aller Probleme, denen ein Incident zugewiesen wurde (Probleme über die incident.problem_id-Beziehung).

    Dies ist kein echter Datenbank-Join, sondern addJoinQuery() fügt eine Unterabfrage hinzu. Während der Ergebnissatz auf der Grundlage des Joins begrenzt ist, haben Sie nur auf die Felder der Basistabelle Zugriff (diejenigen, die sich in der Tabelle befinden, mit der GlideRecord initialisiert wurde).

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Tabellenname
    primaryField Zeichenfolge Primärfeld (wenn nicht sys_id).
    Tabelle : 19. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Zeichnet auf, wo die Beziehungen übereinstimmen.

    Suchen Sie Probleme mit Incidents, indem Sie das Feld Open_by am Join-Schlüssel anstelle der sys_ID verwenden

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

    Bereichsbezogenes Äquivalent

    Um die addJoinQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addJoinQuery().

    GlideRecord – addJoinQuery(String table, String primaryField, String joinTableField)

    Fügt einen Filter hinzu, um Datensätze basierend auf einer Beziehung in einer verknüpften Tabelle zurückzugeben.

    Suchen Sie beispielsweise alle Benutzer in der Datenbankgruppe (Benutzer über sys_user_grmember-Tabelle). Ein anderes Beispiel wäre das Suchen aller Probleme, denen ein Incident zugewiesen wurde (Probleme über die incident.problem_id-Beziehung).

    Dies ist kein echter Datenbank-Join, sondern addJoinQuery() fügt eine Unterabfrage hinzu. Während der Ergebnissatz auf der Grundlage des Joins begrenzt ist, haben Sie nur auf die Felder der Basistabelle Zugriff (diejenigen, die sich in der Tabelle befinden, mit der GlideRecord initialisiert wurde).

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Tabellenname
    primaryField Zeichenfolge Primärfeld (wenn nicht sys_id).
    joinTableField Zeichenfolge Feld, das die Tabellen verbindet (wenn nicht sys_id)
    Tabelle : 21. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Zeichnet auf, wo die Beziehungen übereinstimmen.

    Suchen Sie nach Problemen mit zugeordneten Incidents, bei denen der caller_id-Feldwert des Incident dem des opened_by-Field des Problems entspricht.

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

    Bereichsbezogenes Äquivalent

    Um die addJoinQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addJoinQuery().

    GlideRecord – addNotNullQuery(String fieldName)

    Fügt einen Filter hinzu, um Datensätze zurückzugeben, bei denen das angegebene Feld nicht NULL ist.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition GlideQueryCondition von Datensätzen, bei denen das Parameterfeld nicht null ist.
    var target = new GlideRecord('incident'); 
      target.addNotNullQuery('short_description');
      target.query();   // Issue the query to the database to get all records
      while (target.next()) {   
         // add code here to process the incident record
      }

    Bereichsbezogenes Äquivalent

    Um die addNotNullQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addNotNullQuery().

    GlideRecord – addNullQuery(String fieldName)

    Fügt einen Filter hinzu, um Datensätze zurückzugeben, bei denen das angegebene Feld NULL ist.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    Tabelle : 25. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition GlideQueryCondition von Datensätzen, bei denen das angegebene Feld null ist.
    var target = new GlideRecord('incident'); 
      target.addNullQuery('short_description');
      target.query();   // Issue the query to the database to get all records
      while (target.next()) {   
         // add code here to process the incident record
      }

    Bereichsbezogenes Äquivalent

    Um die addNullQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addNullQuery().

    GlideRecord – addQuery(String name, Object operator, Object value)

    Bietet die Möglichkeit, eine Anforderung zu erstellen, die bei ihrer Ausführung die Zeilen der angegebenen Tabelle zurückgibt, die der Anforderung entsprechen.

    Wenn Sie mit SQL vertraut sind, ähnelt diese Methode der „Where“-Klausel. Sie können einen oder mehrere erstellen AddQuery() Ruft in einer einzelnen Abfrage auf. Für diese Methode sind die Abfragen UND'ed. Wenn eine der Abfrageanweisungen ODER sein muss, verwenden Sie die Klasse GlideQueryCondition .

    addQuery() wird normalerweise mit drei Parametern aufgerufen; Tabellenfeld, Operator und Vergleichswert. Es kann nur mit zwei Parametern aufgerufen werden, Tabellenfeld und Vergleichswert, z. B. myObj.addQuery('category','Hardware');. In diesem Fall wird davon ausgegangen, dass der Operator „equal to“ ist.

    Weitere Informationen zur Verwendung von Abfragen finden Sie unter Tabellen im Skript werden abgefragt .

    Testen Sie Abfragen immer in einer Test- und Entwicklungsumgebung, bevor Sie sie in einer Produktionsinstanz bereitstellen. Eine falsch erstellte codierte Abfrage, z. B. das Hinzufügen eines ungültigen Feldnamens, führt zu einer ungültigen Abfrage. Wenn die ungültige Abfrage ausgeführt wird, wird der ungültige Teil der Abfragebedingung gelöscht und die Ergebnisse basieren auf dem gültigen Teil der Abfrage, der möglicherweise alle Datensätze aus der Tabelle zurückgibt. Die Methode insert(), update(), deleteRecord() oder deleteMultiple() kann bei schlechten Abfrageergebnissen 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 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.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Tabellenfeldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher-Element.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    operator Objekt Abfrageoperator. Die verfügbaren Werte sind vom Datentyp des value-Parameters abhängig.
    Zahlen:
    • =
    • !=
    • >
    • >=
    • <
    • <=
    Zeichenfolgen (in Großbuchstaben):
    • =
    • !=
    • IN
    • NOT IN
    • STARTSWITH
    • ENDSWITH
    • CONTAINS
    • DOES NOT CONTAIN
    • INSTANCEOF
    Hinweis:
    Verwenden Sie „ENTHÄLT“ anstelle des „GEFÄLLT MIR“-Operators.
    Dynamische Schemaoperatoren:
    • =
    • !=
    • <
    • >
    • <=
    • >=
    • BETWEEN
    • CONTAINS
    • NICHT_ENTHALTEN
    • ENDSWITH
    • GT_FIELD
    • GT_OR_EQUALS_FIELD
    • IN
    • ISEMPTY
    • ISNOTEMPTY
    • IST_NOT_NULL
    • IST_NULL
    • GEFÄLLT MIR
    • LT_FIELD
    • LT_OR_EQUALS_FIELD
    • STIMMT ÜBEREIN
    • NOT_IN
    • NOT_LIKE
    • NOT_MATCHES
    • NSAMEAS
    • SAMEAS
    • STARTSWITH
    Wert Objekt Wert, nach dem abgefragt werden soll (Groß- und Kleinschreibung wird nicht berücksichtigt).
    Tabelle : 27. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Verweis auf die GlideQueryCondition, die dem GlideRecord hinzugefügt wurde.

    Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird.

    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.active = false;
     gs.print('Active incident ' + rec.number + ' closed');
     rec.update();
    }

    Das folgende Beispiel zeigt die Verwendung von IN Operator.

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

    Das folgende Beispiel zeigt, wie diese Methode für die Verwendung von Attributen in einem dynamischen Attributspeicher aufgerufen wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.addQuery('inc_dynamic_schema->cars->avg_mpg', 'GT_FIELD', 'inc_dynamic_schema2->cars->avg_mpg'); 
    gr_Inc.query();
    while(gr_Inc.next()) {
        gs.info(gr_Inc.number + " Gas Mileage 1: " + gr_Inc.getDynamicAttributeValue('inc_dynamic_schema->cars->avg_mpg') +  " GT_FIELD Gas Mileage 2 :" + gr_Inc.getDynamicAttributeValue('inc_dynamic_schema2->cars->avg_mpg'));
    }

    Bereichsbezogenes Äquivalent

    Um die addQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addQuery().

    GlideRecord – addValue(Zeichenfolgenfeld, Zahlenwert)

    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. Bei 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, ist der Wert des Felds u_count in der Datenbank 2.
    gs.print(now_now_GR.u_count); // "1" 
    now_GR.u_count += 1; 
    now_GR.update(); 
    now_GR.get(now_now_GR.sys_id); 
    gs.print(now_now_GR.u_count); // "2"   
    Wenn ein anderer Anwender gleichzeitig identischen Code ausführt, anstelle der beiden Vorgänge, die jeweils 1 zu u_count addieren, besteht der Nettoeffekt darin, dass u_count nur 2 enthält, 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.print(now_now_GR.u_count); // "1" 
    now_GR.addValue("u_count", 1); 
    now_GR.update(); 
    now_GR.get(now_GR); // The record must be reloaded from the database to observe the result
    gs.print(now_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 geschehen.

    Gefällt Mir SetValue() , 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 SetValue() Wird für das angegebene Feld vor dem Aufruf aufgerufen AddValue() , AddValue() Methode wird nicht verarbeitet, und eine Fehlermeldung wird protokolliert.
    Tabelle : 28. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Der Name des Felds in diesem GlideRecord, das geändert werden soll.

    Wenn das zugeordnete Feld kein numerischer Typ ist, wird der Vorgang ignoriert.

    Wert Anzahl Der 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 : 29. Rückgaben
    Typ Beschreibung
    void

    Zeigt einen hinzugefügten Wert an.

    gs.print(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.print(now_GR.u_count);

    Ausgabe: 2

    Zeigt einen subtrahierten Wert an.

    gs.print(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.print(now_GR.u_count);

    Ausgabe: 3

    GlideRecord – applyEncodedQuery(Zeichenfolge QueryString)

    Legt die Werte der angegebenen codierten Abfragebegriffe fest und wendet sie auf den aktuellen GlideRecord an.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    queryString Zeichenfolge Codierte Abfrage, die auf den aktuellen GlideRecord angewendet werden soll.
    Tabelle : 31. Rückgaben
    Typ Beschreibung
    Keine

    function createAcl(table, role) {
      gs.print("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.sys_id.toString(), role);
        return;
      } else {
      now_GR.initialize();
      now_GR.applyEncodedQuery(encQuery);
      var acl = now_GR.insert();
        gs.print("Added read access control on " + table);
        createAclRole(acl, role);
      } 
    }

    GlideRecord – applyTemplate(String template)

    Wenden Sie einen Vorlagendatensatz aus der Vorlagentabelle [sys_template] auf den aktuellen Datensatz an. Wenn die angegebene Vorlage nicht gefunden wird, wird keine Aktion ausgeführt.

    Hinweis:
    Mit dieser Methode wird automatisch ein instanziiert now_GR.insert() Methode, wenn eine Vorlage über verfügt Nächste Zugehörige Untergeordnete Vorlage Feld ausgefüllt. Informationen finden Sie unter Erstellen Sie Vorlagen für zugehörige Aufgabendatensätze .
    Tabelle : 32. Parameter
    Name Typ Beschreibung
    template Zeichenfolge Name einer Vorlage aus der Tabelle „Vorlagen“ [sys_template].
    Tabelle : 33. Rückgaben
    Typ Beschreibung
    void
    var rec1 = new GlideRecord("incident");
    rec1.initialize();
    rec1.applyTemplate("my_incident_template");
    rec1.insert();

    GlideRecord – autoSysFields(Boolean e)

    Aktiviert oder deaktiviert die Aktualisierung auf die Felder „sys_updated_by“, „sys_updated_on“, „sys_mod_count“, „sys_created_by“ und „sys_created_on“. Dies wird häufig zum manuellen Aktualisieren von Feldwerten in einem Datensatz verwendet, während historische Informationen unverändert bleiben.

    Warnung:
    Seien Sie vorsichtig, wenn Sie diese Methode verwenden. Wenn Sie diese Methode verwenden, wird das Feld „sys_mod_count“ nicht erhöht, und andere sys_-Felder werden nicht aktualisiert. Dies kann die Funktionalität beeinträchtigen, einschließlich Aktivitätsformatierer, Verlaufssätze, Benachrichtigungen und Metriken.
    Tabelle : 34. Parameter
    Name Typ Beschreibung
    e Boolean Bei „false“ werden Updates auf „sys_updated_by“, „sys_updated_on“, „sys_mod_count“, „sys_created_by“ und „sys_created_on“ deaktiviert.
    Tabelle : 35. Ergebnisse
    Typ Beschreibung
    void
    var inc = new GlideRecord('incident');
     
    // Change all Open(1) incidents to Active(2)
     
    inc.addQuery('state', 1);
    inc.query();
     
    while (inc.next()) {
      inc.autoSysFields(false);  // Do not update sys_updated_by, sys_updated_on, sys_mod_count, sys_created_by, and sys_created_on
      inc.setWorkflow(false);    // Do not run any other business rules
      inc.setValue('state', 2);
      inc.update();
    }

    GlideRecord – canCreate()

    Bestimmt, ob die Zugriffskontrollregeln (einschließlich der Benutzerrolle) das Einfügen neuer Datensätze in diese Tabelle ermöglichen.

    Tabelle : 36. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 37. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Rollen des Anwenders die Erstellung von Datensätzen in dieser Tabelle zulassen.
    Mögliche Werte:
    • Wahr: Erstellung zulässig
    • Falsch: Erstellen ist nicht zulässig

    Dieses Beispiel zeigt, ob Datensätze in der Tabelle „benefit_Plan“ erstellt werden können.

    canCreateBenefitPlan : function() {
      var now_GR = new GlideRecord('benefit_plan');
      return now_GR.canCreate();
    }

    Bereichsbezogenes Äquivalent

    Um die canCreate()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: canCreate().

    GlideRecord – canDelete()

    Bestimmt, ob die Zugriffskontrollregeln (einschließlich der Rolle des Benutzers) das Löschen von Datensätzen in dieser Tabelle zulassen.

    Tabelle : 38. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 39. Ergebnisse
    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
    var att = new GlideRecord('sys_attachment');
    att.get('$[sys_attachment.sys_id]');
    var sm = GlideSecurityManager.get();
    var checkMe = 'record/sys_attachment/delete';
    var canDelete = sm.hasRightsTo(checkMe, att);
    gs.log('canDelete: ' + canDelete);

    Bereichsbezogenes Äquivalent

    Um die canDelete()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: canDelete().

    GlideRecord – canRead()

    Gibt an, ob die Zugriffssteuerungsregeln (ACLs) dem aktuellen Anwender erlauben, den aktuellen Datensatz in der zugehörigen GlideRecord-Tabelle zu lesen. Diese Methode wertet alle verfügbaren ACLs für die spezifische Ressource aus.

    Hinweis:
    Sie sollten diese Methode nicht verwenden, um den Zugriff auf Tabellenebene zu überprüfen. Ein einzelner Aufruf dieser Methode reicht möglicherweise nicht aus, um ein schlüssiges Ergebnis der Überprüfung der Zugriffsrechte auf Tabellenebene zu erhalten. Um eine Zugriffsprüfung auf Tabellenebene durchzuführen, verwenden Sie GlideSicherheitsmanager.hasRightsTo() Methode.

    Weitere Informationen zu ACLs finden Sie unter Auswertungsreihenfolge Für Zugriffssteuerungen .

    Tabelle : 40. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 41. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Rollen des Anwenders das Lesen des aktuellen Datensatzes zulassen.
    Gültige Werte:
    • Wahr: Lesen zulässig
    • Falsch: Lesen ist nicht zulässig

    Dieses Beispiel zeigt, wie die Tabelle „Incident“ [Incident] iteriert und überprüft wird, ob der Anwender Leserechte für jeden Datensatz hat.

    var grTable = new GlideRecord('incident');
    grTable.query();
    while (grTable.next()) {
      if (grTable.canRead()) 
    		…
    }

    Bereichsbezogenes Äquivalent

    Um die canRead()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: canRead().

    GlideRecord – canWrite()

    Bestimmt, ob die Zugriffskontrollregeln (einschließlich der Rolle des Benutzers) Updates der Datensätze in dieser Tabelle zulassen.

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 43. Ergebnisse
    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

    Dieses Beispiel zeigt, ob Datensätze in die Tabelle „benefit_Plan“ geschrieben werden können.

    canWriteBenefitPlan : function() {
      var now_GR = new GlideRecord('benefit_plan');
      return now_GR.canWrite();
    }

    Bereichsbezogenes Äquivalent

    Um die canWrite()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: canWrite().

    GlideRecord – changes()

    Bestimmt, ob sich eines der Felder im Datensatz geändert hat.

    Tabelle : 44. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 45. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der angegebene Datensatz Änderungen aufweist.
    Mögliche Werte:
    • Wahr: Felder im angegebenen Datensatz haben sich geändert.
    • Falsch: Es wurden keine Felder geändert.

    Dieses Beispiel zeigt, wie überprüft wird, ob in einem Incident-Datensatz Änderungen vorhanden sind.

    var now_GR = new GlideRecord("incident");
    now_GR.query();
    now_GR.next();
    if (now_GR.changes()) {
      gs.print("The incident record reported changes right after being read");
    } else {
      gs.print("The incident record has not changed");
    }

    Bereichsbezogenes Äquivalent

    Um diese Funktionalität in einer bereichsbezogenen Anwendung implementieren, fügen Sie folgenden Code hinzu:

    var now_GR = new GlideRecord("incident");
       now_GR.get("965c9e5347c12200e0ef563dbb9a7156");
       now_GR.short_description = "test";
       var elements = now_GR.getElements();
       var hasChanged = false;
       for(var i=0; i < elements.length;i++){
         var element = elements[i];
         hasChanged = hasChanged || element.changes();
         gs.info(element.getName() + ":" + element.changes());
       }
       gs.info(hasChanged);

    GlideRecord – select Window(Number firstRow, Number lastRow, Boolean forceCount)

    Legt einen Zeilenbereich fest, der von nachfolgenden Abfragen zurückgegeben werden soll.

    Tabelle : 46. Parameter
    Name Typ Beschreibung
    firstRow Anzahl Null-basierter Index der Startzeile für den Bereich, einschließlich. (Ein Wert von 0 gibt die erste Zeile zurück.)
    letzte Reihe Anzahl 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 ausgeführt. Es gibt einige ausstehende 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.

    Standardwert: false

    Tabelle : 47. Ergebnisse
    Typ Beschreibung
    void

    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

    GlideRecord – deleteMultiple()

    Löscht alle Datensätze, die die Abfrage erfüllen.

    Diese Methode löscht keine Anhänge.

    Dot-Walking wird für diese Methode nicht unterstützt. Bei Verwendung der deleteMultiple()Funktion für referenzierte Tabellen werden alle Datensätze in der Tabelle gelöscht. Bei der Verwendung von deleteRecord() zum Kaskadieren des Löschvorgangs werden vorherige Aufrufe bei setWorkflow() für dasselbe GlideRecord-Objekt auch ignoriert.

    Verwenden Sie nicht deleteMultiple() für Tabellen mit Währungsfeldern. Löschen Sie jeden Datensatz einzeln. Verwenden Sie diese Methode zudem nicht mit den Methoden chooseWindow() oder setLimit(), wenn Sie mit großen Tabellen arbeiten. 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 davon 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.

    Hinweis:
    Bei der Verwendung von deleteMultiple() zum Kaskadieren des Löschvorgangs werden vorherige Aufrufe bei setWorkflow() für dasselbe GlideRecord-Objekt ignoriert.
    Tabelle : 48. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 49. Ergebnisse
    Typ Beschreibung
    Keine

    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();

    Bereichsbezogenes Äquivalent

    Um die deleteMultiple()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: deleteMultiple().

    GlideRecord – deleteRecord()

    Löscht einen einzelnen Datensatz.

    Tabelle : 50. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 51. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Datensatz erfolgreich gelöscht wurde.
    Mögliche Werte:
    • Wahr: Datensatz wurde gelöscht.
    • Falsch: Es wurde kein Datensatz zum Löschen gefunden.

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

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

    Ausgabe:

    Inactive incident INC0010010 deleted
    Inactive incident INC0010011 deleted

    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

    Bereichsbezogenes Äquivalent

    Um die deleteRecord()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: deleteRecord().

    GlideRecord – disableSysIdInOptimization()

    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.

    Tabelle : 52. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 53. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt die Verwendung von DisableSysIdInOptimierung() Methode zum Deaktivieren der Optimierung des sys_ID-Grenzwerts, wenn eine Incident-sys_ID-Liste übergeben wird, 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

    GlideRecord – find(String columnName, String value)

    Gibt „true“ zurück, wenn für einen Datensatz in der angegebenen Spalte ein übereinstimmender Wert vorhanden ist. Wenn er gefunden wird, wird auch zum ersten übereinstimmenden Datensatz gegangen, wobei im Wesentlichen next() bis zur Rückgabe des Datensatzes ausgeführt wird.

    Hinweis:
    Diese Methode erstellt einen Datensatz, anstatt den vorhandenen Datensatz zu aktualisieren, wenn Sie anwenden Aktualisieren () Methode nach dem Ändern des GlideRecord. Um zu vermeiden, dass ein Datensatz erstellt wird, rufen Sie auf Next() Methode vor dem Aufruf Suchen () . Zum Beispiel:
    var existingMaterials = new GlideRecord('u_m2m_material_num_service_instance');
    existingMaterials.addQuery('u_service_instance', serviceInstance.sys_id);
    existingMaterials.query();
    existingMaterials.next(); // This line added to prevent new record creation
    
    existingMaterials.find('u_material_number', 'ca41b9fd37a84200fdc25ca543990ed8');
    
    existingMaterials.u_material_quantity = 5;
    existingMaterials.update("Modify request via catalog");
    Tabelle : 54. Parameter
    Name Typ Beschreibung
    columnName Zeichenfolge Feldname, der gesucht werden soll.
    Wert Zeichenfolge Wert, auf den im angegebenen Feld geprüft werden soll.
    Tabelle : 55. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Datensatz in der aktuellen Tabelle einen übereinstimmenden Wert im angegebenen Feld hat.
    Mögliche Werte:
    • Wahr: Übereinstimmendes Feld.
    • Falsch: Kein übereinstimmendes Feld.

    Dieses Beispiel zeigt, wie Sie einen Datensatz in der Incident-Tabelle mit „Kritisch“ im Feld „Kurzbeschreibung“ finden.

    var now_GR = new GlideRecord("incident");
    now_GR.query();
    var shortDescription = "Critical";
    if (now_GR.find("short_description", shortDescription)) {
      gs.print("An incident with the specified field value was found");
      var recordID = now_GR.getValue("sys_id");
      gs.print("Found in the following record: " + recordID);
    } else {
      gs.print("An incident with the specified field value was not found");
    }

    Ausgabe

    An incident with the specified field value was found
    Found in the following record: 552c48888c033300964f4932b03eb092

    GlideRecord – get(Object name, Object value)

    Gibt den angegebenen Datensatz im aktuellen GlideRecord-Objekt zurück.

    Diese Methode akzeptiert 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.

    Tabelle : 56. Parameter
    Name Typ Beschreibung
    Name Objekt Optional. Name der instanziierten GlideRecord-Spalte, nach der gesucht werden soll valueParameter. Wenn nur ein einziger Parameter übergeben wird, geht die Methode davon aus, dass dieser Parameter die sys_id ist.
    Wert Objekt Abzugleichender Wert. 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 : 57. Rückgaben
    Typ Beschreibung
    Boolean Gibt an, ob der angeforderte Datensatz gefunden wurde.
    Mögliche Werte:
    • Wahr: Datensatz wurde gefunden
    • Falsch: Datensatz wurde nicht gefunden

    Dieses Beispiel ruft einen Incident-Datensatz ab, indem die sys_ID übergeben wird

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

    In diesem Beispiel wird ein Incident-Datensatz abgerufen, indem die Spalte im zu suchenden Datensatz und der zu suchende Wert übergeben werden.

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

    Bereichsbezogenes Äquivalent

    Um die get()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: get().

    GlideRecord – getAttribute(String fieldName)

    Gibt die Wörterbuchattribute im angegebenen Feld zurück.

    Tabelle : 58. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname, für den die Wörterbuchattribute zurückgegeben werden sollen
    Tabelle : 59. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Wörterbuchattribute

    Dieses Beispiel zeigt, wie die Wörterbuchattribute für „Tree_Picker“ zurückgegeben werden.

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

    Bereichsbezogenes Äquivalent

    Um die getAttribute()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getAttribute().

    GlideRecord – getClassDisplayValue()

    Gibt die Bezeichnung der Tabelle zurück.

    Tabelle : 60. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 61. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Bezeichnung, die die Tabelle identifiziert.

    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.

    Bereichsbezogenes Äquivalent

    Um die getClassDisplayValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getClassDisplayValue().

    GlideRecord – getDisplayValue(Zeichenfolgenname)

    Ruft den Anzeigewert für den aktuellen Datensatz oder den Anzeigewert eines Attributs in einem dynamischen Attributspeicher ab.

    Display values Werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen bearbeitet.

    Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert liegt im UTC-Format vor, während der Anzeigewert auf der Zeitzone des Benutzers basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der Anzeigewert entsprechend dem Verschlüsselungskontext des Benutzers unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch das Anzeigefeld des referenzierten Datensatzes.

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Tabelle : 62. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Optional. Nur erforderlich, wenn der Anzeigewert für ein dynamisches Attribut angefordert wird.

    Pfad zu einem Attribut innerhalb eines dynamischen Schemas, das abgerufen werden soll.

    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Tabelle : 63. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anzeigewert für den aktuellen Datensatz oder das angegebene Element.

    In diesem Beispiel wird der Anzeigewert eines angegebenen Incident-Datensatzes in das Protokoll geschrieben.

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

    Ausgabe:

    INC0000050

    Dieses Beispiel zeigt, wie der Anzeigewert eines Attributs in einem dynamischen Attributspeicherelement abgerufen wird.

    var gr_AppTab = new GlideRecord('application_table'); 
    gr_AppTab.setValue('dyn_att_field->group->attr', 42); 
    gr_AppTab.setDisplayValue('dyn_att_field->group->attr2, true);
    gr_AppTab.update();
    gs.info('Attr value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->group->attr);
    gs.info('Attr2 value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->group->attr2);

    Ausgabe:

    Attr value: System error
    Attr2 value: true

    Bereichsbezogenes Äquivalent

    Um die getDisplayValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDisplayValue().

    GlideRecord – getDynamicAttribute(Zeichenfolge – vollständiger Pfad)

    Gibt das GlideElementDynamicAttribute-Objekt für den angegebenen dynamischen Attributspeicherpfad zurück.

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Tabelle : 64. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad, der zum Suchen des gewünschten dynamischen Attributs verwendet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Tabelle : 65. Rückgaben
    Typ Beschreibung
    Objekt GlideElementDynamicAttribute-Objekt, das das angegebene dynamische Attribut enthält.

    Wenn fullPathParameter ist ungültig, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gr_Inc.getDynamicAttribute('attr_store->car->color').setValue('Blue');
    gr_Inc.update();
    
    gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gs.info(gr_Inc.getDynamicAttribute('attr_store', 'car->color'));
    Ausgabe:
    *** Script: Blue

    GlideRecord – getDynamicAttribute(Zeichenfolge dynamicAttributeField, Zeichenfolge groupAttrPath)

    Gibt ein GlideElementDynamicAttribute-Objekt zurück, das das dynamische Attribut im angegebenen Tabellenfeld und Attributpfad enthält.

    Tabelle : 66. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    GroupAttrPath Zeichenfolge Attributpfad, der zum Suchen des zugehörigen dynamischen Schemaattributs verwendet werden soll.
    Format: „Group_Name->attr_Name“
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group] oder im Feld Gruppe der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    • attr_Name : Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Beispiel: „Auto->Farbe“

    Tabelle : 67. Ergebnisse
    Typ Beschreibung
    Objekt GlideElementDynamicAttribute-Objekt, das das angegebene dynamische Attribut enthält.

    Wenn einer der beiden ist dynamicAttributeFieldOder groupAttrPathParameter sind ungültig, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gr_Inc.getDynamicAttribute('attr_store->car->color').setValue('Blue');
    gr_Inc.update();
    
    gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gs.info(gr_Inc.getDynamicAttribute('attr_store', 'car->color'));
    Ausgabe:
    *** Script: Blue

    GlideRecord – getDynamicAttributeValue(Zeichenfolge – vollständiger Pfad)

    Gibt den Wert des dynamischen Attributs an einem angegebenen Pfad zurück.

    Tabelle : 68. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad, der zum Suchen des gewünschten dynamischen Attributs verwendet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Tabelle : 69. Rückgaben
    Typ Beschreibung
    Objekt Wert des dynamischen Attributs, das sich am angegebenen Pfad befindet.

    Wenn fullPathParameter enthält ungültige Daten, oder der angegebene Attributwert ist keiner der unterstützten Datentypen, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    // Update the value of the attribute 'attribute_store->car->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->car->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store->car->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store->car->time_of_purchase'));

    Ausgabe:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

    GlideRecord – getDynamicAttributeValue(Zeichenfolge dynamicAttributeField, Zeichenfolge groupAttrPath)

    Gibt den Wert des dynamischen Attributs zurück, das sich in einem angegebenen Feld in der aktuellen Tabelle und einem angegebenen Attributpfad befindet.

    Tabelle : 70. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    GroupAttrPath Zeichenfolge Attributpfad, der zum Suchen des zugehörigen dynamischen Schemaattributs verwendet werden soll.
    Format: „Group_Name->attr_Name“
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group] oder im Feld Gruppe der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    • attr_Name : Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Beispiel: „Auto->Farbe“

    Tabelle : 71. Ergebnisse
    Typ Beschreibung
    Objekt Wert des dynamischen Attributs, das sich am angegebenen Pfad befindet.

    Wenn einer der beiden ist dynamicAttributeFieldOder groupAttrPathParameter sind ungültig, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    // Update the value of the attribute 'attribute_store->car->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'car->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'car->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'car->time_of_purchase'));

    Ausgabe:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

    GlideRecord – getDynamicAttributeDisplayValue(Zeichenfolge vollständiger Pfad)

    Gibt den Anzeigewert des dynamischen Attributs zurück, das sich am angegebenen Pfad befindet.

    Tabelle : 72. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad, der zum Suchen des gewünschten dynamischen Attributs verwendet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Tabelle : 73. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anzeigewert des dynamischen Attributs, das sich am angegebenen Pfad befindet.

    Wenn fullPathParameter ist ungültig, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    // Update the value of the attribute 'attribute_store->car->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->car->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purcahse Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store->car->time_of_purchase'));
    gs.info("Time of Purcahse DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store->car->time_of_purchase'));

    Ausgabe:

    *** Script: Time of Purcahse Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purcahse DisplayValue (PST): 2020-05-13 06:52:44

    GlideRecord – getDynamicAttributeDisplayValue(Zeichenfolge dynamicAttributeField, Zeichenfolge groupAttrPath)

    Gibt den Anzeigewert des dynamischen Attributs zurück, das sich in einem angegebenen Tabellenfeld und Attributpfad befindet.

    Tabelle : 74. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    GroupAttrPath Zeichenfolge Attributpfad, der zum Suchen des zugehörigen dynamischen Schemaattributs verwendet werden soll.
    Format: „Group_Name->attr_Name“
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group] oder im Feld Gruppe der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    • attr_Name : Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Beispiel: „Auto->Farbe“

    Tabelle : 75. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzeigewert des dynamischen Attributs, das sich am angegebenen Pfad befindet.

    Wenn einer der beiden ist dynamicAttributeFieldOder groupAttrPathParameter sind ungültig, gibt null zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    // Update the value of the attribute 'attribute_store->car->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'car->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'car->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'car->time_of_purchase'));

    Ausgabe:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

    GlideRecord – getED()

    Gibt den Deskriptor des Elements zurück.

    Tabelle : 76. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 77. Ergebnisse
    Typ Beschreibung
    GlideElementDescriptor Der Deskriptor des Elements.

    Dieses Beispiel zeigt, wie das Namensfeld für einen Incident-GlideRecord abgerufen wird.

    grInc = new GlideRecord('incident');
    grInc.getActiveQuery();
    grInc.query();
    if (grInc.next())
      gs.info("Table Descriptor is - " + grInc.getED().getName());
    

    Ausgabe:

    Table Descriptor is - incident

    Bereichsbezogenes Äquivalent

    Um die getED()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getED().

    GlideRecord – getElement(String fieldName)

    Ruft das GlideElement für ein angegebenes Feld ab.

    Der von dieser Methode zurückgegebene Wert ist ein vollständiges GlideElement-Objekt. Die Ergebnisse entsprechen dem Feldwert „Dot-Walking“. 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:

    Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die 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().

    Tabelle : 78. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Spaltenname, für den das GlideElement-Objekt zurückgegeben werden soll.
    Tabelle : 79. Rückgaben
    Typ Beschreibung
    GlideElement Das GlideElement für die angegebene Spalte des aktuellen Datensatzes. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.

    Dieses Beispiel zeigt, wie das GlideElement-Objekt für eine übergebene Tabelle abgerufen und mit den erwarteten Systemmetadatenwerten verglichen wird.

    function compareElement(comment, table, element, /*{}*/ expected) {
      var now_GR = new GlideRecord(table);
      var el = now_GR.getElement(element);
      for (var n in expected) {
        assertEquals(comment + ":" + table + "." + element, expected[n], el.sys_meta[n]);
      }
    }

    Bereichsbezogenes Äquivalent

    Um die getElement()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getElement().

    GlideRecord – getEncodedQuery()

    Ruft die Abfragebedingung des aktuellen Ergebnissatzes als codierte Abfragezeichenfolge ab.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

    Tabelle : 80. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 81. Ergebnisse
    Typ Beschreibung
    Zeichenfolge

    Dieses Beispiel zeigt, wie Sie die aktuelle codierte Abfrage abrufen, die später zum Erstellen einer ACL-Lese-Rolle verwendet wird.

    function createAcl(table, role) {
      gs.print("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.sys_id.toString(), role);
       return;
      } else {
        now_GR.initialize();
        now_GR.applyEncodedQuery(encQuery);
        var acl = now_GR.insert();
        gs.print("   Added read access control on " + table);
        createAclRole(acl, role);
      }
    }

    Bereichsbezogenes Äquivalent

    Um die getEncodedQuery()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getEncodedQuery().

    GlideRecord – getEscapedDisplayValue()

    Ruft den Feldwert für das Anzeigefeld des aktuellen Datensatzes ab und fügt Escape-Zeichen für die Verwendung in Jelly-Skripts hinzu.

    Hinweis:
    Damit diese Methode funktioniert, muss in der zugehörigen Tabelle ein Anzeigewert festgelegt worden sein. Informationen dazu finden Sie unter Wählen Sie ein Feld als Tabellenanzeigewert aus .
    Tabelle : 82. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 83. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Escape-Wert des Anzeigefelds der aktuellen Tabelle.

    Dieses Beispiel zeigt, wie der Anzeigewert „user_Name“ mit Escape-Zeichen aus der Tabelle „Anwender“ [sys_user] abgerufen wird.

    var userName = "Michael J'ones";
    var now_GR = new GlideRecord("sys_user");
    if (now_GR.get("user_name", userName)) {
      gs.print("Deleting existing user=" + userName);
      now_GR.deleteRecord();
    }
    now_GR.initialize();
    
    var name = userName.split(" ", 2);
    var firstName = name[0];
    var lastName = name[1];
    now_GR.setValue("user_name", userName);
    gs.print("Name: " + now_GR.getValue("user_name"));
    now_GR.setValue("first_name", firstName);
    now_GR.setValue("last_name", lastName);
    var escapeValue = now_GR.getEscapedDisplayValue();
    gs.print("Escaped name: " + escapeValue);

    Ausgabe:

    Name: Michael J'ones
    Escaped name: Michael J\'ones

    GlideRecord – getFields()

    Ruft eine Java-ArrayList von Feldern im aktuellen Datensatz ab.

    Tabelle : 84. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 85. Ergebnisse
    Typ Beschreibung
    Java-ArrayList Felder im aktuellen Datensatz
    // This can be run in "Scripts - Background" for demonstration purposes
     
    // Get a single incident record
    var grINC = new GlideRecord('incident');
    grINC.query();
    grINC.next();
    gs.print('Using ' + grINC.getValue('number'));
    gs.print('');
     
    // getFields() returns a Java ArrayList
    var fields = grINC.getFields();
     
    // Enumerate GlideElements in the GlideRecord object that have values
    gs.print('Enumerating over all fields with values:');
    for (var i = 0; i < fields.size(); i++) {
      var glideElement = fields.get(i);
      if (glideElement.hasValue()) {
        gs.print('  ' + glideElement.getName() + '\t' + glideElement);
      }
    }
    gs.print('');
     
    // Get a specific GlideElement: number
    gs.print('Getting the number field:');
    for (var i = 0; i < fields.size(); i++) {
      var glideElement = fields.get(i);
      if (glideElement.hasValue() && glideElement.getName() == 'number') {
        gs.print('  ' + glideElement.getName() + '\t' + glideElement);
      }
    }

    GlideRecord – getLabel()

    Ruft die Bezeichnung des Felds ab.

    Tabelle : 86. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 87. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Bezeichnung des Felds

    Dieses Beispiel zeigt, wie Sie eine Bezeichnung eines Fragenfelds in der Tabelle „angefordertes Element“ abrufen und die Bezeichnung und ihren Anzeigenamen drucken.

    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() + " = " 
                         + vnow_V.getDisplayValue() + "\n");  
          }
        }
    }

    Bereichsbezogenes Äquivalent

    Um die getLabel()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getLabel().

    GlideRecord – getLocation()

    Ruft die Zeilennummer des aktuellen Datensatzes in der Tabelle ab.

    Tabelle : 90. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 91. Ergebnisse
    Typ Beschreibung
    Anzahl Null-basierte Zeilennummer des aktuellen Datensatzes in der Tabelle.

    Dieses Beispiel zeigt, wie überprüft wird, ob ein Datensatz in der Incident-Tabelle nicht ordnungsgemäß abgerufen wird, indem die Datensatzanzahl mit der Nummer des Datensatzstandorts verglichen wird.

    var now_GR = new GlideRecord("incident");
    now_GR.addQuery("priority", "4");
    now_GR.query();
    for (x=0; x <4; x++) {
      now_GR.next();
      gs.print("Location value: " + now_GR.getLocation());
    }

    Ausgabe:

    Location value: 0
    Location value: 1
    Location value: 2
    Location value: 3

    GlideRecord – getPlural()

    Ruft die Pluralbezeichnung der GlideRecord-Tabelle ab.

    Wenn der Tabellenname beispielsweise „Change Request“ lautet, gibt diese Methode „Change Requests“ zurück.

    Tabelle : 92. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 93. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Pluralbezeichnung der GlideRecord-Tabelle.

    Dieses Beispiel zeigt Prüfungen der Rückgabewerte für GetLabel() Und GetPlural() Für die Incident-Tabelle.

    var now_GR = new GlideRecord('incident');
    gs.print(now_GR.getLabel());
    if (now_GR.getLabel() != 'Incident')
    throw "GlideRecord.getLabel() returned unexpected value for table 'incident': " + now_GR.getLabel();
    
    gs.print(now_GR.getPlural());
    if (now_GR.getPlural() != 'Incidents')
    throw "GlideRecord.getPlural() returned unexpected value for table 'incident': " + now_GR.getPlural();
    "success";

    Bereichsbezogenes Äquivalent

    Zur Verwendung von GetPlural() Methode in einer bereichsbezogenen Anwendung verwenden Sie die bereichsbezogene GlideRecord.getED() Methode, um den Deskriptor des Felds abzurufen und dann den bereichsbezogenen zu verwenden GlideElementDescriptor.getPlural() Methode.

    GlideRecord – getRecordClassName()

    Ruft den Klassennamen (Tabellennamen) für den aktuellen Datensatz ab.

    Tabelle : 94. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 95. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Klassen- oder Tabellenname
    function TaskAssignmentFilter() {
      var classname = current.getRecordClassName();
      var filter = "type=null";
      if (classname == "incident" && current.category == "database") {
        filter = GetGroupFilter("database");
      }
      else {
        // append exclusion for 'catalog' to the filter
        var cat = new GlideRecord("sys_user_group_type");  
        cat.addQuery("name", "catalog");
        cat.query();
        if (cat.next()) {
          filter += "^ORtype!=" + cat.sys_id;
        }
      }
      gs.log("TaskAssignmentFilter: " + filter);
      return filter;
    }

    Bereichsbezogenes Äquivalent

    Um die getRecordClassName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getRecordClassName().

    GlideRecord – getRelatedLists()

    Ruft eine Liste von Namen und Anzeigewerten der zugehörigen Listen ab, die dem aktuellen GlideRecord zugeordnet sind.

    Tabelle : 96. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 97. Ergebnisse
    Typ Beschreibung
    HashMap Hash-Zuordnung mit Namen und Anzeigewerten zugehöriger Listen.

    Dieses Beispiel zeigt, wie Sie die Liste der Namen und die Anzeigewerte der zugehörigen Listen abrufen, die dem aktuellen GlideRecord zugeordnet sind, sie in einem Array speichern und dann ihre Werte drucken.

    var now_GR = new GlideRecord('incident');
    var c = now_GR.getRelatedLists().values().toArray();
    var numElements = c.length;
    for( var i = 0; i < numElements; ++i){
      gs.print(i+": "+c[i]);
    }

    GlideRecord – getRelatedTables()

    Ruft eine Liste mit Namen und Anzeigewerten von Tabellen ab, auf die der aktuelle Datensatz verweist.

    Tabelle : 98. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 99. Ergebnisse
    Typ Beschreibung
    HashMap Hashmap mit Namen und Anzeigewerten von zugehörigen Tabellen.

    Dieses Beispiel zeigt, wie Sie die Liste der Namen und Anzeigewerte von Tabellen im Zusammenhang mit dem aktuellen GlideRecord abrufen, in einem Array speichern und dann ihre Werte drucken.

    var now_GR = new GlideRecord('incident');
    var c = now_GR.getRelatedTables().values().toArray();
    var numElements = c.length;
    for( var i = 0; i < numElements; ++i){
      gs.print(i+": "+c[i]);
    }

    GlideRecord – getRowCount()

    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 GlideAggregate
    Die GlideRecord getRowCount() Und GlideAggregate getAggregate() 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 benötigen, bevor oder nachdem Sie den Satz iteriert haben, um Aktionen für die Datensätze auszuführen, verwenden Sie diese Methode.
    • Die GlideAggregate getAggregate() 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.
    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());
    Nur die Anzahl der Datensätze mit GlideAggregate getAggregate() wird 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 aggregierte Abfrage 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 der GlideAggregate getAggregate() Methode ist die beste Option. Um die einzelnen Datensätze zu verwenden und die Anzahl der Ergebnisse abzurufen, verwenden Sie 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.
    Stellen Sie außerdem sicher, dass Sie den anrufen .Next() Methode vor dem Aufrufen von GetRowCount() Methode.
    Tabelle : 100. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 101. Ergebnisse
    Typ Beschreibung
    Anzahl Anzahl der Zeilen im aktuellen GlideRecord.

    Das folgende Beispiel zeigt, wie die Anzahl der Incidents aus der Tabelle „Incident“ [Incident] abgerufen wird.

    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 die Verwendung von DisableSysIdInOptimierung() Methode zum Deaktivieren der Optimierung des sys_ID-Grenzwerts, wenn eine Incident-sys_ID-Liste übergeben wird, 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

    Bereichsbezogenes Äquivalent

    Um die getRowCount()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getRowCount().

    GlideRecord – getRowNumber()

    Ruft die von festgelegte Zeilennummer ab SaveLocation() Oder SetLocation() .

    Um die aktuelle Zeilennummer abzurufen, verwenden Sie GetLocation() .

    Tabelle : 102. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 103. Ergebnisse
    Typ Beschreibung
    Anzahl Gespeicherte Zeilennummer.

    Dieses Beispiel zeigt, wie Sie einen Zeilenspeicherort in der Tabelle „Anwender“ speichern und diese Zeilennummer abrufen.

    var now_GR = new GlideRecord('sys_user');
    now_GR.addQuery();
    now_GR.query();
    now_GR.saveLocation(5);
    var savedRow = now_GR.getRowNumber();
    gs.print("Saved row: " + savedRow);

    Ausgabe:

    Saved row: 5

    GlideRecord – getTableName()

    Ruft den Tabellennamen ab, der diesem GlideRecord zugeordnet ist.

    Tabelle : 104. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 105. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Tabellenname

    Dieses Beispiel zeigt, wie der aktuelle Tabellenname in das Systemprotokoll geschrieben wird.

    gs.log('Table: ' + current.getTableName()); 
    gs.log('Parent: ' + current.parent.sys_id); 
    var item = new GlideRecord('sc_req_item'); 
    item.addQuery('sys_id', current.parent.sys_id); 
    item.query(); 
    if(item.next()){ 
      for(var variable in item.variable_pool) {
        gs.log(variable); 
        var answer = eval ("item.variable_pool." + variable + ".getDisplayValue()");
        gs.log(answer);
      }
    }

    Bereichsbezogenes Äquivalent

    Um die getTableName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getTableName().

    GlideRecord – getUniqueValue()

    Ruft den Primärschlüssel des Datensatzes ab, der normalerweise die sys_id ist, sofern nicht anders angegeben.

    Tabelle : 106. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 107. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eindeutiger Primärschlüssel als Zeichenfolge oder NULL, wenn der Schlüssel NULL ist.
    var now_GR = new GlideRecord('kb_knowledge');
    now_GR.query();
    now_GR.next();
    var uniqueid = now_GR.getUniqueValue();
    gs.info(uniqueid);

    GlideRecord – getValue(String fieldName)

    Ruft den Zeichenfolgenwert eines angegebenen Felds oder den Zeichenfolgenwert eines Attributs in einem dynamischen Attributspeicher ab.

    Hinweis:
    Wenn Feldverschlüsselung Enterprise Plugin 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 .

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Tabelle : 108. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Name des Felds, dessen Wert Sie abrufen möchten, oder der Pfad zu einem Attribut in einem dynamischen Attributspeicher, das abgerufen werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Tabelle : 109. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert des angegebenen Elements. Gibt null zurück, wenn das Feld leer ist oder das Feld nicht vorhanden ist.
    Hinweis:
    Boolesche Werte geben als zurück „0“ Und „1“ Zeichenfolgenwerte anstelle von „falsch“ und „wahr“.

    In diesem Beispiel wird verwendet GetValue() Methode zum Abrufen von Feldwerten in zwei GlideRecords, die verglichen werden.

    function() {
      var jobExists = true;
      var jobGr;
      while(jobExists){
        jobGr = new GlideRecord("sys_trigger");
        jobExists = jobGr.get("name", "BaselineAPI: Create Baseline Job");
      }
      var baselineGr =  new GlideRecord('pm_project_baseline');
      baselineGr.get('baseline_name','Test Project Baseline');
      baselineGr.query();
     
      Assert.assertEquals(true, baselineGr.next());
      var projectGr =  new GlideRecord('pm_project');
      projectGr.get(this._project);
      Assert.assertEquals(projectGr.getValue('cost'), baselineGr.getValue('cost'));
      Assert.assertEquals((projectGr.getValue('capex_cost')), baselineGr.getValue('capex_cost'));
      Assert.assertEquals((projectGr.getValue('opex_cost')), baselineGr.getValue('opex_cost'));
      Assert.assertEquals((projectGr.getValue('budget_cost')), baselineGr.getValue('budget_cost'));
      Assert.assertEquals((projectGr.getValue('value')), baselineGr.getValue('value'));
      Assert.assertEquals((projectGr.getValue('npv_value')), baselineGr.getValue('npv_value'));  Assert.assertEquals((projectGr.getValue('score')), baselineGr.getValue('score'));
    }

    Dieses Beispiel zeigt, wie der Wert eines dynamischen Attributs abgerufen wird.

    // Update the value of the attribute 'attribute_store->car->color' to 'Red' on incident `INC0009009`
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->car->color', 'Red');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info(gr2.getValue('attribute_store->car->color'));

    Ausgabe:

    *** Script: Red

    Bereichsbezogenes Äquivalent

    Um die getValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getValue().

    GlideRecord – hasAttachments()

    Bestimmt, ob der aktuelle GlideRecord Anhänge enthält.

    Tabelle : 110. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 111. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der aktuelle Datensatz Anhänge enthält, andernfalls „false“.

    Dieses Beispiel sucht nach Anhängen und erstellt einen Link, falls vorhanden.

    var attachment_link = '';
    var rec = new GlideRecord('sc_req_item');
    rec.addQuery('sys_id', current.request_item);
    rec.query();
    if(rec.next()){
      if(rec.hasAttachments()){
        attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
      }   
    }

    GlideRecord – hasNext()

    Bestimmt, ob weitere Datensätze im GlideRecord vorhanden sind.

    Tabelle : 112. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 113. Ergebnisse
    Typ Beschreibung
    Boolean „Wahr“, wenn der Abfragesatz weitere Datensätze enthält, andernfalls „falsch“.

    Dieses Beispiel zeigt, wie verschiedene Funktionen aufgerufen werden, je nachdem, ob im aktuellen GlideRecord zusätzliche Datensätze vorhanden sind.

    if (now_GR.hasNext()) {
      dothis(); // found it, do it
    } else {
      dothat(); // didn't find it
    };

    Bereichsbezogenes Äquivalent

    Um die hasNext()-Methode in einer bereichsbezogenen Anwendung zu verwende, verwenden Sie die entsprechende bereichsbezogene Methode: hasNext().

    GlideRecord – initialize()

    Erstellt einen leeren Datensatz im aktuellen GlideRecord, der für die Auffüllung vor dem Einfügen geeignet ist.

    Tabelle : 114. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 115. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel initialisiert einen neuen Datensatz in der Tabelle „to_do“, erstellt einen Datensatz und fügt ihn dann in die Tabelle ein.

    var now_GR = new GlideRecord('to_do');
    now_GR.initialize(); 
    now_GR.name = 'first to do item'; 
    now_GR.description = 'learn about GlideRecord'; 
    now_GR.insert();

    Bereichsbezogenes Äquivalent

    Zur Verwendung von Initialisieren () Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: Initialisieren () .

    GlideRecord – insert()

    Fügt einen neuen Datensatz mit den Feldwerten ein, die für den aktuellen Datensatz festgelegt wurden.

    Tabelle : 116. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 117. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die sys_id des eingefügten Datensatzes oder null, wenn der Datensatz nicht eingefügt wird.

    In diesem Beispiel wird ein neuer Datensatz in der Tabelle „Aufgabe“ erstellt, Werte für einige Datensatzfelder festgelegt und dann der Datensatz in die Tabelle eingefügt.

    var now_GR = new GlideRecord('to_do');
    now_GR.initialize(); 
    now_GR.name = 'first to do item'; 
    now_GR.description = 'learn about GlideRecord'; 
    now_GR.insert();

    Bereichsbezogenes Äquivalent

    Um die insert()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: insert().

    GlideRecord – insertWithReferences()

    Fügt einen neuen Datensatz ein und fügt auch alle zugehörigen Datensätze mit den angegebenen Informationen ein oder aktualisiert sie.

    Tabelle : 118. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 119. Ergebnisse
    Typ Beschreibung
    Zeichenfolge sys_ID des eingefügten Datensatzes oder null, wenn der Datensatz nicht eingefügt wurde.

    Wenn kein Referenzwert angegeben ist (wie unten), wird ein neuer Anwenderdatensatz mit dem angegebenen first_Name und Last_Name erstellt, und der Wert caller_ID wird auf diesen neu erstellten sys_user-Datensatz festgelegt. Das Ergebnis ist ein neuer sys_user-Datensatz mit dem angegebenen first_Name und Last_Name und ein neuer Incident-Datensatz mit der angegebenen short_description und caller_ID

    var inc = new GlideRecord('incident');
    inc.initialize();
    inc.short_description = 'New incident 1';
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.insertWithReferences();

    Wenn ein Wert für „caller_ID“ angegeben ist, wird diese Caller_ID mit den angegebenen „first_Name“ und „Last_Name“ aktualisiert. Das Ergebnis ist ein neu erstellter Incident Record mit Werten für short_description und caller_id.

    var inc = new GlideRecord('incident');
    inc.initialize();
    inc.short_description = 'New incident 1';
    inc.caller_id.setDisplayValue('David Loo');
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.insertWithReferences();

    GlideRecord – instanceOf(String className)

    Überprüft eine Tabelle auf den Typ/die Klasse der Tabelle.

    Tabelle : 120. Parameter
    Name Typ Beschreibung
    className Zeichenfolge Name eines Datensatztyps oder einer Datensatzklasse.
    Tabelle : 121. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn Tabelle eine Instanz der angegebenen Klasse ist.

    In diesem Beispiel wird überprüft, ob die übergebene Gruppe/der übergebene Anwender den Tabellen-/Klassentyp „sys_user“ aufweist.

    function(groupOrUser, label, grantedBy) {
      var labelCheck;
      var labelRecord;
      if (typeof label === "string") {
        labelRecord = new GlideRecord('label');
        labelRecord.addQuery('name', label);
        labelRecord.query();
        labelRecord.next();
      } else {
        labelRecord = label;
      }
      if (groupOrUser.instanceOf('sys_user')) {
        labelCheck = new GlideRecord('label_user_m2m');
        labelCheck.addQuery('user', groupOrUser.sys_id);
      } else {
        labelCheck = new GlideRecord('label_group_m2m');
        labelCheck.addQuery('group', groupOrUser.sys_id);
      }
      labelCheck.addQuery('label', labelRecord.sys_id);
      if (grantedBy !== "undefined") {
        labelCheck.addQuery('granted_by', grantedBy.sys_id);
      }
      labelCheck.query();
      return labelCheck.hasNext();
    }

    GlideRecord – isNewRecord()

    Bestimmt, ob der aktuelle Datensatz in die Datenbank eingefügt wurde.

    Diese Methode gibt nur dann „true“ zurück, wenn die newRecord()-Methode aufgerufen wurde. Diese Methode ist nützlich für die geskriptete ACL und in den Bedingungen für UI Actions, sollte jedoch nicht in Hintergrundskripts verwendet werden.

    Hinweis:
    Diese Methode gibt „true“ für jeden neuen Datensatz während einer Business Rule zurück, oder wenn die newRecord()-Methode zum Initialisieren eines Datensatzes mit Standardwerten und einer eindeutigen ID (sys_id) verwendet wird. In allen anderen Fällen wird „false“ zurückgegeben.
    Tabelle : 122. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 123. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der aktuelle Datensatz neu ist (wurde nicht in die Datenbank eingefügt).
    Mögliche Werte:
    • Wahr: Datensatz ist neu.
    • Falsch: Datensatz ist nicht neu.

    In diesem Beispiel wird überprüft, ob der neue Datensatz in die Tabelle „sys_user“ eingefügt wurde.

    var now_GR = new GlideRecord("sys_user");
    now_GR.newRecord();
    now_GR.setValue("user_name", "John Smith");
    gs.print("Is this a new record: " + now_GR.isNewRecord());
    
    var now_GR2 = new GlideRecord("sys_user");
    now_GR2.addQuery("user_name", "Abel Tutor");
    now_GR2.query();
    now_GR2.next();
    gs.print("Is this a new record: " + now_GR2.isNewRecord());

    GlideRecord – isValid()

    Bestimmt, ob die aktuelle GlideRecord-Tabelle vorhanden ist.

    Tabelle : 124. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 125. Ergebnisse
    Typ Beschreibung
    Boolean „Wahr“, wenn die Tabelle vorhanden ist (gültig), andernfalls „falsch“.

    In diesem Beispiel wird überprüft, ob die Incident-Tabelle vorhanden ist.

    var testTable = new GlideRecord('incident');
    gs.print(testTable.isValid());

    Bereichsbezogenes Äquivalent

    Um die isValid()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: isValid().

    GlideRecord – isValidField(String columnName)

    Bestimmt, ob das angegebene Feld in der aktuellen GlideRecord-Tabelle definiert ist.

    Tabelle : 126. Parameter
    Name Typ Beschreibung
    columnName Zeichenfolge Name einer zu überprüfenden Spalte.
    Tabelle : 127. Rückgaben
    Typ Beschreibung
    Boolean „Wahr“, wenn das Feld in der Tabelle definiert ist, andernfalls „falsch“.

    In diesem Beispiel wird überprüft, ob das Feld sys_class_Name in der Tabelle „cmds_Software_instance“ vorhanden ist.

    var gobj = new GlideRecord('sys_db_object');
    gobj.addQuery('name','cmdb_software_instance');
    gobj.query();
    if (!gobj.next()) {
      var si = new GlideRecord('cmdb_software_instance');
      si.query();
      var count = 0;
      while (si.next()) {
        if (!si.isValidField('sys_class_name')) {
          var ci = new GlideRecord('cmdb_ci');
          ci.name = si.name;
          ci.setNewGuidValue(si.sys_id);
          ci.sys_class_name = 'cmdb_software_instance';
          ci.insert();
          count++;
        }
      }
    }

    Bereichsbezogenes Äquivalent

    Um die isValidField()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isValidField().

    GlideRecord – isValidRecord()

    Bestimmt, ob der aktuelle Datensatz gültig ist.

    Tabelle : 128. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 129. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der aktuelle Datensatz gültig ist.
    Gültige Werte:
    • Wahr: Datensatz ist gültig.
    • Falsch: Ende des Datensatzes überschritten.

    In diesem Beispiel wird überprüft, ob der Datensatzbezeichner von der übergebenen sys_ID ein gültiger Datensatz in der Ideentabelle ist.

    function(sysId) {
      this.log('Inside acceptIdea sysId = ' + sysId);
      var now_GR = new GlideRecord('idea');
      now_GR.get(sysId);
      this.log('now_GR.isValidRecord() = ' + now_GR.isValidRecord());
      if(now_GR.isValidRecord()) {
        now_GR.setValue('state', 2);
        this.log('Updating gliderecord');
        this.log('gliderecord table name' + now_GR.getTableName());
        now_GR.update();
      }
    }

    Bereichsbezogenes Äquivalent

    Um die isValidRecord()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isValidRecord().

    GlideRecord – newRecord()

    Erstellt einen GlideRecord, legt die Standardwerte für die Felder fest und weist dem Datensatz eine eindeutige ID zu.

    Tabelle : 130. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 131. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird überprüft, ob der neue Datensatz in die Tabelle „sys_user“ eingefügt wurde.

    var now_GR = new GlideRecord("sys_user");
    now_GR.newRecord();
    now_GR.setValue("user_name", "John Smith");
    gs.print("Is this a new record: " + now_GR.isNewRecord());
    
    var now_GR2 = new GlideRecord("sys_user");
    now_GR2.addQuery("user_name", "Abel Tutor");
    now_GR2.query();
    now_GR2.next();
    gs.print("Is this a new record: " + now_GR2.isNewRecord());

    Bereichsbezogenes Äquivalent

    Um die newRecord()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: newRecord().

    GlideRecord – next()

    Geht zum nächsten Datensatz im GlideRecord.

    Verwenden Sie diese Methode, um die Datensätze zu durchlaufen, die von einer GlideRecord-Abfrage zurückgegeben werden.

    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() .
    Hinweis:
    Das if(myObj.next())-Konstrukt verarbeitet nur den ersten zurückgegebenen Datensatz.
    Tabelle : 132. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 133. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der GlideRecord einen „nächsten“ Datensatz enthält.
    Gültige Werte:
    • Wahr: Der Wechsel zum nächsten Datensatz war erfolgreich.
    • Falsch: Keine weiteren Datensätze im Ergebnissatz.

    In diesem Beispiel wird gezeigt, wie mithilfe von durch die Incident-Tabelle iteriert wird Next() Methode.

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

    Bereichsbezogenes Äquivalent

    Um die next()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: next().

    GlideRecord – _next()

    Geht zum nächsten Datensatz im GlideRecord. Bietet die gleiche Funktionalität wie next(), für Fälle, in denen der GlideRecord die Spalte „next“ aufweist.

    Tabelle : 134. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 135. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Abfragesatz mehr Datensätze enthält.
    var rec = new GlideRecord('sys_template');
    rec.query();
    while (rec._next()) { 
      gs.print(rec.number + ' exists');
    }

    Bereichsbezogenes Äquivalent

    Um die _next()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: _next().

    GlideRecord – operation()

    Bestimmt, ob ein Vorgang „Einfügen“, „Aktualisieren“ oder „Löschen“ ist.

    Wenn Sie den Vorgang kennen, können Sie verwenden Current.Operation() Um eine generische Business-Regel zu erstellen, die jeden Vorgang eindeutig verarbeiten kann.

    Informationen zur Verwendung der globalen Variable Aktuell , Siehe Globale Variablen in Business-Regeln .

    Tabelle : 136. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 137. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Aktueller Vorgang.
    Mögliche Werte:
    • löschen
    • einfügen
    • Aktualisieren

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

    Dieses Beispiel zeigt die Verwendung von Vorgang () Methode zum Übergeben des Vorgangswerts an StartFlow() Methode.

    function createNewTransferOrder() {
      var toGr = new GlideRecord("alm_transfer_order");
      toGr.initialize();
      // From Stockroom - Southern California Warehouse
      toGr.setValue('from_stockroom', fromStockroomSysId);
      // To Stockroom - San Diego North - Pickup/Dropoff
      toGr.setValue('to_stockroom', toStockroomSysId);
      var transferOrder = toGr.insert();
    
      if(toGr.get(transferOrder)){
      // Start Transfer Order Workflow
      var wf = new Workflow();
      var context = wf.startFlow(toWorkflowSysId, toGr, toGr.operation(),{});
        createNewTransferOrderLine(transferOrder);
      } 
    }

    Bereichsbezogenes Äquivalent

    Um die operation()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: operation().

    GlideRecord – orderBy(String fieldName)

    Gibt einen Feldnamen oder Pfad zu einem Attribut in einem dynamischen Attributspeicher an, der zum Sortieren des Abfragesatzes verwendet werden soll. Um nach mehreren Feldern zu sortieren, rufen Sie diese Methode mehrmals mit verschiedenen Feldwerten auf.

    Tabelle : 138. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Tabellenfeldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher, für das der Abfragesatz angeordnet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Tabelle : 139. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie der Abfragesatz nach „Reihenfolge“ und dann nach „Zahl“ sortiert wird.

    function UpdateProjectWBS(project) {
      var count = 0;
      var child = new GlideRecord('pm_project_task');
      child.addQuery('parent', project.sys_id);
      child.orderBy('order');
      child.orderBy('number');
      child.query();
      var len = child.getRowCount().toString().length;
      var seq = 0;
      while (child.next()) {
        count += UpdateProjectTaskWBS(child, 1, ++seq, len, '');
      }
      gs.addInfoMessage(count + ' Project Tasks updated');
    }

    Dieses Beispiel zeigt, wie der Abfragesatz nach einem Attribut in einem dynamischen Attributspeicher angeordnet wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.orderBy('attribute_store->caller_id->first_name');
    gr_Inc.query();
    
    while(gr_Inc.next()) {
      gs.info("first_name: " + gr_Inc.getValue('attribute_store->caller_id->first_name'));
    }
    Ausgabe:
    *** Script: first_name: Alejandro
    *** Script: first_name: Bertie
    *** Script: first_name: Beth
    *** Script: first_name: Bow
    *** Script: first_name: Bud
    *** Script: first_name: Carol
    *** Script: first_name: Charlie
    *** Script: first_name: Christen
    *** Script: first_name: David

    Bereichsbezogenes Äquivalent

    Um die orderBy()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: orderBy().

    GlideRecord – orderByDesc(String fieldName)

    Gibt das Feld oder ein Attribut in einem dynamischen Attributspeicher an, das zum Sortieren des Abfragesatzes in absteigender Reihenfolge verwendet werden soll.

    Tabelle : 140. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Tabellenfeldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher, für das der Abfragesatz in absteigender Reihenfolge angeordnet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Tabelle : 141. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie der Abfragesatz in aufsteigender oder absteigender Reihenfolge sortiert wird.

    function(fiscalType, orderByDesc) {
      var now_GR = new GlideRecord('fiscal_period');
      now_GR.addQuery('fiscal_type', fiscalType);
      if (orderByDesc) {
        now_GR.orderByDesc('fiscal_start_date_time');
      } else {
        now_GR.orderBy('fiscal_start_date_time');
      }
      now_GR.setLimit(1);
      now_GR.query();
      now_GR.next();
      return now_GR.sys_id;
    }

    Dieses Beispiel zeigt, wie der Abfragesatz nach einem Attribut in einem dynamischen Attributspeicher angeordnet wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.orderByDesc('attribute_store->caller_id->first_name');
    gr_Inc.query();
    
    while(gr_Inc.next()) {
      gs.info("first_name: " + gr_Inc.getValue('attribute_store->caller_id->first_name'));
    }
    Ausgabe:
    
    *** Script: first_name: David
    *** Script: first_name: Christen
    *** Script: first_name: Charlie
    *** Script: first_name: Carol
    *** Script: first_name: Bud
    *** Script: first_name: Bow
    *** Script: first_name: Beth
    *** Script: first_name: Bertie
    *** Script: first_name: Alejandro

    Bereichsbezogenes Äquivalent

    Um die orderByDesc()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: orderByDesc().

    GlideRecord – Abfrage (Zeichenfolgenfeld, Zeichenfolgenwert)

    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 etwaige Verweise auf die Tabelle ab. Weitere Informationen finden Sie unter Tabellen im Skript werden abgefragt .

    Hinweis:
    Diese Methode schlägt fehl, wenn in der Tabelle ein Feld namens „Abfrage“ vorhanden ist. Wenn dies der Fall ist, verwenden Sie die Methode _Query() . Verwenden Sie die Methode, um Abfragen in einer domänengetrennten Instanz auszuführen QueryNoDomain() .

    Siehe GlideRecord artikel mit Details zum Erstellen und Ausführen von Abfragen.

    Tabelle : 142. Parameter
    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 : 143. Rückgaben
    Typ Beschreibung
    void

    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

    Bereichsbezogenes Äquivalent

    Um die query()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: query().

    GlideRecord – _query(Zeichenfolgenfeld, Zeichenfolgenwert)

    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 eine Spalte mit dem Namen „query“ vorhanden ist, was zu Fehlern beim Ausführen der query()-Methode führen kann.

    Diese Methode fragt die GlideRecord-Tabelle sowie etwaige Verweise auf die Tabelle ab. Weitere Informationen finden Sie unter Tabellen im Skript werden abgefragt .

    Siehe GlideRecord artikel mit Details zum Erstellen und Ausführen von Abfragen.

    Tabelle : 144. Parameter
    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 : 145. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie die Tabelle „Wissensfeedback“ [kb_Feedback] abgefragt und KB-Artikel mit Kommentaren aufgelistet werden, 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?

    Bereichsbezogenes Äquivalent

    Um die _query()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: _query().

    GlideRecord – queryNoDomain(Zeichenfolgenfeld, Zeichenfolgenwert)

    Wird in domänengetrennten Instanzen verwendet. Ähnlich wie bei query() wird die Abfrage anhand der Tabelle basierend auf den durch addQuery() und addEncodedQuery() angegebenen Filtern ausgeführt, Domänen werden jedoch ignoriert.

    Diese Methode fragt die GlideRecord-Tabelle sowie etwaige Verweise auf die Tabelle ab. Weitere Informationen finden Sie unter Tabellen im Skript werden abgefragt .

    Tabelle : 146. Parameter
    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 : 147. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Incident-Tabelle für alle Domänen abgefragt wird.

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

    GlideRecord – restoreLocation()

    Legt den aktuellen Datensatz als den Datensatz fest, der mit savelocation() gespeichert wurde. Wenn SaveLocation() Wurde nicht aufgerufen, der aktuelle Datensatz ist auf den ersten Datensatz des GlideRecord festgelegt.

    Tabelle : 148. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 149. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie den aktuellen Datensatzspeicherort speichern, zum nächsten Datensatz wechseln und dann zum gespeicherten Speicherort zurückkehren.

    function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      now_GR.next();
      var firstID = now_GR.getValue("sys_id");
      now_GR.next();
      var restoreID = now_GR.getValue("sys_id");
      now_GR.saveLocation();
      now_GR.next();
      var lastID = now_GR.getValue("sys_id");
      now_GR.restoreLocation();
      now_GR.next();
      var thisID = now_GR.getValue("sys_id");
      var progress = "first id=" + firstID
        + "\n\t last id=" + lastID
        + "\n\t saved id=" + restoreID
        + "\n\t restored id=" + thisID;
      gs.print("Progress:\n\t" + progress);
    }

    GlideRecord – saveLocation()

    Speichert die aktuelle Zeilennummer, damit Sie mit zu diesem Standort zurückkehren können RestoreLocation() Methode.

    Tabelle : 150. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 151. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie den aktuellen Datensatzspeicherort speichern, zum nächsten Datensatz wechseln und dann zum gespeicherten Speicherort zurückkehren.

    function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      now_GR.next();
      var firstID = now_GR.getValue("sys_id");
      now_GR.next();
      var restoreID = now_GR.getValue("sys_id");
      now_GR.saveLocation();
      now_GR.next();
      var lastID = now_GR.getValue("sys_id");
      now_GR.restoreLocation();
      now_GR.next();
      var thisID = now_GR.getValue("sys_id");
      var progress = "first id=" + firstID
        + "\n\t last id=" + lastID
        + "\n\t saved id=" + restoreID
        + "\n\t restored id=" + thisID;
      gs.print("Progress:\n\t" + progress);
    }

    GlideRecord – setAbortAction(Boolean b)

    Legt ein Flag fest, um anzugeben, ob die nächste Datenbankaktion (Einfügen, Aktualisieren, Löschen) abgebrochen werden soll.

    Verwenden Sie in einem OnBefore Geschäftsregel, um zu verhindern, dass die Datenbankaktion ausgeführt wird. Die Business Rule läuft nach dem Aufruf von setAbortAction() weiter. Durch das Aufrufen von setAbortAction() werden die nachfolgenden Business Rules nicht an der Ausführung gehindert. Durch Aufrufen dieser Methode wird nur die Ausführung der Datenbankaktion verhindert.

    Tabelle : 152. Parameter
    Name Typ Beschreibung
    b Boolean „True“, um die nächste Aktion abzubrechen, oder „false“, um die nächste Aktion zuzulassen.
    Tabelle : 153. Ergebnisse
    Typ Beschreibung
    void
    if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
      var start = current.u_date1.getGlideObject().getNumericValue();
      var end = current.u_date2.getGlideObject().getNumericValue();
      if (start > end) {
        gs.addInfoMessage('start must be before end');
        current.u_date1.setError('start must be before end');
        current.setAbortAction(true);
      }
    }

    Bereichsbezogenes Äquivalent

    Um die setAbortAction()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setAbortAction().

    GlideRecord – setDisplayValue(String name, Object value)

    Legt ein angegebenes Feld oder ein Attribut in einem dynamischen Attributspeicher auf einen angegebenen Anzeigewert fest.

    Für ein Referenzfeld ist dies der Anzeigewert für die Tabelle. Für ein Datum/eine Uhrzeit ist dies die Uhrzeit in der aktuellen Zeitzone des Anrufers.

    Tabelle : 154. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds, dessen Wert Sie festlegen möchten, oder der Pfad zu einem Attribut in einem dynamischen Attributspeicher.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Wert Objekt Wert, der im angegebenen Attribut festgelegt werden soll.
    Hinweis:
    Für dynamische Attribute werden nur die folgenden Datentypen unterstützt:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 155. Ausgabe
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie ein Anzeigewert in einem Datensatz festgelegt und dann der Datensatz aktualisiert wird.

    var now_GR = new GlideRecord('incident');
    now_GR.get('46f09e75a9fe198100f4ffd8d366d17b');
    now_GR.setDisplayValue('opened_at','2011-02-13 4:30:00');
    now_GR.update();

    Das folgende Codebeispiel zeigt, wie ein Anzeigewert in einem dynamischen Attributspeicher festgelegt wird.

    var gr_AppTab = new GlideRecord('application_table'); 
    gr_AppTab.setValue('dyn_att_field->group->attr', 42); 
    gr_AppTab.setDisplayValue('dyn_att_field->group->attr2, true);
    gr_AppTab.update();
    gs.info('Attr value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->group->attr);
    gs.info('Attr2 value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->group->attr2);

    GlideRecord – setDynamicAttributeValue(Zeichenfolge – vollständiger Pfad, Objektwert)

    Legt den Wert des dynamischen Attributs fest, das sich an einem angegebenen Pfad befindet.

    Tabelle : 156. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad, der zum Suchen des gewünschten dynamischen Attributs verwendet werden soll.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Wert Objekt Wert, auf den das angegebene dynamische Attribut festgelegt werden soll.
    Der übergebene Wert muss einen der folgenden Datentypen aufweisen:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 157. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das dynamische Attribut erfolgreich aktualisiert wurde.
    Mögliche Werte:
    • Wahr: Dynamisches Attribut wurde erfolgreich aktualisiert.
    • Falsch: Fehler aufgetreten. Dynamisches Attribut wurde nicht aktualisiert. Überprüfen Sie, ob fullPathParameter enthält einen gültigen Pfad zum gewünschten Attribut.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.setValue('inc_dynamic_groups', '78db044fc4b44210f8770961513dd7fe'); //Sysid of cars dimensions group
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->color","black");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->make","Honda");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->model","CRV");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->luxury",false);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->cost",20000);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->avg_mpg",28.4);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cars->date_purchased", new GlideDateTime());
    gr_Inc.setValue("inc_dynamic_schema->cars->total_miles", 10000.12345);
    gr_Inc.insert();
    

    GlideRecord – setDynamicAttributeValue(Zeichenfolge dynamicAttributeField, Zeichenfolge groupAttrPath, Objektwert)

    Legt den Wert des dynamischen Attributs fest, das sich in einem angegebenen Feld des aktuellen GlideRecord und einem angegebenen Attributpfad befindet.

    Tabelle : 158. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    attributePath Zeichenfolge Attributpfad, der zum Suchen des zugehörigen dynamischen Schemaattributs verwendet werden soll.
    Format: „Group_Name->attr_Name“
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group] oder im Feld Gruppe der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    • attr_Name : Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Beispiel: „Auto->Farbe“

    Wert Objekt Wert, auf den das angegebene dynamische Attribut festgelegt werden soll.
    Der übergebene Wert muss einen der folgenden Datentypen aufweisen:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 159. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das dynamische Attribut erfolgreich aktualisiert wurde.
    Mögliche Werte:
    • Wahr: Dynamisches Attribut wurde erfolgreich aktualisiert.
    • Falsch: Fehler aufgetreten. Dynamisches Attribut wurde nicht aktualisiert. Überprüfen Sie, ob dynamicAttributeFieldUnd groupAttrPathParameter enthalten gültige Daten.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    // Update the value of the attribute 'attribute_store->car->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'car->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();
    
    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'car->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'car->time_of_purchase'));

    Ausgabe:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

    GlideRecord – setDynamicAttributeDisplayValue(Zeichenfolge vollständiger Pfad, Objektwert)

    Legt den Anzeigewert des dynamischen Attributs fest, das sich an einem angegebenen Pfad befindet.

    Tabelle : 160. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad, der zum Suchen des dynamischen Attributs verwendet werden soll, dessen Anzeigewert Sie aktualisieren möchten.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Wert Objekt Anzeigewert, auf den das angegebene dynamische Attribut festgelegt werden soll.
    Der übergebene Wert muss einen der folgenden Datentypen aufweisen:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 161. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Anzeigewert des dynamischen Attributs erfolgreich aktualisiert wurde.
    Mögliche Werte:
    • Wahr: Anzeigewert des dynamischen Attributs wurde erfolgreich aktualisiert.
    • Falsch: Fehler aufgetreten. Anzeigewert des dynamischen Attributs wurde nicht aktualisiert. Überprüfen Sie, ob fullPathParameter enthält einen gültigen Pfad zum gewünschten Attribut.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var grProdTab = new GlideRecord('products_table');
    grProdTab.query();
    grProdTab.next();
    var val = grProdTab.setDynamicAttributeDisplayValue('product_details->cars->date_purchased', '2023-03-31 08:54:26');

    GlideRecord – setDynamicAttributeDisplayValue(Zeichenfolge dynamicAttributeField, Zeichenfolge groupAttrPath, Objektwert)

    Legt den Anzeigewert des dynamischen Attributs fest, das sich in einem angegebenen Feld des aktuellen GlideRecord und einem angegebenen Attributpfad befindet.

    Tabelle : 162. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    GroupAttrPath Zeichenfolge Attributpfad, der zum Suchen des zugehörigen dynamischen Schemaattributs verwendet werden soll.
    Format: „Group_Name->attr_Name“
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group] oder im Feld Gruppe der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    • attr_Name : Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Beispiel: „Auto->Farbe“

    Wert Objekt Anzeigewert, auf den das angegebene dynamische Attribut festgelegt werden soll.
    Der übergebene Wert muss einen der folgenden Datentypen aufweisen:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 163. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Anzeigewert des dynamischen Attributs erfolgreich aktualisiert wurde.
    Mögliche Werte:
    • Wahr: Anzeigewert des dynamischen Attributs wurde erfolgreich aktualisiert.
    • Falsch: Fehler aufgetreten. Anzeigewert des dynamischen Attributs wurde nicht aktualisiert. Überprüfen Sie, ob dynamicAttributeFieldUnd groupAttrPathParameter enthalten gültige Daten.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var grProdTab = new GlideRecord('products_table');
    grProdTab.query();
    grProdTab.next();
    var val = grProdTab.setDynamicAttributeDisplayValue('product_details', 'cars->date_purchased', '2023-03-31 08:54:26');

    GlideRecord – setDynamicAttributeValues(Zeichenfolge dynamicAttributeField, GlideDynamicAttributeStore-Werte)

    Legt einen oder mehrere dynamische Attributwerte mit Werten fest, die im übergebenen GlideDynamicAttributeStore-Objekt angegeben sind.

    Diese Methode aktualisiert nur die als Argumente übergebenen Attribute und Werte. Attribute und Werte im GlideRecord, die nicht angegeben sind, sind von diesem Aufruf nicht betroffen. Ungültige Gruppen, Attribute oder Werte werden ignoriert. Überprüfen Sie die Protokollnachrichten auf mögliche Fehlerinformationen.

    Tabelle : 164. Parameter
    Name Typ Beschreibung
    DynamicAttributeField Zeichenfolge Name des Felds in der aktuellen Tabelle, das enthält Dynamisches Schema .
    Werte GlideDynamicAttributeStore GlideDynamicAttributeStore-Objekt, das die zu aktualisierenden dynamischen Attribute enthält.
    Die im Objekt ausgefüllten Werte müssen die folgenden Datentypen aufweisen:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 165. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var das = new GlideDynamicAttributeStore();
    das.setDynamicAttributeValue('group->attribute1', 'Apple');
    das.setDynamicAttributeValue('group->attribute2', 1234);
    
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();
    gr_Inc.next();
    gr_Inc.setDynamicAttributeValues(das);

    GlideRecord – setForceUpdate(Boolean force)

    Aktualisiert den Datensatz, auch wenn sich Felder nicht geändert haben.

    Tabelle : 166. Parameter
    Name Typ Beschreibung
    force Boolean „True“ für Update, auch wenn sich Felder nicht geändert haben, andernfalls „false“.
    Tabelle : 167. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie erzwingen, dass ein Datensatz in der Tabelle „itfm_Cost_model“ aktualisiert wird, auch ohne Änderungen.

    function() {
      gs.log("Update Script: Upgrade_cost_model_data.js started");
      var now_GR = new GlideRecord("itfm_cost_model");
      now_GR.initialize();
      now_GR.addNullQuery("source_table");
      now_GR.query();
      while (now_GR.next()) {
        now_GR.setForceUpdate(true);
        var sourceTable = getSourceTable(now_GR.getValue('clone_from'));
        if(sourceTable){
          now_GR.setValue("source_table", sourceTable);
          now_GR.setWorkflow(false);
          now_GR.update();
        }
      }
    }

    GlideRecord – setLimit(Number limit)

    Legt die maximale Anzahl von Datensätzen fest, die im GlideRecord aus einer Abfrage zurückgegeben werden sollen.

    Tabelle : 168. Parameter
    Name Typ Beschreibung
    limit Zahl Grenzwert für Datensätze, abgerufen werden sollen.
    Tabelle : 169. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird die Anzahl der in der Abfrage zurückgegebenen Datensätze auf maximal zehn festgelegt.

    var now_GR = new GlideRecord('incident');
    now_GR.orderByDesc('sys_created_on');
    now_GR.setLimit(10);
    now_GR.query();

    Bereichsbezogenes Äquivalent

    Um die setLimit()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setLimit().

    GlideRecord – setLocation(Number rowNumber)

    Legt die aktuelle Zeilenposition auf den angegebenen Wert fest.

    Tabelle : 170. Parameter
    Name Typ Beschreibung
    rowNumber Anzahl Zeilennummer, die als aktuelle Zeile festgelegt werden soll.
    Tabelle : 171. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Datensatzposition in der Incident-Tabelle festgelegt wird

    verifySetLocation : function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      var recordIDs = new Array();
      while(now_GR.next()) {
      recordIDs.push(now_GR.getValue("sys_id"));
      }
      for (var ix = recordIDs.length - 1; ix >= 0; ix--) {
        now_GR.setLocation(ix);
        Assert.assertEquals(recordIDs[ix], now_GR.getValue("sys_id"),
          "The entry retrieved for the index " + ix + " is not valid");
      }
    }

    GlideRecord – setNewGuid()

    Generiert eine neue GUID und legt sie als eindeutige ID (sys_ID) für den aktuellen Datensatz fest.

    Diese Funktion gilt nur für neue Datensätze. Sie können die GUID für einen vorhandenen Datensatz nicht ändern.

    Tabelle : 172. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 173. Ergebnisse
    Typ Beschreibung
    Zeichenfolge SYS_ID des aktuellen Datensatzes.

    In diesem Beispiel wird ein neuer Aufgabendatensatz erstellt und die ID in der Tabelle „Task_rel_Task“ gespeichert.

    var task = new GlideRecord ('task');
    var tsk_id = task.setNewGuid();
     
    task.description = "Request: " + current.request.number;
    task.description = task.description + "\n" + "Requested by: " + current.request.u_requested_by.name;
    task.description = task.description + "\n" + "Requested for: " + current.request.u_requested_for.name;
    task.description = task.description + "\n" + "Item: " + current.cat_item.name;
     
    var now_GR = new GlideRecord ('task_rel_task');
    //link the incident to the request
    now_GR.parent = current.request;
    now_GR.child = tsk_id;
    now_GR.insert();

    GlideRecord – setNewGuidValue (String guid)

    Generiert eine neue GUID und legt sie beim Einfügen eines neuen Datensatzes als eindeutige ID für den aktuellen Datensatz fest.

    Tabelle : 174. Parameter
    Name Typ Beschreibung
    guid Zeichenfolge Wert für die neue GUID.
    Tabelle : 175. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel generiert eine neue GUID und legt sie als eindeutige ID für den neu erstellten cmdb_Software_instance-Datensatz fest.

    var gobj = new GlideRecord('sys_db_object');
    gobj.addQuery('name','cmdb_software_instance');
    gobj.query();
    if (!gobj.next()) {
      var si = new GlideRecord('cmdb_software_instance');
      si.query();
      var count = 0;
      while (si.next()) {
      if (!si.isValidField('sys_class_name')) {
        var ci = new GlideRecord('cmdb_ci');
        ci.name = si.name;
        ci.setNewGuidValue(si.sys_id);
        ci.sys_class_name = 'cmdb_software_instance';
        ci.insert();
        count++;
      }
    }

    Bereichsbezogenes Äquivalent

    Um die setNewGuidValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setNewGuidValue().

    GlideRecord – setQueryReferences(Boolean queryReferences)

    Aktiviert oder deaktiviert die Verwendung des Anzeigenamens des Referenzfelds, wenn ein Referenzfeld abgefragt wird.

    Tabelle : 176. Parameter
    Name Typ Beschreibung
    queryReferences Boolean Kennzeichnung, die angibt, wann die Daten generiert werden sollen.
    Gültige Werte:
    • Wahr: Generieren Sie eine Zeichenfolge von Anzeigenamen.
    • Falsch: Generieren Sie eine Zeichenfolge von sys_IDs.
    Tabelle : 177. Rückgaben
    Typ Beschreibung
    void
    var grByName = new GlideRecord(this.TEST_TABLE);
    grByName.addQuery("caller_id", userDisplayName);
    grByName.setQueryReferences(true);
    grByName.query();
    if (grByName.hasNext()) {
      while(grByName.next()) {
        gs.print("Incident caller_id=" + grByName.caller_id);
      }
    } else {
      gs.print("NO RESULTS");
    }

    GlideRecord – setUseEngines(Boolean e)

    Deaktiviert oder aktiviert die Ausführung von Engines (Genehmigungsregeln/Zuweisungsregeln).

    Warnung:
    Das Deaktivieren der Ausführung von Engines 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.
    Tabelle : 178. Parameter
    Name Typ Beschreibung
    e Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines aktiviert oder deaktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines aktivieren
    • Falsch: Engines deaktivieren
    Tabelle : 179. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Engines und Business-Regeln vor dem Ausführen einer Abfrage deaktiviert werden.

    function auditOAuthInboundRequestsUsage(){
      var now_GR = new GlideRecord("oauth_credential");
      var oauthClient = now_GR.addJoinQuery("oauth_entity", "peer", "sys_id");
      now_GR.addQuery("type", "access_token");
      now_GR.addQuery("expires", ">", nowDateTime());
      now_GR.addNullQuery("oauth_requestor_profile");
      oauthClient.addCondition("active", "true");
      oauthClient.addCondition("type", "client");
      now_GR.setUseEngines(false);
      now_GR.setWorkflow(false);
      now_GR.query();
      return now_GR.hasNext();
    }

    GlideRecord – setValue(String name, Object value)

    Legt das angegebene Feld oder ein Attribut in einem dynamischen Attributspeicher auf einen angegebenen Wert fest.

    Normalerweise würde ein Skript beispielsweise eine direkte Zuweisung durchführen now_GR.category = Wert . Wenn der Elementname in einem Skript jedoch 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.

    Wenn der Wertparameter Null ist, wird der Datensatz nicht aktualisiert, und es wird kein Fehler ausgelöst.
    Hinweis:
    Diese Methode kann nicht für Journalfelder verwendet werden. Verwenden  GlideElement.setJournalEntry() Stattdessen.
    Hinweis:
    Wenn Feldverschlüsselung Enterprise Plugin 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 .
    Nicht für Authentifizierung mit Passwort2-Feldern
    Die SetValue() Die Methode übergibt Passwort2-Daten als Klartext, was zu einem Fehler bei der Erwartung verschlüsselter Daten führt. Darüber hinaus werden durch die Verwendung der Methode setValue() für Passwort2-Felder Daten verfügbar gemacht, die verschlüsselt werden müssen.

    Verwenden Sie für die Passwort2-Authentifizierung SetDisplayValue() Stattdessen Methode.

    Tabelle : 180. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds, dessen Wert Sie festlegen möchten, oder der Pfad zu einem Attribut in einem dynamischen Attributspeicher.
    Format des dynamischen Pfads: dyn_ATT_field->Group_Name->Attribute_Name
    • dyn_ATT_field : Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • Gruppenname : Name der Gruppe, der das Attribut zugeordnet ist.

      Tabelle: Im Feld Group_Name der Tabelle „dynamische Attributgruppe“ [Dynamic_Attribute_Group].

    • attr_Name : Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „dynamisches Attribut“ [Dynamic_Attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Wert Objekt Wert, der im angegebenen Feld festgelegt werden soll.
    Hinweis:
    Für ein dynamisches Attribut werden nur die folgenden Datentypen unterstützt:
    • Boolescher Wert (Wahr/Falsch)
    • Dezimal
    • Gleitkommazahl
    • GlideDate
    • GlideDateTime
    • Ganzzahl
    • Zeichenfolge
    Tabelle : 181. Rückgaben
    Typ Beschreibung
    Keine

    Dieses Beispiel zeigt, wie der Wert des Felds Status in der Tabelle planned_Task festgelegt wird.

    function() {
      var topTask = new GlideRecord('planned_task');
      topTask.setValue('state', -5);
      var childTask = new GlideRecord('planned_task');
      childTask.setValue('state', -5);
      var s = new PlannedTaskStateManagement(childTask, topTask);
      var state = s.manageStateChange(false);
      Assert.assertEquals("-5", state);
    }

    Dieses Beispiel zeigt, wie der Wert eines dynamischen Attributs festgelegt wird.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.setValue('inc_dynamic_groups', '78db044fc4b44210f8770961513dd7fe'); //Sysid of cars dimensions group
    gr_Inc.setValue("inc_dynamic_schema->cars->color", "black");
    gr_Inc.setValue("inc_dynamic_schema->cars->make", "Honda"); 
    gr_Inc.setValue("inc_dynamic_schema->cars->model", "CRV");
    gr_Inc.setValue("inc_dynamic_schema->cars->luxury", false); 
    gr_Inc.setValue("inc_dynamic_schema->cars->cost", 25000);
    gr_Inc.setValue("inc_dynamic_schema->cars->avg_mpg", 28.4);
    gr_Inc.setValue("inc_dynamic_schema->cars->date_purchased", new GlideDateTime());
    gr_Inc.setValue("inc_dynamic_schema->cars->total_miles", 10000.12345);
    gr_Inc.insert();

    Bereichsbezogenes Äquivalent

    Um die setValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setValue().

    GlideRecord – setWorkflow(Boolean e)

    Aktiviert oder deaktiviert die Ausführung von Business Rules, die normalerweise durch nachfolgende Aktionen ausgelöst werden. Wenn eDer Parameter ist auf „falsch“ festgelegt, ein Einfügen/Update wird nicht auditiert. Die Prüfung erfolgt nur, wenn der Parameter für einen GlideRecord-Vorgang auf „true“ festgelegt ist.

    Hinweis:
    Die setWorkflow()-Methode wird ignoriert, wenn Sie nachfolgend entweder die Methode deleteProblem() oder deleteMultiple() zum Kaskadieren des Löschvorgangs verwenden.
    Warnung:
    Das Deaktivieren der Ausführung von Business-Regeln 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.
    Tabelle : 182. Parameter
    Name Typ Beschreibung
    e Boolean Kennzeichnung, die angibt, ob die Ausführung von Business-Regeln aktiviert oder deaktiviert werden soll.
    Gültige Werte:
    • Wahr: Business-Regeln aktivieren
    • Falsch: Business-Regeln deaktivieren
    Tabelle : 183. Rückgaben
    Typ Beschreibung
    void
    doit('name1','name2'); 
     
    function doit(username1,username2) { 
     
      var usr1 = new GlideRecord('sys_user');
      var usr2 = new GlideRecord('sys_user');
      var num = 0;
     
      if (usr1.get('user_name',username1) && usr2.get('user_name',username2)) {
        var ref;
        var dict = new GlideRecord('sys_dictionary');
        dict.addQuery('reference','sys_user');
        dict.addQuery('internal_type','reference');
        dict.query();
        while (dict.next()) {
          num = 0;
          ref = new GlideRecord(dict.name.toString());
          ref.addQuery(dict.element,usr1.sys_id);
          ref.query();
          while (ref.next()) {
            ref.setValue(dict.element.toString(),usr2.sys_id); 
            ref.setWorkflow(false);
            ref.update();
            num++;
          }
          if (num > 0) {
            gs.print(dict.element + ' changed from ' + usr1.user_name + 
              ' to ' + usr2.user_name + ' in ' + num + ' ' + dict.name + ' records');
          }
        }
      }
    }

    Bereichsbezogenes Äquivalent

    Um die setWorkflow()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setWorkflow().

    GlideRecord – update(Object reason)

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

    Tabelle : 184. Parameter
    Name Typ Beschreibung
    reason Objekt Optional. Grund für die Aktualisierung. Der Grund wird im Audit-Datensatz angezeigt.
    Tabelle : 185. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die sys_ID des neuen oder aktualisierten Datensatzes. Gibt NULL zurück, wenn das Update fehlschlägt.

    Dieses Beispiel aktualisiert einen Datensatz in der Tabelle „Task_ci“.

    var now_GR = new GlideRecord('task_ci');
    now_GR.addQuery();
    now_GR.query();
    var count = now_GR.getRowCount();
    if (count > 0) {
       var allocation = parseInt(10000 / count) / 100;
       while (now_GR.next()) {
          now_GR.u_allocation = allocation;
          now_GR.update();
       }
    }

    Bereichsbezogenes Äquivalent

    Um die update()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: update().

    GlideRecord – updateMultiple()

    Aktualisiert jeden GlideRecord in einer angegebenen Abfrage mit einem angegebenen Satz von Änderungen.

    Informationen zum Hinzufügen von Journaleinträgen finden Sie unter SetJournalEntry() Methode.

    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.

    Hinweis:
    Um die erwarteten Ergebnisse sicherzustellen, verwenden Sie SetValue() 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 den Methoden chooseWindow() oder setLimit(), wenn Sie mit großen Tabellen arbeiten.

    Diese Methode legt neue Werte fest und löscht vorhandene Werte nicht. Um einen vorhandenen Wert zu löschen, verwenden Sie SetValue() Methode, und legen Sie das Feld auf „Null“ fest. Weitere Informationen finden Sie unter GlideRecord-Variable auf „Null“ festlegen.

    Tabelle : 186. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 187. Ergebnisse
    Typ Beschreibung
    Keine

    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();
    Dieses Beispiel zeigt, wie vorhandene Werte des Beschreibungsfelds für Incidents der Priorität 1 gelöscht werden.
    var test = new GlideRecord('incident');
    test.addEncodedQuery('priority=1');
    test.query();
     
    test.setValue('description','NULL');
    test.updateMultiple();

    Bereichsbezogenes Äquivalent

    Um die updateMultiple()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: updateMultiple().

    GlideRecord – updateWithReferences(Object reason)

    Aktualisiert einen Datensatz und führt auch Einfügungen oder Updates für zugehörige Datensätze mit den bereitgestellten Informationen durch.

    Tabelle : 188. Parameter
    Name Typ Beschreibung
    reason Objekt Grund für die Updates. Der Grund wird im Audit-Datensatz angezeigt.
    Tabelle : 189. Ergebnisse
    Typ Beschreibung
    Zeichenfolge sys_id für den Datensatz, der aktualisiert wird.

    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. Wenn Sie einen Incident verarbeiten, für den 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();
    }