Cadeias de caracteres de consulta codificadas

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

    • Uma cadeia de caracteres de consulta codificada representa um filtro complexo em uma lista de registros.

    Use cadeias de caracteres de consulta codificadas para incluir um filtro como parte de um parâmetro de URL, como Navegue até um registro ou módulo usando um URL ou como qualificador de referência restringir os dados selecionáveis para um campo de referência.

    Para construir uma cadeia de caracteres de consulta codificada, gere uma consulta de lista e, em seguida copie-o do filtro de lista . Este é o método preferencial porque a alternativa é criar a cadeia de caracteres manualmente.

    Para criar uma cadeia de caracteres de consulta codificada manualmente, você precisa saber os nomes de tabela e campo relevantes e. operadores .

    Tabela 1. Exemplos de cadeia de caracteres de consulta codificada
    Título Exemplo
    Referência a valores boolianos ou de cadeia de caracteres Para criar uma cadeia de caracteres de consulta em campos boolianos, use esta sintaxe: Por exemplo, para retornar somente registros ativos em uma tabela, use:
    active=true

    Para criar uma cadeia de caracteres de consulta com um campo que tenha um valor de cadeia de caracteres específico, use esta sintaxe: Por exemplo, para retornar registros de incidentes em que a categoria é rede, use:

    category=network
    Referência aos campos de referência Para criar uma cadeia de caracteres de consulta que se refere a um campo de referência em outra tabela, use esta sintaxe: Field_in_referenced_table. Por exemplo, para retornar usuários com a função itil no Atribuído a. Campo de referência no formulário Incidente, use:
    Assigned_to.roles=itil
    Referência aos valores da lista de seleção Para criar uma cadeia de caracteres de consulta que se refere a lista de seleção , use o valor da lista de seleção, não o rótulo, com esta sintaxe: campo da lista de seleção: valor. Por exemplo, para retornar itens de configuração (ICs) com o status Instalado , que tem um valor de 1 na lista de seleção, use:
    install_status=1

    Consulte Valores a serem associados a rótulos de opção para script para encontrar as opções dos valores.
    Usando várias condições Para usar duas condições unidas por um operador AND, use o símbolo de quilate nesta sintaxe: campo1 Por exemplo, para retornar todos os usuários ativos com a função "itil", use:
    active=true^roles=itil

    Para usar duas condições unidas por um operador OR, use o símbolo de quilate com OU com esta sintaxe: campo1 Por exemplo, para retornar todos os usuários com as funções "itil" ou "admin", use:

    roles=itil^ORroles=admin

    Para usar a condição pelo operador LIKE, use a sintaxe:fieldLIKEsubstring. Por exemplo, para retornar todos os usuários com funções que contenham a cadeia de caracteres "it", use:

    rolesLIKEit

    Para usar a condição por um operador IN, use a sintaxe: FieldINvalue1,value2,value3. Por exemplo, para retornar todos os usuários com funções que são "itil", "admin" ou "user", use:

    rolesINitil,admin,user

    Para adicionar várias condições em que uma condição é uma função JavaScript, use esta sintaxe: javascript: A função deve retornar uma cadeia de caracteres que pode ser concatenada com a primeira cadeia de caracteres para produzir uma cadeia de caracteres de consulta válida. Por exemplo, para retornar todos os usuários ativos e atender às condições da função getGroupQualifier(), use:

    javascript:'active=true^' + getGroupQualifier()
    Listar valores em ordem Para classificar dados por um campo específico, use a condição ORDERBY com a seguinte sintaxe:

    Por exemplo, para retornar os dias da semana em ordem a partir da tabela Dia da semana [sys_cal_unit], use:

    unit_name=day^ORDERBYvalue

    Na tabela Dia da semana, unit_name é o campo que especifica dia, semana ou mês, e valor é um valor numérico para cada dia de 1 (segunda-feira) a 7 (domingo). A cadeia de caracteres de consulta retorna uma lista dos dias da semana em ordem do menor valor, que representa segunda-feira, até o maior valor, que representa domingo.

    Nota:
    Os qualificadores de referência não são compatíveis com a condição ORDERBY. Em qualificadores de referência, você pode classificar a lista de pesquisa de referência usando controles de lista padrão. Para especificar a ordem de uma lista de preenchimento automático para um campo de referência, use o atributo de dicionário ref_ac_order_by.
    Incluindo uma consulta de lista relacionada No final da instrução de consulta, inclua as informações da lista relacionada com RLQUEERY e ENDRLQUEY e a quantidade. Por exemplo, em uma consulta na tabela Problema que inclui problemas com pelo menos um incidente relacionado, use:
    ^RLQUERYincident.problem_id,>=1^ENDRLQUERY

    Você também pode especificar condições na tabela relacionada. Por exemplo, para incluir a condição de que pelo menos um dos incidentes relacionados é prioridade crítica, use:

    ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY
    Nota:
    As consultas de lista relacionada devem ser habilitadas em Propriedades do sistema Lista v3 . Selecione Permitir que condições de consulta da lista relacionada sejam adicionadas por meio do filtro marque a caixa para habilitá-la.

    Você pode criar uma consulta de lista relacionada para uma lista que usa Lista v2, no entanto, as condições de filtro não podem ser modificadas até que você remova a condição de lista relacionada na trilha.
    Incluindo uma consulta de termo de pesquisa

    Para incluir um termo de pesquisa em uma consulta, use a variável reservada 123TEXTquery321. Por exemplo, para retornar resultados com o termo de pesquisa "e-mail", use esta cadeia de caracteres de consulta codificada.

    123TEXTQUERY321=email
    Incluindo uma consulta de grupo de índice de texto

    Para incluir um grupo de índice de texto em uma consulta, use a variável reservada 123TEXTINDEXGROUP321. Por exemplo, para retornar resultados no grupo de índice de texto portal_index_group na tabela Grupos de índice de texto [ts_index_group], use esta cadeia de caracteres de consulta codificada.

    123TEXTINDEXGROUP321=portal_index_group