Office.Entities interface
Representa una colección de entidades presente en un mensaje de correo electrónico o en una cita. Solo modo Lectura.
El objeto Entities
es un contenedor para las matrices de entidades devueltas por los métodos getEntities
y getEntitiesByType
cuando el elemento (un mensaje de correo electrónico o una cita) contiene una o varias entidades encontradas por el servidor. Puede usar estas entidades en el código para proporcionar información de contexto adicional al visor, como un mapa para una dirección encontrada en el elemento o para abrir un marcador para un número de teléfono encontrado en el elemento.
Si no existen entidades del tipo especificado en la propiedad en el elemento, la propiedad asociada a esa entidad es null. Por ejemplo, si un mensaje contiene una dirección postal y un número de teléfono, las propiedades addresses y phoneNumbers tendrán información y las demás propiedades serán null.
Para que se reconozca como una dirección, la cadena debe contener una dirección postal de los Estados Unidos que tenga al menos un subconjunto de elementos con el número de la calle, el nombre de la calle, la ciudad, el estado y el código postal.
Para que se reconozca como un número de teléfono, la cadena debe contener un formato de número de teléfono de Estados Unidos.
El reconocimiento de entidades depende del reconocimiento del lenguaje natural basado en el aprendizaje automático de grandes volúmenes de datos. El reconocimiento de una entidad no es determinista y a veces los resultados dependen del contexto concreto del elemento.
Cuando el método devuelve getEntitiesByType
las matrices de propiedades, solo la propiedad de la entidad especificada contiene datos; todas las demás propiedades son 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.
Comentarios
Nivel mínimo de permiso: elemento de lectura
Modo de Outlook aplicable: Lectura
Propiedades
addresses | Obtiene las direcciones físicas (dirección postal o de correo) presentes en un mensaje de correo o una cita. 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. |
contacts | Obtiene los contactos presentes en una dirección de correo electrónico o una cita. 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 |
Obtiene las direcciones de correo electrónico presentes en un mensaje de correo o una cita. 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. |
meeting |
Obtiene las sugerencias de reunión presentes en un mensaje de correo. 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 |
Obtiene los números de teléfono presentes en un mensaje de correo o una cita. 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. |
task |
Obtiene las sugerencias de tarea presentes en un mensaje de correo o una cita. 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 | Obtiene las direcciones URL de Internet presentes en un mensaje de correo o una cita. 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
Obtiene las direcciones físicas (dirección postal o de correo) presentes en un mensaje de correo o una cita.
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[]
Ejemplos
const item = Office.context.mailbox.item;
const addresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.Address);
contacts
Obtiene los contactos presentes en una dirección de correo electrónico o una cita.
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.
contacts: Contact[];
Valor de propiedad
Ejemplos
const item = Office.context.mailbox.item;
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);
emailAddresses
Obtiene las direcciones de correo electrónico presentes en un mensaje de correo o una cita.
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[]
Ejemplos
const item = Office.context.mailbox.item;
const emailAddresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.EmailAddress);
meetingSuggestions
Obtiene las sugerencias de reunión presentes en un mensaje de correo.
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.
meetingSuggestions: MeetingSuggestion[];
Valor de propiedad
Ejemplos
const item = Office.context.mailbox.item;
const meetingSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.MeetingSuggestion);
phoneNumbers
Obtiene los números de teléfono presentes en un mensaje de correo o una cita.
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
Ejemplos
const item = Office.context.mailbox.item;
const phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);
taskSuggestions
Obtiene las sugerencias de tarea presentes en un mensaje de correo o una cita.
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.
taskSuggestions: string[];
Valor de propiedad
string[]
Ejemplos
const item = Office.context.mailbox.item;
const taskSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.TaskSuggestion);
urls
Obtiene las direcciones URL de Internet presentes en un mensaje de correo o una cita.
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[]
Ejemplos
const item = Office.context.mailbox.item;
const urls = item.getEntitiesByType(Office.MailboxEnums.EntityType.Url);