.. _global-settings:

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

.. _19.2.1|VOSS-94:
.. _19.3.1|VOSS-577:
.. _19.3.2|EKB-4053:


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**

  * **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 (for example, "CEO number"). Default =  **No**.
  
    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**.
  
  * **Enable Number Inventory Cooling**: 
  
    Default = **False** (not enabled).
    
    Choose **Yes** from the drop-down to enable number cooling. 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** 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**: 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 wit
    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.
 
    
 .. _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.