Office.Contact interface

パッケージ:

outlook

警告

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

Use regular expression rules instead.

アイテムの本文から抽出された連絡先 (物理的な連絡先や名刺と同様) に関する詳細を表します。 閲覧モードのみ。

電子メール メッセージまたは予定の本文から抽出された連絡先の一覧は、現在のアイテムの getEntities または getEntitiesByType メソッドによって返される Entities オブジェクトのcontacts プロパティで返されます。

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

注釈

最小アクセス許可レベル: 制限あり

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

例

const item = Office.context.mailbox.item;
// Get an array of strings that represent contacts in the current item's body.
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);
console.log("There are " + contacts.length + " contacts.")
contacts.forEach(function (contact) {
    console.log("Person name: " + JSON.stringify(contact.personName));
    console.log("Business name: " + JSON.stringify(contact.businessName));
    console.log("Addresses: " + JSON.stringify(contact.addresses));
    console.log("Phone numbers: " + JSON.stringify(contact.phoneNumbers));
    console.log("Email addresses: " + JSON.stringify(contact.emailAddresses));
    console.log("Urls: " + JSON.stringify(contact.urls));
});

/* Example email that includes contact details of sender, John Smith:
Hi there,
I have received the package.

Thanks.
John Smith
Account Manager
Contoso Corporation
1 Contoso Way, Redmond, WA 98052
john.smith@contoso.com
111-111-1111
https://contoso.com/john.smith
*/

プロパティ

addresses	連絡先に関連付けられているメールアドレスと住所を含む文字列の配列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
businessName	連絡先に関連付けられた取引先の名前が含まれている文字列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
emailAddresses	連絡先に関連付けられている SMTP メールアドレスを含む文字列の配列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
personName	連絡先に関連付けられた人物の名前が含まれている文字列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
phoneNumbers	連絡先に関連付けられた各電話番号の PhoneNumber オブジェクトが含まれている配列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。
urls	連絡先に関連付けられているインターネットの URL を含む文字列の配列。 Null 許容型。 警告: エンティティベースのコンテキスト Outlook アドインは廃止されました。 ただし、正規表現ルールは引き続きサポートされています。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

プロパティの詳細

addresses

警告

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

Use regular expression rules instead.

連絡先に関連付けられているメールアドレスと住所を含む文字列の配列。 Null 許容型。

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

addresses: string[];

プロパティ値

string[]

businessName

警告

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

Use regular expression rules instead.

連絡先に関連付けられた取引先の名前が含まれている文字列。 Null 許容型。

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

businessName: string;

プロパティ値

string

emailAddresses

警告

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

Use regular expression rules instead.

連絡先に関連付けられている SMTP メールアドレスを含む文字列の配列。 Null 許容型。

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

emailAddresses: string[];

プロパティ値

string[]

personName

警告

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

Use regular expression rules instead.

連絡先に関連付けられた人物の名前が含まれている文字列。 Null 許容型。

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

personName: string;

プロパティ値

string

phoneNumbers

警告

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

Use regular expression rules instead.

連絡先に関連付けられた各電話番号の PhoneNumber オブジェクトが含まれている配列。 Null 許容型。

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

phoneNumbers: PhoneNumber[];

プロパティ値

Office.PhoneNumber[]

urls

警告

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

Use regular expression rules instead.

連絡先に関連付けられているインターネットの URL を含む文字列の配列。 Null 許容型。

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

urls: string[];

プロパティ値

string[]