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 im 2. Quartal 2024 eingestellt. Die Arbeiten zur Einstellung dieses Features beginnen im Mai und werden bis Ende Juni fortgesetzt. Nach Juni können Kontext-Add-Ins keine Entitäten mehr in E-Mail-Elementen erkennen, um Aufgaben für sie auszuführen. Die folgenden APIs werden ebenfalls eingestellt.

Um potenzielle Unterbrechungen zu minimieren, werden die folgenden Elemente weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden.

  • Eine alternative Implementierung der Schaltfläche " An Besprechung teilnehmen ", die von Onlinebesprechungs-Add-Ins aktiviert wird, wird entwickelt. Sobald die Unterstützung für entitätsbasierte Kontext-Add-Ins endet, werden Onlinebesprechungs-Add-Ins automatisch zur alternativen Implementierung übergehen, um die Schaltfläche An Besprechung teilnehmen zu aktivieren.
  • Regeln für reguläre Ausdrücke werden weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Anleitungen zum Implementieren dieser Regeln finden Sie unter Verwenden von Aktivierungsregeln für reguläre Ausdrücke zum Anzeigen eines Outlook-Add-Ins.

Weitere Informationen finden Sie unter Außerbetriebnahme entitätsbasierter kontextbezogener 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

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

<Rule xsi:type="RuleCollection" Mode="And">
  <Rule xsi:type="ItemIs" ItemType="Message" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="MeetingSuggestion" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="Address" Highlight="none" />
</Rule>

Siehe auch