GlideList2 (g_list)

GlideList2 – addFilter(String filter)

Fügt dem Listenabfragefilter einen einzelnen Begriff hinzu.

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

Tabelle : 2. Ausgabe
Typ	Beschreibung
void

g_list.addFilter("active=true");

GlideList2 – get(Object DOMelement)

Gibt das GlideList2-Objekt für die Liste zurück, die das angegebene Element enthält.

Tabelle : 3. Parameter
Name	Typ	Beschreibung
DOMelement	Objekt	DOM-Element-ID für die Liste, für die Sie das GlideList2-Objekt benötigen.

Tabelle : 4. Ergebnisse
Typ	Beschreibung
Objekt	Das GlideList2-Objekt oder NULL, falls nicht gefunden.

GlideList2 – get(String ListID)

Gibt das GlideList2-Objekt für die angegebene Liste zurück.

Tabelle : 5. Parameter
Name	Typ	Beschreibung
ListID	Zeichenfolge	ID für die Liste, für die Sie das GlideList2-Objekt benötigen.

Tabelle : 6. Ergebnisse
Typ	Beschreibung
Objekt	Das GlideList2-Objekt oder NULL, falls nicht gefunden.

function assignLabelActionViaLookupModal(tableName, listId) {
	var list = GlideList2.get(listId);
	if (!list)
		return;

	assignLabelViaLookup(tableName, sysIds, list.getView());
}

GlideList2 – getChecked()

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

Tabelle : 7. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 8. 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.

function removeLabelActionViaLookupModal(tableName, listId) {
  var list = GlideList2.get(listId);
  if (!list)
    return;

  var sysIds = list.getChecked();
  if (!sysIds)
    return;

  removeLabelViaLookup(tableName, sysIds);
}

GlideList2 – 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). Sie wird durch einschließlich angegeben sysparm_fixed_queryParameter für das Anwendungsmodul.

Tabelle : 9. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Feste Abfragezeichenfolge für die Liste.

var list = GlideList2.get(container.readAttribute('list_id'));
var filter = this._getFilter(element);
var fixedQuery = list.getFixedQuery();
if (fixedQuery)
  filter = fixedQuery + "^" + filter;

GlideList2 – getGroupBy()

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

Tabelle : 11. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Feld oder kommagetrennte Liste mit Feldern, die zum Gruppieren der Liste verwendet werden.

function runFilterV2Lists(name, filter) {
  var list = GlideList2.get(name);	
    if (list) {
      var groupBy = list.getGroupBy();
      if (groupBy)  
        filter += "^" + groupBy;
		
        list.setFilterAndRefresh(filter);
    }
}

GlideList2 – getListName()

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

Tabelle : 13. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Listenname (normalerweise der Tabellenname).

var list = GlideList2.get(name);	
var listName = list.getListName();

GlideList2 – getOrderBy()

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

Tabelle : 15. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 16. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das Feld, nach dem die Liste sortiert werden soll. Leer, wenn die Liste nicht sortiert ist.

var list = GlideList2.get(listId);
if (!list)
  return;
var orderBy = list.getOrderBy();

GlideList2 – getParentTable()

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

Tabelle : 17. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name der übergeordneten Tabelle.

for (var id in GlideLists2) {
  var list = GlideLists2[id];
  if (list.getTableName() == listTableName && list.getParentTable() == tableName)
    return list.getContainer();
}

GlideList2 – getQuery(Boolean orderBy, Boolean groupBy, Boolean fixed, Boolean all)

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

Tabelle : 19. Parameter
Name	Typ	Beschreibung
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
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
fixed	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
alle	Boolean	Standard. Kennzeichnung, die angibt, ob orderBy, groupBy und feste Abfrage in die Ergebnisse einbezogen werden sollen. Gültige Werte: Wahr: Schließen Sie orderBy, groupBy und feste Abfrage in die Ergebnisse ein. Falsch: Schließen Sie nicht alle drei Optionen in den Ergebnissen ein. Standardwert: wahr

Tabelle : 20. Ausgabe
Typ	Beschreibung
Zeichenfolge	Codierte Abfragezeichenfolge für die Liste.

var list = GlideList2.get(this.listID);
var ajax = new GlideAjax("AJAXJellyRunner", "AJAXJellyRunner.do");
  ajax.addParam("sysparm_query_encoded", list.getQuery({groupby: true, orderby: true}));
  ajax.addParam("sysparm_table", list.getTableName());
  ajax.addParam("sysparm_view", list.getView());

GlideList2 – getRelated()

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

Tabelle : 21. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Feld, das die Liste mit dem übergeordneten Formular verbindet.

var list = GlideList2.get(name);
var related = list.getRelated();
if (related) 
  ajax.addParam("sysparm_is_related_list", "true");

GlideList2 – getTableName()

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

Tabelle : 23. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Gibt den Tabellennamen für die Liste zurück.

GlideList2.getListsForTable = function(table) {
    var lists = [];
    for (var id in GlideLists2) {
        var list = GlideLists2[id];
        if (list.getTableName() == table)
            lists.push(list);
    }
    return lists;
}

GlideList2 – getView()

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

Tabelle : 25. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 26. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name der Ansicht.

function assignLabelActionViaLookupModal(tableName, listId) {
	var list = GlideList2.get(listId);
	if (!list)
		return;

	assignLabelViaLookup(tableName, sysIds, list.getView());
}

GlideList2 – getTitle()

Gibt den Listentitel zurück.

Tabelle : 27. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 28. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Listentitel.

var list = GlideList2.get(name);	
var listTitle = list.getTitle();

GlideList2 – isUserList()

Gibt true zurück, wenn die Liste vom Benutzer durch Auswahl des Listenmechanismus und Änderung des Listenlayouts personalisiert wurde.

Tabelle : 29. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 30. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn das Listenlayout geändert wurde.

var list = GlideList2.get(listId);
if (!list)
  return;
if (list.isUserList())
  var tableName = list.getTableName();

GlideList2 – refresh(Number firstRow, String additionalParms)

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

Tabelle : 31. Parameter
Name	Typ	Beschreibung
firstRow	Anzahl	Die erste Zeile, die in der Liste angezeigt werden soll. Standard: Erste Zeile der aktuellen Ansicht.
additionalParms	Zeichenfolge	Optionale Name-Wert-Paare, die Werden mit der Listenaktualisierungsanforderung übermittelt.

Tabelle : 32. Ausgabe
Typ	Beschreibung
void

$timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

GlideList2 – refreshWithOrderBy(Number firstRow, String description)

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

Tabelle : 33. Parameter
Name	Typ	Beschreibung
firstRow	Anzahl	Die erste Zeile, die in der Liste angezeigt werden soll. Standard: Erste Zeile der aktuellen Ansicht.
Beschreibung	Zeichenfolge	Optional Name-Wert-Paare, die mit der Listenaktualisierungsanforderung übermittelt werden.

Tabelle : 34. Ausgabe
Typ	Beschreibung
void

ga.getXML(function(serverResponse) {
  var response = serverResponse.responseXML.getElementsByTagName("response")[0];
  if (response) {
    var list = GlideList2.getByName("backlog_stories");
    list.refreshWithOrderBy();
    var status = response.getAttribute('status');
    $j('html, body').animate({scrollTop: $j("#"+data.record.sys_id).offset().top},500);
    if (status == 'failure') {
      alert('${gs.getMessage("Story cannot be created. Team is not associated with any project.")}');
    }
  }
}

GlideList2 – setFilter(String filter)

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

Tabelle : 35. Parameter
Name	Typ	Beschreibung
Filter	Zeichenfolge	Codierte Abfragezeichenfolge im Standard-Glide-Format. Siehe Codierte Abfragezeichenfolgen .

Tabelle : 36. Ausgabe
Typ	Beschreibung
void

list = GlideList2.get($(side+"ContentDivRelease").select(".list_div")[0].getAttribute("id"));
if (list) {
  list.setFilter("active=true");
  list.refresh(1);
 }

GlideList2 – setFilterAndRefresh(String filter)

Legt die codierte Abfragezeichenfolge für die Liste fest, einschließlich orderByUnd groupByWenn angegeben, wird die Liste dann mit dem neuen Filter aktualisiert.

Tabelle : 37. Parameter
Name	Typ	Beschreibung
filter	Zeichenfolge	Codierte Abfragezeichenfolge.

Tabelle : 38. Ergebnisse
Typ	Beschreibung
void

function updateListFilter(projectID) {
  var list = GlideList2.getByName("backlog_stories");
  var fixedQuery = $('hdn_additional_filters').value;
  if(!projectID) {
      list.setFilterAndRefresh(fixedQuery + "^ORDERBYteam_index");
      list.setOrderBy("team_index");
  }
}

GlideList2 – setFirstRow(Number rowNum)

Legt die erste Zeile fest, die in der Liste angezeigt wird, wenn die Liste aktualisiert wird.

Tabelle : 39. Parameter
Name	Typ	Beschreibung
rowNum	Zahl	Zeilennummer der ersten anzuzeigenden Zeile.

Tabelle : 40. Ergebnisse
Typ	Beschreibung
void

var nextRow = 0;
var rowsPerPage = 20;
var list = GlideList2.get(listId);
if (!list)
  return;
list.setFirstRow(nextRow);
nextRow = nextRow + rowsPerPage;

GlideList2 – setGroupBy(String groupBy)

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

Tabelle : 41. Parameter
Name	Typ	Beschreibung
groupBy	Zeichenfolge	Die groupByKriterien für die Liste.

Tabelle : 42. Ausgabe
Typ	Beschreibung
void

function runContextAction(listId) {
  var g_list = GlideList2.get(listId);
  g_list.setGroupBy('');
  g_list.refresh(1);
}

GlideList2 – setOrderBy(String 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.

Tabelle : 43. Parameter
Name	Typ	Beschreibung
orderBy	Zeichenfolge	Einzelne oder mehrere orderBy-Felder.

Tabelle : 44. Ausgabe
Typ	Beschreibung
void

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            updateOrderBy: function(orderBy){
  var list = GlideList2.get(this.listID);
  if (list)
    list.setOrderBy(orderBy);
};

GlideList2 – setRowsPerPage(Number rows)

Legt die Anzahl der anzuzeigenden Zeilen pro Seite fest.

Tabelle : 45. Parameter
Name	Typ	Beschreibung
rows	Anzahl	Die Anzahl der anzuzeigenden Zeilen.

Tabelle : 46. Rückgaben
Typ	Beschreibung
void

link: function(scope) {
  var list = GlideList2.get(scope.listId);
  list.setRowsPerPage(scope.maxRows);
  list.setFilterAndRefresh(scope.tableQuery);
}

GlideList2 – showHideGroups(Boolean showFlag)

Zeigt alle Gruppen in der Liste an oder blendet sie aus und speichert den aktuellen reduzierten/erweiterten Status der Gruppen als Benutzervoreinstellung.

Tabelle : 47. Parameter
Name	Typ	Beschreibung
showFlag	Boolean	Bei true werden die Gruppen in der Liste angezeigt.

Tabelle : 48. Ergebnisse
Typ	Beschreibung
void

function showHideAllGroups(showFlag) {
  var list = GlideList2.get(listId);
  if (!list)
    return;
  list.showHideGroups(showFlag);
}

GlideList2 – showHideList(Boolean showFlag)

Zeigt die Liste an oder blendet sie aus und speichert den aktuellen reduzierten/erweiterten Status der Liste als Benutzervoreinstellung.

Tabelle : 49. Parameter
Name	Typ	Beschreibung
showFlag	Boolean	Bei true wird die Liste angezeigt.

Tabelle : 50. Ergebnisse
Typ	Beschreibung
void

GlideList2.toggleAll = function(expandFlag) {
for (var id in GlideLists2) {
  var list = GlideLists2[id];
list.showHideList(expandFlag);
}

GlideList2 – sort(String field)

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

Tabelle : 51. Parameter
Name	Typ	Beschreibung
Feld	Zeichenfolge	Feld, das zum Sortieren der Liste verwendet werden soll.

Tabelle : 52. Ausgabe
Typ	Beschreibung
void

$timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

GlideList2 – sortDescending(String field, Number amount)

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

Tabelle : 53. Parameter
Name	Typ	Beschreibung
field	Zeichenfolge	Feld, das zum Sortieren der Liste verwendet werden soll.

Tabelle : 54. Ergebnisse
Typ	Beschreibung
void

$timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

GlideList2 – toggleList()

Schaltet die Anzeige der Liste um und speichert den aktuellen reduzierten/erweiterten Status der Liste als Benutzervoreinstellung.

Tabelle : 55. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 56. Ergebnisse
Typ	Beschreibung
void

var list = GlideList2.get(listId);
if (!list)
  return;
list.toggleList();

GlideList2 – toggleListNoPref()

Schaltet die Anzeige der Liste um, aber speichert den aktuellen reduzierten/erweiterten Status der Liste als Benutzervoreinstellung nicht.

Tabelle : 57. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 58. Ergebnisse
Typ	Beschreibung
void

var list = GlideList2.get(listId);
if (!list)
  return;
list.toggleListNoPref();

GlideList2 (g_list) – Client

Zürich-API-Referenz