Kontextbezogene Outlook-Add-Ins

Kontext-Add-Ins sind Outlook-Add-Ins, die auf der Grundlage von Text in einer Nachricht oder einem Termin aktiviert werden. Mithilfe von Kontext-Add-Ins kann ein Benutzer Aufgaben im Zusammenhang mit einer Nachricht initiieren, ohne die Nachricht zu verlassen. Dies erhöht die Benutzerfreundlichkeit und bietet den Benutzern mehr Möglichkeiten.

Im Folgenden sind Beispiele für Kontext-Add-Ins aufgeführt:

  • Wählen Sie eine Adresse, um eine Karte des Orts zu öffnen.
  • Wählen Sie eine Zeichenfolge, um eine Besprechungsvorschlag-Add-Ins zu öffnen.
  • Wählen Sie eine Telefonnummer, um sie den Kontakten hinzuzufügen.

Erstellen eines Kontext-Add-Ins

Das Manifest eines Kontext-Add-Ins muss ein ExtensionPoint-Element enthalten, dessen Attribut xsi:type auf DetectedEntity festgelegt ist. Innerhalb des ExtensionPoint-Elements gibt das Add-In die Entitäten oder den regulären Ausdruck an, von denen bzw. dem es aktiviert werden kann. Bei Angabe einer Entität kann die Entität eine beliebige der Eigenschaften im Entities-Objekt sein. Daher muss das Add-In-Manifest eine Regel vom Typ ItemHasKnownEntity oder ItemHasRegularExpressionMatch enthalten. Das folgende Beispiel zeigt, wie Sie eine Entität angeben, die eine Telefonnummer ist:

<Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />

Nachdem ein Kontext-Add-In einem Konto zugeordnet ist, wird es automatisch gestartet, wenn der Benutzer auf eine hervorgehobene Entität oder einen regulären Ausdruck klickt. Weitere Informationen zu regulären Ausdrücken für Outlook-Add-Ins finden Sie unter Verwenden regulärer Ausdrücke für Aktivierungsregeln zum Anzeigen eines Outlook-Add-Ins.

Es gibt verschiedene Einschränkungen für Kontext-Add-Ins:

  • Ein Kontext-Add-In kann nur in Lese-Add-Ins vorhanden sein (nicht in Verfassen-Add-Ins).
  • Sie können die Farbe der hervorgehobenen Entität nicht festlegen.
  • Durch eine nicht hervorgehobene Entität wird kein Kontext-Add-In auf einer Karte gestartet.

Da eine nicht hervorgehobene Entität oder ein nicht hervorgehobener regulärer Ausdruck kein Kontext-Add-In startet, müssen Add-Ins mindestens ein Rule-Element enthalten, dessen Attribut Highlight auf all festgelegt ist.

Hinweis: Die Entitätstypen EmailAddress und Url unterstützen keine Hervorhebung, daher können sie nicht zum Starten eines Kontext-Add-Ins verwendet werden. Sie können jedoch in einem RuleCollection-Regeltyp kombiniert werden, um als zusätzliche Aktivierungskriterien zu dienen.

Starten eines Kontext-Add-Ins

Ein Benutzer startet ein Kontext-Add-In durch Text, entweder eine bekannte Entität oder einen regulären Ausdruck eines Entwicklers. In der Regel identifiziert ein Benutzer ein Kontext-Add-In dadurch, dass die Entität hervorgehoben ist. Im folgenden Beispiel wird gezeigt, wie die Hervorhebung in einer Nachricht angezeigt wird. Hier wird die Entität (eine Adresse) blau und mit einer gepunkteten blauen Linie unterstrichen dargestellt. Ein Benutzer startet das Kontext-Add-In durch Klicken auf die hervorgehobene Entität.

Beispiel für Text mit hervorgehobener Entität (einer Adresse)

Zeigt die hervorgehobene Entität in einer E-Mail

Wenn mehrere Entitäten oder Kontext-Add-Ins in einer Nachricht vorhanden sind, gibt es einige Regeln für die Benutzerinteraktion:

  • Wenn mehrere Entitäten vorhanden sind, muss der Benutzer auf eine andere Entität klicken, um das Add-In dafür zu starten.
  • Wenn eine Entität mehrere Add-Ins aktiviert, wird durch jedes Add-In einer neuen Registerkarte geöffnet. Der Benutzer wechselt zwischen den Registerkarten, um zwischen den Add-Ins zu wechseln. Beispielsweise können ein Name und eine Adresse ein Telefon-Add-In und eine Karte auslösen.
  • Wenn eine Zeichenfolge mehrere Entitäten enthält, die mehrere Add-Ins aktivieren, wird die gesamte Zeichenfolge hervorgehoben, und beim Klicken auf die Zeichenfolge werden alle für die Zeichenfolge relevanten Add-Ins auf separaten Registerkarten angezeigt. Beispielsweise kann eine Zeichenfolge, die eine vorgeschlagene Besprechung in einem Restaurant beschreibt, das Add-In „Vorgeschlagene Besprechungen" und ein Restaurantbewertungs-Add-In aktivieren.

Anzeige eines Kontext-Add-Ins

Ein aktiviertes Kontext-Add-In wird auf einer Karte angezeigt, bei der es sich um ein separates Fenster in der Nähe der Entität handelt. Die Karte wird normalerweise unterhalb der Entität und in Bezug auf die Entität so weit wie möglich zentriert angezeigt. Wenn nicht genug Platz unterhalb der Entität vorhanden ist, wird die Karte darüber platziert. Der folgende Screenshot zeigt die hervorgehobene Entität und darunter ein aktiviertes Add-In (Bing Maps) auf einer Karte.

Beispiel für ein auf einer Karte angezeigtes Add-In

Zeigt ein Kontext-App auf einer Karte

Um die Karte zu schließen und das Add-In zu beenden, muss ein Benutzer auf eine beliebige Stelle außerhalb der Karte klicken.

Aktuelle Kontext-Add-Ins

Die folgenden Kontext-Add-Ins werden standardmäßig für Benutzer mit Outlook-Add-Ins installiert:

  • Bing Maps
  • Vorgeschlagene Besprechungen

Zusätzliche Ressourcen