次の方法で共有


アプリケーション タブ テンプレートを管理する

注意

機能の可用性情報は次のとおりです。

Dynamics 365 Contact Center - 埋め込み Dynamics 365 Contact Center - スタンドアロン Dynamics 365 Customer Service
いいえ

顧客サービスのアプリケーション タブ テンプレートでは、エージェントが Customer Service Workspace でセッションを開始する際に開くことができるアプリケーションの種類を指定することができます。

左側のパネルの垂直バーには、セッションのリストが表示されます。 パネルには常にホーム セッションが表示されますが、閉じたりカスタマイズすることはできません。

Customer Service workspace で、セッションには、「アンカー タブ」と呼ばれる、閉じることもカスタマイズすることもできないアプリケーションタブが少なくとも一つ存在します。 セッションを開始すると、構成に基づいて、対応するアプリケーションページとその他の追加ページが開かれます。

アプリケーション タブのテンプレートを使用して、セッションで使用可能なアプリケーションを定義し、それらのアプリケーションをセッションに関連付けることができます。 たとえば、アクティブな会話 ページ タブを作成し、チャットや SMS セッションに関連付けることができます。 これにより、エージェントがチャットチャネルや SMS チャネルの通知を引き受けたときに、セッションが開始され、アクティブな会話 ページが 開きます。

管理者は複数のアプリケーション タブ テンプレートを作成できます。

注意

既成のテンプレートはカスタマイズできませんが、独自のカスタムテンプレートを作成することはできます。

前提条件

この記事で扱ったタスクを実行するには、システム管理者ロールが必要です。

アプリケーション タブ テンプレートの作成

  1. Customer Service 管理センターを選択して、手順を実行します。

    1. サイト マップで エージェント エクスペリエンスワークスペース を選択します。
    2. ワークスペース ページで、アプリケーション タブ テンプレート管理 を選択します。
  2. アクティブなアプリケーション タブ テンプレート ページで 新規 を選択します。

  3. 新規アプリケーション タブ テンプレート ページで、以下を指定します。

    Tab キー 件名 内容
    一般 件名 アプリケーション タブの名前を指定します。この名前は、実行時にエージェントに表示されません。 サポート情報記事の検索
    一般 一意の名前 <接頭辞>_<名前> 形式の一意識別子を入力します。
    重要
    一意の名前には以下が必要です:
    • 接頭辞は英数字のみで、長さは 3 - 8 文字である必要があります。
    • 接頭辞と名前の間にアンダースコアを追加する必要があります。

    電球アイコンを選択してから、適用する を選択して、入力した名前が要件を満たしているかどうかを確認します。
    contoso_application_tab
    全般 敬称 実行時にエージェントに表示するアプリケーションのタイトルを入力します。 サポート情報記事の検索
    一般 ページの種類 一覧からページの種類を選択します。 Web リソース
    一般 説明設定 参照の説明を提供します。 ページの種類は、ナレッジベースの検索ページの表示に使用されます。
  4. 保存 を選択します。 パラメーター セクションに、選択したページの種類のパラメーターが表示されます。

    注意

    アプリケーション タブ テンプレートを編集するときは変更を保存します。すると パラメーター セクションに対応するフィールドが表示されます。

  5. 編集したいパラメータのフィールドを選択し、値を入力します。

  6. 保存 を選びます。

ページの種類

以下のページの種類を使用できます。

  • ダッシュボード​
  • エンティティ リスト
  • エンティティ レコード
  • 検索する
  • サード パーティ Web サイト
  • Web リソース
  • コントロール (社外秘)
  • カスタム

ダッシュボード​

このページの種類は、ダッシュボードをアプリケーションとして表示するために使用されます。 ダッシュボード ページの種類では、次のパラメーターを使用できます。

パラメーター 説明設定 必須 サポートされている値
dashboardId ダッシュボードの GUID String d201a642-6283-4f1d-81b7-da4b1685e698

注意

  • dashboardId パラメーターが次の場合、デフォルトのダッシュボードが表示されます。
    > - 空白
    > - 不正解
    > - アプリモジュール定義に含まれていないダッシュボード
  • 個人用のデフォルトダッシュボードはサポートされていません。

エンティティ リスト

このページの種類は、特定のエンティティのレコードの一覧をどのように表示するかを定義するエンティティ ビューを表示するために使用されます。 エンティティ ビューのページの種類では、次のパラメーターを使用できます。

パラメーター 説明設定 必須 サポートされている値
entityName エンティティの論理名 はい 文字列

スラグ
取引先企業

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}
viewId ビューの GUID いいえ 文字列 00000000-0000-0000-00aa-000010001031

注意

目的のビューが存在しないか、アプリ モジュール定義に含まれていない場合は、代わりに既定のエンティティ ビューが表示されます。

エンティティ レコード

このページの種類は、既存のレコードを表示したり、フォームを開いて新しいレコードを作成したりするために使用されます。

既存のレコードを開くときに、エンティティ レコードのページの種類で次のパラメータを使用できます。

パラメーター 説明設定 必須 サポートされている値
entityName エンティティの論理名 はい 文字列

置換フィールド

取引先企業

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}

entityId エンティティ レコードの GUID いいえ 文字列

置換フィールド

d49e62a8-90df-e311-9565-a45d36fc5fe8

{anchor._customerid_value}

formId フォーム インスタンスの GUID いいえ 文字列 915f6055-2e07-4276-ae08-2b96c8d02c57
validateRecord レコードが組織のデータベースにあるかどうかを確認します いいえ ブール型 True

注意

システムが entityId 値をDataverse の既存のレコードと照合しない場合、フォームは作成モードで開き、レコードを作成します。 レコードが Dataverse に存在する場合にのみシステムにフォームをロードする場合、validateRecord パラメータを true に設定します。

validateRecord パラメーターが存在しない場合は、次のようにパラメーターを作成します。

  1. アプリケーション タブ テンプレート フォームで、 新しいテンプレート パラメータ を選択し、次の値を入力します。
    • 名前: validateRecord
    • 一意の名前: new_tabtemplateparam_validateRecord
    • : True
  2. 保存して閉じます。

レコードを作成するためにエンティティ フォームを開いたときに、エンティティ レコードのページの種類で次のパラメータを使用できます。

パラメーター Description 必須 サポートされている値
entityName エンティティの論理名 はい 文字列

置換フィールド

担当者

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}

data フォームに事前入力されるデータ いいえ JSON {"subject":"Task created from {anchor.ticketnumber}","description":"Follow-up needed with customer","prioritycode":"2","scheduledend":"06/12/2023", "regardingobjectid": [{"id": "{anchor.incidentid}", "name": "{anchor.title}", "entityType":"{anchor.entityName}"}]}
formId フォーム インスタンスの GUID いいえ 文字列 915f6055-2e07-4276-ae08-2b96c8d02c57

Entity Search のページの種類では、次のパラメーターを使用できます。

パラメーター 説明設定 必須 サポートされている値
searchType 関連性検索やカテゴリ別検索を使用するように定義します。 可能な値は次のとおりです:
  • 関連性検索の場合は 0
  • カテゴリ別検索の場合は 1
いいえ 数値 0
searchText 検索する文字列を定義します。 はい 文字列

置換フィールド

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

サード パーティ Web サイト

このページの種類は、サード パーティ Web サイトをアプリケーションとして表示するために使用されます。 このタイプを使用して、iframe ホスティングと互換性のある Web サイトのみをホストできます。 Web サイトが iFrame ホスティングとの互換性がない場合、Web サイトから接続が拒否されたというエラー メッセージが表示されます。 アプリケーション タブ テンプレートは、URL とデータ パラメーターを解析して、表示される URL アドレスをフォーマットします。

パラメーター 内容 必須 サポートされている値
url アプリ タブに表示される Web サイトの URL
はい 文字列
https://www.bing.com/search?q=
data url パラメーターで解析される追加のデータ パラメーター
いいえ 文字列

置換フィールド

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

注意

エージェントがサードパーティ Web サイトのタブ テンプレート タイプから別のタブに切り替えてから、サードパーティ Web サイトのタブ テンプレートに戻ると、ページが初期状態に更新されます。 詳細については、既知の問題に関するドキュメント の『フォーカスが変更されたときのサードパーティ アプリケーション タブの更新』セクションを参照してください。

解析の仕組み

これらの例は、チケット番号: CAS-01003-P3B7G1 の新しいセッションでケースがアンカー タブとして開かれたシナリオに基づいています。

url パラメーター: https://www.bing.com/search?q=
data スラッグを使用したパラメーター: {anchor.ticketnumber}
予想される URL: https://www.bing.com/search?q=CAS-01003-P3B7G1

url パラメーター: https://www.bing.com/search?q=
data OData を使用したパラメーター:: {$odata.incident.ticketnumber.?$filter=incidentid eq'{anchor.incidentid}'&$select=ticketnumber}
予想される URL: https://www.bing.com/search?q=CAS-01003-P3B7G1

注意

url パラメーターには、「https://」 を使用した正式な URL 形式が必要です。

Web リソース

このページの種類は、HTML ファイル、JavaScript、CSS、複数の画像フォーマットなど、Web アプリケーションを拡張するために使用されるファイルを表す Web リソースを表示するために使用されます。 Web リソースのページの種類では、次のパラメーターを使用できます。

パラメーター 説明設定 必須 サポートされている値
webresourceName 開く Web リソースの名前 はい 文字列 new_myresource.html
data Web リソースの要件に応じて、文字列やキー/値のペアを提供します。 いいえ 文字列

置換フィールド

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

注意

エージェントが Web リソース タイプのタブ テンプレート タイプから別のタブに切り替えてから、Web リソース タイプのタブ テンプレートに戻ると、ページが初期状態に更新されます。 詳細については、既知の問題に関するドキュメント の『フォーカスが変更されたときのサードパーティ アプリケーション タブの更新』セクションを参照してください。

Custom

このページ タイプは、アプリケーション タブにカスタム ページを表示するために使用されます。このタブ テンプレート タイプを使用して、対応するアプリで利用可能なカスタム ページをホストすることができます。 カスタムページの詳細については、モデル駆動型アプリのカスタム ページの概要を参照してください。

カスタム ページには以下のパラメータが用意されています。

パラメーター 説明 必須 サポートされている値
entityName エンティティの論理名 いいえ 文字列

置換フィールド
インシデント

{anchor.entityName}
name カスタムページの固有名称 はい 文字列
new_mycustompage
recordId エンティティ レコードの GUID いいえ 文字列

置換フィールド



OData



d49e62a8-90df-e311-9565-a45d36fc5fe8

{caseId}

{anchor.incidentid}

{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}


既成のアプリケーション タブのテンプレート

既成のアプリケーション タブのテンプレートは以下の通りです。

テンプレート名 説明 アプリケーションの種類
アクティブな会話 タブにアクティブな会話ページが表示されます。 エンティティ レコード
エンティティ レコード タブにエンティティ レコードを表示します。 エンティティ レコード
サポート情報検索 タブにナレッジ記事検索ページを表示します。 Web ​​リソース
オムニチャネル会話ダッシュボード タブにオムニチャネル会話ダッシュボードを表示します。 ダッシュボード​
オムニチャネル日中インサイト Power BI レポートをタブに表示します。 コントロール
クイック返信のプレビュー タブにクイック返信を表示します。 コントロール
リッチ メッセージのプレビュー タブにリッチ メッセージを表示します。 コントロール
検索する タブにオムニチャネル検索ページを表示します。 コントロール

参照

Customer Service 管理センターの概要
セッション テンプレートを管理する
通知テンプレートを管理する
テンプレートを作業ストリームに関連付ける