# Obtenir par filtre

### 🎯 **Que fait cette opération ?**

Cette opération permet de rechercher des enregistrements dans une table du dictionnaire en utilisant des filtres personnalisés.

#### ✅ **Caractéristiques principales :**

* Récupère plusieurs enregistrements en fonction de critères spécifiques.
* Permet d'appliquer des filtres pour affiner la recherche.
* Peut être utilisée pour charger des listes dynamiques ou valider des informations.

### 📂 **Comment configurer l'opération "Rechercher par filtre"**

#### 1️⃣ **Accédez au composant**

1. Dans **Hablla Studio**, ouvrez le flux d'automatisation où vous souhaitez rechercher des enregistrements dans le dictionnaire.
2. Ajoutez le bloc **« Dictionnaire »**.
3. Dans le panneau latéral droit, sélectionnez l'opération **"Rechercher par filtre"**.

#### 2️⃣ **Remplissez les champs obligatoires**

| **Champ**                     | **Type de donnée** | **Obligatoire ?** | **Description**                                                      |
| ----------------------------- | ------------------ | ----------------- | -------------------------------------------------------------------- |
| **ID de l'espace de travail** | `chaîne`           | ✅ Oui             | ID de l'espace de travail où se trouve la table du dictionnaire.     |
| **Nom de la table**           | `chaîne`           | ✅ Oui             | Nom de la table du dictionnaire où les enregistrements sont stockés. |

#### 3️⃣ **Ajouter des filtres (Optionnel)**

En plus des champs obligatoires, vous pouvez définir des filtres pour affiner la recherche.

| **Filtre**               | **Type de donnée**             | **Description**                                                                             |
| ------------------------ | ------------------------------ | ------------------------------------------------------------------------------------------- |
| **Champs Personnalisés** | `collection`                   | Permet de sélectionner quels champs du dictionnaire doivent être utilisés comme filtre.     |
| **Méthode de Filtre**    | `chaîne` (`fields` ou `query`) | Définit si la recherche sera basée sur des champs spécifiques ou sur une chaîne de requête. |
| **Tri**                  | `chaîne` (`asc` ou `desc`)     | Définit l'ordre croissant (`asc`) ou décroissant (`desc`) des résultats.                    |
| **Page**                 | `nombre`                       | Permet de définir la page de la recherche pour la pagination des résultats.                 |
| **Limite**               | `nombre`                       | Définit combien d'enregistrements doivent être retournés à la fois.                         |

⚠️ **Attention !**

* Si aucun filtre n'est appliqué, la recherche retournera tous les enregistrements de la table.
* Utilisez la pagination pour éviter un retour excessif d'enregistrements.

#### 4️⃣ **Enregistrer la configuration**

Après avoir rempli les champs et défini les filtres, cliquez sur le bouton **"Enregistrer"** ✅.

Dorénavant, chaque fois que cette automatisation sera déclenchée, les enregistrements filtrés seront renvoyés automatiquement.

### 📌 **Exemple d'utilisation dans le flux d'automatisation**

📊 **Scénario :** Vous souhaitez rechercher tous les clients enregistrés dans la table **"Clients"** du dictionnaire qui sont dans le statut **"Actif"**.

#### 🔹 **Flux d'automatisation :**

1️⃣ **Bloc 1** → Déclencher une automatisation chaque fois qu'un client effectue une action.\
2️⃣ **Bloc 2** → Rechercher dans le dictionnaire tous les clients avec le statut **"Actif"**.\
3️⃣ **Bloc 3** → Envoyer un message personnalisé à ces clients.

🚀 **Résultat :** L'automatisation filtre et renvoie uniquement les enregistrements pertinents, permettant des communications ciblées et segmentées.

### 🎉 **Conclusion**

L'opération **Rechercher des enregistrements par filtre dans le dictionnaire** est idéal pour trouver des informations spécifiques de manière dynamique et personnalisée. Avec cette fonctionnalité, vous pouvez optimiser les recherches et rendre vos automatismes encore plus intelligents dans Hablla Studio.

Si vous avez besoin de plus d'assistance, contactez notre équipe ! 🚀