Override 要素

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

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

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

<Override> 要素に overrideType 属性はありません。 相違点は、親要素と親要素の型によって決まります。 xsi:typeが RequirementToken の <Token> 要素内にある <Override> 要素は、型が RequirementTokenOverride である必要があります。 他の親要素内、または型 LocaleToken の <Override> 要素内の <Override> 要素は、LocaleTokenOverride 型である必要があります。

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

オーバーライドする要素 LocaleToken

<オーバーライド> 要素は条件を表し、"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>

含まれる場所

属性

例

<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 アドインのローカライズ
• SharePoint のキーボード ショートカット

オーバーライドする要素 RequirementToken

<オーバーライド> 要素は条件を表し、"If ...それから...」ステートメント。 <Override> 要素が RequirementTokenOverride 型の場合、子 <Requirements> 要素は条件を表し、Value 属性は結果です。 たとえば、以下の最初の <オーバーライド> は、「現在のプラットフォームが FeatureOne バージョン 1.7 をサポートしている場合、祖父母の URL で ${token.requirements} トークンの代わりに文字列 'oldAddinVersion' を使用してください <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 の <Override> 要素には、アドインの種類に応じて、次の子要素を含める必要があります。

属性

例

<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 のバージョンとプラットフォームを指定する
• SharePoint のキーボード ショートカット

オーバーライドする要素 Runtime

<オーバーライド> 要素は条件を表し、"If ...それから...」ステートメント。 <Override> 要素が RuntimeOverride 型の場合、type 属性は条件であり、resid 属性は結果です。 たとえば、次のようになります: "型が 'javascript' の場合、residは 'JSRuntime.Url' です。Windows 上の Excel、PowerPoint、Word、および Windows 上の従来の Outlook では、LaunchEvent 拡張ポイントと ReportPhishingCommandSurface 拡張ポイント ハンドラーにこの要素が必要です。

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

アドインの種類: ドキュメント、メール、プレゼンテーション、ブック

構文

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

含まれる場所

• ランタイム

属性

例

<!-- 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>

関連項目

• ランタイム
• イベントを使用してアドインをアクティブ化する