Элемент Override

Предоставляет способ переопределения значения параметра манифеста в зависимости от указанного условия. Существует три типа условий:

• Языковой стандарт Office, отличный от стандартного LocaleToken, с именем LocaleTokenOverride.
• Шаблон поддержки набора требований, отличающийся от шаблона по умолчанию RequirementToken , который называется RequirementTokenOverride.
• Источник отличается от используемого по умолчанию Runtime, который называется RuntimeOverride.

Элемент <Override> , который находится внутри <элемента Runtime> , должен иметь тип RuntimeOverride.

Атрибут для <элемента Override> отсутствуетoverrideType. Разница определяется родительским элементом и типом родительского элемента. Элемент <Override> , который находится внутри <элемента Token> , который xsi:type имеет значение RequirementToken, должен иметь тип RequirementsTokenOverride. Элемент <Override> внутри любого другого родительского <элемента или внутри элемента Override> типа LocaleTokenдолжен иметь тип LocaleTokenOverride. Дополнительные сведения об использовании этого элемента, когда он является дочерним элементом <элемента Token> , см. в статье Работа с расширенными переопределениями манифеста.

Каждый тип описан в отдельных разделах далее в этой статье.

Переопределение элемента для LocaleToken

Элемент <Override> выражает условное выражение и может быть прочитан как "Если... тогда ..." Заявление. <Если элемент Override> имеет тип LocaleTokenOverride, то Locale атрибут является условием, а Value атрибут — последующим. Например, следующий текст: "Если языковой стандарт Office имеет значение fr-fr, отображаемое имя — "Lecteur vidéo".

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

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

Синтаксис

<Override Locale="string" Value="string"></Override>

Содержится в

Элемент
CitationText
Описание
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Image
QueryUri
SourceLocation
String
SupportUrl
Маркер
Url

Атрибуты

Атрибут	Тип	Обязательный	Описание
Locale	string	Да	Указывает имя языка и региональных параметров для этого переопределения в формате тега языка BCP 47, например "en-US".
Значение	string	Да	Задает значение параметра, представленное для указанного языкового стандарта.

Примеры

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

<bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
    <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
</bt:Image>

  <ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.locale}/extended-manifest-overrides.json">
    <Tokens>
      <Token Name="locale" DefaultValue="en-us" xsi:type="LocaleToken">
        <Override Locale="es-*" Value="es-es" />
        <Override Locale="es-mx" Value="es-mx" />
        <Override Locale="fr-*" Value="fr-fr" />
        <Override Locale="ja-jp" Value="ja-jp" />
      </Token>
    <Tokens>
  </ExtendedOverrides>

См. также

• Локализация надстроек для Office
• Сочетания клавиш

Переопределение элемента для RequirementToken

Элемент <Override> выражает условное выражение и может быть прочитан как "Если... тогда ..." Заявление. <Если элемент Override> имеет тип RequirementsTokenOverride, то дочерний <элемент Requirements> выражает условие, а Value атрибут является последующим. Например, первое<> переопределение в следующем: "Если текущая платформа поддерживает FeatureOne версии 1.7, используйте строку "oldAddinVersion" вместо ${token.requirements} маркера в URL-адресе бабушки и дедушки <ExtendedOverrides> (вместо строки по умолчанию upgrade)."

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Tokens>
        <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
            <Override Value="oldAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.7" />
                    </Sets>
                </Requirements>
            </Override>
            <Override Value="currentAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.8" />
                    </Sets>
                    <Methods>
                        <Method Name="MethodThree" />
                    </Methods>
                </Requirements>
            </Override>
        </Token>
    </Tokens>
</ExtendedOverrides>

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

Синтаксис

<Override Value="string" />

Содержится в

Элемент
Маркер

Должен содержать

Элемент <Override> для RequirementToken должен содержать следующие дочерние элементы в зависимости от типа надстройки.

Элемент	Контентная	Почта	Область задач
Требования	Нет	Нет	Да

Атрибуты

Атрибут	Тип	Обязательный	Описание
Значение	string	Да	Значение маркера бабушки и дедушки при выполнении условия.

Пример

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
        <Override Value="very-old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.5" />
                    <Set Name="FeatureTwo" MinVersion="1.1" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.7" />
                    <Set Name="FeatureTwo" MinVersion="1.2" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="current">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.8" />
                    <Set Name="FeatureTwo" MinVersion="1.3" />
                </Sets>
                <Methods>
                    <Method Name="MethodThree" />
                </Methods>
            </Requirements>
        </Override>
    </Token>
</ExtendedOverrides>

См. также

• Версии Office и наборы обязательных элементов
• Укажите, на каких версиях и платформах Office может размещаться надстройка
• Сочетания клавиш

Переопределение элемента для Runtime

Важно!

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

Элемент <Override> выражает условное выражение и может быть прочитан как "Если... тогда ..." Заявление. <Если элемент Override> имеет тип RuntimeOverride, то type атрибут является условием, а resid атрибут — последующим. Например, следующее: "Если тип является "javascript", то resid имеет значение "JSRuntime.Url". Outlook в Windows требуется этот элемент для обработчиков точки расширения LaunchEvent и точки расширения ReportPhishingCommandSurface (предварительная версия).

<Runtime resid="WebViewRuntime.Url">
  <Override type="javascript" resid="JSRuntime.Url"/>
</Runtime>

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

Синтаксис

<Override type="javascript" resid="JSRuntime.Url"/>

Содержится в

• Время выполнения

Атрибуты

Атрибут	Тип	Обязательный	Описание
type	string	Да	Задает язык для этого переопределения. В настоящее время "javascript" является единственным поддерживаемым вариантом.
resid	string	Да	Указывает URL-адрес файла JavaScript, который должен переопределять URL-адрес HTML-кода по умолчанию, определенного в родительском элементе residRuntime . Объект resid может содержать не более 32 символов и должен соответствовать id атрибуту Url элемента в элементе Resources .

Примеры

<!-- Event-based activation and integrated spam reporting happen in a lightweight runtime.-->
<Runtimes>
  <!-- HTML file including reference to or inline JavaScript event handlers.
  This is used by Outlook on the web, on the new Mac UI, and new Outlook on Windows. -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

См. также

• Время выполнения
• Настройка надстройки Outlook для активации на основе событий