Élément Rule

  • Article

Spécifie les règles d’activation qui doivent être évaluées pour ce complément de messagerie contextuelle.

Type de complément : Courrier (contextuel)

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.

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.

Contenu dans

Attributs

Attribut Obligatoire Description
xsi:type Oui Type de règle en cours de définition.

Le type de règle peut être l’un des suivants :

Règle ItemIs

Définit une règle qui donne la valeur true si l’élément sélectionné est du type spécifié.

Attributs

Attribut Obligatoire Description
ItemType Oui Spécifie le type d’élément à mettre en correspondance. Peut être Message ou Appointment. Le type d’élément Message inclut e-mails, demandes de réunion, réponses à une demande de réunion et annulations de réunion.
FormType Non (dans ExtensionPoint), Oui (dans App_office) Spécifie si l’application doit apparaître dans le formulaire de lecture ou de modification pour l’élément. Peut correspondre à l’une des valeurs suivantes : Read, Edit, ReadOrEdit. Si elle est spécifiée sur un Rule dans un ExtensionPoint, cette valeur DOIT être Read.
ItemClass Non Spécifie la classe de message personnalisé à mettre en correspondance. Pour plus d’informations, voir l’article relatif à l’activation d’un complément de messagerie dans Outlook pour une classe de message spécifique.
IncludeSubClasses Non Spécifie si la règle doit donner la valeur true si l’élément est une sous-classe de la classe de message spécifiée ; par défaut, la valeur est false.

Exemple

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

Règle ItemHasAttachment

Définit une règle qui donne la valeur true si l’élément contient une pièce jointe.

Exemple

<Rule xsi:type="ItemHasAttachment" />

Règle ItemHasKnownEntity

Définit une règle qui donne la valeur true si l’élément contient dans son objet ou son corps du texte correspondant au type d’entité spécifié.

Attributs

Attribut Obligatoire Description
EntityType Oui Spécifie le type d’entité à rechercher pour que la règle donne la valeur true. Peut correspondre à l’une des valeurs suivantes : MeetingSuggestion, TaskSuggestion, Address, Url, PhoneNumber, EmailAddress ou Contact.
RegExFilter Non Spécifie une expression régulière à exécuter par rapport à cette entité à des fins d’activation.
FilterName Non Spécifie le nom du filtre d’expression régulière, afin qu’il soit possible par la suite de s’y référer dans le code de votre complément.
IgnoreCase Non Spécifie s’il faut ignorer la casse pour la correspondance avec l’expression régulière spécifiée par l’attribut RegExFilter.
Highlight Non Remarque : cela s’applique uniquement aux <éléments Rule> dans les <éléments ExtensionPoint> . Spécifie comment le client doit mettre en surbrillance les entités correspondantes. Peut correspondre à l’une des valeurs suivantes : all ou none. Si non spécifié, la valeur par défaut est all.

Exemple

<Rule xsi:type="ItemHasKnownEntity" EntityType="EmailAddress" />

Règle ItemHasRegularExpressionMatch

Définit une règle qui donne la valeur true si une correspondance de l’expression régulière spécifiée est trouvée dans la propriété spécifiée de l’élément.

Attributs

Attribut Obligatoire Description
RegExName Oui Spécifie le nom de l’expression régulière afin que vous puissiez vous référer à l’expression dans le code de votre complément.
RegExValue Oui Spécifie l’expression régulière qui sera évaluée pour déterminer si le complément de messagerie doit être affiché.
PropertyName Oui Spécifie le nom de la propriété par rapport à laquelle l’expression sera évaluée. Peut correspondre à l’une des valeurs suivantes : Subject, BodyAsPlaintext, BodyAsHTML ou SenderSMTPAddress.

Si vous spécifiez BodyAsHTML, Outlook applique seulement l’expression régulière si le corps de l’élément est du code HTML. Si ce n’est pas le cas, Outlook ne renvoie aucune correspondance pour cette expression régulière.

Si vous spécifiez BodyAsPlaintext, Outlook applique toujours l’expression régulière au corps de l’élément.

Important: Si vous devez spécifier l’attribut Highlight pour l’élément <Rule> , vous devez définir l’attribut PropertyName sur BodyAsPlaintext.
IgnoreCase Non Spécifie s’il faut ignorer la casse pour la correspondance avec l’expression régulière spécifiée par l’attribut RegExName.
Highlight Non Spécifie la façon dont le client doit mettre en évidence le texte correspondant. Cet attribut ne peut être appliqué qu’aux <éléments Rule> dans <les éléments ExtensionPoint> . Peut correspondre à l’une des valeurs suivantes : all ou none. Si non spécifié, la valeur par défaut est all.

Important: Pour spécifier l’attribut Highlight dans l’élément <Rule> , vous devez définir l’attribut PropertyName sur BodyAsPlaintext.

Exemple

<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="SupportArticleNumber" RegExValue="(\W|^)kb\d{6}(\W|$)" PropertyName="BodyAsPlaintext" IgnoreCase="true" Highlight="all" />

RuleCollection

Définit une collection de règles et l’opérateur logique à utiliser lors de leur évaluation.

Attributs

Attribut Obligatoire Description
Mode Oui Spécifie l’opérateur logique à utiliser lors de l’évaluation de cette collection de règles. Peut être And ou Or.

Exemple

<Rule xsi:type="RuleCollection" Mode="And">
  <Rule xsi:type="ItemIs" ItemType="Message" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="MeetingSuggestion" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="Address" Highlight="none" />
</Rule>

Voir aussi