Objekt Entities (JavaScript-API für Office v1.1)

Artikel
01/28/2015

Stellt eine Auflistung von in einer E-Mail-Nachricht oder einem Termin gefundenen Entitäten dar.

Letzte Änderung: Montag, 24. November 2014

Zutreffende Outlook-Modi	Lesen
Verfügbar in Anforderungssätzen	Postfach

Entities

Member

Eigenschaften

Eigenschaftenname	Outlook-Modus	Beschreibung	Eingeführt in
addresses	Lesen	Ruft eine oder mehrere physikalische Adressen im Element ab.	Version 1.0
contacts	Lesen	Ruft einen oder mehrere Kontakte im Element ab.	Version 1.0
emailAddresses	Lesen	Ruft eine oder mehrere SMTP-E-Mail-Adressen im Element ab.	Version 1.0
meetingSuggestions	Lesen	Ruft einen oder mehrere Besprechungsvorschläge im Element ab.	Version 1.0
phoneNumbers	Lesen	Ruft eine oder mehrere Telefonnummern im Element ab.	Version 1.0
taskSuggestions	Lesen	Ruft einen oder mehrere Vorgangsvorschläge im Element ab.	Version 1.0
urls	Lesen	Ruft eine oder mehrere URLs im Element ab.	Version 1.0

Hinweise

Das Entities-Objekt ist ein Container für die Entitätsarrays, die von der getEntities-Methode und der getEntitiesByType-Methode zurückgegeben werden, wenn das Element (eine E-Mail-Nachricht oder ein Termin) mindestens eine vom Exchange Server 2013-Server gefundene Entität enthält. Sie können diese Entitäten im Code verwenden, um zusätzliche Kontextinformationen für den Betrachter bereitzustellen, z. B. eine Karte für eine im Element gefundene Adresse anzeigen oder ein Wählprogramm für eine Telefonnummer im Element öffnen.

Sie können auf die Eigenschaften des Entities-Objekts als Array ohne Verweis auf das Entities-Objekt im Code zugreifen. Wenn Sie z. B. auf die addresses-Eigenschaft zugreifen möchten, verwenden Sie den folgenden Code:

var addresses = getEntities().addresses[];

Wenn keine Entitäten des in der Eigenschaft angegebenen Typs im Element vorhanden sind, lautet die dieser Entität zugeordnete Eigenschaft null. Wenn eine Nachricht z. B. eine Adresse und eine Telefonnummer enthält, enthalten die addresses-Eigenschaft und die phoneNumbers-Eigenschaft Informationen, und die anderen Eigenschaften sind null.

Die Entitätserkennung basiert auf der Erkennung von natürlicher Sprache und damit auf einer Maschine, die aus einer großen Datenmenge lernt. Die Erkennung einer Entität ist nondeterministisch, und der Erfolg ist in einigen Fällen vom jeweiligen Kontext im Element abhängig.

Wenn die Eigenschaftenarrays von der getEntitiesByType-Methode zurückgegeben werden, enthält nur die Eigenschaft für die angegebene Entitäten Daten. Alle anderen Eigenschaften sind null.

Anforderungen

App-Typen	Mail-App
Unterstützte Clients	Outlook 2013, Outlook 2013 SP1, Outlook 2013 RT, Outlook Web App und OWA für mobile Geräte
Bibliothek	Office.js
Namespace	Office