Freigeben über

Aktivierungsregeln für kontextbezogene Outlook-Add-Ins

  • Artikel

Outlook aktiviert einige Arten von Add-Ins, wenn Nachrichten oder Termine, die der Benutzer gerade liest oder erstellt, den Aktivierungsregeln des Add-Ins entsprechen. Dies gilt für alle Add-Ins, die das Manifestschema 1.1 verwenden. Anschließend kann der Benutzer das Add-In in der Outlook-Benutzeroberfläche auswählen, um es für das aktuelle Element zu starten.

Hinweis

Outlook-Add-In-Features, die von Aktivierungsregeln abhängen, werden nicht unterstützt, wenn das Add-In ein einheitliches App-Manifest für Microsoft 365 verwendet.

Angeben von Aktivierungsregeln in einem Manifest

Damit Outlook ein Add-In für bestimmte Bedingungen aktiviert, geben Sie Aktivierungsregeln im Add-In-Manifest an, indem Sie eines der folgenden Rule Elemente verwenden.

Hinweis

Das Rule Element, das Sie zum Angeben einer einzelnen Regel verwenden, ist vom abstrakten komplexen Rule-Typ . Jeder der folgenden Regeltypen erweitert diesen abstrakten Rule komplexen Typ. Wenn Sie also eine einzelne Regel in einem Manifest angeben, müssen Sie das Attribut xsi:type verwenden, um einen der folgenden Regeltypen genauer zu definieren.

Die folgende Regel definiert beispielsweise eine ItemIs-Regel . <Rule xsi:type="ItemIs" ItemType="Message" />

Das FormType -Attribut gilt für Aktivierungsregeln im Manifest v1.1, ist aber nicht in VersionOverrides v1.0 definiert. Daher kann es nicht verwendet werden, wenn ItemIs im VersionOverrides Knoten verwendet wird.

In der folgenden Tabelle werden die verfügbaren Regeltypen aufgeführt. Weitere Informationen finden Sie im Anschluss an die Tabelle.

Regelname Anwendbare Formulare Beschreibung
ItemIs Lesen, Verfassen Überprüft, ob das aktuelle Element vom angegebenen Typ (Nachricht oder Termin) ist. Kann auch die Elementklasse und den Formulartyp und optional die Elementnachrichtenklasse überprüfen.
ItemHasAttachment Lesen Überprüft, ob das ausgewählte Element über einen Anhang verfügt.
ItemHasRegularExpressionMatch Lesen Überprüft, ob die E-Mail-Adresse des Absenders, der Betreff oder der Textkörper des ausgewählten Elements eine Übereinstimmung mit einem regulären Ausdruck enthält.
RuleCollection Lesen, Verfassen Kombiniert einen Satz von Regeln, damit Sie komplexere Regeln erstellen können.

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.

ItemIs-Regel

Der ItemIs komplexe Typ definiert eine Regel, die ergibt true , ob das aktuelle Element mit dem Elementtyp übereinstimmt, und optional die Elementnachrichtenklasse, wenn sie in der Regel angegeben ist.

Geben Sie einen der folgenden Elementtypen im ItemType -Attribut einer Regel an ItemIs . Sie können mehr als eine ItemIs Regel in einem Manifest angeben. Das ItemType Attribut definiert die Typen von Outlook-Elementen, die Outlook-Add-Ins unterstützen.

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

Das FormType -Attribut wird verwendet, um den Modus (Lesen oder Verfassen) anzugeben, in dem das Add-In aktiviert werden soll.

Hinweis

Das ItemIs-Attribut FormType wird in Schema v1.1 und höher definiert, jedoch nicht in VersionOverrides v1.0. Schließen Sie das FormType Attribut beim Definieren von Add-In-Befehlen nicht ein.

Nach der Aktivierung eines Add-Ins können Sie mit der Eigenschaft mailbox.item das aktuell ausgewählte Element in Outlook und mit der Eigenschaft item.itemType die Art des aktuell ausgewählten Elements abrufen.

Sie können optional das ItemClass -Attribut verwenden, um die Nachrichtenklasse des Elements anzugeben, und das IncludeSubClasses -Attribut, um anzugeben, ob die Regel sein true soll, wenn das Element eine Unterklasse der angegebenen Klasse ist.

Weitere Informationen zu Nachrichtenklassen finden Sie unter Elementtypen und Meldungsklassen.

Das folgende Beispiel ist eine ItemIs Regel, die das Outlook-Add-In aktiviert, wenn der Benutzer eine Nachricht liest.

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

Das folgende Beispiel ist eine ItemIs Regel, die das Outlook-Add-In aktiviert, wenn der Benutzer eine Nachricht oder einen Termin liest.

<Rule xsi:type="RuleCollection" Mode="Or">
  <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
  <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
</Rule>

ItemHasAttachment-Regel

Der ItemHasAttachment komplexe Typ definiert eine Regel, die überprüft, ob das ausgewählte Element eine Anlage enthält.

<Rule xsi:type="ItemHasAttachment" />

"ItemHasRegularExpressionMatch"-Regel

Der ItemHasRegularExpressionMatch komplexe Typ definiert eine Regel, die einen regulären Ausdruck verwendet, um den Inhalt der angegebenen Eigenschaft eines Elements abzugleichen. Verwenden Sie die getRegExMatches - oder getRegExMatchesByName -Methode des -Objekts, das das aktuell ausgewählte Element darstellt, um Übereinstimmungen für den angegebenen regulären Ausdruck abzurufen.

Das folgende Beispiel zeigt eine ItemHasRegularExpressionMatch , die das Add-In aktiviert, wenn der Text des ausgewählten Elements "Apfel", "Banane" oder "Kokosnuss" enthält, wobei die Groß-/Kleinschreibung ignoriert wird.

<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="fruits" RegExValue="apple|banana|coconut" PropertyName="BodyAsPlaintext" IgnoreCase="true" />

Weitere Informationen zur Verwendung der ItemHasRegularExpressionMatch Regel finden Sie unter Kontextbezogene Outlook-Add-Ins.

RuleCollection-Regel

Der RuleCollection komplexe Typ kombiniert mehrere Regeln in einer einzelnen Regel. Mithilfe des -Attributs können Sie angeben, ob die Regeln in der Auflistung mit einem logischen OR oder einem logischen AND Mode kombiniert werden sollen.

Wird ein logisches AND angegeben, muss ein Element mit allen in der Sammlung angegebenen Regeln übereinstimmen, damit das Add-In angezeigt wird. Wenn ein logisches OR angegeben wird, zeigt ein Element, das einer der angegebenen Regeln in der Auflistung entspricht, das Add-In an.

Sie können Regeln kombinieren, um komplexe Regeln zu bilden RuleCollection . Im folgenden Beispiel wird das Add-In aktiviert, wenn der Benutzer einen Termin oder eine Nachricht anzeigt, die eine Anlage enthält.

<Rule xsi:type="RuleCollection" Mode="And">
  <Rule xsi:type="RuleCollection" Mode="Or">
    <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
    <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
  </Rule>
  <Rule xsi:type="ItemHasAttachment" />
</Rule>

Im folgenden Beispiel wird das Add-In aktiviert, wenn der Benutzer eine Nachricht verfasst oder wenn der Benutzer einen Termin anzeigt und dessen Betreff "Vertrieb", "Marketing" oder "Finanzen" enthält.

<Rule xsi:type="RuleCollection" Mode="Or">
  <Rule xsi:type="ItemIs" ItemType="Message" FormType="Edit" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="Read" />
    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="departments" RegExValue="sales|marketing|finance" PropertyName="Subject" IgnoreCase="true" />
  </Rule> 
</Rule>

Einschränkungen für Regeln und reguläre Ausdrücke

Für eine zufriedenstellende Erfahrung mit Outlook-Add-Ins sollten Sie die Richtlinien für die Aktivierung und die API-Verwendung befolgen. Weitere Informationen zu diesen Richtlinien finden Sie unter Grenzwerte für die Aktivierung und JavaScript-API für Outlook-Add-Ins und Problembehandlung bei der Aktivierung von Outlook-Add-Ins.

Siehe auch