Office アドインと Teams アプリを組み合わせるための一般的なガイダンス

密接に関連している、または機能とワークロードが重複している既存の Teams アプリと Office アドインがある場合は、それらを 1 つのアプリに組み合わせることをお勧めします。 これにより、ユーザーと Microsoft 365 テナント管理者は、アドインと Teams アプリの両方をユニットとして取得および承認できます。 アドインと Teams アプリを組み合わせたアプリの例については、「 割引プランのサンプル」を参照してください。

次の理由から、アドインと Teams アプリをマージするためのアルゴリズム手順はありません。

• アルゴリズムでは、既存の Teams アプリのフォルダーとファイル構造について想定する必要があります。 ただし、これらの構造は、アプリ プロジェクトの作成に使用されたツールとそのツールのバージョンによって異なります。 もちろん、アプリの開発者は、プロジェクトの作成後に構造を変更した可能性があります。
• 上記の箇条書きは、アドイン プロジェクトにも適用されます。
• アルゴリズムでは、さまざまな構成ファイルの設定に関する前提を作成する必要があります。 ただし、これらの設定は、プロジェクトの作成方法と、プロジェクトの作成以降の構成に対する変更によっても異なります。
• アルゴリズムでは、Web アプリケーションのクライアント側のソース コードに使用された TypeScript または JavaScript の言語を想定する必要があります。

ただし、アドインと Teams アプリの組み合わせに関する一般的な推奨事項を作成できます。

Teams アプリと Office アドインの組み合わせのマニフェストと構造について説明します

既存の 2 つの拡張機能のマージ作業を開始する前に、Teams ツールキットで新しい Teams アプリと新しいアドインを作成し、「Outlook アドインを Teams アプリに追加する」の手順に従って、2 種類の拡張機能を結合する方法を理解してください。 以下に細心の注意を払ってください。

• 単一統合マニフェストの作成方法。
• アドインと Teams アプリのサイドローディングとデバッグ方法の違い。

Teams アプリとアドインを組み合わせるための適切な原則に従う

既存のアドインと Teams アプリをマージする準備ができたら、次の原則に従います。

• アドインで XML マニフェストを使用する場合は、「アドインを変換して Microsoft 365 の統合マニフェストを使用する」で説明されているように、Microsoft 365 用の統合マニフェストを使用するように 変換してから、それを Teams アプリと組み合わせます。
• Teams アプリ プロジェクトを、マージされたアプリケーションの基本プロジェクトとして使用します。
• アドインと Teams アプリの両方に適用できる構成ファイルは、プロジェクトのルートに保持します。
• Teams アプリにのみ適用されるソース ファイルと構成ファイルを、プロジェクトのルート外のサブフォルダーに移動します。 同様に、アドインによってのみ使用されるソース ファイルと構成ファイルを既存のアドインから、結合されたプロジェクトのルートから別のサブフォルダーにコピーします。
• アドインと Teams アプリの両方のビルド 済みファイルに同じ基本ドメインを使用します。たとえば、contoso.com。
• 2 つのマニフェストを 1 つのマニフェストにマージします。 手順 1 で行ったプロセスをガイドとして使用します。
• 新しいマニフェストの id プロパティは、元の Teams アプリ マニフェストの "id" プロパティと同じ値にする必要があります。
• version プロパティの値を上げます。たとえば、"1.0.0" を "1.1.0" に上げます。
• extensions.alternates プロパティをマニフェストに追加し、アドインと Teams アプリの組み合わせをサポートする Office の元の Office アドイン バージョンを非表示にするように構成します。 詳細については、「 アドインの新しいバージョンと古いバージョンを管理する」を参照してください。

Teams アプリと Office アドインを組み合わせて発行する

組み合わされたアプリを発行するには、Teams アプリの更新プログラムとして扱います。 詳細については、「 アプリに更新プログラムを発行する」を参照してください。

更新プログラムが発行されると、エンド ユーザーが更新プログラムを使用できるようになる方法は異なります。 一般的な原則を次に示します。

• Microsoft 365 管理者が更新プログラムに同意した場合は、次の操作を行います。

  • Teams アプリの更新バージョンは、以前に Teams アプリを取得したユーザーに対して、Outlook の アプリ または その他のアプリ 、および Teams アプリではなく Microsoft 365 アプリケーションからすぐに入手できます。
  • Outlook アドインは、以前にアドインを取得したかどうかに関係なく、以前に Teams アプリを取得したユーザーにもすぐに使用できます。
  • Teams 管理者が更新を許可した場合、ユーザーは Teams アプリから Teams に個別にインストールできます。

• 管理者が同意しない場合は、以前に Teams アプリを取得した各ユーザーが更新プログラムに同意する必要があり、Teams 管理者が許可している場合にのみ Teams で使用できるようになります。

• 以前に Office アドインのみを取得したユーザーは、Teams ストアから新しい複合アプリを取得する必要があります。 Outlook リボン の [すべてのアプリ] ボタンを使用して取得することはできません。

今後は、アプリの新しいバージョンのみを更新する必要があります。

関連項目

• Outlook アドインの概要
• Microsoft 365 用統合アプリ マニフェストを含む Office アドイン
• Microsoft 365 の統合マニフェストを使用して Outlook アドインを構築する
• Teams アプリに Outlook アドインを追加する