MOR Localization

From Kolmisoft Wiki
Jump to navigationJump to search

Description



Localization transforms received number to E.164 format number.


The main idea of localization is: No matter how the user dials the number (destination), when localized it should be in E.164 format.

Localization has nothing in common with the numbers you send to providers. It operates with numbers received from the caller.


Depending on the device's physical location, it is often important to allow users to dial numbers in different formats to reach a destination. For this purpose, each device has a field called Location, which describes the device's physical location and defines rules for how the device can dial a destination. In other words, each device IS in (or belongs to) some Location where specific dialing rules apply.

Location describes where a caller IS - not where he is calling to!

By default, a device has the location 'Global'. Global rules apply to ALL devices. If a device belongs to some other location and the dialed destination has some rule for this destination, then global rules are not activated – they have a lower priority in location rules.

You can access Localization settings in SETTINGS –> Billing –> Functions –> Localization.

In the main window, you can see the available Locations:

Localization1.png

At first, there is only the Global location. You can't delete this location. It's the default for all devices.

You can add a new Location by entering this Location's name in the field at the bottom of the table:

Localization2.png

and clicking Add.png:

Localization3.png



Clone

Additionally, you can make a copy of your current Localization rules by clicking the copy icon:

Localization copy function.png



Rules

In the Rules column, click the Rules icon to access the Location's rules:

Editbutton.png

Localization rules.png

Destination Rules – Changes Destination number.

CallerID Rules – Changes source number.

Combined Rules – Change Destination number and Source number. Please note that both Destination and Source cells must be matched to apply Combined Rules. Special symbols * and # do not work in combined rules.

Priority of rules that are applied first:

  • 1) CallerID Rules
  • 2) Combined Rules
  • 3) Destination Rules


Note that if the match is found in "Combined Rules", "Destination Rules" are skipped entirely.



Removing or adding a prefix

To remove a prefix from the dialed number (destination), add a Destination Rule: set Cut to the prefix you want to remove and Add to the replacement (if any). You do not need to change the call's owner.


To remove a prefix from the caller ID (source), use a CallerID Rule with Cut and Add in the same way.


The Change Call's owner, Route to DID, Change CallerID Name, Change User LCR to this LCR, and Change User Tariff to this Tariff fields are optional; use them only when you need that specific behaviour. They are not required to remove or add a prefix – only Cut and Add are needed for that.



Rule fields

The following settings should be explained for rules:

  • Name – just for informational purposes.
  • Cut – what prefix should be cut from the number.
  • Add – what prefix should be added to the number.
  • Min Len – the minimum length of the number to which the rule is being applied.
  • Max Len – the maximum length of the number to which the rule is being applied.
  • Change User Tariff to this Tariff – optional; which Tariff to apply when this rule is applied. Used in special cases, for example here. Leave empty in most cases; not required to remove or add a prefix.
  • Change User LCR to this LCR – optional; which LCR to apply when this rule is applied. Used in special cases, for example here. Leave empty in most cases; not required to remove or add a prefix.
  • Route to DID – optional; allows routing calls to DID according to localization rules. Not required to remove or add a prefix.
  • Change CallerID Name – optional; changes the caller ID name when this rule is applied. Not required to remove or add a prefix.
  • Change Call's owner – optional; changes the owner of the call depending on the incoming tech prefix. Use only when you need to route the call to a specific user; no prefix is required to remove or add.
  • Enter edit mode - lets you change all rules at one time.

When you have entered all the necessary values (Cut or Add can be left empty), click Add.png.

For example:

  • The normal Lithuania MOB prefix is 3706.
  • The user's device is located in Vilnius, Lithuania (displayed as "Lithuania Vilnius").
  • By current Lithuanian regulations, the local customer can dial 9-digit numbers starting with 86 to reach Mobile subscribers.

To describe this situation, we create the following rule:

Localization 5 2.png

Rules can be enabled or disabled by clicking the Check.png icon or Cross.png in the Enabled? column.

  • Edit.png- This icon allows you to edit the details of the rule.
  • Cross.png- This icon allows you to delete the rule.

Now, in the main Localization window:

Localization6.png

click on View.png in the Devices column to access Devices in Global Location:

Localization7.png

Here, all Devices with a selected location are listed. Choose other locations for the selected Device and click on Check.png icon to activate this change. The device will be assigned to the selected Location.

Localization8.png

NOTE: It's possible to change a device's Location in the Device settings (SETTINGS –> Users –> Devices).

Now our device belongs to Location "Lithuania Vilnius". And if we dial a mobile number in the Lithuanian format, for example, 863042439, MOR cuts 86 (leaving 3042439) and adds 3706. The result is 37063042439, which is E.164 compatible and can be billed correctly by MOR.

NOTE: Make sure that after localization, your number is always E.164 compatible. Call Tracing can help you do this.

NOTE: You cannot delete a rule if it is assigned to a device.



Special cases



Cut everything till Hash

With rule Cut: *# it is possible to cut everything till # (# included) in the dialed destination:

Loc cut till hash 2.png

For example:

  • Dialed number: 1aaaaaaaaa#37063042439
  • After Localization: 37063042439

Please note that if the dialed number is #37063042439, the call will not go through, because MOR rejects destinations with # in front of it.

This function can be used in fancy MNP (Mobile Number Portability) schemes and perhaps elsewhere.


NOTE: The Add value still can be used to add any value after Cut is used on the Destination.



Cut any digits after a specific prefix

Works only with Destination and Combined rules.

Cut pattern accepts "x" which indicates any digit:

Cut: 12xxx
will cut first 5 digits from the number which starts with digits "12".


If there are two rules like

Cut: 12xxx

Cut: 1234x

and a number

12345

then the rule Cut: 1234x will be selected because it matches most of the digits exactly.


Example1:

If we have a rule

Cut: 12xxx

Add: 99

Then all the following dialled numbers

1200012345

1257812345

1298712345

will be modified to

9912345


Example2:

If we have a rule Cut: 123xxx78

Add: 78

Then all numbers starting from 12300078 till 12399978 will be localised to start with 78



Change LCR/Tariff when CallerID is empty



This is an optional feature for special cases (e.g. applying a different LCR or Tariff when the caller ID is missing).

To change LCR/Tariff when CallerID is empty, set the following in Source Localization:

Cut: *
Min Len: 0
Max Len: 0

and then choose the LCR/Tariff you want to set for calls without CallerID.



Reseller localizations

The reseller is not using the admin's global localization rules. Instead, he can now copy the rules and modify them to suit his needs. All newly created resellers have those global rules copied automatically from the admin. This feature can be disabled by the admin in Reseller Settings.

Copy rules.png

IMPORTANT: Fields "Change User Tariff to this Tariff" and "Change User LCR to this LCR" will not be copied.

"Default location" does not act as "Global location" on the reseller's account. Only the rules set in the device's settings will be applied.

Route to DID



This is an optional feature. Admin and Reseller PRO users can route calls to a DID according to localization rules.

Localization9.png

Start typing the DID number, and you will see all the DIDs that start with that number. If the DID you need is not there, enter more digits - only the first 20 DIDs starting with that number are shown.



Change owner of call depending on incoming prefix



This is an optional feature for routing the call to a specific user based on the incoming tech prefix.

It is now possible to change the call owner based on the incoming tech prefix.

  • Open the localization menu to find the "Change Call's Owner" field.

Localization8 5.png

  • Enter the incoming prefix that needs to be cut in the "Cut" section.
  • Afterwards, choose a user from the drop-down list and the device to which the call should be assigned.

Change owner2.png

  • This feature is also available for resellers.
  • Admin can assign the call to ANY user on the system (even to those that do not belong to the admin).



See also