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

  • [アーティクル]

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

注:

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

アドインの種類: メール

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

  • メール 1.1

詳細については、「マニフェストでのバージョンの上書き」をご覧ください。

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

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

子要素

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

注:

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

要素 必須 説明
説明 いいえ アドインについての説明。
Requirements いいえ 親 <VersionOverrides> のマークアップを有効にするためにサポートする必要がある最小要件セットを指定します。 これは、マニフェストの基本部分の <Requirements> 要素よりもさらに制限を厳しくする必要があります。
Hosts はい Office アプリケーションのコレクションを指定します。 子の Host 要素は、マニフェストの親部分の Host 要素を上書きします。
リソース はい マニフェストの他の要素によって参照されるリソースのコレクション (文字列、URL、画像) を定義します。
EquivalentAddins いいえ Web アドインと同等のネイティブ (COM/XLL) アドインを指定します。 同等のネイティブ アドインがインストールされている場合、Web アドインはアクティブ化されません。
<VersionOverrides> いいえ 現在、メール アドインの VersionOverrides 1.1 では使用できません。
WebApplicationInfo いいえ Azure Active Directory V2.0 などの安全なトークン発行者へのアドインの登録に関する詳細を指定します。
ExtendedPermissions いいえ 拡張アクセス許可のコレクションを指定します。

説明

アドインの説明です。 マニフェストのすべての親部分の <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 アドインのコード サンプルのサンプル アドインのマニフェストを参照してください。

次に、一般的な <VersionOverrides> 要素の例を示します。これには、通常使用される子要素も含まれます (必須ではありません)。

<OfficeApp ... xsi:type="MailApp">
...
  <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>
...
</OfficeApp>

複数のバージョンを実装する

1 つのマニフェストで、複数のバージョンの 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>