> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/reference/blocs/search-role.md).

# Rechercher un rôle

**Catégorie** — Recherche Discord · **Éditeur d’outils**

Cherche un rôle par son nom sur le serveur courant.

![Rechercher un rôle dans le builder](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-efa20781a1841a2bfc376d6c81ae9c162a0f84a6%2Fsearch-role.png?alt=media)

## Paramètres

| Réglage                        | Valeurs acceptées                                                                                                                           |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Recherche                      | Texte · 256 caractères maximum · obligatoire                                                                                                |
| Mode de recherche              | Choix · Automatique, Correspondance exacte, Contient le texte, Commence par le texte, Correspondance approximative · par défaut Automatique |
| Nombre maximal de résultats    | Nombre · de 1 à 100 · par défaut `20`                                                                                                       |
| Trier par pertinence           | Interrupteur · par défaut activé                                                                                                            |
| Nom de la recherche (variable) | Texte · 32 caractères maximum · obligatoire · par défaut `roles`                                                                            |

## Entrées, sorties et variables

Une entrée et une sortie. La recherche peut utiliser une variable de texte. Avec le nom de sortie par défaut, le bloc fournit `{discord_roles_result}`, `{discord_roles_count}`, `{discord_roles_status}`, `{discord_roles_error}`, `{discord_roles_first_id}`.

## Exécution et limites

Exécutez ce bloc dans un outil. Les résultats dépendent du serveur courant et de ce que le bot peut consulter. La sortie fournit au plus le nombre demandé.

## Exemple

Cherchez `Atelier` en mode exact, puis transmettez `{discord_roles_first_id}` à l’action suivante si le choix est unique.

## Erreurs courantes

Avec zéro résultat, vérifiez le nom et le serveur. Avec plusieurs correspondances, demandez une précision ou comparez le nombre avant de choisir l’ID. Traitez aussi le statut partiel.

## Blocs associés

[Ajouter un rôle](/reference/blocs/add-role.md) · [Renvoyer un résultat](/reference/blocs/return-tool-result.md)
