Difference between revisions of "M4 Destination Transformation"
From Kolmisoft Wiki
Jump to navigationJump to search
m (→Examples) |
|||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
=Destination Transformation rules= | =Destination Transformation rules= | ||
Destination Transformation rules are used to manipulate outgoing | Destination Transformation rules are used to manipulate outgoing numbers (cut prefix, add prefix). Rules can be set in [[M2 Termination Points | Termination Points]] or [[M2 Origination Points | Origination Points]] <u>Destination Transformation</u> input field. There are 3 different Destination Transformation rules: | ||
'''1. Add prefix''' | '''1. Add prefix''' | ||
| Line 9: | Line 9: | ||
'''2. Cut prefix''' | '''2. Cut prefix''' | ||
To cut something from number, write - (minus) character and then what to cut. For example -00 will cut 00 from the beginning of number (only if number starts with 00). | To cut something from a number, write - (minus) character and then what to cut. For example, -00 will cut 00 from the beginning of the number (only if the number starts with 00). | ||
'''3. Replace prefix''' | '''3. Replace prefix''' | ||
To cut something from number and add something else (replace), write - (minus) character followed by what to cut, then + (plus) character and what to add. For example -00+8 will cut 00 from beginning of number and add digit 8 in front (00 will be replaced by 8). | To cut something from the number and add something else (replace), write - (minus) character followed by what to cut, then + (plus) character and what to add. For example, -00+8 will cut 00 from the beginning of the number and add the digit 8 in front (00 will be replaced by 8). | ||
<br><br> | <br><br> | ||
| Line 23: | Line 23: | ||
-A+B|-C+D|-X|Z | -A+B|-C+D|-X|Z | ||
Rules are checked in the order they are written and first matching rule will be applied. If one rule is applied, then other rules will be skipped. This means that some rules do | Rules are checked in the order they are written and the first matching rule will be applied. If one rule is applied, then other rules will be skipped. This means that some rules do not make sense, for example, 00|-6+370 rule will always add 00 in front of the number and the second rule will be skipped.<br> | ||
The number of rules is limited only by the length of input field (255 characters). | The number of rules is limited only by the length of the input field (255 characters). | ||
<br><br> | <br><br> | ||
| Line 34: | Line 34: | ||
| '''Incoming Number''' || '''Destination Transformation''' || '''Outgoing number''' || '''Comment''' | | '''Incoming Number''' || '''Destination Transformation''' || '''Outgoing number''' || '''Comment''' | ||
|- | |- | ||
| | | 86123456789 || + || +86123456789 || add + in front of number | ||
|- | |- | ||
| +86123456789 || -\+ || 86123456789 || cut + in front of number | | +86123456789 || -\+ || 86123456789 || cut + in front of number | ||
| Line 41: | Line 40: | ||
| 86123456789 || 00 || 0086123456789 || simple rule adds 00 in front of number | | 86123456789 || 00 || 0086123456789 || simple rule adds 00 in front of number | ||
|- | |- | ||
| 003706123456789 || -00 || 3706123456789 || if number starts with | | 003706123456789 || -00 || 3706123456789 || if the number starts with digit 00, then cut them | ||
|- | |||
| 03706123456789 || -0+\+ || +3706123456789 || if the number starts with digit 0, then cut 0 and add + | |||
|- | |- | ||
| 86123456789 || -8+370 || 3706123456789 || cut number 8 and add 370. If number does not start with 8, then nothing will be added | | 86123456789 || -8+370 || 3706123456789 || cut number 8 and add 370. If the number does not start with 8, then nothing will be added | ||
|- | |- | ||
| 03706123456789 || <nowiki>-00+370|-0</nowiki> || 3706123456789 || Destination Transformation contains multiple rules but first rule is skipped | | 03706123456789 || <nowiki>-00+370|-0</nowiki> || 3706123456789 || Destination Transformation contains multiple rules but the first rule is skipped because the number starts with 0 and not 00. The second rule is applied and 0 is cut from the number | ||
|- | |- | ||
| 3706123456789 || <nowiki>-00+370|-0|+</nowiki> || +3706123456789 || Destination Transformation contains multiple rules but first and second rules are skipped. | | 3706123456789 || <nowiki>-00+370|-0|+</nowiki> || +3706123456789 || Destination Transformation contains multiple rules but the first and second rules are skipped. The last rule simply adds + to the number | ||
|- | |- | ||
| 86123456789 || <nowiki>-8+370|00</nowiki> || 3706123456789 || Destination Transformation contains multiple rules but first rule is applied and other rules are skipped | | 86123456789 || <nowiki>-8+370|00</nowiki> || 3706123456789 || Destination Transformation contains multiple rules but the first rule is applied and other rules are skipped | ||
|- | |- | ||
| 86123456789 || <nowiki>-8+\+370</nowiki> || +3706123456789 || if number | | 86123456789 || <nowiki>-8+\+370</nowiki> || +3706123456789 || if the number starts with the digit 8, then cut it and add +370. Note that + is escaped by using \ character | ||
|} | |} | ||
| Line 58: | Line 59: | ||
=See also= | =See also= | ||
* [[ | * [[M4 Termination Points]] | ||
* [[ | * [[M4 Origination Points]] | ||
* [[M4 Source Transformation | Source Transformation]] | |||
Latest revision as of 11:07, 29 November 2022
Destination Transformation rules
Destination Transformation rules are used to manipulate outgoing numbers (cut prefix, add prefix). Rules can be set in Termination Points or Origination Points Destination Transformation input field. There are 3 different Destination Transformation rules:
1. Add prefix
To add something to every number, just enter what to add.
2. Cut prefix
To cut something from a number, write - (minus) character and then what to cut. For example, -00 will cut 00 from the beginning of the number (only if the number starts with 00).
3. Replace prefix
To cut something from the number and add something else (replace), write - (minus) character followed by what to cut, then + (plus) character and what to add. For example, -00+8 will cut 00 from the beginning of the number and add the digit 8 in front (00 will be replaced by 8).
Multiple rules
It is possible to define multiple Destination Transformation rules in one single line. It is done by separating rules with | character:
-A+B|-C+D|-X|Z
Rules are checked in the order they are written and the first matching rule will be applied. If one rule is applied, then other rules will be skipped. This means that some rules do not make sense, for example, 00|-6+370 rule will always add 00 in front of the number and the second rule will be skipped.
The number of rules is limited only by the length of the input field (255 characters).
Examples
| Incoming Number | Destination Transformation | Outgoing number | Comment |
| 86123456789 | + | +86123456789 | add + in front of number |
| +86123456789 | -\+ | 86123456789 | cut + in front of number |
| 86123456789 | 00 | 0086123456789 | simple rule adds 00 in front of number |
| 003706123456789 | -00 | 3706123456789 | if the number starts with digit 00, then cut them |
| 03706123456789 | -0+\+ | +3706123456789 | if the number starts with digit 0, then cut 0 and add + |
| 86123456789 | -8+370 | 3706123456789 | cut number 8 and add 370. If the number does not start with 8, then nothing will be added |
| 03706123456789 | -00+370|-0 | 3706123456789 | Destination Transformation contains multiple rules but the first rule is skipped because the number starts with 0 and not 00. The second rule is applied and 0 is cut from the number |
| 3706123456789 | -00+370|-0|+ | +3706123456789 | Destination Transformation contains multiple rules but the first and second rules are skipped. The last rule simply adds + to the number |
| 86123456789 | -8+370|00 | 3706123456789 | Destination Transformation contains multiple rules but the first rule is applied and other rules are skipped |
| 86123456789 | -8+\+370 | +3706123456789 | if the number starts with the digit 8, then cut it and add +370. Note that + is escaped by using \ character |
