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

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 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.

Wichtig

Outlook: Die Registrierung Mailbox und ItemEreignisse ist nicht verfügbar, wenn xsi:type ist ExecuteFunction.

Untergeordnete Elemente

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

xsi:type ist ExecuteFunction

Element Beschreibung
FunctionName Gibt den Namen der Funktion an, die ausgeführt werden soll.

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

Element Beschreibung
SourceLocation Gibt den Speicherort der Quelldatei für diese Aktion an.
  TaskpaneId Gibt die ID des Aufgabenbereichscontainers an. Nicht unterstützt in Outlook-Add-Ins.
  Title Gibt den benutzerdefinierten Titel für den Aufgabenbereich an. Nicht unterstützt in Outlook-Add-Ins.
  SupportsPinning Gibt an, dass ein Aufgabenbereich das Anheften unterstützt, sodass der Aufgabenbereich geöffnet bleibt, wenn der Benutzer die Auswahl ändert. Nur in Outlook unterstützt.
Unterstützt Multiselect Gibt an, dass ein Outlook-Add-In für mehrere ausgewählte Nachrichten aktiviert werden kann. 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. 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 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:

Hinweis

Dieses Element wird in Outlook nicht unterstützt.

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:

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 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:

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:

  • Modernes Outlook im Web
  • Das neue Outlook unter Windows
  • Outlook 2016 oder höher auf Windows (Version 1612 (Build 7628.1000) oder höher)
  • Outlook auf Mac (Version 16.13 (18050300) oder höher)
<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:

<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:

Hinweis

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

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