Office アドインの統合マニフェストと XML マニフェスト バージョンの両方を管理する

Microsoft は、Microsoft 365開発者プラットフォームについて多くの改善を行っています。 これらの機能強化により、Office アドインを含むすべての種類の Microsoft 365 拡張機能の開発、展開、インストール、および管理の一貫性が高くなります。

取り組んでいる重要な改善点の 1 つは、同じマニフェスト形式 (Microsoft 365 用の JSON 形式の統合マニフェスト) を使用して、すべての Microsoft 365 拡張機能に対して 1 つの配布単位を作成できることです。

統合マニフェストを使用するアドインのバージョンを作成したら、統合マニフェストを使用してビルドされた既存のアドインとアプリをリンクして、ユーザーが Outlook 内にアドイン UI の 2 つのコピーを表示しないようにする必要があります。

次の手順を使用します。

1. "extensions" 配列で拡張オブジェクトを開きます。

2. まだ存在しない場合は、"代替" 配列プロパティを作成します。

3. "alternatives" 配列で、"hide" プロパティを持つ "代替" オブジェクトを作成します。

4. 既存のアドインが AppSource を通じて販売されている場合は、"hide" オブジェクトに "storeOfficeAddin" プロパティを指定します。 それ以外の場合は、手順 6 に進みます。

5. "storeOfficeAddin" オブジェクトに次の 2 つのプロパティを指定します。

   • 古いアドインの GUID を値として持つ "officeAddinId"。
   • AppSource 資産 ID を値として持つ "assetId"。

   例を次に示します。

   "extensions": [
       ...
       {
           ...
           "alternates": [
               ...
               {
                   ...
                   "hide": {
                       "storeOfficeAddin": {
                           "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4",
                           "assetId": "WA999999999"
                       }
                   }
               }
           ]
       }
   ]
   

   注:

   • 統合マニフェストのアドインの資産 ID は、パートナー センターで販売者アカウントによって発行された既存のアドインと一致している必要があります。 統合マニフェストでリンクしたアドインの資産 ID が、販売者アカウントによって発行された既存のオファーと一致しない場合、統合マニフェストの申請は失敗します。 正しいアドイン資産 ID を使用するようにマニフェストを更新し、統合マニフェストを再送信する必要があります。
   • 既存のアドインは、単一の統合マニフェストによってのみ非表示にすることができます。 現時点では、複数の統合マニフェストを使用して同じアドインを非表示にすることはできません。 別の統合マニフェストを使用して既にリンクされているアドインを非表示にしようとすると、申請は失敗します。 リンクを削除し、統合マニフェストを再送信する必要があります。

6. 古いアドインが AppSource 経由で配布されていない場合は、"hide" オブジェクトに "customOfficeAddin" プロパティを指定します。

7. "customOfficeAddin" オブジェクトに、古いアドインの GUID を値として指定した "officeAddinId" プロパティを指定します。 次に例を示します。

   "extensions": [
       ...
       {
           ...
           "alternates": [
               ...
               {
                   ...
                   "hide": {
                       "customOfficeAddin": {
                           "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4"
                       }
                   }
               }
           ]
       }
   ]
   

AppSource または Microsoft 365 管理センターから既存のアドインを削除しないでください。または以前のバージョンの Office ではアドインを使用できなくなります。

近い将来に両方のバージョンを維持する

一般に、統合マニフェストを使用するアドインは、Microsoft 365 バージョン 2307 (ビルド 16626.20132) 以降にのみインストールできます。 ただし、これらのアドインを古いバージョンの Microsoft 365 と永続的なライセンス バージョンの Office にインストールできるようにする 2 つの例外があります。

• ユーザーの Microsoft 365 管理者は、すべてのユーザーにアドインを展開します。
• ユーザーは、バージョン 2307 (ビルド 16626.20132) 以降 の 別の Microsoft 365 クライアント アプリにアドインをインストールします。 これにより、古いライセンスや永続的なライセンスを含む、同じユーザーの他の Office クライアントでアドインを使用できるようになります。

これらの例外が適用されない古いバージョンまたは永続的なライセンス バージョンのユーザーがいる場合は、両方のバージョンのアドインを維持する必要があります。 統合マニフェストをサポートするすべてのユーザーが Office バージョンを使用している場合は、展開から XML バージョンを削除できます。

また、両方のバージョンのアドインを長期間維持したい場合もあります。 たとえば、アドインの 2 つの機能は、ほとんど使用されていないか非推奨であるため、統合マニフェストではサポートされていません。 これらの機能を使用するアドインのバージョンを維持することもできます。 統合マニフェストでサポートされていない機能を次に示します。

• Outlook モジュール はサポートされていません。 ただし、 1 つのアプリにアドインに Teams タブを含めることで、統合マニフェストを使用してほぼ同じエクスペリエンスを提供できます。
• Outlook コンテキスト アドイン ("アクティブ化ルール" とも呼ばれます) はサポートされていません。 ただし、統合マニフェストと イベント ベースのアクティブ化を使用して、同様のエクスペリエンスを提供できます。

2 つのバージョンを使用できるようにするための重要な要件は、2 つのバージョンが Outlook UI で個別に表示されるようにすることです。

• 新しいバージョンに既存のアドインとは別の名前を付けます。
• 新しいバージョンに異なるアイコンを作成して使用します。
• 新しいバージョンの統合マニフェストの "id" プロパティが、既存のアドインの XML マニフェストの Id> 要素とは異なる GUID< であることを確認してください。