Action-Element

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

Nur in diesen VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0
• Mail 1.0
• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1 , wenn die übergeordnete <VersionOverrides> vom Typ Taskbereich 1.0 ist.
• Postfach 1.3 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.0 ist.
• Postfach 1.5 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.1 ist.

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 zum Auslösen der ExecuteFunction Aktion auswählt, kommt es nach 5 Minuten zu einem Timeout für das Add-In, wenn es bis dahin nicht abgeschlossen wurde.

Untergeordnete Elemente

Die gültigen untergeordneten Elemente hängen stark vom Wert des xsi:type Parameters ab.

xsi:type ist ExecuteFunction

FunctionName

Erforderliches Element, wenn xsi:type ist ExecuteFunction. Gibt den Namen der Funktion an, die ausgeführt werden soll. Die Funktion ist in der Datei enthalten, die im Element FunctionFile angegeben ist. Der im <FunctionName-Element> angegebene Wert muss mit dem Wert übereinstimmen, der an den actionId Parameter des Office.actions.associate-Aufrufs in der Datei übergeben wird, die die Funktion enthält. Dadurch wird sichergestellt, dass die richtige Funktion aufgerufen wird, wenn die Schaltfläche oder das Menüelementsteuerelement ausgewählt ist. Weitere Informationen finden Sie unter Erstellen von Add-In-Befehlen mit dem Nur-Add-In-Manifest.

<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 länger als 32 Zeichen sein und muss auf den Wert des id-Attributs eines <Url-Elements> im <Urls-Element>des Resources-Elements 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 mehrere ShowTaskpane Aktionen haben, verwenden Sie eine andere <TaskpaneId> , wenn Sie für jede 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> haben, bleibt der Bereichscontainer geöffnet, aber der Inhalt des Bereichs wird durch die entsprechende Aktion SourceLocationersetzt.

Add-In-Typ: Aufgabenbereich

Nur in diesen VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1

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

<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. Wenn Sie diese Beispiele im Kontext sehen möchten, lesen Sie 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 diesen VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-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 Resources> des Manifests definiert wird und nicht länger als 32 Zeichen 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. Die enthaltenden VersionOverrides-Elemente müssen einen xsi:type-Attributwert von VersionOverridesV1_1haben. 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 diesen VersionOverrides-Schemas gültig:

• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Mailbox 1.5

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

Unterstützt Multiselect

Optionales Element in Outlook-Add-Ins, wenn xsi:type den Wert .ShowTaskpane Geben Sie den Wert an true , um es einem Add-In zu ermöglichen, bestimmte Vorgänge für mehrere ausgewählte Nachrichten zu aktivieren und auszuführen. Da die Mehrfachauswahl von Elementen nur für Nachrichten gilt, muss der Attributwert xsi:type des ExtensionPoint-Elements auf MessageReadCommandSurface oder MessageComposeCommandSurfacegesetzt 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 diesen VersionOverrides-Schemas gültig:

• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-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 den Wert .ShowTaskpane Geben Sie den Wert an true , um die Aktivierung eines Add-Ins ohne aktivierten Lesebereich oder ohne ausgewählte Meldung zu ermöglichen. Wenn <SupportsNoItemContext> festgelegt ist auf true, muss der xsi:type-Attributwert des ExtensionPoint-Elements auf MessageReadCommandSurfacegesetzt werden. Weitere Informationen finden Sie unter "Aktivieren Ihres Outlook-Add-Ins" ohne aktivierten Lesebereich oder ohne ausgewählte Nachricht.

Add-In-Typ: Mail

Nur in diesen VersionOverrides-Schemas gültig:

• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Postfach 1.13

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