Is a java-based application designed to queue and distribute calls for call centers with workgroups located in different geographic locations or across multiple maxcs acm systems (44 pages)
Summary of Contents for Altigen Call Detail Reporting
Page 1
Voice w w w. a l t i g e n . c o m Internet 12-4.5 Shaping the Future of Converged Communications...
Page 2
Call Detail Reporting for AltiWare Open Edition (OE) Release 4.5 Manual Revised 02/2002 4403-0012-4.5...
Page 3
This is a criminal offense. Currently, we do not know of any telecommunications system that is immune to this type of criminal activity. AltiGen Communications, Inc. will not accept liability for any damages, including long distance charges, which result from unauthorized and/or unlawful use.
How Long the Warranty Is Effective All AltiGen Communications products are warranted for one (1) year for all parts from the date of the first end user purchase. Whom the Warranty Protects This warranty is valid only for the first end user purchaser.
Page 7
AltiGen website at http://www.altigen.com/ partner/product.htm, to 510-252-9738, attention to Customer Service. AltiGen reserves the right to refuse return of any material that does not have an RMA number. The RMA number should be clearly marked on the outside of the box in which the material is being returned.
Page 8
Sales Outside the U.S.A. For AltiGen Communications products sold outside of the U.S.A., contact your AltiGen Communications dealer for warranty information and services. CDR Manual...
H A P T E R Using CDR Search CDR Search is a client application that lets you search a Call Detail Reporting database. You can install CDR Search on either the AltiServ server or on an administrator client desktop. CDR Search works only with AltiWare OE Release 4.5 and higher.
Statistics” on page 1.To log in as a workgroup supervisor, the option-pack license must be installed on the AltiServ server. For information on obtaining a license, contact your Authorized AltiGen dealer. Before you log in When you log in for the first time, you need to know either the IP address or the name of the server you’ll be linking to.
Page 12
Using CDR Search Logging in - Administrator login From the Windows Start menu, select Programs > CDR Search > CDR Search 4.5. The Login window appears. Figure 1. Login window Enter the IP address or name of the AltiServ server. Enter your Extension and Password.
Page 13
Logging In Click OK to open the User Mode window. Figure 2. User Mode window Select Administrator login and click OK. Logging in - Workgroup supervisor login From the Windows Start menu, select Programs > CDR Search > CDR Search 4.5. The Login window appears. Figure 3.
Page 14
Using CDR Search Select the database containing the data you want to access. • Internal database—DBF database on the AltiServ server. • External database—SQL database set up to log call records. Note: This option is available only when the external logger service is installed on the SQL Server, and External CDR Logging is enabled.
Page 15
Logging In This will allow access to the workgroup CDR and workgroup statis- tics. If you enter an invalid password, the Password window reappears. A red X appears before the problem workgroup. Re-enter the password and click OK. For multiple workgroups: If you re-enter an invalid password for one workgroup, the CDR Search main window will open, but the workgroup will not appear in the Workgroup drop-down and thus will not be available as a search criterion.
Using CDR Search Running a Search The CDR Search main window has three tabs: CDR, WG CDR, and WG Statistics. Figure 7. CDR tab of the CDR Search main window CDR Search CDR Search lets you search all calls, internal and external. To perform this search, you must log in as the administrator.
Page 17
Logging In • All Calls—calls involving: Auto Attendant, Ring No Answer, Queue, Voice Mail (no VM recorded or VM recorded), Connect, Logon, Logoff, All Trunks Busy, No session, VM Access, Forward, Transfer, VM Notify, WG Abandoned, Park, System Park, Conference, Call Monitor, Transfer Cancel, Call Redirect, Call Pick Up, Dial Cancel •...
Page 18
Using CDR Search • Pat - retrieves records that contain the field value in any part of the extension/trunk digits. Example: “252” is the Callee value entered in the blank field. If exact is selected, any record with only “252” in the Callee field is retrieved. If like is selected with this value, any records where “252”...
Logging In Search results appear in the Summary window. Refer to “Search Results” on page 15 for details on working with search results. Workgroup CDR Search Workgroup CDR search lets you specify a search by workgroup. To perform this search, you can log in as the administrator or as a workgroup supervisor.
Page 20
Using CDR Search • All Calls—calls involving: Auto Attendant, Ring No Answer, Queue, Voice Mail (no VM recorded or VM recorded), Connect, Logon, Logoff, All Trunks Busy, No session, VM Access, Forward, Transfer, VM Notify, WG Abandoned, Park, System Park, Conference, Call Monitor, Transfer Cancel, Call Redirect, Call Pick Up, Dial Cancel •...
Page 21
Logging In (For example, when you search for Connected Calls, the time range as “Today,” and sorting by N/A, CDR will retrieve the total number of connected calls for “today.” Note: If the time range for the search is less than 1 day, and Date/Time is selected for Sort by, CDR will list records hourly.
Using CDR Search Workgroup Statistics Search Workgroup Statistics lets you search workgroup call data (rtmData.mdb records) captured from the real-time monitoring function in the Workgroup Statistics tab of the AltiSupervisor client. To perform this search, you can log in as the administrator or as a workgroup supervisor. Figure 9.
Page 23
Logging In Note: This selection is overridden by the interval setting in AltiAdmin. If your search results produce greater intervals than you specified, consult your system administrator. Select the type of search: • Workgroup Statistics—statistics on a specific workgroup • Agent Statistics per Workgroup—statistics on a specific agent for a specific workgroup •...
Using CDR Search Search Results The type of search you perform determines the type of results you see: Summary, which also enables drilldown to call Details and Records windows, or Statistics. All Results windows have the following buttons: • Export - exports selected calls to a csv file. Refer to “Exporting Records”...
Logging In • The Detail button opens the Detail window for a selected call. Refer to “Call Details” on page 16 for details. Call Details You can drill down for detailed information on call records. To see details on a call, select a record in the Summary window and click Detail.
Page 26
Using CDR Search Figure 12. The Record window (Call Info) Figure 13. The Record window (Advanced Call Info - trunk calls only) CDR Manual 17...
Logging In Statistics (WG Statistics) For Workgroup Statistics searches, the Statistics windows display the results of your search. There are different windows for the three types of WG Statistics searches you can perform. Figure 14. The Workgroup Statistics window Figure 15. The Agent Statistics per Workgroup window Figure 16.
Using CDR Search Exporting Records You can export records in csv format from the Statistics, Summary, Detail, and Record windows. To export records from the Statistics window: Click Export. Click OK to open the Save As dialog box. To export records from the Summary, Detail, and Record windows: Do one of the following: •...
H A P T E R CDR Overview AltiGen’s Call Detail Recording (CDR) solutions include data creating, recording, collecting, and reporting. While CDR can be used for individual and departmental billing, timecards, and market analysis, this manual places special emphasis on CDR’s use for call center applications. The data schema are designed to provide information for PBX, call center, billing, multi-tenant, and performance tracking information.
Page 31
Real-time Monitoring and the CDR Client Figure 1. AltiServ installation 22 CDR Manual...
Page 32
CDR Overview After installing AltiServ, the user configures rtmData.mdb using the Call Reports window in AltiAdmin. Figure 2. Call Reports window, System Configuration When RTM Data - MDB is selected, the Config button opens a dialog box where the user can enable and configure these records. CDR Manual 23...
Page 33
Real-time Monitoring and the CDR Client Figure 3. Configuring AltiDB for WG call data collection The Enable and Retain Records parameters are unchanged from the previous version of AltiWare, except that the lower limit for retaining records is now 1 day instead of 5 days. The Buffer Size settings are also gone.
Page 34
CDR Overview If Save is selected, Remove is disabled and AltiWare saves all data that overflows the Retain Records setting each day at midnight. Example: • Retain Records is set to 60 days • Save db is selected • Renew Backup is set to every month On day 61 a backup file is started in the DBBackup folder.
The CDR data schema has been redesigned and streamlined. If you have a reporting package using past versions of AltiGen’s CDR or SMDR, the reporting package vendor will have to rewrite the reporting program to work with the new schema.
Page 36
SMDR is a Mitel-defined data schema for delivering basic call information out the RS232 serial port to external recording and reporting applications. While AltiGen has provided an SMDR interface, it has had many problems in terms of accuracy and consistency of information delivery.
H A P T E R Data Storage CDR Search can store data using either an Internal Logger Service (ILS) or an External Logger Service (ELS). These two storage systems are described below. Internal Logger Service In AltiWare OE Release 4.5, call reporting distinguishes between call detail data, which records every call made to, out of, and within the AltiServ system, and RTM data, which is workgroup-related statistical data captured from the real-time monitoring function used in the AltiSupervisor...
OK to overwrite the ODBC32.dll. • System integrators or developers need to write custom query programs to extract data from the SQL server. AltiGen provides only the logging service. • If multiple AltiServ systems can send CDR records to a single common SQL server for call reporting or billing purposes, each AltiServ system need to have a different system ID.
Page 40
Data Storage To install the External Logger Service (ELS) program on the SQL server: Insert the AltiWare OE 4.5 CDROM into the target server CDROM drive. Using Windows Explorer (or similar mechanism), locate the External Logger Service directory and then find the setup file. Run setup.
Go to System Configuration > Call Reports and double-click “External CDR Log.” Enter the IP address of the SQL server and click on the Apply button. Select AltiGen External Server option and click on the Apply button. To verify SQL logging activity: Make several connected outbound calls.
Page 42
Data Storage For efficient CDR functions, follow recommended SQL database maintenance procedures. If there are over 100,000 records, searching can take a long time. If there are over 10,000 records, record deletion can take a long time and cannot be canceled. CDR Manual 33...
H A P T E R CDR and Workgroup CDR Search — Typical Searches This section contains examples of how to run various CDR and Workgroup CDR searches that are typically used by call centers. Identify the type of search you would like to perform, go to the CDR Search main window, define the search date, set the fields and settings as directed, then click the Search button to run the search.
Page 45
Example CDR Searches To run a search on: Use these fields and settings: All outgoing trunk calls for a Set Type to Connected Calls particular extension Set Caller to Extension, enter particular extension, select Exact Set Callee to Trunk All connected incoming trunk Set Type to Connected Calls calls for a particular extension Set Caller to Trunk...
Page 46
CDR and Workgroup CDR Search — Typical Searches Example CDR Searches To run a search on: Use these fields and settings: All internal calls to/from a Set Type to Connected Calls particular extension Set Caller to Extension, enter particular extension, select Exact Set Callee to Extension, enter particular extension, select Exact All trunks busy...
Page 47
Example Workgroup CDR Searches To run a search on: Use these fields and settings: All calls to workgroup Set Type to All Calls Enter Workgroup Number, select Both Set Sort By to N/A or Date/Time All calls to workgroup via Set Type to All Calls specific DNIS Enter Workgroup Number, select Both...
H A P T E R Records and Data Schema This section contains explanations of the CDR search results records, including the data schema and a Glossary of terms. Search Results This section explains the fields in all the CDR Search results windows. CDR Search and WG CDR Search Results Windows Summary Window Shown in “Summary (CDR Search and WG CDR Search)”...
Page 49
Search Results Detail Window Shown in “Call Details” on page 16 Field Definition Date Date of call Time Start time of call Duration Duration of call in seconds (EndTime minus StartTime; see Table 1, “CDR Call Format,” on page 56 for explanations of these schema) Wait Time AADuration plus VMDuration plus HoldDuration plus WaitDuration (see Table 1, “CDR Call Format,”...
Page 50
Records and Data Schema Record Window for “Call Info” Shown in “Call Details” on page 16 Node ID Server ID (System ID) assigned to an AltiServ system in AltiAdmin Session ID Session ID: a unique number, usually 9 digits or larger, assigned by AltiWare to a call Internal Call Internal or external call...
Page 51
Search Results Record Window for “Call Info” Shown in “Call Details” on page 16 Workgroup Workgroup number for an incoming call Number Outgoing Workgroup number for an outgoing call, as set in Workgroup AltiAdmin or by agent at logon DNIS DNIS number for incoming call Tenant Tenant name for trunk, as set in AltiAdmin...
Page 52
Records and Data Schema Record Window for “Call Info” Shown in “Call Details” on page 16 Record Duration Duration in seconds of NOVO recording Exit State State of call when it was disconnected (see Table 1, “CDR Call Format,” on page 56 for details) URL when “call”...
Page 53
Search Results Record Window for “Advanced Call Info” Shown in “Call Details” on page 16 Note: Advanced Call Info is available only for trunk calls. Duration Duration of call in seconds (End Time minus Start Time) Trunk Count Number of “Trunk” records for this call (always=1) Party Count Count of sets of “Party”...
Page 54
Records and Data Schema Record Window for “Advanced Call Info” Shown in “Call Details” on page 16 Note: Advanced Call Info is available only for trunk calls. Route1 Outcall Route Name, as set in AltiAdmin Route2 Outcall Route Name, as set in AltiAdmin PARTY Start Time...
Page 55
Search Results Record Window for “Advanced Call Info” Shown in “Call Details” on page 16 Note: Advanced Call Info is available only for trunk calls. Workgroup Number Workgroup number for an incoming call Outgoing Workgroup Workgroup number for an outgoing call, as set in AltiAdmin or by agent at logon Auto Attendant Name Auto Attendant Item Name, as set...
Page 56
Records and Data Schema Record Window for “Advanced Call Info” Shown in “Call Details” on page 16 Note: Advanced Call Info is available only for trunk calls. Talk Duration Duration in seconds from the time the call is answered by a person until it is disconnected (EndTime minus time when call was answered by human minus...
Page 57
Search Results Agent Statistics Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Calls Answered Count of calls that were answered by an agent; if a single call is routed to several agents, the counter is increased Calls Answered Sum of duration of Calls Answered, where Duration duration lasts from the time an agent answers the...
Page 58
Records and Data Schema Agent Statistics Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Total Calls Answered Total of Calls Answered Calls Transferred to Count of calls transferred to VM (by caller Voice Mail pressing # or by being automatically transferred to VM after RNA for every agent), where caller leaves a message Total Wrapup...
Page 59
Search Results Agent Statistics per Workgroup Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Upper half of window Number assigned by AltiWare to this record Date Date of call Time Time interval for these call statistics Calls Answered Count of calls that were answered by an agent;...
Page 60
Records and Data Schema Agent Statistics per Workgroup Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Login Time Time agent logged in to WG Logout Time Time agent logged out of WG Logout Reason Logout Reason Lower half of window (Totals, Averages, and Percentages) Total Calls Total of all calls, including Answered, Outgoing and Transferred to VM...
Page 61
Search Results Agent Statistics per Workgroup Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Average Talk Time Total Talk Time divided by (Total Calls Answered plus Total Outgoing Calls) Average Wrapup Time The average of Wrapup time after call (time that user enables “Allow Wrapup Time”...
Page 62
Records and Data Schema Workgroup Statistics Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Outgoing Calls Count of outgoing calls Outgoing Calls Sum of duration of Outgoing Calls, where Duration duration lasts from the time the call enters “Connected”...
Page 63
Search Results Workgroup Statistics Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Lower half of window (Totals, Averages, and Percentages) Total Calls Total of all calls, including Answered, Outgoing, Transferred to VM, and all Abandoned calls Total Calls in Queue Total of Calls in Queue Total Outgoing Calls Total of Outgoing Calls...
Page 64
Records and Data Schema Workgroup Statistics Window Shown in “Statistics (WG Statistics)” on page 18 Field Definition Total Wait Time for Total of Wait Time for Answered Calls Answered Calls Total Wait Time for Total of Wait Time for Abandoned Calls Abandoned Calls Average Talk Time Total Talk Time divided by (Total Calls...
Page 65
Search Results Data Schema This section describes the data schema used in CDR and RTM records. Table 1: CDR Call Format Database Definition Type Specification Element NodeID Server ID (System ID) ULONG value: 1–100 assigned to an AltiServ system in AltiAdmin SessionID Session ID: a unique...
Page 66
Records and Data Schema Table 1: CDR Call Format Database Definition Type Specification Element CallerType Type of line for an UBYTE 0=Unknown incoming call 1=Ext analog 2=Ext IP 3=Ext PHS (not used) 4=Ext virtual 5=Ext WG 11=trk analog 12=trk T1 13=trk IP 14=trk PRI 15=trk PHS (not...
Page 67
Search Results Table 1: CDR Call Format Database Definition Type Specification Element TargetType Type of line for an UBYTE 0=None outgoing call 1=Ext analog 2=Ext IP 3=Ext PHS (not used) 4=Ext virtual 5=Ext WG 11=trk analog 12=trk T1 13=trk IP 14=trk PRI 15=trk PHS (not used)
Page 68
Records and Data Schema Table 1: CDR Call Format Database Definition Type Specification Element Tenant Tenant name for trunk UCHAR (31) AccountCode Account code UCHAR 1—10 digits in (11) length AADuration Duration in seconds ULONG an incoming call is connected to the Auto Attendant;...
Page 69
Search Results Table 1: CDR Call Format Database Definition Type Specification Element ExitState State when call is ULONG (see boxed inset) terminated Specification [documented (HEX)] - [data output (Decimal)] - [exit state definition] “0x0001” - 1 - Auto Attendant “0x0002” - 2 - Ring No Answer “0x0003”...
Page 70
Records and Data Schema Table 1: CDR Call Format Database Definition Type Specification Element LogoffReason Logoff reason code UBYTE URL when “call” is UCHAR initiated by AltiWeb (255) user clicking the make-call button User Data Agent input UCHAR (255) Table 2: RTM Data Format Database Definition Type...
Page 71
Search Results Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field PeakQLength Maximum queue short length since midnight PeakWaitTimeI Maximum ULONG queued time since midnight QLength Number of calls short * Calls in Queue routed into the queue;...
Page 72
Records and Data Schema Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field NumOutCall All outgoing short * Outgoing trunk and Calls station-to-station calls that entered “Connected” state OutCallDuratio Duration of ULONG * Outgoing outgoing calls Calls Duration (NumOutCall);...
Page 73
Search Results Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field NumCallAband Total abandoned short oneBeforeAnsw calls (during C–A–B= VM, queue, and * Calls RNA) Abandoned during VM NumQueueOve Calls routed to short * Queue rflow the WG but not Overflow...
Page 74
Records and Data Schema Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field ServiceLevel Service Level number of calls in queue - X / # of calls in queue X = number of calls in queue exceeding threshold *ServiceLevel is...
Page 75
Search Results Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field NumInCall Calls answered; short * Calls if a call is Answered rerouted to and answered by the same agent, the count is incremented InCallDuration Duration of ULONG * Calls...
Page 76
Records and Data Schema Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field NumWrapUp Number of times short * Wrapup agent entered Wrapup, where Wrapup lasts from agent-set “Not Ready” to “Ready” status WrapUpDurati The amount of ULONG * Wrapup time for Wrapup,...
Page 77
Search Results Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field Time Time interval short hh:mm * Period AgentNum Agent extension UCHAR (8) number WGNum Workgroup UCHAR (8) number Login Log state UBYTE 0=Logout 1=Login LogTimeStamp Login/logout ULONG...
Page 78
Records and Data Schema Table 2: RTM Data Format Database Definition Type Specification/ Element * CDR Client Field NumOutCall All outgoing short * Outgoing trunk and Calls station-to-station calls that entered “Connected” state OutCallDuratio Duration of ULONG * Outgoing outgoing calls Calls Duration (NumOutCall);...
Search Results Glossary of Terms Abandonment - Incoming call where the caller decides to disconnect before completing a call processing state in the phone system: listening and handling auto attendant, while waiting in queue, or while in voice mail. (See also short calls.) Note: This is not the same as the Abandonment from Queue found in Center 4.0 real time screens.
Page 80
Records and Data Schema CallerID - The phone number of the calling party. CallerID differs from ANI in that CallerID is the phone number of the phone from which the caller is calling as opposed to the billing number for the phone. If a caller is calling from a business, the CallerID will be different from the ANI number, in most cases.
Page 81
Search Results Handled Calls - The number of calls actually processed successfully to a normal disconnect exit state. For example, answered by a person, or the person completed a voice message or listening to a prompt. Handled WG - The number of calls handled by a workgroup in the phone system. In WG Average Duration - The amount of time, on average, calls spent waiting for a free agent while in a queue.
Page 82
Records and Data Schema NodeID - The AltiServ system number (from 0–128) that was assigned to a given AltiServ system in AltiAdmin. The number is used to separate CDR records from different AltiServ systems when the records are collected jointly at one site using one database server for consolidated reporting.
Page 83
Search Results PRI - ISDN Primary trunks Queued Call - A call that has entered the queue as a result of not finding any free agents in a workgroup or for an extension and must now wait for an extension to become free.
Page 84
Score - This may or may not be found in the reports created within Call Analyst depending on applications created by the customer, not Call Analyst or AltiGen. Score is a number that represents how well a supervisor believes an agent has handled a particular call that the supervisor has silently monitored.
Page 85
Search Results Spillover - Overflow from one route table to the next. T1 - T1 is a digital facility from the phone system (customer premise) to the central office, or from one CPE site to another between AltiServ systems (T1 tie trunks). Voice is encoded as zeros and ones on a channel (i.e., conceptual trunk) using industry standard encoding.
Page 86
URL - If a caller enters AltiServ via the Internet using AltiGen’s AltiWeb software (Web Button) then this field will contain the URL address for the caller accessing the system.
Configuration Areas Affecting CDR Information WorkGroup - The workgroup is an extension representing a collection of individual extensions, such that each of these individual extensions can service a call arriving at the workgroup extension number. If none of these extensions is available at the time a call arrives, then the call is queued for this particular workgroup—a workgroup queue.
A system integrator is required to use AltiGen’s AltiX ActiveX control. Ring No Answer Configurations and VM Agents sign on to workgroups and answer calls. On occasion, an agent or extension might be signed on, but negligently walk away from their station.
Example Call Sequences and their Effect on CDR Records Example Call Sequences and their Effect on CDR Records One objective of the CDR record is to track the talk time of agents and individuals for incoming and outgoing calls. Many call sequences are possible.
Page 90
Records and Data Schema Figure 2. CDR record sessions for Example 1 Example 3 - External party calls office and gets Automated Attendant, then dials out Operator. The result is two sessions logged for this event. Figure 3. CDR record sessions for Example 3 CDR Manual 81...
Reporting Fields Glossary Reporting Fields Glossary CDR Timestamps and Dates The CDR data schema is provided with basic definitions. As with past OE releases, the StartTime, EndTime, and other timestamps in the OE 4.0 CDR database are in seconds and are offset numbers from a standard industry reference point of January 1, 1970 UTC.
Index Index Party1PAD 61 ring no answer 79 route name 78 address AltiGen Communications, Inc. 2 AltiGen Communications phone numbers 2 session ID number 56, 61 AltiGen Communications, Inc. sign-off 79 address 2 sign-on 79 SMDR 27 SQL 30 backup and restore 32...
Need help?
Do you have a question about the Call Detail Reporting and is the answer not in the manual?
Questions and answers