Compartilhar via


Office.Entities interface

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Representa um conjunto de entidades encontrado em um compromisso ou uma mensagem de email. Somente modo de leitura.

O objeto Entities é um contêiner das matrizes de entidade retornadas pelos métodos getEntities e getEntitiesByType quando o item (uma mensagem de email ou um compromisso) contém uma ou mais entidades que foram encontradas pelo servidor. Você pode usar essas entidades em seu código para fornecer informações adicionais de contexto ao visualizador, como um mapa para um endereço encontrado no item ou para abrir um discador para um número de telefone encontrado no item.

Se não existirem entidades do tipo especificadas na propriedade presentes no item, a propriedade associada a essa entidade é nula. Por exemplo, se uma mensagem contiver um endereço de rua e um número de telefone, a propriedade endereços e a propriedade phoneNumbers conteriam informações e as outras propriedades seriam nulas.

Para ser reconhecida como um endereço, a cadeia de caracteres deve conter um endereço postal norte-americano com ao menos um subconjunto dos elementos de um número de rua, nome de rua, cidade, estado e CEP.

Para ser reconhecida como um número de telefone, a cadeia de caracteres deve conter um formato numérico norte-americano de telefone.

O reconhecimento da entidade depende de reconhecimento de linguagem natural, que é baseado no aprendizado de máquina de grandes quantidades de dados. O reconhecimento de uma entidade não é determinista e o sucesso, às vezes, depende do contexto específico no item.

Quando as matrizes de propriedades são devolvidas pelo getEntitiesByType método , apenas a propriedade da entidade especificada contém dados; todas as outras propriedades são nulas.

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: ler item

Modo Outlook aplicável: Leitura

Propriedades

addresses

Obtém os endereços físicos (endereços para correspondência ou de ruas) encontrados em um compromisso ou uma mensagem de email.

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.

contacts

Obtém os contatos encontrados em um compromisso ou um endereço de email.

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

Obtém os endereços de email encontrados em um compromisso ou uma mensagem de email.

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.

meetingSuggestions

Obtém as sugestões de reunião encontradas em uma mensagem de email.

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

Obtém os números de telefone encontrados em um compromisso ou uma mensagem de email.

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.

taskSuggestions

Obtém as sugestões de tarefas encontradas em um compromisso ou uma mensagem de email.

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

Obtém as URLs de Internet presentes em um compromisso ou uma mensagem de email.

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

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém os endereços físicos (endereços para correspondência ou de ruas) encontrados em um compromisso ou uma mensagem de email.

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[]

Exemplos

const item = Office.context.mailbox.item;
const addresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.Address);

contacts

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém os contatos encontrados em um compromisso ou um endereço de email.

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.

contacts: Contact[];

Valor da propriedade

Exemplos

const item = Office.context.mailbox.item;
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);

emailAddresses

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém os endereços de email encontrados em um compromisso ou uma mensagem de email.

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[]

Exemplos

const item = Office.context.mailbox.item;
const emailAddresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.EmailAddress);

meetingSuggestions

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém as sugestões de reunião encontradas em uma mensagem de email.

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.

meetingSuggestions: MeetingSuggestion[];

Valor da propriedade

Exemplos

const item = Office.context.mailbox.item;
const meetingSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.MeetingSuggestion);

phoneNumbers

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém os números de telefone encontrados em um compromisso ou uma mensagem de email.

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

Exemplos

const item = Office.context.mailbox.item;
const phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);

taskSuggestions

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém as sugestões de tarefas encontradas em um compromisso ou uma mensagem de email.

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.

taskSuggestions: string[];

Valor da propriedade

string[]

Exemplos

const item = Office.context.mailbox.item;
const taskSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.TaskSuggestion);

urls

Aviso

Essa API foi preterida.

Use regular expression rules instead.

Obtém as URLs de Internet presentes em um compromisso ou uma mensagem de email.

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[]

Exemplos

const item = Office.context.mailbox.item;
const urls = item.getEntitiesByType(Office.MailboxEnums.EntityType.Url);