Suplementos contextuais do Outlook

Suplementos contextuais são suplementos do Outlook ativados com base no texto de um compromisso ou de uma mensagem. Usando suplementos contextuais, um usuário pode iniciar tarefas relacionadas a uma mensagem sem sair dela, o que resulta em uma experiência de usuário mais fácil e mais avançada.

Importante

Os suplementos contextuais do Outlook baseados em entidade serão desativados no segundo trimestre de 2024. O trabalho para aposentar esse recurso começará em maio e continuará até o final de junho. Após junho, os suplementos contextuais não poderão mais detectar entidades em itens de email para executar tarefas neles. As APIs a seguir também serão retiradas.

• Office.context.mailbox.item.getEntities()
• Office.context.mailbox.item.getEntitiesByType(entityType)
• Office.context.mailbox.item.getFilteredEntitiesByName(name)
• Office.context.mailbox.item.getSelectedEntities()

Para ajudar a minimizar possíveis interrupções, o seguinte ainda será suportado depois que os suplementos contextuais baseados em entidade forem retirados.

• Uma implementação alternativa do botão Ingressar Reunião , que é ativado por suplementos de reunião online, está sendo desenvolvida. Depois que o suporte para suplementos contextuais baseados em entidade terminar, os suplementos de reunião online farão a transição automática para a implementação alternativa para ativar o botão Ingressar Reunião .
• As regras de expressão regular continuarão a ser suportadas depois que os suplementos contextuais baseados em entidade forem retirados. Recomendamos atualizar seu suplemento contextual para usar regras de expressão regulares como uma solução alternativa. Para obter diretrizes sobre como implementar essas regras, consulte Usar regras regulares de ativação de expressão para mostrar um suplemento do Outlook.

Para obter mais informações, consulte Aposentadoria de suplementos contextuais do Outlook baseados em entidade.

Veja a seguir exemplos de suplementos contextuais.

• Escolher um endereço para abrir um mapa do local.
• Escolher uma cadeia de caracteres que abre um suplemento de sugestão de reunião.
• Escolher um número de telefone para adicionar aos seus contatos.

Como fazer um suplemento contextual

Observação

Suplementos contextuais do Outlook não têm suporte quando o suplemento usa um manifesto unificado para o Microsoft 365 (versão prévia).

O manifesto de um suplemento contextual deve conter um elemento ExtensionPoint com um atributo xsi:type definido como DetectedEntity. <No elemento ExtensionPoint>, o suplemento especifica as entidades ou a expressão regular que pode ativá-lo. Se uma entidade for especificada, ela poderá ser qualquer uma das propriedades no objeto Entities.

Dessa forma, o manifesto do suplemento precisa conter uma regra do tipo ItemHasKnownEntity ou ItemHasRegularExpressionMatch. O exemplo a seguir mostra como especificar que um suplemento deve ser ativado em mensagens com uma entidade detectada que é um número de telefone.

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="contextLabel" />
  <!--If you opt to include RequestedHeight, it must be between 140px to 450px, inclusive.-->
  <!--<RequestedHeight>360</RequestedHeight>-->
  <SourceLocation resid="detectedEntityURL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message" />
    <Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />
  </Rule>
</ExtensionPoint>

Depois que um suplemento contextual é associado a uma conta, ele inicia automaticamente quando o usuário clica em uma entidade ou expressão regular realçada. Para saber mais sobre expressões regulares para Suplementos do Outlook, confira Usar regras de ativação de expressões regulares para mostrar um Suplemento do Outlook.

Há várias restrições em suplementos contextuais:

• Um suplemento contextual só pode existir em suplementos de leitura (não de redação).
• Você não pode especificar a cor da entidade realçada.
• Uma entidade que não estiver realçada não iniciará um suplemento contextual em um cartão.

Como uma entidade ou expressão regular que não estiver realçada não iniciará o suplemento contextual, os suplementos devem conter pelo menos um elemento Rule com o atributo Highlight definido como all.

Observação

Os EmailAddress tipos de entidade e Url não dão suporte ao realce, portanto, não podem ser usados para iniciar um suplemento contextual. No entanto, eles podem ser combinados em um RuleCollection tipo de regra como um critério de ativação adicional.

Como iniciar um suplemento contextual

O usuário inicia o suplemento contextual por meio de texto, tanto uma entidade conhecida quanto uma expressão regular do desenvolvedor. Normalmente, o usuário identifica um suplemento contextual porque a entidade está realçada. O exemplo a seguir mostra como o realce aparece em uma mensagem. Aqui, a entidade (um endereço) é colorida azul e sublinhada com uma linha azul pontilhada. Um usuário inicia o suplemento contextual clicando na entidade realçada.

Quando há várias entidades ou suplementos contextuais em uma mensagem, existem algumas regras de interação do usuário:

• Se houver várias entidades, o usuário terá que clicar em uma entidade diferente para iniciar o suplemento.
• Se uma entidade ativar vários suplementos, cada suplemento abrirá uma nova guia. O usuário alterna entre guias para alternar entre os suplementos. Por exemplo, um nome e um endereço podem acionar um suplemento de telefone e um mapa.
• Se uma única cadeia de caracteres contiver várias entidades que ativam vários suplementos, toda a cadeia será realçada e um clique na cadeia de caracteres mostra todos os suplementos relevantes à cadeia em guias separadas. Por exemplo, uma cadeia de caracteres que descreve uma reunião proposta em um restaurante pode ativar o suplemento Reunião Sugerida e um suplemento de classificação de restaurantes.

Como um suplemento contextual é exibido

Um suplemento contextual ativado aparece em um cartão, que é uma janela separada perto a entidade. O cartão normalmente aparecerá abaixo da entidade e centralizado o máximo possível em relação à entidade. Se não houver espaço suficiente abaixo da entidade, o cartão será colocado acima dela.

Para fechar o cartão e o suplemento, o usuário deve clicar em algum lugar fora do cartão.

Suplementos contextuais atuais

Os suplementos contextuais a seguir são instalados por padrão para usuários com suplementos do Outlook.

• Bing Mapas
• Reuniões sugeridas

Confira também

• Suplemento do Outlook: número de ordem da Contoso (exemplo do suplemento contextual ativado com base em uma correspondência de expressão regular)
• Escreva seu primeiro suplemento do Outlook
• Usar regras de ativação de expressões regulares para mostrar um suplemento do Outlook
• Objeto Entities