Ccpulse+ Manual
Ccpulse+ Manual
Ccpulse+ Manual
CCPulse+
Administrators Guide
The information contained herein is proprietary and confidential and cannot be disclosed or duplicated without the prior written consent of Genesys Telecommunications Laboratories, Inc. Copyright 19992011 Genesys Telecommunications Laboratories, Inc. All rights reserved.
About Genesys
Genesys Telecommunications Laboratories, Inc., a subsidiary of Alcatel-Lucent, is 100% focused on software for contact centers. Genesys recognizes that better interactions drive better business and build company reputations. Customer service solutions from Genesys deliver on this promise for Global 2000 enterprises, government organizations, and telecommunications service providers across 80 countries, directing more than 100 million customer interactions every day. Sophisticated routing and reporting across voice, e-mail, and Web channels ensure that customers are quickly connected to the best available resourcethe first time. Genesys offers solutions for customer service, help desks, order desks, collections, outbound telesales and service, and workforce management. Visit www.genesyslab.com for more information. Each product has its own documentation for online viewing at the Genesys Technical Support website or on the Documentation Library DVD, which is available from Genesys upon request. For more information, contact your sales representative.
Notice
Although reasonable effort is made to ensure that the information in this document is complete and accurate at the time of release, Genesys Telecommunications Laboratories, Inc., cannot assume responsibility for any existing errors. Changes and/or corrections to the information contained in this document may be incorporated in future versions.
Trademarks
Genesys, the Genesys logo, and T-Server are registered trademarks of Genesys Telecommunications Laboratories, Inc. All other trademarks and trade names referred to in this document are the property of other companies. The Crystal monospace font is used by permission of Software Renovation Corporation, www.SoftwareRenovation.com.
Released by
Genesys Telecommunications Laboratories, Inc. www.genesyslab.com Document Version: 80rt_ad_ccpulse+_12-2011_v8.0.10 1 .0 0
Table of Contents
Preface
................................................................................................................... 7 About CCPulse+........................................................................................ 7 Intended Audience..................................................................................... 8 Making Comments on This Document ...................................................... 8 Contacting Genesys Technical Support..................................................... 8 Document Change History ........................................................................ 9 New in Document Version 8.0.101.00 .................................................. 9 New in Document Version 8.0.001.00 ................................................ 10
Chapter 1
CCPulse+ Overview.............................................................................. 13 Overview.................................................................................................. 13 New in This Release................................................................................ 14 New in Release 8.0.0.......................................................................... 14 New in Release 8.0.1.......................................................................... 15
Chapter 2
Installing CCPulse+ Silently ................................................................ 17 Overview.................................................................................................. 17 Creating the Response File ..................................................................... 18 Playing Back the Response File.............................................................. 18 Remote Silent Installation ................................................................... 20 Analyzing the Log File ............................................................................. 20
Chapter 3
Fine-Tuning CCPulse+ Configuration ................................................ 23 Common and security Sections............................................................... 24 Transport Layer Security Support ....................................................... 25 Client-Side Port Definition................................................................... 25 CustomStatistic Section........................................................................... 27 HistoricalView Section ............................................................................. 28 ObjectFormat Section.............................................................................. 30 Substitution Rules............................................................................... 33 Storage Section ....................................................................................... 35
CCPulse+Administrators Guide
Table of Contents
UserInterface Section .............................................................................. 39 View Section............................................................................................ 42 Workspace Section.................................................................................. 44 Changing the Display of Dates and Time ................................................ 49 CCPulse+ Registry Settings .................................................................... 50
Chapter 4
Historical Reporting Considerations for CCPulse+ .......................... 55 Data Mart Connections............................................................................ 55 Composite Metrics................................................................................... 56 Column Names........................................................................................ 56 The Last N Intervals Parameter............................................................... 57 Historical Associations for Statistics ........................................................ 57 Propagation of Template Changes .......................................................... 57
Chapter 5
Server Connections to CCPulse+ ....................................................... 59 Configuration Server Connection Failure ................................................ 60 Stat Server Connection Failure ............................................................... 62 DB Server Connection Failure................................................................. 65
Chapter 6
Using Custom Statistics ...................................................................... 67 Identifying Custom Statistics ................................................................... 67 Hidden Statistics ................................................................................. 68 Using JScript Language .......................................................................... 68 Referencing Basic Statistics .................................................................... 68 Using Predefined Objects in Formulas .................................................... 70 Formatting the Results ............................................................................ 76 Displaying Capacity Information ......................................................... 76
Chapter 7
Thresholds and Actions....................................................................... 79 Overview.................................................................................................. 79 Predefined Objects .................................................................................. 80 Predefined Thresholds ............................................................................ 85 How to Use Thresholds ...................................................................... 85 Explanations of the Predefined Thresholds ........................................ 87 Predefined Actions .................................................................................. 92 How Actions Function ......................................................................... 92 Explanations of the Predefined Actions .............................................. 93
Reporting 8.0
Table of Contents
Chapter 8
Measuring CCPulse+/Stat Server Traffic............................................ 99 Determining Factors ................................................................................ 99 The Number of Requests ........................................................................ 99 The Number of Responses.................................................................... 100 The Size of One Request/Response ..................................................... 100
Chapter 9
Troubleshooting ................................................................................. 101 Agents Having Trouble Logging In ........................................................ 101 Wizards Are Disabled ............................................................................ 102 Import/Export Utility Is Disabled ............................................................ 102 No DB Server Connection Error Message............................................. 103 Agents Missing from Call Center Objects Pane .................................... 103 General SQL Server Error Message ..................................................... 104 Agents Cannot Monitor Agent Activity ................................................... 104 Sudden Stat Server Disconnection ....................................................... 104 Stat Server Missing from New Workspace ............................................ 105 No Historical Associations Error Messages........................................... 105 Cannot Recover Workspace.................................................................. 105 Cant View Multi-Tenant Data ................................................................ 106
Supplements
Index
............................................................................................................... 111
CCPulse+Administrators Guide
Table of Contents
Reporting 8.0
Preface
Welcome to the Reporting 8.0 CCPulse+ Administrators Guide. This document presents information that CCPulse+ administrators need in order to fine-tune and troubleshoot CCPulse+ installation. This guide is valid only for the 8.0.x release of this product.
Note: For releases of this guide created for other releases of this product,
please visit the Genesys Technical Support website, or request the Documentation Library DVD, which you can order by e-mail from Genesys Order Management at [email protected]. This preface contains the following sections: About CCPulse+, page 7 Intended Audience, page 8 Making Comments on This Document, page 8 Contacting Genesys Technical Support, page 8 Document Change History, page 9 Special considerations concerning CCPulse+ historical reporting Instructions for how to customize the user interface Instructions for how to create and format custom statistics Explanations of the threshold and action scripts A list of the historical statistics that are associated with the CCPulse+ realtime statistics Troubleshooting suggestions
About CCPulse+
CCPulse+ enables both real-time and historical monitoring of contact center activity. CCPulse+ monitors the status and statistics related to contact center objects (such as agents, queues, Routing Points, and interaction queues) and displays them on the users desktop.
CCPulse+Administrators Guide
Preface
Intended Audience
Intended Audience
This guide is intended primarily for CCPulse+ administrators. It assumes that you have a basic understanding of: Computer-telephony integration concepts, processes, terminology, and applications. Network operation. Your own network configurations.
You should also be familiar with Genesys Framework architecture and functions, particularly Stat Server statistics and configuration. CCPulse+ administrators have access to CCPulse+ functions that are not available to other users. CCPulse+ administrators can: Operate the Threshold and Action wizards. Operate the Template Wizard to create, modify, or delete CCPulse+ templates. Use the Import/Export Utility to copy CCPulse+ templates, thresholds, and actions from one storage to another.
A strong knowledge of VBScript might be required for some functionality, such as creating custom formulas.
Reporting 8.0
Preface
Region North America and Latin America Europe, Middle East, and Africa Asia Pacific Malaysia India Japan
Telephone +888-369-5555 (toll-free) +506-674-6767 +44-(0)-1276-45-7002 +61-7-3368-6868 (international) 1-800-814-472 (toll-free) +61-7-3368-6868 (international) 000-800-100-7136 (toll-free) +61-7-3368-6868 (international) +81-3-6361-8950
E-Mail
[email protected]
[email protected] [email protected]
Before contacting technical support, refer to the Genesys Technical Support Guide for complete contact information and procedures.
enable-ipv6 inactivity-timeout
Transport Layer Security Support on page 25A new subsection that describes Genesys Transport Layer Security (TLS), a new feature that allows for secure data exchange among components.
CCPulse+Administrators Guide
Preface
Client-Side Port Definition on page 25A new subsection that describes a new feature that enables you to control how CCPulse+ connects to various servers and how to configure client-side port definition using the Network.ini file. HistoricalView Section on page 28A new section that holds configuration options that affect the presentation of data in CCPulse+ historical viewsspecifically:
ObjectFormat Section on page 30New functionality that allows you to define how CCPulse+ objects are displayed in the workspace, in all views, and in the Extended Current Status pane. You have the ability to format each CCPulse+ object by using a format string. DisableAgentCurrentState on page 45Updated with the ability to prevent the creation and display of other agent statistics. DisableThresholdsDlg on page 46Added option to the Workspace section that was added in the Reporting 8.0 release, but was previously not included in this document. CCPulse+ Registry Settings on page 50Updated to indicate that the newly added AgentStats configuration setting on page 52 is the only setting that can be edited by using the Microsoft Windows Registry Editor. Three configuration settings have moved to the Settings menu option in CCPulse+ and can no longer be edited by using the Microsoft Windows Registry Editor. These configuration settings are the following:
The Last N Intervals Parameter on page 57Updated to correctly describe the behavior of Last N Intervals in CCPulse+, previously it was described incorrectly in this document. Identifying Custom Statistics on page 67Updated to included new hidden statistic icons that have been added. Hidden Statistics on page 68A new subsection that describes new functionality that allows you to hide both basic and custom statistics by using the Templates Wizard. Figure 13 on page 69Updated to include new hidden statistic icons.
10
Reporting 8.0
Preface
New in Release 8.0.0 on page 14A new subsection in the New in This Release section that describes the feature enhancements that are introduced in release 8.0.0. Storage Section on page 35New configuration options have been added in the Storage section to store objects in binary or XML format specifically:
UserInterface Section on page 39A new EnableXMLExport configuration option was added to the UserInterface section. Configuration Server Connection Failure on page 60An improved reconnection procedure has been added, when the CCPulse+ connection to Configuration Server or Stat Server fails. Support for CCPulse+ reporting of Genesys Info Mart queries has been discontinued in the 8.x release. The previously documented QueryStorageFull Path configuration option has been removed from Chapter 2.
CCPulse+Administrators Guide
11
Preface
12
Reporting 8.0
Chapter
1
Overview
CCPulse+ Overview
This chapter introduces you to CCPulse+, which is a graphical user interface (GUI) component of Genesys Solution Reporting. This chapter includes the following sections: Overview, page 13 New in This Release, page 14
CCPulse+ enables both real-time and historical monitoring of contact center activity. CCPulse+ monitors the status and statistics that are related to contact center objects (such as agents, queues, Routing Points, and interaction queues) and displays them on the users desktop. Using CCPulse+ you can: Customize real-time, historical, and query-based views of contact center objects. Monitor the current state and activity of objects throughout the contact center, to help make decisions about staffing, scheduling, and call-routing strategies. Create threshold/action associations that generate some kind of notification when a specified activity reaches the threshold level you set. Print views, which can then function as basic reports of contact center activity.
CCPulse+ interfaces with the Services and Configuration Layers of the Genesys Framework to monitor agent performance of one or more tenants from one or more sites. If you are using Historical Reporting, CCPulse+ also connects to the Reporting Data Mart Services.
CCPulse+Administrators Guide
13
Figure 1 illustrates the architecture delivering these capabilities. For detailed information on CCPulse+ interface, refer to the Reporting 8.0 CCPulse+ Help. For information about overall Solution Reporting architecture, refer to the Reporting 8.0 Deployment Guide.
Historical Data
Data Mart
Configuration Server
CCPulse+
14
Reporting 8.0
from the 7.0.1 release An improved reconnection procedure, when the CCPulse+ connection to Configuration Server or Stat Server fails, beginning on page 60.
Support for CCPulse+ reporting of Genesys Info Mart queries has been discontinued in the 8.x release. The previously documented QueryStorageFull Path configuration option has been removed from Chapter 3. Other features that are introduced in the 8.0 release, such as dynamic column sizing and sorting, the display of capacity information, horizontal and vertical tabbing, and the security banner that is displayed when the application is invoked are described in either Reporting 8.0 CCPulse+ Help or the Reporting 8.0 Deployment Guide.
FirstDayOfWeek, on page 28 WholeWeeks, on page 29 MinDayNumberInFirstWeek, on page 29 TimeZone, on page 29 NoAggregationInterval, on page 29
The common and security sections on page 24 hold configuration options that are not unique to CCPulse+, but do enable CCPulse+ functionality. This section contains the following new configuration options: enable-ipv6, on page 24 which enables IPv6 for all IP connections for CCPulse+. inactivity-timeout, on page 24 which specifies the amount of time in which a user can be inactive before the inactivity timeout occurs and the user is locked out of the CCPulse+ session. The user must then log back in to continue with the session.
CCPulse+ now supports Genesys Transport Layer Security (TLS) on page 25, which is secure data exchange among components. TLS is an industry-standard protocol for secure communications over the Internet.
CCPulse+Administrators Guide
15
CCPulse+ now supports client-side port definition on page 25, which enables you to control how CCPulse+ connects to various servers and how to configure client-side port definition with the Network.ini file. The ObjectFormat section on page 30 describes a new formatting section and the options that use a format string to define how CCPulse+ objects are displayed in the workspace, in all views, and in the Extended Current Status pane.
The DisableAgentCurrentState configuration option on page 45 has been updated to allow CCPulse+ administrators to prevent CCPulse+ users from creating and displaying other agent statistics. The AgentStats registry setting on page 52 also enables this functionality, but is configured on an individual basis.
The DisableThresholdsDlg configuration option on page 46 was added to the Workspace section. This option was added in the Reporting 8.0 release, but previously was not included in this document. The GraphTitleFontSize, GraphBkColor, and GraphAxisFontSize CCPulse+ configuration settings on page 50, have been removed from the registry and moved to the Settings menu option under the Tools menu of the CCPulse+ interface. Previously, these configuration settings could be edited by using only the Microsoft Windows Registry Editor. Now they can be edited by using only the Settings menu option under the Tools menu of CCPulse+. For more information about how to configure these settings by using menu options, refer to the Reporting 8.0 CCPulse+ Help. The Hidden statistics subsection on page 68 discusses the ability to hide both basic and custom statistics. The new hidden basic and custom statistics icons are shown on page 67. For more information about how to hide statistics in CCPulse+, refer to the Reporting 8.0 CCPulse+ Help.
16
Reporting 8.0
Chapter
Overview
InstallShield Silent is a third-party installation program that Genesys uses to facilitate electronic software distribution for both server and GUI applications on Windows platforms. Silent installations eliminate the need for interactive dialog during the installation process. Instead, you create a single response file filled with the necessary parameters that InstallShield Silent references during subsequent silent installations. After creating your response file and performing a silent installation, review the log file for a successful result code or any errors encountered. You must take some preliminary actions before installing CCPulse+. Refer to the Predeployment Measures chapter in the Reporting 8.0 Deployment Guide for more information.
CCPulse+Administrators Guide
17
Microsoft Windows Explorer. 1. Open a console window. 2. Enter the path to the directory in which you deployed the CCPulse+ installation files. 3. Issue the following command by using the -r command-line parameter:
setup.exe -r
Answer the prompts as appropriate. InstallShield records all your setup choices in a response file named setup.iss and places the file in the Windows directory. For example, if you are using Windows XP, this is the C:\WINDOWS directory. Use the configured setup.iss file any time you must install an application with the specified parameters. The script in Figure 2 shows a sample setup.iss file for CCPulse+. Blank lines have been inserted between sections to facilitate reading.
specifies the full path to the response file. If you do not specify this parameter, InstallShield assumes that the name of the response file is setup.iss, and that it is located in the Windows directory. For example, if you are using Microsoft Windows XP, this is the C:\WINDOWS directory.
18
Reporting 8.0
[{9058E66E-B24C-4CCE-955A-F156227FC674}-DlgOrder]
Dlg0={9058E66E-B24C-4CCE-955A-F156227FC674}-gctiGdWelcome-0
Count and name of dialog boxes encountered during the installation process
[{9058E66E-B24C-4CCE-955A-F156227FC674}-gctiGdWelcome-0] Direction=1
For this dialog box, Direction=1, indicates that the Next button was selected.
[{9058E66E-B24C-4CCE-955A-F156227FC674}-gctiGdAskPath-0] Direction=1 Path=D:\GCTI\CCPulse+ [{9058E66E-B24C-4CCE-955A-F156227FC674}-gctiGdRadioButton3-0] Direction=1 This dialog box prompts whether users can monitor agent Choice=1
statistics. Choice=1 indicates Yes. Create a different response file to deploy the CCPulse+ application to users who are not permitted to monitor agent statistics.
[{9058E66E-B24C-4CCE-955A-F156227FC674}-gctiGdReadyToInstall-0] Direction=1
Reboot=0 indicates that a reboot is unnecessary.
full path to the log file. If you do not specify this parameter, InstallShield assigns the default file name of setup.log and stores the file in the directory that contains the setup.iss file.
Note: Do not use spaces between the /f1 or /f2 parameter and its value in
CCPulse+Administrators Guide
19
The following illustrates some commands you could issue to play back the response file:
setup.exe -s
Both /f1"*\[Setup.exe directory]\setup.iss" and /f2"*\[setup.exe directory]\setup.log" are implied on a Windows XP system.
setup.exe -s /f1"c:\WINDOWS\MonitorAgents.iss" /f2"*\[Setup.exe directory]\setup.log" is implied on a Windows XP
system.
setup.exe -s /f2"c:\WINDOWS\SuzysLog.log" /f1"*\[Setup.exe directory]\setup.iss" is implied on a Windows XP
system.
20
Reporting 8.0
The text in Figure 3 shows the contents of a log file for a CCPulse+ application that was successfully installed by using InstallShield Silent.
[ResponseResult] ResultCode=0 Figure 3: Log File Showing Successful Deployment
CCPulse+Administrators Guide
21
22
Reporting 8.0
Chapter
The CCPulse+ application itself does not consider the case of configuration information it reads from Configuration Server. However, the RDBMS of your Configuration Server database might be case sensitive. As you fine-tune your CCPulse+ Application object, keep this in mind. Also, for those configuration options for which you specify true/false values, any of the following additional values is also valid:
yes/no y/n 1/0 on/off
CCPulse+Administrators Guide
23
24
Reporting 8.0
Network.ini File
This section explains the details about the format of the Network.ini file. The file format is similar to the standard Microsoft Windows INI file, except that it does not have sections, instead it has key-value pairs. Each key-value pair in the Network.ini file should be formatted as follows:
target-host:target-port=[local-host]:local-port
CCPulse+Administrators Guide
25
Specify this name the same way that it is specified in the Host object in Configuration Manager and in the Host parameter in the login dialog. This parameter is case-insensitive. For example, myhost.mydomain.com, MYhOst.MyDoMaiN.com, and MYHOST.MYDOMAIN.COM all refer to the same host.
Note: You must specify the target-host name the same way that it is
specified in Configuration Server. For example, if the full host name is:
myserever.mydomain.com myserver myserver
But in Configuration Server it uses the short name: In the Network.ini file you also must also use the short name: In the above example, if the Network.ini file contains the full host name (myserever.mydomain.com), then client-side port definition will not work.
target-portthe port of the target server to which CCPulse+ connects.
This must be a valid TCP port number. Zero and negative values are not allowed.
local-hostthe local host address that will be used to establish the
connection with a specified target host and port. This is optional and only needs to be specified if the client machine has multiple network addresses. Skipping this step results in Microsoft Windows automatically selecting this parameter. In most cases (including VPN connections) this is acceptable.
local-portthe local port used to establish the connection with a
specified target host and port. This must be a valid TCP port number. Negative values are not allowed. A value of zero is allowed, but results in Microsoft Windows automatically selecting the port.
Note: CCPulse+ maintains two connections with Configuration Server,
which means you must configure two client-side ports for this server. This is done by creating two separate entries in the Network.ini file that contain the same remote host and port, but a different local port, for example:
myserver.mydomain.com:7000=myworkstation.mydomain.com:59000 myserver.mydomain.com:7000=myworkstation.mydomain.com:59001
26
Reporting 8.0
CustomStatistic Section
CustomStatistic Section
The CustomStatistic section holds two configuration options that affect the display of custom statistics within the CCPulse+ interface. (See Table 3.) Table 3: Configuration Option for the CustomStatistic Section
Option ExtendedCurrentStatus Description Use this option to configure CCPulse+ to display reasons in the current state statistics that are provided through agent views. If this option is set to true, CCPulse+ displays the reasons for the current state statistic as one or more strings that are separated by semicolons. If it is set to false, the reasons for the current state statistics are not displayed. To implement this feature fully, you must also define the underlying stat type for agent current state statistics, as follows:
Category=CurrentTargetState MainMask=* Objects=Agent Subject=AgentStatus
This DNAction-based stat type enables Stat Server to provide data along with duration and actual status data. In Figure 4, the AgentStateReason view displays a reason of 1 for the agent Employee_ID_601 who is in the state NotReadyForNextCall. In this example, a threshold and action have also been applied to this statistic. For information on setting thresholds and actions, refer to the discussion starting on page 79. Table 19 on page 80 shows how to use reasons in thresholds. Default Value: false Valid Values: true, false Change Takes Effect: Upon restart MediaTypes This option populates the drop-down list of media types that are available in the Media Filter section of the Properties dialog box for the CurrentTargetState statistic category. Default Value: voice Valid Value: <comma-separated list of media types> (Example: voice,
email, voip)
CCPulse+Administrators Guide
27
HistoricalView Section
HistoricalView Section
The HistoricalView section holds configuration options that affect the presentation of data in CCPulse+ historical views. The options in this section were designed after the DataMart ETL Service configuration options; thus, many cases, you can check your Genesys ETL Service configuration to determine the appropriate value for the corresponding CCPulse+ option. (See Table 4.) Table 4: Configuration Options for the HistoricalView Section
Option FirstDayOfWeek Description Use this option to specify the first day of the week for reports that have weekly intervals. Different counties begin the week on different days (for example, the first day of the week in the USA is Sunday, while the first day of the week in the Russia is Monday). If CCPulse+ is configured for historical reporting with weekly aggregation, please check your Genesys ETL Service Configuration to determine the appropriate value for this option. Note: Standard ISO-8601 assumes that the first day of the week is Monday. Default Value: Sunday Valid Values: Sunday-Saturday Change Takes Effect: Upon restart
28
Reporting 8.0
HistoricalView Section
NoAggregationInterval
This option specifies the time-interval resolution, in minutes, for nonaggregated data in your DataMart database. Configure this option only if you use a nonstandard data collection interval other than the default of 15 minutes. Default Value: 15 Valid Values: 1-1440 Change Takes Effect: Upon restart
TimeZone
This option enables daylight savings time for the specified time zone. Default Value: default Valid Values: GMT+HH, GMT+HHDST, GMT+HH:MM, GMT-HH:MM, GMT+HH:MMDST, GMT-HH:MMDST. The default value represents the default system settings from your current location, where HH is Hours (0-11), MM is Minutes (0-59), and DST will add Daylight Savings Time. Change Takes Effect: Upon restart
WholeWeeks
Use this option to specify whether CCPulse+ recognizes that DataMart is using whole weeks. Please check your Genesys ETL Service Configuration to determine the appropriate value for this option. Default Value: no Valid Values: yes, no Change Takes Effect: Upon restart
CCPulse+Administrators Guide
29
ObjectFormat Section
ObjectFormat Section
CCPulse+ release 8.0.1 introduces functionality that allows you to define how CCPulse+ objects are displayed in the workspace, in all views, and in the Extended Current Status pane. The ObjectFormat section holds configuration options that affect the display format of each CCPulse+ object type. The name of each option in the ObjectFormat section represents the available CCPulse+ object types and the corresponding description defines what can be formatted by using the format string. (See Table 5.) Table 5: Configuration Options for the ObjectFormat Section
Option ACDPosition Agent AgentGroup CallingList Campaign CampaignAgentGroup CampaignCallingList CampaignPlaceGroup Chat CoBrowse Dialer DN EMail Extension ExternalRoutingPoint Description This option defines the format of the ACD Position object. This option defines the format of the Agent object. This option defines the format of the Agent Group object. This option defines the format of the Calling List object. This option defines the format of the Campaign object. This option defines the format of the Campaign Agent Group object. This option defines the format of the Campaign Calling List object. This option defines the format of the Campaign Place Group object. This option defines the format of the Chat object. This option defines the format of the CoBrowsing object. This option defines the format of the S-Dialer object. This option defines the format of the DN object. This option defines the format of the E-mail object. This option defines the format of the Extension object. This option defines the format of the External Routing Point object.
ExternalRoutingPointInTheGroup This option defines the format of the External Routing Point object shown inside a group. Fax InteractionQueue This option defines the format of the Fax object. This option defines the format of the Interaction Queue object.
30
Reporting 8.0
ObjectFormat Section
CCPulse+Administrators Guide
31
ObjectFormat Section
You have the ability to format each CCPulse+ object by using a format string that consists of two parts: a. The field types, and their widths and formats on the screen.
Notes: This part of the format string is compatible with the C-language
printf function format argument. For more information, refer to
http://www.cplusplus.com/reference/clibrary/cstdio/printf/. The ; (semicolon) symbol is allowed to occur only at the END of the first part of the format string, and not at any other location in this part of the string. The semicolon symbol is used to indicate the end of the first part of the format string. b. The properties of the corresponding CCPulse+ object
Example: Formatting an Agent
%5s %5s %5s;EmployID, FirstName, LastName This formatting results in the following: Emplo, John Smith %6s %7s %5s;EmployID, FirstName, LastName This formatting results in the following: Employ, Jonatha Smith
If the ObjectFormat section is defined, but not all objects format strings are configured, CCPulse+ uses substitution rules. (See Table 6.) If the ObjectFormat section is not defined, CCPulse+ defaults to legacy formatting rules.
32
Reporting 8.0
ObjectFormat Section
Substitution Rules
When a format string for an object type is not defined, CCPulse+ can substitute the format string for this object with a more general object type. For example, Extension can be substituted with the format string for DN. Otherwise, it defaults to legacy formatting rules. Table 6 lists the CCPulse+ format string substitutions. Table 6: CCPulse+ Format String Substitutions
Object Type ACD Position Agent Agent Group Calling List Campaign Campaign Agent Group Campaign Calling List Campaign Place Group Chat CoBrowsing DN E-Mail Extension External Routing Point DN No substitution. It displays as you format it by using the format string or defaults to legacy formatting rules. No substitution. It displays as you format it by using the format string or defaults to legacy formatting rules. No substitution. It displays as you format it by using the format string or defaults to legacy formatting rules No substitution. It displays as you format it by using the format string or defaults to legacy formatting rules Agent Group Calling List Place Group DN DN No substitution. It displays as you format it by using the format string or defaults to legacy formatting rules DN DN DN Substitution
External Routing Point in External Routing Point the Group Fax Interaction Queue DN Script
CCPulse+Administrators Guide
33
ObjectFormat Section
34
Reporting 8.0
Storage Section
Storage Section
A storage is a file in which information of a specific type resides. CCPulse+ stores the following in separate storage files: Actions Templates Thresholds Workspaces
The Real-Time Reporting Wizard prompts you for values for these storages. As an alternate method, you can use Configuration Manager to configure storage locations in the Storage section of your CCPulse+ Application object. This is accomplished at the Options tab. Beginning with the 8.0 release, you can specify the format of CCPulse+ storages as one of the following:
CCPulse+ 7.x Storage, in Legacy (OLE storage format) which is provided
CCPulse+Administrators Guide
35
Storage Section
To enter a storage location within Configuration Manager: 1. Double-click the desired item in the Name column to open the Edit Option window. 2. In the Value text box, enter the full path and file name of the location in which the storage file should reside. 3. Click OK. The Storage list now displays the updated storage location.
Notes: The templates and works options must define valid and existing
storages in order to start the CCPulse+ application. If a storage location is to be shared by multiple users, ensure that all have access to it. Table 7: Configuration Options for the Storage Section
Type General Options Option DefaultStorageType Description Specifies which storage format that a CCPulse+ application uses. If this option is not defined or the value for it is specified incorrectly, CCPulse+ uses the default value, Legacy (OLE storage format). Valid values: Legacy, Binary, XML Default value: Legacy ActionsStorageFullPath
Defines the full path and name of the file in which CCPulse+ stores pre-8.0 actions. This option is retained for backward compatibility.
Defines the full path and the name of the file in which CCPulse+ stores pre-8.0 templates. This option is retained for backward compatibility. Defines the full path and the name of the file in which CCPulse+ stores pre-8.0 thresholds. This option is retained for backward compatibility. Defines the full path and the name of the file in which CCPulse+ stores pre-8.0 user workspaces. This option is retained for backward compatibility.
TemplatesStorageFullPath
ThresholdsStorageFullPath
WorkspacesStorageFullPath
36
Reporting 8.0
Storage Section
Defines the full path to the valid directory name in which CCPulse+ stores, in binary format, actions that result when an administrator clicks Finish in the Actions Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in binary format, templates that result when an administrator creates a new template and clicks Finish in the Template Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in binary format, thresholds that result when an administrator clicks Finish in the Threshold Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in binary format, user workspaces. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist.
BinTemplatesStorage FullPath
BinThresholdsStorage FullPath
BinWorkspacesStorage FullPath
CCPulse+Administrators Guide
37
Storage Section
Defines the full path to the valid directory name in which CCPulse+ stores, in XML format, actions that result when an administrator clicks Finish in the Actions Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in XML format, templates that result when an administrator creates a new template and clicks Finish in the Template Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in XML format, thresholds that result when an administrator clicks Finish in the Threshold Wizard. This path must preexist and point to a valid path; CCPulse+ does not create this path if it does not exist. Defines the full path to the valid directory name in which CCPulse+ stores, in XML format, user workspaces. This path must preexist and point to ta valid path; CCPulse+ does not create this path if it does not exist.
XMLTemplatesStorage FullPath
XMLThresholdsStorage FullPath
XMLWorkspacesStorage FullPath
38
Reporting 8.0
UserInterface Section
UserInterface Section
The UserInterface section holds configuration options with which you can specify how CCPulse+ is to display data in its interface. (See Table 8.) Table 8: Configuration Options for the UserInterface Section
Option DisableThresholdsDlg Description Use this option to enable contact-center operators who are configured as CCPulse+ Users, to set thresholds, or to prevent them from doing this. This option controls visibility of the Set Threshold menu item on the shortcut menu that is invoked when the user right-clicks a statistic or statistics group. Setting this configuration option has no meaning for users who are configured as CCPulse+ Administrators. Full threshold and action functionality is always available to CCPulse+ Administrators. Default Value: false Valid Values: true, false Change Takes Effect: Upon restart Note: This option is not present in the CCPulse+ template. EnableDNAliases Use this option to configure CCPulse+ to display either DN numbers or DN aliases in the CCPulse+ workspace. To display DN aliases, specify true for this options value. To display DN numbers, specify false. CCPulse+ synchronizes DN aliases with any changes you might make to a DN objects properties. Default Value: true Valid Values: true, false Change Takes Effect: Upon restart EnableXMLExport Use this option to allow users to make use of the Export to XML menu item on the CCPulse+ File menu. The Export to XML menu item enables users to export their workspaces in XML format to a location that they designate. If this option is set to the default value of false, this menu item will not appear on the File menu. The workspace that you export is for informational purposes only. CCPulse+ does not import information about workspaces from this file nor does the export affect the location of the workspaces storage. Default Value: false Valid Values: true, false Change Takes Effect: Upon restart
CCPulse+Administrators Guide
39
UserInterface Section
40
Reporting 8.0
UserInterface Section
CCPulse+Administrators Guide
41
View Section
View Section
The View section holds configuration options that affect the presentation of data in CCPulse+ views. (See Table 9.) Table 9: Configuration Options for the View Section
Option CurrentStateRefresh Interval Description This option specifies the time interval at which CurrentState statistics will be refreshed in the view. If the view does not contain any CurrentState statistics, CCPulse+ ignores this option. CCPulse+ adjusts any value specified over the maximum value to the maximum value. Note: If you enter a 0 (zero), a negative number, or any alphanumeric string, you will disable this setting. The current state duration will be not be refreshed until it receives an update from the Stat Server. Default Value: 5 (seconds) Valid Values: 0 to 86399 Change Takes Effect: Upon restart DelayBeforeRemoval This option specifies the number of seconds that logged-out agents remain visible, but in a dimmed (greyed out) state, in a real-time V/AG dynamic membership view, before CCPulse+ removes them from the view entirely. A value of 0 instructs CCPulse+ to immediately remove agents from the view; however, in reality, some small amount time could pass before the view is updated. CCPulse+ resets any value specified outside the range of valid values to 0. Default Value: 15 (seconds) Valid Values: 0 to 3600 Change Takes Effect: Upon restart
42
Reporting 8.0
View Section
CCPulse+Administrators Guide
43
Workspace Section
Workspace Section
The Workspace section holds configuration options that affect your CCPulse+ workspace. (See Table 10.) Note that because the options defined in this section are defined within the CCPulse+ Application object in Configuration Server, their settings affect all CCPulse+ instances that are configured to use the object. You cannot change these settings for every instance of CCPulse+ individually. Instead, you have to define a new Application object for each combination of configuration settings that you wish to set and then configure each instance to use the appropriate Application object. Table 10: Configuration Options for the Workspace Section
Option CurrentStateEnable Description Use this option to enable or disable the display of current status for all configuration objects that are selected for monitoring on the Call Center Objects pane. Consider using this option if you want to increase runtime performance of CCPulse+ and decrease startup time especially if you regularly open workspaces that contain a large number of objects. Default Value: true Valid Values: true, false Change Takes Effect: Upon restart
44
Reporting 8.0
Workspace Section
Displaying agent status icons for agents in tree view. Creating historical and real-time views for individual agents. Creating historical and real-time views for members, and dynamic membership views for agent groups. Setting thresholds for agents. Displaying an extended status for individual agents. Displaying an extended status for agent groups.
Default Value: false Valid Values: true, false Change Takes Effect: Upon restart
CCPulse+Administrators Guide
45
Workspace Section
46
Reporting 8.0
Workspace Section
Note: Displaying agent group capacity will have a linear impact on CCPulse+ performance (depending on the number of calls that the group members receive). Default Value: false Valid Values: true, false Change Takes Effect: Upon restart IgnoreNewObjectNotifications Use this option to specify whether CCPulse+ should accept or ignore notifications from Configuration Server about newly created reportable objects. If this option is set to true, CCPulse+ ignores notifications of new objectsany new reportable objects will not appear in the workspace. If this option is set to false, new objects will appear instantly in the Call Center Objects pane. When the workspace is saved, these objects become a permanent part of the workspace, like the other configuration objects that were explicitly selected for monitoring when the workspace was initially created. Default Value: false Valid Values: true, false Change Takes Effect: Upon restart
CCPulse+Administrators Guide
47
Workspace Section
48
Reporting 8.0
CCPulse+Administrators Guide
49
Figure 8 shows instances of two different time-format settings. The first image uses a regional time format of h:mm:ss tt, representing 4 oclock in the afternoon as 4:00:00 PM. The second image uses the HH:mm:ss format and displays the same time as 16:00:00. Although CCPulse+ accepts dynamic system changes of regional time and dates, if CCPulse+ is currently displaying a view when the change is made, you must deactivate and reactivate the view in order to observe its effect.
50
Reporting 8.0
Editor, Genesys recommends that you use the CfgApplication configuration option in the ObjectFormat section to set this value. Where applicable, Genesys recommends that you use the Settings menu option in CCPulse+ to set these values. However, if you prefer to configure these settings directly using the Registry, refer to the path information that is provided for each setting in the following table. (See Table 11.) You can no longer edit the following three CCPulse+ configuration settings by using the Microsoft Windows Registry Editor. They have been removed from the registry and moved to the Settings menu option under the Tools menu of the CCPulse+ interface:
GraphTitleFontSize GraphBkColor GraphAxisFontSize
Note: Unlike settings that are configured in the CCPulse+ Application object,
which apply to all CCPulse+ instances that use that application, registry key changes affect only the local workstation. Access the root for all these settings through the following path in the Registry:
HKEY_CURRENT_USER\Software\GCTI\CallCenter\
Configure your user interface by entering the desired value next to the appropriate key. (See Table 11.)
CCPulse+Administrators Guide
51
Displaying agent status icons for agents in tree view. Creating historical and real-time views for individual agents. Creating historical and real-time views for members, and dynamic membership views for agent groups. Setting thresholds for agents. Displaying an extended status for individual agents. Displaying an extended status for agent groups.
Setting the DisableAgentCurrentState configuration option under the Workspace section, on page 45 to true will also enable this functionality, but will affect all CCPulse+ users logged into the same CCPulse+ application. Setting the AgentStats registry setting to RESTRICTED_STATS on individual computers, enables this functionality on an individual user basis. Default Value: Depends on the DisableAgentStatus configuration option. If DisableAgentStatus =true, the default value of AgentStats is RESTRICTED_STATS. If DisableAgentStatus = false, the default value of AgentStats is FULL_STATS. Valid Values: RESTRICTED_STATS, FULL_STATS Path:HKEY_LOCAL_MACHINE\SOFTWARE\GCTI\CallCenter\VIEW_STATS value
AgentStats
DeltaAvgTime
Specifies the default value, in seconds, of the Insensitivity parameter for statistics in the Average Time category. Default Value: 2 Valid Values: 2600
52
Reporting 8.0
For example, if you have an agent who is named Vince Duncan and whose employee number is 9001, the following string:
FormatAgentInfo = %n-%f.%L
Note: Separate the parameters by using punctuation with which you want the elements to display.
CCPulse+Administrators Guide
53
54
Reporting 8.0
Chapter
CCPulse+Administrators Guide
55
Composite Metrics
CCPulse+ does not maintain a constant connection to Data Mart. Instead, it connects for each request made and then disconnects until the next request. This functionality saves Data Mart resources.
Note: For CCPulse+, you can use a Data Mart that has only one active
Configuration Server defined to it. (Active indicates that Configuration Server has an ODS [Operational Data Storage] assigned to it within ETL Assistant.) If your Data Mart collects information from multiple Configuration Servers, you cannot use it with CCPulse+.
Composite Metrics
Prior to release 7.0, you could not use CCPulse+ to supply composite metrics in reportsexcept for those metrics already provided by the ready-to-use reports. To correct this shortcoming, the 7.0 release introduced a custom-formula capability, allowing you to define averages, percentages, and more. Refer to the Template Wizard topic in Reporting 8.0 CCPulse+ Help for information on how to use this feature.
Column Names
Data Mart stores information in folder templates that include only a single object (Agent, Place, Queue, and so on). However, in CCPulse+, you can create custom templates that include multiple compatible objects. To link object data stored in Data Mart, CCPulse+ identifies metrics by the Data Mart column name. For this to function properly, the Data Mart folder template for each object to be incorporated into the CCPulse+ template must include the identical column name used in the CCPulse+ template. Otherwise, data from the Data Mart template is omitted from the CCPulse+ template.
Warning! If more than one custom template uses the same column name to
specify different metrics, CCPulse+ might combine these metrics incorrectly. For more information about the Data Mart folder templates and column names provided in reports from Genesys solutions, refer to the Data Mart Folder Templates and Data Mart Composite Metrics sections in Chapter 6 of the Reporting Technical Reference Guide.
56
Reporting 8.0
order for CCPulse+ to accept newly created or changed metrics, you must restart it.
CCPulse+Administrators Guide
57
58
Reporting 8.0
Chapter
CCPulse+ maintains connections with Configuration Server to retrieve information about CCPulse+ application configuration and call center objects. This chapter describes how CCPulse+ behaves when any of these server connections, or the connections to their designated backups, fails. This chapter also describes what actions you should take to regain full functionality under these circumstances.
Note: For information about the Genesys security feature, client-side port
definition, which controls and secures the connections between CCPulse+ and these servers, see Client-Side Port Definition on page 25. The scenarios in this chapter begin with a CCPulse+ session that has all of its connections established. For any number of reasons, the connections might subsequently failand in any orderto affect normal CCPulse+ operation.
This chapter contains the following sections: Configuration Server Connection Failure, page 60 Stat Server Connection Failure, page 62 DB Server Connection Failure, page 65
CCPulse+Administrators Guide
59
Furthermore, you cannot open an existing workspace or create a new one if CCPulse+ has no connection to Configuration Server. With regard to changes that you make to the CCPulse+ Application object itself, CCPulse+ reads this information only upon startup; therefore, a Configuration Server disconnection after an initial successful connection affects CCPulse+s ability to read its own configuration only upon the next startup. In a failed Configuration Server connection, CCPulse+ silently executes its reconnection procedure: 1. CCPulse+ attempts to reconnect automatically 2. If CCPulse+ fails to reconnect automatically within the configured number of reconnect attempts, it displays the following message box in Figure 9, which prompts you to select one of the two options:
Yes No
3. If you select Yes, CCPulse+ attempts again to reconnect to Configuration Server. An unsuccessful attempt returns CCPulse+ to Step 2 and this loop continues indefinitely while Configuration Server is down and you reclick Yes. A successful connection terminates the reconnection procedure, and CCPulse+ resumes its receipt of Configuration Server updates.
60 Reporting 8.0
4. If you select No, CCPulse+ terminates the reconnection procedure. and makes no further attempts to reconnect to either the primary or backup Configuration Server. 5. If a backup Configuration Server is configured, CCPulse+ attempts to connect to it a number of times, defined as follows: Half of the switchover count (rounded up) * all configured server reconnection attempts (for both primary and backup) Where: The switchover count is hardcoded at five attempts. All reconnection attempts include the reconnection values that are configured for both primary and backup Configuration Server applications. Figure 10 shows the Server Info tab of a configuration Server application in Configuration Manager, where this parameter is configured.
6. If a backup Configuration Server is not configured, CCPulse+ will try to reconnect to the current Configuration Server using number of Reconnect Attempts configured for this application in the Configuration Manager. 7. For step 5 or step 6, the following message will appear in the status bar: Reconnecting to CfgServer (attempt X of Y).
CCPulse+Administrators Guide
61
Upon a successful connection to either the primary or backup Configuration Server, the CCPulse+ status bar reads as follows:
Primary/Backup CfgServer ONLine
If, however, you opt to leave the reconnection loop without connecting to any Configuration Server, when Configuration Server (or its backup, if specified) does get back online, you must close and then reopen your workspace in order for CCPulse+ to acknowledge Configuration Server status and for CCPulse+ to receive Configuration Server updates. CCPulse+ checks the status of its connection to Configuration Server every time that a workspace is opened. CCPulse+s connection to Configuration Server can fail for a number of reasons, including the following: Someone closes Configuration Server or kills its process. Network problems break CCPulse+s connection to Configuration Server.
You can continue to use a previously opened and activated CCPulse+ workspace without a connection to Configuration Server; however, you cannot open or create a new workspace without this connection.
In a failed Stat Server connection, CCPulse+ next silently executes its reconnection procedure. 1. CCPulse+ attempts to reconnect automatically 2. If CCPulse+ fails to reconnect automatically within the configured number of reconnect attempts, it displays the following message box in Figure 11, which prompts you to select one of the two options:
Yes No
62
Reporting 8.0
3. If you select Yes, CCPulse+ attempts again to reconnect to Stat Server. An unsuccessful attempt returns CCPulse+ to Step 2 and this loop continues indefinitely while Stat Server is down and you reclick Yes. A successful connection terminates the reconnection procedure, and CCPulse+ resumes its receipt of Stat Server updates. 4. If you select No, CCPulse+ terminates the reconnection procedure. and makes no further attempts to reconnect to either the primary or backup Stat Server. 5. If a backup Stat Server is configured, CCPulse+ attempts to connect to it a number of times, defined as follows: Half of the switchover count (rounded up) * all configured server reconnection attempts (for both primary and backup) Where: The switchover count is hardcoded at five attempts. All reconnection attempts include the reconnection values that are configured for both primary and backup Stat Server applications. Figure 12 shows the Server Info tab of a Stat Server application in Configuration Manager, where this parameter is configured.
CCPulse+Administrators Guide
63
6. If a backup Stat Server is not configured, CCPulse+ will try to reconnect to the current Stat Server using number of Reconnect Attempts configured for this application in the Configuration Manager. 7. For step 5 or step 6, the following message will appear in the status bar: Reconnecting to StatServer (attempt X of Y). If Stat Server restarts within the CCPulse+ reconnection loop, CCPulse+ resumes sending statistical requests to and receiving statistical updates from Stat Server, and the CCPulse+ status bar reads as follows:
Primary/Backup StatServer ONLine
If, however, no connection is made to Stat Server (or its backup, if specified) within the reconnection loop, when Stat Server does get back online, you must close and then reopen your workspace in order for CCPulse+ to acknowledge the connection and resume normal operation. CCPulse+ checks the status of its connection to Stat Server only when you open a workspace or upon execution of its reconnection procedure. CCPulse+s connection to Stat Server can fail for a number of reasons including the following: StatServer becomes overloaded. Someone closes Stat Server.
64
Reporting 8.0
Someone kills the Stat Server process. Network problems break CCPulse+s connection to Stat Server.
You can continue to use a previously opened and activated CCPulse+ workspace without a connection to its Stat Server; although this mode of operation is not particularly useful. However, you cannot open or create a new workspace without this connection.
CCPulse+Administrators Guide
65
66
Reporting 8.0
Chapter
CCPulse+Administrators Guide
67
Hidden Statistics
CCPulse+ release 8.0.1 introduces functionality that allows you to hide both basic and custom statistics by using the Templates Wizard. Hidden statistics are identified by the appearance of the hidden icon that precedes the statistic name (see page 67). These hidden icons, along with basic and custom statistic icons, are displayed in the Predefined Statistics window of the Templates Wizard (see Figure 13). There are three options from which to choose when you are hiding statics: Hide in All ViewsHides the custom statistic in any type of view (tree, table, or graph) for CCPulse+ users, and locks the statistic for CCPulse+ administrators. The main purpose of these statistics is to receive data that can be viewed and used in formulas. Hide in Table ViewHides the custom statistic in table view. The corresponding statistic is hidden, but it can be shown at any time in table view. Hide in Graph ViewHides the custom statistic in graph view, but it will still be visible in other views.
Administrators can use the Hide in Graph View option to increase the performance of CCPulse+ views by hiding insignificant statistics in graph views. For detailed information about how to hide custom or basic statistics, refer to the Reporting 8.0 CCPulse+ Help.
The trailing semicolon is optional. CCPulse+ includes the name of the statistic group to distinguish the statistic, in case another statistic of the same name exists in another statistical group. If either StatisticGroupName or StatisticName contains no spaces, CCPulse+ drops the corresponding group and statistic delimiters, the parentheses, and the double quotes:
68
Reporting 8.0
ccpulse.StatisticGroupName.StatisticName
Example 1 demonstrates the definition of the All Entered custom statistic, which is provided in the Callback Queue template. Example 1 The Callback Queue template (which is provided with the Voice Callback [VCB] option) makes use of several custom statistics. Figure 13 shows a cutaway of CCPulse+s Predefined Statistics window and many of this templates statistics. The Requested Statistics list in this window contains the templates categorization of statistic groups and statistics, and it highlights one custom statistic in particular, All Entered, which belongs to the Total Entered statistic group.
Note: Figure 13 contains hidden statistics (CB Entered, Live Distributed,
EWT, CB EWT, and AWT). For more information about hidden statistics,
When you open the properties of the All Entered statistic, CCPulse+ opens the ActiveX Scripting Expression dialog box and displays the statistics formula. Figure 14 on page 70 provides a cutaway of the ActiveX Scripting Expression dialog box, which shows that the definition of All Entered is based on two basic statistics, CB Entered and Live Entered, both of which belong to the Total Entered group.
CCPulse+Administrators Guide
69
To obtain information about the current status of a statistic in a formula, use the state predefined object and its properties (see Tables 12 and 13). To activate this functionality, be sure to set the ExtendedCurrentStatus configuration option to True and to define the statistics underlying stat type appropriately. The description of the option on page 27 provides these details.
ID of the place where the agent is logged in. Login ID used by the agent.
70
Reporting 8.0
Capacities
Collection
AgentGroupID Capacities
String Collection
and MaxInteractions (see Table 14). To return this collection of capacity items, set the EnableAgentGroupCapacity [Workspace] configuration option to true.
CCPulse+Administrators Guide
71
Table 14 provides a description of the properties of the Capacities items. Table 14: Properties of the Capacity Items
Property MediaType CurrentInteractions RoutableInteractions MaxInteractions Type String Integer Integer Integer Description The name of the media. The number of current interactions. The number of available routable interactions. The maximum number of interactions.
The formula script can count the Capacities collection by using either the enumerator or the index (for example, by using .value(index) method). The number of capacity items are available through the .Count property. Certain capacity items for specific media are also available by using .value("media_name"); for example, var voice_capacity = state.Capacities. Values("voice"). Refer to Example 2 and Example 3. Example 2 The following is an example of the formula script for Agents:
if(state.type == "AgentState") { var i, item, s = ""; for(i = 0; i < state.Capacities.Count; i++) { item = state.Capacities.Value(i); s += item.MediaType; s += "(" + item.CurrentInteractions + "," + item.MaxInteractions + "," + item.RoutableInteractions + "),"; } result.Text = s; } else result.Text = "n\\a";
Example 3 The following is an example of the formula script for Agent Groups:
if(state.type == "AgentGroupState") { var i, item, s = ""; for(i = 0; i < state.Capacities.Count; i++) {
72
Reporting 8.0
item = state.Capacities.Value(i); s += item.MediaType; s += "(" + item.CurrentInteractions + "," + item.MaxInteractions + "," + item.RoutableInteractions + "), "; } result.Text = s; } else result.Text = "n\\a";
Note: In the CCPulse+ workspace, the Graph view displays only one number
To obtain DN-related information in a formula, use the DN predefined object with its properties listed in Table 15. This object can only be used in conjunction with the state predefined object. Table 15: Properties of the DN Object
Property type DNType DN StartTime Type String String String Long Description This string contains the value DNState. The directory numbers type, such as Position, Extension, or Chat. The directory number. Greenwich Mean Time (GMT) date and time when current status has been established. Suitable for use in the Date object available in the JScript. Current status name of the directory number as provided by Stat Server. The switchs identification number, as registered in Configuration Server, to which the DN belongs. Contains information about the list of actions currently occurring at a DN. DNs can hold several simultaneous actions. The list can be iterated by using Enumerator object (available in Jscript) to obtain specific agent data. Refer to the GetAction function in Example 4 for an example showing how to use this property.
Action-Related Information
To obtain action-related information use the Action predefined object and its properties described in the Table 16. This object can only be used in
CCPulse+Administrators Guide
73
conjunction with DN predefined object. Please note that the names of masks can coincide with the names of statuses. Table 16: Properties of the Action Object
Property type Action StartTime Type String String Long Description This string contains the value Action. Name of the action, such as those listed on page 84 without the SDNA, SRPA, or SCMPA prefixes. GMT date and time when this action has been established. Suitable for use in the Date object available in the JScript.
Example 4 The following example illustrates how you can use the state predefined object within a customized statistics formula to determine an agents current state:
result.Text = GetAgentState(); function GetAgentState() { if(state.type != "AgentState") return "n/a"; var r = "(" + FormatDate(state.StartTime) + ") "; r += state.AgentID; r += " [Place: " + state.PlaceID; r += " Login: " + state.LoginID + "]"; r += ", Status: " + state.Status; r += "; DNs: "; for(var e = new Enumerator(state.DNs); !e.atEnd(); e.moveNext()) { r += GetDNState(e.item()); } return r; } function FormatDate(dateVal) { var dateObj = new Date(dateVal); return dateObj.getHours() + ":" + dateObj.getMinutes() + ":" + dateObj.getSeconds(); } function GetDNState(dn) { var r = "(" + FormatDate(dn.StartTime) + ") "; r += dn.DN;
74
Reporting 8.0
r += " [Switch: " + dn.SwitchID; r += ", Type: " + dn.DNType + "], Status: " + dn.Status; r += "; Actions: " for(var e = new Enumerator(dn.Actions); !e.atEnd(); e.moveNext()) { r += GetAction(e.item()) + " "; } return r; } function GetAction(a) { var r = "(" + FormatDate(a.StartTime) + ") "; r += a.Action; return r; }
The information that CCPulse+ returns is the same information that appears in the Extended Current Status window when requested for Agent objects. Figure 15 illustrates sample data returned in the Example 4 script. Note that the time information returned from running the script reflects startup time (the time that the current status occurred)not duration as shown in the Extended Current Status window.
CCPulse+Administrators Guide
75
Displays the returned result in string format. If you omit the result object from the formula, CCPulse+ might not return the result as you expect it. For example, if you try to calculate duration based on a set of time statistics that you create, and if you do not use result.duration in your formula, CCPulse+ might return a Long value and not apply the hh:ss:mm or other time format. Figure 14 on page 70 illustrates the use of result.Long in the definition of the All Entered statistic.
To chose either option, from the Statistic dialog window in the CCPulse+ Template Wizard: Select the media for which CCPulse+ will display the capacity information.
Note: The list of available media is populated by the values set for the
MediaTypes configuration option. See Chapter 3 for more
information on this option. Select the media format from the drop-down menu, or enter a user-defined format.
76
Reporting 8.0
Figure 16 shows the predefined formats in a cutaway of the Statistic dialog box.
Note: Capacity information is available in the CurrentAgentTargetState or
CurrentAgentGroupTargetState
statistic (CurrentTargetState
statistical category).
.
Table 17 lists the placeholder values for which you can substitute a user-defined sting. Note that you must preface the strings entered with a % sign. Table 17: User-Defined Format Strings for Capacity Information
Placeholder %media %m %c %r Type String Description Displays the name of the media in a single cell.
Single integer Displays the maximum interactions in a single cell. Single integer Displays the current interactions in a single cell. Single integer Displays routable interactions in a single cell.
Table 18 lists the predefined formats you can select from a drop-down menu of format choices.
CCPulse+Administrators Guide
77
%media(%c, %m, %r) voice(0, 3, 3) Displays media name, current interactions, maximum interactions, and routable interactions in a single cell. This is the default format. %c, %m, %r 0, 3, 3 Displays current interactions, maximum interactions, and routable interactions in a single cell delimited by commas. Displays current and routable interactions in a single cell delimited by commas. Displays the current interactions. Displays the routable interactions. Displays the maximum interactions.
%c, %r
0, 3
%c %r %m
0 3 3
78
Reporting 8.0
Chapter
7
Overview
This chapter presents the predefined: Objects that you can use in the threshold and action VBScripts to create and edit thresholds and actions. Thresholds that are installed with CCPulse+. Actions that are installed with CCPulse+.
All existing thresholds and actions that are applied to the root level of a view are propagated automatically to any new objects that are added to the view. You do not have to apply thresholds manually to statistics of newly added objects. You can add a customized threshold to a statistic of a specific contact-center object, even if there is a pre-existing threshold applied at the root level. In this case, the customized threshold will take precedence. Any changes to the root-level threshold will not affect a statistic with a customized threshold. A new icon will designate the associated customized threshold. For instructions on using the Threshold Wizard and Action Wizard to create and edit thresholds and actions, and for information on associating thresholds and actions for specific contact-center objects, see the Reporting 7.5 CCPulse+ Help.
CCPulse+Administrators Guide
79
Predefined Objects
Predefined Objects
Use the predefined objects listed and described in Table 19 to modify the predefined CCPulse+ thresholds and actions or to create new ones using the CCPulse+ Threshold and/or Action wizards. Table 19: Predefined Objects for Use in Threshold and Action Scripts
Object Threshold Use this object to set and retrieve the data used in threshold calculation, which is available in both threshold and action scripts. Result Boolean Contains the result of the execution of a threshold script. If the result is not set in the script, it is assumed to be False. Example: Threshold.Result = True StatValue Variant Contains the current value of the statistic to which the threshold script is applied. Example: If (Threshold.StatValue = x) then ... StatAlias String Alias of the statistic, as defined in the template. Note: The alias is an empty string if a threshold is applied to a configuration object in the main tree. ActionDelay Integer Used to delay action execution by n seconds. If the threshold script that set this value is executed again before its actions are completed, and the result is False, action execution is canceled. This allows for so-called duration thresholds, the actions of which are executed if a certain condition is True for the amount of time specified. Example scenario: The value of a statistic changes. CCPulse+ executes the Threshold1 script, which contains an action delay of 10 seconds. The script returns a True value. You can expect CCPulse+ to execute the associated actions 10 seconds later. If the value of the same statistic changes 5 seconds later, CCPulse+ re-executes the Threshold1 script. If the script returns False, CCPulse+ cancels execution of the delayed actions. If there is no statistic changes before the 10 seconds elapse, CCPulse+ executes the actions, thereby showing that a particular condition was True for the duration of 10 seconds. Example: Threshold.ActionDelay = 10 Type Description
80
Reporting 8.0
Predefined Objects
Table 19: Predefined Objects for Use in Threshold and Action Scripts (Continued)
Object ActionDelay (continued) Type Description Note: ActionDelay functionality is based on the duration of Current Status onlynot Current Status and Reason together, unless status and reason are coupled together at the moment of an actual change in Current Status. To obtain the correct time duration when Current Status and Reason are coupled together, you can configure your statistic to use the CurrentTime statistical category with a specific status mask that is filtered by a specific reason. StatReasons String Use this read-only property to evaluate reasons in threshold and action scripts. The following threshold script illustrates how you can use this property when it is applied to an agent CurrentState statistic:
If (Threshold.StatValue = StatAction.SDNANotReadyForNnextCall and Threshold.StatReasons = Lunch) then Threshold.Result = True end if
Note that reasons and action codes can appear only for following agent states: LoggedIn AfterCallWork NotReadyForNextCall WaitForNextCall
Reasons can originate from more than one source (T-Server, hardware, or other), and they can be provided to CCPulse+, via Stat Server, in string or integer format. CCPulse+ converts all reasons to string format, separating each with a semicolon (;). To effectively evaluate the concatenated string, the CCPulse+ Administrator might have to parse it using VBScript. Configuration Object Properties These represent the primary properties of any configuration object (also available in action scripts). CFGTenantDbid Long tenant dbid Example: Threshold.CFGTenantDbid CFGDbid Long object dbid Example: Threshold.CFGDbid CFGObjectID String object ID Example: Threshold.CFGObjectID
CCPulse+Administrators Guide
81
Predefined Objects
Table 19: Predefined Objects for Use in Threshold and Action Scripts (Continued)
Object CFGType Type Integer Description Type of object (short CfgObjectType enumeration value, for instance, value 4 means CFGPlace). The enumeration values for the available object types are as follows: Switch1 DN2 Person3 Place4 AgentGroup5 PlaceGroup6 Example: Threshold.CFGDNGroup CCPulse+ support for the CFGScript predefined object was introduced in the 7.0.1 release. CCPulseNotifier Use this object to send notifications to CCPulse+ (also available in action scripts). SetColor Color: Integer Notifies CCPulse+ of a color change. A member of the Color object can be passed as a parameter. Example: CCPulseNotifier.SetColor(Color.Red). Or a user-defined RGB value can be passed instead. Example: CCPulseNotifier.SetColor(RGB(50,50,50)). For further information about the RGB function, consult your Visual Basic Script (VBScript) documentation. Note: You must set color commands for color names using the English language. ResetColor N/A Notifies CCPulse+ that the color of the object (set by SetColor) should be reset to its original color. Example: CCPulseNotifier.ResetColor Hide Show N/A N/A Use this operation to hide a configuration object in the Call Center Objects pane or Tree view, depending on the threshold application. Use this operation to show a configuration object on the Call Center Objects pane, the Tree view, and the Graph view. Used to display an object that was previously hidden using the Hide action associated with a different threshold. Tenant7 Script12 DNGroup17 CallingList26 Campaign27
82
Reporting 8.0
Predefined Objects
Table 19: Predefined Objects for Use in Threshold and Action Scripts (Continued)
Object Color (Enumeration Object) The properties of this object are constant RGB values that you can use with the SetColor and ResetColor methods (also available in action scripts). Some commonly used color codes are listed below. Examples:
CCPulseNotifier.SetColor(Color.Red) or CCPulseNotifier.SetColor(RGB(255,0,0))
Type
Description
The following commands (and their corresponding RGB values) are available with the Color object: Red Blue Green DarkRed DarkGreen Cyan DarkCyan Magenta DarkMagenta Yellow White Black Gray DarkGray RGB (255,0,0) RGB (0,0,255) RGB (0,255,0) RGB (128,0,0) RGB (0,128,0) RGB (0,255,255) RGB (0,128,128) RGB (255,0,255) RGB (128,0,128) RGB (255,255,0) RGB (255,255,255) RGB (0,0,0) RGB (192,192,192) RGB (128,128,128)
Note: You must set color commands for color names using the English language.
CCPulse+Administrators Guide
83
Predefined Objects
Table 19: Predefined Objects for Use in Threshold and Action Scripts (Continued)
Object StatAction (Enumeration Object) The properties of this object are the names of the DNs, route points, and campaign actions as described in the statistics library (available only in threshold scripts). Example: if ( Threshold.StatValue = StatAction.SDNALoggedIn ) then ...
Current Status Name Current State Value
Type
Description
SDNAWaitForNextCall SDNACallDialing SDNACallRinging SDNANotReadyForNextCall SDNACallUnknown SDNACallConsult SDNACallInternal SDNACallOutbound SDNACallInbound SDNALoggedOut SDNACallOnHold SDNANotMonitored SDNAMonitored SDNALoggedIn SDNAOnHook SDNAOffHook SDNAAfterCallWork SRPANotMonitored SRPAMonitored SRPANotReadyForNextCall SDNAASM_Engaged SDNAASM_Outbound SRPAWaitForNextCall SRPACallWait SCMPAStatusDeactivated SCMPAStatusActivated SCMPAStatusRunning
4 6 7 8 18 19 20 21 22 23 13 0 1 2 3 5 9 0 1 2 16 17 13 9 0 1 2
Each Current Status has an associated Current State value which is constant. The prefixes in the listing to the left mean the following: DNADirectory Number Action RPARouting Point Action CMPACampaign Action The S prefix on each indicates that the item is a Stat Server entity (rather than an entity of Configuration Server or any other server). Elsewhere within the CCPulse+ interface, these actions appear without these prefixes. Example: if
(Threshold.StatValue=StatAction. SDNANotMonitored) then ... Threshold.Result=True end if
CCPulse+ executes the corresponding action script when the selected DN statistic achieves NotMonitored status. Note: ASM is a reference to the Active Switching Matrix call model used in conjunction with predictive dialing in the Outbound Contact solution. Refer to Genesys Outbound Contact documentation for further details.
84
Reporting 8.0
Predefined Thresholds
Predefined Thresholds
This section describes the following threshold scripts which are provided with each Genesys solution:
AgentLoggedIn AgentLoggedOut CampaignActivated CampaignDeactivated ExactValue ExactValueWDuration GreaterThanLimit GreaterThanLimitWDuration LessThanLimit LessThanLimitWDuration
The purpose of providing these scripts is to demonstrate how you might apply thresholds within your own CCPulse+ environment. The scripts and threshold definitions are identical for each Genesys solution and are stored in a file that is named thresholds.stg.
Note: Because these are sample scripts, it is likely that their absolute values
have little significance within your environment. You are encouraged to modify them to more meaningful values.
CCPulse+Administrators Guide
85
Predefined Thresholds
CCPulse+ executes the thresholds in the order you set in the Threshold/Action Association dialog box. The first threshold returning a True result stops the launch of all remaining thresholds in the chain. Any attached action(s) will be run in the order set. The next statistics value repeats the process. You can also use object linking and embedding (OLE) automation objects within threshold scripts, because VBScript allows this.
Note: It is not recommended to use OLE objects with either a GUI-like
appearance or with dialog boxes that require explicit user confirmation. And, starting with release 7.2, you can configure the SafeScriptingMode option to specify whether CCPulse+ spawns a separate thread to execute VBScripts. Refer to SafeScriptingMode on page 48 for more information about this option.
Real-World Example
Consider the following business scenario, which uses thresholds and actions to aid a CCPulse+ operator in managing a queue named ClientQueue. Management has decided that 5 calls or fewer waiting in ClientQueue is the desired situation; 10 or more calls waiting represents an alarming condition; and anywhere in between is acceptable. Three custom thresholds, UnderCapacity, AtCapacity, and OverCapacity, have been applied to the CallsWaiting statistic, which is a statistic that is monitored for ClientQueue. The custom thresholds are defined as follows: UnderCapacity
if Threshold.StatValue < 5 then Threshold.Result = true end if
AtCapacity
if Threshold.StatValue >= 5 and Threshold.StatValue < 10 then Threshold.Result = true end if
OverCapacity
if Threshold.StatValue >= 10 then Threshold.Result = true end if
A color action is assigned to each threshold to change the background color of a table cell holding the CallsWaiting statistic when CCPulse+ evaluates the
86
Reporting 8.0
Predefined Thresholds
threshold to be True. The UnderCapacity threshold triggers the SetGreen action. AtCapacity triggers the SetYellow action, and OverCapacity triggers the SetRed action. Now CCPulse+ users have a visual cue to quickly assess ClientQueue performance.
intended simply to indicate where to insert a value in the script. You must replace these numbers with ones suited to your environment. AgentLoggedIn This threshold script returns a True value when the agent is logged inthat is, when CCPulse+ receives the Logged In status from Stat Server.
if Threshold.StatValue = StatAction.SDNALoggedIn then Threshold.Result = true end if
After an agent logs in, his/her status almost immediately changes from Logged In to Ready or Not Ready, which holds a higher ranking. Hence, the threshold script above is rarely tripped even though an agent may be logged in for quite some time. For this reason, Genesys recommends that you revise your script to reflect the condition when agents have not logged out:
if Threshold.StatValue <> StatAction.SDNALoggedOut then Threshold.Result = true end if
AgentLoggedOut The threshold returns a True value when the agent is logged out.
if Threshold.StatValue = StatAction.SDNALoggedOut then Threshold.Result = true end if
CCPulse+Administrators Guide
87
Predefined Thresholds
Using the Hide action with this threshold removes the logged out agent from the Table view as well as the Tree view.
Note: This functionality does not apply to the Graph view.
CampaignActivated This threshold script returns a True value when the Campaign object has been activated.
if Threshold.StatValue = StatAction.SCMPAStatusActivated then Threshold.Result = true end if
Used with the Campaign object. CampaignDeactivated This threshold script returns a True value when the Campaign object has been deactivated.
if Threshold.StatValue = StatAction.SCMPAStatusDeactivated then Threshold.Result = true end if
Used with the Campaign object. ExactValue This threshold script returns a True value if the value of the statistic to which the threshold is applied equals the value you set. By default, the value is set to 3.
if Threshold.StatValue = 3 then Threshold.Result = true else Threshold.Result = false end if
ExactValueWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied equals the value you set. By default, this value is set to 3. If True, CCPulse+ executes the associated action a specified number of seconds later. By default, ActionDelay is set to 10.
if Threshold.StatValue = 3 then Threshold.ActionDelay = 10 Threshold.Result = true else Threshold.Result = false end if
88
Reporting 8.0
Predefined Thresholds
GreaterThanLimit This threshold script returns a True value if the value of the statistic to which the threshold is applied is greater than the value you set. By default, this value is set to 10.
if ( Threshold.StatValue > 10) then Threshold.Result = True else Threshold.Result = False end if
GreaterThanLimitWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied is greater than the value you set. By default, this value is set to 10. If True, CCPulse+ executes the associated action a specified number of seconds later. By default, ActionDelay is set to 10.
if Threshold.StatValue > 10 then Threshold.ActionDelay = 10 Threshold.Result = True else Threshold.Result = False end if
LessThanSpecifiedLimit This threshold script returns a True value if the value of the statistic to which the threshold is applied is less than the value you set. By default, this value is set to 777.
if (Threshold.StatValue < 777) then Threshold.Result = True else Threshold.Result = False end if
Used with the Calling List object. LessThanLimit This threshold script returns a True value if the value of the statistic to which the threshold is applied is less than the value you set. By default, this value is set to 10.
if ( Threshold.StatValue < 10 ) then Threshold.Result = True else Threshold.Result = False end if
CCPulse+Administrators Guide
89
Predefined Thresholds
LessThanLimitWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied is less than the value you set. By default, this value is set to 10. If True, CCPulse+ executes the associated action a specified number of seconds later. By default, ActionDelay is set to 10.
if Threshold.StatValue < 10 then Threshold.ActionDelay = 10 Threshold.Result = True else Threshold.Result = False end if
NotEqual This threshold script returns a True value if the value of the statistic to which the threshold is applied equals any nonnull value other than the value you set. By default, this value is set to 3.
if Threshold.StatValue <> 3 then Threshold.Result = true else Threshold.Result = false end if
NotEqualWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied equals any nonnull value other than the value you set. By default, this value is set to 3. If True, CCPulse+ executes the associated action a specified number of seconds later. By default, ActionDelay is set to 10.
if Threshold.StatValue <> 3 then Threshold.ActionDelay = 10 Threshold.Result = true else Threshold.Result = false end if
OutOfRange This threshold script returns a True value if the value of the statistic to which the threshold is applied lies outside the range of values between the values you set. By default, these values are set to 5 and 10.
90
Reporting 8.0
Predefined Thresholds
if Threshold.StatValue < 5 Or Threshold.StatValue > 10 then Threshold.Result = true else Threshold.Result = false end if
OutOfRangeWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied lies outside the range of values between the values you set. By default, these values are set to 5 and 10. If True, CCPulse+ executes the associated action a specified number of seconds later. By default, ActionDelay is set to 10.
if Threshold.StatValue < 5 Or Threshold.StatValue > 10 then Threshold.ActionDelay = 10 Threshold.Result = true else Threshold.Result = false end if
WithinRange This threshold script returns a True value if the value of the statistic to which the threshold is applied lies exclusively between the values you set. By default, these values are set to 5 and 10.
if Threshold.StatValue > 5 and Threshold.StatValue < 10 then Threshold.Result = true else Threshold.Result = false end if
WithinRangeOfValues This threshold script returns a True value if the value of the statistic to which the threshold is applied lies exclusively between the values you set. By default, these values are set to 50 and 1000.
if Threshold.StatValue > 50 and Threshold.StatValue < 1000 then Threshold.Result = true else Threshold.Result = false end if
WithinRangeWDuration This threshold script returns a True value if the value of the statistic to which the threshold is applied lies exclusively between the values you set. By default, these values are set to 5 and 10. If True, CCPulse+ executes the associated
CCPulse+Administrators Guide
91
Predefined Actions
Predefined Actions
Actions enable CCPulse+ to alert you when a particular condition has been met with respect to a statistics value. This section describes the following action scripts which are provided with each Genesys solution:
ActiveWebBrowser ExecuteProcess Hide
state WAVAudioAlert
SendE-MailWithCDO
PCSpeakerAudioAlert
This section provides the information that you need to customize the action scripts to meet your contact-center requirements. The scripts are identical for each Genesys solution and are stored in a file that is named actions.stg. Actions have little meaning outside the context of their associated thresholds. Therefore, review Predefined Thresholds on page 85 and see the Threshold/Action Association topic in the Reporting 8.0 CCPulse+ Help.
The following discussion assumes you are familiar with the VBScript programming language and with the CCPulse+ predefined objects described in Predefined Objects on page 80.
92
Reporting 8.0
Predefined Actions
ExecuteProcess The sample that is provided uses a COM component that is defined in the
GsSampleTE Objects.DLL file. The source code for this file is included in the
CCPulse+ installation package. For this script to work, you must compile it by using Visual Basic.
Note: This sample is provided as is for your reference. Although every
effort has been taken to ensure that this sample functions correctly, Genesys does not offer product support for it. To create the Genesys File System object (FSObject) and execute a script, use the following script:
Set FSObject = CreateObject("GsSampleTEObjects.GsActionFSObject") FSObject.Execute("C:\Program Files\Plus!\Microsoft Internet\iexplore.exe")
This example opens Microsoft Internet Explorer within Windows NT. Hide This action hides the object to which the actions associated threshold has been assigned on the Call Center Objects pane, in the Tree view, and in the Grid view (the row that contains the specified statistic). CCPulse+ hides the object when the conditions set for the associated threshold are True. The object remains hidden unless you configure a second threshold/action combination for the targeted statistic using an alternative threshold condition and the Show action.
CCPulseNotifier.Hide
CCPulse+Administrators Guide
93
Predefined Actions
PCSpeakerAudioAlert This action uses a COM component that is defined in the GsSampleTEObjects.DLL file. The source code for this file is included in the CCPulse+ installation package. For this script to work, you must compile it by using Visual Basic. To create the Genesys Sound object, use the following script:
Set SoundObject = CreateObject("GsSampleTEObjects.GsActionSoundObject") SoundObject.Beep
ResetColor This action sets to its default color the background color of the table cell that contains the targeted statistic.
CCPulseNotifier.ResetColor
SendE-MailWithCDO Preinstall Microsoft Outlook 98 or Microsoft Exchange Server version 5.5 to execute the following script.
Dim msgBody Dim thresholdInfo msgBody="A mail from the CCPulse+ threshold engine!"+vbNewLine thresholdInfo="StatValue:"+CStr(Threshold.StatValue)+vbNewLine+ "StatAlias:"+CStr(Threshold.StatAlias)+vbNewLine+ "CFGTenantDbid:"+CStr(Threshold.CFGTenantDbid)+vbNewLine+ "CFGDbid:"+CStr(Threshold.CFGDbid) + vbNewLine + "CFGObjectID:"+CStr(Threshold.CFGObjectID)+vbNewLine+ "CFGType:"+CStr(Threshold.CFGType)+vbNewLine SendMail "","",msgBody+thresholdInfo,"Alarm notification from CCPulse+" Sub SendMail(profile,recipient,message,subject) Dim objSession, objAddrEntry, oInbox, colMessages, oMessage, colRecipients, oRecipient Set objSession = CreateObject("MAPI.Session") objSession.Logon profile,"",True,False,0, False Set Set Set Set Set objAddrEntry = objSession.CurrentUser oInbox = objSession.Inbox colMessages = oInbox.Messages oMessage = colMessages.Add() colRecipients = oMessage.Recipients
94
Reporting 8.0
Predefined Actions
recipient
oMessage.Subject = subject oMessage.Text = msg oMessage.Send objSession.Logoff Set objSession = nothing End Sub
SetColor This action sets to whatever color you choosefor example, dark redthe background color of the table cell that contains the targeted statistic.
CCPulseNotifier.SetColor( Color.DarkRed )
You can modify this action script to use any of the CCPulse+ predefined colors, or you can specify a custom color in RGB formatfor example:
CCPulseNotifier.SetColor( RGB( 7, 77, 177 ) )
The available predefined colors are the following: Blue DarkGray DarkCyan
Green Red White Black Gray
Show This action displays or makes reappear the targeted object in the Call Center Objects pane, in the Tree view, and in the Graph view (the row that contains the specified statistic). The object remains visible unless you configure a second threshold/action combination for the targeted statistic by using an alternative threshold condition and the Hide action.
CCPulseNotifier.Show
state This action returns information about an agents state at a particular DN including when the status began, the agents ID, the login ID, and the status that occurs at the DN:
CCPulse+Administrators Guide
95
Predefined Actions
result.Text = GetAgentState(); function GetAgentState() { if(state.type != "AgentState") return "n/a"; var r = "(" + FormatDate(state.StartTime) + ") "; r += state.AgentID; r += " [Place: " + state.PlaceID; r += " Login: " + state.LoginID + "]"; r += ", Status: " + state.Status; r += "; DNs: "; for(var e = new Enumerator(state.DNs); !e.atEnd(); e.moveNext()) { r += GetDNState(e.item()); } return r; } function FormatDate(dateVal) { var dateObj = new Date(dateVal); return dateObj.getHours() + ":" + dateObj.getMinutes() + ":" + dateObj.getSeconds(); } function GetDNState(dn) { var r = "(" + FormatDate(dn.StartTime) + ") "; r += dn.DN; r += " [Switch: " + dn.SwitchID; r += ", Type: " + dn.DNType + "], Status: " + dn.Status; r += "; Actions: " for(var e = new Enumerator(dn.Actions); !e.atEnd(); e.moveNext()) { r += GetAction(e.item()) + " "; } return r; } function GetAction(a) { var r = "(" + FormatDate(a.StartTime) + ") "; r += a.Action; return r; }
WAVAudioAlert You can implement COM objects by using Visual Basic or C++. The sample that is provided uses a COM component that is defined in the GsSampleTEObjects.DLL file. The source code for this file is included in the
96
Reporting 8.0
Predefined Actions
CCPulse+ installation package. For this script to work, you must compile it by using Visual Basic.
Note: This sample is provided as is for your reference. Although every
effort has been taken to ensure that this sample functions correctly, Genesys does not offer product support for it. To create the Genesys Sound object, use the following script:
Set SoundObject = CreateObject("GsSampleTEObjects.GsActionSoundObject") CreateObject("GsSampleTEObjects.GsActionFSObject")
Specify the full path to a .WAV file in order to play itfor example:
SoundObject.PlaySoundFile (c:\winnt\media\tada.wav)
CCPulse+Administrators Guide
97
Predefined Actions
98
Reporting 8.0
Chapter
Determining Factors
Traffic between CCPulse+ and Stat Server is dependent on many factors, including: The speed of both computers. The number of requests and responses in the data stream. Network speedfor example, a network operating at 100 Mbits/second might yield poor performance.
The data stream is dependent on how fast your network operates. Obviously, a fast network prevents many traffic problems.
CCPulse+Administrators Guide
99
The number of monitored agents, agent groups, places, place groups, queues, groups of queues, routing points, and groups of routing points in the CCPulse+ workspace. CCPulse+ issues one current state request for each.
Moreover, if you request the extended current status for particular object, CCPulse+ requests current state information for the entire status tree of that object which includes subordinate objects. For the extended current status of an agent group, for example, CCPulse+ also receives the current state for all agents, places, DNs, and DN actions within that group. Thus, any formula measuring the number of requests is dependent on the content of a particular workspace and the objects for which you requested the extended current status.
Depending on which notification mode you define for each statistic, Stat Server might send no response, one response, or constant responses. In addition to these four notification modes, the user can request updates at any time by using the Peek Statistics feature. Refer to the Framework 8.0 Stat Server Users Guide for further information about statistics.
100
Reporting 8.0
Chapter
Troubleshooting
This chapter presents some scenarios that you might have to troubleshoot while using CCPulse+ and suggests possible solutions for each. If you are experiencing difficulties with your CCPulse+ application, browse the following list for the resolutions to some commonly encountered issues. If you continue to have problems after reviewing this chapter and verifying that your hardware is functioning properly and that your CCPulse+ configuration settings are correct, contact Genesys Technical Support. These issues are covered in this chapter: Agents Having Trouble Logging In, page 101 Wizards Are Disabled, page 102 Import/Export Utility Is Disabled, page 102 No DB Server Connection Error Message, page 103 Agents Missing from Call Center Objects Pane, page 103 General SQL Server Error Message, page 104 Agents Cannot Monitor Agent Activity, page 104 Sudden Stat Server Disconnection, page 104 Stat Server Missing from New Workspace, page 105 No Historical Associations Error Messages, page 105 Cannot Recover Workspace, page 105 Cant View Multi-Tenant Data, page 106
CCPulse+Administrators Guide
101
Chapter 9: Troubleshooting
102
Reporting 8.0
Chapter 9: Troubleshooting
CCPulse+Administrators Guide
103
Chapter 9: Troubleshooting
The most probable cause of this error message is that your Data Mart has not been upgraded to release 6.5 or later. To use 6.5 (or later) CCPulse+ templates, you must upgrade all Reporting components to release 6.5 or later. For more information, refer to the Reporting chapters of the Genesys Migration Guide or the Configuring Genesys Solution Reporting chapter of the Reporting 8.0 Deployment Guide.
Refer to Installing Real-Time Reporting in the Reporting 7.5 Deployment Guide for more information.
If the StatServer disconnected error message appears, click OK. When the Would you like to save your workspace? message appears, click one of the following:
Yes, to save your current workspace but not your data. No, to clear both workspace and data. Cancel, to save the data but not the workspace.
104
Reporting 8.0
Chapter 9: Troubleshooting
If you are trying to create a historical view, and you receive the error message in Figure 22, confirm that you have correctly configured your Data Mart database access point in the CCPulse+ Application object.
A workspace can become corrupt, for instance, if it was previously only partially saved as is the case when the related CCPulse+ process is killed
CCPulse+Administrators Guide
105
Chapter 9: Troubleshooting
during the save operation or given file system problems. For this reason, Genesys recommends that you periodically back up your storage (*.stg) files.
106
Reporting 8.0
Supplements
Reporting
Reporting 8.0 CCPulse+ Help, which describes how to navigate the CCPulse+ interface, operate the wizards, create templates and views, and associate actions to specific thresholds that you might set. The Reporting 8.0 Deployment Guide, which will help you configure, install, start, stop, and uninstall your Reporting environment. This guide also provides instructions for setting up CCPulse+ administrators and users. The Framework 8.0 Stat Server Users Guide, which will help you understand statistics configuration. The Reporting 8.0 Reference Manual, which provides general information about performance measurements, how Reporting behaves during time shifts, and how to set up custom reports for skills-based and partial-period reporting. The Reporting 8.0 Master Index, which will help you find where other related topics are documented.
Genesys
Genesys Technical Publications Glossary, which ships on the Genesys Documentation Library DVD and which provides a comprehensive list of the Genesys and computer-telephony integration (CTI) terminology and acronyms used in this document. Genesys Migration Guide, which ships on the Genesys Documentation Library DVD, and which provides documented migration strategies for Genesys product releases. Contact Genesys Technical Support for more information.
CCPulse+Administrators Guide
107
Release Notes and Product Advisories for this product, which are available on the Genesys Technical Support website at http://genesyslab.com/ support.
Information about supported hardware and third-party software is available on the Genesys Technical Support website in the following documents: Genesys Supported Operating Environment Reference Manual Genesys Supported Media Interfaces Reference Manual Genesys Interoperability Guide, which provides information on the compatibility of Genesys products with various Configuration Layer Environments; Interoperability of Reporting Templates and Solutions; and Gplus Adapters Interoperability. Genesys Database Sizing Estimator 8.0 Worksheets, which provides a range of expected database sizes for various Genesys products.
For additional system-wide planning tools and information, see the releasespecific listings of System Level Documents on the Genesys Technical Support website, accessible from the system level documents by release tab in the Knowledge Base Browse Documents Section. Genesys product documentation is available on the: Genesys Technical Support website at http://genesyslab.com/support. Genesys Documentation Library DVD, which you can order by e-mail from Genesys Order Management at [email protected].
108
Reporting 8.0
Document Conventions
Document Conventions
This document uses certain stylistic and typographical conventions introduced herethat serve as shorthands for particular kinds of information.
You will need this number when you are talking with Genesys Technical Support about this product.
Type Styles
Table 20 describes and illustrates the type conventions that are used in this document. Table 20: Type Styles
Type Style Used For Italic Document titles Emphasis Definitions of (or first references to) unfamiliar terms Mathematical variables Examples Please consult the Genesys Migration Guide for more information. Do not use this value for this option. A customary and usual practice is one that is widely accepted and used within a particular industry or profession.
Also used to indicate placeholder text within code samples or commands, in the special case The formula, x +1 = 7 where angle brackets are a required part of the where x stands for . . . syntax (see the note about angle brackets on page 110).
CCPulse+Administrators Guide
109
Document Conventions
Examples
All programming identifiers and GUI elements. Select the Show variables on screen check box. This convention includes: The names of directories, files, folders, configuration objects, paths, scripts, dialog boxes, options, fields, text and list boxes, operational modes, all buttons (including radio buttons), check boxes, commands, tabs, CTI events, and error messages. The values of options. Logical arguments and command syntax. In the Operand text box, enter your formula. Click OK to exit the Properties dialog box. T-Server distributes the error messages in
EventError events.
If you select true for the inbound-bsnscalls option, all established inbound Code samples. calls on a local agent are considered Also used for any text that users must manually business calls. enter during a configuration or installation Enter exit on the command line. procedure, or on a command line. Square A particular parameter or value that is optional smcp_server -host [/flags] brackets ([ ]) within a logical argument, a command, or some programming syntax. That is, the presence of the parameter or value is not required to resolve the argument, command, or block of code. The user decides whether to include this optional information. Angle brackets (< >) A placeholder for a value that the user must specify. This might be a DN or a port number specific to your enterprise. Note: In some cases, angle brackets are required characters in code syntax (for example, in XML schemas). In these cases, italic text is used for placeholder values.
smcp_server -host <confighost>
110
Reporting 8.0
Index
Symbols
[] (square brackets). . . . . . . . . . . . . . 110 < > (angle brackets) . . . . . . . . . . . . . 110 ActivateWebBrowser action . . . . . . . . . . 93 agent group capacity calculation. . . . . . . . . . . . . . . . . . 47 performance . . . . . . . . . . . . . . . . 47 agent login troubleshooting problems . . . . . . . . . 101 AgentGroupID property . . . . . . . . . . . . 71 AgentID property. . . . . . . . . . . . . . . . 70 AgentLoggedIn threshold . . . . . . . . . . . 87 AgentLoggedOut threshold . . . . . . . . . . 87 AgentStats customizing in Registry . . . . . . . . . . . 52 angle brackets . . . . . . . . . . . . . . . . 110 audience . . . . . . . . . . . . . . . . . . . . 8
A
Action object properties Action . . . . . . . . . . . . . . . . . . . . 74 StartTime . . . . . . . . . . . . . . . . . . 74 type . . . . . . . . . . . . . . . . . . . . . 74 Action property . . . . . . . . . . . . . . . . 74 ActionDelay object in threshold scripts . . . . . . . . . . . . . 80 actions ActivateWebBrowser . . . . . . . . . . . . 93 CCPulseNotifier in . . . . . . . . . . . . . . 82 CFGDbid object . . . . . . . . . . . . . . . 81 CFGObjectID object . . . . . . . . . . . . . 81 CFGTenantDbid object . . . . . . . . . . . 81 CFGType object . . . . . . . . . . . . . . . 82 color enumeration objects . . . . . . . . . . 83 configuration objects . . . . . . . . . . . . 81 example . . . . . . . . . . . . . . . . . . . 92 ExecuteProcess . . . . . . . . . . . . . . . 93 explanation of predefined actions . . . . . . 93 Hide . . . . . . . . . . . . . . . . . . . . . 93 Hide object . . . . . . . . . . . . . . . . . 82 PCSpeakerAudioAlert . . . . . . . . . . . . 94 ResetColor . . . . . . . . . . . . . . . . . 94 ResetColor object . . . . . . . . . . . . . . 82 SendE-MailWithCDO . . . . . . . . . . . . 94 SetColor . . . . . . . . . . . . . . . . . . . 95 SetColor object . . . . . . . . . . . . . . . 82 Show . . . . . . . . . . . . . . . . . . . . 95 Show object . . . . . . . . . . . . . . . . . 82 using with thresholds . . . . . . . . . . . . 92 WAVAudioAlert . . . . . . . . . . . . . . . 96 Actions property . . . . . . . . . . . . . . . 73 ActionsStorageFullPath configuration option . . . . . . . . . 36
B
basic statistics icon . . . . . . . . . . . . . . . . . . . . . 67 in formulas . . . . . . . . . . . . . . . . . 68 BinActionsStorageFullPath configuration option . . . . . . . . . . 37 BinTemplatesStorage FullPath configuration option . . . . . . . . . . 37 BinThresholdsStorageFullPath configuration option . . . . . . . . . . 37 BinWorkspacesStorageFullPath configuration option . . . . . . . . . . 37 brackets angle . . . . . . . . . . . . . . . . . . . 110 square. . . . . . . . . . . . . . . . . . . 110
C
CampaignActivated threshold . . . . . . . . . 88 CampaignDeactivated threshold. . . . . . . . 88 Capacities property . . . . . . . . . . . . . . 71 CurrentInteractions . . . . . . . . . . . . . 72 MaxInteractions . . . . . . . . . . . . . . . 72 MediaType . . . . . . . . . . . . . . . . . 72
CCPulse+Administrators Guide
111
Index
RoutableInteractions . . . . . . . . . . . . 72 capacity format display . . . . . . . . . . . . . . . . . . . . 76 predefined . . . . . . . . . . . . . . . . . . 76 user-defined . . . . . . . . . . . . . . . . . 76 CCPulse+ installing silently . . . . . . . . . . . . . . . 17 server connections . . . . . . . . . . . . . 59 using composite metrics. . . . . . . . . . . 56 CCPulse+ Overview . . . . . . . . . . . . . 13 CCPulse+ status bar . . . . . . . . . . . .60, 62 CCPulseNotifier predefined object . . . . . . . . . . . . . . 82 CFGDbid object in action scripts . . . . . . . . . . . . . . . 81 CFGObjectID object in action scripts . . . . . . . . . . . . . . . 81 CFGTenantDbid object in action scripts . . . . . . . . . . . . . . . 81 CFGType object in action scripts . . . . . . . . . . . . . . . 82 colors RGB color codes . . . . . . . . . . . . . . 83 column names in templates . . . . . . . . . . . . . . . . . 56 linking objects using . . . . . . . . . . . . . 56 Common and Security section . . . . . . . . 24 composite metrics . . . . . . . . . . . . . . 56 configuration objects in action scripts . . . . . . . . . . . . . . . 81 configuration options ActionsStorageFullPath . . . . . . . . . . . 36 BinActionsStorageFullPath . . . . . . . . . 37 BinTemplatesStorageFullPath . . . . . . . . 37 BinThresholdsStorageFullPath . . . . . . . 37 BinWorkspacesStorageFullPath. . . . . . . 37 CurrentStateEnable . . . . . . . . . . . . . 44 CurrentStateRefreshInterval. . . . . . . . . 42 DefaultStorageType . . . . . . . . . . . . . 36 DelayBeforeRemoval . . . . . . . . . . . . 42 DisableAgentCurrentState. . . . . . . . . . 45 DisableCreateRemoveViews . . . . . . . . 43 DisableHideShowActionsOnGraph . . . . . 43 DisableRowColVisibilityChange . . . . . . . 43 DisableThresholdsDlg . . . . . . . . . . 39, 46 EnableAgentCapacity . . . . . . . . . . . . 46 EnableAgentCapacityStatus. . . . . . . 29, 46 EnableAgentGroupCapacity. . . . . . . . . 47 EnableDNAliases . . . . . . . . . . . . . . 39 enable-ipv6 . . . . . . . . . . . . . . . . . 24 EnableXMLExport . . . . . . . . . . . . . . 39 ExtendedCurrentStatus . . . . . . . . . . . 27 FirstDayOfWeek . . . . . . . . . . . . . . . 28 IgnoreNewObjectNotifications . . . . . . . . 47 inactivity-timeout. . . . . . . . . . . . . . . 24 local-options . . . . . . . . . . . . . . . . . 15 MaxNumberOfAgents . . . . . . . . . . . . 44 MediaTypes . . . . . . . . . . . . . . . 27, 76
112
MinDayNumberInFirstWeek. . . . . . . . . 29 NoAggregationInterval . . . . . . . . . . . 29 SafeScriptingMode . . . . . . . . . . . . . 48 ShowAgentLoginID . . . . . . . . . . . . . 40 ShowAgentSkills . . . . . . . . . . . . . . 40 ShowDurationBeforeStatusName. . . . . . 40 ShowStatusReasons . . . . . . . . . . . . 41 TemplatesStorageFullPath . . . . . . . . . 36 ThresholdsStorageFullPath . . . . . . . . . 36 TimeZone . . . . . . . . . . . . . . . . . . 29 UseStatServerVirtualGroups . . . . . . . . 48 WholeWeeks . . . . . . . . . . . . . . . . 29 WorkspaceAutoLoad . . . . . . . . . . . . 49 WorkspacesStorageFullPath . . . . . . . . 36 XMLActionsStorageFullPath . . . . . . . . 38 XMLTemplatesStorageFullPath . . . . . . . 38 XMLThresholdsStorageFullPath . . . . . . 38 XMLWorkspacesStorageFullPath . . . . . . 38 connection failures Configuration Server . . . . . . . . . . . . 60 Stat Server . . . . . . . . . . . . . . . . . 62 connections Data Mart . . . . . . . . . . . . . . . . . . 55 conventions in document . . . . . . . . . . . . . . . . 109 type styles. . . . . . . . . . . . . . . . . 109 current status determining . . . . . . . . . . . . . . . . . 70 CurrentAgentTargetState statistic . . . . . . . 77 CurrentInteractions capacity item . . . . . . . 72 CurrentStateEnable configuration option . . . . . . . . . . . . . . . . . 44 CurrentStateRefreshInterval configuration option . . . . . . . . . . 42 CurrentTargetState statistical category . . . . 77 custom statistics . . . . . . . . . . . . . . . . 70 determining current status . . . . . . . . . 70 formatting return values . . . . . . . . . . . 76 icon . . . . . . . . . . . . . . . . . . . . . 67 customizing AgentStats . . . . . . . . . . . . . . . . . 52 DeltaAvgTime . . . . . . . . . . . . . . . . 52 DeltaCntCalls . . . . . . . . . . . . . . . . 52 DeltaTotalTime . . . . . . . . . . . . . . . 53 FormatAgentInfo . . . . . . . . . . . . . . 53 HistoricalUpdateFrequency . . . . . . . . . 53 IntervalForCurrentUpdate . . . . . . . . . . 54 NotifyEvery . . . . . . . . . . . . . . . . . 54 Windows Registry settings . . . . . . . . . 50 CustomStatistic section . . . . . . . . . . . . 27
D
Data Mart using with CCPulse+ . . . . . . . . . . . . 55 Data Mart connections . . . . . . . . . . . . . 55
Reporting 8.0
Index
DB Server troubleshooting connection problems with . . . . . . . . . . . . . . 103 DefaultStorageType configuration option . . . . . . . . . . . . . . . . 36 DelayBeforeRemoval configuration option . . . . . . . . . . . . . . . . 42 DeltaAvgTime customizing in Registry . . . . . . . . . . . 52 DeltaCntCalls customizing in Registry . . . . . . . . . . . 52 DeltaTotalTime customizing in Registry . . . . . . . . . . . 53 DisableAgentCurrentState configuration option . . . . . . . . . 45 DisableCreateRemoveViews configuration option . . . . . . . . . 43 DisableHideShowActionsOnGraph configuration option . . . . . . . . . 43 DisableRowColVisibilityChange configuration option . . . . . . . . . 43 DisableThresholdsDlg configuration option . . . . . . . .39, 46 displaying agents troubleshooting problems with. . . . . . . 103 DN aliases in CCPulse+ displays . . . . . . . . . . . . 39 DN numbers in CCPulse+ displays . . . . . . . . . . . . 39 DN object properties . . . . . . . . . . . . . 73 Actions. . . . . . . . . . . . . . . . . . . . 73 DN . . . . . . . . . . . . . . . . . . . . . . 73 DNType . . . . . . . . . . . . . . . . . . . 73 StartTime . . . . . . . . . . . . . . . . . . 73 Status . . . . . . . . . . . . . . . . . . . . 73 SwitchID . . . . . . . . . . . . . . . . . . . 73 type . . . . . . . . . . . . . . . . . . . . . 73 DN property . . . . . . . . . . . . . . . . . 73 DNs property . . . . . . . . . . . . . . . . . 71 DNType property . . . . . . . . . . . . . . . 73 document conventions . . . . . . . . . . . . . . . . 109 version number . . . . . . . . . . . . . . 109
error messages General SQL Server error . . . . . . . . 104 No connection to specified DB server.... . 103 No data available for review... . . . . . . 105 No historical associations... . . . . . . . . 105 ExactValue threshold . . . . . . . . . . . . . 88 ExactValueWDuration threshold . . . . . . . . 88 examples response file . . . . . . . . . . . . . . . . 18 silent install log file . . . . . . . . . . . . . 21 ExecuteProcess action . . . . . . . . . . . . 93 ExtendedCurrentStatus configuration option . . . . . . . . . . 27
F
FirstDayOfWeek configuration option . . . . . 28 font styles italic . . . . . . . . . . . . . . . . . . . . 109 monospace . . . . . . . . . . . . . . . . 110 for referencing basic statistics . . . . . . . . . 68 FormatAgentInfo customizing in Registry . . . . . . . . . . . 53
G
GreaterThanLimit threshold . . . . . . . . . . 89 GreaterThanLimitWDuration threshold . . . . 89
H
Hide action . . . . . . . . . . . . . . . . . . . 93 Hide object in action scripts . . . . . . . . . . . . . . . 82 historical associations for custom statistics . . . . . . . . . . . . . 57 troubleshooting problems with . . . . . . 105 historical reporting considerations associations for statistics . . . . . . . . . . 57 column names . . . . . . . . . . . . . . . 56 composite metrics. . . . . . . . . . . . . . 56 Data Mart . . . . . . . . . . . . . . . . . . 55 using the last_N_intervals parameter . . . . 57 Historical View section . . . . . . . . . . . . . 28 HistoricalUpdateFrequency customizing in Registry . . . . . . . . . . . 53
E
EnableAgentCapacity configuration option . . . . . . . . . . . . . EnableAgentCapacityStatus configuration option . . . . . . EnableAgentGroupCapacity configuration option . . . . . . EnableDNAliases configuration option . enable-ipv6 configuration option . . . . EnableXMLExport configuration option . . . 46 . .29, 46 . . . . . . . . . . . . 47 39 24 39
I
IgnoreNewObjectNotifications configuration option . . . . . . . . . . 47 Import/Export Utility troubleshooting problems . . . . . . . . . 102 inactivity-timeout configuration option . . . . . 24
CCPulse+Administrators Guide
113
Index
installing CCPulse+ silently . . . . . . . . . . . . . . 17 InstallShield Silent . . . . . . . . . . . . . . 17 IntervalForCurrentUpdate customizing in Registry . . . . . . . . . . . 54 italics . . . . . . . . . . . . . . . . . . . . . 109
P
PCSpeakerAudioAlert action . . . . . . . . . 94 persistent connection . . . . . . . . . . . . . 60 PlaceID property . . . . . . . . . . . . . . . . 70 predefined format string . . . . . . . . . . 76, 78 predefined objects in formulas . . . . . . . . . . . . . . . . . 70 Predefined Statistics window . . . . . . . . . 67
J
JScript language . . . . . . . . . . . . . . . 68
L
last_N_intervals using this parameter. . . . . . . . . . . . . 57 LessThanLimit threshold . . . . . . . . . . . 89 LessThanLimitWDuration threshold . . . . . 90 LessThanSpecifiedLimit threshold . . . . . . 89 local-options configuration option . . . . . . 15 log file for silent installation . . . . . . . . . . . . . 20 sample for silent install . . . . . . . . . . . 21 silent install result codes . . . . . . . . . . 20 Login ID property . . . . . . . . . . . . . . . 70
R
ResetColor action . . . . . . . . . . . . . . . 94 ResetColor object in action scripts . . . . . . . . . . . . . . . 82 response file for silent installation . . . . . . . . . . . . . 18 playing back. . . . . . . . . . . . . . . . . 18 sample . . . . . . . . . . . . . . . . . . . 18 Result object in threshold scripts . . . . . . . . . . . . . 80 return values formatting . . . . . . . . . . . . . . . . . . 76 RoutableInteractions capacity item . . . . . . 72
M
MaxInteractions capacities item . . . . . . . 72 MaxNumberOfAgents configuration option . . . . . . . . . . . . . . . . 44 MediaType capacity item . . . . . . . . . . . 72 MediaTypes configuration option. . . . . .27, 76 metrics using composite . . . . . . . . . . . . . . . 56 MinDayNumberInFirstWeek configuration option . . . . . . . . . 29 monitoring agent activity troubleshooting problems . . . . . . . . . 104 monospace font . . . . . . . . . . . . . . . 110
S
SafeScriptingMode configuration option . . . . 48 sections Common and Security . . . . . . . . . . . 24 CustomStatistic . . . . . . . . . . . . . . . 27 Historical View . . . . . . . . . . . . . . . 28 Storage . . . . . . . . . . . . . . . . . . . 35 UserInterface . . . . . . . . . . . . . . . . 39 View . . . . . . . . . . . . . . . . . . . . . 42 Workspace . . . . . . . . . . . . . . . . . 44 SendE-MailWithCDO action . . . . . . . . . . 94 servers disconnecting from CCPulse+ . . . . . . . 59 SetColor action . . . . . . . . . . . . . . . . 95 SetColor object in action scripts . . . . . . . . . . . . . . . 82 Show action . . . . . . . . . . . . . . . . . . 95 Show object in action scripts . . . . . . . . . . . . . . . 82 ShowAgentLoginID configuration option . . . . . . . . . . . . . . . . . 40 ShowAgentSkills configuration option . . . . . 40 ShowDurationBeforeStatusName configuration option . . . . . . . . . . 40 ShowStatusReasons configuration option . . . . . . . . . . . . . . . . . 41 silent installation command line parameters . . . . . . . . . 18 defined . . . . . . . . . . . . . . . . . . . 17
N
NoAggregationInterval configuration option . . . . . . . . . . . . . . . . 29 NotEqual threshold . . . . . . . . . . . . . . 90 NotEqualWDuration threshold . . . . . . . . 90 NotifyEvery customizing in Registry . . . . . . . . . . . 54
O
OutOfRange threshold . . . . . . . . . . . . 90 OutOfRangeWDuration threshold . . . . . . 91
114
Reporting 8.0
Index
log file . . . . . . . . . . . . . . . . . . . . 20 log file result codes . . . . . . . . . . . . . 20 performing remotely . . . . . . . . . . . . . 20 response file . . . . . . . . . . . . . . . . . 18 SQL Server troubleshooting problems with. . . . . . . 104 square brackets . . . . . . . . . . . . . . . 110 StartTime property . . . . . . . . . 70, 71, 73, 74 Stat Server troubleshooting connection problems . . . 105 troubleshooting sudden disconnect . . . . 104 StatAction object . . . . . . . . . . . . . . . 84 StatAlias object in threshold scripts . . . . . . . . . . . . . 80 state object properties AgentGroupID . . . . . . . . . . . . . . . . 71 AgentID . . . . . . . . . . . . . . . . . . . 70 Capacities . . . . . . . . . . . . . . . . . . 71 DNs . . . . . . . . . . . . . . . . . . . . . 71 LoginID . . . . . . . . . . . . . . . . . . . 70 PlaceID . . . . . . . . . . . . . . . . . . . 70 StartTime . . . . . . . . . . . . . . . . 70, 71 Status . . . . . . . . . . . . . . . . . . . . 70 type . . . . . . . . . . . . . . . . . . . 70, 71 state predefined object . . . . . . . . . . . . 74 statistics historical associations for custom . . . . . . 57 StatReasons object in threshold scripts . . . . . . . . . . . . . 81 Status property . . . . . . . . . . . . . . .70, 73 StatValue object in threshold scripts . . . . . . . . . . . . . 80 Storage section. . . . . . . . . . . . . . . . 35 storage section customizing location of . . . . . . . . . . . 35 storages customizing location of . . . . . . . . . . . 35 SwitchID property . . . . . . . . . . . . . . 73 syntax . . . . . . . . . . . . . . . . . . . . 68
GreaterThanLimitWDuration . . . . . . . . 89 LessThanLimit . . . . . . . . . . . . . . . 89 LessThanLimitWDuration . . . . . . . . . . 90 LessThanSpecifiedLimit . . . . . . . . . . 89 NotEqual . . . . . . . . . . . . . . . . . . 90 NotEqualWDuration . . . . . . . . . . . . . 90 OutOfRange . . . . . . . . . . . . . . . . 90 OutOfRangeWDuration . . . . . . . . . . . 91 predefined explained . . . . . . . . . . . . 87 Result object . . . . . . . . . . . . . . . . 80 StatAction objects. . . . . . . . . . . . . . 84 StatAlias object . . . . . . . . . . . . . . . 80 StatReasons object . . . . . . . . . . . . . 81 StatValue object. . . . . . . . . . . . . . . 80 using with actions . . . . . . . . . . . . . . 85 WithinRange . . . . . . . . . . . . . . . . 91 WithinRangeOfValues. . . . . . . . . . . . 91 WithinRangeWDuration . . . . . . . . . . . 91 ThresholdsStorageFullPath configuration option . . . . . . . . . . 36 TimeZone configuration option . . . . . . . . 29 troubleshooting agent login issues . . . . . . . . . . . . . 101 agent missing from displays . . . . . . . 103 general SQL server error . . . . . . . . . 104 Import/Export Utility disabled . . . . . . . 102 missing Stat Server . . . . . . . . . . . . 105 monitoring agent activity . . . . . . . . . 104 no DB Server connection . . . . . . . . . 103 no historical associations . . . . . . . . . 105 Stat Server disconnect . . . . . . . . . . 104 wizards disabled . . . . . . . . . . . . . 102 type property . . . . . . . . . . . . 70, 71, 73, 74 type styles conventions . . . . . . . . . . . . . . . . 109 italic . . . . . . . . . . . . . . . . . . . . 109 monospace . . . . . . . . . . . . . . . . 110 typographical styles . . . . . . . . . . . . . 109
T
templates column names in . . . . . . . . . . . . . . 56 TemplatesStorageFullPath configuration option . . . . . . . . . 36 thresholds ActionDelay object. . . . . . . . . . . . . . 80 AgentLoggedIn . . . . . . . . . . . . . . . 87 AgentLoggedOut . . . . . . . . . . . . . . 87 CampaignActivated . . . . . . . . . . . . . 88 CampaignDeactivated . . . . . . . . . . . . 88 ExactValue . . . . . . . . . . . . . . . . . 88 ExactValueWDuration . . . . . . . . . . . . 88 example . . . . . . . . . . . . . . . . . . . 86 GreaterThanLimit . . . . . . . . . . . . . . 89
U
user-defined format string . . . . . . . . . 76, 77 UserInterface section . . . . . . . . . . . . . 39 UseStatServerVirtualGroups configuration option . . . . . . . . . . 48
V
version numbering, document . . . . . . . . 109 View section . . . . . . . . . . . . . . . . . . 42
W
WAVAudioAlert action . . . . . . . . . . . . . 96
CCPulse+Administrators Guide
115
Index
WholeWeeks configuration option . . . . . . 29 Windows Registry customizing settings in . . . . . . . . . . . 50 root path . . . . . . . . . . . . . . . . . . . 51 WithinRange threshold . . . . . . . . . . . . 91 WithinRangeOfValues threshold . . . . . . . 91 WithinRangeWDuration threshold . . . . . . 91 wizards troubleshooting problems with. . . . . . . 102 Workspace section . . . . . . . . . . . . . . 44 WorkspaceAutoLoad configuration option . . . . . . . . . . . . . . . . 49 WorkspacesStorageFullPath configuration option . . . . . . . . . 36
X
XMLActionsStorageFullPath configuration option . . . XMLTemplatesStorageFullPath configuration option . . . XMLThresholdsStorageFullPath configuration option . . . XMLWorkspacesStorageFullPath configuration option . . . . . . . . . 38 . . . . . . 38 . . . . . . 38 . . . . . . 38
116
Reporting 8.0