Metadata API Developer Guide
jNote: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.
Skill
This type extends the Metadata metadata type and inherits its fullName field.
File Suffix and Directory Location
Skill values are stored in the <developer_name>.skill file in the skills directory.
Version
Skill is available in API version 28.0 and later.
Fields
| Field Name | Field Type | Description |
|---|---|---|
| assignments | SkillAssignments | Specifies how skills are assigned to Chat users. Skills can be assigned to sets of users or sets of profiles. |
| description | string | Specifies the description of the skill. This field is available in API version 38.0 and later. |
| label | string | Specifies the name of the skill. |
| skillType | string | Specifies the skill type, such as language or department, associated with the skill. This field is available in API version 58.0 and later. |
Fields
| Field Name | Field Type | Description |
|---|---|---|
| profiles | SkillProfileAssignments | Specifies the profiles that are associated with a specific skill. |
| users | SkillUserAssignments | Specifies the users that are associated with a specific skill. |
Fields
| Field Name | Field Type | Description |
|---|---|---|
| profile | string | Specifies the custom name of the profile associated with a specific skill. |
Fields
| Field Name | Field Type | Description |
|---|---|---|
| user | string | Specifies the username of the user associated with a specific skill. |
Declarative Metadata Sample Definition
This is a sample of a skill file.
1<?xml version="1.0" encoding="UTF-8"?>
2<Skill xmlns="http://soap.sforce.com/2006/04/metadata">
3 <label>My Skill 1</label>
4 <assignments>
5 <profiles>
6 <profile>LiveAgentOperator</profile>
7 <profile>LiveAgentSupervisor</profile>
8 </profiles>
9 <users>
10 <user>jdoe@acme.com</user>
11 </users>
12 </assignments>
13</Skill>Wildcard Support in the Manifest File
This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.