GlideList ( Next Experience) – Client

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

    • Die GlideList Die API stellt Methoden zum Anpassen von Listen in bereit Next Experience UI Framework.

    Diese API ermöglicht das Hinzufügen der GlideList-Funktionalität zu einer Schaltfläche in Arbeitsbereich-Experience UI. Verwenden Sie G_list Variable zum Aufrufen der einzelnen Methoden.

    Um eine Schaltfläche hinzuzufügen, erstellen Sie eine Listenaktion, und fügen Sie hinzu GlideList Methode ruft in auf Client-Skript Feld Beim Klicken{} Methode. Anweisungen finden Sie unter Verwenden Sie die Client-GlideList-API in der Workspace Experience-UI .

    GlideList-Methodenaufrufe im Feld Client-Skript.
    Hinweis:
    Jede Methode muss mit verwendet werden Aktualisieren () Methode, mit Ausnahme von Sortieren () Und SortDescending() Methoden.
    Die Methoden in dieser API basieren auf GlideList2 . Folgendes GlideList2 -Methoden werden in nicht unterstützt Next Experience Framework und verursacht einen Fehler im Konsolenprotokoll:
    • IsUserList()
    • SetFirstRow()
    • ShowHideGroups()
    • ShowHideList()
    • ToggleList()
    • ToggleListNoPref()

    GlideList ( Next Experience) – AddFilter(Zeichenfolgenfilter )

    Fügt dem Listenabfragefilter einen einzelnen Begriff hinzu.

    Siehe auch SetFilter() .

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Filter Zeichenfolge Codierte Abfragezeichenfolge im Standard-Glide-Format. Siehe Codierte Abfragezeichenfolgen .
    Tabelle : 2. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine Liste aktiver Datensätze abrufen und die Seite aktualisieren.

    g_list.addFilter("active=true");
g_list.refresh();

    GlideList ( Next Experience) – GetChecked()

    Gibt eine kommagetrennte Liste der sys_IDs für die Elemente zurück, die in der zugehörigen Liste überprüft werden.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Kommagetrennte Liste mit sys_ids für die Elemente, die in der Liste geprüft werden. Überprüft nicht, ob die zurückgegebenen Elemente ausgeführt werden dürfen.

    Das folgende Beispiel zeigt, wie die sys_IDs jedes in einer Liste ausgewählten Datensatzes abgerufen werden.

    var myChecked = g_list.getChecked();
alert(myChecked);
g_list.refresh();

    Ausgabe in einem Warnungsfeld (leer, wenn keine Datensätze ausgewählt sind):

    079893e6b733330059128ac7ee11a967, 4fca6d45b7131010f03e9b7ade11a9d3, 5c460fbf1bd0011079e52131604bcbd9

    GlideList ( Next Experience) – GetFixedQuery()

    Gibt die feste Abfrage zurück.

    Eine feste Abfrage ist der Teil der Abfrage, der nicht aus dem Breadcrumb entfernt werden kann (d. h. für den Benutzer festgelegt).

    Wenden Sie diese Methode unter an Zugehörige Listenaktionen In Arbeitsbereich-Experience UI. Anweisungen finden Sie unter Verwenden Sie die Client-GlideList-API in der Workspace Experience-UI .

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feste Abfragezeichenfolge für die Liste.

    Das folgende Beispiel zeigt, wie eine feste Abfrage mit einer Debug-Nachricht im Protokoll der Browserkonsole angezeigt wird.

    console.log(g_list.getFixedQuery() + " debug message");

    Die Ausgabe, nachdem Sie in einem Incident-Datensatz auf die Schaltfläche auf der Registerkarte untergeordnete Incidents geklickt haben.

    parent_incident=46f1784ba9fe19810018aa27fbb23482 debug message

    GlideList ( Next Experience) – GetGroupBy()

    Gibt das Feld oder die kommagetrennte Liste mit Feldern zurück, die zum Gruppieren der Liste verwendet werden.

    Siehe auch:
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld oder kommagetrennte Liste mit Feldern, die zum Gruppieren der Liste verwendet werden.

    Das folgende Beispiel zeigt, wie FeldgroupBy-Werte der aktuellen Listenansicht abgerufen werden.

    var grpdBy = g_list.getGroupBy();
alert("The list is grouped by " + grpdBy);
g_list.refresh();

    Ausgabe in einem Warnungsfeld für eine nach Priorität gruppierte Liste:

    The list is grouped by ^GROUPBYpriority

    GlideList ( Next Experience) – GetListName()

    Gibt den Namen der Liste zurück, normalerweise den Tabellennamen.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Listenname (normalerweise der Tabellenname).

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.getListName();

    GlideList ( Next Experience) – GetOrderBy()

    Gibt das erste Feld zurück, das zum Sortieren der Liste verwendet wird.

    Siehe auch:
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Feld, nach dem die Liste sortiert werden soll. Leer, wenn die Liste nicht sortiert ist.

    Das folgende Beispiel zeigt, wie FeldorderBy-Werte der aktuellen Listenansicht abgerufen werden.

    var orderBy = g_list.getOrderBy();
	
alert("The list is ordered by " + orderBy);
g_list.refresh();

    Ausgabe in einem Warnungsfeld für eine nach Priorität geordnete Liste:

    The list is ordered by ^ORDERBYDESCpriority

    GlideList ( Next Experience) – GetParentTable()

    Gibt den Namen der übergeordneten Tabelle für eine verknüpfte Liste zurück (die dem Formular zugeordnete Tabelle).

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der übergeordneten Tabelle.

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.getParentTable();
g_list.refresh();

    GlideList ( Next Experience) – GetQuery(Object)

    Gibt die codierte Abfragezeichenfolge für die Liste zurück.

    Siehe auch:
    Tabelle : 15. Parameter
    Name Typ Beschreibung
    <object> Objekt Optional. Standardmäßig enthält diese Methode orderBy, groupBy und feste Abfrage in den Ergebnissen. Sie können Objekteigenschaften festlegen, um Ergebnisse auf eine oder mehrere der drei verfügbaren Optionen zu beschränken.
    <object>.OrderBy Boolean Optional. Kennzeichnung, die angibt, ob orderBy in den Ergebnissen berücksichtigt werden soll.
    Gültige Werte:
    • Wahr: OrderBy in Ergebnisse einschließen.
    • Falsch: OrderBy nicht in Ergebnisse einschließen.

    Standardwert: false
    <object>.GroupBy Boolean Optional. Kennzeichnung, die angibt, ob groupBy in den Ergebnissen berücksichtigt werden soll.
    Gültige Werte:
    • Wahr: GroupBy in Ergebnisse einschließen.
    • Falsch: GroupBy nicht in Ergebnisse einschließen.

    Standardwert: false
    <object>.Behoben Boolean Optional. Kennzeichnung, die angibt, ob feste Abfragen in die Ergebnisse aufgenommen werden sollen.
    Gültige Werte:
    • Wahr: Feste Abfrage in Ergebnisse einschließen.
    • Falsch: Keine feste Abfrage in Ergebnisse einschließen.

    Standardwert: false
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Codierte Abfragezeichenfolge für die Liste.

    Das folgende Beispiel zeigt, wie die Listencodierte Abfrage mit einer Debug-Nachricht im Protokoll der Browserkonsole angezeigt wird.

    var myQuery = g_list.getQuery();
console.log(myQuery + " message");

    Ausgabe:

    active=false^EQ message

    GlideList ( Next Experience) – GetRelated()

    Gibt das verknüpfte Listenfeld zurück, das die verknüpfte Liste dem übergeordneten Formular zuordnet.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Feld, das die Liste mit dem übergeordneten Formular verbindet.

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.getRelated();

    GlideList ( Next Experience) – GetTableName()

    Gibt den Tabellennamen für die Liste zurück.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Gibt den Tabellennamen für die Liste zurück.

    Das folgende Beispiel zeigt, wie der Listenname für die aktuelle Ansicht angezeigt wird.

    var listName = g_list.getListName();
alert("The current list name is " + listName);
g_list.refresh();

    Ausgabe in einem Warnungsfeld:

    The current list name is incident

    GlideList ( Next Experience) – GetTitle()

    Gibt den Listentitel zurück.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Listentitel.

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.getTitle();

    GlideList ( Next Experience) – GetView()

    Gibt die Ansicht zurück, mit der die Liste angezeigt wurde.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Ansicht.

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.getView();

    GlideList ( Next Experience) – REFRESH(Number firstRow)

    Aktualisiert die Liste. Die orderByEin Teil des Listenfilters wird ignoriert, sodass die Liste ihre natürliche Reihenfolge verwendet, wenn sie aktualisiert wird.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    firstRow Anzahl Die erste Zeile, die in der Liste angezeigt werden soll.

    Standard: Erste Zeile der aktuellen Ansicht.
    Tabelle : 26. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.addFilter("active=true");
g_list.refresh();

    GlideList ( Next Experience) – Refresh WithOrderBy(Number firstRow)

    Aktualisiert die Liste. Die orderByEin Teil des Listenfilters ist enthalten, wenn er für die Liste angegeben ist.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    firstRow Anzahl Die erste Zeile, die in der Liste angezeigt werden soll.

    Standard: Erste Zeile der aktuellen Ansicht.
    Tabelle : 28. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Methode aufgerufen wird.

    g_list.refreshWithOrderBy();

    GlideList ( Next Experience) – SetFilter(Zeichenfolgenfilter )

    Legt die codierte Abfragezeichenfolge für die Liste fest, wobei ignoriert wird orderByUnd groupByTeile der Abfragezeichenfolge.

    Siehe auch AddFilter() .

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Filter Zeichenfolge Codierte Abfragezeichenfolge im Standard-Glide-Format. Siehe Codierte Abfragezeichenfolgen .
    Tabelle : 30. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Listenergebnisse auf aktive Datensätze beschränkt werden.

    g_list.setFilter("active=true");
g_list.refresh();

    GlideList ( Next Experience) – SetGroupBy(Zeichenfolge groupBy)

    Legt die Liste fest groupByKriterien für ein einzelnes Feld.

    Siehe auch:
    Tabelle : 31. Parameter
    Name Typ Beschreibung
    groupBy Zeichenfolge Die groupByKriterien für die Liste.
    Tabelle : 32. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie aufgeführte Datensätze nach Anrufer-ID gruppiert werden.

    g_list.setGroupBy("caller_id");
g_list.refresh();

    GlideList ( Next Experience) – SetOrderBy(Zeichenfolge orderBy)

    Legt fest orderByKriterien für die Liste.

    Verwenden Sie für ein einzelnes Feld „Sortieren nach“ orderByFeld oder orderByDescFeld.Verwenden Sie für mehrere Felder OrderByField1^orderByField2^orderByField3 . orderByGibt eine aufsteigende Reihenfolge an, und reiderByDesc gibt eine absteigende Reihenfolge an. Diese Präfixzeichenfolgen sind optional. Wenn nicht angegeben, orderByIst die Standardreihenfolge.

    Siehe auch:
    Tabelle : 33. Parameter
    Name Typ Beschreibung
    orderBy Zeichenfolge Einzelne oder mehrere orderBy-Felder.
    Tabelle : 34. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Liste nach dem Wert des Felds Priorität sortiert wird.

    g_list.setOrderBy("priority");
g_list.refresh();

    GlideList ( Next Experience) – SetRowsPerPage(Zahlenzeilen )

    Legt die Anzahl der anzuzeigenden Zeilen pro Seite fest.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    rows Anzahl Die Anzahl der anzuzeigenden Zeilen.
    Tabelle : 36. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Ergebnisse auf 50 Zeilen pro Seite begrenzt werden.

    g_list.setRowsPerPage(50);
refresh();

    GlideList ( Next Experience) – Sortieren (Zeichenfolgenfeld )

    Sortiert die Liste in aufsteigender Reihenfolge und legt das Feld als fest orderBySpalte.

    Siehe auch:
    Hinweis:
    Diese Methode erfordert nicht Aktualisieren () Methode.
    Tabelle : 37. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Feld, das zum Sortieren der Liste verwendet werden soll.
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Ergebnisse nach sortiert werden Nummer Feld.

    g_list.sort("number");

    GlideList ( Next Experience) – SortDescending(Zeichenfolgenfeld , Zahlenbetrag )

    Sortiert ein einzelnes Feld in der Liste in absteigender Reihenfolge und legt das Feld als fest orderByDescFieldSpalte.

    Siehe auch:
    Hinweis:
    Diese Methode erfordert nicht Aktualisieren () Methode.
    Tabelle : 39. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Feld, das zum Sortieren der Liste verwendet werden soll.
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Ergebnisse nach dem Feld Nummer in absteigender Reihenfolge sortiert werden.

    g_list.sortDescending("number");