GlideRecord – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 44 Minuten Lesedauer

    • Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.

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

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

    Für Informationen zu einer Klasse, die dieselben Funktionen wie ausführt GlideRecord Und erzwingt ACLs, siehe Mit GlideRecordSecure .

    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();
    Siehe auch:

    Scoped GlideRecord – addActiveQuery()

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

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

    Bereichsbezogener GlideRecord – addEncodedQuery(Zeichenfolgenabfrage, boolescher 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 : 3. 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 : 4. 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.getValue('number'));
}

    Scoped GlideRecord – addFunction(Object function)

    Wendet ein vordefiniertes GlideDBFunctionBuilder-Objekt auf einen Datensatz an.

    Verwenden Sie GlideDBFunctionBuilder Bereichsbezogene Klasse zum Definieren einer Funktion. Nachdem die Funktion definiert wurde, verwenden Sie die addFunction(Object function)-Methode, um die Funktion auf einen Datensatz anzuwenden.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    function Objekt GlideDBFunctionBuilder-Objekt, das einen SQL-Vorgang definiert.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    void 
    var functionBuilder = new GlideDBFunctionBuilder();
var myAddingFunction = functionBuilder.add();
myAddingFunction = functionBuilder.field('order');
myAddingFunction = functionBuilder.field('priority');
myAddingFunction = functionBuilder.build();

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

    Ausgabe:

    1
4
3
1
1
2
1

    Bereichsbezogener GlideRecord – addJoinQuery(Zeichenfolge-JoinTable, Zeichenfolge primaryField, Zeichenfolge-JoinTableField)

    Fügt einen Filter hinzu, um Datensätze basierend auf einer Beziehung in einer Tabelle zurückzugeben, die sich auf den aktuellen GlideRecord bezieht.

    Sie können diese Methode verwenden, um alle Anwender in der Datenbankgruppe über die Tabelle „Gruppenmitglied“ [sys_user_grmember] zu finden, oder um alle Probleme zu finden, denen ein Incident zugewiesen ist, über die Beziehung „incident.problem_id.

    Dies ist kein echter Datenbank-Join, sondern addJoinQuery() fügt eine Unterabfrage hinzu. Obwohl der Ergebnissatz basierend auf dem Join eingeschränkt ist, haben Sie nur auf die Felder in der Basistabelle Zugriff (die in der Tabelle enthalten sind, 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 : 7. Parameter
    Name Typ Beschreibung
    joinTable Zeichenfolge Name der Tabelle, die im Join verwendet werden soll, z. B. 'incident'.
    primaryField Zeichenfolge Optional. Name des Felds im GlideRecord, das zum Verknüpfen mit dem in angegebenen Feld verwendet werden soll joinTableFieldParameter.

    Standard: sys_ID
    joinTableField Zeichenfolge Optional. Name des Felds in der in angegebenen Tabelle joinTableZum Verbinden der Tabellen zu verwenden.

    Standard: Erstes Feld in der in angegebenen Tabelle joinTableDies ist ein Referenzfeld zur aktuellen GlideRecord-Tabelle.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    GlideQueryCondition Filter, der Datensätze auflistet, in denen 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 inaktive Probleme mit zugehörigen Incidents.

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

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

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

    Scoped GlideRecord – addNotNullQuery(String fieldName)

    Filter, der Datensätze angibt, bei denen der im Parameter übergebene Wert des Felds nicht NULL ist.

    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 : 9. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des zu überprüfenden Felds.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Filter, der Datensätze angibt, bei denen der im Parameter übergebene Wert des Felds nicht NULL ist. 
    var target = new GlideRecord('incident'); 
target.addNotNullQuery('short_description');
target.query();   // Issue the query to the database to get all records where short_description is not null
while (target.next()) {   
     // add code here to process the incident record
}

    Scoped GlideRecord – addNullQuery(String fieldName)

    Fügt einen Filter hinzu, um Datensätze zurückzugeben, bei denen der Wert des angegebenen Felds NULL ist.

    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 : 11. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des zu überprüfenden Felds.
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Dem GlideRecord hinzugefügte Abfragebedingung. 
    var target = new GlideRecord('incident'); 
target.addNullQuery('short_description');
target.query();   // Issue the query to the database to get all records where short_description is null
while (target.next()) {   
   // add code here to process the incident record
}

    Scoped GlideRecord – addQuery(String query)

    Fügt einen Filter hinzu, um Datensätze mithilfe einer codierten Abfragezeichenfolge zurückzugeben.

    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 : 13. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Ein Codierte Abfragezeichenfolge .
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    GlideQueryCondition Dem GlideRecord hinzugefügte Abfragebedingung. 
    var rec = new GlideRecord('incident');
rec.addQuery('active=true');
rec.query();
while (rec.next()) {
  rec.setValue('active', false);
  gs.info('Active incident ' + rec.getValue('number') + ' closed');
  rec.update();
}

    Scoped GlideRecord – addQuery(String name, Object value)

    Erstellen Sie eine Suchabfrage, und geben Sie die Zeilen zurück, die der Anforderung entsprechen.

    Wenn Sie mit SQL vertraut sind, ähnelt diese Methode der „where“ -Klausel. Ein oder mehrere addQuery()-Aufrufe können in einer einzelnen Abfrage erfolgen; in diesem Fall wird für die Abfragen AND verwendet. Wenn für eine der Abfrage-Anweisungen OR verwendet werden muss, verwenden Sie die GlideQueryCondition-Methode addOrCondition().

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

    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 : 15. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des abzufragenden Tabellenfelds oder einer der folgenden reservierten Namen:
    • 123TEXTQUERY321: Fügt der Abfrage einen Zeichenfolgensuchbegriff hinzu. Geben Sie die Zeichenfolge an, die Sie als Wert abgleichen möchten. Verwenden Sie diese Option, um Datensätze mit Feldwerten zurückzugeben, die die Suchzeichenfolge enthalten. Diese Option sucht nach allen Feldern in der Tabelle, die für die Indizierung und Suche konfiguriert werden müssen. Weitere Informationen zum Konfigurieren von Tabellen für die Indizierung und Suche finden Sie unter Konfigurieren Sie eine einzelne Tabelle für die Indizierung und Suche .
    • 123TEXTINDEXGROUP321: Fügt der Abfrage eine Textindexgruppe hinzu. Geben Sie den Namen der Textindexgruppe aus der Tabelle „Textindexgruppen“ [ts_index_Group] an, die Sie als Wert abfragen möchten. Verwenden Sie diese Option, um Suchergebnisse aus einer der Tabellen in einer Textindexgruppe zurückzugeben, wobei die Ergebnisrelevanzpunktzahlen anhand der Einstellungen dieser Textindexgruppe normalisiert werden. Weitere Informationen zum Konfigurieren von Textindexgruppen finden Sie unter Konfigurieren Sie mehrere Tabellen für die Indizierung und Suche .
    Hinweis:
    Weitere Informationen zur Verwendung der reservierten Namen finden Sie unter Tabellen im Skript werden abgefragt.
    Wert Objekt Wert, nach dem abgefragt werden soll (Groß- und Kleinschreibung wird nicht berücksichtigt).
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Abfragebedingung wurde dem GlideRecord hinzugefügt.

    Dieses Codebeispiel zeigt, wie die aktiven Datensätze in der Incident-Tabelle abgefragt und dann alle auf inaktiv gesetzt werden.

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

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

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

    Scoped GlideRecord – addQuery(String name, String 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. Ein oder mehrere addQuery()-Aufrufe können in einer einzelnen Abfrage erfolgen; in diesem Fall wird für die Abfragen AND verwendet. Wenn für eine der Abfrage-Anweisungen OR verwendet werden muss, verwenden Sie die GlideQueryCondition-Methode addOrCondition().

    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 : 17. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Tabellenfelds.
    operator Zeichenfolge 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.
    Wert Objekt Wert, nach dem abgefragt werden soll (Groß- und Kleinschreibung wird nicht berücksichtigt).
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Dem GlideRecord hinzugefügte Abfragebedingung. 
    var rec = new GlideRecord('incident');
rec.addQuery('active',true);
rec.addQuery('sys_created_on', ">", "2010-01-19 04:05:00");
rec.query();
while (rec.next()) {
  rec.setValue('active', false);
  gs.info('Active incident ' + rec.getValue('number') + ' closed');
  rec.update();
}

    Verwendung des IN-Operators.

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

    Bereichsbezogener 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 : 19. 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 : 20. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Dem GlideRecord hinzugefügte Abfragebedingung. 
    var rec = new GlideRecord('incident');
rec.addUserQuery("first_name", "=", "Fred");
rec.query();
while (rec.next()) {
  gs.info('Active user ' + rec.getValue('last_name'));
}

    Scoped GlideRecord – canCreate()

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

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Rollen des Anwenders die Erstellung von Datensätzen in dieser Tabelle zulassen.
    Gültige Werte:
    • Wahr: Erstellung zulässig
    • Falsch: Erstellen ist nicht zulässig

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

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

    Scoped GlideRecord – canDelete()

    Bestimmt, ob die Zugriffskontrollregeln (einschließlich der Benutzerrollen) das Löschen von Datensätzen in diese Tabelle ermöglichen.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. 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

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

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

    Scoped GlideRecord – canRead()

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

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Rollen des Anwenders das Lesen von Datensätzen in dieser Tabelle zulassen.
    Gültige Werte:
    • Wahr: Lesen zulässig
    • Falsch: Lesen ist nicht zulässig

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

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

    Scoped GlideRecord – canWrite ()

    Bestimmt, ob die Zugriffskontrollregeln, zu denen die Rollen des Benutzers gehören, die Bearbeitung von Datensätzen in dieser Tabelle zulassen.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. 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 Codebeispiel schreibt, ob der aktuelle Anwender Datensätze in der Incident-Tabelle im Systemprotokoll schreiben kann.

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

    Scoped GlideRecord – chooseWindow(Number firstRow, Number lastRow, Boolean forceCount)

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

    Tabelle : 29. 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 : 30. 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

    Scoped GlideRecord – deleteMultiple()

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

    Diese Methode löscht keine Anhänge.

    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.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. 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();

    Scoped GlideRecord – deleteRecord()

    Löscht den aktuellen Datensatz.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Datensatz erfolgreich gelöscht wurde.
    Gültige Werte:
    • Wahr: Datensatz wurde gelöscht.
    • Falsch: Es wurde kein Datensatz zum Löschen gefunden.

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

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

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

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

    Ausgabe:

    true

    Bereichsbezogener GlideRecord – disableSysIdInOptimization()

    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 : 35. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 36. 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

    Scoped 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 : 37. Parameter
    Name Typ Beschreibung
    Name Objekt Optional. Name der instanziierten GlideRecord-Spalte, nach der gesucht werden soll valueParameter. Wenn nur ein einzelner Parameter übergeben wird, geht die Methode davon aus, dass dieser Parameter die sys_ID oder den Anzeigewert ist.
    Wert Objekt 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 : 38. Rückgaben
    Typ Beschreibung
    Boolean Gibt an, ob der angeforderte Datensatz gefunden wurde:
    • true: Datensatz wurde gefunden
    • false: Datensatz wurde nicht gefunden

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

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

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

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

    Scoped GlideRecord – getAttribute(String fieldName)

    Gibt die Wörterbuchattribute für das angegebene Feld zurück.

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname, für den die Wörterbuchattribute zurückgegeben werden sollen
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Wörterbuchattribute 
    doit();
function doit() {
  var now_GR = new GlideRecord('sys_user');
  now_GR.query("user_name","admin");
  if (now_GR.next()) {
    gs.info("we got one");
    gs.info(now_GR.location.getAttribute("tree_picker"));
  }
}

    Scoped GlideRecord – getClassDisplayValue()

    Gibt die Bezeichnung der aktuellen Tabelle zurück.

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

    Scoped GlideRecord – getDisplayValue()

    Ruft den Anzeigewert für den aktuellen Datensatz ab.

    Anzeigewerte werden auf Grundlage des tatsächlichen Werts in der Datenbank und der Benutzer- oder Systemeinstellungen und Voreinstellungen geändert.

    Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch aussagekräftiger.
    • 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 ein Anzeigefeld des referenzierten Datensatzes.
    Tabelle : 43. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzeigewert für den aktuellen Datensatz.

    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

    Scoped GlideRecord – getED()

    Gibt den Deskriptor des Elements zurück.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. Ergebnisse
    Typ Beschreibung
    GlideElementDescriptor Der Deskriptor des Elements.

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

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

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

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

    Bereichsbezogener GlideRecord – getElement(String fieldName)

    Ruft das GlideElement-Objekt für das angegebene Feld ab.

    Der von dieser Methode zurückgegebene Wert ist ein vollständiges GlideElement-Objekt. Die Ergebnisse entsprechen dem 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:
    Tabelle : 47. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Spaltenname, für den das GlideElement-Objekt zurückgegeben werden soll.
    Tabelle : 48. Rückgaben
    Typ Beschreibung
    GlideElement Das GlideElement für die angegebene Spalte des aktuellen Datensatzes. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.

    Das folgende Beispiel zeigt, wie Sie einen neuen Incident-Datensatz mit Details in hinzufügen Kurzbeschreibung Feld.

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

    Ausgabe:

    My DB is not working

    Bereichsbezogener GlideRecord – getElements()

    Gibt ein Array von GlideElement-Objekten zurück. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.

    Wenn Dot-Walking durch ein GlideElement-Objekt erforderlich ist, verwenden Sie ToString() Methode zum Abrufen von Werten. Beispielsweise benötigen Sie möglicherweise die 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:
    Tabelle : 49. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    Array Array von GlideElement Objekte. Jedes Objekt beschreibt ein Feld im aktuellen GlideRecord.

    Das folgende Beispiel zeigt den Wert des Namensfelds für die fünf neuesten Datensätze an, die in der Tabelle „Frage“ [Frage] erstellt wurden.

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

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

    Ausgabe:

    delivery_time_var
delivery_time
sequence
priority
assigned_group

    Scoped GlideRecord – getEncodedQuery()

    Ruft die Abfragebedingung des aktuellen Ergebnissatzes als codierte Abfragezeichenfolge ab.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    Zeichenfolge 
    var now_GR = new GlideRecord('incident'); 
now_GR.addQuery('active', true);
now_GR.addQuery('priority', 1); 
now_GR.query(); 
var encodedQuery = now_GR.getEncodedQuery(); 
gs.info(encodedQuery);

    Ausgabe:

    active=true^priority=1

    Scoped GlideRecord – getLabel()

    Gibt die Feldbezeichnung zurück.

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

    Scoped GlideRecord – getLastErrorMessage()

    Ruft die letzte Fehlermeldung ab. Wenn keine letzte Fehlermeldung angezeigt wird, wird null zurückgegeben.

    Tabelle : 55. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 56. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die letzte Fehlermeldung als String. 
    // Setup a data policy where short_description field in incident is mandatory
var now_GR = new GlideRecord('incident');
now_GR.insert(); // insert without data in mandatory field
var errormessage = now_GR.getLastErrorMessage(); 
gs.info(errormessage);

    Ausgabe:

    Data Policy Exception: Short description is mandatory

    Scoped GlideRecord – getRecordClassName()

    Ruft den Klassennamen für den aktuellen Datensatz ab.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Klassenname. 
    var now_GR = new GlideRecord('incident'); 
var recordClassName = now_GR.getRecordClassName(); 
gs.info(recordClassName);

    Ausgabe:

    incident

    Scoped 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 : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. 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

    Scoped GlideRecord – getTableName()

    Ruft den Namen der Tabelle ab, die dem GlideRecord zugeordnet ist.

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Tabellenname 
    var now_GR = new GlideRecord('incident');
gs.info(now_GR.getTableName());

    Scoped GlideRecord – getUniqueValue()

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

    Tabelle : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. 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);

    Scoped GlideRecord – getValue(String name)

    Ruft den Zeichenfolgewert eines zugrunde liegenden Elements in einem Feld 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 .
    Tabelle : 67. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds, aus dem der Wert abgerufen werden soll.
    Tabelle : 68. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeichenfolgewert des zugrunde liegenden Elements. Gibt null zurück, wenn das Feld leer ist oder das Feld nicht vorhanden ist. Boolesche Werte geben als zurück „0“ Und „1“ Zeichenfolgenwerte anstelle von „falsch“ und „wahr“. 
    var now_GR = new GlideRecord('incident'); 
now_GR.orderBy('number');
now_GR.query('active','true'); 
now_GR.next(); 
gs.info(now_GR.getValue('number'));

    Ausgabe:

    INC0000002

    Scoped GlideRecord – GlideRecord(String tableName)

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

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

    Scoped GlideRecord – hasNext()

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

    Tabelle : 70. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 71. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Abfrageergebnissatz mehr Datensätze enthält. 
    var rec = new GlideRecord('incident'); 
rec.query(); 
if (rec.hasNext()) { 
  gs.info("Table is not empty"); 
}

    Scoped GlideRecord – insert()

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

    Tabelle : 72. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 73. Ergebnisse
    Typ Beschreibung
    Zeichenfolge SYS_ID des eingefügten Datensatzes oder null, wenn der Datensatz nicht eingefügt wird. 
    var now_GR = new GlideRecord('incident');
now_GR.initialize();
now_GR.setValue('name', 'New Incident');
now_GR.setValue('description', 'Incident description');
now_GR.insert();

    Ausgabe:

    138fb4111b4d4d907cf30d03cd4bcb57

    Scoped GlideRecord – initialize()

    Erstellt einen leeren Datensatz, der vor einem Einfügevorgang gefüllt werden kann.

    Tabelle : 74. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 75. Ergebnisse
    Typ Beschreibung
    void 
    var grIncident = new GlideRecord('incident');
grIncident.initialize();
grIncident.setValue('short_description', 'New Incident');
grIncident.setValue('description', 'Incident description');
grIncident.insert();

    Scoped GlideRecord – isActionAborted()

    Überprüft, ob die aktuelle Datenbankaktion abgebrochen werden soll.

    isActionAborted() wird initialisiert (auf false gesetzt) für neue Threads und durch next( )-Methode.

    Tabelle : 76. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 77. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die aktuelle Datenbankaktion abgebrochen werden soll.
    Gültige Werte:
    • Wahr: Die aktuelle Datenbankaktion muss abgebrochen werden.
    • Falsch: Die aktuelle Datenbankaktion darf nicht abgebrochen werden.
    		 
    var now_GR = new GlideRecord('incident');
 
gs.info(now_GR.isActionAborted());

    Ausgabe:

    false

    Bereichsbezogener GlideRecord – isEncodedQueryValid (Zeichenfolgenabfrage)

    Überprüft, ob die angegebene verschlüsselte Abfrage gültig ist.

    Wenn die angegebene codierte Abfrage gültig ist, wird die Abfrage so angewendet, als hätten Sie angerufen AddEncodedQuery() . Wenn die angegebene codierte Abfrage ungültig ist, dann sys_idNotValidnull Wird als codierte Abfrage hinzugefügt.

    Hinweis:
    Diese Methode wurde veraltet und durch ersetzt IsValidEncodedQuery() Methode, die die Abfrage nicht ausführt.
    Tabelle : 78. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Zu überprüfende verschlüsselte Abfrage. Siehe Codierte Abfragezeichenfolgen .
    Tabelle : 79. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene codierte Abfrage gültig ist.
    • Wahr: Die übergebene codierte Abfrage ist gültig.
    • Falsch: Die übergebene codierte Abfrage ist ungültig.

    Dieses Codebeispiel zeigt, wie eine codierte Abfrage validiert und dann Logik ausgeführt wird, wenn die Abfrage gültig ist.

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

    Scoped GlideRecord – isNewRecord()

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

    Tabelle : 80. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 81. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Datensatz neu ist und nicht in die Datenbank eingefügt wurde. 
    var now_GR = new GlideRecord("x_app_table"); 
now_GR.newRecord(); // create a new record and populate it with default values
gs.info(now_GR.isNewRecord());

    Scoped GlideRecord – isValid()

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

    Tabelle : 82. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 83. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Tabelle gültig ist oder ob der Datensatz erfolgreich abgerufen wurde.
    Mögliche Werte:
    • Wahr: Tabelle ist gültig, oder der Datensatz wurde erfolgreich abgerufen.
    • Falsch: Tabelle ist ungültig, oder der Datensatz wurde nicht erfolgreich abgerufen.
    		 
    var comment_GR = new GlideRecord('cf_comment');
var commentId = '99ebb4156fa831005be8883e6b3ee4b9';
comment_GR.get(commentId);
gs.info(comment_GR.isValid());

    Bereichsbezogener GlideRecord – isValidEncodedQuery(Zeichenfolgenabfrage)

    Überprüft, ob die Syntax der codierten Abfrage korrekt ist.

    Bei Übergabe einer leeren Zeichenfolge ( „“ ) Als Abfrage angeben:
    • Die leere Zeichenfolge ( „“ ) Stellt die Abwesenheit einer Abfrage dar und gibt „falsch“ zurück.
    • Wird Aufgerufen GlideRecord.addEncodedQuery(„“) Gefolgt von GlideRecord.query() Gibt alle Zeilen zurück. Die Abfragemethode ähnelt einer SQL SELECT-Anweisung. Bei Verwendung von „SELECT * FROM foo WHERE X“ in SQL stellt der Wert X die Abfrage dar. Wenn kein Abfragewert angegeben wird, werden alle Datensätze zurückgegeben (z. B. * AUS foo AUSWÄHLEN).
    Tabelle : 84. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Zu überprüfende verschlüsselte Abfrage. Siehe Codierte Abfragezeichenfolgen .
    Tabelle : 85. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene codierte Abfrage gültig ist.
    • Wahr: Die übergebene codierte Abfrage ist gültig.
    • Falsch: Die übergebene codierte Abfrage ist ungültig.

    Dieses Codebeispiel zeigt, wie überprüft wird, ob die codierte Abfrage gültig ist.

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

    Scoped GlideRecord – isValidField(String columnName)

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

    Tabelle : 86. Parameter
    Name Typ Beschreibung
    columnName Zeichenfolge Name des Felds.
    Tabelle : 87. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Feld für die aktuelle Tabelle definiert ist. 
    var now_GR = new GlideRecord('incident'); 
now_GR.initialize(); 
gs.info(now_GR.isValidField("short_description"));

    Scoped GlideRecord – isValidRecord()

    Bestimmt, ob ein Datensatz tatsächlich vom Vorgang „Abfrage/Datensatz abrufen“ zurückgegeben wurde.

    Tabelle : 88. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 89. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Datensatz tatsächlich vom Abfrage-/GET-Vorgang zurückgegeben wurde.
    Gültige Werte:
    • Wahr: Datensatz, der vom Abfrage-/GET-Vorgang zurückgegeben wird.
    • Falsch: Ende des Datensatzes, kein Datensatz zurückgegeben.
    		 
    var rec = new GlideRecord('incident');
rec.query();
while (rec.next()) { 
  gs.info(rec.number + ' exists');
}
gs.info(rec.isValidRecord());

    Bereichsbezogener GlideRecord – isView()

    Überprüft, ob der Datensatz in einer Ansicht oder Tabelle erstellt wurde.

    Tabelle : 90. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 91. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Datensatz in der Tabelle erstellt wurde, die eine Ansicht ist.
    • Wahr: Der Datensatz wurde in einer Ansicht erstellt.
    • Falsch: Der Datensatz wurde in einer Tabelle erstellt.

    Dieses Codebeispiel zeigt, wie bestimmt wird, ob ein GlideRecord in einer Ansicht oder Tabelle erstellt wurde.

    var mySLA = new GlideRecord('incident_sla');

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

    Ausgabe:

    This record was created in a view.

    Scoped GlideRecord – newRecord()

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

    Tabelle : 92. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 93. Ergebnisse
    Typ Beschreibung
    void 
    var now_GR = new GlideRecord("x_app_table"); 
now_GR.newRecord(); 
gs.info(now_GR.isNewRecord());

    Ausgabe:

    true

    Scoped GlideRecord – next()

    Geht zum nächsten Datensatz im GlideRecord-Objekt.

    Hinweis:
    Diese Methode schlägt fehl, wenn in der Tabelle ein Feld mit dem Namen „Next“ vorhanden ist. Wenn dies der Fall ist, verwenden Sie die Methode _Next() .
    Tabelle : 94. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 95. 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.
    		 
    var rec = new GlideRecord('incident');
rec.query();
while (rec.next()) {
 gs.info(rec.getValue('number') + ' exists');
}
    Ausgabe:
    INC0010112 exists
INC0010114 exists
INC0010119 exists
INC0010127 exists

    Scoped GlideRecord – _next()

    Geht zum nächsten Datensatz im GlideRecord. Bietet die gleiche Funktionalität wie Next() , Verwenden Sie diese Methode, wenn GlideRecord eine Spalte mit dem Namen Next hat.

    Tabelle : 96. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 97. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Abfragesatz weitere Datensätze enthält.
    Mögliche Werte:
    • Wahr: Weitere Datensätze im Abfragesatz.
    • Falsch: Keine weiteren Datensätze im Abfragesatz.

    Das folgende Beispiel zeigt, wie die einzelnen Datensätze in der Tabelle „Incidents“ [Incident] aufgelistet werden.

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

    Ausgabe:

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

    Scoped 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 : 98. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 99. 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; }

    Scoped GlideRecord – orderBy(String name)

    Gibt eine orderBy-Spalte an.

    Rufen Sie diese Methode mehr als einmal auf, um nach mehreren Spalten zu sortieren. Die Ergebnisse werden in aufsteigender Reihenfolge angeordnet. Informationen zum Anordnen von Datensätzen in absteigender Reihenfolge finden Sie unter Scoped GlideRecord – orderByDesc(String name).

    Tabelle : 100. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Spaltenname, der zum Sortieren der Datensätze in diesem GlideRecord-Objekt verwendet werden soll.
    Tabelle : 101. Rückgaben
    Typ Beschreibung
    void

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

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

    Ausgabe:

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

    Scoped GlideRecord – orderByDesc(String name)

    Gibt eine absteigende Reihenfolge nach Spalte an.

    Rufen Sie diese Methode mehr als einmal auf, um nach mehreren Spalten zu sortieren. Die Ergebnisse sind in absteigender Reihenfolge angeordnet. Informationen zum Anordnen von Datensätzen in aufsteigender Reihenfolge finden Sie unter Scoped GlideRecord – orderBy(String name).

    Tabelle : 102. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Spaltenname, der zum Sortieren der Datensätze in einem GlideRecord-Objekt verwendet werden soll.
    Tabelle : 103. Rückgaben
    Typ Beschreibung
    void

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

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

    Ausgabe:

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

    Bereichsbezogener GlideRecord – Abfrage (Zeichenfolgenfeld, Zeichenfolgenwert)

    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 _Query() Stattdessen Methode.

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

    Siehe auch:
    Tabelle : 104. 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 : 105. 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

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

    Siehe auch:
    Tabelle : 106. 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 : 107. 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?

    Scoped GlideRecord – setAbortAction(Boolean b)

    Legt ein Flag fest, um anzugeben, ob die nächste Datenbankaktion (Einfügen, Aktualisieren, Löschen) abgebrochen werden soll. Dies wird häufig in Business Rules verwendet.

    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 : 108. Parameter
    Name Typ Beschreibung
    b Boolean „True“, um die nächste Aktion abzubrechen. „False“, wenn die Aktion erlaubt werden soll.
    Tabelle : 109. Ergebnisse
    Typ Beschreibung
    void 
    // Often used in business rule to check whether the current operation should be aborted.
if (current.size > 16) {
  current.setAbortAction(true);
}

    Scoped GlideRecord – setLimit(Number maxNumRecords)

    Legt das Limit für die Anzahl der Datensätze fest, die von der GlideRecord-Abfrage abgerufen werden.

    Tabelle : 110. Parameter
    Name Typ Beschreibung
    maxNumRecords Zahl Maximale Anzahl der abzurufenden Datensätze.
    Tabelle : 111. Ergebnisse
    Typ Beschreibung
    void 
    var now_GR = new GlideRecord('incident');
now_GR.orderByDesc('sys_created_on');
now_GR.setLimit(10);
now_GR.query(); // this retrieves latest 10 incident records created

    Scoped GlideRecord – setNewGuidValue(String guid)

    Legt den sys_ID-Wert für den aktuellen Datensatz fest.

    Tabelle : 112. Parameter
    Name Typ Beschreibung
    guid Zeichenfolge GUID, die dem aktuellen Datensatz zugewiesen werden soll.
    Tabelle : 113. Rückgaben
    Typ Beschreibung
    void 
    var now_GR = new GlideRecord('incident');
now_GR.setValue('short_description', 'The third floor printer is broken');
now_GR.setNewGuidValue('eb4636ca6f6d31005be8883e6b3ee333');
now_GR.insert();
gs.info(now_GR.getValue('sys_id'));

    Scoped GlideRecord – setValue(String name, Object value)

    Legt den Wert des Felds mit dem angegebenen Namen auf den angegebenen Wert fest.

    Normalerweise führt das Skript einen aus now_GR.category = Wert . Wenn der Elementname jedoch selbst eine Variable ist, können Sie verwenden now_GR.setValue(elementName, Wert) . Stellen Sie beim Festlegen eines Werts sicher, dass der Datentyp des Felds mit dem Datentyp des eingegebenen Werts übereinstimmt.

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

    Siehe auch:
    Tabelle : 114. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds.
    Wert Objekt Wert, der dem Feld zugewiesen werden soll.
    Tabelle : 115. Rückgaben
    Typ Beschreibung
    Keine 
    var elementName = 'short_description'; 
var now_GR = new GlideRecord('incident'); 
now_GR.initialize(); 
now_GR.setValue(elementName, "My DB is not working");
now_GR.insert();

    Scoped GlideRecord – setWorkflow(Boolean enable)

    Aktiviert oder deaktiviert die Ausführung von Business Rules, Skriptengines und Audit.

    Warnung:
    Das Deaktivieren der Ausführung von Business-Regeln, Skript-Engines und Audit kann erhebliche Auswirkungen auf haben ServiceNow® Instanz und Funktionsweise. Stellen Sie sicher, dass Sie diesen Change gründlich testen, bevor Sie ihn in der Produktion bereitstellen.
    Hinweis:
    Diese Methode kann nicht für bereichsübergreifende Anwendungen festgelegt werden. Weitere Informationen finden Sie im folgenden KB-artikel https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0820691.
    Tabelle : 116. Parameter
    Name Typ Beschreibung
    enable Boolean Kennzeichnung, die angibt, ob die Ausführung von Business-Regeln, Skript-Engines und Audit aktiviert oder deaktiviert werden soll.
    Gültige Werte:
    • Wahr: Aktivieren Sie die Ausführung von Business-Regeln, Skript-Engines und Audit.
    • Falsch: Deaktivieren Sie die Ausführung von Business-Regeln, Skript-Engines und Audit.

    Standardwert: wahr
    Tabelle : 117. Rückgaben
    Typ Beschreibung
    void 
    //Enable business rules, scripts engines for x_app_table
var now_GR = new GlideRecord("x_app_table"); 
now_GR.setWorkflow(true);

    Scoped GlideRecord – update(String reason)

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

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

    Das folgende Beispiel zeigt, wie das Feld Kurzbeschreibung eines Incident aktualisiert wird.

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

    Ausgabe:

    Update the short description.

    Scoped GlideRecord – updateMultiple()

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

    Diese Methode unterstützt das Hinzufügen mehrerer Journaleinträge nicht.

    Die glide.db.forced.chunk.thresholdDie Systemeigenschaft legt den Schwellenwert fest, über dem das Löschen und Aktualisieren von Blockdatensätzen erzwungen wird. Durch das Blockieren wird verhindert, dass nicht primäre Schlüssel in großen Tabellen zu Replikationsproblemen führen. Weitere Informationen finden Sie unter Available system properties.

    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 : 120. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 121. 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();

    Bereichsbezogener GlideRecord – updateWithReferences (Objekturgrund)

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

    Tabelle : 122. Parameter
    Name Typ Beschreibung
    reason Objekt Grund für die Updates. Der Grund wird im Audit-Datensatz angezeigt.
    Tabelle : 123. 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();
}