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
.
- Élément de règle (MailApp complexType) : spécifie une règle individuelle.
- Élément de règle (RuleCollection complexType) : combine plusieurs règles à l’aide d’opérations logiques.
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.
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour