ダイアログ

  • [アーティクル]

ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます) を使用すると、Teams アプリケーションでモーダル ポップアップ エクスペリエンスを作成できます。 ポップアップで、次のことができます。

  • 独自のカスタム HTML または JavaScript コードを実行します。
  • <iframe>YouTube やMicrosoft Streamビデオなどのベースのウィジェットを表示します。
  • アダプティブ カードを表示します。

ダイアログは、タスクの開始と完了、またはビデオや Power Business Intelligence (BI) ダッシュボードなどの豊富な情報の表示に役立ちます。 多くの場合、ポップアップ エクスペリエンスは、タブや会話ベースのボット エクスペリエンスと比較して、ユーザーがタスクを開始して完了する方が自然です。

ダイアログは、Microsoft Teams タブの基礎に基づいて構築されます。 基本的にポップアップ ウィンドウ内のタブです。 同じ Microsoft Teams JavaScript クライアント ライブラリ (TeamsJS) を使用するため、タブを作成している場合は、ダイアログの作成に既に慣れている必要があります。

ダイアログは、次の 3 つの方法で呼び出すことができます。

  • チャネルタブまたは個人用タブ: TeamsJS ライブラリを使用すると、タブのボタン、リンク、またはメニューからダイアログを呼び出すことができます。詳細については、 タブでのダイアログの使用に関するページを参照してください。
  • ボット: ボットから送信された カード のボタンを使用します。 これは、チャネル内のすべてのユーザーがボットで何をしているかを確認する必要がない場合に便利です。 たとえば、ユーザーがチャネル内のポーリングに応答する場合、作成されているそのポーリングのレコードを表示することは役に立ちません。 詳細については、「 Teams ボットからのダイアログの使用」を参照してください。
  • ディープ リンクから Teams の外部: どこからでもダイアログを呼び出す URL を作成することもできます。 詳細については、「 ダイアログ ディープ リンク構文」を参照してください。

ダイアログのコンポーネント

ボットから呼び出されたときのダイアログの外観を次に示します。

dialog の例

ダイアログには、前の図に示すように次のものが含まれています。

  1. アプリの color アイコン。

  2. アプリの short 名前。

  3. DialogInfo オブジェクトの プロパティでtitle指定されたダイアログのタイトル。

  4. ダイアログの [閉じる] ボタンまたは [キャンセル] ボタン。 ユーザーがこのボタンを選択すると、アプリはイベントを err 受け取ります。 詳細については、 ダイアログの結果を送信する例を参照してください。

    注:

    現在、ボットからダイアログが呼び出されたときにイベントを検出 err することはできません。

  5. TaskInfo オブジェクトの プロパティを使用してurl独自の Web ページを読み込んでいる場合、青い四角形は Web ページが表示される場所です。 詳細については、「ダイアログの 呼び出しと閉じる」を参照してください。

  6. TaskInfo オブジェクトの プロパティを使用してアダプティブ カードをcard表示する場合は、パディングが追加されます。 詳細については、「 HTML または JavaScript ダイアログの CSS」を参照してください。

  7. [ サインアップ] を選択すると、アダプティブ カード ボタンがレンダリングされます。 独自のページを使用する場合は、独自のボタンを作成します。 設計上、アダプティブ カードの最後のルート アクションにプライマリ ボタン スタイル (ソリッド) が適用されます。 その他のすべてのアクションでは、既定のボタン スタイルが適用されます。

次の手順

ダイアログの呼び出しと閉じる

関連項目