---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de filtre : Android

# API de filtre : Android {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

La classe Filter permet de configurer des filtres qui définissent les données à renvoyer dans les résultats renvoyés d'une requête de point de terminaison REST.
{#FilterAndroidAPI__table_vx2_klw_5pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| éléments requeryItems | Map\<chaîne, chaîne\> | Collection d'éléments de requête représentant le filtre. |
[Tableau 1. Propriétés]

{#FilterAndroidAPI__table_vx2_klw_5pb}

## Filtre : filtre(conditions : List\<Condition\>, mots-clés : String ? = null, sortBy : List\<Sort\> ? = null) {#ariaid-title2}

Crée un filtre basé sur des mots clés et des conditions spécifiques qui peuvent être OU ET ensemble.
{#Filter-Filter_cond_A_S_A__table_yzp_jz2_4qb__entry__3}

| Nom | Type | Description |
|-|-|-|
| conditions | List\<Condition\> | Conditions simples ou composées à ajouter à la requête. Conditions possibles : * BooleanSimpleCondition : conditions disponibles pour les champs d'enregistrement booléens. * DateSimpleTimeCondition : conditions disponibles pour les champs d'enregistrement de date et heure. * EmailSimpleCondition : conditions disponibles pour les champs d'e-mail. * IntegerChoiceSimpleCondition : conditions disponibles pour les champs de choix de nombre entier. * NumericSimpleCondition : conditions disponibles pour divers champs numériques. * ReferenceSimpleCondition : opérateurs de condition disponibles pour les champs d'enregistrement de référence. * StringChoiceSimpleCondition : opérateurs de condition disponibles pour les champs d'enregistrement de choix contenant des chaînes. * StringSimpleCondition : opérateurs de condition disponibles pour les champs d'enregistrement sous forme de chaîne. * CompoundCondition : vous permet de regrouper des SimpleConditions dans une condition composée à l'aide des connecteurs ConditionUtils.CompoundOperator. {#Filter-Filter_cond_A_S_A__ul_hx1_yf5_tqb} |
| Mots clés | Chaîne | Facultatif. N'importe quel mot ou expression spécifique à rechercher. Par défaut : néant : pas de recherche de mot spécifique. |
| trier par | Liste\<trier\> | Facultatif. Liste des noms de champs d'enregistrement et constante d'ordre de tri associée pour trier les enregistrements renvoyés. Par exemple : `val sortBy = listOf(<< zipcode >>, ORDER_DESC)` Si vous incluez plusieurs champs de tri, chaque champ suivant est un autre tri du ou des champs précédents. Valeurs de tri valides : * ORDER_ASC : Trier par ordre croissant * ORDER_DESC : Trier par ordre décroissant {#Filter-Filter_cond_A_S_A__ul_nws_tcf_4qb} Par défaut : ORDER_ASC |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 3. Renvoie]

{#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))  

## Filtre : filtre(criteriaList : List\<Criteria\>, sortBy : List\<Sort\> ? = null) {#ariaid-title3}

Crée un filtre en fonction d'un ou de plusieurs critères de filtre qui sont OU ensemble.
{#Filter-Filter_criteria_A_A__table_ebq_fbz_nqb__entry__3}

| Nom | Type | Description |
|-|-|-|
| liste de critères | Liste\<Critères\> | Conditions de critères de niveau supérieur à regrouper avec des connecteurs `OR` . |
| trier par | Liste\<trier\> | Facultatif. Liste des noms de champs d'enregistrement et constante d'ordre de tri associée pour trier les enregistrements renvoyés. Par exemple : `val sortBy = listOf(<< zipcode >>, ORDER_DESC)` Si vous incluez plusieurs champs de tri, chaque champ suivant est un autre tri du ou des champs précédents. Valeurs de tri valides : * ORDER_ASC : Trier par ordre croissant * ORDER_DESC : Trier par ordre décroissant {#Filter-Filter_criteria_A_A__ul_nws_tcf_4qb} Par défaut : ORDER_ASC |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 5. Renvoie]

{#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))