Элемент VersionOverrides 1.1 в файле манифеста для почтовой надстройки

  • Статья

Этот элемент содержит сведения о функциях, которые не поддерживаются в базовом манифесте.

Примечание.

В этой статье предполагается, что вы знакомы с обзором элемента VersionOverrides, который содержит важную информацию об атрибутах и вариациях элемента.

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

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

  • Почта 1.1

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

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

  • Mailbox 1.5
  • Некоторые дочерние элементы могут быть связаны с дополнительными наборами требований.

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

Следующая таблица применяется только к элементам VersionOverrides> версии 1.1< и только к почтовым надстройкам.

Примечание.

В iOS поддерживается только <WebApplicationInfo> . Все остальные дочерние <элементы VersionOverrides> игнорируются.

Элемент Обязательный Описание
Описание Нет Описывает надстройку.
Requirements Нет Указывает минимальные наборы обязательных элементов, которые должны поддерживаться для того, чтобы разметка в родительской <версииOverrides> вступает в силу. Это всегда должно быть более строгим, <чем элемент Requirements> в базовой части манифеста.
Hosts Да Указывает коллекцию приложений Office. Дочерний элемент Hosts переопределяет элемент Hosts в родительской части манифеста.
Ресурсы Да Определяет коллекцию ресурсов (строк, URL-адресов и изображений), на которые ссылаются другие элементы манифеста.
EquivalentAddins Нет Указывает собственные (COM/XLL) надстройки, эквивалентные веб-надстройке. Веб-надстройка не активируется, если установлена эквивалентная собственная надстройка.
<VersionOverrides> Нет В настоящее время не используется в VersionOverrides 1.1 для почтовых надстроек.
WebApplicationInfo Нет Указывает сведения о регистрации надстройки в издателях маркеров безопасности, таких как Azure Active Directory версии 2.0.
ExtendedPermissions Нет Задает коллекцию расширенных разрешений.

Описание

Описывает надстройку. Это переопределяет <элемент Description> в любой родительской части манифеста. Текст описания содержится в дочернем элементе LongString, включенном в элемент Resources. Атрибут resid<элемента Description> может содержать не более 32 символов и должен соответствовать значению id атрибута дочернего <элемента элемента ShortString> , содержащегося в элементе Resources .

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

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

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

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

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

Пример

Ниже приведен простой пример. Более сложные примеры см. в манифестах примеров надстроек в примерах кода надстроек Office.

Ниже приведен пример типичного <элемента VersionOverrides> , включая некоторые дочерние элементы, которые не являются обязательными, но обычно используются.

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>

Реализация нескольких версий

В манифесте может быть реализовано несколько версий элемента VersionOverrides, которые поддерживают различные версии схемы VersionOverrides. Это можно сделать, чтобы поддерживать новые функции в новой схеме, по-прежнему поддерживая старые клиенты.

Чтобы реализовать несколько версий, элемент VersionOverrides для новой версии должен зависеть от элемента VersionOverrides для старой версии. Дочерний элемент VersionOverrides не наследует значения от родительского объекта.

Для реализации схемы VersionOverrides версии 1.0 и версии 1.1 манифест будет выглядеть примерно так, как показано в следующем примере.

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>

    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
      <Description resid="residDescription" />
      <Requirements>
        <!-- add information on requirements -->
      </Requirements>
      <Hosts>
        <Host xsi:type="MailHost">
          <!-- add information on form factors -->
        </Host>
      </Hosts>
      <Resources>
        <!-- add information on resources -->
      </Resources>
    </VersionOverrides>  
  </VersionOverrides>
...
</OfficeApp>