FormatNumber

Description (v1.5.1)

INFO Convert phone number to a format defined. The result is given in the variable named NUMBER_x_FORMATTED where x is the digit of the number in the field. eg: "Number 1" the output value is in the variable NUMBER_1_FORMATTED.
INFO Type of format in output [Address format]
INFO International Call Prefix [International Call Prefix]
INFO Trunk Prefix [Trunk Prefix]
INFO Contry Calling Code [Contry Calling Code]
INFO National number length. The format must be the lowest value before the highest value and separate with : [National number length]
INFO Number to format [Number X]

Release notes

Show release notes
Version 1.5.1 - Early deployment
  • Bugfix: Incorrect format when calling number abroad (PC-802)

Version 1.5.0 - Deprecated
  • Feature: added support for national format with trunk prefix (PC-802)
  • Deprecated: Incorrect format for number abroad (PC-802)

Version 1.4.1 - Early deployment
  • Bugfix: International prefix was not added in case of national number in input and international noa is selected for the output (M0)
  • Bugfix: National number length was not properly taken into account in case (M0)

Version 1.4.0 - Early deployment
  • Feature: Set default national number length for Italy (M17375)
  • Improvement: When a number starts with the local country code, the number is assumed to be national if the length does not match the national number length (M17375)

Version 1.3.0 - Early deployment
  • Improvement: Set the plus when a national number is detected based on the national dial plan length (M17058)

Version 1.2.0 - Early deployment
  • Feature: Make the Dialing plan (Trunk prefix) optional (M14818)

Version 1.1.3 - General deployment
  • Bugfix: Empty National number length (M12325)
  • Improvement: Optimization on empty number (M0)

Version 1.1.2 - General deployment
  • Bugfix: When the first digits of a short code match the Country Calling Code, FormatNumber did not consider the number as a shortcode (M0011941)

Version 1.1.1 - General deployment
  • Bugfix: Set variable value to empty before to start the process (M10252)
  • Feature: Address format field can use a LUA expression (M10252)
  • Bugfix: Set NUMBER_x_FORMATTED_PREFIX in national mode (M10252)
  • Bugfix: Fix of the formation in national mode with prefix +CCC... (M10252)
  • Bugfix: Do not format when when we have a-zA-Z character in the number (M10365)

Version 1.1.0 - General deployment
  • Feature: add possibility to add a prefix in international (M10217)

Version 1.0.0 - General deployment
  • Feature: Initial version

Action parameters

This action enables to standardize the format of some numbers. The input format is detected in an heuristic way.

  • Address format: Output format of the number. Set to 'to E.164 international format' to have the E.164 format with the country code. Set to 'to E.164 national level' to have the national part of the E.164 format
  • International call prefix: The prefix used to indicate national call. Typically '00'.
  • Trunk prefix (previously Dial plan: The prefix to be used to indicate national call. Typically '0'. If set to empty, it will be computed based on the Country Calling Code. Some countries such as Italy and Spain do not use any Trunk prefix.
  • Country Calling Code: The prefix of the local country. For example '32' for Belgium.
  • National number length: The minimum and maximum length of a national number separated by a semicolon. For example '8:9' for Belgium.
  • Number [n]: The number to be formatted. The formatted number will be stored in the variable NUMBER_[n]_FORMATTED.
  • International prefix: The prefix to be added in case of international call. Typically this is set to '+'. The formatted number which includes the prefix is stored in the variable NUMBER_[n]_FORMATTED_PREFIX.
  • Validation: Enable to ignore the + received in the number. On some network (mobile roaming), incoming call for an extension are prefixed with an extra +.

Other references:
Copyright © Escaux SA