Элемент Action

Определяет действие, которое необходимо выполнить, когда пользователь выбирает элемент управления кнопкой или меню .

Допустимо только в следующих схемах VersionOverrides:

Область задач 1.0
Почта 1.0
Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

AddinCommands 1.1 , если родительским <параметром VersionOverrides> является тип области задач 1.0.
Почтовый ящик 1.3 , если родительское <значение VersionOverrides> имеет тип Mail 1.0.
Почтовый ящик 1.5 , если родительское <значение VersionOverrides> имеет тип Mail 1.1.

Атрибуты

Атрибут	Обязательный	Описание
xsi:type	Да	Тип выполняемого действия

xsi:type

Этот атрибут указывает действие, которое выполняется, когда пользователь нажимает кнопку. Допустимые значения:

ExecuteFunction
ShowTaskpane

После того как пользователь нажмет кнопку, которая запускает ExecuteFunction действие, надстройка не завершит работу через 5 минут, если она еще не завершена.

Важно!

Outlook: Регистрация Mailbox и Itemсобытия недоступны, если xsi:type имеет значение ExecuteFunction.

Дочерние элементы

Допустимые дочерние элементы очень зависят от значения параметра xsi:type .

xsi:type is ExecuteFunction

Элемент	Описание
FunctionName	Указывает имя выполняемой функции.

FunctionName

Обязательный элемент, если xsi:type равен ExecuteFunction. Указывает имя выполняемой функции. Функция содержится в файле, указанном в элементе FunctionFile. Значение, указанное в элементе <FunctionName> , должно соответствовать значению, переданному actionId в параметр вызова Office.actions.associate в файле, содержащем функцию. Это гарантирует вызов правильной функции при выборе элемента управления кнопкой или элементом меню. Дополнительные сведения см. в статье Создание команд надстроек с манифестом только надстройки.

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

xsi:type is ShowTaskpane

Элемент	Описание
SourceLocation	Указывает расположение исходного файла для этого действия.
TaskpaneId	Определяет идентификатор для контейнера области задач. Не поддерживается в надстройках Outlook.
Title	Определяет заголовок области задач. Не поддерживается в надстройках Outlook.
SupportsPinning	Указывает, что область задач поддерживает закрепление (область задач остается открытой, когда пользователь выбирает другой элемент). Поддерживается только в Outlook.
ПоддерживаетMultiselect	Указывает, что надстройку Outlook можно активировать для нескольких выбранных сообщений. Поддерживается только в Outlook.
ПоддерживаетNoItemContext	Указывает, что надстройку Outlook можно активировать без включения области чтения или выбора сообщения. Поддерживается только в классических клиентах Outlook.

SourceLocation

Обязательный элемент, если xsi:type равен ShowTaskpane. Указывает расположение исходного файла для этого действия. Атрибут resid может содержать не более 32 символов и должен быть установлен в значение атрибута <id элемента Url в элементе Urls>>в элементе< Resources.

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

TaskpaneId

Необязательный элемент, если xsi:type равен ShowTaskpane. Определяет идентификатор для контейнера области задач. Если у вас есть несколько ShowTaskpane действий, используйте разные <TaskpaneId> , если вам нужна независимая панель для каждого из них. Используйте один и тот же <идентификатор TaskpaneId> для разных действий, которые имеют одну и ту же панель. При выборе команд с одним и тем же <идентификатором TaskpaneId> контейнер панели остается открытым, но содержимое панели заменяется соответствующим действием SourceLocation.

Тип надстройки: надстройки области задач

Допустимо только в следующих схемах VersionOverrides:

Область задач 1.0

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

AddinCommands 1.1

Примечание.

Этот элемент не поддерживается в Outlook.

В следующем примере показаны два действия, которые используют один и тот же <TaskpaneId>.

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

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

В следующих примерах показаны два действия, которые используют разный <TaskpaneId>.

<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://localhost:3000/Taskpane.html" />
  <bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://localhost:3000/Taskpane2.html" />
</bt:Urls>

Название

Необязательный элемент, если xsi:type равен ShowTaskpane. Определяет заголовок области задач для этого действия.

Тип надстройки: надстройки области задач

Допустимо только в следующих схемах VersionOverrides:

Область задач 1.0

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

AddinCommands 1.1

Примечание.

Этот дочерний элемент не поддерживается в надстройках Outlook.

В следующем примере показано действие, использующее <элемент Title> . Обратите внимание, что вы не назначаете <заголовок> строке напрямую. Вместо этого ему назначается идентификатор ресурса (resid), который определяется в <разделе "Ресурсы> " манифеста и может содержать не более 32 символов.

<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

Необязательный элемент, если xsi:type равен ShowTaskpane. Содержащие элементы VersionOverrides должны иметь значение атрибута xsi:type , равное VersionOverridesV1_1. Включите этот элемент со значением true для поддержки закрепления области задач. Пользователь сможет закрепить область задач, после чего она будет оставаться открытой при выборе другого элемента. Дополнительные сведения см. в статье Реализация закрепляемой области задач в Outlook.

Тип надстройки: почтовая

Допустимо только в следующих схемах VersionOverrides:

Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

Mailbox 1.5

Важно!

Хотя элемент SupportsPinning был добавлен в набор требований 1.5, в настоящее время он поддерживается только для подписчиков Microsoft 365 с использованием следующего:

Современная версия Outlook в Интернете
новый Outlook для Windows
Outlook 2016 или более поздняя версия для Windows (версия 1612 (сборка 7628.1000) или более поздняя)
Outlook для Mac (версия 16.13 (18050300) или более поздняя)

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

ПоддерживаетMultiselect

Необязательный элемент в надстройках Outlook , когда xsi:type равен ShowTaskpane. Включает значение, true позволяющее надстройке активировать и выполнять определенные операции с несколькими выбранными сообщениями. Поскольку множественный выбор элемента применяется только к сообщениям, значение атрибута xsi:type элемента ExtensionPoint должно быть установлено равным MessageReadCommandSurface или MessageComposeCommandSurface. Дополнительные сведения о выборе нескольких элементов см. в статье Активация надстройки Outlook для нескольких сообщений.

Тип надстройки: почтовая

Допустимо только в следующих схемах VersionOverrides:

Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

Почтовый ящик 1.13

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

ПоддерживаетNoItemContext

Необязательный элемент в надстройках Outlook , когда xsi:type равен ShowTaskpane. Включите значение true для разрешения активации надстройки без включения области чтения или выбора сообщения. Если <для SupportsNoItemContext> задано значение trueатрибута xsi:type элемента ExtensionPoint, должно быть установлено значение MessageReadCommandSurface. Дополнительные сведения см. в статье "Активация надстройки Outlook без включения области чтения или выбора сообщения".

Тип надстройки: почтовая

Допустимо только в следующих схемах VersionOverrides:

Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

Почтовый ящик 1.13

Примечание.

Несмотря на то, что Outlook в Интернете и новый Outlook в Windows поддерживают требование к почтовому ящику 1.13, надстройка не активируется, если область чтения скрыта или сообщение не выбрано сначала. Дополнительные сведения см. в статьях "Поддержка функций в Outlook в Интернете" и "Новый Outlook для Windows".

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-09-17

Элемент Action

Атрибуты

xsi:type

Дочерние элементы

xsi:type is ExecuteFunction

FunctionName

xsi:type is ShowTaskpane

SourceLocation

TaskpaneId

Название

SupportsPinning

ПоддерживаетMultiselect

ПоддерживаетNoItemContext

Обратная связь

Дополнительные ресурсы