Dialplan
1. Description
The page is intended for creating a Dialplan. It is designed to describe dialing rules - which Flow should be executed when dialing a number. The position that determines the order of the check is also important.
It consists of the following elements:
Creation tool (Fig.1(1));
Search field (Fig.1(2));
Refresh button (Fig.1(3));
Registry (Fig.1(4));
Pagination (Fig.1(5)).
Fig. 1. Dialplan page
1.1. Creation tool
Use the Add button (Fig.1(1)) to create a new object. Access to the General tab opens after clicking. You can open tabs for an existing Dialplan through the entries editing tool (see paragraph 1.4.8).
1.2. Search field
The search is performed on the Name column.
1.3. Refresh button
1.4. Registry
The registry is a list of entries of existing objects in this section, each of which consists of a set of fields:
Checkbox;
Name;
Destination number;
Flow schema;
State;
Position;
Draggable tool;
Editing tool;
Removal tool.
If there is no entry on the page, then an additional Add button is displayed in the register, the functionality of which duplicates the Add button in paragraph 1.1.
1.4.1. Checkbox
Fig. 2. Confirm deletion modal window
1.4.2. Name
The name of the Dialplan is displayed here.
1.4.3. Destination number
This is a regular expression for the dialed phone number.
Consider an example:
^\+?3?8?(0[679]3\d{7})$
This regular expression describes the codes of the Ukrainian mobile operator lifecell.
This operator has three codes: 63, 73, and 93. Users can dial telephone numbers both in the international format +38063ххххххх, in the national format 063ххххххх, and the outdated format: 8063ххххххх.
With the above expression, we close all dialing possibilities.
Let's consider in more detail:
^
- the beginning of the regular expression. This is a required character!\+
- further check for the presence of+
, since this is a service character, we escape it with\
?
- the question mark means optional. That is, the presence of+
in the number is not obligatory;3?
- number 3, the presence is optional;8?
- number 8, the presence is optional;(
- the beginning of the match block. Everything that will be in parentheses goes into service variables and can be used in call routing;0
- the obligatory presence of the number 0;[679]
- one digit from those entered in [ ]. That is either 6, 7, or 9;3
- the obligatory presence of the number 3;\d
- this sign indicates the presence of any digit. The same if it were written in the following way:[0-9]
- any one digit from the range from 0 to 9;{7}
- the number in{ }
indicates the number of repetitions of the previous expression. This means that there should be 7 of any digits in total;)
- the ending of the match block;$
- the end of the regular expression. This is a required character!
The expression may also contain the following symbols:
|
- Or operator. For example,7|8
- can be 8 or 7 - one digit out of two;{10,12}
- the number of repetitions of the previous expression. But, in this case, our range is at least 10 and not more than 12.
If an incorrect regular expression is entered in the field, such as unclosed brackets, the field will be highlighted in red, and the Save button will be inactive.
More information about regular expressions can be found here.
1.4.4. Flow schema
Displays the name of the Flow schema that is used. Clicking on the scheme's name opens this Flow schema's General tab or the graphic constructor.
1.4.5. State
The switch that is responsible for enabling and disabling the Dialplan rule, according to the switch position:
- the rule is enabled;
- the rule is disabled.
1.4.6. Position
The position number where the Dialplan rule resides.
In setting up Dialplan rules, the sequence is essential since, during an outgoing call, the number is checked for each rule from top to bottom.
1.4.7. Draggable tool
You can move the entry to another position by pressing and holding the icon. After changing the position in the entries register, the number in the Position column also varies.
1.4.8. Editing tool
1.4.9. Removal tool
Fig. 3. Confirm deletion modal window
1.5. Pagination
2. Opportunities
2.1. Create a new Dialplan
Goal | Create a new Dialplan |
---|---|
Preconditions | |
Steps
|
|
Result | Data saved. Dialplan is created |
2.2. Delete a Dialplan
Goal | Delete a Dialplan |
---|---|
Preconditions |
|
Steps
|
|
Result | The modal window closes. The Dialplan is removed. |
2.3. Delete several Dialplans
Goal | Delete several Dialplans |
---|---|
Preconditions |
|
Steps
|
|
Result | The modal window closes. Dialplans are removed. |
2.4. Edit a Dialplan
Goal | Edit a Dialplan |
---|---|
Preconditions |
|
Steps
|
|
Result | Data saved. |
2.5. Enable/disable Dialplan
Goal | Enable a Dialplan |
---|---|
Preconditions |
|
Steps
|
|
Result | The Dialplan is enabled/disabled |
- 1 1. Description
- 1.1 1.1. Creation tool
- 1.2 1.2. Search field
- 1.3 1.3. Refresh button
- 1.4 1.4. Registry
- 1.4.1 1.4.1. Checkbox
- 1.4.2 1.4.2. Name
- 1.4.3 1.4.3. Destination number
- 1.4.4 1.4.4. Flow schema
- 1.4.5 1.4.5. State
- 1.4.6 1.4.6. Position
- 1.4.7 1.4.7. Draggable tool
- 1.4.8 1.4.8. Editing tool
- 1.4.9 1.4.9. Removal tool
- 1.5 1.5. Pagination
- 2 2. Opportunities