通过

Office.Contact interface

  • 参考
包:
outlook

警告

现已弃用此 API。

Use regular expression rules instead.

表示有关联系人 (的详细信息，类似于从项目正文中提取的物理联系人或业务卡) 。 仅限阅读模式。

从电子邮件或约会的正文中提取的联系人列表在当前项目的 或 getEntitiesByType 方法返回getEntities的 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

包含与联系人关联的 Internet 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.

包含与联系人关联的 Internet URL 的字符串数组。 可为 NULL。

警告：基于实体的上下文 Outlook 加载项现已停用。 但是，仍支持正则表达式规则。 建议更新上下文加载项，以使用正则表达式规则作为替代解决方案。 有关如何实现这些规则的指南，请参阅 上下文 Outlook 加载项。

urls: string[];

属性值

string[]