Kontextbezogene Outlook-Add-Ins

Kontextbezogene 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 selbst zu verlassen. Dies führt zu einer einfacheren und umfangreicheren Benutzererfahrung.

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.

• Office.context.mailbox.item.getEntities()
• Office.context.mailbox.item.getEntitiesByType(entityType)
• Office.context.mailbox.item.getFilteredEntitiesByName(name)
• Office.context.mailbox.item.getSelectedEntities()

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.

Im Folgenden sind Beispiele für kontextbezogene 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

Hinweis

Kontextbezogene Outlook-Add-Ins werden nicht unterstützt, wenn das Add-In ein einheitliches Manifest für Microsoft 365 (Vorschau) verwendet.

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, die es aktivieren können. Wenn eine Entität angegeben wird, kann es sich um eine beliebige der Eigenschaften im Entities-Objekt handeln.

Daher muss das Add-In-Manifest eine Regel vom Typ ItemHasKnownEntity oder ItemHasRegularExpressionMatch enthalten. Das folgende Beispiel zeigt, wie Sie angeben, dass ein Add-In für Nachrichten mit einer erkannten Entität, die eine Telefonnummer ist, aktiviert werden soll.

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="contextLabel" />
  <!--If you opt to include RequestedHeight, it must be between 140px to 450px, inclusive.-->
  <!--<RequestedHeight>360</RequestedHeight>-->
  <SourceLocation resid="detectedEntityURL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message" />
    <Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />
  </Rule>
</ExtensionPoint>

Nachdem ein kontextbezogenes Add-in mit einem Konto verknüpft wurde, wird es automatisch gestartet, wenn der Benutzer auf eine markierte Entität oder auf 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 EmailAddress Entitätstypen und Url unterstützen keine Hervorhebung, sodass sie nicht zum Starten eines Kontext-Add-Ins verwendet werden können. 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. Das folgende Beispiel zeigt, wie die Hervorhebung in einer Nachricht angezeigt wird. Hier ist die Entität (eine Adresse) blau gefärbt und mit einer gepunkteten blauen Linie unterstrichen. Ein Benutzer startet das Kontext-Add-In, indem er auf die hervorgehobene Entität klickt.

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 unter der Entität nicht genügend Platz vorhanden ist, wird der Karte darüber platziert.

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

Aktuelle Kontext-Add-Ins

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

• Bing Maps
• Vorgeschlagene Besprechungen

Siehe auch

• Outlook-Add-In: Contoso-Bestellnummer – Ein Beispiel für ein Kontext-Add-In, das basierend auf einer Übereinstimmung eines regulären Ausdrucks aktiviert wird.
• Schreiben des ersten Outlook-Add-Ins
• Verwenden regulärer Ausdrücke für Aktivierungsregeln zum Anzeigen eines Outlook-Add-Ins
• Entities-Objekt