Rechercher des projets
boond_projects_searchSearch projects in BoondManager using structured filters such as manager, company, state, type, and date. Returns a paginated list matching your criteria.
Instructions
Recherche des projets / missions 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 projets sans connaître son propre ID : perimeterDynamic: ["data"]. Pour "projets de X" : perimeterManagers: [<X_id>].
• États / types : projectStates: [<id>] (dictionnaire setting.state.project), projectTypes: [<id>] (setting.typeOf.project). IDs entiers.
• Société cliente : companies: [<companyId>] (filtre les projets rattachés à ces sociétés).
• Lié à un contact / opportunité / contrat / ressource / produit : utiliser keywords avec préfixes — "PRJ<id>" (projet), "CSOC<id>" (société), "CCON<id>" (contact), "AO<id>" (opportunité), "CTR<id>" (contrat), "COMP<id>" (ressource), "PROD<id>" (produit), "MIS<id>" (livraison).
• Périmètre orga : perimeterAgencies, perimeterPoles, perimeterBusinessUnits. narrowPerimeter: true pour ET.
• Métier : activityAreas, expertiseAreas, flags (tags).
• Période : period: "running" (en cours), "created", "started", "stopped", "closed", "updated", "hasAdditionalDataOrPurchase" + startDate/endDate. Ex: projets en cours en 2026 → period: "running", startDate: "2026-01-01", endDate: "2026-12-31".
Pagination : page, pageSize (max 500). Tri : sort: "startDate"|"endDate"|"reference"|"company.name"|"mainManager.lastName" + order.
Returns : liste paginée des projets. Utiliser boond_projects_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) | |
| 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 : 'running' (en cours), 'created', 'started', 'stopped', 'closed', 'updated', 'hasAdditionalDataOrPurchase'. À combiner avec `startDate` + `endDate`. | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| keywords | No | Mots-clés. Pour cibler par ID préfixé : 'PRJnnn' (projet), 'CSOCnnn' (société), 'CCONnnn' (contact), 'AOnnn' (opportunité), 'COMPnnn' (ressource), 'CTRnnn' (contrat). | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| companies | No | IDs de sociétés clientes : projets rattachés à ces sociétés. | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| projectTypes | No | IDs de types de projet (dictionnaire setting.typeOf.project). | |
| activityAreas | No | IDs de secteurs d'activité. | |
| projectStates | No | IDs d'états de projet (dictionnaire setting.state.project). | |
| expertiseAreas | No | IDs de domaines d'expertise. | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| 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. | |
| 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 |