Office.Contact interface
Representa os detalhes sobre um contacto (semelhante ao que está num contacto físico ou cartão de visita) 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
Importante: os suplementos contextuais do Outlook baseados em entidades serão descontinuados no 2.º trimestre de 2024. Os trabalhos para extinguir esta funcionalidade começarão em maio e continuarão até ao final de junho. Após junho, os suplementos contextuais deixarão de conseguir detetar entidades em itens de correio para realizar tarefas nos mesmos. As seguintes APIs também serão descontinuadas.
Office.context.mailbox.item.getEntities-Office.context.mailbox.item.getEntitiesByType-Office.context.mailbox.item.getFilteredEntitiesByName-Office.context.mailbox.item.getSelectedEntities
Para ajudar a minimizar potenciais interrupções, o seguinte continuará a ser suportado depois de os suplementos contextuais baseados em entidades serem descontinuados.
Está a ser desenvolvida uma implementação alternativa do botão Participar na Reunião , que é ativado por suplementos de reuniões online. Assim que o suporte para suplementos contextuais baseados em entidades terminar, os suplementos de reunião online passarão automaticamente para a implementação alternativa para ativar o botão Participar na Reunião .
As regras de expressão regular continuarão a ser suportadas depois de os suplementos contextuais baseados em entidades serem descontinuados. 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.
Para obter mais informações, veja Descontinuação dos suplementos contextuais do Outlook baseados em entidades.
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. |
| business |
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. |
| email |
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. |
| person |
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. |
| phone |
Uma matriz que contém um objeto 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
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
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
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
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
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
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[]