Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Screenshot: Traffic Processing section

 Image RemovedImage Added

Column NameDescriptionIDRules identification numberOrigGeneralPrefixes
Column NameDescription
IDRules Rule's identification number
TypeStageType

Stage of a rule

(the rules are grouped by following stages: Initial, After Client, After Rate, After Routing)

Filters

Depending on rule parameters, a table can display the following scope of details:

Depending on
  • Name of service, the rule is created for
  • Gateway, specified in a rule
  • Tag(s), indicated in a rule
Client
  • rule
parameters, a table can display the following scope of details:
  • Client's name, specified in a rule
  • Client's account, defined in a rule
  • Indicated Code

Depending on rule parameters, a table can display the following scope of details:

  • POSIX regular expression for Src number (Src Match)
  • POSIX regular expression for Dst number (Dst Match)
  • Src Prefixes (Src P Any/Src P Not)
  • Src Prefixes Names (Src PN Any/Src PN Not)
  • Dst Prefixes (Dst P Any/Dst P Not)
  • Dst Prefixes Names (Dst PN Any/Dst PN Not)
Action

Depending on rule parameters, a table can display the following scope of details:

  • Replacement for a matched rule for Src number (Src)
  • Replacement for a matched rule for Dst number (Dst)
  • List of tags added during traffic processing rule execution
UserUser name and time, when a rule was created/edited
OrderSpecified order for rule execution

Screenshot: Orig/Term Rules section

Image Removed

  • Deny plank for blocking rules
  • LNP/MNP db specification with LNP direction and Revert LNP indication (if enabled)
  • Any blocked termination Clients/Accounts from the Routing Blocks section
Notes / Expiry Date / Created By

Depending on rule parameters, a table can display the following scope of details:

  • Origination Client
  • Origination Account
Term

Depending on rule parameters, a table can display the following scope of details:

  • Termination Client
  • Termination Account
CodeSpecify a destination code (use * as a wildcard)Action

You can set up the following Actions for the rule:

  • Allow - allow a current event to proceed. Stop further traffic processing rules within this type of rule;
  • Allow and Continue -allow a current event to proceed. Search for the next traffic rule;
    • Notes, specified in a rule
    • Rule's Expiry date
  • Deny - deny a current event.
  • NotesExtra notes for the rule.Expiration DateDefines the date when the rule expires.User
    • User name and time, when a rule was created/edited
    OrderSpecified order for rule execution

    Functional buttons/icons presented in the section are as follows:

    Button/IconDescription

    Allows creating a new traffic processing rule

    Allows importing a .csv file with a traffic processing rule(s)

    Allows exporting a current list of rules in a .csv format

    Indicates that a rule origin is origination

    Indicates that a rule origin is termination

    Image Removed

    Indicates the Allow action of a rule

    Image Removed

    Indicates the Allow and Continue action of a rule

    Image Removed

    Indicates the Deny action of a rule

    Allows editing existing rules in a section list

    Allows deleting a traffic processing rule from the system

    ...

    Screenshot: New Traffic Processing rule

    Image RemovedImage Added

    MatchAction
    Information blockFieldDescription
    GeneralTypeStageSpecifies at what stage a current translation rule will be applied:
    • Initial - execute this rule before a Client is identified
    • After Client - execute this rule after client identification but before rate identification
    • After Rate - execute this rule after rate identification but before routing
    • After Routing - execute this rule after routing
    Src Code DeckIdentify a code deck that will be used for Src codes or code names filtering
    Dst Code Deck

    Identify a code deck that will be used for Dst codes or code names filtering

    Order

    Sets rules ordering . First matched rule will stop further number translationsthat works within the same rule Stage.

    Panel
    borderColor#ffffb3
    bgColor#ffffb3
    borderWidth2px

    (warning)   Attention

    Note that this field indicates the order of rules execution only within a specified typestage. It means that a rule with the Initial type stage and order 1 will be executed before any other rule of the same type stage with order ≥ 2. However, such rule will be executed prior to a rule with the After Rate type stage and order 0, even though the latter has a higher order, due to the fact that Initial is the 1st on the types stages list.


    Origin

    Specify the event origin:

    • Origination
    • Termination
    CompanySpecify a Reseller for this rule to be executed under. Default - all resellers
    NotesSpecify additional informational information about a rule
    Expiration Expiry DateDefine a date when this rule will expire and will be removed from the system
    Src DeckIdentify a code deck that will be used for Src codes or code names filtering
    Dst DeckIdentify a code deck that will be used for Dst codes or code names filtering
    Filters

    Select the required parameters for a traffic processing rule on the MatchFilters menu. To cancel any filter, click on the delete  sign next to its name.

    You can start a quick search by typing filters' names in the field at the top of the Match Filters menu.

    Panel
    borderColor#ccffcc
    bgColor#ccffcc
    borderWidth2px
    borderStylesolid

    Tip

    If, for instance, the Client filter is empty, it means that this rule will implicate all clients.


    General
    Service IDSelect a target from the drop-down list of all services, presented in the Services section of your JeraSoft Billing
    GatewaySelect a respective VoIP gateway, for which rule is applied, from the drop-down list
    Tags (Any)

    A rule will work if an event has at least one of the tags, specified in this field

    Tags (All)

    A rule will work if an event has all tags, specified in this field

    Tags (Not)

    A rule will work if an event has no tags, specified in this field

    Scr Party ID
    Src (Match)In this field you may indicate POSIX regular expressions syntax, by which a number will be analyzed. If an expression matches the number, the translation will occur in respective settings in the SRC Replace field.
    Src Prefixes (Any)A rule will work if an event has at least one of the Src prefixes (e.g., 010, 810), specified in this field
    Src Prefixes (Not)A rule will work if an event has no Src prefixes (e.g., 010, 810), specified in this field
    Src Prefixes Names (Any)A rule will work if an event has at least one of the Src prefixes names (e.g., vodafone), specified in this field
    Src Prefixes Names (Not)A rule will work if an event has no Src prefixes names (e.g., vodafone), specified in this field
    Dst Party ID
    Dst (Match)In this field, you may indicate POSIX regular expressions syntax (see best practice example below), by which a number will be analyzed. If an expression matches the number, the translation will occur in respective settings in the Dst Replace field.
    Dst Prefixes (Any)A rule will work if an event has at least one of the Dst prefixes (e.g., 010, 810), specified in this field
    Dst Prefixes (Not)A rule will work if an event has no Dst prefixes (e.g., 010, 810), specified in this field
    Dst Prefixes Names (Any)A rule will work if an event has at least one of the Dst prefixes names (e.g., vodafone), specified in this field
    Dst Prefixes Names (Not)A rule will work if an event has no Dst prefixes names (e.g., vodafone), specified in this field
    Client
    Client

    Specify a respective client

    Panel
    borderColor#ffffb3
    bgColor#ffffb3
    borderWidth2px

    (warning)   Attention

    Please be advised that any traffic processing rule can have either the Client or Account field.


    Account Specify a respective account
    Dst CodeSpecify a destination code
    Dst Code NameSpecify a destination code (use * as a wildcard)name
    Src CodeSpecify a source code
    Src Code NameSpecify a source code name
    Parties ID TranslationsType

    Define a type of translation:

    • Src
    • Dst
    Order

    Specify the order of translation

    Tip
    titleTip

    If you need to do multiple translations for the same call flow, it's better to create them all in one rule than to create multiple rules for the same type (time) of translations. That's where ordering would be useful.


    MatchIn this field, you may indicate POSIX regular expressions syntax (see best practice example below), by which a number will be analyzed. If an expression matches the number, the translation will occur in respective settings in the Replace field.
    ReplaceReplacement for a matched rule.
    ActionsMode

    Defines an action that will be executed if a traffic rule matches:

    • Allow - allow a current event to proceed. Stop further traffic processing rules within this type of rule;
    • Allow and Continue -allow a current event to proceed. Search for the next traffic rule;
    • Deny - deny a current event.
    Src ReplaceReplacement for a matched rule. For this field to work, the Scr Match filter must be used in the Match information block.
    Add TagsHere you can add tags that will be added for events matching this rule Dst ReplaceReplacement for a matched rule. For this field to work, the Dst Match filter must be used in the Match information block.
    Set ServiceAllows to change a specified service to another one while processing them
    Add TagsHere you can add tags that will be added for events matching this rule 
    LNP / JurisdictionLNP/MNP

    Define a provider for the LNP/MNP service, which will be dipped for translation

    Panel
    borderColor#ffffb3
    bgColor#ffffb3
    borderWidth2px

    (warning)   Attention

    In the VCS 3.17.0, a new feature regarding TJA database has been added. Starting from this version, while creating a new rule, in the LNP/MNP field, a user can select either tja.ee (Routing Number) or tja.ee (Owner). The difference is as follows:

    • tja.ee (Routing Number) - if a traffic processing rule executes, 372+Original Number will be substituted by 372+Routing Number, specified in the TJA database.
    • tja.ee (Owner) - if a traffic processing rule executes, 372+Original number will remain unchanged. Instead, a Dynamic Tag indicating an owner of the number will be added to the call.

    Please find more about TJA database here.


    Revert LNP

    Allows returning original numbers to vendors after routing:

    • Enabled
    • Disabled
    LNP PartyLNP DirectionDefine, which Party ID(s) (Src, Dst, or both) will be used for LNP dipping. To enable this feature, you need to specify the LNP/MNP field.
    US NANP Processing

    Define if NANP processing will be used for LNP dipping:

    • Enabled
    • Disabled
    Routing BlocksBlock ClientsSpecify, which termination Clients to block for the originator, specified in the Filters block
    Block AccountsSpecify, which termination Accounts to block for the originator, specified in the Filters block


    Panel
    borderColor#ccffcc
    bgColor#ccffcc
    borderWidth2px
    borderStylesolid
    Best Practice Example

    To get a better understanding of how the Src/Dst Match and Src/Dst Replace fields work, let's consider the following example:

    If our Src/Dst number is 123#456, the Src/Dst Match field is ^123#(.*)$ and the Src/Dst Replace field is 789\1, the resulting number will be 789456. That's because the ^123#(.*)$ expression tells the system that from 123#456 number it must remember only the (.*) part, which stands for 456. Now, in the Src/Dst Replace field we have 789\1, which means that instead of 123#456, it must insert 789 + add \1 that equals (.*). Therefore, our resulting number will be 789+456=789456. These translation rules use the PostgreSQL regular expressions syntax (based on POSIX regex with some extensions). For more information, please refer to the PostgreSQL documentation portal.

    In addition, in the Src/Dst Replace field you can insert random number with fixed digit length using the $rnd(xxx-yyy)$ variable, where xxx - start number and yyy - end number of the range. For example, $rnd(050-950)$ will be replaced by a 3-digit random number from 50 to 950.

    Creating a new Orig/Term Rule

    To perform a translation for a specific pair of Originator and Terminator, switch to the Orig/Term Rules tab, click the Add Rule button, and fill in the following fields:

    Screenshot: New Orig/Term rule

    Image Removed

    ...

    Select the required parameters for a traffic processing rule on the Match menu:

    ...

    Specify a respective Origination client

    ...

    .

    ...

    ...

    Defines an action that will be executed if a traffic rule matches:

    • Allow 
    • Allow and Continue
    • Deny 

    Rules Import

    A user can import a .csv file containing a list of traffic processing rules. To import the file, click the Import button and a pop-up window with the following structure will appear:

    ...

    By clicking on the Export button you can download a current list of rules in a .csv file.

    Screenshot: Rules export


    Knowledge Base Articles

    Content by Label
    showLabelsfalse
    spaces+KB
    showSpacefalse
    sortmodified
    excerpttrue
    reversetrue
    excerptTypesimple
    cqllabel in ("lnp_mnp","traffic_processing") and space = "KB"
    labels+dr_plans