次の方法で共有

Teams アプリの既定のオプションを構成する

  • [アーティクル]

アプリでは Teams で複数のシナリオをサポートするのが一般的ですが、特定のスコープと機能を念頭に置いて設計している可能性があります。 たとえば、アプリが主にチームまたはチャネルで使用される場合は、Microsoft Teams ストアにユーザーが表示する最初のインストール オプションが [チームに追加] であることを確認できます。

[チームに追加] オプションを示すスクリーンショット。

アプリの主な機能がボットの場合は、ユーザーがアプリをチームにインストールするときにボットを既定の機能にすることもできます。

アプリの既定のインストール スコープを構成する

アプリの既定のインストール スコープを構成します。 一度に設定できるスコープは 1 つだけです。 詳細については、「アプリ マニフェスト」を参照してください。

アプリ マニフェストで既定のインストール スコープを構成するには:

  1. アプリ マニフェストを開き、 defaultInstallScope プロパティを追加します。

  2. 既定のインストール スコープの値を personal、 team、 groupchat、または meetings に設定します。

    "defaultInstallScope": "meetings",

共有スコープの既定の機能を構成する

チーム、会議、またはグループチャット用にアプリをインストールするときに、既定の機能を構成します。 詳細については、「アプリ マニフェスト」を参照してください。

注:

defaultGroupCapability は、チーム、グループ チャット、または会議に追加される既定の機能を提供します。 アプリの既定の機能としてタブ、ボット、またはコネクタを選択しますが、アプリ定義で選択した機能が指定されていることを確認する必要があります。

アプリ マニフェストで詳細を構成するには:

  1. アプリ マニフェストを開き、 defaultGroupCapability プロパティを追加します。

  2. team、groupchat、またはmeetingsの値を設定します。

  3. 選択したグループ機能の場合、使用可能なグループ機能は、 bot、 tab、または connectorです。

    注:

    選択したグループ機能には、 bot、 tab、または connector の 1 つの既定の機能のみを選択できます。

    "defaultGroupCapability": {
    "team": "bot",
    "groupchat": "bot",
    "meetings": "tab"
}

アプリの既定のランディング機能を構成する

個人用スコープでボットとタブの両方の機能をサポートするアプリの既定のランディング機能を構成できます。 この構成に基づいて、アプリは既定でボットまたはタブとして開きます。

次のいずれかを構成できます。

既定のランディング機能としてのボット

既定でボットとして開くアプリを構成します。

  1. アプリ マニフェストを開きます。

  2. [bots プロパティ] で、personalとしてscopesを定義します。

    "bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

注:

staticTabs プロパティでconversationsとしてentityIdを指定しない場合でも、そのスコープが個人用として定義されている場合、ボットは既定のランディング機能として機能します。

次の例では、ボットを既定のランディング機能として使用してアプリを開き、ユーザーがタブに移行する方法を示します。

図は、ボットを既定のランディング機能として使用してアプリを開くプロセスを示しています。

既定のランディング機能としてのタブ

既定でタブとして開くアプリを構成します。

  1. アプリ マニフェストを開きます。
  2. [ staticTabs プロパティ] の下:
    1. 配列の最初のエントリとしてタブ プロパティを追加します。 タブ プロパティを定義するには、 アプリ マニフェストに関するページを参照してください。
    2. 以下のプロパティを追加します。
      1. entityIdをconversationsとして定義します。
      2. scopesをpersonalとして定義します。

次のコード スニペットは、既定のランディング機能としてタブを設定する例です。

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

次の例は、既定のランディング機能としてタブを使用してアプリを開く方法と、ユーザーがボットに移行する方法を示しています。

既定のランディング機能としてタブを使用してアプリを開くプロセスを示す図。

staticTabs プロパティは、個人用タブのピン留めやタブの並べ替えにも使用されます。 詳細については、「アプリ マニフェスト」を参照してください。

管理者が承認するまで、ユーザーのアプリを既定でブロックする

Teams アプリのユーザー エクスペリエンスを向上させるには、ユーザーがアプリを使用する前に IT 管理者が介入する必要があります。 たとえば、Contoso Electronics for Teams によって作成されたヘルプ デスク アプリを考えてみましょう。 アプリが適切に機能するように、Contoso Electronics では、お客様がアプリの特定のプロパティを最初に構成することを望んでいます。

IT 管理者が関連するタスクを確実に実行できるように、開発者は、管理者がアプリを許可するまで、ユーザーのアプリをブロックできます。 既定でアプリをブロックするには、アプリ マニフェスト ファイルで defaultBlockUntilAdminAction プロパティを true に設定します。 プロパティが true に設定されている場合、Teams 管理センターのアプリの状態は、[アプリの管理] ページの発行元によってブロックされます。

発行元によってブロックされたアプリを示すスクリーンショット。

管理者は、アプリに関するデュー デリジェンスを行うことができます。また、ユーザーがアプリを使用できるようにする前に 、提供したアプリドキュメント を読むことができます。 たとえば、管理者は、ユーザーがアプリを使用できるようにする前に、必要なライセンスを購入し、ライセンスを配布できます。 発行元によってブロックされた状態のアプリを許可するには、管理者は Teams 管理センターの [アプリの管理] ページで [許可] を選択できます。

発行元によってブロックされたアプリの [許可] オプションを示すスクリーンショット。

アプリを既定でブロックしない場合は、 defaultBlockUntilAdminAction 設定を false に更新し、更新したアプリを発行用に送信します。 アプリの新しいバージョンを発行すると、既定で許可されます。

注:

組織用に構築されたカスタム アプリの場合、 defaultBlockUntilAdminAction はサポートされていません。 このプロパティを使用してorganization用に構築されたカスタム アプリをアップロードした場合、アプリはブロックされません。

コード サンプル

サンプルの名前 説明 .NET Node.js マニフェスト
Helloワールド このサンプルでは、個人用スコープでボットとタブの両方の機能をサポートするアプリの既定のランディング機能を構成する方法を示します。 表示 表示 表示

次の手順

アプリ パッケージを作成する