Office.Entities interface

パッケージ:

outlook

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージまたは予定に含まれているエンティティのコレクションを表します。 閲覧モードのみ。

Entities オブジェクトは、サーバーによって見つけられた 1 つ以上のエンティティがアイテム (電子メール メッセージまたは予定) に含まれている場合に、getEntities メソッドと getEntitiesByType メソッドによって返されるエンティティ配列のコンテナーです。 これらのエンティティをコード内で使用することにより、アイテム内のアドレスへのマップなどの追加のコンテキスト情報をビューアーに提供したり、アイテム内の電話番号に対してダイヤラーを開いたりできます。

プロパティで指定された型のエンティティがアイテムに存在しない場合、そのエンティティに関連付けられているプロパティは null です。 たとえば、メッセージに番地と電話番号が含まれている場合、address プロパティと phoneNumbers プロパティには情報が含まれます。その他のプロパティは null になります。

住所として認識されるには、文字列に米国の住所 (少なくとも番地、通り名、都市名、州名、郵便番号の要素を含む) が含まれている必要があります。

電話番号として認識されるためには、北アメリカの電話番号の形式を文字列に含める必要があります。

エンティティの認識には、大量のデータの機械学習に基づいた自然言語認識を利用しています。 エンティティの認識は決定論的ではなく、結果がアイテムの特定のコンテキストに左右されることがあります。

プロパティ配列が getEntitiesByType メソッドによって返される場合、指定されたエンティティのプロパティにのみデータが含まれます。その他のプロパティはすべて null です。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

注釈

最小アクセス許可レベル: 読み取り項目

該当する Outlook モード: 読み取り

プロパティ

addresses	電子メール メッセージまたは予定に含まれている物理的な住所 (番地または郵送先住所) を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
contacts	電子メール アドレスまたは予定に含まれている連絡先を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
emailAddresses	電子メール メッセージまたは予定に含まれている電子メール アドレスを取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
meetingSuggestions	電子メール メッセージ含まれている会議の提案を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
phoneNumbers	電子メール メッセージや予定に含まれている電話番号を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
taskSuggestions	電子メール メッセージまたは予定に含まれている、タスクの提案を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
urls	電子メール メッセージまたは予定に含まれているインターネット URL を取得します。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

プロパティの詳細

addresses

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージまたは予定に含まれている物理的な住所 (番地または郵送先住所) を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

addresses: string[];

プロパティ値

string[]

例

const item = Office.context.mailbox.item;
const addresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.Address);

contacts

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール アドレスまたは予定に含まれている連絡先を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

contacts: Contact[];

プロパティ値

Office.Contact[]

例

const item = Office.context.mailbox.item;
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);

emailAddresses

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージまたは予定に含まれている電子メール アドレスを取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

emailAddresses: string[];

プロパティ値

string[]

例

const item = Office.context.mailbox.item;
const emailAddresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.EmailAddress);

meetingSuggestions

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージ含まれている会議の提案を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

meetingSuggestions: MeetingSuggestion[];

プロパティ値

Office.MeetingSuggestion[]

例

const item = Office.context.mailbox.item;
const meetingSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.MeetingSuggestion);

phoneNumbers

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージや予定に含まれている電話番号を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

phoneNumbers: PhoneNumber[];

プロパティ値

Office.PhoneNumber[]

例

const item = Office.context.mailbox.item;
const phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);

taskSuggestions

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージまたは予定に含まれている、タスクの提案を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

taskSuggestions: string[];

プロパティ値

string[]

例

const item = Office.context.mailbox.item;
const taskSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.TaskSuggestion);

urls

警告

この API は非推奨になりました。

Use regular expression rules instead.

電子メール メッセージまたは予定に含まれているインターネット URL を取得します。

警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

urls: string[];

プロパティ値

string[]

例

const item = Office.context.mailbox.item;
const urls = item.getEntitiesByType(Office.MailboxEnums.EntityType.Url);