[Index]

Model: data/HcsEntitlementProfileDAT

Profiles

Service Levels

The following table shows the impact to a user when a service is disabled in the entitlement profile applied to the user.

Note

An entitlement profile can be explicitly assigned to a user, or implicitly applied if an entitlement profile is designated as the default entitlement profile in a hierarchy node at or above the user's hierarchy node.

Service disabled Result
Default Profile When this check box is selected, this entitlement profile will be the default entitlement profile displayed in the Quick Add Subscriber Entitlement Profile drop-down.
Voice Adding a phone to a user in Subscriber Management fails. For an existing user with a phone with this profile (where voice is disabled), the update of the user from "Subscriber Management" fails, unless the existing phones for the user are dissociated.
Voicemail Adding Voicemail to a user in Subscriber Management fails. For an existing user with Voicemail, updates in Subscriber Management fail after an entitlement profile with Voicemail disabled is applied to the user.
Presence Enabling Cisco Unified Communications Manager IM and Presence Service for a user in Subscriber Management fails. For an existing user with Cisco Unified Communications Manager IM and Presence Service enabled, updates in Subscriber Management fail after an entitlement profile with Presence disabled is applied to the user.
Extension Mobility Adding Extension Mobility to a user in Subscriber Management fails. For an existing user with Extension Mobility, updates in Subscriber Management fail after an entitlement profile with Extension Mobility disabled is applied to the user.
Single Number Reach For a new user, adding Single Number Reach in Subscriber Management fails, and for an existing user with Enable Mobility checked, adding Single Number Reach fails after an entitlement profile with Single Number Reach disabled is applied to the user.
WebEx Adding or assigning WebEx feature to the subscriber fails if this field is disabled. For an existing subscriber if you enable WebEx and an entitlement profile with "WebEx disabled" is applied, the update operation fails.
CMR Adding or assigning CMR feature to the subscriber fails if this field is disabled. For an existing subscriber if you enable CMR and entitlement profile with "CMR disabled is applied", the update operation fails.
Webex Teams

Webex Teams is not available for a new subscriber if this field is disabled.

If Webex Teams is enabled for an existing subscriber, and an entitlement profile with Webex Teams disabled is applied, the update operation fails.
Contact Center

Contact Center is not available for a new subscriber if this field is disabled.

If Contact Center is enabled for an existing subscriber, and an entitlement profile with Contact Center disabled is applied, the update operation fails.

Create an Entitlement Profile

Before You Begin

Define an Entitlement Catalog at or above the hierarchy node where you create an Entitlement Profile (see Create an Entitlement Catalog).

The Entitlement Catalog restricts the service and devices that can be entitled in the Entitlement Profile. An Entitlement Profile can further restrict services and devices a user is entitled to. However, it cannot expand the services and devices beyond the restrictions defined in the Entitlement Catalog.

Entitlement Profiles are used to define the services and devices a user is entitled to. An Entitlement Profile can be assigned to a user in these situations:

Note

The Maximum Number of Devices and Maximum Number of Devices in a Group are limitations for each individual user, not for all users in the system.

Procedure

See procedure below for clarity if required:

  1. Log in as provider administrator.
  2. Set the hierarchy path to the location where you want to create the Entitlement Profile.
  3. Choose Entitlement > Profiles.
  4. Click Add.
  5. On the Profiles screen, complete at minimum, the mandatory Entitlement Profiles fields.
  6. Click + next to Device Groups to add more device groups to the Entitlement Profile if required.
  7. Click Save.

The Entitlement Profile is defined and can be assigned to users.

Entitlement Profiles Fields

Field Description
Name * Entitlement Profile name. This field is mandatory.
Description An optional description of the entitlement Profile
Default Profile Select this check box to make this Entitlement Profile the default for the hierarchy node. Any previously designated User Entitlement Profile automatically has this check box cleared.
Voice Select this check box to entitle voice services.
Voicemail Select this check box to entitle voicemail services.
Presence Select this check box to entitle presence services.
Extension Mobility Select this check box to entitle Extension Mobility services.
Single Number Reach Select this check box to entitle Single Number Reach service.
WebEx Select this check box to add the WebEx service to the profile.
CMR Select this check box to add Collaboration Meeting Rooms (CMR) service to the profile. Select WebEx service to select CMR.
Webex Teams Select this check box to add the Webex Teams service to the profile.
Contact Center Select this check box to add the Contact Center service to the profile.
Maximum Number of Devices *

Specify the maximum number of devices allowable for the Entitlement Profile. This field is mandatory.

The maximum number cannot exceed the total of the maximums for the entire device group included in the Entitlement Profile.
Device Group * Choose a Device Group to include in the Entitlement Profile. This field is mandatory.
Maximum Number of Devices in Group *

For the selected device group, specify the maximum number of devices allowed. This field is mandatory.

The maximum number for any device group cannot exceed the maximum number of devices for the profile.

HcsEntitlementProfileDAT

Model Details

Title Description Details
Name *
  • Field Name: name
  • Type: String
  • MaxLength: 1024
Description
  • Field Name: description
  • Type: String
  • MaxLength: 1024
Default Profile
  • Field Name: defaultprofile
  • Type: Boolean
Voice
  • Field Name: voice
  • Type: Boolean
Voicemail
  • Field Name: voicemail
  • Type: Boolean
Presence
  • Field Name: presence
  • Type: Boolean
Single Number Reach
  • Field Name: snr
  • Type: Boolean
Extension Mobility
  • Field Name: extension_mobility
  • Type: Boolean
WebEx
  • Field Name: webex
  • Type: Boolean
Webex Teams
  • Field Name: spark
  • Type: Boolean
Contact Center
  • Field Name: contact_center
  • Type: Boolean
CMR
  • Field Name: cmr
  • Type: Boolean
Maximum Number of Devices *
  • Field Name: num_devices
  • Type: Integer
Device Groups
  • Field Name: device_groups.[n]
  • Type: Array
Device Group *
  • Field Name: device_groups.[n].device_group
  • Type: String
  • Target: data/HcsDeviceGroupDAT
  • Target attr: name
  • MaxLength: 1024
  • Format: uri
Maximum Number of Devices in Group *
  • Field Name: device_groups.[n].num_devices
  • Type: Integer
API reference for data/HcsEntitlementProfileDAT