Элемент Action

Статья
11/24/2024

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

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

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

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

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

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

Атрибуты

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

xsi:type

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

ExecuteFunction
ShowTaskpane

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

Важно!

Outlook: регистрация событий почтовых ящиков и элементов недоступна, если xsi:type имеет значение ExecuteFunction.

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

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

xsi:type имеет значение ExecuteFunction.

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

FunctionName

Обязательный элемент, если xsi:type имеет значение ExecuteFunction. Указывает имя выполняемой функции. Функция содержится в файле, указанном в элементе FunctionFile.

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

xsi:type — ShowTaskpane

Элемент	Описание
SourceLocation	Указывает расположение исходного файла для этого действия.
TaskpaneId	Определяет идентификатор для контейнера области задач. Не поддерживается в надстройках Outlook.
Title	Определяет заголовок области задач. Не поддерживается в надстройках Outlook.
SupportsPinning	Указывает, что область задач поддерживает закрепление (область задач остается открытой, когда пользователь выбирает другой элемент). Поддерживается только в Outlook.
SupportsMultiselect	Указывает, что надстройка Outlook может активироваться для нескольких выбранных сообщений. Поддерживается только в Outlook.
SupportsNoItemContext	Указывает, что надстройка 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://commandsimple.azurewebsites.net/Taskpane.html" />
   <bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/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>

SupportsMultiselect

Необязательный элемент в надстройках 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>

SupportsNoItemContext

Необязательный элемент в надстройках 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>

Поделиться через

Элемент Action

Атрибуты

xsi:type

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

xsi:type имеет значение ExecuteFunction.

FunctionName

xsi:type — ShowTaskpane

SourceLocation

TaskpaneId

Название

SupportsPinning

SupportsMultiselect

SupportsNoItemContext

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