Élément Rule

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

Cet élément ou cette valeur d’attribut est documenté pour aider les développeurs à résoudre les problèmes de compléments contextuels Outlook existants. Nous vous recommandons de ne pas créer de compléments contextuels Outlook.

  • Les compléments Outlook contextuels basés sur des entités sont désormais mis hors service.
  • Les scénarios qui nécessitaient auparavant des règles d’expression régulière dans les compléments contextuels peuvent désormais être implémentés avec les compléments Outlook basés sur les événements, qui sont activés automatiquement en réponse à des événements tels que la création d’un message ou d’une réunion. JavaScript offre une prise en charge intégrée des expressions régulières, et vous pouvez également référencer des bibliothèques JavaScript qui fournissent des fonctionnalités avancées d’expressions régulières. Contrairement aux compléments contextuels, les compléments basés sur des événements peuvent fonctionner dans des contextes de composition aussi bien qu’en mode Lecture.

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 dont le résultat est vrai si l’élément sélectionné dans le formulaire lu ou composé 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 a 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 Types d’éléments et classes de messages.
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. Il s’agit notamment d’un élément de réunion auquel on a répondu et qui a un organisateur et des participants, ou d’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 généralement 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 sous forme 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 les 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 ne s’applique qu’aux <éléments Rule> au sein des <é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 dont le résultat est vrai si une correspondance pour l’expression régulière spécifiée peut être trouvée dans la propriété spécifiée de l’élément sous forme de lecture.

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

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 <Règle> , 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> au sein des <é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

  • Dernière mise à jour :