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
Country code	NEW IN 9.6.1 Represents the international dialing code for the country associated with the phone number.
Country code source	NEW IN 9.6.1 Identifies the source of the country code, such as whether it was derived from the number itself or provided explicitly.
Extension field	NEW IN 9.6.1 Stores the extension part of a phone number, which is typically used to route calls within a larger organization or system. For example, in a phone number like +1 (555) 123-4567 ext. 89, "89" would be the extension.
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
Italian leading zero	NEW IN 9.6.1 Indicates whether the phone number has a leading zero, which is significant for Italian numbers when dialing internationally.
National number	NEW IN 9.6.1 The significant part of the phone number within the country, excluding the country code and any national prefix.
Number of leading zeros	NEW IN 9.6.1 Specifies the count of leading zeros in the national number.
Phone field	Input field containing the phone number to be parsed and validated.
Preferred domestic carrier code	NEW IN 9.6.1 Contains the carrier code preferred for dialing within the country.
Raw input	NEW IN 9.6.1 Stores the original input string of the phone number before any parsing or formatting.
Region field	Input field containing the dialing region, expressed as a two-letter ISO code (GB).

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.