Salesforce Docs Portal

Work Capacity Usage Fields

Work Capacity Usages have the following fields.

Required Editions

Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
The Agentforce Field Service and Operations core features, managed package, and mobile app are available in Enterprise, Unlimited, and Developer Editions.
Field Name Description
Available Capacity (in hours) This value is copied from the AvailCapacityHours of the WorkCapacityAvailability object for the service territory on the same date.
Consumption to Limit Ratio (%)

(Time consumed in hours / Limit in hours) * 100

Note the following exceptions.

  • If a limit isn’t defined (-1) the ratio is -1 (even if consumption is 0 or higher).
  • If consumption is 0, and the limit is a number greater than 0, then the ration is 0.
  • If consumption is 0 and the limit is 0, the ration is 100% hard-coded.
  • If consumption is greater than 0 and the limit is 0, the ration is calculated as if the limit = 0.99 in order to get a result that’s higher than 100%.
End Date End date of the time period for which the capacity usage is accumulated.
Field Value Value of Service Appointment Field, the work-specific criteria of the capacity limit.
Field Value Display Name Workstream display name of Field Value.
Limit Override Policy Defines the relaxation behavior that determines the limit override policy for this limit if the limit override policy is set per limit in Field Service Settings. If the limit override policy isn’t set per limit, this value is ignored.
Limitation (in hours) The Limitation (in hours) depends on the Limitation Unit. If the Limitation Unit is Hours the value is copied from LimitationValue in the WorkCapacityLimit object. If the Limitation Unit is Percentage, the percentage is calculated relative to the availability in the WorkCapacityAvailability object.
Limitation (in percentage) If the Limitation Units is Percentage this value is copied from the LimitationValue field of the WorkCapacityLimit object.
Limitation Units Defines whether the limitation for the workstream in the service territory is in hours or as a percentage of all the available hours for all the workstreams for which limitations exist in the service territory on a specific day.
Original Limitation If the limit value is changed after the work capacity usage was created, this parameter is the original value.
Service Appointment Field Work-specific criteria used to define the capacity limit for the workstream.
Service Territory ID of the service territory of the work capacity workstream for which usage is accumulated.
Service Territory Limit Applies this work capacity limit to the entire service territory.
Start Date Start date of the time period for which the capacity usage is accumulated.
Time Consumed (in hours) Time consumed in hours by the workstream in the service territory for the defined period.
Time Consumed (in minutes) Time consumed in minutes by the workstream in the service territory for the defined period.
Time Period Duration for defining the capacity limitation on the workstream in the service territory.
Usage Number A unique identifying number.

See Also