Teams でキャンバスアプリを個人用アプリとして埋め込む

[アーティクル]
07/08/2022

作成したアプリは、Microsoft Teams に直接埋め込むことで共有できます。完了すると、ユーザーは + を選択して、アプリを 自分の チームチャネルまたは参加しているチームの会話に追加できます。アプリは、チームのタブ の下にタイルとして表示されます。

注意

チームカスタムアプリポリシーは、カスタムアプリのアップロードを許可するように設定する必要があります。アプリを Teams に埋め込むことができない場合は、管理者に問い合わせてカスタムアプリ設定がセットアップされているかを確認してください。

前提条件

有効な Power Appsライセンスが必要です。
アプリを Teams に埋め込むには、Power Apps を使用して作成された既存のアプリが必要です。

Teams に追加する

Power Apps にサインインし、アプリ を選択します。
Teams で共有するアプリの その他のアクション (...) を選択し、Teams に追加 を選択します。

Teams に追加 パネルがスクリーンの右側に開きます。
(オプション) アプリに説明がない場合は、詳細を編集 を選択して、追加する Power Apps Studio のアプリを開きます。
(オプション) 高度な設定 を選択して、名前、ウェブサイト、利用規約、プライバシーポリシー、MPN ID (Microsoft Partner Network ID) などのその他の詳細を追加します。
Teams に追加 を選択すると Teams を開くように求められます。

ヒント

必要に応じて、アプリのダウンロード を選択してアプリをダウンロードしMicrosoft Teams にアプリをアップロードするの記事で説明されている手順に従って、アプリを Teams にアップロードできます。
Microsoft Teams を開く を選択して Teams アプリを開くか、キャンセル の後に 代わりに Web アプリを使用 を選択して Teams Web アプリを開きます。
追加を選択します。 チームに追加 を使用して特定のチームに、または チャットに追加 を使用して特定のチャットにアプリを追加することができます。

アプリが Teams に追加されました。

ヒント

簡単にアクセスできるように、アプリをピン留めすることもできます。

アプリを Teams カタログに公開する

管理者であれば、Microsoft Teams カタログにアプリを公開することもできます。

Teams のコンテキストを使用する

Teams と緊密に統合されたアプリを構築するには、Param() 関数でチームのコンテキスト変数を使用できます。たとえば、画面の Fill プロパティで次の式を使用して、Teams 内のユーザーのテーマに基づいてアプリの背景を変更します。

Switch(
        Param("theme"),
        "dark",
        RGBA(
            32,
            31,
            31,
            1
        ),
        "contrast",
        RGBA(
            0,
            0,
            0,
            1
        ),
        RGBA(
            243,
            242,
            241,
            1
        )
    )

アプリをテストするには、アプリを公開して、Teams 内で再生します。

Teams の以下のコンテキスト変数がサポートされています。

ロケール
channelId
channelType
chatId
groupId
hostClientType
subEntityId
teamId
teamType
テーマ
userTeamRole

注意

この機能は 2020 年 3 月に追加されました。これより前にアプリを Teams に埋め込んだ場合、この機能を使用するには、アプリを Teams に再度追加する必要があります。

アプリのパフォーマンスを向上させる

オプションで、Teams 内にアプリを事前に読み込み、パフォーマンスを向上させることができます。

Power Apps にサインインして、メニューで アプリ を選択します。
Teams で共有するアプリの その他のアクション (...) を選択し、設定を選択します。
設定パネルで、アプリをプリロードしてパフォーマンスを向上 をはいに切り替えます。その後、アプリはチームに埋め込まれるたびにプリロードされます。
変更を有効にするには、アプリを削除して再度 Teams に追加します。

注意

これにより、ユーザーは、組み込みシナリオの認証の進行中に、コンパイルされたアプリをダウンロードできます。ただし、ユーザーは認証に成功した後にのみアプリを実行できます。この動作により、認証されていないユーザーがアプリデータを利用できないようになります。コンパイルされたアプリの情報には次のものが含まれます—アプリコントロールで作成されたテキスト、メディアアセット (画像など)、アプリ名、およびアプリが存在する環境 URL を含む JavaScript ファイルのコレクション。

参照

Microsoft Teams へようこそ

注意

ドキュメントの言語設定についてお聞かせください。簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。個人データは収集されません (プライバシーステートメント)。

Teams でキャンバス アプリを個人用アプリとして埋め込む