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

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éconseillée)

Avertissement

L’élément <ItemHasKnownEntity> est désormais déconseillé. Spécifiez des règles d’expression régulière à l’aide de l’élément ItemHasRegularExpressionMatch à la place.

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

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="Context.Label"/>
  <SourceLocation resid="DetectedEntity.URL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message"/>
    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="videoURL" RegExValue="http://www\.youtube\.com/watch\?v=[a-zA-Z0-9_-]{11}" PropertyName="BodyAsPlaintext"/>
  </Rule>
</ExtensionPoint>

Voir aussi