Partager via

É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 prend la valeur true si l’élément sélectionné sous forme de lecture ou de composition est du type spécifié. Vous pouvez spécifier plusieurs ItemIs règles dans le manifeste.

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, consultez Types d’éléments et classes de message.
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.

ItemType

Le tableau suivant décrit les types d’éléments Appointment et Message que vous pouvez spécifier dans l’attribut ItemType .

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

Exemple

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

Règle ItemHasAttachment

Définit une règle qui prend la valeur true si l’élément dans le formulaire de lecture 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 prend la valeur true si une correspondance pour l’expression régulière spécifiée se trouve dans la propriété spécifiée de l’élément sous forme de lecture.

Pour savoir comment implémenter la ItemHasRegularExpressionMatch règle, consultez Compléments Outlook contextuels.

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