Элемент Override

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

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

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

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

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

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

См. также

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

Элемент <Override> выражает условное выражение и может быть прочитан как «Если ... затем...» заявление. <Если элемент Override> имеет тип RequirementTokenOverride, то дочерний <элемент 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" />

Содержится в

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

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

Переопределяемый<> элемент должен содержать следующие дочерние элементы в 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>

См. также

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

Важно!

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

Элемент <Override> выражает условное выражение и может быть прочитан как «Если ... затем...» заявление. <Если элемент Override> имеет тип RuntimeOverride, то type атрибут является условием, а resid атрибут — следствием. Например, это звучит следующим образом: "Если тип "javascript", то значением resid будет "JSRuntime.Url"". Для Excel, PowerPoint и Word в Windows и классического 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-кода по умолчанию, определенного в файле .resid Он resid может содержать не более 32 символов и должен соответствовать атрибуту idUrl элемента в элементе 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>

См. также

  • Last updated on