GlideList2 (g_list) - Cliente

. GlideList2 A API fornece métodos para personalizar listas (v2).

A variável g_list é usado para acessar um objeto de lista especificado. . g_list A variável não está disponível para a ação de IU do link do formulário Listas relacionadas. Ele está disponível para a ação de IU do link do formulário de listas.

Esses métodos são usados em menus de contexto de IU e ações de IU.

Vários desses métodos estão disponíveis em Estrutura de IU do Next Experience. Para obter detalhes, consulte GlideList (Estrutura de IU do Next Experience).

GlideList2 - addFilter ( filtro de cadeia de caracteres)

Adiciona um único termo ao filtro de consulta de lista.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
filtros	Cadeia de caracteres	Cadeia de caracteres de consulta codificada no formato Glide padrão. Consulte Cadeias de caracteres de consulta codificadas .

Tabela 2. Retornos

Tipo	Descrição
vazio

g_list.addFilter("active=true");

GlideList2 - GET ( DOMement do objeto)

Retorna GlideList2 objeto da lista que contém o item especificado.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
DOMelhement	Objeto	O ID do elemento DOM da lista para a qual você deseja GlideList2 objeto.

Tabela 4. Retornos

Tipo	Descrição
Objeto	O objeto GlideList2 ou nulo se não for encontrado.

GlideList2 - GET( ListID de cadeia de caracteres)

Retorna GlideList2 objeto da lista especificada.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
ListID	Cadeia de caracteres	O ID da lista da qual você deseja GlideList2 objeto.

Tabela 6. Retornos

Tipo	Descrição
Objeto	. GlideList2 objeto ou nulo se não for encontrado.

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

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

GlideList2 - getCheck()

Retorna uma lista separada por vírgulas dos sys_ids dos itens que são verificados na lista associada.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 8. Retornos

Tipo	Descrição
Cadeia de caracteres	Lista separada por vírgulas dos sys_ids dos itens que são verificados na lista. Não verifica para determinar se os itens retornados podem ser executados.

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

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

  removeLabelViaLookup(tableName, sysIds);
}

GlideList2 - getFixedQuery()

Retorna a consulta fixa.

Uma consulta fixa é a parte da consulta que não pode ser removida da trilha (ou seja, é fixa para o usuário). É especificado pela inclusão de um sysparm_fixed_queryparâmetro do módulo da aplicação.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 10. Retornos

Tipo	Descrição
Cadeia de caracteres	A cadeia de caracteres de consulta fixa da lista.

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

GlideList2 - getGroupBy()

Retorna o campo ou a lista separada por vírgulas de campos que são usados para agrupar a lista.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 12. Retornos

Tipo	Descrição
Cadeia de caracteres	O campo ou a lista separada por vírgulas de campos usados para agrupar a lista.

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

GlideList2 - getListName()

Retorna o nome da lista, que geralmente é o nome da tabela.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 14. Retornos

Tipo	Descrição
Cadeia de caracteres	O nome da lista (geralmente o nome da tabela).

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

GlideList2 - getOrderBy()

Retorna o primeiro campo usado para ordenar a lista.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 16. Retornos

Tipo	Descrição
Cadeia de caracteres	O campo pelo qual a lista será solicitada. Vazio se a lista não estiver ordenada.

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

GlideList2 - getParentTable()

Retorna o nome da tabela primária de uma lista relacionada (a tabela associada ao formulário).

Tabela 17. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 18. Retornos

Tipo	Descrição
Cadeia de caracteres	O nome da tabela primária.

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

GlideList2 - getQuery (booliano orderBy, booliano groupBy, booliano fixo, booliano tudo)

Retorna a cadeia de caracteres de consulta codificada para a lista.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
orderBy	Booliano	Opcional. Sinalizador que indica se orderBy deve ser incluído nos resultados. Valores válidos: Verdadeiro: Incluir orderBy nos resultados. Falso: Não inclua orderBy nos resultados. Padrão: falso
groupBy	Booliano	Opcional. Sinalizador que indica se groupBy deve ser incluído nos resultados. Valores válidos: Verdadeiro: Incluir groupBy nos resultados. Falso: Não inclua groupBy nos resultados. Padrão: falso
fixa	Booliano	Opcional. Sinalizador que indica se a consulta fixa deve ser incluída nos resultados. Valores válidos: Verdadeiro: Incluir consulta fixa nos resultados. Falso: Não incluir consulta fixa nos resultados. Padrão: falso
tudo	Booliano	Padrão. Sinalizador que indica se orderBy, groupBy e consulta fixa devem ser incluídos nos resultados. Valores válidos: Verdadeiro: Inclua orderBy, groupBy e consulta fixa nos resultados. Falso: Não inclua todas as três opções nos resultados. Padrão: verdadeiro

Tabela 20. Retornos

Tipo	Descrição
Cadeia de caracteres	Cadeia de caracteres de consulta codificada para a lista.

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

Retorna o campo da lista relacionada que associa a lista relacionada ao formulário primário.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 22. Retornos

Tipo	Descrição
Cadeia de caracteres	Campo que conecta a lista ao formulário primário.

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

GlideList2 - getTableName()

Retorna o nome da tabela da lista.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 24. Retornos

Tipo	Descrição
Cadeia de caracteres	Retorna o nome da tabela da lista.

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

Retorna a exibição usada para exibir a lista.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 26. Retornos

Tipo	Descrição
Cadeia de caracteres	O nome da exibição.

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

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

GlideList2 - getTitle()

Retorna o título da lista.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 28. Retornos

Tipo	Descrição
Cadeia de caracteres	O título da lista.

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

GlideList2 - isUserList()

Retorna verdadeiro se a lista tiver sido personalizada pelo usuário, escolhendo a mecânica de lista e alterando o layout da lista.

Tabela 29. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 30. Retornos

Tipo	Descrição
Booliano	Verdadeiro se o layout da lista tiver sido alterado.

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

GlideList2 - atualizar (número firstRow, cadeia de caracteres adicionais)

Atualiza a lista. . orderByparte do filtro de lista é ignorada para que a lista use sua ordem natural quando for atualizada.

Tabela 31. Parâmetros

Nome	Tipo	Descrição
Primeira linha	Número	A primeira linha a aparecer na lista. Padrão: Primeira linha da exibição atual.
Parms adicionais	Cadeia de caracteres	Pares de nome-valor opcionais que são enviados com a solicitação de atualização de lista.

Tabela 32. Retornos

Tipo	Descrição
vazio

$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, descrição da cadeia de caracteres)

Atualiza a lista. . orderByparte do filtro de lista será incluída se for especificado para a lista.

Tabela 33. Parâmetros

Nome	Tipo	Descrição
Primeira linha	Número	A primeira linha a aparecer na lista. Padrão: Primeira linha da exibição atual.
descrição	Cadeia de caracteres	Opcional pares nome-valor que são enviados com a solicitação de atualização de lista.

Tabela 34. Retornos

Tipo	Descrição
vazio

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 ( filtro de cadeia de caracteres)

Define a cadeia de caracteres de consulta codificada para a lista, ignorando orderBye. groupBypartes da cadeia de caracteres de consulta.

Tabela 35. Parâmetros

Nome	Tipo	Descrição
filtros	Cadeia de caracteres	Cadeia de caracteres de consulta codificada no formato Glide padrão. Consulte Cadeias de caracteres de consulta codificadas .

Tabela 36. Retornos

Tipo	Descrição
vazio

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

GlideList2 - setFilterAndRefresh( filtro de cadeia de caracteres)

Define a cadeia de caracteres de consulta codificada para a lista, incluindo orderBye. groupByse especificado, e atualizará a lista usando o novo filtro.

Tabela 37. Parâmetros

Nome	Tipo	Descrição
filtros	Cadeia de caracteres	Cadeia de caracteres de consulta codificada.

Tabela 38. Retornos

Tipo	Descrição
vazio

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)

Define a primeira linha que aparece na lista quando a lista é atualizada.

Tabela 39. Parâmetros

Nome	Tipo	Descrição
RowNumber	Número	Número da linha da primeira linha a ser exibida.

Tabela 40. Retornos

Tipo	Descrição
vazio

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

GlideList2 - setGroupBy(cadeia de caracteres groupBy)

Define a lista groupBycritérios para um único campo.

Tabela 41. Parâmetros

Nome	Tipo	Descrição
groupBy	Cadeia de caracteres	. groupBycritérios da lista.

Tabela 42. Retornos

Tipo	Descrição
vazio

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

GlideList2 - setOrderBy(cadeia de caracteres orderBy)

Define o. orderBycritérios da lista.

Para um único pedido por campo, use orderBycampo ou orderByDesccampo.Para vários campos, use OrderPorCampo1 OrderPorCampo2 OrderPorCampo3 . orderByEspecifica a ordem crescente e orderByDesc especifica decrescente. Essas cadeias de caracteres de prefixo são opcionais. Se não for especificado, orderByé a ordem padrão.

Tabela 43. Parâmetros

Nome	Tipo	Descrição
orderBy	Cadeia de caracteres	Campos orderBy únicos ou múltiplos.

Tabela 44. Retornos

Tipo	Descrição
vazio

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

GlideList2 - setRowsPerPage ( linhas numéricas)

Define o número de linhas por página a serem exibidas.

Tabela 45. Parâmetros

Nome	Tipo	Descrição
linhas	Número	O número de linhas a serem exibidas.

Tabela 46. Retornos

Tipo	Descrição
vazio

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

GlideList2 - showHideGroups (showFlag booliano )

Mostra ou oculta todos os grupos na lista e salva o estado recolhido/expandido atual dos grupos como uma preferência do usuário.

Tabela 47. Parâmetros

Nome	Tipo	Descrição
MostrarSinalizador	Booliano	Se verdadeiro mostra os grupos na lista.

Tabela 48. Retornos

Tipo	Descrição
vazio

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

GlideList2 - showHideList (showFlag booliano )

Exibe ou oculta a lista e salva o estado recolhido/expandido atual da lista como uma preferência do usuário.

Tabela 49. Parâmetros

Nome	Tipo	Descrição
MostrarSinalizador	Booliano	Se verdadeiro exibe a lista.

Tabela 50. Retornos

Tipo	Descrição
vazio

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

GlideList2 - classificar ( campo de cadeia de caracteres)

Classifica a lista em ordem crescente e define o campo como um orderBycoluna.

Tabela 51. Parâmetros

Nome	Tipo	Descrição
Assunto:	Cadeia de caracteres	Campo a ser usado para classificar a lista.

Tabela 52. Retornos

Tipo	Descrição
vazio

$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 - classificaçãoDescending ( campo de cadeia de caracteres, valor numérico)

Classifica um único campo na lista em ordem decrescente e define o campo como um orderByDescFieldcoluna.

Tabela 53. Parâmetros

Nome	Tipo	Descrição
Assunto:	Cadeia de caracteres	Campo a ser usado para classificar a lista.

Tabela 54. Retornos

Tipo	Descrição
vazio

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

Alterna a exibição da lista e salva o estado recolhido/expandido atual da lista como uma preferência do usuário.

Tabela 55. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 56. Retornos

Tipo	Descrição
vazio

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

GlideList2 - toggleListNoPref()

Alterna a exibição da lista, mas não salva o estado recolhido/expandido atual da lista como uma preferência do usuário.

Tabela 57. Parâmetros

Nome	Tipo	Descrição
nenhum

Tabela 58. Retornos

Tipo	Descrição
vazio

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