Override 要素

  • [アーティクル]

指定した条件に応じてマニフェスト設定の値をオーバーライドする方法を提供します。 条件には次の 3 種類があります。

  • LocaleTokenOverride と呼ばれる、既定LocaleTokenとは異なる Office ロケール。
  • RequirementTokenOverride と呼ばれる既定RequirementTokenのパターンとは異なる要件セットサポートのパターン。
  • ソースは、RuntimeOverride という既定Runtimeの とは異なります。

Runtime 要素の<内部にある Override 要素は、RuntimeOverride 型である必要>があります。><

Override> 要素の<属性はありませんoverrideType。 違いは、親要素と親要素の型によって決まります。 を持つ xsi:typeToken> 要素の<内部にある Override> 要素は、RequirementTokenOverride 型である必要があります。<RequirementToken 他の<親要素内、または型の Override 要素内の Override>>要素は、LocaleTokenOverride 型である必要があります。<LocaleToken Token> 要素の子である場合のこの要素の使用方法の詳細については、「マニフェストの<拡張オーバーライドを操作する」を参照してください。

各型については、この記事の後半の個別のセクションで説明します。

のオーバーライド要素 LocaleToken

<Override> 要素は条件付きを表し、"If .." と読み取ることができます。次に ...."ステートメント。 <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> 要素は条件付きを表し、"If .." と読み取ることができます。次に ...."ステートメント。 <Override> 要素が RequirementTokenOverride 型の場合、子 <Requirements> 要素は条件を表し、その結果として Value 属性が使用されます。 たとえば、次の最初<のオーバーライド>は、"現在のプラットフォームで FeatureOne バージョン 1.7 がサポートされている場合は、祖父母 <ExtendedOverrides> の URL (既定の文字列 'upgrade' ではなく) のトークンの${token.requirements}代わりに文字列 'oldAddinVersion' を使用します。

<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には、アドインの種類に応じて次の子要素が含まれている必要があります。

要素 コンテンツ メール TaskPane
要件 いいえ 不要 はい

属性

属性 種類 必須 説明
値 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

重要

この要素のサポートは、イベント ベースのアクティブ化機能を持つメールボックス要件セット 1.10 で導入されました。 この要件セットをサポートする クライアントおよびプラットフォーム を参照してください。

<Override> 要素は条件付きを表し、"If .." と読み取ることができます。次に ...."ステートメント。 Override> 要素が<RuntimeOverride 型の場合、type属性は条件であり、その結果として resid 属性が使用されます。 たとえば、次は "型が 'javascript' の場合、 resid は 'JSRuntime.Url' です。Windows 上の Outlook では、 LaunchEvent 拡張ポイント と ReportPhishingCommandSurface 拡張ポイント (プレビュー) ハンドラーにこの要素が必要です。

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

アドインの種類: メール

構文

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

含まれる場所

属性

属性 種類 必須 説明
type string はい このオーバーライドの言語を指定します。 現時点では、 "javascript" サポートされている唯一のオプションです。
resid string はい 親 Runtime 要素で定義されている既定の HTML の URL の場所をオーバーライドする JavaScript ファイルの residURL の場所を指定します。 は resid 32 文字以内で、要素内Resourcesの要素のUrl属性と一致idする必要があります。

例

<!-- 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 (preview). -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

関連項目