Action-Element

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 reinen Add-In-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

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.

Untergeordnete Elemente

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

xsi:type ist ExecuteFunction

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

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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1

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>

Position

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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1

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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Mailbox 1.5

<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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Postfach 1.13

<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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Postfach 1.13

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