Rechercher des ressources
boond_resources_searchSearch and filter internal collaborators in BoondManager using dynamic criteria like skills, availability, location, and organizational scope.
Instructions
Recherche des ressources (collaborateurs internes) dans BoondManager avec filtres serveur.
⚠️ Utilisez les filtres structurés plutôt que la pagination intégrale. Les noms de paramètres ci-dessous sont ceux exacts de l'API BoondManager — toute autre orthographe est silencieusement ignorée.
Cas d'usage courants :
• Mes données / mon équipe / mon agence sans connaître son propre ID : perimeterDynamic: ["data"] (mes ressources), ["managers"] (mes N-1), ["agencies"] (mes agences).
• Équipe d'une personne X : perimeterManagers: [<X_id>] (filtre les ressources dont X est le N+1).
• Mon ID utilisateur : appeler boond_application_current_user puis passer cet ID dans perimeterManagers.
• États / types : resourceStates: [<id>], resourceTypes: [<id>]. IDs entiers issus du dictionnaire (voir boond_application_dictionary avec setting.state.resource ou setting.typeOf.resource). excludeResourceStates / excludeResourceTypes pour exclure.
• Périmètre organisationnel : perimeterAgencies, perimeterPoles, perimeterBusinessUnits (IDs entiers). Combiner avec narrowPerimeter: true pour ET au lieu de OU.
• Compétences / outils : tools: [<toolId>, ...] (OU par défaut ; pour ET: ["#AND#", "1", "2"]). expertiseAreas, activityAreas, languages (format langueId|niveauId).
• Disponibilité / activité : period: "available" + startDate/endDate. Autres valeurs : working, hired, left, employed, birthday, seniority…
• Recherche par nom : keywords: "Dupont" + keywordsType: "lastName" (ou firstName, fullName avec keywords: "Dupont#Jean").
• Géolocalisation : coordinates: "48.85,2.35" (ou location: "Paris") + geoDistance: 50 (km).
Pagination : page (1+), pageSize (1-500). Tri : sort: "lastName" (ou firstName/title/availability/state/updateDate/creationDate) + order: "asc"|"desc".
Returns : liste paginée. Utiliser boond_resources_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 (drapeaux) attachés à la ressource. | |
| 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 | Champ temporel pour filtrer par période. Valeurs courantes: 'available' (disponibilité), 'working' (en mission hors interne), 'workingAll', 'absent', 'idle', 'hired', 'left', 'employed', 'unemployed', 'updated', 'arrival', 'birthday', 'seniority', 'present', 'noAction'/'withActions'/'withoutActions'/'withAbsences'/'withoutAbsences'. À combiner avec `startDate` + `endDate`. | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| shields | No | Niveau de complétude des champs conditionnels. | |
| keywords | No | Mots-clés (par défaut, recherche dans CV + dossier technique). Pour cibler un champ précis, fournir aussi `keywordsType` (ex: lastName, firstName, fullName, emails, title, titleSkills, phones, reference). | |
| location | No | Adresse texte (ville, etc.) pour recherche géographique. À combiner avec `geoDistance`. | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| languages | No | Langues parlées au format `langueId|niveauId` (dictionnaires setting.languageSpoken et setting.languageLevel). Ex: ['anglais|courant']. | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| trainings | No | IDs de formations (dictionnaire setting.training). | |
| coordinates | No | Coordonnées GPS 'latitude,longitude' pour recherche géographique. À combiner avec `geoDistance`. | |
| experiences | No | IDs de niveaux d'expérience (dictionnaire setting.experience). | |
| geoDistance | No | Rayon en km pour la recherche géographique (5-200). Requis si `coordinates` ou `location` est fourni. | |
| keywordsType | No | Champ ciblé par `keywords`. Défaut: 'resumeTd' (CV + dossier technique). Pour 'fullName' utiliser `keywords = 'NOM#PRENOM'`. | |
| activityAreas | No | IDs de secteurs d'activité (dictionnaire setting.activityArea). | |
| mobilityAreas | No | IDs de zones de mobilité (dictionnaire setting.mobilityArea). | |
| resourceTypes | No | IDs de types de ressource (dictionnaire setting.typeOf.resource). | |
| excludeManager | No | Si true, ne retourne que les ressources sans compte manager. | |
| expertiseAreas | No | IDs de domaines d'expertise (dictionnaire setting.expertiseArea). | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| resourceStates | No | IDs d'états de ressource (dictionnaire setting.state.resource 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. | |
| 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 (filtre pour ressources externes). | |
| excludeResourceTypes | No | IDs de types de ressource à EXCLURE. | |
| excludeResourceStates | No | IDs d'états de ressource à EXCLURE. | |
| 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 |