OmniSupervisorConfig | Metadata API Developer Guide

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Parent Type

This type extends the Metadata metadata type and inherits its fullName field.

File Suffix and Directory Location

OmniSupervisorConfig components have the suffix .omniSupervisorConfig and are stored in the omniSupervisorConfigs folder.

Version

OmniSupervisorConfig components are available in API version 57.0 and later.

Special Access Rules

To access this type, Omni-Channel must be enabled.

Fields

Field Name	Description
isTimelineHidden	Field Type boolean Description Required. If set to `true`, hides the agent timeline from the supervisors assigned to this supervisor configuration. The default value is `false`.
masterLabel	Field Type string Description Required. A unique label for the supervisor configuration. The name must begin with a letter and can contain alphanumeric characters and underscores. It can’t contain spaces, two consecutive underscores, or end with an underscore. The name appears as Omni Supervisor Configuration Name in the UI.
omniSupervisorConfigAction	Field Type OmniSupervisorConfigAction[] Description Represents the actions available to the supervisors of this Omni-Channel supervisor configuration.
omniSupervisorConfigGroup	Field Type OmniSupervisorConfigGroup[] Description Represents the group of agents who are visible to the supervisors of an Omni-Channel supervisor configuration. The group, if visible, appears in the Agents tab of Omni Supervisor.
omniSupervisorConfigProfile	Field Type OmniSupervisorConfigProfile[] Description Represents the supervisor profiles to which an Omni-Channel supervisor configuration applies. User-level configurations override profile-level configurations.
omniSupervisorConfigQueue	Field Type OmniSupervisorConfigQueue[] Description Represents the queues that are visible to the supervisors of an Omni-Channel supervisor configuration. The queue, if visible, appears in the Queues Backlog and Assigned Work tabs of Omni Supervisor.
omniSupervisorConfigSkill	Field Type OmniSupervisorConfigSkill[] Description Represents the skills that are visible to the supervisors of an Omni-Channel supervisor configuration. These skills, if visible, appear in the Skills Backlog tab of Omni Supervisor.
skillVisibility	Field Type OmniSuperSkillVisibilityType (enumeration of type string) Description Determines which work items based on skills are visible to the supervisors assigned to this supervisor configuration. Values are: `AllSkills` `AnySkill`

OmniSupervisorConfigAction

Represents an action and associated tab, custom flow, and display order for supervisor actions in this configuration.

Field Name	Description
actionName	Field Type OmniSupervisorActionName (enumeration of type string) Description Required. An action that a supervisor can perform. Values are: `AWSDashboard` `AssignLearning` `ChangeQueues` `ChangeSkills` `CustomAction` `ManageQueues`
actionTab	Field Type OmniSupervisorActionTab (enumeration of type string) Description Required. The tab where the action appears. Values are: `AgentDetails` `AllAgents` `AssignedWork` `AssignedWorkDetails` `QueueDetails` `QueuesBacklog` `SkillDetails` `SkillsBacklog`
customActionFlow	Field Type string Description A flow that performs a custom action.
displayOrder	Field Type int Description Required. The order in which the action is displayed.

OmniSupervisorConfigGroup

Represents the group of agents for the supervisors in this configuration.

Field Name	Description
group	Field Type string Description Required. The name of the group of agents.

OmniSupervisorConfigProfile

Represents a profile for the supervisors in this configuration.

Field Name	Description
profile	Field Type string Description Required. The profile name.

OmniSupervisorConfigQueue

Represents a queue that’s visible to the supervisors in this configuration.

Field Name	Description
queue	Field Type string Description Required. The queue name.

OmniSupervisorConfigSkill

Represents a skill that’s visible to supervisors in this configuration.

Field Name	Description
skill	Field Type string Description Required. The skill name.

Declarative Metadata Sample Definition

The following is an example of a OmniSupervisorConfig component.

1<?xml version="1.0" encoding="UTF-8"?>
2<OmniSupervisorConfig xmlns="http://soap.sforce.com/2006/04/metadata">
3    <isTimelineHidden>true</isTimelineHidden>
4    <masterLabel>Supervisor Config</masterLabel>
5    <skillVisibility>AllSkills</skillVisibility>
6    <omniSupervisorConfigAction>
7        <actionName>ChangeQueues</actionName>
8        <actionTab>AllAgents</actionTab>
9        <displayOrder>0</displayOrder>
10    </omniSupervisorConfigAction>
11    <omniSupervisorConfigGroup>
12        <group>Agent_Group</group>
13    </omniSupervisorConfigGroup>
14    <omniSupervisorConfigProfile>
15        <profile>contractmanager</profile>
16    </omniSupervisorConfigProfile>
17    <omniSupervisorConfigQueue>
18        <queue>CaseQueue</queue>
19    </omniSupervisorConfigQueue>
20    <omniSupervisorConfigSkill>
21        <skill>English</skill>
22    </omniSupervisorConfigSkill>
23</OmniSupervisorConfig>

The following is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>*</members>
5        <name>OmniSupervisorConfig</name>
6    </types>
7    <version>57.0</version>
8</Package>

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.