次の方法で共有


メール アドインのマニフェスト ファイル内の VersionOverrides 1.0 要素

この要素には、基本マニフェストでサポートされていない機能に関する情報が含まれます。

注:

この記事では、要素の属性とバリエーションに関する重要な情報が含まれる VersionOverrides 要素の概要について理解していることを前提としています。

アドインの種類: メール

次の VersionOverrides スキーマでのみ有効です:

  • メール 1.0

詳細については、「 アドインのみのマニフェストでのバージョンのオーバーライド」を参照してください。

次の要件セットに関連付けられています:

  • Mailbox 1.3
  • 一部の子要素は、追加の要件セットに関連付けられている場合があります。

子要素

次の表は、 <VersionOverrides> 要素のバージョン 1.0 にのみ適用され、メール アドインにのみ適用されます。

注:

iOS では、<WebApplicationInfo> のみがサポートされます。 <VersionOverrides> の他のすべての子要素は無視されます。

要素 必須 説明
説明 いいえ アドインについての説明。
Requirements いいえ 親 <VersionOverrides> のマークアップを有効にするためにサポートする必要がある最小要件セットを指定します。 これは、マニフェストの基本部分の <Requirements> 要素よりもさらに制限を厳しくする必要があります。
Hosts はい Office アプリケーションのコレクションを指定します。 子 <Hosts> 要素は、マニフェストの親部分の <Hosts> 要素をオーバーライドします。
リソース はい マニフェストの他の要素によって参照されるリソースのコレクション (文字列、URL、画像) を定義します。
<VersionOverrides> いいえ より新しいスキーマ バージョンでアドイン コマンドを定義します。 詳細については、「複数のバージョンを実装する」を参照してください。
WebApplicationInfo いいえ Azure Active Directory V2.0 などの安全なトークン発行者へのアドインの登録に関する詳細を指定します。

説明

アドインの説明です。 マニフェストのすべての親部分の <Description> 要素を上書きします。 説明のテキストは、Resources 要素の LongString 要素の子要素に含まれています。 <Description> 要素の resid 属性は 32 文字以下であり、Resources 要素に含まれる <ShortString> 要素の子要素の id 属性の値と一致する必要があります。

アドインの種類: 作業ウィンドウ、メール

次の VersionOverrides スキーマでのみ有効です:

  • 作業ウィンドウ 1.0
  • メール 1.0
  • メール 1.1

詳細については、「 アドインのみのマニフェストでのバージョンのオーバーライド」を参照してください。

次の要件セットに関連付けられています:

  • <VersionOverrides> が Taskpane 1.0 型の場合、AddinCommands 1.1
  • <VersionOverrides> が Mail 1.0 型の場合、Mailbox 1.3
  • <VersionOverrides> が Mail 1.1 型の場合、Mailbox 1.5

次に簡単な例を示します。 より複雑な例については、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 v1.0 と v1.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>