---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de filtro - Android

# API de filtro - Android {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A classe Filtro fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.
{#FilterAndroidAPI__table_vx2_klw_5pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| queryItems | Mapa\<String, String\> | Coleção de itens de consulta que representam o filtro. |
[Tabela 1. Propriedades]

{#FilterAndroidAPI__table_vx2_klw_5pb}

## Filtro - Filtro (condições: Lista\<Condition\> , palavras-chave: cadeia de caracteres? = nulo, "sortBy": lista\<Sort\> ? = nulo) {#ariaid-title2}

Cria um filtro com base em palavras-chave e condições específicas que podem ser combinadas com OR ou AND.
{#Filter-Filter_cond_A_S_A__table_yzp_jz2_4qb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| condições | Lista\<Condition\> | Condições simples ou compostas a serem adicionadas à consulta. Condições possíveis: * BooleanSimpleCondition: condições disponíveis para campos de registro booliano. * DateSimpleTimeCondition: condições disponíveis para campos de registro de data e hora. * EmailSimpleCondition: condições disponíveis para campos de e-mail. * IntegerChoiceSimpleCondition: condições disponíveis para campos de opção de número inteiro. * NumericSimpleCondition: condições disponíveis para vários campos numéricos. * ReferênciaSimpleCondition: operadores de condição disponíveis para campos de registro de referência. * StringChoiceSimpleCondition: operadores de condição disponíveis para campos de registro de opção que contêm cadeias de caracteres. * StringSimpleCondition: operadores de condição disponíveis para campos de registro de cadeia de caracteres. * ComponentCondition: permite agrupar SimpleConditions em uma condição composta usando conectores ConditionUtils.ComponentOperator. {#Filter-Filter_cond_A_S_A__ul_hx1_yf5_tqb} |
| palavras-chave | Cadeia de caracteres | Opcional. Qualquer palavra ou frase específica a ser pesquisada. Padrão: nil - Nenhuma pesquisa de palavra específica. |
| classificarPor | Lista\<Sort\> | Opcional. Lista de nomes de campo de registro e a constante de ordem de classificação associada para classificar os registros retornados. Por exemplo: `valsortBy = listOf("zipcode", ORDER_DESC)` Se você incluir vários campos de classificação, cada campo subsequente será uma classificação adicional do(s) campo(s) anterior(es). Valores de classificação válidos: * ORDER_ASC: classificar em ordem crescente * ORDER_DESC: classificação decrescente {#Filter-Filter_cond_A_S_A__ul_nws_tcf_4qb} Padrão: ORDER_ASC |
[Tabela 2. Parâmetros]

{#Filter-Filter_cond_A_S_A__table_yzp_jz2_4qb} {#Filter-Filter_cond_A_S_A__table_zzp_jz2_4qb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 3. Retorna]

{#Filter-Filter_cond_A_S_A__table_zzp_jz2_4qb}  
<br />

    // Where the record is active 

    val condition1 = BooleanSimpleCondition.conditionIs("active", true) 

    // AND the date value of the SLA due field is on "today" or any date after today. 

    val condition2 = DateSimpleTimeCondition.atOrAfter("sla_due", 0, ConditionUtils.DateTimeValueOperator.daysAgoStart) 

    val filter = Filter(conditions = listOf(condition1, condition2))  

## Filtro - Filter(criteriaList: lista\<Criteria\> , "sortBy": lista\<Sort\> ? = nulo) {#ariaid-title3}

Cria um filtro com base em um ou mais critérios de filtro que são OU juntos.
{#Filter-Filter_criteria_A_A__table_ebq_fbz_nqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| lista de critérios | Lista\<Criteria\> | Condições de critérios de nível superior para agrupar com conectores `OR`. |
| classificarPor | Lista\<Sort\> | Opcional. Lista de nomes de campo de registro e a constante de ordem de classificação associada para classificar os registros retornados. Por exemplo: `valsortBy = listOf("zipcode", ORDER_DESC)` Se você incluir vários campos de classificação, cada campo subsequente será uma classificação adicional do(s) campo(s) anterior(es). Valores de classificação válidos: * ORDER_ASC: classificar em ordem crescente * ORDER_DESC: classificação decrescente {#Filter-Filter_criteria_A_A__ul_nws_tcf_4qb} Padrão: ORDER_ASC |
[Tabela 4. Parâmetros]

{#Filter-Filter_criteria_A_A__table_ebq_fbz_nqb} {#Filter-Filter_criteria_A_A__table_fbq_fbz_nqb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 5. Retorna]

{#Filter-Filter_criteria_A_A__table_fbq_fbz_nqb}  
<br />

    val activeIncidents = BooleanSimpleCondition.conditionIs("active", true)
    val assignedToEmpty = StringSimpleCondition.isEmpty("assigned_to")
    val assignedToAbel = StringSimpleCondition.conditionIs("assigned_to", "Abel Tuter")
    val assignedToAbelOrEmpty = CompoundCondition(ConditionUtils.CompoundOperator.OR, listOf(assignedToEmpty, assignedToAbel))
    val needToReassign = Criteria().addConditions(listOf(activeIncidents, assignedToAbelOrEmpty))
    val highEscelations = StringSimpleCondition.conditionIs("escalation", "2")
    val overdueEscelations = StringSimpleCondition.conditionIs("escalation", "3")
    val highOrOverdueEscelations = CompoundCondition(ConditionUtils.CompoundOperator.OR, listOf(highEscelations, overdueEscelations))
    val needToHandleEscalation = Criteria().addCondition(highOrOverdueEscelations)
    val myPrioritiesForTodayFilter = Filter(listOf(needToReassign, needToHandleEscalation))