.. _global-settings:

Global Settings
---------------

.. _19.2.1|VOSS-94:
.. _19.3.1|VOSS-577:
.. _20.1.1|EKB-4053:
.. _20.1.1|VOSS-551|EKB-6537:


Provider administrators and higher have access to a **Global Settings** customization
menu that allows for the configuration of a number of settings across all hierarchies
or per individual hierarchy.

* On the Admin Portal, the greyed-out value (or value directly under the drop-down)
  is the current setting, either inherited from the hierarchy above the current one
  or as a result of the selected drop-down option - Yes, No (True, False) or Inherit.
* The setting title and description provides a guide to its functionality.


Available Settings
..................

The following settings are available:

* **Number Inventory**

  * **Enforce HCS Dialplan Rules**: 
    
    When enabled, dial plan workflows enforce HCS Rules
    when provisioning Customers, Countries, Site and so on. Default =  **Inherit**.
    If your deployment uses a custom or specific dial plan which does not conform
    to the HCS rules, this setting should be set to **No**.
  * **Include the Number Inventory description in all number drop-downs**:
   
    When the Number Inventory is managed from the **Number Management** menu, descriptions
    can be added to the numbers.
    This setting controls the display where the number is listed on a form drop-down.
    The description will be displayed if the setting is **Yes**.
   
    For example, if you had number `1000` with a description
    of "CEO Internal", then when using Quick Add Subscriber or similar features and
    selecting numbers from a drop-down, you will see an option of ``1000 - CEO Internal``.
 
    Default =  **No**.
  
  * **Enable Number Inventory Cooling**: 

    Controls the reserved state of numbers when a phone, user or service
    is deleted and the number no longer associated with these.
  
    Default = **False** (not enabled).
    
    Choose **Yes** from the drop-down to enable number cooling and keep numbers
    in a reserved state for a duration as set in the **Number Inventory Cooling
    Duration (Days)** field. The number will not appear as available in drop-downs
    until the cooling period has expired.
   
    If the inherited value is set to **True**, number cooling is already enabled.
    
    See "Number Cooling" for more information.
    
  * **Number Inventory Cooling Duration (Days)**: 
   
    Default = 30 days. 
    
    Refer to :ref:`change-inherited-settings` if you want to change the inherited
    setting. 
    

* **Webex Teams**

  * For the **Retain a Webex Teams User when a Subscriber is deleted** and 
    **Send SNMP trap message when the Webex Teams Refresh Token expires** (default
    is **No** which means no message will be sent) drop-downs, the values can be
    inherited or set as required. 
  * For the **Webex Teams Refresh Token expires threshold (in seconds)** drop-down,
    the default (inherited) value is ``172800``. In this case, the value itself can
    be changed, in other words there are no **Yes** or **No** options.
    
    Refer to :ref:`change-inherited-settings` if you want to change the inherited
    setting.    


* **Email**

  * For the **Allow email to be sent to user after Quick Add Subscriber**: controls if an
    email needs to be sent to a user when added via Quick Add Subscriber. By default the setting
    is inherited from the hierarchy level directly above the current one. When set to **Yes**
    at a hierarchy and a SMTP server is *also* set up for a hierarchy on the **Device Management** menu,
    a check box is available on the **Quick Add Subscriber** input form to send an email to
    the subscriber. See: :ref:`SMTP-server`.


* **Phones**

  * For **Delete existing Unassigned Phone when re-adding an identical Phone**: by default (inherited),
    the setting is **False**. This means that if a Phone with the same Name and Product Type is re-added
    to the system during for example a QuickAddSubscriber bulk load or re-add of a Subscriber during a
    Subscriber update, it will *not* by default be overwritten.

* **User**

  When a user is either synced into or added manually on VOSS-4-UC, these settings apply by default.
  The settings can however be modified when adding a user from the **User Management** menu.

  * **User Default Auth Method**: the authentication method to use by default when
    a user is synced in or added manually. **Local** is default (inherited).
    
    
    .. raw:: latex
    
       For details on these authentication methods, refer to the "User Authentication Methods" topic in the Core Feature Guide.
       
    .. raw:: html
    
       <p>For details on these authentication methods, refer to <a href="concepts-user-authentication-methods.html">User Authentication Methods</a>.</p>


.. _change-inherited-settings:

How to Change Inherited Settings
................................

* For inherited values that are numeric, e.g. "**Number Inventory Cooling Duration (Days)**"
  or "**Webex Teams Refresh Token expires threshold (in seconds)**", overwrite the word
  "Inherit" with the required value, e.g. 45 and click **Save**. If the inherited
  value has already been overwritten, e.g. it is already 45, then overwrite this
  with the new value.
* For inherited values that are **Yes/No** (**True/False**) use the drop-down
  selection (Yes, No or Inherit). This may change the current value.