Reporting ressources
boond_reporting_resourcesRead-onlyIdempotent
Retrieve resource reporting data on occupancy, revenue, and productivity. Filter by perimeter, period, resource types, states, and linked entities to generate customized reports.
Instructions
Reporting des ressources (taux d'occupation, CA, productivité...).
Filtres clés : périmètre (perimeterDynamic/perimeterManagers/perimeterAgencies...), période (period, periodDynamic), reportingCategory, resourceTypes, resourceStates, period, resources/projects/contacts/companies, maxResources. Les états/types sont des IDs entiers issus de boond_application_dictionary. Sans filtre de périmètre, le reporting porte sur tout le périmètre autorisé.
Returns: Données de reporting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Numéro de page (défaut: 1, max: 100) | |
| period | No | Découpage temporel : 'onePeriod' (unique, entre startDate/endDate), 'dynamicPeriod' (selon periodDynamic), 'monthly' (6 mois depuis startDate), 'quarterly', 'semiAnnual', 'annual'. La synthèse accepte aussi 'weekly'. | |
| endDate | No | Date de fin (YYYY-MM-DD). | |
| contacts | No | Filtrer sur ces IDs de contacts. | |
| keywords | No | Mots-clés. | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| projects | No | Filtrer sur ces IDs de projets. | |
| useCache | No | Cache de reporting : 'withCache' (valeurs mises en cache) ou 'withoutCache' (recalcul, défaut). | |
| companies | No | Filtrer sur ces IDs de sociétés. | |
| resources | No | Filtrer sur ces IDs de ressources. | |
| startDate | No | Date de début (YYYY-MM-DD). | |
| scorecards | No | IDs des scorecards (indicateurs) à retourner. | |
| maxResources | No | Nombre de ressources par page (1-10, défaut 1). Le nombre de résultats = ressources × indicateurs. | |
| periodDynamic | No | Période dynamique relative à aujourd'hui (avec period='dynamicPeriod') : today, thisWeek, thisMonth, thisTrimester, thisSemester, thisYear, thisFiscalYear, yesterday, lastWeek, lastMonth, lastTrimester, lastSemester, lastYear, lastFiscalYear, tomorrow, nextWeek, nextMonth, nextTrimester, nextSemester, nextYear, nextFiscalYear, lastCustomPeriod, nextCustomPeriod. | |
| resourceTypes | No | IDs de types de ressources (dictionnaire setting.typeOf.resource). | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| resourceStates | No | IDs d'états de ressources (dictionnaire setting.state.resource). | |
| 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. | |
| reportingCategory | No | Vue : 'showByResources' (défaut, sans returnedPeriod) ou 'showByPeriods' (returnedPeriod requis). | |
| perimeterBusinessUnits | No | IDs de business units. Conserve les entités dont le responsable appartient à ces BU. | |
| periodDynamicParameters | No | Paramètres de la période personnalisée (utilisé avec periodDynamic=lastCustomPeriod/nextCustomPeriod). |