[Index]

Model: view/IniCoolingMgmtVIEW

Cooling & Reservation

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

Cooling Overview

Number cooling allows for the automatic aging of numbers after service delete to prevent immediate reuse of a number. For example, if a user leaves the company, the phone number that was in use can be placed into a cooling period for a pre-configured number of days to prevent a new user from receiving unwanted calls on that number. This feature can be enabled per hierarchy level.

Note

Number cooling is enabled and configured in Global Settings.

During the 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. Once a number has been removed from the cooling period, it will be reintroduced into the pool of available numbers for allocation to a subscriber, phone, device, etc.

A number cooling auto expiry schedule runs daily. This schedule polls the cooling Release Date field on the number inventory list view to determine which numbers have completed their cooling period. These numbers are then returned to the list of available numbers at the specific hierarchy level. For more details refer to "Number Cooling Auto Expiry Schedule" in the Advanced Feature Guide.

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

Enable Cooling


.

Manage Cooling


Apply cooling

  1. Navigate to the required hierarchy level (Provider, Customer or Site) from which you want to add numbers to a cooling period.
  2. On the Cooling & Reservation 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 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 status, and are no longer available for use until they reach either the Release Date or until they are manually removed from cooling.

Remove from cooling

  1. Navigate to the required hierarchy level (Provider, Customer or Site) 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 Cooling & Reservation 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:

Number Cooling Auto Expiry Schedule in the Advanced Configuration Guide

Number Reservation

Reservation Overview

The Reservation feature allows numbers to be reserved for future use. Reserved numbers cannot be allocated to a device or line.

The Cooling & Reservation list view (default menu Number Management > Cooling & Reservation) allows a provider administrator to manually reserve numbers at the selected hierarchy (Provider, Customer or Site) for a specified number of days. While a number is within the Reservation duration (days) period, it is unavailable and cannot be used by a device or line.

If the Reservation duration (days) period is left blank, the numbers remain in the Reserved status. Currently reserved numbers can be unreserved manually, thereby adding them back to the list of available numbers.

Manage Cooling


Reserve numbers

  1. Navigate to the required hierarchy level (Provider, Customer or Site) from which you want to reserve numbers.

  2. On the Cooling & Reservation form, choose Reserve from the Select action drop-down.

  3. In the Reservation duration (days) field, enter the number days for which you want to reserve the numbers.

  4. Enter Reservation Notes for the reserved numbers to describe why the numbers are being reserved. This is displayed in the Reservation notes field on the Number Inventory list.

  5. Set Filters to determine which numbers will be included in the Available box in the Select Numbers area:

  6. Select one or more numbers in the Available box and click Select to move them to the Selected box.

  7. Click Save. The selected number(s) are placed into a Reserved status, and are no longer available for allocation to a subscriber or phone, etc.

    Note

    Individual numbers can also be reserved directly from the Number Inventory list view (default menu Number Management > Number Inventory) by clicking on the required number on the list view and then selecting Reserve Number on the button bar.

Unreserve numbers

  1. Navigate to the required hierarchy level from which you want to unreserve numbers, i.e. add them back into the list of available numbers.
  2. On the Cooling & Reservation form, choose Unreserve 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:
  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 Reserved status, and are available for allocation to a subscriber or phone, etc.

See also:

Model Details: view/IniCoolingMgmtVIEW

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", "Reserve", "Unreserve"]
Reservation/Cooling duration (days)
  • Field Name: add_days
  • Type: String
  • Pattern: ^([1-9][0-9]{0,2})$
  • Format: regex
Reservation Notes
  • Field Name: reservation_notes
  • Type: String
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 reserved numbers
  • Field Name: numbers_filter_show_reserved
  • Type: Boolean
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]
Control field for GUIR async behaviour
  • Field Name: guir_control
  • Type: String