Rechercher des candidats
boond_candidates_searchSearch and filter candidates in BoondManager by manager, state, skills, location, and more using server-side parameters; returns a paginated list of matching candidates.
Instructions
Recherche des candidats dans BoondManager avec filtres serveur.
⚠️ Utilisez les filtres structurés plutôt que la pagination intégrale. Les noms de paramètres sont ceux exacts de l'API.
Cas d'usage courants :
• Mes candidats sans connaître son propre ID : perimeterDynamic: ["data"]. Pour "candidats de l'équipe X" : perimeterManagers: [<X_id>] (utiliser perimeterManagersType: "main"|"hr" pour cibler Main vs HR Manager).
• États / types : candidateStates: [<id>] (dictionnaire setting.state.candidate), candidateTypes (setting.typeOf.resource), contractTypes, availabilityTypes. IDs entiers issus du dictionnaire.
• Périmètre orga : perimeterAgencies, perimeterPoles, perimeterBusinessUnits. narrowPerimeter: true pour ET.
• Profil technique : tools: [<id>] (OU; pour ET: ["#AND#", "1", "2"]), expertiseAreas, activityAreas, experiences, trainings, mobilityAreas, languages (format langueId|niveauId).
• Sourcing : sources: [<id>] (origine du candidat), evaluations.
• Période : period: "created"|"updated"|"available"|"withActions"|... + startDate/endDate.
• Recherche par nom : keywords: "Dupont" + keywordsType: "lastName" (ou firstName, fullName avec "NOM#PRENOM", emails, phones, title, titleSkills…). Sans keywordsType, recherche par défaut dans le CV.
• Géolocalisation : coordinates: "lat,lon" ou location + geoDistance (km, 5-200).
Pagination : page, pageSize (max 500). Tri : sort + order.
Returns : liste paginée des candidats. Utiliser boond_candidates_get ou les outils d'onglets pour le détail.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Numéro de page (défaut: 1, max: 100) | |
| sort | No | Champ de tri (ex: lastName, firstName, updateDate) | |
| flags | No | IDs de tags. | |
| order | No | Ordre de tri (asc/desc) | |
| tools | No | IDs d'outils/technos (dictionnaire setting.tool). Logique OU par défaut. Pour ET, ajouter '#AND#' en 1er élément: tools=['#AND#','12','34']. | |
| fields | No | Projection côté client : liste d'attributs JSON:API à afficher pour chaque résultat (ex: ['title', 'updateDate', 'numberOfActiveProjects']). Réduit fortement la taille de la réponse. Absent = résumé standard (nom, email, ville, statut...). Les noms inconnus sont ignorés. | |
| period | No | Filtre temporel : 'created', 'updated', 'available', 'noAction'/'withActions'/'withoutActions'. À combiner avec `startDate` + `endDate`. | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| shields | No | Niveau de complétude. | |
| sources | No | IDs de sources de recrutement (dictionnaire setting.source). | |
| keywords | No | Mots-clés (par défaut, recherche dans CV + dossier technique). Combinable avec `keywordsType`. | |
| location | No | Adresse texte. Requiert `geoDistance`. | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| languages | No | Langues au format `langueId|niveauId` (ex: ['anglais|courant']). | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| trainings | No | IDs de formations. | |
| coordinates | No | Coordonnées GPS 'lat,lon'. Requiert `geoDistance`. | |
| evaluations | No | IDs d'évaluations. | |
| experiences | No | IDs de niveaux d'expérience. | |
| geoDistance | No | Rayon km (5-200). | |
| keywordsType | No | Champ ciblé par `keywords` (défaut: 'resumeTd'). | |
| activityAreas | No | IDs de secteurs d'activité (dictionnaire setting.activityArea). | |
| contractTypes | No | IDs de types de contrat recherchés (dictionnaire setting.typeOf.contract). | |
| mobilityAreas | No | IDs de zones de mobilité. | |
| candidateTypes | No | IDs de types de candidat (dictionnaire setting.typeOf.resource). | |
| expertiseAreas | No | IDs de domaines d'expertise. | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| candidateStates | No | IDs d'états de candidat (dictionnaire setting.state.candidate via boond_application_dictionary). | |
| narrowPerimeter | No | Si true, jointure ET entre les filtres `perimeter*` (au lieu de OU par défaut). | |
| perimeterDynamic | No | Périmètre dynamique relatif à l'utilisateur courant (raccourci sans avoir à connaître son propre ID). Valeurs : 'data' (mes propres données), 'managers' (mon équipe / mes N-1), 'agencies' (mes agences), 'poles' (mes pôles), 'businessUnits' (mes BU). Combinable. | |
| availabilityTypes | No | IDs de types de disponibilité (dictionnaire setting.availability). | |
| perimeterAgencies | No | IDs d'agences. Conserve les entités dont le responsable appartient à ces agences. | |
| perimeterManagers | No | IDs des managers (ressources). Conserve les entités dont le responsable est l'un de ces managers. Pour 'mon équipe / N-1 d'une personne X', passer [X_id]. Obtenir son propre ID via boond_application_current_user. | |
| providerCompanies | No | IDs de sociétés sous-traitantes. | |
| perimeterManagersType | No | Type de responsable visé par `perimeterManagers`: 'main' (Main Manager) ou 'hr' (HR Manager). | |
| perimeterBusinessUnits | No | IDs de business units. Conserve les entités dont le responsable appartient à ces BU. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Nombre d'éléments retournés sur cette page | |
| items | Yes | ||
| total | No | Nombre total de résultats côté BoondManager |