GlideList ( Next Experience) - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • . GlideList A API fornece métodos para personalizar listas no Estrutura de IU do Next Experience.

    Esta API permite adicionar a funcionalidade GlideList a um botão no Experiência com o espaço IU. Use g_list variável para chamar cada método.

    Para adicionar um botão, crie uma ação de lista e adicione GlideList o método chama para Client Script campo Onclick método. Para obter instruções, consulte Use a API GlideList do cliente na IU do Workspace Experience .

    Chamadas de método GlideList no campo Client Script.
    Nota:
    Cada método deve ser usado com atualizar () , com as exceções de classificar() e. ClassificaçãoDescending() métodos.
    Os métodos nesta API são baseados em GlideList2 . A seguir GlideList2 os métodos não são compatíveis com Next Experience e causa um erro no log do console:
    • IsUserList()
    • SetFirstRow()
    • ShowOcultar Groups()
    • ShowHideList()
    • ToggleList()
    • ToggleListNoPref()

    GlideList ( Next Experience AddFilter ( filtro de cadeia de caracteres)

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

    Consulte também SetFilter() .

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

    O exemplo a seguir mostra como recuperar uma lista de registros ativos e atualizar a página.

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

    GlideList ( Next Experience GetChecked()

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

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    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.

    O exemplo a seguir mostra como obter os sys_ids de cada registro selecionado em uma lista.

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

    Saída em uma caixa de alerta (vazio se nenhum registro for selecionado):

    079893e6b733330059128ac7ee11a967, 4fca6d45b7131010f03e9b7ade11a9d3, 5c460fbf1bd0011079e52131604bcbd9

    GlideList ( Next Experience 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).

    Aplique este método em Ações da lista relacionada em Experiência com o espaço IU. Para obter instruções, consulte Use a API GlideList do cliente na IU do Workspace Experience .

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres de consulta fixa da lista.

    O exemplo a seguir mostra como exibir uma consulta fixa com uma mensagem de depuração no log do console do navegador.

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

    A saída após clicar no botão na guia Incidentes secundários em um registro de incidente.

    parent_incident=46f1784ba9fe19810018aa27fbb23482 debug message

    GlideList ( Next Experience GetGroupBy()

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

    Consulte também:
    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres O campo ou a lista separada por vírgulas de campos usados para agrupar a lista.

    O exemplo a seguir mostra como obter valores de groupBy de campo da exibição de lista atual.

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

    Saída em uma caixa de alerta para uma lista agrupada por prioridade:

    The list is grouped by ^GROUPBYpriority

    GlideList ( Next Experience GetListName()

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome da lista (geralmente o nome da tabela).

    O exemplo a seguir mostra como chamar o método.

    g_list.getListName();

    GlideList ( Next Experience GetOrderBy()

    Retorna o primeiro campo usado para ordenar a lista.

    Consulte também:
    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres O campo pelo qual a lista será solicitada. Vazio se a lista não estiver ordenada.

    O exemplo a seguir mostra como obter valores de orderBy de campo da exibição de lista atual.

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

    Saída em uma caixa de alerta para uma lista ordenada por prioridade:

    The list is ordered by ^ORDERBYDESCpriority

    GlideList ( Next Experience GetParentTable()

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

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome da tabela primária.

    O exemplo a seguir mostra como chamar o método.

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

    GlideList ( Next Experience GetQuery(Object)

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

    Consulte também:
    Tabela 15. Parâmetros
    Nome Tipo Descrição
    <object> Objeto Opcional. Por padrão, este método inclui orderBy, groupBy e consulta fixa nos resultados. Você pode definir propriedades do objeto para restringir os resultados a uma ou mais das três opções disponíveis.
    <object>.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
    <object>.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
    <object>.corrigido 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
    Tabela 16. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres de consulta codificada para a lista.

    O exemplo a seguir mostra como exibir a consulta codificada de lista com uma mensagem de depuração no log do console do navegador.

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

    Saída:

    active=false^EQ message

    GlideList ( Next Experience GetRelated()

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

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres Campo que conecta a lista ao formulário primário.

    O exemplo a seguir mostra como chamar o método.

    g_list.getRelated();

    GlideList ( Next Experience GetTableName()

    Retorna o nome da tabela da lista.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    Tipo Descrição
    Cadeia de caracteres Retorna o nome da tabela da lista.

    O exemplo a seguir mostra como exibir o nome da lista da exibição atual.

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

    Saída em uma caixa de alerta:

    The current list name is incident

    GlideList ( Next Experience GetTitle()

    Retorna o título da lista.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Cadeia de caracteres O título da lista.

    O exemplo a seguir mostra como chamar o método.

    g_list.getTitle();

    GlideList ( Next Experience GetView()

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

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome da exibição.

    O exemplo a seguir mostra como chamar o método.

    g_list.getView();

    GlideList ( Next Experience Atualizar (número firstRow)

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

    Tabela 25. 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.
    Tabela 26. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como chamar o método.

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

    GlideList ( Next Experience RefreshWithOrderBy(Number firstRow)

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

    Tabela 27. 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.
    Tabela 28. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como chamar o método.

    g_list.refreshWithOrderBy();

    GlideList ( Next Experience 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.

    Consulte também AddFilter() .

    Tabela 29. 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 30. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como restringir os resultados da lista a registros ativos.

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

    GlideList ( Next Experience SetGroupBy(cadeia de caracteres groupBy)

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

    Consulte também:
    Tabela 31. Parâmetros
    Nome Tipo Descrição
    groupBy Cadeia de caracteres . groupBycritérios da lista.
    Tabela 32. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como agrupar registros listados por ID do solicitante.

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

    GlideList ( Next Experience 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.

    Consulte também:
    Tabela 33. Parâmetros
    Nome Tipo Descrição
    orderBy Cadeia de caracteres Campos orderBy únicos ou múltiplos.
    Tabela 34. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como ordenar a lista pelo valor do campo Prioridade.

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

    GlideList ( Next Experience SetRowsPerPage( linhas numéricas)

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

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    linhas Número O número de linhas a serem exibidas.
    Tabela 36. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como limitar os resultados a 50 linhas por página.

    g_list.setRowsPerPage(50);
refresh();

    GlideList ( Next Experience Classificar ( campo de cadeia de caracteres)

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

    Consulte também:
    Nota:
    Este método não requer atualizar () método.
    Tabela 37. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres Campo a ser usado para classificar a lista.
    Tabela 38. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como classificar os resultados por Número campo.

    g_list.sort("number");

    GlideList ( Next Experience ClassificDescending ( campo de cadeia de caracteres, valor numérico)

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

    Consulte também:
    Nota:
    Este método não requer atualizar () método.
    Tabela 39. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres Campo a ser usado para classificar a lista.
    Tabela 40. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como classificar os resultados pelo campo Número em ordem decrescente.

    g_list.sortDescending("number");