GlideList (Now Experience) – Client

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Die GlideList -API bietet Methoden zum Anpassen von Listen in Next Experience UI Framework.

    Diese API ermöglicht das Hinzufügen von GlideList-Funktionen zu einer Schaltfläche in der Anwenderoberfläche Arbeitsbereich-Experience. Verwenden Sie die Variable g_list, um die einzelnen Methoden aufzurufen.

    Um eine Schaltfläche hinzuzufügen, erstellen Sie eine Listenaktion, und fügen Sie im Feld Client-Skript für Methode onClick{}GlideList -Methodenaufrufe hinzu. Anweisungen hierzu finden Sie unter Client-GlideList-API in der Workspace Experience-UI verwenden.

    GlideList-Methodenaufrufe im Feld „Client-Skript“.
    Hinweis:
    Alle Methoden müssen mit der refresh()- Methode verwendet werden, mit Ausnahme der sort()- und sortDescending()- Methoden.
    Die Methoden in dieser API basieren auf GlideList2. Die folgenden GlideList2 -Methoden werden im Framework Next Experience nicht unterstützt und verursachen einen Fehler im Konsolenprotokoll:
    • istAnwenderliste ()
    • festlegenErsteRow ()
    • anzeigenHideGroups()
    • anzeigenHideList()
    • Umschaltliste ()
    • toggleListNoPref ()

    GlideList (Next Experience) - addFilter(String Filter)

    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 durch Kommas getrennte Liste der sys_ids für die Elemente zurück, die in der zugehörigen Liste aktiviert sind.

    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 Sie die sys_ids der einzelnen in einer Liste ausgewählten Datensätze abrufen.

    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 „Aktionen für zugehörige Liste“ in der UI Arbeitsbereich-Experience an. Anweisungen hierzu finden Sie unter Client-GlideList-API in der Workspace Experience-UI verwenden.

    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-Meldung im Protokoll der Browserkonsole angezeigt wird.

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

    Die Ausgabe nach dem Klicken auf die Schaltfläche auf der Registerkarte Untergeordnete Incidents in einem Incident-Datensatz.

    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 Sie Feldwerte für groupBy in der aktuellen Listenansicht abrufen.

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

    Ausgabe in einem Warnfeld 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 Sie die orderBy-Feldwerte der aktuellen Listenansicht abrufen.

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

    Ausgabe in einem Warnfeld 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 „fixed query“ in den Ergebnissen. Sie können Objekteigenschaften so festlegen, dass die Ergebnisse auf eine oder mehrere der drei verfügbaren Optionen beschränkt werden.
    <object>.sortierenNach Boolean Optional. Kennzeichnung, die angibt, ob orderBy in Ergebnisse aufgenommen werden soll.
    Gültige Werte:
    • „wahr“: orderBy in Ergebnisse einbeziehen.
    • „falsch“: orderBy nicht in Ergebnisse einbeziehen.

    Standardwert: false
    <object>.groupBy Boolean Optional. Kennzeichnung, die angibt, ob groupBy in Ergebnisse eingeschlossen werden soll.
    Gültige Werte:
    • „wahr“: Schließt „groupBy“ in Ergebnisse ein.
    • „falsch“: „groupBy“ nicht in Ergebnisse einbeziehen.

    Standardwert: false
    <object>.repariert Boolean Optional. Kennzeichnung, die angibt, ob die feste Abfrage in die Ergebnisse eingeschlossen werden soll.
    Gültige Werte:
    • wahr: Feste Abfrage in Ergebnisse einbeziehen.
    • „falsch“: Feste Abfrage nicht in Ergebnisse einbeziehen.

    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-Meldung 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 ein Warnfeld:

    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. Der Teil orderBy des Listenfilters wird ignoriert, sodass die Liste beim Aktualisieren ihre natürliche Reihenfolge verwendet.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    firstRow Nummer Die erste Zeile, die in der Liste angezeigt wird.

    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) - refreshWithOrderBy(Number firstRow)

    Aktualisiert die Liste. Der Teil orderBy des Listenfilters wird eingeschlossen, wenn er für die Liste angegeben ist.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    firstRow Nummer Die erste Zeile, die in der Liste angezeigt wird.

    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(String filter)

    Legt die codierte Abfragezeichenfolge für die Liste fest und ignoriert die Teile orderBy und groupBy in 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(String groupBy)

    Legt die Kriterien der Liste groupBy für ein einzelnes Feld fest.

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

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

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

    GlideList (Next Experience) - setOrderBy(String orderBy)

    Legt die Kriterien orderBy für die Liste fest.

    Verwenden Sie für ein einzelnes Feld vom Typ „Sortieren nach“ das Feld orderBy oder das Feld orderByDesc. Verwenden Sie für mehrere Felder orderByField1^orderByField2^orderByField3. orderBy gibt die aufsteigende Reihenfolge und orderByDesc die absteigende Reihenfolge an. Diese Präfixzeichenfolgen sind optional. Wenn nicht angegeben, ist orderBy die Standardreihenfolge.

    Siehe auch:
    Tabelle : 33. Parameter
    Name Typ Beschreibung
    orderBy Zeichenfolge Einzelnes 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(Number rows)

    Legt die Anzahl der anzuzeigenden Zeilen pro Seite fest.

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

    Das folgende Beispiel zeigt, wie Sie Ergebnisse auf 50 Zeilen pro Seite beschränken können.

    g_list.setRowsPerPage(50);
refresh();

    GlideList (Next Experience) – sort(Zeichenfolgenfeld)

    Sortiert die Liste in aufsteigender Reihenfolge und legt das Feld als orderBy -Spalte fest.

    Siehe auch:
    Hinweis:
    Diese Methode erfordert die Aktualisierung nicht.
    Tabelle : 37. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Feld zum Sortieren der Liste.
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    Keine

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

    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 Spalte orderByDescField fest.

    Siehe auch:
    Hinweis:
    Diese Methode erfordert die Aktualisierung nicht.
    Tabelle : 39. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Feld zum Sortieren der Liste.
    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");