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


Элемент Action

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

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

  • Область задач 1.0
  • Почта 1.0
  • Почта 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

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

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

Примечание.

Этот элемент не поддерживается в 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

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

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

Примечание.

Этот дочерний элемент не поддерживается в надстройках 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

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

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

Важно!

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

  • Современная версия Outlook в Интернете
  • новый Outlook в Windows
  • Outlook 2016 или более поздней версии в Windows (сборка 7628.1000 или более поздняя версия)
  • Outlook на Mac (сборка 16.13.503 или более поздняя версия)
<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

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

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

<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

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

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

Примечание.

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

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