Partager via


Règles d’activation des compléments contextuels Outlook

Outlook active certains types de complément si le message ou le rendez-vous que l’utilisateur lit ou compose respecte les règles d’activation du complément. Cela est vrai pour tous les compléments qui utilisent le schéma de manifeste 1.1. L’utilisateur peut choisir le complément à partir de l’interface utilisateur Outlook afin de le démarrer pour l’élément actuel.

Notes

Les fonctionnalités du complément Outlook qui dépendent de règles d’activation ne sont pas prises en charge lorsque le complément utilise un manifeste d’application unifié pour Microsoft 365.

Spécifier des règles d’activation dans un manifeste

Pour qu’Outlook active un complément pour des conditions spécifiques, spécifiez des règles d’activation dans le manifeste du complément à l’aide de l’un des éléments suivants Rule .

Notes

L’élément Rule que vous utilisez pour spécifier une règle individuelle est de type complexe Règle abstraite. Chacun des types de règles suivants étend ce type complexe abstrait Rule . Ainsi, quand vous spécifiez une règle individuelle dans un manifeste, vous devez utiliser l’attribut xsi:type pour définir plus précisément l’un des types de règle suivants.

Par exemple, la règle suivante définit une règle ItemIs . <Rule xsi:type="ItemIs" ItemType="Message" />

L’attribut FormType s’applique aux règles d’activation dans le manifeste v1.1, mais n’est pas défini dans VersionOverrides la version 1.0. Il ne peut donc pas être utilisé lorsque ItemIs est utilisé dans le VersionOverrides nœud.

Le tableau suivant répertorie les types de règle disponibles. Vous trouverez plus d’informations en suivant le tableau.

Nom de la règle Formulaires applicables Description
ItemIs Lecture, composition Vérifie si l’élément actuel est du type spécifié (message ou rendez-vous). Peut également vérifier la classe d’élément et le type de formulaire, et éventuellement, la classe de message d’élément.
ItemHasAttachment Lecture Vérifie si l’élément sélectionné contient une pièce jointe.
ItemHasRegularExpressionMatch Lecture Vérifie si l’adresse e-mail de l’expéditeur, l’objet ou le corps de l’élément sélectionné contient une correspondance avec une expression régulière.
RuleCollection Lecture, composition Associe un ensemble de règles pour vous permettre de former des règles plus complexes.

Importante

Les compléments Outlook contextuels basés sur des entités sont désormais mis hors service. Comme solution alternative, implémentez des règles d’expression régulière dans votre complément contextuel. Pour obtenir des conseils sur la façon d’implémenter ces règles, consultez Compléments Outlook contextuels.

Règle ItemIs

Le ItemIs type complexe définit une règle qui prend la true valeur si l’élément actuel correspond au type d’élément, et éventuellement la classe de message d’élément si elle est indiquée dans la règle.

Spécifiez l’un des types d’éléments suivants dans l’attribut ItemType d’une ItemIs règle. Vous pouvez spécifier plusieurs ItemIs règles dans un manifeste. L’attribut ItemType définit les types d’éléments Outlook qui prennent en charge les compléments Outlook.

Valeur Description
Rendez-vous Spécifie un élément dans le calendrier Outlook. Cela inclut un élément de réunion auquel a répondu un organisateur et des participants, ou un rendez-vous qui n’a pas d’organisateur ou de participant et qui est simplement un élément du calendrier. Cela correspond à la classe de message IPM.Appointment dans Outlook.
Message Spécifie l’un des éléments suivants reçus dans la boîte de réception.
  • Message électronique. Cela correspond à la classe de message IPM.Note dans Outlook.

  • Demande de réunion, réponse à une demande de réunion ou annulation d’une réunion. Cela correspond aux classes de message suivantes dans Outlook.

    IPM.Schedule.Meeting.Request

    IPM.Schedule.Meeting.Neg

    IPM.Schedule.Meeting.Pos

    IPM.Schedule.Meeting.Tent

    IPM.Schedule.Meeting.Canceled

L’attribut FormType est utilisé pour spécifier le mode (lecture ou composition) dans lequel le complément doit s’activer.

Notes

L’attribut ItemIs FormType est défini dans le schéma v1.1 et versions ultérieures, mais pas dans la VersionOverrides version 1.0. N’incluez pas l’attribut lors de la FormType définition des commandes de complément.

Une fois qu’un complément est activé, vous pouvez utiliser la propriété mailbox.item pour obtenir l’élément actuellement sélectionné dans Outlook, et la propriété item.itemType pour obtenir le type de l’élément actuel.

Vous pouvez éventuellement utiliser l’attribut ItemClass pour spécifier la classe de message de l’élément et l’attribut IncludeSubClasses pour spécifier si la règle doit être true lorsque l’élément est une sous-classe de la classe spécifiée.

Pour plus d’informations sur les classes de message, reportez-vous à la rubrique Types d’éléments et classes de messages.

L’exemple suivant est une ItemIs règle qui active le complément Outlook lorsque l’utilisateur lit un message.

<Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />

L’exemple suivant est une ItemIs règle qui active le complément Outlook lorsque l’utilisateur lit un message ou un rendez-vous.

<Rule xsi:type="RuleCollection" Mode="Or">
  <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
  <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
</Rule>

Règle ItemHasAttachment

Le ItemHasAttachment type complexe définit une règle qui vérifie si l’élément sélectionné contient une pièce jointe.

<Rule xsi:type="ItemHasAttachment" />

Règle ItemHasRegularExpressionMatch

Le ItemHasRegularExpressionMatch type complexe définit une règle qui utilise une expression régulière pour faire correspondre le contenu de la propriété spécifiée d’un élément. Utilisez la getRegExMatches méthode ou getRegExMatchesByName de l’objet qui représente l’élément actuellement sélectionné pour obtenir des correspondances pour l’expression régulière spécifiée.

L’exemple suivant montre un ItemHasRegularExpressionMatch qui active le complément lorsque le corps de l’élément sélectionné contient « pomme », « banane » ou « noix de coco », en ignorant la casse.

<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="fruits" RegExValue="apple|banana|coconut" PropertyName="BodyAsPlaintext" IgnoreCase="true" />

Pour plus d’informations sur l’utilisation de la ItemHasRegularExpressionMatch règle, voir Compléments Outlook contextuels.

Règle RuleCollection

Le RuleCollection type complexe combine plusieurs règles en une seule règle. Vous pouvez spécifier si les règles de la collection doivent être combinées avec un OR logique ou un AND logique à l’aide de l’attribut Mode .

Quand un ET logique est spécifié, un élément doit correspondre à toutes les règles spécifiées dans le regroupement pour permettre l’affichage du complément. Lorsqu’un OR logique est spécifié, un élément qui correspond à l’une des règles spécifiées dans la collection affiche le complément.

Vous pouvez combiner des RuleCollection règles pour former des règles complexes. L’exemple suivant active le complément lorsque l’utilisateur affiche un rendez-vous ou un message contenant une pièce jointe.

<Rule xsi:type="RuleCollection" Mode="And">
  <Rule xsi:type="RuleCollection" Mode="Or">
    <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
    <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
  </Rule>
  <Rule xsi:type="ItemHasAttachment" />
</Rule>

L’exemple suivant active le complément lorsque l’utilisateur compose un message, ou lorsque l’utilisateur affiche un rendez-vous et que son objet contient « sales », « marketing » ou « finance ».

<Rule xsi:type="RuleCollection" Mode="Or">
  <Rule xsi:type="ItemIs" ItemType="Message" FormType="Edit" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="departments" RegExValue="sales|marketing|finance" PropertyName="Subject" IgnoreCase="true" />
  </Rule> 
</Rule>

Limites pour les règles et les expressions régulières

Pour fournir une expérience satisfaisante avec les compléments Outlook, vous devez vous conformer aux directives d’activation et d’utilisation des API. Pour en savoir plus sur ces instructions, consultez Limites d’activation et API JavaScript pour les compléments Outlook et Résoudre les problèmes d’activation des compléments Outlook.

Voir aussi