Function

toemailaddress( value )

Converts a value to email address.

See also: Send E-Mail Smart Service

Parameters

Keyword	Type	Description
value	Any Type	Value to convert.

Returns

Email Address

Usage considerations

Using toemailaddress() with arrays

When operating on arrays, it is not necessary to use apply with toemailaddress. If multiple parameters are passed, or one parameter is an Array, toemailaddress will return an Email Address Array.

Understanding results

Can convert an email address Text.

The output can be converted to a value with an Email Recipient type for use in the To:, Cc:, or Bcc: field in the Setup tab of the Send E-Mail Smart Service.

Examples

toemailaddress("john.doe@company.com") returns john.doe@company.com as an Email Address type.

toemailaddress("john.doe@company.com","jane.doe@company.com") and toemailaddress({"john.doe@company.com","jane.doe@company.com"}) both return {john.doe@company.com,jane.doe@company.com} as a List of Email Address type.

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Compatible
Offline Mobile	Compatible
Sync-Time Custom Record Fields	Compatible	Can be used to create a custom record field that only evaluates at sync time.
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Compatible
Process Events	Compatible