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

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

  • Статья

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

Примечание.

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

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

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

  • Почта 1.0

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

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

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

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

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

Примечание.

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

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

Описание

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

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

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

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

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

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

Пример

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

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