Office.Contact interface

Paquete:

outlook

Representa los detalles sobre un contacto (similar a lo que aparece en un contacto físico o una tarjeta de presentación) extraídos del cuerpo del elemento. Solo en modo Lectura.

La lista de contactos extraídos del cuerpo de un mensaje de correo electrónico o una cita se devuelve en la contacts propiedad del objeto Entities devuelto por el getEntities método o getEntitiesByType del elemento actual.

Comentarios

Nivel mínimo de permiso: restringido

Modo de Outlook aplicable: Lectura

Importante: Los complementos contextuales de Outlook basados en entidades se retirarán en el segundo trimestre de 2024. El trabajo para retirar esta característica comenzará en mayo y continuará hasta finales de junio. Después de junio, los complementos contextuales ya no podrán detectar entidades en elementos de correo para realizar tareas en ellos. También se retirarán las siguientes API.

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

Para ayudar a minimizar las posibles interrupciones, se seguirá admitiendo lo siguiente después de que se retiren los complementos contextuales basados en entidades.

• Se está desarrollando una implementación alternativa del botón Unirse a la reunión , que se activa mediante complementos de reunión en línea. Una vez finalizada la compatibilidad con complementos contextuales basados en entidades, los complementos de reunión en línea pasarán automáticamente a la implementación alternativa para activar el botón Unirse a la reunión .

• Las reglas de expresión regular seguirán siendo compatibles después de retirar los complementos contextuales basados en entidades. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Usar reglas de activación de expresiones regulares para mostrar un complemento de Outlook.

Para obtener más información, vea Retirada de complementos contextuales de Outlook basados en entidades.

Ejemplos

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

Propiedades

addresses	Una matriz de cadenas que contiene las direcciones de correo electrónico y postales asociadas al contacto. Admite valores NULL.
businessName	Cadena que contiene el nombre de la empresa asociada al contacto. Admite valores NULL.
emailAddresses	Una matriz de cadenas que contiene las direcciones de correo electrónico SMTP asociadas al contacto. Admite valores NULL.
personName	Cadena que contiene el nombre de la persona asociada al contacto. Admite valores NULL.
phoneNumbers	Una matriz que contiene un objeto PhoneNumber para cada número de teléfono asociado al contacto. Admite valores NULL.
urls	Una matriz de cadenas que contiene las direcciones URL de Internet asociadas al contacto. Admite valores NULL.

Detalles de las propiedades

addresses

Una matriz de cadenas que contiene las direcciones de correo electrónico y postales asociadas al contacto. Admite valores NULL.

addresses: string[];

Valor de propiedad

string[]

businessName

Cadena que contiene el nombre de la empresa asociada al contacto. Admite valores NULL.

businessName: string;

Valor de propiedad

string

emailAddresses

Una matriz de cadenas que contiene las direcciones de correo electrónico SMTP asociadas al contacto. Admite valores NULL.

emailAddresses: string[];

Valor de propiedad

string[]

personName

Cadena que contiene el nombre de la persona asociada al contacto. Admite valores NULL.

personName: string;

Valor de propiedad

string

phoneNumbers

Una matriz que contiene un objeto PhoneNumber para cada número de teléfono asociado al contacto. Admite valores NULL.

phoneNumbers: PhoneNumber[];

Valor de propiedad

Office.PhoneNumber[]

urls

Una matriz de cadenas que contiene las direcciones URL de Internet asociadas al contacto. Admite valores NULL.

urls: string[];

Valor de propiedad

string[]