Cadeias de caracteres de consulta codificadas

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 Navegar até um registro ou módulo usando uma URL, ou como um qualificador de referência para restringir os dados selecionáveis para um campo de referência.

    Para criar uma cadeia de caracteres de consulta codificada, gere uma consulta de lista e copie-a 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 conhecer os nomes e operadoresrelevantes da tabela e do campo.

    Tabela 1. Exemplos de cadeia de caracteres de consulta codificada
    Título Exemplo
    Referindo-se a valores boolianos ou de cadeia de caracteres Para criar uma cadeia de caracteres de consulta em campos boolianos, use esta sintaxe: field=true ou field=false. 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: field=value. Por exemplo, para retornar registros de incidentes em que a categoria é rede, use:

    category=network
    Referindo-se aos campos de referência Para criar uma cadeia de caracteres de consulta que se refira a um campo de referência em outra tabela, use esta sintaxe: field_in_referenced_table=value. Por exemplo, para retornar usuários com a função itil no campo de referência Atribuído a no formulário de 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 refira a uma opção de lista de seleção, use o valor da lista de seleção, não o rótulo, com esta sintaxe: campo de 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 para os valores.
    Como usar várias condições Para usar duas condições unidas por um operador E, use o símbolo de acento circunflexo ^ nesta sintaxe: field1=value1^field2=value2. 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 acento circunflexo com OR com esta sintaxe: field1=value1^ORfield1=value2. 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 contêm 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:'field=value^' + function(). 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()
    Listando valores na ordem Para classificar dados por um campo específico, use a condição ORDERBY com a seguinte sintaxe: field1=value^ORDERBYfield2.

    Por exemplo, para retornar os dias da semana na ordem 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 o 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 valor mais baixo, que representa segunda-feira, até o maior valor, que representa o 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 declaração de consulta, coloque as informações da lista relacionada entre ^RLQUERY e ^ENDRLQUERY 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 é de prioridade crítica, use:

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

    Você pode criar uma consulta de lista relacionada para uma lista que usa a Lista v2. No entanto, as condições do filtro não podem ser modificadas até que você remova a condição da 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 dentro do 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