Office.Contact interface

Pacote:

outlook

Representa os detalhes sobre um contato (semelhante ao que está em um contato físico ou cartão comercial) extraído do corpo do item. Somente modo de leitura.

A lista de contatos extraídos do corpo de uma mensagem de email ou compromisso é retornada na contacts propriedade do objeto Entidades retornado pelo getEntities método ou getEntitiesByType do item atual.

Comentários

Nível mínimo de permissão: restrito

Modo outlook aplicável: Leitura

Importante: os suplementos contextuais do Outlook baseados em entidade serão desativados no segundo trimestre de 2024. O trabalho para aposentar esse recurso começará em maio e continuará até o final de junho. Após junho, os suplementos contextuais não poderão mais detectar entidades em itens de email para executar tarefas neles. As APIs a seguir também serão retiradas.

• Office.context.mailbox.item.getEntities - Office.context.mailbox.item.getEntitiesByType - Office.context.mailbox.item.getFilteredEntitiesByName - Office.context.mailbox.item.getSelectedEntities

Para ajudar a minimizar possíveis interrupções, o seguinte ainda será suportado depois que os suplementos contextuais baseados em entidade forem retirados.

• Uma implementação alternativa do botão Ingressar Reunião , que é ativado por suplementos de reunião online, está sendo desenvolvida. Depois que o suporte para suplementos contextuais baseados em entidade terminar, os suplementos de reunião online farão a transição automática para a implementação alternativa para ativar o botão Ingressar Reunião .

• As regras de expressão regular continuarão a ser suportadas depois que os suplementos contextuais baseados em entidade forem retirados. Recomendamos atualizar seu suplemento contextual para usar regras de expressão regulares como uma solução alternativa. Para obter diretrizes sobre como implementar essas regras, consulte Usar regras regulares de ativação de expressão para mostrar um suplemento do Outlook.

Para obter mais informações, consulte Aposentadoria de suplementos contextuais do Outlook baseados em entidade.

Exemplos

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
*/

Propriedades

addresses	Uma matriz de cadeias de caracteres que contém os endereços de correspondência e ruas associados ao contato. Anulável.
businessName	Uma cadeia de caracteres que contém o nome da empresa associado ao contato. Anulável.
emailAddresses	Uma matriz de cadeias de caracteres que contém os endereços de email SMTP associados ao contato. Anulável.
personName	Uma cadeia de caracteres que contém o nome da pessoa associado ao contato. Anulável.
phoneNumbers	Uma matriz que contém um objeto PhoneNumber para cada número de telefone associado ao contato. Anulável.
urls	Uma matriz de cadeias de caracteres que contém as URLs de Internet associadas ao contato. Anulável.

Detalhes da propriedade

addresses

Uma matriz de cadeias de caracteres que contém os endereços de correspondência e ruas associados ao contato. Anulável.

addresses: string[];

Valor da propriedade

string[]

businessName

Uma cadeia de caracteres que contém o nome da empresa associado ao contato. Anulável.

businessName: string;

Valor da propriedade

string

emailAddresses

Uma matriz de cadeias de caracteres que contém os endereços de email SMTP associados ao contato. Anulável.

emailAddresses: string[];

Valor da propriedade

string[]

personName

Uma cadeia de caracteres que contém o nome da pessoa associado ao contato. Anulável.

personName: string;

Valor da propriedade

string

phoneNumbers

Uma matriz que contém um objeto PhoneNumber para cada número de telefone associado ao contato. Anulável.

phoneNumbers: PhoneNumber[];

Valor da propriedade

Office.PhoneNumber[]

urls

Uma matriz de cadeias de caracteres que contém as URLs de Internet associadas ao contato. Anulável.

urls: string[];

Valor da propriedade

string[]