SkillRequirement

Represents a skill that is required to complete a particular task in Field Service and Lightning Scheduler. Skill requirements can be added to work types, work orders, and work order line items in Field Service and Lightning Scheduler. This object is available in API version 38.0 and later. You also can add skill requirements to work items in Omni-Channel skills-based routing using API version 42.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), update(), upsert()

Special Access Rules

If you want to use SkillRequirement for Field Service use cases, then Field Service must be enabled.

If you want to use SkillRequirement only for Omni-Channel skills-based routing use cases, then you don't need Field Service to be enabled.

Fields

Field Name	Details
IsAdditionalSkill	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates that a skill is additional. After a designated timeout period, a skill marked as additional is dropped from Omni-Channel routing. The case is then routed to the best-matched agent even if they don’t have all the skills.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.
RelatedRecordId	Type reference Properties Create, Filter, Group, Sort Description The record that the skill is required for. The related record can be a work order, work order line item, work type, or pending service routing record.
SkillId	Type reference Properties Create, Filter, Group, Sort, Update Description The skill that is required.
SkillLevel	Type double Properties Create, Defaulted on create, Filter, Nillable, Sort, Update Description The level of the skill required. Skill levels can range from zero to 99.99. Depending on your business needs, you might want the skill level to reflect years of experience, certification levels, or license classes.
SkillNumber	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description An auto-generated number identifying the skill requirement.
SkillPriority	Type int Properties Aggregatable, Create, Filter, Group, Nillable, Sort, Update Description For additional skills, specify the order in which skills are dropped if after the specified timeout no agent with that skill is available. Higher priority-value skills are dropped first. Lower priority-value skills, for example 0, are dropped last. Skills with the same priority value are dropped as a group. You can set skill priority using skills-based routing rules or Apex code.

Usage

Skill requirements help dispatchers assign work orders to service resources with the proper expertise. You can still assign a work order, work order line item, or related service appointment to a service resource that does not possess the specified skills, so skill requirements serve more as a suggestion than a rule.

If you’re using the Field Service managed package, use matching rules to ensure that appointments are only assigned to service resources who possess the skills listed on the parent work order.

Note

If many of your work orders require the same skills, add skill requirements to work types to save time and keep your processes consistent. When you add a skill requirement to a work type, work orders and work order line items that use that type automatically inherit the skill requirement. For example, if all annual maintenance visits for your Classic Refrigerator product require a Refrigerator Maintenance skill level of at least 50, add that skill requirement to the Annual Maintenance Visit work type. When you create a work order for a customer’s annual fridge maintenance, applying that work type adds the skill requirement as well.

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

SkillRequirementFeed: Feed tracking is available for the object.
SkillRequirementHistory: History is available for tracked fields of the object.

Object Reference for Salesforce and Lightning Platform