.. _quick_add_subscriber_class-of-service:

Quick Add Subscriber Class of Service
-------------------------------------

A Class of Service (CoS) allows the user to specify a Calling Search Space (CSS)
for devices and lines, respectively. A CSS, in turn, is mandatory for lines and
devices when adding a Subscriber using Quick Add Subscriber. A Calling Search
Space can be referenced by:

* Site Defaults Doc (SDD) 
* Reference Configuration Template (CFT) referenced in the Quick Add Subscriber
  Group (QAG)
* Admin Portal via the Class of Service field (if exposed)

**Site Defaults Doc**

The Calling Search Space values referenced in the SDD ensure that a Subscriber's 
lines and devices always have a Calling Search Space associated to it. If there are 
no Calling Search Space values referenced in either the QAG or via the Class of 
Service field in the Admin Portal drop-down (see below) the value defaults to the SDD.

**Quick Add Subscriber Group (QAG)**

The Calling Search Space values referenced by a Configuration Template (CFT) in the 
QAG take precedence over the Calling Search Space values referenced in either the 
SDD or the Class of Service via the Admin Portal drop-down (if exposed). See 
:ref:`quick_add_subscriber_group` for details.

**Admin Portal** 

An Administrator can expose a Class of Service drop-down on the QAS page on the 
Admin Portal by editing or cloning the Field Display Policy. 
See :ref:`expose_class_of_service_on_QAS`. The Class of Service drop-down allows 
an Administrator to overwrite the Calling Search Space values in the SDD by 
selecting a custom Class of Service from the drop-down list. The Class of Service,
in turn, contains a custom Calling Search Space for Lines and Devices 
respectively. The options available in the list are the customer level Class of 
Service instances, as created by the relevant administrator.

.. note::

   When exposing the Class of Service drop-down, the Administrator **must** remove 
   the values in the Calling Search Space fields of the CFT's referenced in the QAG, 
   that is, the field must be blank. This is done to make sure that the value in 
   the CFT does not overwrite the custom Calling Search Space value as defined in
   the selected Class of Service.
   
   The CFTs and their target models for which the Calling Search Space name can be 
   made blank to allow the Portal to drive the Calling Search Space values include:
   
   * Line templates (device/cucm/Line)
   * Phone templates (device/cucm/Phone)
   * Jabber device templates (device/cucm/Phone)
   * Remote Destination Profile templates (device/cucm/RemoteDestinationProfile)