AssignmentHoursVarianceAction
Analyses the supplied assignment records to produce high variance and low variance analysis, predicted hours variance, and recommended hour adjustments over a number of weeks. Supply the assignment record IDs in objectIds, and the number of weeks to analyse in numberOfWeeks. Use this action when a user asks how assignments are tracking against their scheduled hours, whether they are trending toward high or low variance from plan, the predicted variance at the current rate, or what hour adjustments are recommended. This action performs the analysis only; it does not retrieve assignment data, so obtain the assignment record IDs from the assignment retrieval action first and pass them in.
| Property | Value |
|---|
| Label | Analyse Assignment Hours Variance |
| Category | — |
| Since | Summer 2026 |
| Read-only | Yes |
| Supports Agents | Yes |
| Supports Flows | No |
| Async Action | No |
| Keywords | forecast, plan vs actual, hours tracking, over-run, under-run |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
objectIds | List<Id> | Object IDs | Salesforce record IDs of the Assignment records to analyse. Pass the IDs returned by the Query Assignments for Specified Records action. | No |
numberOfWeeks | Integer | Number of Weeks | Number of weeks to include in the variance analysis. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
varianceAnalysis | String | Variance Analysis | The variance analysis result for the requested records. | No |
errorMessage | String | Error Message | Error message if the action execution encounters any issues. | No |
| 