--- sourceDocument: Interface do usuário da Now Platform Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interface do usuário da Now Platform Yokohama ft:clusterId : - platux bundleId : - platux workflow : - Platform --- # Cadeias de caracteres de consulta codificadas # Cadeias de caracteres de consulta codificadas {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/i1nRUR4MK_0kzODMvI3u5Q "Os usuários podem navegar até um registro ou módulo diretamente usando um URL. Este tópico explica o esquema de URL pelo qual o sistema renderiza páginas."), ou como [qualificador de referência](https://www.servicenow.com/docs/access?context=c_ReferenceQualifiers&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)para 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](https://servicenow-prod.fluidtopics.net/NjKDWzrncro9HqD_chvlRA "Você pode gerar uma cadeia de caracteres de consulta codificada por meio de um filtro em qualquer lista e colar a cadeia de caracteres em uma consulta de URL ou em um qualificador de referência."). 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](https://servicenow-prod.fluidtopics.net/UeR61aqR6Hp~FzZ4ZsBXhg "O sistema fornece um conjunto de operadores para uso com filtros, construtores de condições e consultas codificadas. O tipo de dados de um campo determina quais operadores estão disponíveis para ele."). {#c_EncodedQueryStrings__table_hkc_kvp_pq__entry__2} | 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 incidente 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 um [lista de seleção](https://www.servicenow.com/docs/access?context=c_ChoiceLists&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US), use o valor da lista de escolha, não o rótulo, com esta sintaxe: campo da lista de escolha: 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 aos rótulos de escolha para script](https://www.servicenow.com/docs/access?context=c_DetermValsAssocWChoicesScripting&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)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 OR com esta sintaxe: campo1 Por exemplo, para retornar todos os usuários com as funções "itil" ou "administrador", 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: FieldINvalor1,valor2,valor3. Por exemplo, para retornar todos os usuários com funções "itil", "admin" ou "usuário", 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() | | Listando valores em ordem | Para classificar dados por um campo específico, use a condição ORDERBY com a seguinte sintaxe: campo1 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, coloque as informações da lista relacionada com 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 é prioridade crítica, use: ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY Nota: As consultas da lista relacionada devem ser habilitadas em Propriedades do sistema Lista v3 . Selecione Permita que condições de consulta da lista relacionada sejam adicionadas por meio do filtro para habilitá-lo. 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 | [Tabela 1. Exemplos de cadeia de caracteres de consulta codificada] {#c_EncodedQueryStrings__table_hkc_kvp_pq} * **[Gere uma cadeia de caracteres de consulta codificada por meio de um filtro](https://servicenow-prod.fluidtopics.net/NjKDWzrncro9HqD_chvlRA)** Você pode gerar uma cadeia de caracteres de consulta codificada por meio de um filtro em qualquer lista e colar a cadeia de caracteres em uma consulta de URL ou em um qualificador de referência.