Freigeben über

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 als true ausgewertet wird, wenn das ausgewählte Element im Lese- oder Verfassenformular den angegebenen Typ aufweist. Sie können mehr als eine ItemIs Regel im Manifest angeben.

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 Elementtypen und Nachrichtenklassen.
IncludeSubClasses Nein Gibt an, ob die Regel „true“ ausgeben soll, wenn das Element einer Unterklasse der angegebenen Nachrichtenklasse angehört; der Standardwert ist false.

ItemType

In der folgenden Tabelle werden die Appointment Elementtypen und Message beschrieben, die ItemType Sie im -Attribut angeben können.

Wert Beschreibung
Appointment Gibt ein Element in einem Outlook-Kalender an. Dies umfasst ein Besprechungselement, auf das geantwortet wurde und über einen Organisator und Teilnehmer verfügt, oder einen Termin, der keinen Organisator oder Teilnehmer hat und einfach ein Element im Kalender ist. Entspricht der IPM.Appointment-Nachrichtenklassen in Outlook:
Meldung Gibt eines der folgenden Elemente an, die normalerweise im Posteingang empfangen werden.

  • Eine E-Mail-Nachricht. Entspricht der Nachrichtenklasse "IPM.Note" in Outlook.

  • Eine Besprechung, Antwort oder ein Abbruch. Dies entspricht den folgenden Nachrichtenklassen in Outlook.

    IPM.Schedule.Meeting.Request

    IPM.Schedule.Meeting.Neg

    IPM.Schedule.Meeting.Pos

    IPM.Schedule.Meeting.Tent

    IPM.Schedule.Meeting.Canceled

Beispiel

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

ItemHasAttachment-Regel

Definiert eine Regel, die als true ausgewertet wird, wenn das Element im Leseformular 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 als true ausgewertet wird, wenn eine Übereinstimmung für den angegebenen regulären Ausdruck in der angegebenen Eigenschaft des Elements in Leseform gefunden werden kann.

Informationen zum Implementieren der ItemHasRegularExpressionMatch Regel finden Sie unter Kontextbezogene Outlook-Add-Ins.

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