Office.Contact interface
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
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 Complementos contextuales 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 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. |
| business |
Cadena que contiene el nombre de la empresa asociada 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. |
| email |
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. |
| person |
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. |
| phone |
Una matriz que contiene un objeto 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
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
Cadena que contiene el nombre de la empresa asociada 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: 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.
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
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
Una matriz que contiene un objeto PhoneNumber para cada número de teléfono asociado 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: PhoneNumber[];Valor de propiedad
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.
urls: string[];Valor de propiedad
string[]