Action-Element

  • Artikel

Gibt die Aktion an, die ausgeführt werden soll, wenn der Benutzer ein Schaltflächen- oder Menü-Steuerelement auswählt.

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

  • AddinCommands 1.1 , wenn der übergeordnete <VersionOverrides-Typ> Taskpane 1.0 ist.
  • Postfach 1.3 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.0 hat.
  • Postfach 1.5 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.1 hat.

Attribute

Attribut Erforderlich Beschreibung
xsi:type Ja Die Art der durchzuführenden Aktion

xsi:type

Dieses Attribut gibt die Art von Aktion an, die durchgeführt wird, wenn der Benutzer auf die Schaltfläche klickt. Das kann eine der folgenden Aktionen sein:

  • ExecuteFunction
  • ShowTaskpane

Sobald der Benutzer eine Schaltfläche auswählt, die die ExecuteFunction Aktion startet, tritt für das Add-In nach 5 Minuten ein Zeitüberschreitung auf, wenn es bis dahin noch nicht abgeschlossen wurde.

Wichtig

Outlook: Das Registrieren von Postfach- und Item-Ereignissen ist nicht verfügbar, wenn xsi:type istExecuteFunction.

Untergeordnete Elemente

Die gültigen untergeordneten Elemente, die stark vom Wert des xsi:type Parameters abhängen.

xsi:type ist ExecuteFunction

Element Beschreibung
FunctionName Gibt den Namen der auszuführenden Funktion an.

FunctionName

Erforderliches Element, wenn xsi:type ist ExecuteFunction. Gibt den Namen der auszuführenden Funktion an. Die Funktion ist in der Datei enthalten, die im Element FunctionFile angegeben ist.

<Action xsi:type="ExecuteFunction">
  <FunctionName>getSubject</FunctionName>
</Action>

xsi:type ist ShowTaskpane

Element Beschreibung
SourceLocation Gibt den Speicherort der Quelldatei für diese Aktion an.
 TaskpaneId Gibt die ID des Aufgabenbereichscontainers an. Wird in Outlook-Add-Ins nicht unterstützt.
 Title Gibt den benutzerdefinierten Titel für den Aufgabenbereich an. Wird in Outlook-Add-Ins nicht unterstützt.
 SupportsPinning Gibt an, dass ein Aufgabenbereich das Anheften unterstützt, sodass der Aufgabenbereich geöffnet bleibt, wenn der Benutzer die Auswahl ändert. Wird nur in Outlook unterstützt.
SupportsMultiselect Gibt an, dass ein Outlook-Add-In für mehrere ausgewählte Nachrichten aktiviert werden kann. Wird nur in Outlook unterstützt.
SupportsNoItemContext Gibt an, dass ein Outlook-Add-In aktiviert werden kann, ohne dass der Lesebereich aktiviert oder eine Nachricht ausgewählt ist. Wird nur in Outlook-Desktopclients unterstützt.

SourceLocation

Erforderliches Element, wenn xsi:type ist ShowTaskpane. Gibt den Speicherort der Quelldatei für diese Aktion an. Das resid-Attribut darf nicht mehr als 32 Zeichen lang sein und muss auf den Wert des id-Attributs eines <Url-Elements> im <Urls-Element> im Resources-Element festgelegt werden.

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
</Action>

TaskpaneId

Optionales Element, wenn xsi:type ist ShowTaskpane. Gibt die ID des Aufgabenbereichscontainers an. Wenn Sie über mehrere ShowTaskpane Aktionen verfügen, verwenden Sie eine andere <TaskpaneId> , wenn Sie jeweils einen unabhängigen Bereich wünschen. Verwenden Sie dieselbe <TaskpaneId> für verschiedene Aktionen, die denselben Bereich verwenden. Wenn Benutzer Befehle auswählen, die dieselbe <TaskpaneId> verwenden, bleibt der Bereichscontainer geöffnet, aber der Inhalt des Bereichs wird durch die entsprechende Aktion SourceLocationersetzt.

Add-In-Typ: Aufgabenbereich

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Hinweis

Dieses Element wird in Outlook nicht unterstützt.

Das folgende Beispiel zeigt zwei Aktionen, die dieselbe <TaskpaneId> verwenden.

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="aTaskPaneUrl" />
</Action>

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="anotherTaskPaneUrl" />
</Action>

Die folgenden Beispiele zeigen zwei Aktionen, die eine andere <TaskpaneId> verwenden. Diese Beispiele im Kontext finden Sie unter Beispiel für einfache Add-In-Befehle.

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID1</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane1.Url" />
</Action>

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID2</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane2.Url" />
</Action>

<bt:Urls>
   <bt:Url id="Contoso.Taskpane1.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane.html" />
   <bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane2.html" />
</bt:Urls>

Titel

Optionales Element, wenn xsi:type ist ShowTaskpane. Gibt den benutzerdefinierten Titel für den Aufgabenbereich für diese Aktion an.

Add-In-Typ: Aufgabenbereich

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Hinweis

Dieses untergeordnete Element wird in Outlook-Add-Ins nicht unterstützt.

Das folgende Beispiel zeigt eine Aktion, die das <Title-Element> verwendet. Beachten Sie, dass Sie den <Titel> nicht direkt einer Zeichenfolge zuweisen. Stattdessen weisen Sie ihm eine Ressourcen-ID (resid) zu, die <im Abschnitt Ressourcen> des Manifests definiert ist und maximal 32 Zeichen lang sein darf.

<Action xsi:type="ShowTaskpane">
    <TaskpaneId>Office.AutoShowTaskpaneWithDocument</TaskpaneId>
    <SourceLocation resid="PG.Code.Url" />
    <Title resid="PG.CodeCommand.Title" />
</Action>

 ... Other markup omitted ...
<Resources>
    <bt:Images> ...
    </bt:Images>
    <bt:Urls>
        <bt:Url id="PG.Code.Url" DefaultValue="https://localhost:3000?commands=1" />
    </bt:Urls>
    <bt:ShortStrings>
        <bt:String id="PG.CodeCommand.Title" DefaultValue="Code" />
    </bt:ShortStrings>
 ... Other markup omitted ...
</Resources>

SupportsPinning

Optionales Element, wenn xsi:type ist ShowTaskpane. Das enthaltende VersionOverrides-Element muss den xsi:type-Attributwert aufweisen VersionOverridesV1_1. Schließen Sie dieses Element in den Wert von true ein, um das Anheften des Aufgabenbereichs zu unterstützen. Der Benutzer kann dann den Aufgabenbereich „anheften“, sodass dieser geöffnet bleibt, wenn die Auswahl geändert wird. Weitere Informationen finden Sie unter Implementieren eines anheftbaren Aufgabenbereichs in Outlook.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Wichtig

Obwohl das SupportsPinning-Element in Anforderungssatz 1.5 eingeführt wurde, wird es derzeit nur für Microsoft 365-Abonnenten unterstützt, die Folgendes verwenden:

  • Outlook 2016 oder höher unter Windows (Build 7628.1000 oder höher)
  • Outlook 2016 oder höher auf Mac (Build 16.13.503 oder höher)
  • Modernes Outlook im Web
  • neues Outlook unter Windows (Vorschau)
<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Optionales Element in Outlook-Add-Ins, wenn xsi:type ist ShowTaskpane. Fügen Sie den Wert ein true , damit ein Add-In bestimmte Vorgänge für mehrere ausgewählte Nachrichten aktivieren und ausführen kann. Da die Mehrfachauswahl des Elements nur für Nachrichten gilt, muss der xsi:type-Attributwert des ExtensionPoint-Elements auf MessageReadCommandSurface oder MessageComposeCommandSurfacefestgelegt werden. Weitere Informationen zur Mehrfachauswahl von Elementen finden Sie unter Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskpaneUrl" />
    <SupportsMultiSelect>true</SupportsMultiSelect>
</Action>

SupportsNoItemContext

Optionales Element in Outlook-Add-Ins, wenn xsi:type ist ShowTaskpane. Fügen Sie den Wert ein true , damit ein Add-In aktiviert werden kann, ohne dass der Lesebereich aktiviert oder eine Nachricht ausgewählt ist. Wenn <SupportsNoItemContext> auf truefestgelegt ist, muss der xsi:type-Attributwert des ExtensionPoint-Elements auf MessageReadCommandSurfacefestgelegt werden. Weitere Informationen finden Sie unter Aktivieren Ihres Outlook-Add-Ins ohne aktivierten Lesebereich oder ausgewählte Nachricht.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Hinweis

Obwohl Outlook im Web und das neue Outlook unter Windows (Vorschau) den Postfachanforderungssatz 1.13 unterstützen, wird ein Add-In nicht aktiviert, wenn der Lesebereich ausgeblendet ist oder eine Nachricht nicht zuerst ausgewählt wird. Weitere Informationen finden Sie unter Featureunterstützung in Outlook im Web und neuen Outlook unter Windows (Vorschau).

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="Taskpane.Url"/>
    <SupportsNoItemContext>true</SupportsNoItemContext>
</Action>