電子メール メッセージ内で検出された指定のエンティティ型のすべてのエンティティを含む配列を取得します。
適用可能な Outlook のモード |
読み取り |
要件セットに指定できるもの |
メールボックス |
var entities = Office.context.mailbox.item.getEntitiesByType(entityType);
パラメーター
entityType
EntityType 列挙値の 1 つ。
戻り値
電子メール メッセージ内で検出された指定のエンティティ型のすべてのエンティティが含まれている配列。メッセージ内に指定の型のエンティティがない場合は、null。
例
次の例は、現在のアイテムの件名または本文に含まれる郵送先住所を表す文字列の配列にアクセスする方法を示しています。Outlook の現在のアイテムは Message オブジェクトであることもあれば、Appointment オブジェクトであることもあります。どちらのオブジェクトも Item オブジェクトから派生します。
// The initialize function is required for all apps.
Office.initialize = function () {
// Checks for the DOM to load using the jQuery ready function.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
var item = Office.context.mailbox.item;
// Get an array of strings that represent postal addresses in the current item.
var addresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.Address);
// Continue processing the array of addresses.
});
要件
アプリの種類 |
メール アプリ |
サポートされるクライアント |
Outlook 2013、Outlook 2013 SP1、Outlook 2013 RT、Outlook Web App、デバイス用 OWA |
ライブラリ |
Office.js |
名前空間 |
Office |
関連項目
その他の技術情報
Outlook クライアントでメール アプリをアクティブ化する
正規表現アクティブ化ルールを使用して Outlook でメール アプリを表示する
Outlook アイテム内の文字列を既知のエンティティとして照合する
サンプル: Outlook アイテムからエンティティ文字列を抽出する
Message.getEntities メソッド (JavaScript API for Office v1.1)
Message.getFilteredEntitiesByName メソッド (JavaScript API for Office v1.1)