Rule-Element

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

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

Wichtig

Dieser Element- oder Attributwert ist dokumentiert, um Entwicklern bei der Problembehandlung vorhandener kontextbezogener Outlook-Add-Ins zu helfen. Es wird empfohlen, keine neuen kontextbezogenen Outlook-Add-Ins zu erstellen.

  • Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt.
  • Szenarien, für die Regeln für reguläre Ausdrücke in kontextbezogenen Add-Ins erforderlich waren, können jetzt mit ereignisbasierten Outlook-Add-Ins implementiert werden, die automatisch als Reaktion auf Ereignisse wie das Erstellen einer neuen Nachricht oder Besprechung aktiviert werden. JavaScript bietet integrierte Unterstützung für reguläre Ausdrücke, und Sie können auch auf JavaScript-Bibliotheken verweisen, die erweiterte Funktionen für reguläre Ausdrücke bereitstellen. Im Gegensatz zu kontextbezogenen Add-Ins können ereignisbasierte Add-Ins sowohl im Verfassenkontext als auch im Lesemodus verwendet werden.

Enthalten in

Attribute

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

Es kann sich um einen der folgenden Regeltypen handeln:

ItemIs-Regel

Definiert eine Regel, die als wahr ausgewertet wird, wenn das ausgewählte Element im Lese- oder Verfassen-Format vom angegebenen Typ ist. 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 auf einem Rule innerhalb eines angegeben ExtensionPointwird, 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 Und-Elementtypen beschrieben, die AppointmentMessageItemType Sie im Attribut angeben können.

Wert Beschreibung
Appointment Gibt ein Element in einem Outlook-Kalender an. Dazu gehört ein Besprechungselement, auf das geantwortet wurde und das einen Organisator und Teilnehmer aufweist, oder ein Termin, das 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, das normalerweise im Posteingang empfangen wird.

  • 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 wahr ausgewertet wird, wenn das Element im Leseformat eine Anlage enthält.

Beispiel

<Rule xsi:type="ItemHasAttachment" />

ItemHasKnownEntity-Regel (veraltet)

Warnung

Das <ItemHasKnownEntity-Element> ist jetzt veraltet. Geben Sie stattdessen Regeln für reguläre Ausdrücke mit dem ItemHasRegularExpressionMatch-Element 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 <Regelelemente> innerhalb von< 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 wahr 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 BodyAsPlaintextsetzen.
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 <Regelelemente> innerhalb von <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 BodyAsPlaintextsetzen.

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

  • Zuletzt aktualisiert um