This topic has not yet been rated - Rate this topic

Entities object (JavaScript API for Office v1.1)

JavaScript API for Office v1.1

Represents a collection of entities found in an email message or appointment.

Last modified: February 24, 2014

Applicable Outlook modes

Read

Available in requirement sets

Mailbox

Entities
Properties

Property name

Outlook mode

Description

Introduced in

addresses

Read

Gets one or more physical addresses found in the item.

Version 1.0

contacts

Read

Gets one or more contacts found in the item.

Version 1.0

emailAddresses

Read

Gets one or more SMTP email addresses found in the item.

Version 1.0

meetingSuggestions

Read

Gets one or more meeting suggestions found in the item.

Version 1.0

phoneNumbers

Read

Gets one or more phone numbers found in the item.

Version 1.0

taskSuggestions

Read

Gets one or more task suggestions found in the item.

Version 1.0

urls

Read

Gets one or more URLs found in the item.

Version 1.0

The Entities object is a container for the entity arrays returned by the getEntities and getEntitiesByType methods when the item (either an email message or an appointment) contains one or more entities that have been found by the Exchange Server 2013 server. You can use these entities in your code to provide additional context information to the viewer, such as a map to an address found in the item, or to open a dialer for a phone number found in the item.

You access the properties of the Entities object as an array without reference to the Entities object in your code. For example, to access the addresses property, you would use the following code:

var addresses = getEntities().addresses[];

If no entities of the type specified in the property are present in the item, the property associated with that entity is null. For example, if a message contains a street address and a phone number, the addresses property and phoneNumbers property would contain information, and the other properties would be null.

Entity recognition relies on natural language recognition that is based on machine learning of large amounts of data. The recognition of an entity is non-deterministic and success sometimes relies on the particular context in the item.

When the property arrays are returned by the getEntitiesByType method, only the property for the specified entity contains data; all other properties are null.

App types

Mail app

Supported clients

Outlook 2013, Outlook 2013 SP1, Outlook Web App, and OWA for Devices

Library

Office.js

Namespace

Office

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.