[Index]

Model: view/IniCoolingMgmtVIEW

Cooling

Pre-requisites

The Number Cooling feature must be enabled and configured in Global Settings before it will work.

Overview

If this feature is enabled, when a directory number used by a device or service, e.g. phone, device profile, hunt group pilot etc. becomes unused and available by either unassigning it from the device or service or by deleting the device or service, then the number is automatically moved into a cooling period and marked as unavailable for a pre-configured number of days.

During this cooling period, the number cannot be reused until either the cooling period has elapsed, or until a provider administrator has manually removed the number from the cooling period. Only once the number has been removed from the cooling period will the directory number be reintroduced into the pool of available numbers for allocation to a subscriber, phone, device etc.

The Number Cooling form allows a provider administrator to manually add directory numbers to a cooling period (thereby removing them from the list of available numbers), or to manually remove directory numbers from a cooling period (thereby adding them back to the list of available numbers).

Apply cooling

  1. Navigate to the required hierarchy level (Provider or Customer) from which you want to add numbers to a cooling period.
  2. On the Number Cooling form, choose Apply cooling from the Select Action drop-down.
  3. Enter an optional cooling duration in days (max = 999) to apply to the selected numbers. This setting overrides the value set in their global settings. If this field is left blank, then the cooling duration set in the global settings for each number will apply.
  4. Set Filters to determine which numbers will be included in the Available box in the Select Numbers area, these include:
  5. Select one or more numbers in the Available box and click Select to move them to the Selected box. Note that the Available box will not display numbers that are used, i.e. it will only display numbers that are unused and available.
  6. Click Save. The selected number/s are placed into a cooling period and will no longer be available for use until the cooling period has elapsed or until they have been manually removed from cooling.

Remove from cooling

  1. Navigate to the required hierarchy level (Provider or Customer) from which you want to remove numbers from a cooling period, i.e. add them back into the list of available numbers.
  2. On the Number Cooling form, choose Remove from cooling from the Select Action drop-down.
  3. Set Filters to determine which numbers will be included in the Available box in the Select Numbers area, these include:
  4. Select one or more numbers in the Available box and click Select to move them to the Selected box.
  5. Click Save. The selected number/s are removed from the cooling period and are available for allocation to a subscriber or phone, etc.

See also:

Model Details

Title Description Details
For the above internal number, do: * Default: move_to_cooling
  • Field Name: view_action
  • Type: String
  • Default: move_to_cooling
  • Choices: ["Apply cooling", "Remove from cooling"]
Select new cooling duration (days)
  • Field Name: apply_cooling_days
  • Type: String
  • Pattern: ^([1-9][0-9]{0,2})$
  • Format: regex
Show available numbers Default: True
  • Field Name: numbers_filter_show_available
  • Type: Boolean
  • Default: True
Show numbers in cooling Default: True
  • Field Name: numbers_filter_show_incooling
  • Type: Boolean
  • Default: True
Show numbers at/below hierarchy
  • Field Name: numbers_filter_hierarchy
  • Type: String
Show numbers that contain
  • Field Name: numbers_filter_contains
  • Type: String
Show numbers expiring from cooling within the next (days)
  • Field Name: numbers_filter_expires_within
  • Type: String
  • Pattern: ^([1-9][0-9]{0,2})$
  • Format: regex
Select Number
  • Field Name: numbers.[n]
  • Type: Array
  • Cardinality: [1..n]
API reference for view/IniCoolingMgmtVIEW