適用対象: Dynamics 365 Customer Service と Dynamics 365 Contact Center — スタンドアロン版のみ
Customer Service のアプリケーション タブ テンプレートを使用すると、顧客サービス担当者 (サービス担当者または担当者) が Copilot Service ワークスペースでセッションを開始するときに開くことができるアプリケーションの種類を指定できます。
左側のパネルの垂直バーには、セッションのリストが表示されます。 パネルには常にホーム セッションが表示されますが、閉じたりカスタマイズすることはできません。
Copilot Service ワークスペースでは、すべてのセッションに "アンカー タブ" と呼ばれるアプリケーション タブが少なくとも 1 つあり、閉じたりカスタマイズしたりすることはできません。 セッションを開始すると、構成に基づいて、対応するアプリケーションページとその他の追加ページが開かれます。
アプリケーション タブのテンプレートを使用して、セッションで使用可能なアプリケーションを定義し、それらのアプリケーションをセッションに関連付けることができます。 たとえば、アクティブな会話 ページ タブを作成し、チャットや SMS セッションに関連付けることができます。 これで、担当者がチャットまたは SMS チャネルからの通知を受け入れると、セッションが開始され、[ アクティブな会話] ページが開きます。
管理者は、複数のアプリケーション タブ テンプレートを作成できます。
Note
既成のテンプレートはカスタマイズできませんが、独自のカスタムテンプレートを作成することはできます。
前提条件
この記事で扱ったタスクを実行するには、システム管理者ロールが必要です。
アプリケーション タブ テンプレートの作成
Copilot サービス管理センター を選択し、手順を実行します。
- サイト マップで、[サポート エクスペリエンス] の [ワークスペース] を選択します。
- ワークスペース ページで、アプリケーション タブ テンプレート の 管理 を選択します。
アクティブなアプリケーション タブ テンプレート ページで 新規 を選択します。
新規アプリケーション タブ テンプレート ページで、以下を指定します。
タブ 氏名 Description 例 一般 氏名 アプリケーションタブの名前を指定します。この名前は、実行時に代表者には表示されません。 サポート情報記事の検索 一般 固有の名前 < 接頭辞>_<名前> 形式の一意識別子を入力します。
重要
一意の名前には以下が必要です:- 接頭辞は英数字のみで、長さは 3 - 8 文字である必要があります。
- 接頭辞と名前の間にアンダースコアを追加する必要があります。
電球アイコンを選択してから、適用する を選択して、入力した名前が要件を満たしているかどうかを確認します。contoso_application_tab 一般 タイトル 実行時に担当者に表示するアプリケーションのタイトルを指定します。 サポート情報記事の検索 一般 ページのタイプ 一覧からページの種類を選択します。 Web リソース 一般 Description 参照用に説明を指定します。 ページの種類は、ナレッジベースの検索ページの表示に使用されます。 保存 を選択します。 パラメーター セクションに、選択したページの種類のパラメーターが表示されます。
Note
アプリケーション タブ テンプレートを編集するときは変更を保存します。すると パラメーター セクションに対応するフィールドが表示されます。
編集したいパラメータの値フィールドを選択し、値を入力します。
保存 を選択します。
ページの種類
以下のページの種類を使用できます。
- ダッシュボード
- エンティティ リスト
- エンティティ レコード
- Search
- サード パーティ Web サイト
- Web リソース
- コントロール (社外秘)
- ユーザー設定
ダッシュボード
このページの種類は、ダッシュボードをアプリケーションとして表示するために使用されます。 ダッシュボード ページの種類では、次のパラメーターを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
dashboardId |
ダッシュボードの GUID | 有 | 文字列 | d201a642-6283-4f1d-81b7-da4b1685e698 |
Note
- dashboardId パラメーターが次の場合、デフォルトのダッシュボードが表示されます。
> - 空白
> - 正しくない
> - アプリ モジュール定義に含まれていないダッシュボード - 個人用のデフォルトダッシュボードはサポートされていません。
エンティティ リスト
このページの種類は、特定のエンティティのレコードの一覧をどのように表示するかを定義するエンティティ ビューを表示するために使用されます。 エンティティ ビューのページの種類では、次のパラメーターを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
entityName |
エンティティの論理名 | 有 | ストリング 置換フィールド |
取引先企業 {anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname} |
viewId |
ビューの GUID | No | 文字列 | 00000000-0000-0000-00aa-000010001031 |
Note
目的のビューが存在しないか、アプリ モジュール定義に含まれていない場合は、代わりに既定のエンティティ ビューが表示されます。
エンティティ レコード
このページの種類は、既存のレコードを表示したり、フォームを開いて新しいレコードを作成したりするために使用されます。
既存のレコードを開くときに、エンティティ レコードのページの種類で次のパラメータを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
entityName |
エンティティの論理名 | 有 | ストリング 置換フィールド |
取引先企業 {anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname} |
entityId |
エンティティ レコードの GUID | No | ストリング 置換フィールド |
11bb11bb-cc22-dd33-ee44-55ff55ff55ff {anchor._customerid_value} |
formId |
フォーム インスタンスの GUID | No | 文字列 | 915f6055-2e07-4276-ae08-2b96c8d02c57 |
validateRecord |
レコードが組織のデータベースにあるかどうかを確認します | No | ブール値 | 正しい |
Note
システムが entityId 値をDataverse の既存のレコードと照合しない場合、フォームは作成モードで開き、レコードを作成します。 レコードが Dataverse に存在する場合にのみシステムでフォームをロードする場合、validateRecord パラメータを true に設定します。
validateRecord パラメーターが存在しない場合は、次のようにパラメーターを作成します。
-
アプリケーション タブ テンプレート フォームで、 新しいテンプレート パラメータ を選択し、次の値を入力します。
- 名前: validateRecord
- 一意の名前: new_tabtemplateparam_validateRecord
- 値 - True
- 保存して閉じます。
レコードを作成するためにエンティティ フォームを開いたときに、エンティティ レコードのページの種類で次のパラメータを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
entityName |
エンティティの論理名 | 有 | ストリング 置換フィールド |
担当者{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname} |
data |
フォームに事前入力されるデータ | No | 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 | No | 文字列 | 915f6055-2e07-4276-ae08-2b96c8d02c57 |
Search
Entity Search のページの種類では、次のパラメーターを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
searchType |
関連性検索やカテゴリ別検索を使用するように定義します。 可能な値は次のとおりです:
|
No | 番号 | 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 アドレスをフォーマットします。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
url |
アプリ タブに表示される Web サイトの URL |
有 | ストリング |
https://www.bing.com/search?q= |
data |
url パラメーターで解析される追加のデータ パラメーター |
No | ストリング 置換フィールド OData (英語) |
contoso{anchor.title} {anchor._customerid_value@OData.Community.Display.V1.FormattedValue} {$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title} |
Note
担当者がサードパーティの 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
Note
url パラメーターには、「https://」 を使用した正式な URL 形式が必要です。
Web リソース
このページの種類は、HTML ファイル、JavaScript、CSS、複数の画像フォーマットなど、Web アプリケーションを拡張するために使用されるファイルを表す Web リソースを表示するために使用されます。 Web リソースのページの種類では、次のパラメーターを使用できます。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
webresourceName |
開く Web リソースの名前 | 有 | 文字列 | new_myresource.html |
data |
Web リソースの要件に応じて、文字列やキー/値のペアを提供します。 | No | ストリング 置換フィールド OData (英語) |
contoso{anchor.title} {anchor._customerid_value@OData.Community.Display.V1.FormattedValue} {$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title} |
Note
担当者がタブ テンプレートの Web リソースの種類から別のタブに切り替えた後、タブ テンプレートの Web リソースの種類に戻ると、ページは初期状態に更新されます。 詳細については、既知の問題に関するドキュメント の『フォーカスが変更されたときのサードパーティ アプリケーション タブの更新』セクションを参照してください。
ユーザー設定
このページ タイプは、アプリケーション タブにカスタム ページを表示するために使用されます。このタブ テンプレート タイプを使用して、対応するアプリで利用可能なカスタム ページをホストすることができます。 カスタムページの詳細については、モデル駆動型アプリのカスタム ページの概要を参照してください。
カスタム ページには以下のパラメータが用意されています。
| パラメーター | Description | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
entityName |
エンティティの論理名 | No | ストリング 置換フィールド |
インシデント{anchor.entityName} |
name |
カスタムページの固有名称 | 有 | ストリング |
new_mycustompage |
recordId |
エンティティ レコードの GUID | No | ストリング 置換フィールド OData |
11bb11bb-cc22-dd33-ee44-55ff55ff55ff{caseId} {anchor.incidentid}{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title} |
既成のアプリケーション タブのテンプレート
既成のアプリケーション タブのテンプレートは以下の通りです。
| テンプレート名 | Description | アプリケーション タイプ |
|---|---|---|
| アクティブな会話 | タブにアクティブな会話ページが表示されます。 | エンティティ レコード |
| エンティティ レコード | タブにエンティティ レコードを表示します。 | エンティティ レコード |
| サポート情報検索 | タブにナレッジ記事検索ページを表示します。 | Web リソース |
| オムニチャネル会話ダッシュボード | タブにオムニチャネル会話ダッシュボードを表示します。 | ダッシュボード |
| オムニチャネル日中インサイト | タブにPower BI レポートを表示します。 | 状態 |
| クイック返信のプレビュー | タブにクイック返信を表示します。 | 状態 |
| リッチ メッセージのプレビュー | タブにリッチ メッセージを表示します。 | 状態 |
| 検索 (非推奨) | タブにオムニチャネル検索ページを表示します。(非推奨) | 状態 |
関連情報
Copilot Service admin center の使用を開始する
セッション テンプレートを管理する
通知テンプレートを管理する
テンプレートをワークストリームに関連付ける