[Index]

Model: data/HcsEntitlementProfileDAT

Profiles

To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com

Device Groups

A user to whom an entitlement profile is applied is limited to devices in the device groups assigned in the entitlement profile. Adding a Phone to a user in Subscriber Management fails if the added Phone is not in a device group assigned to the entitlement profile applied to the user.

Device Limits

A user to whom an entitlement profile is applied is subject to the following device limits set in the entitlement profile:

Adding a Phone to a user in Subscriber Management fails if the total number of devices limit or the total number of devices in a device group limit is exceeded.

Transaction Log

The transaction log messages contain detailed information that can be used to determine what entitlement profile limitation caused an action to fail.

Service Levels

The table describes the impact on 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
  When this check box is selected, this entitlement
Default Profile 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.
Conferencing Adding or assigning Conferencing feature to the subscriber fails if this field is enabled. For an existing subscriber if you enable Conferencing and an entitlement profile with Conferencing 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

Entitlement Profiles are used to define the services and devices a user is entitled to.

Assign an entitlement profile to a user when you:

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.

Prerequisites:

Note

The animation shows how to create an entitlement catalog and an entitlement profile. An entitlement catalog must exist at or above the hierarchy level at which you want to create the entitlement profile.

To create an entitlement profile:

  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 the Plus sign (+) adjacent 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 Field Descriptions

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.
Conferencing Select this check box to add conferencing services to the profile.
Collaboration Select this check box to add collaboration services to the profile.
Contact Center Select this check box to add the Contact Center service to the profile.
FMC Adds Fixed Mobile Convergence (FMC) 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: data/HcsEntitlementProfileDAT

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
Conferencing
  • Field Name: conferencing
  • Type: Boolean
Collaboration
  • Field Name: collaboration
  • Type: Boolean
Contact Center
  • Field Name: contact_center
  • Type: Boolean
Fixed Mobile Convergence
  • Field Name: fmc
  • 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