Kontextbezogene Outlook-Add-InsContextual 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.Contextual add-ins are Outlook add-ins that activate based on text in a message or appointment. By using contextual add-ins, a user can initiate tasks related to a message without leaving the message itself, which results in an easier and richer user experience.

Im Folgenden sind Beispiele für Kontext-Add-Ins aufgeführt:The following are examples of contextual add-ins:

  • Wählen Sie eine Adresse, um eine Karte des Orts zu öffnen.Choosing an address to open a map of the location.
  • Wählen Sie eine Zeichenfolge, um eine Besprechungsvorschlag-Add-Ins zu öffnen.Choosing a string that opens a meeting suggestion add-in.
  • Wählen Sie eine Telefonnummer, um sie den Kontakten hinzuzufügen.Choosing a phone number to add to your contacts.

Erstellen eines Kontext-Add-InsHow to make a contextual add-in

Das Manifest eines Kontext-Add-Ins muss ein ExtensionPoint-Element enthalten, dessen Attribut xsi:type auf DetectedEntity festgelegt ist.A contextual add-in's manifest must include an ExtensionPoint element with an xsi:type attribute set to DetectedEntity. 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.Within the ExtensionPoint element, the addin specifies the entities or regular expression that can activate it. Wenn eine Entität angegeben wird, kann es sich um eine beliebige der Eigenschaften im Entities-Objekt handeln.If specifying an entity, the entity can be any of the properties in the Entities object. Daher muss das Add-In-Manifest eine Regel vom Typ ItemHasKnownEntity oder ItemHasRegularExpressionMatch enthalten.Thus, the add-in manifest must contain a rule of type ItemHasKnownEntity or ItemHasRegularExpressionMatch. Das folgende Beispiel zeigt, wie Sie festlegen, dass ein Add-In für Nachrichten mit einer erkannten Entität aktiviert werden soll, die eine Telefonnummer ist:The following example shows how to specify that an add-in should activate on messages with a detected entity that is a phone number:

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="contextLabel" />
  <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 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.After a contextual add-in is associated with an account, it will automatically start when the user clicks a highlighted entity or regular expression. For more information on regular expressions for Outlook add-ins, see Use regular expression activation rules to show an Outlook add-in.

Es gibt verschiedene Einschränkungen für Kontext-Add-Ins:There are several restrictions on contextual add-ins:

  • Ein Kontext-Add-In kann nur in Lese-Add-Ins vorhanden sein (nicht in Verfassen-Add-Ins).A contextual add-in can only exist in read add-ins (not compose add-ins).
  • Sie können die Farbe der hervorgehobenen Entität nicht festlegen.You cannot specify the color of the highlighted entity.
  • Durch eine nicht hervorgehobene Entität wird kein Kontext-Add-In auf einer Karte gestartet.An entity that is not highlighted will not launch a contextual add-in in a card.

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.Because an entity or regular expression that is not highlighted will not launch a contextual add-in, add-ins must include at least one Rule element with the Highlight attribute set to all.

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.EmailAddress The Url and RuleCollection entity types do not support highlighting, so they cannot be used to launch a contextual add-in. They can however be combined in a rule type as an additional activation criteria.

Starten eines Kontext-Add-InsHow to launch a contextual add-in

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.A user launches a contextual add-in through text, either a known entity or a developer's regular expression. Typically, a user identifies a contextual add-in because the entity is highlighted. The following example shows how highlighting appears in a message. Here the entity (an address) is colored blue and underlined with a dotted blue line. A user launches the contextual add-in by clicking the highlighted entity.

Beispiel für Text mit hervorgehobener Entität (einer Adresse)Example of text with highlighted entity (an address)

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:When there are multiple entities or contextual add-ins in a message, there are a few user interaction rules:

  • Wenn mehrere Entitäten vorhanden sind, muss der Benutzer auf eine andere Entität klicken, um das Add-In dafür zu starten.If there are multiple entities, the user has to click a different entity to launch the add-in for it.
  • 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.If an entity activates multiple add-ins, each add-in opens a new tab. The user switches between tabs to change between add-ins. For example, a name and address might trigger a phone add-in and a map.
  • 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.If a single string contains multiple entities that activate multiple add-ins, the entire string is highlighted, and clicking the string shows all add-ins relevant to the string on separate tabs. For example, a string that describes a proposed meeting at a restaurant might activate the Suggested Meeting add-in and a restaurant rating add-in.

Anzeige eines Kontext-Add-InsHow a contextual add-in displays

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.An activated contextual add-in appears in a card, which is a separate window near the entity. The card will normally appear below the entity and centered with respect to the entity as much as possible. If there is not enough room below the entity, the card is placed above it. The following screenshot shows the highlighted entity, and below it, an activated add-in (Bing Maps) in a card.

Beispiel für ein auf einer Karte angezeigtes Add-InExample of an add-in displayed in a card

Zeigt ein Kontext-App auf einer Karte

Um die Karte und das Add-In zu schließen, muss ein Benutzer auf eine beliebige Stelle außerhalb der Karte klicken.To close the card and end the add-in, a user clicks anywhere outside of the card.

Aktuelle Kontext-Add-InsCurrent contextual add-ins

Die folgenden Kontext-Add-Ins werden standardmäßig für Benutzer mit Outlook-Add-Ins installiert:The following contextual add-ins are installed by default for users with Outlook add-ins:

  • Bing MapsBing Maps
  • Vorgeschlagene BesprechungenSuggested Meetings

Zusätzliche RessourcenAdditional Resources