アプリケーション タブ テンプレートを管理する
顧客サービスのアプリケーション タブ テンプレートでは、エージェントが Customer Service Workspace でセッションを開始する際に開くことができるアプリケーションの種類を指定することができます。
左側のパネルの垂直バーには、セッションのリストが表示されます。 パネルには常にホーム セッションが表示されますが、閉じたりカスタマイズすることはできません。
Customer Service workspace で、セッションには、「アンカー タブ」と呼ばれる、閉じることもカスタマイズすることもできないアプリケーションタブが少なくとも一つ存在します。 セッションを開始すると、構成に基づいて、対応するアプリケーションページとその他の追加ページが開かれます。
アプリケーション タブのテンプレートを使用して、セッションで使用可能なアプリケーションを定義し、それらのアプリケーションをセッションに関連付けることができます。 たとえば、アクティブな会話 ページ タブを作成し、チャットや SMS セッションに関連付けることができます。 これにより、エージェントがチャットチャネルや SMS チャネルの通知を引き受けたときに、セッションが開始され、アクティブな会話 ページが 開きます。
管理者は複数のアプリケーション タブ テンプレートを作成できます。
注意
既成のテンプレートはカスタマイズできませんが、独自のカスタムテンプレートを作成することはできます。
前提条件
この記事で扱ったタスクを実行するには、システム管理者ロールが必要です。
アプリケーション タブ テンプレートの作成
Customer Service 管理センターを選択して、手順を実行します。
- サイト マップで エージェント エクスペリエンス の ワークスペース を選択します。
- ワークスペース ページで、アプリケーション タブ テンプレート の 管理 を選択します。
アクティブなアプリケーション タブ テンプレート ページで 新規 を選択します。
新規アプリケーション タブ テンプレート ページで、以下を指定します。
Tab キー 件名 内容 例 一般 件名 アプリケーション タブの名前を指定します。この名前は、実行時にエージェントに表示されません。 サポート情報記事の検索 一般 一意の名前 <接頭辞>_<名前> 形式の一意識別子を入力します。
重要
一意の名前には以下が必要です:- 接頭辞は英数字のみで、長さは 3 - 8 文字である必要があります。
- 接頭辞と名前の間にアンダースコアを追加する必要があります。
電球アイコンを選択してから、適用する を選択して、入力した名前が要件を満たしているかどうかを確認します。contoso_application_tab 全般 敬称 実行時にエージェントに表示するアプリケーションのタイトルを入力します。 サポート情報記事の検索 一般 ページの種類 一覧からページの種類を選択します。 Web リソース 一般 説明設定 参照の説明を提供します。 ページの種類は、ナレッジベースの検索ページの表示に使用されます。 保存 を選択します。 パラメーター セクションに、選択したページの種類のパラメーターが表示されます。
注意
アプリケーション タブ テンプレートを編集するときは変更を保存します。すると パラメーター セクションに対応するフィールドが表示されます。
編集したいパラメータの値フィールドを選択し、値を入力します。
保存 を選びます。
ページの種類
以下のページの種類を使用できます。
- ダッシュボード
- エンティティ リスト
- エンティティ レコード
- 検索する
- サード パーティ Web サイト
- Web リソース
- コントロール (社外秘)
- カスタム
ダッシュボード
このページの種類は、ダッシュボードをアプリケーションとして表示するために使用されます。 ダッシュボード ページの種類では、次のパラメーターを使用できます。
| パラメーター | 説明設定 | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
dashboardId |
ダッシュボードの GUID | はい | 文字列 | d201a642-6283-4f1d-81b7-da4b1685e698 |
注意
目的のダッシュボードがアプリ モジュール定義に含まれていない場合は、代わりに既定のダッシュボードが表示されます。
エンティティ リスト
このページの種類は、特定のエンティティのレコードの一覧をどのように表示するかを定義するエンティティ ビューを表示するために使用されます。 エンティティ ビューのページの種類では、次のパラメーターを使用できます。
| パラメーター | 説明設定 | 必須 | サポートされている値 | 例 |
|---|---|---|---|---|
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 パラメーターが存在しない場合は、次のようにパラメーターを作成します。
- アプリケーション タブ テンプレート フォームで、 新しいテンプレート パラメータ を選択し、次の値を入力します。
- 名前: validateRecord
- 一意の名前: new_tabtemplateparam_validateRecord
- 値: True
- 保存して閉じます。
レコードを作成するためにエンティティ フォームを開いたときに、エンティティ レコードのページの種類で次のパラメータを使用できます。
| パラメーター | 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 |
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 管理センターの概要
セッション テンプレートを管理する
通知テンプレートを管理する
テンプレートを作業ストリームに関連付ける
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示