メール アドインのマニフェスト ファイル内の 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」と入力されている場合の>メールボックス 1.3。
  • 親 <VersionOverrides が「Mail 1.1」と入力されている場合の>メールボックス 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>