Compartir a través de


Office.Contact interface

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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.

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

Comentarios

Nivel mínimo de permiso: restringido

Modo de Outlook aplicable: Lectura

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 un valor NULL.

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

businessName

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

emailAddresses

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

personName

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

phoneNumbers

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

urls

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

Detalles de las propiedades

addresses

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

addresses: string[];

Valor de propiedad

string[]

businessName

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

businessName: string;

Valor de propiedad

string

emailAddresses

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

emailAddresses: string[];

Valor de propiedad

string[]

personName

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

personName: string;

Valor de propiedad

string

phoneNumbers

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

phoneNumbers: PhoneNumber[];

Valor de propiedad

urls

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

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

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. 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 Complementos contextuales de Outlook.

urls: string[];

Valor de propiedad

string[]