GlideListV3 (g_list) - Cliente (descontinuado)

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

    • . GlideListV3 A API fornece métodos para manipular listas.

    Você acessa o. GlideListV3 usando g_list objeto global. Esses métodos são usados em menus de contexto de IU e ações de IU. O objeto g_list não está disponível para listas relacionadas na ação de IU do link do formulário.

    Nota:

    Esta API não é mais compatível. Considere o uso do GlideList2() API em vez disso.

    GlideListV3 - 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 Condição de cadeia de caracteres de consulta a ser adicionada.
    Tabela 2. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - Obter (ListID de cadeia de caracteres)

    Retorna o objeto GlideList da lista especificada.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    listId Cadeia de caracteres O nome da lista.
    Tabela 4. Retornos
    Tipo Descrição
    Objeto O objeto GlideList da lista especificada ou nulo se não for encontrado.

    GlideListV3 - Get(Object DomElement)

    Retorna o objeto GlideList para o elemento DOM especificado.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    DomElement Objeto O ID do elemento DOM para o qual você deseja o objeto GlideList.
    Tabela 6. Retornos
    Tipo Descrição
    Objeto O objeto GlideList para o elemento DOM especificado. Retorna nulo se o elemento DOM não for encontrado.

    GlideListV3 - getCheck()

    Retorna uma lista separada por vírgulas de sys_ids para itens marcados na lista. Não retorna itens que não têm permissão para serem executados.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres Lista separada por vírgulas dos sys_ids para itens marcados na lista. Não retorna itens que não têm permissão para serem executados.

    GlideListV3 - getFixedQuery()

    Retorna a consulta sysparm_fixed.

    A 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. Retorna
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres de consulta fixa da lista.

    GlideListV3 - getFormTarget()

    Retorna o atributo de destino do formulário.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres O atributo de destino do formulário.

    GlideListV3 - getGroupBy()

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

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres O campo ou a lista separada por vírgulas de campos usados para agrupar a lista.

    GlideListV3 - getListName()

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

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome da lista.

    GlideListV3 - getOrderBy()

    Retorna o primeiro campo usado para ordenar a lista.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres O campo usado para ordenar a lista ou uma cadeia de caracteres vazia se a lista não estiver classificada.

    GlideListV3 - getParentTable()

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

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

    GlideListV3 - getQuery (opções de objeto)

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

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    opções Objeto As opções podem ser uma ou mais das seguintes opções.
    • Orderby - Inclui ORDERBY na consulta
    • Groupby - Incluir GROUPBY na consulta
    • corrigido - inclui sysparm_fixed_query na consulta
    • todos - inclui todas as opções na consulta
    Tabela 22. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres de consulta codificada para a lista.

    GlideListV3 - getReferringUrl()

    Retorna o URL de referência.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Cadeia de caracteres Retorna a URL do formulário primário ou '*' se não houver formulário primário.

    GlideListV3 - getRelated()

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

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

    GlideListV3 - getRelatedListType()

    Retorna o tipo de lista relacionada.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    Cadeia de caracteres O tipo de tabela de relacionamento.

    GlideListV3 - getRelationshipId()

    Retorna o ID do registro de relacionamento, se esta for a lista relacionada do tipo REL.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 30. Retorna
    Tipo Descrição
    Cadeia de caracteres O sys_id do registro de relacionamento.

    GlideListV3 - getRow Count()

    Retorna o número de linhas retornadas pela consulta.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 32. Retorna
    Tipo Descrição
    Número O número de linhas retornadas pela consulta.

    GlideListV3 - getRowsPerPage()

    Retorna o número de linhas a serem exibidas em uma página.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 34. Retorna
    Tipo Descrição
    Número O número de linhas a serem exibidas em uma página.

    GlideListV3 - getTableName()

    Retorna o nome da tabela da lista.

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

    GlideListV3 - getTitle()

    Retorna o título da lista.

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

    GlideListV3 - getView()

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

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

    GlideListV3 - isUserList()

    Retorna verdadeiro se a lista tiver sido personalizada pelo usuário.

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 42. Retorna
    Tipo Descrição
    Booliano Verdadeiro se o layout da lista foi alterado.

    GlideListV3 - atualizar(Número firstRow, Parâmetros adicionais do objeto)

    Atualiza a lista. A parte orderBy do filtro de lista é ignorada para que a ordenação natural da lista seja usada.

    Tabela 43. Parâmetros
    Nome Tipo Descrição
    Primeira linha Número (Opcional) A primeira linha a ser exibida na lista. Se não for especificado, a primeira linha atual da lista será usada.
    additionalParams Objeto (Opcional) Nome- Pares de valor que são enviados com a solicitação de atualização de lista.
    Tabela 44. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - refreshWithOrderBy(Number firstRow, Object additionalParams)

    Atualiza a lista usando os campos orderBy.

    Tabela 45. Parâmetros
    Nome Tipo Descrição
    Primeira linha Número (Opcional) A primeira linha a ser exibida na lista. Se não for especificado, a primeira linha atual da lista será usada.
    additionalParams Objeto (Opcional) Nome- Pares de valor que são enviados com a solicitação de atualização de lista.
    Tabela 46. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setFilter (filtro de cadeia de caracteres, booliano saveOrderBy, booliano saveGroupBy)

    Define a cadeia de caracteres de consulta codificada para a lista ignorando as partes orderBy e groupBy da cadeia de caracteres de consulta.

    Tabela 47. Parâmetros
    Nome Tipo Descrição
    filtros Cadeia de caracteres Uma cadeia de caracteres de consulta codificada.
    SalvaOrderBy Booliano O padrão é falso. Quando verdadeiro, usa a parte orderBy da consulta.
    SaveGroupBy Booliano O padrão é falso. Quando verdadeiro, usa a parte groupBy da consulta.
    Tabela 48. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setFilterAndRefresh( filtro de cadeia de caracteres)

    Define a cadeia de caracteres de consulta codificada para a lista e atualiza a lista usando o novo filtro.

    Isso preserva os parâmetros groupby e orderby.

    Tabela 49. Parâmetros
    Nome Tipo Descrição
    filtros Cadeia de caracteres Cadeia de caracteres de consulta codificada.
    Tabela 50. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setFirstRow (número firstRow)

    Define a primeira linha a ser exibida quando a lista é atualizada.

    Tabela 51. Parâmetros
    Nome Tipo Descrição
    Primeira linha Número O número da linha na lista.
    Tabela 52. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setFormTarget(destino de cadeia de caracteres)

    Especifica onde exibir a resposta do formulário.

    Tabela 53. Parâmetros
    Nome Tipo Descrição
    target Cadeia de caracteres O valor do atributo form.target a ser usado.
    Tabela 54. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setGroupBy(cadeia de caracteres groupBy)

    Define o. groupBycritérios para a lista, para um único campo ou vários campos.

    Para um único campo, use field ou groupByField. O prefixo groupBy é opcional. Para vários campos, use campo1 campo2 campo3 ou GrupoPorCampo1 grupoPorCampo2 grupoPorCampo3 .

    Tabela 55. Parâmetros
    Nome Tipo Descrição
    Cadeia de caracteres groupBy Agrupar por critérios da lista.
    Tabela 56. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setOrderBy(cadeia de caracteres orderBy)

    Define o. orderBycritérios da lista.

    Para um único pedido por uso de campo orderBycampo ou orderByDescField. 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 especificado orderBypresumido.

    Tabela 57. Parâmetros
    Nome Tipo Descrição
    orderBy Cadeia de caracteres Ordem única ou múltipla por campos.
    Tabela 58. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setReferringUrl(url da cadeia de caracteres)

    Define o url de referência do formulário primário.

    Tabela 59. Parâmetros
    Nome Tipo Descrição
    URL Cadeia de caracteres URL do formulário primário
    Tabela 60. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - setRowsPerPage(number numRows)

    Defina o número de linhas a serem exibidas em uma página.

    Tabela 61. Parâmetros
    Nome Tipo Descrição
    numRows Número O número de linhas a serem exibidas em uma página.
    Tabela 62. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - showHideGroups (showFlag booliano)

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

    Tabela 63. Parâmetros
    Nome Tipo Descrição
    MostrarSinalizador Booliano Quando verdadeiro, exibe os grupos na lista.
    Tabela 64. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - 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 65. Parâmetros
    Nome Tipo Descrição
    MostrarSinalizador Booliano Quando verdadeiro, exibe a lista.
    Tabela 66. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - classificar (campo de cadeia de caracteres)

    Classifique a lista em ordem crescente.

    Tabela 67. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres O campo a ser usado para classificar a lista.
    Tabela 68. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - sortDescending (campo de cadeia de caracteres)

    Classifica a lista em ordem decrescente.

    Tabela 69. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres O campo usado para classificar a lista.
    Tabela 70. Retornos
    Tipo Descrição
    vazio

    GlideListV3 - toggleList()

    Alterna a exibição da lista entre recolhida e expandida e salva o estado como uma preferência do usuário.

    Tabela 71. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 72. Retorna
    Tipo Descrição
    vazio

    GlideListV3 - toggleListNoPref()

    Alterna a exibição da lista entre recolhida e expandida, mas não salva o estado como uma preferência do usuário.

    Tabela 73. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 74. Retorna
    Tipo Descrição
    vazio