Compartilhar via


Office.Contact interface

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Representa os detalhes sobre um contacto (semelhante ao que está num contacto físico ou card empresarial) extraído do corpo do item. Somente modo de leitura.

A lista de contactos extraídos do corpo de uma mensagem de e-mail ou compromisso é devolvida na contacts propriedade do objeto Entidades devolvido pelo getEntities método ou getEntitiesByType do item atual.

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

Comentários

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

Modo Outlook aplicável: Leitura

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.

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

businessName

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

emailAddresses

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

personName

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

phoneNumbers

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

urls

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

Detalhes da propriedade

addresses

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

addresses: string[];

Valor da propriedade

string[]

businessName

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

businessName: string;

Valor da propriedade

string

emailAddresses

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

emailAddresses: string[];

Valor da propriedade

string[]

personName

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

personName: string;

Valor da propriedade

string

phoneNumbers

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

phoneNumbers: PhoneNumber[];

Valor da propriedade

urls

Aviso

Essa API foi preterida.

Use regular expression rules instead.

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

Aviso: os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

urls: string[];

Valor da propriedade

string[]