Compléments Outlook contextuels

Les compléments contextuels sont des compléments Outlook qui s’activent sur la base du texte d’un message ou d’un rendez-vous. En utilisant des compléments contextuels, un utilisateur peut lancer des tâches liées à un message sans quitter le message lui-même, ce qui se traduit par une expérience utilisateur plus facile et plus riche.

Importante

Les compléments Outlook contextuels basés sur des entités seront mis hors service au deuxième trimestre 2024. Le travail de mise hors service de cette fonctionnalité commencera en mai et se poursuivra jusqu’à la fin du mois de juin. Après juin, les compléments contextuels ne seront plus en mesure de détecter les entités dans les éléments de courrier pour effectuer des tâches sur ces derniers. Les API suivantes seront également mises hors service.

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

Pour réduire les interruptions potentielles, les éléments suivants seront toujours pris en charge une fois les compléments contextuels basés sur des entités mis hors service.

• Une autre implémentation du bouton Participer à une réunion , qui est activé par les compléments de réunion en ligne, est en cours de développement. Une fois la prise en charge des compléments contextuels basés sur des entités terminée, les compléments de réunion en ligne passent automatiquement à l’implémentation alternative pour activer le bouton Participer à une réunion .
• Les règles d’expression régulière continueront d’être prises en charge une fois les compléments contextuels basés sur des entités mis hors service. Nous vous recommandons de mettre à jour votre complément contextuel pour utiliser des règles d’expression régulière comme solution alternative. Pour obtenir des conseils sur la façon d’implémenter ces règles, voir Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook.

Pour plus d’informations, consultez Retrait des compléments Outlook contextuels basés sur des entités.

Voici des exemples de compléments contextuels.

• Choix d’une adresse à ouvrir dans un plan du lieu.
• Choix d’une chaîne ouvrant un complément de suggestion de réunion.
• Choisir un numéro de téléphone permet de l’ajouter à vos contacts.

Création d’un complément contextuel

Remarque

Les compléments Outlook contextuels ne sont pas pris en charge lorsque le complément utilise un manifeste unifié pour Microsoft 365.

Le manifeste d’un complément contextuel doit inclure un élément ExtensionPoint avec une attribut xsi:type défini sur DetectedEntity. Dans l’élément <ExtensionPoint> , le complément spécifie les entités ou l’expression régulière qui peuvent l’activer. Si une entité est spécifiée, il peut s’agir d’une des propriétés de l’objet Entités.

Par conséquent, le manifeste du complément doit contenir un type de règle ItemHasKnownEntity ou Itemhasregularexpressionmatch. L’exemple suivant montre comment spécifier qu’un complément doit s’activer sur les messages avec une entité détectée qui est un numéro de téléphone.

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

Une fois qu’un complément contextuel est associé à un compte, il démarre automatiquement lorsque l’utilisateur clique sur une expression régulière ou une entité mise en surbrillance. Pour plus d’informations sur les expressions régulières pour les compléments Outlook, reportez-vous à l’article Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook.

Il existe plusieurs restrictions sur les compléments contextuels :

• Un complément contextuel ne peut exister que dans des compléments de lecture (pas dans des compléments de composition).
• Vous ne pouvez pas spécifier la couleur de l’entité en surbrillance.
• Si une entité n’est pas en surbrillance, elle ne lancera pas de complément contextuel dans une carte.

Une entité ou une expression régulière qui n’est pas mise en surbrillance ne permettant pas le lancement d’un complément contextuel, les compléments doivent inclure au moins un élément Rule avec l’attribut Highlight défini sur all.

Remarque

Les EmailAddress types d’entité et Url ne prennent pas en charge la mise en surbrillance. Ils ne peuvent donc pas être utilisés pour lancer un complément contextuel. Elles peuvent toutefois être combinées dans un RuleCollection type de règle en tant que critères d’activation supplémentaires.

Lancement d’un complément contextuel

Un utilisateur lance un complément contextuel par le biais du texte, une entité connue ou une expression régulière du développeur. En règle générale, un utilisateur identifie un complément contextuel car l’entité est mise en surbrillance. L’exemple suivant montre comment la mise en surbrillance s’affiche dans un message. Ici, l’entité (une adresse) est de couleur bleue et soulignée avec une ligne bleue pointillée. Un utilisateur lance le complément contextuel en cliquant sur l’entité en surbrillance.

Lorsque plusieurs entités ou compléments contextuels sont présents dans un message, l’interaction avec l’utilisateur a lieu comme suit :

• S’il existe plusieurs entités, l’utilisateur doit cliquer sur une autre entité pour lancer le complément de celle-ci.
• Si une entité active plusieurs compléments, chaque complément ouvre un nouvel onglet. L’utilisateur bascule entre les onglets pour passer d’un complément à l’autre. Par exemple, un nom et une adresse peuvent déclencher un complément de téléphone et une carte.
• Si une chaîne unique contient plusieurs entités qui activent plusieurs compléments, la chaîne entière est mise en surbrillance et lorsque l’utilisateur clique sur cette chaîne, tous les compléments concernés par la chaîne s’affichent dans des onglets distincts. Par exemple, une chaîne qui décrit une proposition de réunion dans un restaurant peut activer le complément de suggestion de réunion et un complément d’avis sur des restaurants.

Affichage des compléments contextuels

Un complément contextuel activé s’affiche dans une carte, qui est une fenêtre séparée près de l’entité. La carte s’affiche normalement sous l’entité et au centre par rapport à l’entité autant que possible. S’il n’y a pas assez d’espace sous l’entité, la carte est placée au-dessus de celle-ci.

Pour fermer la carte et quitter le complément, il suffit de cliquer n’importe où en dehors de la carte.

Compléments contextuels actuels

Les compléments contextuels suivants sont installés par défaut pour les utilisateurs avec des compléments Outlook.

• Plans Bing
• Réunions suggérées

Voir aussi

• Complément Outlook : numéro de commande Contoso (exemple de complément contextuel qui est activé en fonction d’une correspondance d’expression régulière)
• Créer votre premier complément Outlook
• Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook
• Objet Entités