International Phone

Overview

The International Phone tool validates and standardizes international phone numbers using Google's common Java library for validating and formatting international phone numbers. It accepts a phone number and dialing region as input, and outputs the standardized phone number along with several diagnostic fields.

International Phone tool configuration parameters

The International Phone tool has a single set of configuration parameters in addition to the standard execution options.

Parameter

Description

Phone field

Input field containing the phone number to be parsed and validated.

Region field

Input field containing the dialing region, expressed as a two-letter ISO code (GB).

Format

Desired output format for the parsed phone number:

INTERNATIONAL number notation: uses a leading plus (+) as an international prefix symbol, immediately followed by the country code. Country code, area code, and subscriber number are separated by spaces.
- Example: +22 607 123 4567
NATIONAL number notation: attempts to use Region field to determine the preferred number format.
- Example: 0115 933 4567
RFC3966 numbers: conform to the URI scheme "tel" for phone numbers.
- Example: +22-607-123-4567;ext=101
E164 numbers: can have a maximum of fifteen digits and are usually written as follows: [+][country code][subscriber number including area code].
- Example: +226071234567

Configure the International Phone tool

Select the International Phone tool.
Go to the Input tab.
Select Phone field and choose the input field containing the phone number.
Select Region field and choose the input field containing the country/region field.
Select Format and choose the desired output format for the parsed phone number.
Optionally, go to the Execution tab, and then set Web service options.

International Phone tool output fields

The International Phone tool outputs two diagnostic fields for each input phone number: phone number type (PHONE_NUM_TYPE), and validation result (VALIDATION_RESULT).

Phone number types

PHONE_NUM_TYPE value	Description
`FIXED_LINE`	Landline (phone that uses a metal wire or fiber optic telephone line for transmission).
`MOBILE`	Mobile cellular line.
`FIXED_LINE_OR_MOBILE`	In some regions (such as the USA), it is impossible to distinguish between fixed-line and mobile numbers by looking at the phone number itself.
`TOLL_FREE`	Phone number that is billed for all arriving calls instead of incurring charges to the originating caller.
`PREMIUM_RATE`	Call in which services are provided. Unlike a normal call, part of the call charge is paid to the service provider. See http://en.wikipedia.org/wiki/Premium-rate_telephone_number.
`SHARED_COST`	Cost of call is shared between the caller and the recipient, and is typically less than `PREMIUM_RATE` calls. See http://en.wikipedia.org/wiki/Shared_Cost_Service.
`VOIP`	Voice over IP numbers, including TSoIP (Telephony Service over IP).
`PERSONAL_NUMBER`	Number associated with a particular person, and may be routed to either a `MOBILE` or `FIXED_LINE` number. See http://en.wikipedia.org/wiki/Personal_Numbers.
`PAGER`	Number associated with a wireless telecommunications device that receives and displays alphanumeric messages, or receives and announces voice messages.
`UAM`	"Universal Access Numbers" or "Company Numbers." These may be further routed to specific offices, and allow a single number to be used for a company.
`VOICEMAIL`	Number associated with a voicemail system.
`UNKNOWN`	Does not fit any of the known patterns for a specific region.

Validation results

VALIDATION_RESULT value	Description
`IS_POSSIBLE`	Number length matches that of valid numbers for this region.
`IS_POSSIBLE_LOCAL_ONLY`	Number length matches that of local numbers for this region only (number that may be able to be dialed within an area, but does not have all the information to be dialed from anywhere inside or outside the country).
`INVALID_COUNTRY_CODE`	Number has an invalid country calling code.
`TOO_SHORT`	Number is shorter than all valid numbers for this region.
`INVALID_LENGTH`	Number is shorter than the longest valid numbers for this region, and does not itself have a number length that matches valid numbers for this region.
`TOO_LONG`	Number is longer than all valid numbers for this region.