Rule-Element

  • Artikel

Gibt die Aktivierungsregeln an, die für dieses kontextbezogene E-Mail-Add-In ausgewertet werden sollen.

Add-In-Typ: E-Mail (kontextbezogen)

Wichtig

Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Als alternative Lösung können Sie Regeln für reguläre Ausdrücke in Ihrem Kontext-Add-In implementieren. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

Enthalten in

Attribute

Attribut Erforderlich Beschreibung
xsi:type Ja Der Typ der Regel, die definiert wird.

Der Regeltyp kann eine der folgenden Sein:

ItemIs-Regel

Definiert eine Regel, die „true“ ausgibt, wenn das ausgewählte Element den angegebenen Typ aufweist.

Attribute

Attribut Erforderlich Beschreibung
ItemType Ja Gibt den zu findenden Elementtyp an. Kann Message oder Appointment sein. Der Elementtyp Message umfasst E-Mail, Besprechungsanfragen, Besprechungsantworten und Besprechungsabsagen.
FormType Nein (innerhalb von ExtensionPoint), Ja (innerhalb von OfficeApp) Gibt an, ob die App im Lese- oder Bearbeitungsformat für das Element angezeigt werden soll. Folgende Werte sind möglich: Read, Edit, ReadOrEdit. Wenn für eine Rule innerhalb eines ExtensionPointangegeben wird, MUSS dieser Wert sein Read.
ItemClass Nein Gibt die zu findende benutzerdefinierte Nachrichtenklasse an. Weitere Informationen finden Sie unter Aktivieren eines E-Mail-Add-Ins in Outlook für eine bestimmte Nachrichtenklasse.
IncludeSubClasses Nein Gibt an, ob die Regel „true“ ausgeben soll, wenn das Element einer Unterklasse der angegebenen Nachrichtenklasse angehört; der Standardwert ist false.

Beispiel

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

ItemHasAttachment-Regel

Definiert eine Regel, die „true“ ausgibt, wenn das Element eine Anlage enthält.

Beispiel

<Rule xsi:type="ItemHasAttachment" />

ItemHasKnownEntity-Regel (veraltet)

Warnung

Das <Element ItemHasKnownEntity> ist jetzt veraltet. Geben Sie regeln für reguläre Ausdrücke stattdessen mithilfe des ItemHasRegularExpressionMatch-Elements an.

Definiert eine Regel, die „true“ ausgibt, wenn das Element im Betreff oder im Textkörper Text vom angegebenen Entitätstyp enthält.

Attribute

Attribut Erforderlich Beschreibung
EntityType Ja Gibt den Entitätstyp an, der gefunden werden muss, damit die Regel „true“ ausgibt. Folgende Werte sind möglich: MeetingSuggestion, TaskSuggestion, Address, Url, PhoneNumber, EmailAddress oder Contact.
RegExFilter Nein Gibt einen regulären Ausdruck an, der zur Aktivierung für diese Entität ausgeführt wird.
FilterName Nein Gibt den Namen des regulären Ausdrucksfilters an, damit später im Code Ihres Add-Ins darauf verwiesen werden kann.
IgnoreCase Nein Gibt an, ob die Schreibung ignoriert werden soll, wenn ein Abgleich mit dem vom RegExFilter-Attribut angegebenen regulären Ausdruck erfolgt.
Highlight Nein Hinweis: Dies gilt nur für Rule-Elemente<> in <ExtensionPoint-Elementen>. Gibt an, wie der Client übereinstimmende Entitäten hervorheben soll. Folgende Werte sind möglich: all oder none. Falls keine Angabe erfolgt, ist der Standardwert all.

Beispiel

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

ItemHasRegularExpressionMatch-Regel

Definiert eine Regel, die "true" ausgibt, wenn in der angegebenen Eigenschaft des Elements eine Übereinstimmung mit dem regulären Ausdruck vorhanden ist.

Attribute

Attribut Erforderlich Beschreibung
RegExName Ja Gibt den Namen des regulären Ausdrucks an, damit Sie im Code Ihres Add-Ins auf den Ausdruck verweisen können.
RegExValue Ja Gibt den regulären Ausdruck an, der ausgewertet wird, um zu bestimmen, ob das E-Mail-Add-In angezeigt werden soll.
PropertyName Ja Gibt den Namen der Eigenschaft an, für die der reguläre Ausdruck ausgewertet wird. Folgende Werte sind möglich: Subject, BodyAsPlaintext, BodyAsHTML oder SenderSMTPAddress.

Wenn Sie BodyAsHTML angeben, wendet Outlook den regulären Ausdruck nur an, wenn der Textkörper HTML ist. Andernfalls gibt Outlook keine Übereinstimmungen für diesen regulären Ausdruck zurück.

Wenn Sie BodyAsPlaintext angeben, wendet Outlook stets den regulären Ausdruck auf den Textkörper des Elements an.

Wichtig: Wenn Sie das Highlight-Attribut für das <Rule-Element> angeben müssen, müssen Sie das PropertyName-Attribut auf BodyAsPlaintextfestlegen.
IgnoreCase Nein Gibt an, ob die Schreibung ignoriert werden soll, wenn ein Abgleich mit dem vom RegExName-Attribut angegebenen regulären Ausdruck erfolgt.
Highlight Nein Gibt an, wie der Client übereinstimmenden Text hervorheben soll. Dieses Attribut kann nur auf <Rule-Elemente> in <ExtensionPoint-Elementen> angewendet werden. Folgende Werte sind möglich: all oder none. Falls keine Angabe erfolgt, ist der Standardwert all.

Wichtig: Um das Highlight-Attribut im <Rule-Element> anzugeben, müssen Sie das PropertyName-Attribut auf BodyAsPlaintextfestlegen.

Beispiel

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

RuleCollection

Definiert eine Sammlung von Regeln sowie den logischen Operator, der beim Auswerten der Regeln verwendet werden soll.

Attribute

Attribut Erforderlich Beschreibung
Mode Ja Gibt den logischen Operator an, der beim Auswerten dieser Regelsammlung verwendet werden soll. Folgende Werte sind möglich: And oder Or.

Beispiel

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

Siehe auch