サードパーティガジェットを使用したCisco FinesseでのCUIC履歴レポートガジェットの設定

概要

このドキュメントでは、Finesseの履歴レポートガジェットを設定する手順について説明します。デフォルトの設定には、Finesseエージェント/スーパーバイザデスクトップのライブデータガジェットのみが含まれているためです。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Cisco Unified Contact Center Express（UCCX）
• Cisco Unified Intelligence Center（CUIC）
• Finesseの管理
• Finesseデスクトップ

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

• UCCXバージョン12.5
• CUICバージョン12.5
• Finesseバージョン12.5
• フィージラ

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

コンフィギュレーション

Finesseで履歴レポートを有効にする手順。

ここでは、Finesseプラットフォームで履歴レポート機能を有効にするための手順について説明します。

1. CUICでカスタムレポートを作成します。

CUICページに移動します。 クリックして  Reports > Stock > Unified CCX Historical > Inbound. 選択  Agent Detail Report 図に示すように。

エージェント状態詳細レポートのコピーの保存

の下  Actions  タブ、選択  Save As  レポートに名前を付けます。たとえば、  Agent Detail Report - Test  下に保存します  Reports  図に示すように。

エージェント詳細レポートの保存

2.ユーザーに権限を追加します。

移動先  Reports  および選択  Agent Detail Report - Test  アクセス許可を追加します。の下  Actions  タブ、選択  Permissions - All Users/Supervisors - View/Edit  図に示す要件に従います。

エージェント詳細レポートの権限オプションの選択

レポートの権限の割り当て

3.以下  Actions , 選択  Set Default Filter  を選択し、 Agent Names  のデータを表示します。また、オプションを選択してください。  Skip Filter during the report execution  図に示すように。

レポートに既定のフィルタを設定

デフォルト・フィルタのユーザーの選択

4.アンダー  Actionsを選択します。 Permalinks . クリックして  HTML を入力し、次に  permalink  をクリックします。その後、両方の固定リンク認証オプション（変数とデフォルトの両方）をオフにして、最後にクリックします Save  図に示すように。 

レポートの固定リンクの選択

レポートの固定リンクの検索

たとえば、https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800

5.コピーした固定リンクを使用してXMLファイルを作成します。

この形式でXMLファイルを作成し、名前を付けて保存します  AgentDetailReport.xml and href = “Permalink you have copied from CUIC” を参照。また、固定リンクの「&」を「&」に置き換えます。

フォーマット例：

<?xml version="1.0" encoding="UTF-8"?>

<Module>

<ModulePrefs title=" Agent Detail Report " height="425">

</ModulePrefs>

<Content type="url" href= “https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800 “/>

</Module>

XML形式

6. UCCXサーバでCLIを使用して3rdpartygadgetユーザパスワードをリセットします。

3rdpartygadgetアカウントは、サードパーティのガジェットをFinesseにアップロードするために使用されます。パスワードを設定またはリセットする新しいCLIコマンドは次のとおりです。 utils reset_3rdpartygadget_password  図に示すように。

CLIへの3rdpartygadgetログイン

7.  AgentDetailReport.xml  ファイル先  /3rdpartygadget/files  filezillaまたはWinSCP （SFTPクライアント）を使用するフォルダ：

FFilezillaログインインターフェイス

サーバーへのXMLのアップロード

8.値を755に変更して、XMLファイルにファイル権限を付与します。

XMLアクセス許可の設定

XMLファイルの権限が必要です

9. Cisco Finesse Administration(https://FQDN:8445/cfadmin/container/?locale=en_US)に移動します。 Finesseデスクトップレイアウトファイルを編集します。クリックして  Expand All  図に示すように。

Finesseデスクトップレイアウトページ

10.エージェント/スーパーバイザのロールのガジェットをFinesseデスクトップの新しいタブに追加し、保存します。

例：

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

                          <gadget>/3rdpartygadget/files/AgentDetailReport.xml</gadget>

                     </gadgets>

        </tab>

Finesseガジェットの設定

11. UCCX GUIから次のサービスを再起動します。

• Cisco Unified CCX通知サービス

• Cisco Finesse Tomcat

• Unified CCX Socket.IOサービス

12. Finesseデスクトップにログインし、エージェント詳細レポートが新しいタブに表示されるかどうかを確認します。

Finesseエージェントデスクトップビュー

トラブルシュート

1. 図に示すように、「There were issues rendering this gadget. org.apache.shindig.common.xml.XmlException: Open quote is expected for attribute "href" associated with an element type "Content".」というエラーメッセージが表示されます。

FinesseでのHREFエラー

ソリューション：

エラーに示されているXMLファイルを開き、href属性の後の引用符(")で囲まれている固定リンクが、手順5の指示どおりに正しくフォーマットされていることを確認します。

XMLファイル形式

2. Finesseデスクトップからガジェットをロードしようとすると、「The user is not allowed to view this report」というエラーが表示されます。

Finesse Agent Desktopのエラー

ソリューション：

このオプションのチェックを外してください  Skip Filter during the report executionステップ3で示したように、前に説明しました。

内  Actions  メニュー、選択  Set Default Filter  オプションにチェックマークを付けます  Skip filter during the report execution  図に示すように。

レポートの既定のフィルタを設定

FAQ

1. 1つのタブに複数の3rdpartygadgetsを追加することはできますか。

はい、1つのタブに複数の3rdpartygadgetsを追加することができます。新しいガジェットを内部に追加します   手順を実行します。

2. 3rdpartygadgetのユーザパスワードをリセットすると、/3rdpartygadget/filesフォルダ内の既存のXMLファイルに影響しますか。

3rdpartygadgetのパスワードの目的は、  3rdpartygadget/files  SFTPクライアント経由でフォルダを作成し、XMLファイルをアップロードします。そのため、既存の設定には影響しません。