Assign a resource to several tasks
rillsoft_resource_usage_setSet one resource's usage across multiple tasks in one undoable call, with per-task values; use quantity 0 to remove assignments.
Instructions
Puts one resource on several tasks at once, or takes it off them, with the single values per task - the page 'Using tasks' of the capacity planning, written through the contract. One call is exactly one undo step for all of them, labelled like the page. quantity 0 removes, as with the five single-task tools. Each entry carries only the fields the page offers for that kind (rillsoft_resource_usage_list documents them); a field that belongs to another kind, or one the page merely displays such as free, is refused by name. Every check runs before the change: a single unknown UUID leaves the project untouched and creates no undo step. team is not part of this contract - assigning a team to a task belongs to the Standard edition alone; read it through rillsoft_resource_usage_list and set the preferred team of a project through rillsoft_project_team_preference_set. Beware of the neighbour: rillsoft_task_resource_assignment_fill is the wizard, filling tasks automatically out of their roles and without single values; this one fills exactly the tasks named, with them.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | resource type; team is missing on purpose - see the description | |
| resourceId | Yes | id of the resource from rillsoft_resource_pool_catalog_list | |
| assignments | Yes | one entry per task; each UUID at most once |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | name of the resource | |
| type | Yes | resource type | |
| tasks | Yes | the tasks after the change, in the order of assignments[] | |
| skipped | Yes | skipped tasks with the cause | |
| resourceId | Yes | id of the resource in the resource pool |