Download as docx, pdf, or txt
Download as docx, pdf, or txt
You are on page 1of 210

C•CURE 800/8000

Version 10.3

Reports Guide

REVISION H0

6 Technology Park Drive


Westford, MA 01886
http://www.swhouse.com
Fax: 978-577-4392 Phone: 978-577-4000
C•CURE and Software House are registered trademarks of Tyco International Ltd. and its
respective companies.

The trademarks, logos, and service marks displayed on this document are registered in the
United States [or other countries]. Any misuse of the trademarks is strictly prohibited and
Tyco International Ltd. will aggressively enforce its intellectual property rights to the fullest
extent of the law, including pursuit of criminal prosecution wherever necessary. All
trademarks not owned by Tyco International Ltd. are the property of their respective owners,
and are used with permission or allowed under applicable laws.

Product offerings and specifications are subject to change without notice. Actual products may
vary from photos. Not all products include all features. Availability varies by region; contact
your regional sales manager.

Software version: 10.3


Document Number: UM-115
Revision Number: H0
Release Date: July 2012

This manual is proprietary information of Software House. Unauthorized reproduction of any


portion of this manual is prohibited. The material in this manual is for information purposes
only. It is subject to change without notice. Software House assumes no responsibility for
incorrect information this manual may contain.

Copyright © 2012 Tyco International Ltd. and its respective companies.

All rights reserved.


Table of Contents

Preface
How to Use this Manual........................................................................................viii
Conventions Used in This Manual............................................................................x
Finding More Information.......................................................................................xi
Software House Customer Support Center............................................................xii

Chapter 1 Generating Security Reports


Overview................................................................................................................. 1-2
Using the Report Generation Dialog Box..............................................................1-4
Using Wildcard Search..........................................................................................1-5
Search Examples.............................................................................................................1-5
Selection Browser....................................................................................................1-5
apC Groups..............................................................................................................1-6
Personnel Query......................................................................................................1-6
Period.......................................................................................................................1-6
Viewing and Displaying Report Results in Microsoft Excel.................................1-7
Excel Spreadsheet Limitations.......................................................................................1-8
C•CURE 800/8000 Standard Reports..........................................................................1-9
Configuration Reports Overview.........................................................................1-13
User-Configurable Reports..................................................................................1-16
Viewing a Configuration Report..................................................................................1-21
Printing and Saving a Report.......................................................................................1-22
Opening a Report in Another Application...................................................................1-23
Creating a New Configuration Report.........................................................................1-25
Deleting a Configuration Report..................................................................................1-25
Renaming a Configuration Report...............................................................................1-26

C•CURE 800/8000 Reports Guide iii


Table of Contents

Non-Configurable Reports...................................................................................1-27
Personnel Reports............................................................................................... 1-30
User Privilege Reports.........................................................................................1-40
Users Report.................................................................................................................1-40
Administration Privilege Reports................................................................................1-43
Monitoring Privilege Reports.......................................................................................1-47
Miscellaneous Reports.........................................................................................1-50
Roll Call Reports..................................................................................................1-53
Configuring Roll Call Reports from the Administration Application........................1-54
Editing Roll Call Reports..............................................................................................1-55
Running Roll Call Reports............................................................................................1-57
Running Roll Call Reports for Selected Personnel.....................................................1-58
User Defined Reports..........................................................................................1-62
C•CURE Central Reports.....................................................................................1-64

Chapter 2 Journal Reporting


Overview................................................................................................................ 2-2
How the C•CURE 800/8000 Changes to a New Journal.............................................2-3
Journal Numbering........................................................................................................2-3
Audit Trail............................................................................................................. 2-4
Changes Which Are Not Audited..................................................................................2-4
Changes Not Audited at the Field Level...............................................................2-5
The Audit Trail Reporting Process................................................................................2-6
How Audit Trail Processes Deletions............................................................................2-6
How Audit Trail Displays Names..................................................................................2-6
Default Values for Objects in Full Field-level Auditing................................................2-7
Generating a Journal Report................................................................................2-8
Creating Activity Reports.....................................................................................2-15
Creating Audit Reports........................................................................................2-19
Creating Incident Reports...................................................................................2-25
Incident Tracking Overview........................................................................................2-25
Incident Groups....................................................................................................2-26
Event Incident......................................................................................................2-29

Table of Contents
Making Selections for Activity/Audit Reports....................................................2-33
Selecting Messages for an Activity Report..................................................................2-33
Selecting Security Objects for Activity and Audit Reports.........................................2-34
Selecting Personnel for Activity and Audit Reports...................................................2-39
Selecting Users for an Audit Report............................................................................2-41
Running a Journal Report..................................................................................2-43
NetVue Activity Messages...........................................................................................2-44
Viewing and Displaying Journal Replay Report Results in Microsoft Excel.............2-46
Viewing Journal Incident Reports..............................................................................2-46

Chapter 3 Configuring Enhanced Reporting


Overview................................................................................................................ 3-2
Definitions, Acronyms, and Abbreviations...................................................................3-2
Journal Export Service...................................................................................................3-3
Enhanced (Crystal Reports) Reporting Interface.........................................................3-4
Report Customization............................................................................................3-6
Creating a DSN for the Enhanced Reporting Database........................................3-7
Journal Export Overview.....................................................................................3-10
Journal Export Scheduling..........................................................................................3-10
How Selection Criteria are Applied..............................................................................3-11
Journal Export Service Operation...............................................................................3-12
Journal Export Database Schema.......................................................................3-14
Journal Export Database Tables..................................................................................3-15
Export Journal Database Users...................................................................................3-17
Journal Messages Structure.........................................................................................3-18
Configuring Journal Export in the Administration Application........................3-19
Running Enhanced Reports................................................................................3-29
Running Predefined Journal Reports.........................................................................3-30
Predefined Journal Report Parameters...............................................................3-32
Time and Attendance Report Parameters...........................................................3-35
Predefined Journal Report Descriptions.....................................................................3-37
Running Time and Attendance Reports in Microsoft Excel.......................................3-41
Running Customized Journal Reports........................................................................3-45
Viewing Predefined and Customized Journal Reports...............................................3-46
Journal and Audit Trail Messages that Support Enhanced Reporting......................3-47

Scheduling Reports to Run..........................................................................................3-48


Table of Contents
Starting the Windows Scheduler Service............................................................3-50

Appendix A Export Journal Message Structure


Table Field Name Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Export Journal Message Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

Appendix B Enhanced Reporting Maintenance


Using the Progress Administration Service for Journal Export . . . . . . . . . . . . . . B-
2 Re-initializing the C•CURE Journal Export Database. . . . . . . . . . . . . . . . . . . . . .
B-5
Initializing a Second C•CURE Journal Export Database. . . . . . . . . . . . . . . . . . . . . . . . B-6

Index
Preface

This C•CURE 800/8000 Reports Guide is for new and experienced security
system users. The manual describes the procedures for generating different
types of security reports; for running journal reports to obtain activity, audit,
and/or incident information; and for configuring and using enhanced
reporting.

In this preface
 How to Use this Manual............................................................................................viii
 Conventions Used in This Manual...............................................................................x
 Finding More Information..........................................................................................xi
 Software House Customer Support Center...............................................................xii
Preface

How to Use this Manual


This manual includes the following sections. Turn to the appropriate section
for the information you need.

Chapter 1, “Generating Security Reports”


This chapter describes how to generate several types of security reports:
 Configuration
 Personnel
 User Privileges
 Miscellaneous
 Roll Call
 User defined

Chapter 2, “Journal Reporting”


This chapter describes the C•CURE 800/8000 journal, which contains
activity and audit information, as well as procedures for generating the
following types of journal reports:
 Activity reports
 Audit reports
 Incident reports

Chapter 3, “Configuring Enhanced Reporting”


This chapter describes enhanced reporting and procedures to configure and
use it.

vii C•CURE 800/8000 Reports Guide


Appendix A, “Export Journal Message Structure”
This appendix provides details of the Export Journal Messages: the Journal
database naming suffixes and structure of the C•CURE 800/8000 journal
messages.

Appendix B, “Enhanced Reporting Maintenance”


This appendix describes procedures that can be used to maintain journal
export for enhanced reporting.
Conventions Used in This Manual
This manual uses the following text formats and symbols.

Convention Meaning
Bold This font indicates screen elements, and also indicates when you
should take a direct action in a procedure.
Bold font describes one of the following items:
 A command or character to type, or
 A button or option on the screen to press, or
 A key on your keyboard to press
 A screen element or name

blue color text Indicates a hyperlink to a URL, or a cross-reference to a figure,


table, or section in this guide.

Regular italic font Indicates a new term, or a book title.

<text> Indicates a variable.

The following items are used to indicate important information.

NOTE Indicates a note. Notes call attention to any item of information that may
be of special importance.

TIP Indicates an alternate method of performing a task.

Indicates a caution. A caution contains information essential to avoid


damage to the system. A caution can pertain to hardware or software.

Indicates a warning. A warning contains information that advises users


that failure to avoid a specific action could result in physical harm to the
user or to the hardware.

Indicates a danger. A danger contains information that users must know


to avoid death or serious injury.
Finding More Information
You can access C•CURE 800/8000 manuals and online Help for more
information about C•CURE 800/8000.

Manuals
The C•CURE 800/8000 documentation is located in English\Manuals
directory on the C•CURE 800/8000 DVD. The ONLINE.pdf document lists
the software and hardware guides.

You can access the PDF guides from the C•CURE 800/8000 Help menu
after you install C•CURE 800/8000 and copy the appropriate PDF files from
the C•CURE 800/8000 DVD. See the C•CURE 800/8000 Installation Guide for
more information.

The manuals are also available from the Software House Member Center.

To access the Software House Member Center, go to:


http://www.swhouse.com/TechnicalLibrary/TechLibSW.aspx.

Online Help
You can access C•CURE 800/8000 Help by pressing F1 or clicking Help from
the menu bar in the Administration/Monitoring Station application.
Preface

Software House Customer Support Center

Telephone Technical Support


During the period of the Agreement, the following guidelines apply:
 Software House accepts service calls only from employees of the
Systems Integrator of Record for the installation associated with the
support inquiry.

Before Calling
Ensure that you:
 Are the Dealer of record for this account.
 Are certified by Software House for this product.
 Have a valid license and current Software Support Agreement (SSA) for
the system.
 Have your system serial number available.
 Have your certification number available.

Hours Normal Support Hours Monday through Friday, 8:00 a.m. to 8:00 p.m., EST. Except holidays.

Emergency Support Hours 24 hours/day, seven days a week, 365 days/year.


Requires Enhanced SSA “7 x 24” Standby Telephone Support
(emergency) provided to Certified Technicians.
For all other customers, billable on time and materials basis.
Minimum charges apply – See MSRP.

Phone U.S. +1-800-392-2873


Puerto Rico
U.S. Virgin Islands

For other regions, see www.swhouse.com/support/contact_technical_support.aspx.

xii C•CURE 800/8000 Reports Guide


1

Generating Security Reports

C•CURE 800/8000 allows you to generate several different types of security


reports.

In this chapter
 Overview...........................................................................................................1-2
 Using the Report Generation Dialog Box..................................................................1-4
 Using Wildcard Search...............................................................................................1-5
 Viewing and Displaying Report Results in Microsoft Excel.....................................1-7
 Configuration Reports Overview.............................................................................1-13
 User-Configurable Reports......................................................................................1-16
 Non-Configurable Reports.......................................................................................1-27
 Personnel Reports....................................................................................................1-30
 User Privilege Reports.............................................................................................1-40
 Miscellaneous Reports.............................................................................................1-50
 Roll Call Reports......................................................................................................1-53
 User Defined Reports..............................................................................................1-62
 C•CURE Central Reports.........................................................................................1-64
Overview

Overview
You can generate the following types of reports with the C•CURE 800/8000:
 Configuration reports - contain information about the various security
objects (such as input, output, and holiday activity)
 Personnel reports - contain information about personnel and user
records including time and attendance
 User privilege reports - contain information about system users and
their privileges
 Miscellaneous reports - do not fall into any of the basic report
categories, but help you obtain basic system information
 Roll call reports - provide a list of all personnel that the system
determines to be in a user-specified area and are used for emergency
evacuations of buildings
 User-defined reports - let you create your own customized report
definitions
 C•CURE Central reports - contain information about C•CURE Central,
the browser-based central card administration system, and are available
if the C•CURE 800/8000 is a part of a C•CURE Central network.

This chapter describes reporting basics, such as using the Report Generation
dialog box and printing and saving a report. It also describes all the report
types listed above.

In a partitioned system, all reports respect the configured partitions. You can
run reports only on partitioned objects in your own partition and shared
partitions, unless you are a partition administrator. Partition Administrators
can run reports on objects in any partition(s) that they administer.

Example:
Neither Alicia nor Eduardo are partition administrators. If Alicia runs a
door report, her report shows doors only for her partition and shared
partitions. If Ed, who is in a different partition, runs a door report, his
report shows doors from his partition, which are different from Alicia’s
doors, and doors from shared partitions, which are the same for both Ed
and Alicia. See the C•CURE 800/8000 Software Configuration Guide for
more information.

1–2 C•CURE 800/8000 Reports Guide


NOTE If you have the C•CURE 800/8000 Asset Manager option installed, you
can generate asset reports.

The system also gives you the capability to generate the following:
 Journal Reports - contain activity information about the system, and/or
audit information about the C•CURE 800/8000 database, or activity
incident reports for Incident IDs for particular incident groups or
events—all described in Chapter 2.
 Enhanced reports - include both predefined and customized Crystal
Reports®, described in Chapter 3.
Using the Report Generation Dialog Box

Using the Report Generation Dialog Box


To generate any types of reports, use the Report Generation dialog box
Figure 1-2 on page 1-7.

To Access the Report Generation Dialog Box

1. Select Reports from the C•CURE 800/8000 Administration application


menu bar and then choose the appropriate command for the report that
you want to generate.

Figure 1-1: C•CURE 800/8000 Administration Application Reports Menu

2. You can report on a variety of security objects—both hardware and


software, on personnel, on user privilege, on miscellaneous items, and
on the historical journal.

1–4 C•CURE 800/8000 Reports Guide


Using Wildcard Search
The browsers and many of the dialog boxes contain a Wildcard search. A
Wildcard search can be used to search for personnel records and for object
names.

Enter the characters in the appropriate field(s) and use a Wildcard character
(*) to represent one more undefined characters in the character search string.

NOTE Wildcard searches work in character type fields only, they do not work in
integer type fields.

You can use up to ten Wildcard characters (*) in a search string.

NOTE In partitioned systems, the search function only searches the selected
partition.

Search Examples

Selection Browser
1. In the application menu bar: choose
Hardware>apC. The apC Selection browser opens.

2. In the Search box, enter off*bui*1

3. Click Search....
The Object List field shows results such as:
• officebuilding1
• officebuilding12
• officebuilding212
Using Wildcard Search

The search box has a default value of "*".

apC Groups
In a list of apC groups:
 Type p* to find all apC groups with names beginning with "p".
 Type *p to find all apC groups with names that end with "p".
 Type *p* to find all apC groups with "p" anywhere in their name.

Personnel Query
In the application menu bar:

1. Choose Personnel > Personnel Query.


The Personnel Query dialog box opens.
2. In the Last Name: field, enter Sm*

3. In the Customer tab, <Text1>; field (e.g. assume Text1 field is user-
renamed “Country”), enter *land
4. Click Do Query.
The Personnel Query browser dialog box opens, and the Result list box
shows results such as:
Table 1-1:

Name Card Country


Smith, John D. 012345 England

Smothers, Bonnie 345678 Scotland

Period
The search string for any period should include two ~~ in front. For example,
to search for *..* you need to input the following string: *~~.~~.*

1–6 C•CURE 800/8000 Reports Guide


Viewing and Displaying Report Results in Microsoft Excel
When you select the Display in Excel check box in the Report Generation
dialog box (see Figure 1-2) and click Run Report, the results are displayed in
Microsoft® Excel® . If you do not select the Display in Excel check box, results
are displayed in text format.

NOTE You must have Microsoft Excel installed on your system to view reports in
Excel.

NOTE This section does not include displaying Journey Replay results to
Microsoft Excel. See “Viewing and Displaying Journal Replay Report
Results in Microsoft Excel” on page 2-46.

Figure 1-2: Report Generation Dialog Box


Viewing and Displaying Report Results in Microsoft Excel

Excel Spreadsheet Limitations


The maximum numbers of rows per Excel worksheet is 262,144. If report is
longer than 262,144 rows (for example the Personnel Report can be very
large) a warning message appears and the first 262,144 rows are displayed.
In this event, you have the option to narrow query results or display larger
reports in text format.

If a capacity of the Excel control exceeds the capacity of a single sheet in the
installed Excel version, then you will be able to export a limited number of
rows.
Example
A single sheet in 2003 Excel can hold about 65,000 rows, so only
first 65,000 rows would be exported.

The Display in Excel option is not available for user-defined reports, Crystal
reports and the Roll Call report.

To avoid unexpected re-formatting cells, all data is stored in cells as text. The
(’) character will be added in front of each cell value, that character will not be
visible in cells. Numbers that are formatted as text are left-aligned instead of
right-aligned in the cell. With error checking turned on, they are also marked
with an error indicator. You are able to convert them to numbers in one cell
(or range of cells) at a time before performing sorting or calculations.

1–8 C•CURE 800/8000 Reports Guide


C•CURE 800/8000 Standard Reports
User-configurable Excel spread sheet report results display only one
worksheet per C•CURE 800/8000 report. If a user-configurable report has
“inner loops,” then all the loop fields are displayed as separate columns in the
Excel spread sheet. An inner loop field indicates a field with dependant
objects.

Example
Dependent (child) objects that are managed under iSTAR and apC
controllers include inputs, outputs, readers, boards, elevators, floors and
doors. Controllers are parent objects to these and are created first. When a
report includes fields which are dependant objects, these fields are
combined and nested within the parent object’s records.

The standard reports available in C•CURE 800/8000 are listed by type in


Table 1-2.

Table 1-2: C•CURE 800/8000 Standard Report Types

Report Type Report Name


Asset Reports  Miscellaneous Asset
 Defined Asset

Journal Reports  Journal Replay


 Predefined
 Admitted Access by Door Group
 Admitted Access by Door
 Input Activation by Input Group
 Input Activation by Input
 Rejected Access by Door Group
 Rejected Access by Door
 Time and Attendance
 Intrusion Zones in Maintenance Mode (for more
information about Maintenance Mode, see the
C•CURE 800/8000 Personnel Configuration Guide)
Table 1-2: C•CURE 800/8000 Standard Report Types, continued

Report Type Report Name


Personnel Reports  Personnel
 Users
 Roll Call
 Time and Attendance (with Enhanced
Reporting license)
 Personnel Administration Privilege
 Administration Privilege
 Users of Administration Privilege
 Users of Each Selected Screen

Personnel Reports  Monitoring Privileges


 Users of Each Monitoring Privilege
 Roles (for more information about Roles, see the
C•CURE 800/8000 Personnel Configuration Guide)

C•CURE Central  Manual Conflicts


 Replication Queue
 Server for C•CURE Central

Hardware  apC
 CCCTV (Action, Protocol, Switchers)
 Comm Ports
 Controller (iSTAR)
 Bi-directional Interface (Message Protocol, Device,
Gateway)
 Host Modem
 STAR Cluster
 NetVue (Server, Camera Action, Video Tour)
 Certificate
 Input
 Output
 Reader

Area Area

Automated Import Automated Import


Table 1-2: C•CURE 800/8000 Standard Report Types, continued

Report Type Report Name


Clearance  Clearance
 Custom Clearance
 Door Clearances

Partition  Partition Configuration


 Partition

Door Door

Elevator Elevator

Event Event

Floor Floor

Guard Tour Tour


Stop

Holiday  Holiday List


 Holiday

Intrusion Zone Intrusion Zone

Map Map

Keypad Command Keypad Command

Node Node

Time Specification  Time Spec Detail


 Time Spec

Time Zone  Time Zone Exceptions


 Time Zone
Table 1-2: C•CURE 800/8000 Standard Report Types, continued

Report Type Report Name


Groups  Area
 Door
 Elevator
 Event
 Floor
 Incident
 Input
 NetVue Alarm
 Output
 Personnel

Miscellaneous  Actions
 Authorized Cardholders
 Authorized Cards on apC
 Authorized Cards on Controller
 Board

User-Defined Reports  All Objects


 All Undeleted Objects
 Complex Clearance
 Object Linkage by Source
 Object Linkage by Target
 Sample
 Template
Configuration Reports Overview

Configuration Reports Overview


There are two types of configuration reports for the various security objects:
reports that you can configure by allowing you to determine the layout of a
report and reports that you cannot configure. Table 1-3 presents a list of the
user-configurable and non-configurable configuration report types. See
“User-Configurable Reports” on page 1-16 and “Non-Configurable Reports”
on page 1-27 for more information.

Table 1-3: Configuration Report Types

Configurable Report Type Non-Configurable Report Type


Assets Assets
 Defined Asset  Miscellaneous Asset

Personnel Personnel Administration Privilege


 Personnel  Administration Privilege
 Users  Users of Administration Privilege
 Roll Call  Users of Screen
 Time and Attendance (with
Enhanced Reporting license)

Personnel Monitoring Privilege


 Monitoring Privilege
 Users of Monitoring Privilege

Hardware Hardware
 apC  Bi-directional Interface (Message
Protocol)
 CCCTV (Action, Protocol, Switchers)
 Comm Ports
 Controller (iSTAR)
 Bi-directional Interface (Device, Gateway)
 Host Modem
 STAR Cluster
 NetVue (Server, Camera Action,
Video Tour)

C•CURE 800/8000 Reports Guide 1–13


Table 1-3: Configuration Report Types, continued

Configurable Report Type Non-Configurable Report Type


Hardware (continued)
 Certificate
 Input
 Output
 Reader

Area

Door C•CURE Central


 Manual Conflicts
 Replication Queue
 Server for C•CURE Central

Elevator Automated Import

Event Clearance
 Clearance
 Custom Clearance
 Door Clearances

Partition
 Partition Configuration
 Partition

Floor Holiday
 Holiday List
 Holiday

Intrusion Zone Guard Tour


 Tour
 Stop

Keypad command Map


Table 1-3: Configuration Report Types, continued

Configurable Report Type Non-Configurable Report Type


Node Time Specification
 Time Spec Detail
 Time Spec

Time Zone:
 Time Zone Exceptions
 Time Zone

Group
 Area
 Door
 Elevator
 Event
 Floor
 Incident
 Input
 Output
 Personnel

Miscellaneous
 Actions
 Authorized Cardholders
 Authorized Cards on apC
 Authorized Cards on Controller
 Board
User-Configurable Reports

User-Configurable Reports
User-configurable report types allow you to determine the layout of a report.
When you choose a security object from the Reports menu, the Report
Generation dialog box appears, as shown in Figure 1-3 with an example
report already configured.

Example:
To report on door configuration, select Door from the Reports menu.
As shown in Figure 1-3, one report is already defined. You can use the
cursor keys or mouse to select the report you want.

Figure 1-3: Report Generation Dialog Box

By using the buttons in the Report Configuration box at the bottom of the
dialog box you can:
 Edit an existing report
 Create a new report and choose the supported language in which it
appears
 Delete a report
 Rename a report and change the supported language in which it appears

1–16 C•CURE 800/8000 Reports Guide


Table 1-4 displays the fields and buttons available for user-configurable
configuration reports.

Table 1-4: Report Generation Dialog Box Fields and Buttons for Configurable Reports

Box Field/Button Description


Selected Report Displays the name of the report that is
currently selected in the Select Report list
box. This field is read-only.

Language Displays the language in which the report


appears. This field is read-only.
 Click New Report to define a report
and choose its language.
 Click Rename Report to change the
report’s language.

Select Report Lists Already-Created Reports

Name Displays the name of the report as it is


stored online.

Report Title Displays the name of the report as it appears


when the report is generated.

Report Configuration Edit Report Select a report from the Select Report list
and click Edit Report to edit the existing
report definition. The Edit Report dialog box
appears. See Figure 1-4 on page 1-19.

New Report Click to create a new report. A New Report


Name dialog box opens. See Figure 1-10 on
page 1-25. Enter the following:
 Report Name: file name of the report as
you would like it stored on the system
 Title: name of the report as you want it
to appear on the report itself (report
title)
 Language: language in which you want
the report to display.
Delete Report Click to delete a report definition. The
system asks whether you are sure you want
to delete the report definition. Click Yes to
confirm the deletion.
Table 1-4: Report Generation Dialog Box Fields and Buttons for Configurable Reports, continued

Box Field/Button Description


Report Configuration Rename Report Select a report from the Select Report list.
(continued) Click Rename Report to rename an existing
report definition or to change the language in
which you want the report to appear. The
system prompts you to do the following:
 Rename the report as you would like it
stored on the system (report file name)
 Rename the report as you want it to
appear on the report (report title)
 Change the report’s language

Run Report Click to run the currently selected report and


to see it in the View Report dialog box

View Last Text Report Click to view the last text format report
generated from this dialog box. This option
displays the last report which was produced
in text format, ignoring more recent Excel
reports.

Edit Default Click to edit the default report definition. Use


the default report to set up the fields you
want to appear in all reports of this type. Add
the fields and click OK. When you create a
new report, these fields will be pre-selected.
To View and Modify an Existing Configuration Report Definition

1. Select a report and click Edit Report. The Edit Report dialog box
appears in which you can add or remove the fields you want to report on,
or adjust their position in the report.

Figure 1-4: Edit Report Dialog Box

NOTE If you are configuring a Personnel report, the field names displayed in the
Field Name list are the field names configured in the Configure Field
Attributes dialog box, not the labels displayed for personnel views.

See the C•CURE 800/8000 Personnel Configuration Guide for information.

2. To reposition a field so that the data in the field appears one column to
the left of its current position, highlight the field, and click the Move up
button.

Report records are sorted by the first report column.


NOTE

3. To modify a field’s label or length, highlight the field and click Modify.
The Modify Field dialog box appears, as shown in Figure 1-5, in which
you can make the desired changes, following the information in Table 1-5
on page 1-20.

Figure 1-5: Modify Field Dialog Box

Table 1-5: Modify Field Dialog Box

Item Description
Field label The label for the column as it will appear on the report.

Display length of current field The number of characters you want to display on the report.
This option is available for character fields only. A field
length shorter than the label length is not allowed.

4. The system calculates the current line length of the report and displays it.

5. Once you have made the necessary changes, click OK. The Edit Report
dialog box reappears.

6. You can continue to work with the fields or click OK to return to the
Report Generation dialog box.

7. Click Run Report. A report such as the example shown in Figure 1-6 on
page 1-21 opens on your workstation on the View Report dialog box.
If you decide that you would like the Admit Causes column to appear as
the second column in the report, go back to the Edit Report dialog box,
select the field, and click Move up.
When you run the report again, the column appears as the second item in
the report.
8. To view the last report generated for this security object, click
View Last Rpt. (This button is unavailable if there is no existing report for
the security object.)
Whether you click Run Report or View Last Text Report, the report
opens in the View Report dialog box, as shown in Figure 1-6. The View
Last Text Report option displays the last report which was produced in
text format, ignoring more recent Excel reports.

Viewing a Configuration Report


Once you have run a configuration report and are viewing it, you have the
option to save or print the report. See “Printing and Saving a Report” on
page 1-22. You can also open your report in another application, such as
Microsoft Excel or Word. See “Opening a Report in Another Application” on
page 1-23.

Figure 1-6: Report Example


Printing and Saving a Report
Once you have run a report, you can print a copy of it or save it to a file. You
must run a report at your computer before you can print or save it.

NOTE If the report is too wide to fit on an 8-1/2 x 11 inch page, the
“recommended print layout” field displays “Landscape” instead of
“Portrait.”

To Print a Report

1. Click the Print button on the View Report dialog box, shown in
Figure 1-6 on page 1-21.
2. The system prompts you for printer information with the standard
Windows Print dialog box.

Figure 1-7: Print Dialog Box

3. Enter the desired print options. See the Microsoft Windows System Guide
for information on printer setup.
To Save a Report to a File

1. Click Save on the View Report dialog box, shown in Figure 1-6 on
page 1-21. The system prompts you for a file specification with a standard
Windows filename dialog box.

Figure 1-8: Filename Dialog Box

2. The default extension for the file is .rep, but you can save the report with
another file extension. Click the pull-down list to see possible values. If
you need help, consult the Microsoft Windows System Guide.

Opening a Report in Another Application


Once you have run a report, you can open it in an external application such as
Microsoft Excel or Word. You must run the report at your computer before
you can do this.

NOTE If the report you generate is more than 16 MB, the system can display only
the first 10 pages on the View Report dialog box. You must open it in
another application to view the entire report. When you click Run Report
on the Report Generation dialog box, a message warns you about this.
NOTE C•CURE 800/8000 allows reports to be viewed and saved in Microsoft
Excel. Click the Display in Excel check box in the Report Generation
for... dialog box before you click Run Report to view your selected report
in Excel. For an example of viewing and saving reports in Excel see
“Viewing and Displaying Journal Replay Report Results in Microsoft
Excel” on page 2-46.

To Open a Report in Another Application

1. Click the Open With button on the View Report dialog box, shown in
Figure 1-6 on page 1-21.
The Open With dialog box, appears as shown in Figure 1-9.

Figure 1-9: Open With Dialog Box

2. Select an application from the list and click OK to open your report in
the selected format.
Creating a New Configuration Report

To Create a New Configuration Report

1. On the Report Generation dialog box, click New Report. The New
Report Name dialog box, Figure 1-10, opens.

Figure 1-10: New Report Name Dialog Box

2. Enter the following information:


• Report Name – file name of the report as you would like it stored on
the system
• Title – name of the report as you want it to appear on the report itself
(report title)
• Language – supported language in which you want the report to
display.
3. Click OK. The Edit Report dialog box appears as shown in Figure 1-4 on
page 1-19. See Step 2 through Step 8 on page 1-21.

Deleting a Configuration Report


You can delete user-configurable configuration reports. See Table 1-3 on
page 1-13 for the list of user-configurable reports.

To Delete a Configuration Report

1. Access the Report Generation dialog box.


2. Select the report you want to delete.

3. Click the Delete Report button in the Report Configuration box. The
system asks if you are sure you want to delete the report.
4. Click Yes to delete it.
Renaming a Configuration Report
You can rename user-configurable configuration reports. See Table 1-3 on
page 1-13 for the list of user-configurable reports.

To Rename a Configuration Report

1. Access the Report Generation dialog box.


2. Select the report you want to rename.

3. Click the Rename Report button in the Report Configuration box.

4. The system asks you for a new report name, a new title—which will
appear on the printed report, and a new report language.
5. Enter the name and title.

6. Click the Language drop-down list box and specify the supported
language in which you want the report to appear.
7. Click OK.

NOTE If you change the supported language in which the report will appear, you
should also change the field labels appropriately.
Non-Configurable Reports

Non-Configurable Reports
Non-configurable configuration report types allow you to view and run a
report, but don’t allow you to rearrange the format. For a list of non-
configurable configuration reports, see Table 1-3 on page 1-13. When you
choose a security object from the Reports menu, the Report Generation
dialog box appears, as shown in the example in Figure 1-11. These non-
configurable reports are predefined.

Example:
To report on clearances, select Clearance from the Report menu.

The Report Configuration buttons (Edit Report, New Report, Delete Report,
and Rename Report) are unavailable, as is the Edit Default button. The
Language field is available, letting you select a language for the printed
report.

As shown in the example in Figure 1-11, there are three predefined clearance-
type reports. You can use the cursor keys or mouse to select the report you
want to view or run.

Figure 1-11: Clearance Report Selection

C•CURE 800/8000 Reports Guide 1–27


Table 1-6 displays the fields and buttons available for all non-configurable
configuration reports.

Table 1-6: Report Generation Dialog Box Fields and Buttons for Non-Configurable Reports

Box Field/Button Description


Selected Report Displays the name of the report that is
currently selected in the Select Report list
box. This field is read-only.

Language Displays the supported language in which


the report appears.
 Select another supported language (if
available) from the drop-down box to
display the report in a different
language.
Select Report Lists Already-Created Reports

Name Displays the name of the pre-defined report


as it is stored online.

Run Report Click to run the currently selected report and


to see it in the View Report dialog box

View Last Text Report Click to view the last text format report
generated from this dialog box. This option
displays the last report which was produced
in text format, ignoring more recent Excel
reports.

A sample Clearance Report is shown on the View Report dialog box in


Figure 1-12 on page 1-29. Typically, once you have run a non-configurable
configuration report, you have the option to save or print the report. See
“Printing and Saving a Report” on page 1-22. You can also open your report
in another application, such as Microsoft Excel or Word. See “Opening a
Report in Another Application” on page 1-23.
Figure 1-12: Clearance Report
Personnel Reports

Personnel Reports
Personnel reports allow you to get printed information about personnel and
system users. When you generate a personnel report, you must specify the
personnel records for which you want a report. You can also restrict the
personnel records selected by personnel group and by their access
permissions at specific doors or door groups. You can delete and rename
personnel reports or add, remove, and rearrange their fields.

To Generate a Personnel Report

1. Select Personnel from the Report menu and then select Personnel
from the Personnel submenu. The Report Generation for Personnel
dialog box appears, as shown in Figure 1-13.

Figure 1-13: Report Generation for Personnel Dialog Box

This dialog box displays previously created reports.

NOTE The Run Report button is unavailable until you perform a query.

1– C•CURE 800/8000 Reports Guide


2. Select the report when you click on the listing. It will be highlighted, as
shown in Figure 1-13 on page 1-30.

NOTE A Wildcard search can be used to search for a specific report. See “Using
Wildcard Search” on page 1-5 for more information and examples.

If you want to edit a specific personnel report (including changing the


supported language in which it appears) or create a new one, you can do
so from this dialog box by clicking the Edit Report or New Report
buttons. The language can only be changed while using a New Report.
Follow the steps outlined in “User-Configurable Reports” on page 1-16
for viewing and modifying existing configuration reports and for creating
new configuration reports.
Once you have the report definition you want, you are ready to select
personnel records for your report.
3. To limit the personnel for this report to those only in a specific personnel
group, enter a personnel group name or double-click in the Restricted
by Group field. Select a group from the Personnel Group Selection
dialog box, as shown in Figure 1-13 on page 1-30.
4. To limit the personnel for this report to only those assigned a specific
clearance, select the Clearance Selection button. The Select
Clearances dialog box appears, as shown in Figure 1-14 on page 1-32.
Figure 1-14: Select Clearances Dialog Box

You can also specify a door, door group, or double-click in the With
allowed access by Door/Door Group field and select a Door or Door
Group from the Door Selection browser. The same is also true for
elevators and elevator groups.
See the C•CURE 800/8000 Software Configuration Guide Clearances
chapter for more information. For more information concerning the
configuration of Door and Elevator Groups, also refer to Groups chapter
in the C•CURE 800/8000 Software Configuration Guide. For information
about Doors and Elevators, refer to the corresponding chapters of the
C•CURE 800/8000 Hardware Configuration Guide.
Using the Select Clearances dialog box you can select clearances to be
added to the query criteria. To modify the clearance selection you can use
the Add/Remove buttons. The system retains the selection until the
Report Generation for Personnel dialog box is closed.
If the clearance list has been modified after the Query Personnel button
is selected, you must re-query personnel. The Personnel Query dialog
box also allows you to add a clearance to also be considered by the
query.
5. To specify personnel records, click the Query Personnel button in the
Report Generation for Personnel dialog box shown in Figure 1-13 on
page 1-30. The Personnel Query for Reports dialog box appears, shown
in Figure 1-16 on page 1-37. Use this dialog box to compose a query for
the personnel information that you want in your report.

NOTE In a partitioned system, reports respect the configured partitions. You


can run reports only on partitioned objects in your own and shared
partitions, unless you are a partition administrator. Partition
administrators can run reports on objects in any partition(s) they
administer.
Table 1-7 lists some of the fields and buttons available for use in the
Report Generation for Personnel dialog box, some of which are unique
to personnel reporting.

Table 1-7: Report Generation for Personnel Dialog Box Fields and Buttons

Box Field/Button Description


Report Generation Fields Restricted by Group Enter a personnel group name or double-
click in this field to select a group from the
Personnel Group Selection browser. With
a selection, your generated report is filtered
to include only those personnel in that
group.
With allowed access by Select the Door/Door Group option and
Door/Door Group enter a door or door group name or double-
click in this field to select one from the Door
Selection browser. With such a selection,
your generated report includes only
personnel who are allowed access, through
clearances/custom clearances, at the
selected door or at least one door in the
selected door group.

With allowed access by Select the Elevator/Elevator Group option


Elevator/Elevator Group and enter a elevator or elevator group name
or double-click in this field to select one
from the Elevator Selection browser. With
such a selection, your generated report
includes only personnel who are allowed
access, through clearances/custom
clearances, at the selected elevator or at
least one elevator in the selected elevator
group.
Table 1-7: Report Generation for Personnel Dialog Box Fields and Buttons, continued

Box Field/Button Description


Records Selected This field shows the number of personnel
records returned from the query which met
the criteria that you entered for the
Personnel Query and entered in the
Restricted by Group and/or With allowed
access by Door/Door Group fields.

With assigned clearances To limit the personnel for the report to only
those assigned a specific clearance, select a
clearance from the With assigned
clearances list.

Clearance Selection To limit the personnel for this report to only


those assigned specific clearances, select
the Clearance Selection button. The Select
Clearances dialog box appears, as shown in
Figure 1-14 on page 1-32.

Show Deleted Cards Select this check box to show deleted cards
in the query and report.

Report Generation Buttons Query Personnel Click Query to open a Personnel Query
dialog box (see Figure 1-15 on page 1-35)
and enter criteria for selecting personnel for
the report. These criteria are in addition to
any restrictions from entries you made in the
Restricted by Group and/ or With allowed
access by Door/Door group fields.

Run Report Click to run the currently selected report and


to see it in the View Report dialog box.
NOTE: This button is unavailable until you
run a successful query that returns at
least one personnel record.

View Last Text Report Click to view the last text format report
generated from this dialog box. This option
displays the last report which was produced
in text format, ignoring more recent Excel
reports.
Figure 1-15: Personnel Query for Reports Dialog Box

The personnel view that you have configured determines the layout of the
NOTE
Personnel Query dialog box. In the personnel view shown in Figure 1-15,
the Cards tab has been configured with Activation and Expiration Date
From/To fields added. This view allows a query that includes cards with
activation or expiration dates between 02/21/06 at 11:02 and 06/21/06 at
11:36. The default $System Person View includes only a single activation
and expiration date on the General tab and does not include a Cards tab.
If you are using another view or are using a partitioned system, your
Personnel Query dialog box may look different. See “Configuring
Personnel Views” in the C•CURE 800/8000 Personnel Configuration Guide
for more information about configuring personnel views.

6. Specify search criteria for the query by following these guidelines:


• To run a faster query, query on indexed fields; otherwise your query
may be slow if you have a large personnel record database. The
following fields are indexed: Person ID, Person EUID, Card Number,
CHUID, Extended Card, First Name, Last Name, Agency Code,
PIN- Only Access, certain user-named text and integer fields (such as
Int1, Int2, Int6, and Int7 or Text1, Text2, Text6, and Text7).
• Only enter values in the fields on which you want to search. Leave all
other fields set to ? (question mark).
Example:
To find only personnel whose cards have an issue code of 2, enter 2
in the Issue Code field.
• You can also enter partial data in a field.
Example:
You can enter part of a last name to find all personnel whose last
name begins with those characters. When you use this method, you
must insert an asterisk (*) wildcard character at the end of the data
string.
Example:
If you enter Sar*, the system searches for all names beginning with
Sar, such as Saroyan, Sarton, and Sartre.
• You can enter as little or as much information as you want on this
dialog box. The system retrieves only the records that match all of
your search criteria. The more information you enter, the more
selective your query.
• If you do not enter anything, the system retrieves all records in the
Personnel data table.
• For check boxes, click to select one of the following search options:
Restrict your search to personnel records for which the option is
selected.
Restrict your search to personnel records for which the option is not
selected.

Do not restrict your search based on the option.


• You cannot query on PINs.
• You can include only one clearance code in your query to find all
records with that clearance.
7. Select one of the following query options:
• Existing Records to query existing records only.
• Deleted Records to query deleted records only.
• All Records to query both existing and deleted records.

8. Click Do Query to run the query.


- or -
Click Clear Screen to remove information from the Personnel Query
dialog box and specify new search criteria.

NOTE If no records are found by the query, the system displays a message.

NOTE If your system is partitioned, query results are restricted to personnel


records in your own partition and in any shared partitions. Partition
administrators can view query results for all personnel in any partition(s)
that they administer. If you have set the system option for partitioning
with global clearance assignment, see “Defining Personnel Options” in the
C•CURE 800/8000 System Maintenance Guide for information.

When you run the query, the Personnel Query in Progress dialog box
opens, as shown Figure 1-16.

Figure 1-16: Personnel Query in Progress Dialog Box

This dialog box displays the number of personnel records being retrieved
by the query. If your personnel database is very large and the query is
taking too long, you can cancel it by clicking the Stop Query button.
When the system either finishes retrieving records or stops the query, the
Report Generation for Personnel dialog box reappears with the Run
Report button available. This dialog box displays the query results in the
Records selected field: the total number of personnel records found in
the database that met your criteria (including the criteria you entered in
the Restricted by Group and/or With allowed access by Door/Door
Group fields) or the number of records found before you clicked Stop
Query.
NOTE
If you are running a query on a Wide Area Network (WAN) and you use
the Stop Query option, you will essentially cancel the query, as data
retrieval over a WAN uses the creation of temporary data tables on your
client-side server to avoid latency caused by data transmission through
routers and other network components. The Stop Query command
eliminates such tables. The use of Stop Query is practicable for partial
data retrieval when running a query on a Local Area Network (LAN). The
system shows results obtained by the time that you clicked the Stop
Query button.

9. Make sure the report you want is highlighted and click Run Report. The
View Report dialog box appears from which you can print or save the
report or open it in another application. Figure 1-17 displays a report
example that lists all personnel who are allowed access to a selected door.

Figure 1-17: View Report Dialog Box with Personnel Report


10. To print or save the report after you have run it, follow the steps in
“Printing and Saving a Report” on page 1-22. To open your report in
another application, such as Microsoft Excel or Word, see “Opening a
Report in Another Application” on page 1-23.

NOTE You can query personnel records as the first step in the report generation
process, before you edit an existing report, create a new one, or select one
for running
User Privilege Reports

User Privilege Reports


User reports allow you to get printed information about C•CURE 800/8000
users and user privileges. This type of report includes:
 One users report
 Three administration privilege reports
 Two monitoring privilege reports.

Users Report
The users report lists all personnel who are system users: people who have
authorization to run either the administration application or the monitoring
station. The report shows such information as the user’s administration and
monitoring privileges.

These reports are user-configurable. You can delete and rename users reports
or add, remove, and rearrange their fields.

To Generate a Users Report

1. Select Personnel from the Report menu and then select Users from
the Personnel submenu. The Report Generation for Users dialog box
appears, as shown in Figure 1-18 on page 1-41.

1– C•CURE 800/8000 Reports Guide


Figure 1-18: Report Generation for Users Dialog Box

Figure 1-18 lists an example report that was previously configured.

2. Select the report you want to generate from the Select Report box.

3. If you want to edit a specific report (including changing the supported


language in which it appears) or create a new one, you can do so from
this dialog box by clicking the Edit Report or New Report buttons.
Follow the steps outlined in “User-Configurable Reports” on page 1-16,
for viewing and modifying existing configuration reports and for creating
new configuration reports and refer to Table 1-4 on page 1-17 for
descriptions of the available fields and buttons on the Report
Generation dialog box.
4. Make sure the report you want is highlighted and click the Run Report
button.
The View Report dialog box appears, as shown in the example in
Figure 1-19 on page 1-42, from which you can print or save the report or
open it in another application.
Figure 1-19: View Report Dialog Box

5. To print or save the report, follow the steps in “Printing and Saving a
Report” on page 1-22. To open your report in another application, such as
Microsoft Excel or Word, see “Opening a Report in Another Application”
on page 1-23.
Administration Privilege Reports
There are three administration privilege reports, as listed in Table 1-8,
providing information about user privileges for the administration
application. These reports are pre-defined and not configurable. You cannot
delete and rename administration privilege reports, nor configure their fields.
See the “Viewing and Displaying Report Results in Microsoft Excel” on
page 1-7 and “Non-Configurable Reports” on page 1-27 for more information.
The reports are as follows:

Table 1-8: Administration Privilege Reports

Report Name Description


Administration Privileges Lists available administration privileges.

Users of Administration Privileges Lists users assigned to each administration privilege.

Users of Screen Lists users with access rights to a specific dialog box
(as specified by the person running the report).

See Table 1-6 on page 1-28 for descriptions of the fields and buttons available
for non-configurable reports on the Report Generation dialog box.

To Generate an Administration Privilege report

1. Select Personnel from the Report menu and then select Administration
Privilege from the Personnel submenu. The Report Generation for
Administration Privilege dialog box, Figure 1-20 on page 1-44, appears.
Figure 1-20: Report Generation for Administration Privilege Dialog Box

2. Click to open the Language drop-down list box and specify the supported
language in which you want the report to appear.
3. Select one of the following predefined reports from the Select Report
box and click the Run Report button:
• Admin Priv Report – The View Report dialog box appears from
which you can print, save, or exit the report. Go to Step 5 on page 1-
46.
• Users of Admin Priv Report – The View Report dialog box appears
from which you can print, save, or exit the report. Go to Step 5
on page 1-46.
• Users of Screen Report – The Select Screen(s) dialog box
appears, shown in Figure 1-21 on page 1-45. Go to Step 4 on page
1-45.
Figure 1-21: Select Screen(s) Dialog Box

4. Highlight the dialog box(es) for which you want to report on user access
privileges and click the Select button. To select a range of dialog boxes
simultaneously, press the Shift key and click the first and last dialog
boxes. To select several dialog boxes not in a range simultaneously, press
the Ctrl key and click each dialog box.
The View Report dialog box appears, as shown in the example in
Figure 1-22 on page 1-46, from which you can print or save the report or
open it in another application.
Figure 1-22: View Report Dialog Box with a Users of Screen Report

5. To print or save the report, follow the steps in “Printing and Saving a
Report” on page 1-22. To open your report in another application, such as
Microsoft Excel or Word, see “Opening a Report in Another Application”
on page 1-23.
Monitoring Privilege Reports
There are two monitoring privilege reports, as listed in Table 1-9, providing
information about user privileges for the monitoring application. These
reports are pre-defined and not configurable. You cannot delete and rename
monitoring privilege reports, nor edit their fields. See the “Viewing and
Displaying Report Results in Microsoft Excel” on page 1-7 and “Non-
Configurable Reports” on page 1-27 for more information.

Table 1-9: Monitoring Privilege Reports

Report Name Description


Monitoring Privileges Lists available monitoring privileges.

Users of Monitoring Privileges Lists users assigned to each monitoring privilege.

See Table 1-6 on page 1-28 for descriptions of the fields and buttons available
for non-configurable reports on the Report Generation dialog box.

To Generate a Monitoring privilege Report

1. Select Personnel from the Report menu and then select Monitoring
Privilege from the Personnel submenu. The Report Generation for
Monitoring Privilege dialog box, Figure1-23 onpage1-48, appears.
Figure 1-23: Report Generation for Monitoring Privilege Dialog Box

2. Click to open the Language drop-down list box and specify the
supported language in which you want the report to appear.
3. Select one of the predefined reports from the Select Report box and click
the Run Report button.
The View Report dialog box appears, as shown in the example in
Figure 1-24 on page 1-49, from which you can print or save the report or
open it in another application.
Figure 1-24: View Report Dialog Box with a Monitoring Privilege Report

4. To print or save the report, follow the steps in “Printing and Saving a
Report” on page 1-22. To open your report in another application, such as
Microsoft Excel or Word, see “Opening a Report in Another Application”
on page 1-23.
Miscellaneous Reports

Miscellaneous Reports
For reports not falling into any of the basic report categories, use the
Miscellaneous command on the Administration Reports menu. Software
House has created these reports to help you get basic system information. The
reports include those listed in Table 1-10.

Table 1-10: Miscellaneous Reports

Report Name Description


Actions Lists actions associated with events (organized by event).

Authorized Cardholders Lists cardholders authorized to use a selected door and their
clearance codes.

Authorized Cards on apC Lists cardholders with clearances for access to the apC
panel.

Authorized Cards on Controller Lists cardholders with clearances for access to the controller.

Board Lists the boards defined on each controller and/or apC.

NOTE If your system is partitioned, the Authorized Cardholders, Authorized


Cards on apC, Authorized Cards on Controller, and Board reports list
only items from your own partition or shared partitions with one
exception: reports run by users who are partition administrators list
items from any partition(s) that they administer.

You cannot delete and rename miscellaneous reports, nor edit their fields.
See the “Viewing and Displaying Report Results in Microsoft Excel” on page
1-7 and “Non-Configurable Reports” on page 1-27 for more information.

See Table 1-6 on page 1-28 for descriptions of the fields and buttons
available for non-configurable reports on the Report Generation dialog box.

1– C•CURE 800/8000 Reports Guide


To Generate One of the Miscellaneous Reports

1. Select Miscellaneous from the Report menu. The Report Generation


for Miscellaneous Reports dialog box, Figure 1-25, opens.

Figure 1-25: Report Generation for Miscellaneous Reports Dialog Box

2. Click the Language drop-down list box and specify the supported
language in which you want the report to appear.
3. Select the report you want from the Select Report box and click the
Run Report button.

NOTE For the Authorized Cardholders report you must first select a door. The
Door Selection browser appears when you click the Run Report button.

The report appears on the View Report dialog box from which you can
print or save the report or open it in another application. In the example in
Figure 1-27 on page 1-54, the Action Report appears, giving you a list of
actions for each event.
Figure 1-26: View Report Dialog Box with an Actions Report

4. To print or save the report, follow the steps in “Printing and Saving a
Report” on page 1-22. To open your report in another application, such as
Microsoft Excel or Word, see “Opening a Report in Another Application”
on page 1-23.
Roll Call Reports

Roll Call Reports


The roll call report allows you to print out, or display on a client Monitoring
Station, a list of all personnel the system determines to be in a specified area or
area group. This report is intended to assist in the emergency evacuations of
buildings and can be initiated in three different ways:
 By an Administration Application user
 By a Monitoring Station user
 By an event

The roll call report gives a view of where personnel are located at the time the
report is started. It takes 15 to 60 seconds after the report is initiated to
upload all the personnel information; personnel movement which occurs
after the upload is not included in the report.

NOTE The system determines the last door accessed by each cardholder by
sorting accesses by the local time that they occurred. Accesses recently
received from a dialup apC panel/iSTAR controller that actually occurred
several days ago are considered older than accesses that occurred today.

The area group supports roll call: an area group can contain one or more
areas. Area groups are created and edited in the same manner as all other
groups. See “Putting Security Objects into Groups” in the C•CURE 800/8000
Software Configuration Guide for more information. An area may be assigned to
several area groups; the areas assigned to an area group may also span
multiple apCs or iSTAR controllers.

The C•CURE 800/8000 tracks the current location, or area, of each


cardholder as he or she moves through doors controlled by access readers.
The tracking of personnel movement is independent of the anti-passback
restrictions of an area. Therefore, anti-passback does not have to be enforced
in order for roll call and area groups to be used, but any areas used in roll call
reports must have access control readers in them.

C•CURE 800/8000 Reports Guide 1–53


Configuring Roll Call Reports from the Administration Application
The Report Generation for Roll Call dialog box lets you create, edit, delete,
and run roll call reports. The roll call report differs from the other reports
described in this chapter in the following ways:
 You can only view the report online on the Monitoring Station.
 On the Edit Roll Call Report dialog box, you must specify the area or
area group for which the report is being run.

NOTE Roll Call reports may look unformatted if:


 More than 10 clearances are selected
 Clearance names are too long

To Work with Roll Call Reports

1. Select Personnel from the Reports menu and then select Roll Call from
the Personnel submenu. The Report Generation for Roll Call dialog
box, Figure 1-27, appears. (In this example, a roll call report is already
defined.)

Figure 1-27: Report Generation for Roll Call Dialog Box


2. Use the following buttons to edit, create, delete, or rename reports:
• Edit Report - Highlight an existing roll call report and click this
button to modify the roll call report. The Edit Roll Call Report dialog
box, shown in Figure 1-28 on page 1-56, appears. See “Editing Roll
Call Reports” next in this chapter for further information.
• New Report - Click this button to create a new roll call report. For
instructions see “Creating a New Configuration Report” on page 1-25
for further information.
• Delete Report - Highlight a report and click this button to delete an
existing roll call report definition. See “Deleting a Configuration
Report” on page 1-25 for further information.
• Rename Report - Highlight an existing roll call report and click this
button to rename a roll call report. See “Renaming a Configuration
Report” on page 1-26 for further information.
3. After you configure a roll call report, you can do the following:
• Run the report immediately using the Run Report button. See
“Running Roll Call Reports” on page 1-57 for information.
• Create an event that activates a roll call report. See “Defining Actions
for Events” in the C•CURE 800/8000 Software Configuration Guide for
more information.
• Let a Monitoring Station user run the report on a client Monitoring
Station. Refer to the C•CURE 800/8000 Monitoring Station User’s Guide
for more information.

Editing Roll Call Reports


The Edit Roll Call Report dialog box lets you configure new roll call reports
and edit existing roll call reports.

To Configure a Roll Call Report

1. Select an existing report and click the Edit Report button in the Report
Generation for Roll Call dialog box or click OK in the New Report
Name dialog box for a new roll call report. The Edit Roll Call Report
dialog box opens, as shown in Figure 1-28 on page 1-56.
This dialog box allows you to select fields to include in the report and to
adjust their position in the report. The following fields can be specified
for a roll call report:
• Any fields from the personnel record
• Last Access Date/Time (when the last access occurred for
this cardholder)
• Door used (Door through which the cardholder entered the area)
• Area used (access area where the cardholder was located at the time
of the roll call report

Figure 1-28: Edit Roll Call Report

2. Configure the report. See Step 1 on page 1-19 through Step 6 on page 1-20.
3. Specify a single area or area group for which you want to produce this
roll call report. Only cardholders whose last known location is in the
specified area are included in the roll call report.
4. To open the standard select browser for a list of areas or area groups,
double-click the Area field; then use the option buttons to select
either areas or area groups.

5. Either specify the printer to which you wish to send the report, or leave
the field blank if you want the report to display on a client Monitoring
Station. If you are specifying a printer, you can either enter the printer
path in the Printer field or double-click in the field to select a printer on
the Printer Selection dialog box. The list of printers on the selection
dialog box are all in the same workgroup or domain as the
C•CURE 800/8000 Server computer. (The report is printed from the
server.)
6. Click OK to return to the Report Generation for Roll Call dialog box.

Running Roll Call Reports

To Generate a Roll Call Report

1. On the Report Generation for Roll Call dialog box make sure the report
you want is highlighted and click the Run Report button. The Run Roll
Call Report dialog box appears with the Current printer dialog box on
top, as shown in Figure 1-29.

Figure 1-29: Report Generation for Roll Call Dialog Box

2. If the Printer field is blank, double-click in the Printer field to select a


printer on the Printer Selection dialog box. The list of printers on the
selection dialog box are all in the same workgroup or domain as the
C•CURE 800/8000 Server computer. (The report is printed from the
server.) If a printer is displayed in the field, either leave the printer
defined for this report or double-click in the Printer field to select another
printer from the printer list.

3. Click Begin Report to run the report. The report prints out in portrait
or landscape orientation automatically—depending upon the length of
the report line.

Running Roll Call Reports for Selected Personnel


You can run a roll call report that prints a list only of specified personnel
within an area rather than all the personnel in that particular area.

Example:
You might need a report that lists all the fire wardens in a building and
the floor for which each is responsible.

To Generate a Roll Call Report for Selected Personnel

1. Open the Diag System Utility, shown in Figure 1-30 on page 1-59, from
the Windows desktop as follows: click Start, point to Programs, point to
the C•CURE 800/8000 System Diagnostics icon, and click the Diag
System icon.
Figure 1-30: C•CURE System Diagnostics

2. Click 4GLInterface in the Section list box, click RollCallEnableSelector


in the Entry list, and change the value in the Entry Value field to 1.

3. Click Apply Changes and Quit.

4. In the Administration application on the Edit Roll Call Report dialog


box, shown in Figure 1-28 on page 1-56, select any of the logical
personnel fields for the first column of the roll call report.
Example:
Logical1, Logical2, or other logical user-defined field
This is the “selector” field.

NOTE The selector field does not appear in the report, but is used to determine
which personnel are included in the report (assuming that all other roll
call criteria have been met).
Example:

The following is a roll call report with the RollCallEnableSelector set to 0,


which means No and represents a “normal” roll call report.

Date: 08/09/2005 Fire WardenPage: 1

Time: 15:48Fire Warden

FBFloorLast NameFirst NameFire BrigadeArea used

no 0Truman (57)DavidEast Out

no 0Robinson (7)MaryEast Out

no 0Ross (23)FranklinEast Out

yes 1Wilson (49)ThomasDFWEast

Out yes 2Churchill (12)WilmaWEast

Out yes 3Divol (38)BenDFWEast Out

yes 3Linde (44)CharlesFWEast

Out yes 3Roberts (14)TedFWEast

Out
Example:

The following is the same roll call report as in the example on page 1-60,
with the RollCallEnableSelector set to 1, which means Yes and represents a
roll call report for a selected group of personnel.

Date: 08/09/2005 Fire WardenPage:

1 Time: 15:47Fire Warden

FloorLast NameFirst NameFire BrigadeArea used

1Wilson (49)ThomasDFWEast Out

2Churchill (12)WilmaWEast Out

3Divol (38)BenjaminDFWEast Out

3Linde (44)CharlesFWEast Out

3Roberts (14)TheodoreFWEast Out


User Defined Reports

User Defined Reports


You can customize a report by creating your own report definitions. Select
User Defined from the Reports menu. The system searches the report
directory to find a list of your reports. (Several sample reports are also
provided.) The Report Generation for User Defined Reports dialog box
appears, as shown in Figure 1-31. For more information on this feature,
contact the Software House Customer Support Center.

Figure 1-31: Report Generation for User Defined Reports Dialog Box

Table 1-11 on page 1-63 displays the fields and buttons in the Report
Generation for User Defined Reports Dialog Box

1– C•CURE 800/8000 Reports Guide


Table 1-11: Report Generation for User Defined Reports Dialog Box Fields

Item Description
Report Directory The default directory where the system stores sample reports
and any user-defined reports that you create.

Select Reports List The list of sample reports provided by Software House and
any user-defined reports that you have already created.
 Software House-provided Reports
 All Objects – lists all security objects ever created
on this system, indicating whether or not deleted.
 All Undeleted Objects – lists all existing
security objects created on this system.
 Remaining Reports are for internal use.

Run Selected Reports Click this button to run the currently selected report and see it
on the View Reports dialog box, shown in Figure 1-5 on
page 1-14.

View Last Text Report Click this button to view the last report generated from this
dialog box. This option displays the last report which was
produced in text format, ignoring more recent Excel reports.

To print or save the report, follow the steps in “Printing and Saving a Report”
on page 1-22. To open your report in another application, such as Microsoft
Excel or Word, see “Opening a Report in Another Application” on page 1-23.
C•CURE Central Reports

C•CURE Central Reports


If your C•CURE 800/8000 is a part of a C•CURE Central network, to access
reports with information about C•CURE Central use the C•CURE Central
command on the Administration Reports menu.

NOTE This command is available only if the C•CURE 800/8000 belongs to a


C•CURE Central network.

The available reports include those listed in Table 1-12:

Table 1-12: C•CURE Central Reports

Report Name Description


Manual Conflicts Lists all existing manual conflicts between this C•CURE 800/8000
and C•CURE Central. These are the personnel records that
C•CURE Central rejected for replication, and the report includes the
rejection reasons. You have to change these records on C•CURE
800/8000 for replication to be successful

Replication Queue Lists the records in the current queue waiting to be replicated,
including the records currently in manual conflict.

Server Lists all the servers in the C•CURE Central network, and includes
details such as the server's name, CID, computer name, and
whether or not replication is enabled on this server. The report also
identifies the local server and whether it is configured (on C•CURE
Central) to allow global field editing of external personnel.

You cannot delete and rename C•CURE Central reports, nor edit their fields.
See the “Viewing and Displaying Report Results in Microsoft Excel” on
page 1-7 and “Non-Configurable Reports” on page 1-27 for more information.

See Table 1-6 on page 1-28 for descriptions of the fields and buttons available
for non-configurable reports on the Report Generation dialog box.

1– C•CURE 800/8000 Reports Guide


To Generate One of the C•CURE Central Reports

1. Select C•CURE Central from the Report menu. The Report


Generation for C•CURE Central Reports dialog box, Figure 1-32,
appears.

Figure 1-32: Report Generation for C•CURE Central Reports Dialog Box

2. Click the Language drop-down list box and specify the supported
language in which you want the report to appear.
3. Select the report you want from the Select Report box and click the
Run Report button.
The report appears on the View Report dialog box, as shown in
Figure 1-6 on page 1-21.
4. To print or save the report, follow the steps in “Printing and Saving a
Report” on page 1-22. To open your report in another application, such as
Microsoft Excel or Word, see “Opening a Report in Another Application”
on page 1-23.
2

Journal Reporting

Journal Replay allows you to create activity and audit log reports, as well as
incident log reports.

In this chapter
 Overview....................................................................................................................2-2
 Audit Trail..................................................................................................................2-4
 Generating a Journal Report....................................................................................2-8
 Creating Activity Reports.........................................................................................2-15
 Creating Audit Reports............................................................................................2-19
 Creating Incident Reports.......................................................................................2-25
 Running a Journal Report......................................................................................2-43

C•CURE 800/8000 Reports Guide 2–1


Overview

Overview
C•CURE 800/8000 tracks the following types of information:
 Activity occurring in the system and monitored by the system—accesses,
rejects, event activations, and input/output state changes. This
information is known as the activity log.
• C•CURE 800/8000 can also track Incident IDs in either of the
following ways:
– By incident groups – these include inputs and/or events and permit
you to track input state changes, event activations, and any related
messages by a specific Incident ID tag.
– By event – a unique Incident ID tag allows you to track a series of
event activities.
 Changes made to the C•CURE 800/8000 database by the
Administration application—additions, modifications, or deletions of
security objects and personnel records. This information is known as the
audit log.
 Intrusion Zones in Maintenance Mode activity.

The information is stored in database files known collectively as journal


databases.

As activity occurs in the system, it is recorded or written to the journal


database. As users make changes to security objects and personnel records in
the C•CURE 800/8000 database, these changes are also written to the
journal database. The journal, therefore, contains a record of all the activity
the system monitors and all the database configuration changes. The journal
consists of the current database (which contains current activity and audits)
and older database (which contain all past activity and audits).

You can generate journal reports containing either activity or audit


information, or both. A journal report for the activity log can tell you who
accessed a particular door during a given time span. A journal report for the
audit log can tell you that a particular door configuration in the database was
modified, how (which fields), when, and by whom.

You can also generate journal incident reports that filter the activity log for
Incident IDs only—either those associated with incident groups (including
inputs and/or events) or those that pertain only to an event and its related
activities.
How the C•CURE 800/8000 Changes to a New Journal
As the journal gets larger, it can take up a lot of disk space and take a long
time to back up. For this reason, the system changes to a new journal file
based on the values for the SwitchTime and MaximumRecords parameters
in the CCURE.INI file, accessed through the Diag System Utility. For
information on changing these parameters, see the C•CURE 800/8000
Troubleshooting Guide.

By default, the system will switch to a new journal file when both the
following are true:
 The current journal contains at least 100,000 records.
 Midnight has just passed.

When changing journals, the system creates an empty journal file. Once that
file is created, the system can begin recording new information.

Journal Numbering
Numbering for the journal database starts at 1 and increments by one every
time you switch journals. Your system can maintain up to 99,999 journals.
However, it is a good idea to remove older journals that you no longer need
from the system.

See “Maintaining Your Journal Databases” in the C•CURE 800/8000 System


Maintenance Guide for further information.

C•CURE 800/8000 Reports Guide 2–3


Audit Trail

Audit Trail
In C•CURE 800/8000, audit trail can track changes to the security objects and
personnel records at either of two levels:
 Field level — records details of changes
 Object level — records only that changes were made (the default)

To choose the desired audit level, select or clear the Enable Field-level
Auditing option on the Auditing tab of the System Variables dialog box. You
must stop and restart the C•CURE System driver for the change to take effect.
See “Defining Auditing Options” in the C•CURE 800/8000 System Maintenance
Guide for further information.

NOTE The system only starts tracking the changes to objects and personnel at
the level indicated on the System Variables Auditing tab once you have
changed that option and stopped and restarted the driver.

Changes Which Are Not Audited


The following changes are not audited at all:
 Changes not stored in the database permanently, such as running
reports or querying the personnel database.
 Changes to user configurable reports, such as report titles and editable
fields.
 Changes to fields set by the system, even if based on user action, such as
the date of modification field in the Personnel Record dialog box.
 Purges of personnel records.
 Changes to badge setup.
 Changes to the bitmap file associated with each map. (The preceding
changes take place outside C•CURE 800/8000. Changes to the map
file name itself would be audited.)
 Changes where the C•CURE 800/8000 is part of a C•CURE Central
network, and the C•CURE 800/8000 records are altered by C•CURE
Central as follows:
• When you delete a server and reassign all records to a new home node.
• When external cards (cards that belong to another server home
node) with Card number 0 (zero) are deleted.
Before users can delete a server as their home node server, they must
choose a new home node computer to preserve personnel records as
described above. When a new home node is selected, the records on the
deleted server are assigned a new CID (computer ID) on the new home
node server. The records are the same but the CID for the record has
changed.
The CID for each personnel record on the deleted server, CID # 2000, is
CID #2000; the new server's CID is #2500. The personnel records from
the deleted server would therefore have #2500 as their CID instead of
#2000.

Changes Not Audited at the Field Level


Changes to the following are currently audited at the object level, not at the
field level:
 All reports
 Personnel View dialog box
 Configure Layout of Personnel Record Screen dialog box
 Color Setting dialog box (for setting Personnel dialog box color)
 Configure Import/Export Template for Personnel dialog box
 Import Asset Data dialog box
 Configure Import/Export Template for Assets dialog box
 Badge Setup dialog box

C•CURE 800/8000 Reports Guide 2–5


The Audit Trail Reporting Process
A single C•CURE 800/8000 System transaction encompasses the time
from when a top-level dialog box is opened until the OK button is clicked
in that dialog box. In between, many other dialog boxes can be changed.

Example:
You could bring up a specific controller/apC and create 30 new inputs
attached to the Controller/apC before pressing OK in the main
Controller/apC dialog box.
All the audit trail messages generated from this single transaction would
display in the audit log report as a group with the same date and time.

How Audit Trail Processes Deletions


When you delete an object, the audit trail not only records that deletion, but
also records changes to any other objects caused by that first deletion.

Example:
If a clearance is deleted, the audit messages record changes to all
personnel records which included that clearance.

How Audit Trail Displays Names


The audit log report displays the current name of all objects that were
changed, not their names at the time the audit was done—except for
personnel records that have the Temporary Record check box selected.

A special situation can also sometimes exist for those objects—such as


readers, inputs, and outputs—with defaults for the creation of their name.

Example:
The second reader on the third floor apC/8x panel 3rdFC1 would be
named 3rdFC1 apC:1 R2.

If a user had given such an object a non-default name, a field-level audit


report would show that the object’s name was changed from the default name
to a non-default name.
Example:
Reader 3rdF Rear added by Cindy on
chew2k Reader Name is “AAAdefault”
Reader name is changed from “AAAdefault” to “non-defaultBB name”

Default Values for Objects in Full Field-level Auditing


If you create a new object and change a default value in that record, audit trail
can give you two possible results:
 In the first case where the default value is removed before the record is
committed, the audit information will show no audit information about
the value of the field.
 In the second case where the changed default value is committed, the
audit information will show that the default value was created and then
modified.

It is possible to determine the history of values by simply comparing them


with the values of the default record of the appropriate object. In cases where
no audit information is shown for a given field, you can infer that the field’s
default value was removed prior to being saved. All subsequent changes to
any of the object’s values will be explicitly identified in the audit trail.
Generating a Journal Report

Generating a Journal Report


You can report on information in the historical journal—from the activity log
or the audit log or from both. You can also report on information in the event
incident logs.

To Generate a Journal Report

1. Select Reports from the C•CURE 800/8000 Administration application


menu bar and then click Journal>Journal Replay as shown in Figure 2-
1.

Figure 2-1: C•CURE 800/8000 Administration Application Journal Reports Menu

2. The Journal Replay dialog box appears with the General tab displayed,
as shown in Figure 2-2 on page 2-9. On this dialog box, you compose a
query for the time and date range you want to report on, select the result
options for your report, and select the type of journal report you want.

2–8 C•CURE 800/8000 Reports Guide


Figure 2-2: Journal Replay - General Tab
3. Provide the information in Table 2-1 on page 2-11 in the top section of the
dialog box when constructing a journal report.

NOTE If you want the system to process your query and display the report when
it finishes processing, select Display after replay completes in the
Results box. If you select this option, a popup box, which dynamically
indicates the number of records that have been processed, appears while
the system is processing. Choosing this option is the fastest way to
process journal replays. In addition, this Results option:
 Includes the NetVue video icon in a NetVue Activity message;
consequently, you can view the associated video segment (by clicking
on the icon). See “NetVue Activity Messages” on page 2-44.
 Makes the Display TreeView Incident option available, if the
Report incident logs option is selected as the Type of replay. See
“Viewing Journal Incident Reports” on page 2-46.

The Display while replaying option also allows you to Display results in
Excel.
Table 2-1: Journal Report Fields

Box Field/Button Description


Replay date/time range Start/End date Enter the starting and ending dates you want to report on in the
format mm/dd/yyyy.
NOTE: A journal option set on
the System Variables This information tells the system the journal file(s) from which to
dialog box lets you retrieve the information. If no date is entered, the default is to
restrict the number of report on all the entries in the current journal. The Start Date is
days back in time from when the system was built and the End Date is the current date.
the present during which
you can generate journal Start/End time Enter the starting and ending time of the information you want to
reports. It affects the report on in military format hh:mm. (The ending time includes
values you can enter in the first minute of the hour on zero seconds: hh:mm:00.)
the Start Date/End Date Example:
fields. Refer to “Defining
Journal Options” in the If the time specified for a journal replay is from 12:00 to
C•CURE 800/8000 12:15, a message logged into the journal at 12:15:01 is not
System Maintenance replayed.
Guide for information. This information tells the system where to look in the journal files
NOTE: If you are generating a for the information. If no time is entered, the default is to report
report on an Incident ID on all the entries in the current journal specified by date, if any.
that you entered in the
NOTE: The default End time is 23:59. Therefore, activity before
Incident ID field (not on
23:59 on that day is shown in the report.
an Incident group), the
Start date/time field is
populated with the date
and time from the
Incident occurred date/
time field in the Replay
activity messages for a
particular incident ID
box.

Time Zone Specify a time zone relative to the start/end time range of the
journal replay. In addition, all the dates/times displayed in the
journal replay are adjusted to conform to the selected time zone.
None, the default entry, means the local time zone of the Client
computer determines the journal entries.

Begin replay Click this button to begin the journal replay.


This button is not available if you select the Selected message
types, Selected security items, Selected personnel, or Selected
assets options and do not select individual message types,
security items, personnel, or assets.
Table 2-1: Journal Report Fields, continued

Box Field/Button Description


Results Display while Select this option to see every journal message as it is generated.
replaying
Click Stop in the Journal Report dialog box to pause system
processing so you can view the records that the system has
retrieved thus far. Resume system processing at any time by
clicking Continue, or terminate report processing by clicking
Close.
NOTE: This option does not include the NetVue video icon in a
NetVue Activity message; therefore, you cannot click the
icon to view the associated video segment. To see pre-
recorded video segments, select the Display after
Replay Completes option in the Results box in the
Journal Replay dialog box before generating the report.

This option makes the Display results in MS Excel


option available, allowing you to also export the report
directly to Excel.

Display after Select this option if you want the system to process your query
replay completes and display the report when it is finished processing.
When you select this option, a popup box appears on your
terminal while the system is processing the records. It indicates
the number of records that have been processed.
NOTE: This option allows the journal replay to be processed
faster. If you select this option, a popup box appears on
your terminal while the system is processing records. It
indicates dynamically the number of records that have
been processed. Choosing this option is the fastest way to
process journal replays.
In addition, this Results option includes the NetVue video
icon in a NetVue Activity message; consequently, you
can view the associated video segment (by clicking the
icon). See “NetVue Activity Messages” on page 2-44 for
more information.
This option makes the Display results in MS Excel option
unavailable.
If the Report incident logs option is selected as the Type
of Replay, this option makes the Display TreeView
Incident option available. The Tree View displays the
Incident ID log messages organized in an expandable tree
structure hierarchy.
Table 2-1: Journal Report Fields, continued

Box Field/Button Description


Results (cont) Language Specify the supported language in which you want the report to
appear.

Display results in Select this check-box to export journal reports to Excel. (Microsoft
MS Excel Excel must be installed on your computer).
This check-box is available when the Display while replaying
option and the Report activity log, Report audit log, Report
both activity and audit logs and the Report incident logs
options are selected.

Type of Replay Report activity log Select this option to replay journal messages only from the
activity log. If you select this option, the Audit trail and Incident
tabs are both unavailable. Then select report options on the
General tab. See “Creating Activity Reports” on page 2-15.

Report audit log Select this option to replay journal messages only from the audit
log. If you select this option, the Select message types for report
box on the General tab is unavailable, as well as the Incident tab.
Select report options on both the General tab and the Audit tab.
See “Creating Audit Reports” on page 2-19.

Report both Select this option to replay journal messages from both the
activity and audit activity log and the audit log. If you select this option, the
logs Incident tab is unavailable. Then select report options on both
the General tab and the Audit tab. See “Creating Activity
Reports” on page 2-15 and “Creating Audit Reports” on
page 2-19.

Report incident Select this option to replay all the activity message logs that
logs belong to a specific event incident number or a specific incident
group. Only activity logs directly related to the Incident ID or
incident group are replayed.
If you select this option, the General and Audit trail tabs are
unavailable and the Incident Occurred Date/Time field displays
on the Incident tab. Enter information on the Incident tab to
replay incidents, either entering a valid event Incident ID or
selecting an Incident group. See “Creating Incident Reports” on
page 2-25.
NOTE: The entry UseIncidentId in the Driver Section of the
CCURE Diag System must be enabled (set to 1) to use
this feature.
Table 2-1: Journal Report Fields, continued

Box Field/Button Description


Type of Replay (cont.) Report Select this option to replay all the activity messages logs that
Maintenance belong to Intrusion Zones in Maintenance Mode only.
Mode activity log
only

Include Select this option to include all activity messages from Intrusion
Maintenance Zones in Maintenance Mode.
Mode activity
Creating Activity Reports

Creating Activity Reports


There are four reporting categories for you to choose from for activity log
journal reports—all on the General tab:
 Message types
 Personnel
 Security items
 Assets (if you purchased the Asset Manager option)

Within each category, you can include all of the items or select the particular
ones you want.

Example:
You could include all the message types you are allowed to view, a
selected number of personnel, and only the iSTAR Controllers in
building 1. You can also select “No” security items, “No” personnel, and
“No” assets to exclude those activity log messages from the report.

The categories all work together. In order for an activity log message to be
displayed, it must match the criteria from each category which applies to it.
The selection of message types is the only one that applies to all activity log
messages, because every activity log message must include one message type.
Thus, all activity log messages displayed in a report must match the list of
selected message types. The other three reporting categories—personnel,
security items, and assets—are not necessarily present in each activity log
message. If an activity log message does not include any reference to a
particular reporting category, the message will still be displayed regardless of
what you selected in that category.

Example:
You select “card admitted” and “state change” message types, three
specific personnel, and all security items. The report will include card
admitted messages at all doors only for those people selected, but state
change messages for all security objects. Since the card admitted
messages contain references to both personnel and objects, admit
messages are based on both selections. State change messages do not
reference personnel because this type of message does not pertain to
them. Consequently, the state change messages ignore any personnel
selections.

C•CURE 800/8000 Reports Guide 2–15


NOTE You can run a journal activity report only on those message types and
security items that your monitoring user privilege allows you to see. In
addition, in a C•CURE 800/8000 with partitions, you can only view
messages that contain objects in your own partition and in any shared
partitions. Users who are partition administrators can view messages
containing objects in all partitions that they administer, dependent only
upon their monitoring user privilege. See “Configuring Partitions,” in the
C•CURE 800/8000 Software Configuration Guide and “Configuring
Monitoring Privileges” in the C•CURE 800/8000 Personnel Configuration
Guide for more information.

To Create an Activity Report

1. Fill in the information in the top of the Journal Replay dialog box as
described in “Generating a Journal Report” on page 2-8 and select the
Report activity log as the type of replay.

2. In the General tab, as shown in Figure 2-3 on page 2-17, select options
according to the information provided in Table 2-2 on page 2-17.
Figure 2-3: Journal Replay - General Tab for Activity Reports

Table 2-2: Journal Replay - General Tab Fields for Activity Report

Box Field/Button Description


Select message types for All allowed message Select this option to view all the messages your user privilege
report types allows you to report on. (This is the default.)

Selected message Select this option to specify the message types you want to report
types on. The Select message types button becomes available. See
“Making Selections for Activity/Audit Reports” on page 2-33.

Select message types Click this button to view the Journal Replay - Select Message
Types dialog box and select the specific message types for the
report. See “Making Selections for Activity/Audit Reports” on
page 2-33.

Select security items for All allowed security Select this option to view all the security items your user privilege
report items allows you to report on. (This is the default.)

No security items Select this option to exclude all messages containing security
items. (This option is usually not desirable for “activity only”
reports.)
Table 2-2: Journal Replay - General Tab Fields for Activity Report, continued

Box Field/Button Description


Selected security items Select this option to specify the security items you want to report
on. The Select security items button becomes available.
See“Selecting Security Objects for Activity and Audit Reports” on
page 2-34.

Select security items Click this button to view the Journal Replay - Select Security
Items dialog box and select the security items for the report. See
“Selecting Security Objects for Activity and Audit Reports” on
page 2-34.

Select personnel for report All personnel Select this option to view all personnel in your report. (This is the
default.)

No personnel Select this option to exclude all messages containing personnel.

Selected personnel Select this option to specify the personnel you want to report on.
The Select personnel button becomes available, and an empty
Records field also appears. This field displays the number of
personnel records selected once you have run your query. See
“Selecting Personnel for Activity and Audit Reports” on page 2-39

Include misread and Select this check box to include in the report, cards with parity
unknown cards errors and/or not yet assigned to a personnel record.

Select personnel Click this button to view the Personnel Query dialog box, shown
in Figure 2-10 on page 2-40, and select the personnel records
you want to report on. See “Selecting Personnel for Activity and
Audit Reports” on page 2-39.

Select assets for report All assets Select this option to view all assets that your user privilege allows
in your report. This is the default.
NOTE: These options are
unavailable if you No assets Select this option to exclude all messages containing assets.
have not
purchased the Selected assets Select this option to specify the assets you want to report on.
Asset Manager The Select assets button becomes available and an empty
software option. Records field also appears. This field displays the number of
asset records selected once you have run your query.

Select assets Click this button to view the Asset Query dialog box and select
the asset records you want to report on.
See the C•CURE 800/8000 Asset Manager Guide for more
information.
Creating Audit Reports

Creating Audit Reports


There are six reporting categories for you to choose from for audit log journal
reports—on both the General and the Audit Trail tabs:
 Personnel
 Allowable security items
 Assets (if you purchased the Asset Manager option)
 Users
 Types of changes made by users.
 Audit replay type

Within the first four categories, you can include all the items or select the
particular ones you want. You can also select “No” security items, “No”
personnel, and “No” assets to exclude those messages from the report.

Example:
You could include a selected number of personnel records, all the security
objects you are allowed to view, a selected number of users, and
modification and deletion changes to the configuration database.

The categories work together. A report displays all the journal audit
messages with the selected changes made by the selected users to the
selected personnel record(s), selected object(s), or the selected asset(s).

Example:
You select no personnel, all controllers and readers, five users,
modification audit changes, and field level audit type. The report will
include any audit message where any of those five system users modified
any iSTAR or reader in the configuration database, with the details of the
fields that they changed.

C•CURE 800/8000 Reports Guide 2–19


NOTE You can run an audit journal report on only those security items that your
monitoring user privilege allows you to see. In addition, in a
C•CURE 800/8000 with partitions, you can view only messages that
contain objects in your own partition and in shared partitions. However,
users who are partition administrators can view messages containing
objects in all partitions that they administer, dependent only upon their
monitoring user privilege. For more information, see “Configuring
Partitions,” in the C•CURE 800/8000 Software Configuration Guide and
“Configuring Monitoring Privileges,” in the C•CURE 800/8000 Personnel
Configuration Guide.

To Create an Audit Report

1. Fill in the information in the top of the Journal Replay dialog box as
described in“Generating a Journal Report” on page 2-8 and select the
Report audit log option as the type of replay.

2. In the General tab, as shown in Figure 2-4 on page 2-21, select options
according to the information provided in Table 2-3 on page 2-21.
Figure 2-4: Journal Replay - General Tab for Audit Reports

Table 2-3: Journal Replay - General Tab Fields for Audit Reports

Box Field/Button Description


Select security items for report All allowed Select this option to view all the security items your user privilege
security items allows you to report on. (This is the default.)

No security items Select this option to exclude all messages containing security
items.

Selected security Select this option to specify the security items you want to report
items on. The Select security items button becomes available. See
“Selecting Security Objects for Activity and Audit Reports” on
page 2-34.

Select security Click this button to view the Journal Replay - Select Security
items Items dialog box and select the security items for the report. See
“Selecting Security Objects for Activity and Audit Reports” on
page 2-34.
Table 2-3: Journal Replay - General Tab Fields for Audit Reports, continued

Box Field/Button Description


Select personnel for report All personnel Select this option to view all personnel in your report. (This is the
default.)

No personnel Select this option to exclude all personnel from your report.

Selected Select this option to specify the personnel you want to report on.
personnel The Select personnel button becomes available, and an empty
Records field also appears. (This field displays the number of
personnel records selected once you have run your query.) See
“Selecting Personnel for Activity and Audit Reports” on
page 2-39.

Include misread Select this check box to include in your report, cards with parity
and unknown errors and/or not yet assigned to a personnel record.
cards

Select personnel Click this button to view the Personnel Query dialog box, shown
in Figure 2-10 on page 2-40, and select the personnel records
you want to report on. See “Selecting Personnel for Activity and
Audit Reports” on page 2-39.

Select assets for report All assets Select this option to view all assets in your report. This is the
default.
NOTE: These options are
unavailable if you have No assets Select this option to exclude all assets from your report.
not purchased the
Asset Manager Selected assets Select this option to specify the assets you want to report on.
software option. The Select assets button becomes available, and an empty
Records field also appears. This field displays the number of
asset records selected once you have run your query.

Select assets Click this button to view the Asset Query dialog box and select
the asset records you want to report on.

3. Click the Audit Trail tab, as shown Figure 2-5 on page 2-23, and
select report options according to the information in Table 2-4 on
page 2-23.
Figure 2-5: Journal Replay - Audit Trail Tab

Table 2-4: Journal Replay - Audit Trail Tab Fields

Box Field/Button Description


Select types of Creation Select this option to include the creation of security objects and
changes made by personnel records in the journal report.
users
Deletions Select this option to include the deletion of security objects and
personnel records in the journal report.

Modifications Select this option to include the modification of security objects and
personnel records in the journal report.
Table 2-4: Journal Replay - Audit Trail Tab Fields, continued

Box Field/Button Description


Audit type of replay Display audit field Select this option to include in the Journal Replay changes made to
details the specific fields within the security object’s configuration and the
personnel record. If this box is cleared, the changes tracked in the
Journal Replay will only be at the object level. See “Changes Not
Audited at the Field Level” on page 2-5 for more information.
NOTE: To have field change details included in your Journal Replay
Audit Report, you must have set the option on the
C•CURE 800/8000 System Variables Auditing tab and
then have started the system driver, prior to the changes in
question. The system only audits changes at the field level
once the foregoing has been done. See the
C•CURE 800/8000 System Maintenance Guide for more
information.

Select users who have All users Select this option to replay changes made to the configuration
made changes database by all system users. This is the default.

Selected users Select this option to only replay changes made by certain users.
The Select users button becomes available. See “Selecting Users
for an Audit Report” on page 2-41.

Select personnel Click this button to view the Journal Replay - Select users dialog
box, shown in Figure 2-11 on page 2-42, and select the specific
users for the report. See “Selecting Users for an Audit Report” on
page 2-41.
Creating Incident Reports

Creating Incident Reports

Incident Tracking Overview


C•CURE 800/8000 journal reports track the history of all monitored
activities and activity messages for inputs (alarm points) and/or events
labeled with the Incident ID, if this functionality has been enabled for your
system.

NOTE By default, Incident ID functionality is not enabled.

To enable Incident ID

1. Select the UseIncidentId Entry in the Driver section of the Ccure.ini


file, accessed through the Diag Systems utility

2. Set the Entry Value to 1 (one).

3. Restart the driver if it is running.

For more information, see the Diag System help.

The Incident tab in the Journal Replay dialog box allows you to replay event
messages and log messages for either of two types of Incident IDs described
in the following sections:
 A particular incident group
 A particular event incident

An Incident ID is a unique number generated by C•CURE 800/8000. It


consists of two parts separated by an underscore and is guaranteed to be
unique:

Example:
499796920_2821
 The first digits before the underscore are the number of seconds since
January 1, 1990 (GMT).
 The four digits after the underscore are:
• For an incident group, the incident group object ID.
• For an event not in an incident group, the event object ID.

C•CURE 800/8000 Reports Guide 2–


Incident Groups
An Incident Group allows you to group inputs and events together. You
configure Incident Groups from the C•CURE 800/8000 Administration
application menu, Configure>Group>Incident Group. See the
C•CURE 800/8000 Software Configuration Guide for more information.

Incident Groups can consist of the following:


 One or more inputs
 One or more events
 A combination of the preceding two elements

Once an Incident Group is created, and an input (alarm point) or an event


inside of the group changes state, a unique Incident ID is created for the
group. This ID is also maintained and tagged (or labeled) to all the
monitored activities and activity messages that are part of the group. During
this change of state, if other inputs or events inside of the group also change
state, they are labeled with the same Incident ID established by the initial
activation.

The Incident ID is also tagged to monitored activities and activity messages


for inputs when the following inputs are generated:
 Regular inputs
• Input activates
• Input deactivates
• Input supervision errors.
 Door Switch Monitor (DSM) input for a door
• Door forced open active
• Door held open active
• Door close (the inactive state for both door forced and door held)
• Supervision error for DSM input used by a door
 Request to Exit (RTE) input for door:
• Supervision error for RTE input used by door
NOTE To ensure that all monitored activities and activity messages tagged with
the Incident ID are sent to both the Monitoring Station and the Journal,
the Send state changes of this event to monitoring station and Send
state changes of this event to journal check boxes on the Event dialog
box and the Send state changes to monitoring station and Send state
changes to journal check boxes on the Input dialog box must be selected.

The unique Incident ID is reused within an Incident Group until both the
following parameters are met:
• All events inside of the group are fully acknowledged and cleared.
• All monitored activities of inputs change from an active state to an
inactive state.

When the driver is restarted, a new Incident ID is issued to an Incident Group.


Example:
• Incident Group A contains Input X.
• Input X changes its state; the Incident ID tags to activity messages
for this Input.
• The driver is restarted while Input X is still active. A new Incident ID
is issued and tagged to new activity messages for Input X.

Incident Group Example:


Guard Station Activities with Incident ID with Two Phase Acknowledge and Clear

 Preconditions:
• Incident Group A contains Input 1 and Event B.
• Input 1 is configured to activate Event B when Input 1 is active.
 Action:
• Input 1 is activated to trigger Event B to activate.
• Input 1 is deactivated.
• Event B is acknowledged.
• Event B is cleared.
• Input 1 is activated to cause new Incident ID.
 The monitored activities and the message activities are generated with
their tagged Incident ID as follows:
12:02:15 [12:02:16] Input 1 activated [Incident 499712535_2820]
12:02:15 Event B activated [Incident 499712535_2820]
12:02:15 [12:02:16] Input 1 deactivated [Incident 499712535_2820]
12:02:23 Manual action by Smith, Anne: acknowledge Event B [Incident
499712535_2820]
12:02:16 Event B deactivated [Incident 499712535_2820]
12:02:23 Manual action by Smith, Anne: clear Event B
[Incident 499712535_2820]
12:04:25 [12:04:26] Input 1 activated [Incident 499712601_2820] new
incident
12:04:25 Event B activated [Incident 499712601_2820]

NOTE If you open a closed event from the Monitoring Station Activity or Event
Monitor to add a new log message to it, the Review Event dialog box
displays the Incident ID for the most recent occurrence of the event,
instead of the Incident ID for the event occurrence to which you are
adding the message.

Example:
In the preceding Incident Group Example, if at 12:04:26 you opened
the Event B occurrence activated at 12:02:15 and deactivated at
12:02:16 to log an important new message, the Incident ID that
displays on the Review Event dialog box—and that will be attached
to the log message—will be Incident 499712601_2820 for the most
recent occurrence of Event B, instead of Incident 499712535_2820.
Event Incident
An incident is a series of alarm instances and other related actions grouped
together for reporting purposes. An Incident ID is a unique number that
denotes a series of event activities starting when the event is activated and
ending when the event is deactivated and has no active causes.

If the event is configured for acknowledgment, the Incident ID ends when the
event satisfies all the following conditions on the Monitoring Station and is:
 Deactivated
 Acknowledged
 Cleared
 Has no active causes

After an event incident ends, its Incident ID is still kept on the Monitoring
Station Event Status dialog box until the event becomes active with a new
active cause. As long as an event does not become active again, all messages
logged to it still retain the previous Incident ID. This applies to all three types
of event activation:
 Permanent activation
 Momentary activation
 Latching event

During an event’s activation period, any other related activity messages are
assigned the same Incident ID. The activity messages included are
 Event acknowledgements
 Event clears
 Event acknowledgements overdue
 Event resets
 Event log messages—including acknowledgement and clear messages
 Event re-activations
 Event deactivations
An Incident ID can have multiple causes. If the same event is activated by
some other cause during its activation period, a new Incident ID is not
assigned. The event still keeps the Incident ID of the earliest active cause, as
long as the event is still active.

Event activations get new Incident IDs when the driver is restarted.

Example:
If a manual action activates an event from 8 a.m. to 12 p.m and the driver
is stopped and restarted at 10 a.m., the event activation at the restart of
the driver gets a new Incident ID. However, if a panel event is no longer
active, but still needs acknowledgement or clearing, it keeps the same
Incident ID after the driver is restarted.

To Create an Incident Report

1. Fill in the information in the top of the Journal Replay dialog box as
described in“Generating a Journal Report” on page 2-8 and select the
Report incident logs option as the type of replay.

2. Click the Incident tab on the Journal Replay dialog box, as shown in
Figure 2-6 on page 2-31 and enter information according to Table 2-5 on
page 2-32.
Figure 2-6: Journal Replay - Incident Tab

NOTE You can not run the same incident log report for both an event Incident
ID and an incident group. The Incident ID and Incident Group fields are
mutually exclusive.
Table 2-5: Journal Replay - Incident Tab Fields

Box Field/Button Description


Replay activity Incident ID Enter an Incident ID or copy and paste the ID from the Monitoring
messages for a Station as follows.
particular incident ID
1. Copy the Incident ID from the Incident ID field on either of two
Monitoring Station dialog boxes: the Event Status dialog box
or the Review Event dialog box.
 Select the Incident ID and right-click the mouse.
 Select Copy from the popup menu.
2. Paste the Incident ID into this Incident ID field on the
Administration application Journal Replay Incident tab.
 Place the cursor in this field and right-click the mouse.
 Select Paste from the popup menu.
NOTE: If you enter the Incident ID in the wrong format, the system
displays an error message. A valid Incident ID contains an
underscore between two numbers.

Incident This read-only field appears on the Incident tab when you select
Occurred Report incident logs as the Type of Replay, but is empty until you
Date/Time enter the Incident ID in the previous field and move the cursor out
of the field.
The system then calculates the incident starting date\time and
displays it in this Incident Occurred Date/Time field. This starting
date\time value is also entered in the Start Date/Time field in the
Replay Date/Time Range box in the top of the Journal Replay
dialog box. (The Start Date\Time field previously displayed the time
when the first journal message was stored in the current journal
volume.) The new value becomes the date and time from which the
system retrieves the incident ID log messages from the journal
file(s) when you click Begin Replay.
NOTE: Journal replay for incident log reporting respects partition
privileges. If journal replay user A is not in the same
partition as the Monitoring Station user B who
acknowledges events and user A does not have privileges
to see user B’s partition, incident log journals replayed by
user A do not show acknowledgements by user B.

Replay activity Incident Group Enter an incident group name or double-click in this field to select a
messages for a group from the Incident Group Selection browser. Your journal
particular incident replay will include only incident activities associated with the
group selected Incident group.
Making Selections for Activity/Audit Reports

Making Selections for Activity/Audit Reports

Selecting Messages for an Activity Report


You can select the types of messages you want to include in your report from
those messages your monitoring privilege allows you to see. This option only
applies to journal activity reports.

NOTE In a C•CURE 800/8000 with partitions, you can view only messages that
contain objects in your own partition and in shared partitions. If you are
a partition administrator, you can view messages containing objects in all
partitions that you administer, dependent only upon your monitoring
user privilege.

See “Configuring Monitoring Privileges” in the C•CURE 800/8000


Personnel Configuration Guide for information.

To Select Allowable Message Types

1. On the General tab of the Journal Replay dialog box, select the Selected
message types option and then click Select message types.
The Journal Replay - Select Message Types dialog box appears, as
shown in Figure 2-7 on page 2-34. This dialog box permits you to specify
which message types you want to appear in your report.

C•CURE 800/8000 Reports Guide 2–


Figure 2-7: Journal Replay - Select Message Types Dialog Box

2. In the Available message types box, highlight messages for the report
and click the Add button, or double-click the messages. The messages
move to the Selected message types box.

3. To deselect message types, in the Selected message types box, highlight


the messages and click the Remove button, or double-click the message.
The messages move to the Available message types box.

TIP You can highlight a range of message types to add or remove by holding
down the SHIFT key and clicking the first and last items you want. You
can also add or remove all message types by clicking the Add All or
Remove All buttons.

4. When you are finished making your selection, click Close. The Journal
replay dialog box reappears.

NOTE If you have the Asset Manager option, the Available message types box
includes Asset Message types.

Selecting Security Objects for Activity and Audit Reports


You can select the security objects for your report from those items your
monitoring privilege allows you to see.
The list of security items to select from the Journal Replay - Select Items
dialog box includes all the objects in the database that can be created,
modified, or deleted. Some of these objects, such as “System Variables,” only
appear in audit log messages, not in activity log messages. If the
C•CURE 800/8000 is partitioned, the dialog box displays only objects from
your partition and any shared partitions, with one exception. If you are a
partition administrator, the dialog box displays objects from all partitions that
you administer. See the C•CURE 800/8000 Software Configuration Guide for
more information about partitioning.

To Select Allowable Security Items

1. On the General tab of the Journal Replay dialog box, select the Selected
security items option and then click Select security items.
The Journal Replay - Select Items dialog box appears, as shown in
Figure 2-8 on page 2-35.

Figure 2-8: Journal Replay - Select Items Dialog Box

From this dialog box you can specify which of the system security objects
you want to appear in your report.
2. In the Type list box, select a security object type, such as apC, from the
drop-down list.
3. Below the Type list box, select an option button that specifies the items
to be displayed in the Select Items box.
Example:
If you selected apC in the Type list box, select the apC option to
display a list of configured apCs in the box, or select apC Group to
display a list of apC groups in the box.
If you select a group option, $All xxx (where xxx equals the type of
object), is displayed in the Select Items box. $All xxx is a group that
contains all the currently-configured individual objects and group
objects of the selected type. $All xxx is dynamically updated to include
new objects when they are created. If C•CURE 800/8000 is partitioned,
selecting $All xxx means selecting all objects only in your partition and in
any shared partitions. See the C•CURE 800/8000 Software Configuration
Guide for more information about partitioning.
If you selected Door in the Type list box and moved doors or door groups
to the Selected Items box (as described in Step 4 below), an Access
Direction box appears on the bottom right of the Journal Replay - Select
Items dialog box, shown in Figure 2-9 on page 2-38. See “To Select Bi-
directional Doors and a Door Direction for Activity Reports” on page 2-37
for information about this box.

4. You select objects and groups for your report by moving them from the
Select Items box to the Selected Items box.

A Wildcard search can be used to search for a specific object or group. See
NOTE “Using Wildcard Search” on page 1-5 for more information and examples.

Use the following methods to move selected objects:


• To move individual objects or groups, highlight the object or group
and click Add, or double-click the item. The item moves to the
Selected Items box.
• To move all objects and groups, click Add All. $All (all objects and
groups) is moved to the Selected Items box.

NOTE If your monitoring privileges or partitioning restrictions do not allow you


to view all objects of this type, when you select Add All, only the allowed
objects and groups will be selected, not the ‘$All group.’

5. You deselect items for the report by removing them from the Selected
Items box. Use the following methods:
• To remove individual objects or groups, highlight the object or group
and click Remove, or double-click the item. The items are removed
from the Selected Items box.
• To remove all objects and groups of all types, click Remove All. All
objects and groups for all types of security items are removed from the
Selected Items box.

6. When you are finished making your selection, click OK. The Journal
Replay dialog box reappears.

To Select Bi-directional Doors and a Door Direction for Activity Reports

1. When you highlight doors or door groups in the Selected items box, an
Access direction box appears on the bottom right of the Journal Replay
- Select Items dialog box, as shown in Figure 2-9 on page 2-38.

NOTE Wildcard search can be used to search for a specific Door or Door Group.
See “Using Wildcard Search” on page 1-5 for more information and
examples.
Figure 2-9: Journal Replay - Select Items Dialog Box

This box allows you to specify the door direction for which you want
access messages to appear in your report. The choices are:
• IN and OUT (the default)
• IN
• OUT
• Neither IN nor OUT

2. In the Selected items box, select the door you want and then click the IN
and/or OUT checkbox(es) in the Access direction box.
The text for the door and door group item in the Selected items box in
the Type column changes depending on the access direction you selected
in the Access direction box.
If neither the IN nor OUT check box is selected, no access messages are
included in the journal replay. If at least one check box (either IN or
OUT) is selected, access messages with the selected direction, as well as
all access messages with unknown directions, are included in the journal
replay.

Selecting Personnel for Activity and Audit Reports


You can determine which personnel information to include in a report. The
report includes all journal messages that reference personnel you specify in
your personnel query. For activity reports, you can report on such things as
accesses, rejects, manual actions, logins, and logouts for those personnel
records. For audit reports, you can report on any configuration changes made
to those personnel records in the database.

NOTE If C•CURE 800/8000 is partitioned, you can only select personnel from
your own partition and any shared partitions, with one exception.
Partition administrators can select personnel from all partitions that they
administer. See the C•CURE 800/8000 Software Configuration Guide for
more information. If you have set the system option for partitioning with
global clearance assignment, see “Defining Personnel Options” in the
C•CURE 800/8000 System Maintenance Guide for more information.

To Select Personnel

1. On the General tab of the Journal replay dialog box, select the Selected
personnel option and then click Select personnel.
The Personnel Query dialog box appears, as shown in Figure 2-10 on
page 2-40.
Figure 2-10: Personnel Query - General Tab

NOTE Your personnel view determines the layout of the Personnel Query dialog
box. The preceding figure shows the Personnel Query dialog box from the
$System Person View. If you are using another view or are using a
partitioned system, the Personnel Query dialog box that opens for you
may look different. See “Configuring Personnel Views” in the C•CURE
800/8000 Personnel Configuration Guide for more information.

2. Specify search criteria for your query, just as you would when querying
the Personnel data table. Follow the procedure detailed in Step 6
on page 1-35.

3. Select one of the following query options


• Existing Records to query existing records only
• Deleted Records to query deleted records only
• All Records to query both existing and deleted records
4. Once you have selected the personnel information criteria for your
query, click Do Query. The Personnel Query in Progress dialog box
opens. This dialog box displays the number of personnel records being
retrieved by the query. If your personnel database is very large and the
query is taking too long, you can cancel it by clicking the Stop Query
button.
When the system either finishes retrieving records or stops the query, the
Journal replay dialog box reappears. This dialog box displays the query
results in the Records selected field: the total number of personnel
records found in the database that met your criteria or the number of
records found before you clicked Stop Query.

NOTE If your system is partitioned, query results are restricted to personnel


records in your own partition and in any shared partitions. If you are a
partition administrator, query results include personnel in all partitions
that you administer. If you have set the system option for partitioning
with global clearance assignment, see “Defining Personnel Options” in the
C•CURE 800/8000 System Maintenance Guide for more information.

Selecting Users for an Audit Report


You can select the system users you want to include in your report.

To Select Users

1. On the Audit tab of the Journal replay dialog box, select the Selected
users option and then click Select users.
The Journal Replay - Select Users dialog box appears, as shown in
Figure 2-11 on page 2-42.
Figure 2-11: Journal Replay - Select Users Dialog Box
.

This dialog box includes all system personnel who are or have ever been
users and permits you to specify which users you want to appear in your
report.

NOTE If C•CURE 800/8000 is partitioned, the Available users box displays


only users from your own partition and any shared partitions, with one
exception. If you are a partition administrator, the box displays system
users from all partitions that you administer. See the C•CURE 800/8000
Software Configuration Guide for more information about partitioning.

2. In the Available users box, highlight users for the report and click the
Add button, or double-click the users. The users move to the Selected
users box.

3. To deselect users, in the Selected users box, highlight the users and click
the Remove button, or double-click the users. The users move to the
Available Users box.

You can add or remove all users by clicking the Add All or Remove All
TIP
buttons.

4. When you are finished making your selection, click Close. The Journal
replay dialog box reappears with the number of users that you selected
displayed in the dialog box.
Running a Journal Report

Running a Journal Report


When you are finished specifying your report criteria, click Begin replay. The
system generates your report and the Journal report dialog box appears, as
shown in Figure 2-12 for activity log and audit log reports. For information on
running and viewing incident activity reports, see “Viewing Journal Incident
Reports” on page 2-46.

Figure 2-12: Journal Report Viewer with Activity Log and Audit Log Messages

The Journal report shown above includes both activity log messages and
audit log messages.

Activity log messages, as shown in the following example, can display two
dates/times—the first is the date/time when the activity happened at the apC
(or controller, not shown); the second, displayed in brackets, is the date/time
when the message was received by C•CURE 800/8000.

Example:
09/09/2010 11:23:56 [09/10/2010 10:00:00] Apc 1 communication failure

C•CURE 800/8000 Reports Guide 2–


Audit log messages, as shown in the following example, display only a single
date/time—the date/time when C•CURE 800/8000 processed the change to
the data. Notice that “on DANB” indicates the name of the node on which the
audit took place. If the change was made by an import of data rather than a
normal edit at the C•CURE 800/8000 Administration application, the entry
would have “[Import]” appended to the end of the message.

Example:
10/06/2005 10:16:35 Reader “Test apC apC:1 R3” added by King, Mr Jay on DANB

If you have opted to use field-level audit, the journal replay messages
indicate the changes made at the field level as well as at the object level. A
message displays “User modified” when Partition Administrator for
Selection Partition is added due to the full audit feature.

Example:
12/15/2006 14:22:15 Person King, Jonathan modified by Smythe, Winslow (import)
Expiration date has been changed from 11/22/2003 to 12/22/2004

If the date range you entered on the Journal Replay dialog box includes
NOTE
missing journal volumes, a message appears saying that journal volumes
are missing and giving the missing volume numbers.

The Status bar at the bottom of the C•CURE 800/8000 dialog box
dynamically displays the status of the replay process: for example,
Searching, Processing, Paused, and Done.

You can print your report or save it to a file. See “Printing and Saving a
Report” on page 1-22, for further information.

NetVue Activity Messages


NetVue segments are tracked in the C•CURE 800/8000 journal. When you
include NetVue Activity message types in a journal replay and select the
Display after Replay Completes option in the Results box in the Journal
Replay dialog box, messages, similar to the example shown in Figure 2-13 on
page 2-45, appear in the report.
Figure 2-13: Journal Report Viewer Showing NetVue Activity Messages

To View the Associated Video Segment


1. Click the NetVue Camera icon to the right of the message, as shown in
Figure 2-13.
2. The NetVue Player screen appears displaying the pre-recorded video
segment.

NOTE For NetVue journal replay:


 The availability of the journal video segment depends upon the
capability of the Digital Video Server.
 For journal replay of NetVue to work properly, you must enable
Active-X on your system.
 If the video segment is no longer available on the Digital Video
Management Systems, a message displays.
 Only one NetVue player with a pre-recorded video segment can
display at a time.
Viewing and Displaying Journal Replay Report Results in Microsoft Excel
If you select the Display in MS Excel check box on the Journal Replay dialog
box, your report displays in Excel.

NOTE Microsoft Excel must be installed on your system to view results in Excel.

See the Microsoft Excel help for help information.

Viewing Journal Incident Reports


You have several options for displaying the incident report on the Journal
Report Viewer.

To View the Messages in Regular Journal Activity Mode

1. In the Results box, select the Display while replaying option.

2. Click Begin replay.


The results appear as shown in the example for an incident event report
in Figure 2-14 on page 2-47 and the example for an incident group report
in Figure 2-15 on page 2-47.
Figure 2-14: Journal Report Viewer with Incident Report – by Incident ID

Figure 2-15: Journal Report Viewer with Incident Report – by Incident Group
To View the Incident Report in a Tree Structure

1. In the Results box, select the Display after replay completes option
and then select the Display TreeView Incident Report check box.

2. Click Begin replay.


The results appear as shown in the example in Figure 2-16 for the same
incident event report and in the example in Figure 2-17 on page 2-49 for
the same incident group report.
Within the incident, the entries are sorted in reverse chronological order.

Figure 2-16: Journal Incident Report in Tree View – by Incident ID


Figure 2-17: Journal Incident Report in Tree View – by Incident Group

To View the Messages in Microsoft Excel

1. In the Results box, select the Display while replaying option and
then select the Display in MS Excel check box.
2. Click Begin replay.

The results are displayed in Excel. See the Microsoft Excel help for more
information.
3

Configuring Enhanced Reporting

This chapter describes the C•CURE 800/8000 Enhanced Reporting

feature. In this chapter


 Overview..........................................................................................................3-2
 Creating a DSN for the Enhanced Reporting Database...........................................3-7
 Journal Export Overview.........................................................................................3-10
 Journal Export Database Schema...........................................................................3-14
 Configuring Journal Export in the Administration Application............................3-19
 Running Enhanced Reports....................................................................................3-29

C•CURE 800/8000 Reports Guide 3–1


Overview

Overview
The C•CURE 800/8000 Enhanced Reporting feature provides:
 Easier access to the valuable data stored in C•CURE 800/8000 journals.
 Pre-configured reports to address specific reporting needs.
 Ability to customize additional reports.

The enhanced reporting feature provides an add-on reporting module to


C•CURE 800/8000, which de-normalizes and exports Progress Journal data
to an external reporting database.

Crystal Reports is used as the reporting engine to provide predefined reports.


However, you can use any ODBC-compliant third-party data analysis tool,
such as, Excel, Crystal Reports, Actuate, and Access.

NOTE The C•CURE 800/8000 system includes a utility to update an existing


Enhanced Reporting Database for Multiple Card or Government Card
compatibility. If you have an existing Journal Export Database which you
have not yet updated and are using Multiple Cards or Government Cards,
you should run the Enhanced Reporting Database Conversion Utility after
upgrading to the current release, but before running any enhanced
reports. See the C•CURE 800/8000 Installation Guide for more information.
Definitions, Acronyms, and Abbreviations
 Crystal Reports – Crystal Reports is a third-
party report generation tool. It accesses
databases via ODBC and can be used to design
and administer reports.
 Journal Export Database – This is the Database
that contains the extracted journal data, also
referred to as the Enhanced Reporting database.
 Data Extraction Service – Independent process
that extracts data from the current journal
databases and dumps the data into the Journal
Export database. The Data Extraction Service is
also referred to as the Journal Export Service
and runs as a Windows service.
Journal Export Service
The C•CURE 800/8000 Journal Export Service extracts data from the
current journal databases and exports the data to the reporting database, as
shown in Figure 3-1.

Figure 3-1: Exporting Journal Data to a Reporting Database

C•CURE 800/8000 Reports Guide 3–3


Enhanced (Crystal Reports) Reporting Interface
Crystal Reports is integrated with C•CURE 800/8000 as shown in Figure 3-2.

Figure 3-2: Crystal Reports Integration

Crystal Reports is the platform for all reports developed by Software House
using the Enhanced Reporting feature. The current version of
C•CURE 800/8000 installs the royalty-free runtime version of Crystal
Reports software.

The user interface to the reporting environment is through the


C•CURE 800/8000 Administration application, which enables you to specify
report parameters and initiate reports.

The current version of the C•CURE 800/8000 Enhanced reporting feature


allows you to:
 Configure reports.
 Schedule reports via the Windows scheduler utility.
 E-mail the results of a scheduled report to an e-mail address.
 Print the report results to a specific printer.
 Produce predefined reports in Microsoft Excel.
Microsoft Excel must be installed on the system to view the reports in
Excel.
 Export the report results, whether the report was generated
automatically or manually, to different file formats:
• pdf — Adobe Acrobat Reader
• doc — Microsoft Word (Document Format)
• rtf — Microsoft Word (Rich Text Format)
• rpt — Crystal Reports
• txt — Notepad
• html — Hypertext Markup Language (Can be viewed in Notepad)
• xml — Extensible Markup Language (Can be viewed in Notepad)
• xls — Microsoft Excel
 Save report templates.
 Save batch reports (either the same or different versions) in
different folders at runtime.
 Include PID, card number, Text1, and Int1 fields in the database as
identifiers.
 Store cardholder name in Journal table entries, which lets you
handle temporary cards.

The following predefined report types are currently available:


 Admitted Access by Door Group and Admitted Access by Door
• Reports on doors with admitted accesses greater than the user-
specified threshold.
 Input Activation by Input Group and Input Activation by Input
• Reports on inputs that have activated more than the user-specified
threshold.
 Rejected Access by Door Group and Rejected Access by Door
• Reports on doors with rejected access attempts greater than the
user- specified threshold.
 Time and Attendance
• Reports on amount of time a person spent in an area or facility.

Report Customization
The predefined reports provided with the current version of
C•CURE 800/8000 are not customizable. You can specify parameters for
the reports, such as selecting readers, or start and end date/time, but
cannot modify the report format or any aspect of the data collection of the
report.
If you want to create customized reports, you must purchase a third-party
reporting tool such as Crystal Reports, Excel, Actuate, Access, or similar
application.
The Administration’s reporting interface allows you to add any reports
that you have customized (using a third-party reporting tool) to the
custom reports folder. You can then run any of these reports based on
data collected via the journal export.
Creating a DSN for the Enhanced Reporting Database

Creating a DSN for the Enhanced Reporting Database


To export int1 and text1 fields of the personnel database without having to
specifically export personnel data, you can create a new DSN,
“CUSTFIELDS”.

To Create a New DSN

1. Go to Control Panel >Administrative Tools>Data Sources


(ODBC)>System DSN. The OBDC Data Source Administrator dialog
box opens, shown in Figure 3-3.

Figure 3-3: System DSN Tab

C•CURE 800/8000 Reports Guide 3–7


NOTE If your C•CURE 800/8000 server is running on a 64-bit Windows
Operating System, you must use the 32-bit version of the ODBC Data
Source Administrator tool (because the C•CURE 800/8000 server is a
32- bit program).

Run the 32-bit version of the Odbcad32.exe file located in the


%systemdrive%\Windows\SysWoW64 folder rather than the Control
Panel > Administrative Tools > Data Sources ODBC selection.

If you use the default, Control Panel 64-bit ODBC Data Source
Administrator, any System DSNs you define will not be accessible to the
C•CURE 800/8000 server.

For more information, see the following Microsoft Knowledge Base


article: http://support.microsoft.com/kb/942976.

2. Click Add. The Create New Data Source dialog box opens, shown in
Figure 3-4.

Figure 3-4: Create New Data Source Dialog Box

3. Select Progress OpenEdge 10.2A Driver and click Finish. The


ODBC Progress OpenEdge Wire Protocol Driver Setup dialog box
opens, shown in Figure 3-5 on page 3-9.
Figure 3-5: OpenEdge Driver Setup Dialog Box

4. Enter all relevant information in the dialog box and click Apply.

5. Click OK.

6. Restart the C•CURE 800 driver once the configuration is completed.


Journal Export Overview

Journal Export Overview


This overview describes how journal export works from beginning to end.
However, before you can create predefined and custom journal reports, you
also need to be familiar with the following information:
 “Journal Export Database Schema” on page 3-14 – contains information
about Journal Export Database Schema and Journal Export Message,
Journal Export Database Tables, Export Journal Database Users, and
Table Field Name Standards.
 “Using the Progress Administration Service for Journal Export” on
page B-2 – contains information on the Progress utility used for database
administration.
 “Scheduling Reports to Run” on page 3-48 – describes the scheduling
of reports, such as Time and Attendance.
 “Re-initializing the C•CURE Journal Export Database” on page B-5 –
describes how to re-initialize the journal export database.
 “Initializing a Second C•CURE Journal Export Database” on page B-6 –
describes how to initialize a second export journal database.

Journal Export Scheduling


The Journal export service is controlled by the C•CURE 800 driver. As soon
as the current time is within the period when the journal export is scheduled
to run, and the journal export object is online, the export service begins
running. If the export service is scheduled to run all the time, it starts
running as soon as the driver startup is complete. The journal export service
continues to run until all journal messages requested are exported.

NOTE The journal export finishes exporting all messages even if that means
continuing to run after it is no longer within the scheduled runtime. When
the C•CURE 800 driver shuts down, so does the journal export.

Once the journal export finishes exporting all desired messages, it goes to
sleep for the export wait time—the amount of time specified in the Export
every hh:mm during time spec field on the Configure Journal Export
Scheduling tab. It then wakes up and exports any new journal records that

3–10 C•CURE 800/8000 Reports Guide


have come in since the last export. This continues while the time specification
to export data is active. The export stops when it is outside the time
specification.

If your journal export is within the time period when it is scheduled to run,
but is waiting to run until the wait period has expired, you can force it to run
immediately by doing the following:
1. Taking it offline.

2. Saving it.

3. Putting it back online.


4. Saving it again.

You can also force the journal export to end its current export run by putting
it offline.

If for any reason the journal export service gets an error when trying to access
the export database, it stops the export and waits until the export wait time
has passed, before starting to run again.

NOTE C•CURE 800/8000 does not support multiple journal exports to the same
database.

How Selection Criteria are Applied


The journal export object selects messages based on the entries in the
following fields on the Configure Journal Export dialog box:
 The Name of user “whose monitoring privilege will be used for filtering”
field on the Setup tab.
 The Ignore messages older than field on the Scheduling tab.

These entry values are saved when the journal export run is first started. If
you change these values, the changes do not go into effect until the current
journal export run has finished and the next run started.

In addition, the journal export operates on the principle that journal


records that have already been exported are never changed:
 Consequently, any changes made to the selection criteria apply only to
future journal messages (after the next scheduled journal export run
starts), never to existing journal messages.
 To make a change to the selection criteria that applies to all records,
erase your journal export database and start the export over from the
beginning.

Journal Export Service Operation


1. When the journal export starts running, it first checks to see if there is
a request to “erase the database.”
• If such a request has been issued, the journal export then checks
whether or not there are fewer than 1,000,000 records in the
exported database:
– If there are fewer than that number of records, all existing data in
the database is erased and a message entered in the journal when
the erase completes.
– If there are more than that number of records, the erase is not done
(since it would take too long—with 1,000,000 records in the
database, an erase can take up to a few hours), but an error message
is put into the journal.
Once a successful erase has been done, the journal export goes to sleep
for the export wait time period and then wakes back up.

NOTE A database with a CC8X_Journ.d1 file larger than approximately 500 MB


is likely to have more than 1 million records in it.

2. The journal export finds all those records that satisfy the selection
criteria, but have not yet been exported. It begins to extract these records
out of the journal, reformat them, and put them into the journal export
database. This process continues until all the desired records have been
extracted.
NOTE This process puts a fairly heavy load on the system doing the exporting.
3. Once all the desired records have been exported, the journal export
checks to see if any of these exported records are older than the value
entered in the Remove records older than field on the Configure
Journal Export Scheduling tab.
• If any such records are found, up to 50,000 of them are deleted at
once. (It would take too long to delete any more than 50,000.)
4. Once this delete is done, the journal export goes to sleep for the export
wait-time period. If the wait-time period finishes within the time
specification when the journal export is active, the whole process begins
over again.
Journal Export Database Schema

Journal Export Database Schema


Figure 3-6 illustrates the database schema for the Journal Export database.

Figure 3-6: Journal Export Database Schema

3–14 C•CURE 800/8000 Reports Guide


Journal Export Database Tables
All text fields in the Journal and Servers tables in the Journal Export database
are case-sensitive. Therefore, all queries against fields in these tables must
reflect the exact case of the text strings.

The Journal Export database consists of the tables shown in Table 3-1.

Table 3-1: Journal Export Database Tables

Table Contains
Servers A list of all C•CURE 800/8000 servers whose data is being imported into this table.

Journal All the journal messages that have been exported from the C•CURE 800/8000 system. The
messages are reformatted to make them easier both to interpret and for report-generation. All
characters in the journal table are case-sensitive.

Objects A list of all objects referenced in the Journal table. Object names and IDs are passed as part
of the journal messages retrieved from C•CURE 800/8000 and added to this table as
needed. The Object EUID is the ID referenced in the journal table.

Person A list of all personnel referenced in the Journal table. Personnel names, PIDs, and EUIDs are
passed as part of the journal messages retrieved from C•CURE 800/8000 and added to this
table as needed. The Person EUID is the ID referenced in the journal table.
NOTE: If an export journal record references a person or object that is deleted at the time the
export operation occurs, the PersonxFullName fields contains a string corresponding
to $$Deleted(xxx) where xxx is the corresponding object ID or Person ID. However,
the Object and Person tables contain the correct information.

Assets A list of all assets referenced in the Journal table. Asset names, PIDs, and EUIDs are
passed as part of the journal messages retrieved from C•CURE 800/8000 and added to this
table as needed. The asset EUID is the ID referenced in the journal table.

CodeTypes References to several different types of status code.


Example:
Journal Message Codes, Admit Codes, Reject Codes, Device Status, etc.
The CodeTypes table contains an entry for each type of code.
Table 3-1: Journal Export Database Tables, continued

Table Contains
Codes A list of different codes for each type of code
Example:
There is one record for each card reject code.
All system-defined strings in the Journal Export database are defined in this table. This is the
only table that requires translation. No other table should contain any hard-coded strings.
The LanguageCode field in this table contains a text code for the language of the particular
string stored in CodeString field. All languages configured in the Administration application
that are used to export the codes are exported to this table.
The following are the code strings currently supported:
ENU = US English
DEU = German
FRA = French
ESP = Spanish
CHS = Simplified Chinese
CHT = Traditional Chinese
JPN = Japanese

GroupMember For each object group and area defined in C•CURE 800/8000, the GroupMember table
contains an entry for each object that is a member of that group. This table is used for
generating reports based on groups of objects. The Is Exit Reader field is used to
differentiate data between entry and exit readers for an area.

PersonGroupMember For each personnel group defined in C•CURE 800/8000, the PersonGroupMember table
contains an entry for each person who is a member of that group. This table is used for
generating reports based on groups of personnel.
Export Journal Database Users
The Export Journal database is configured with two default users and
passwords: SYSPPROGRESS and Manager.
User: SYSPROGRESS Password: sysprogress
User: Manager Password: manager

You can change or add additional users via the Progress SQL Explorer tool
using standard SQL syntax.

Example:
CREATE USER ‘username’, ‘password’;
COMMIT;
Creates a user with no privileges

GRANT RESOURCE, DBA TO 'username';


COMMIT;
Grants full privileges to user

GRANT SELECT ON PUB.Person TO 'username';


COMMIT;
Grants SELECT privilege for table:
PUB.Person to user

REVOKE SELECT ON PUB.Person FROM ‘username’;


COMMIT;
Revokes the SELECT privilege

DROP USER ‘username’;


COMMIT;
Deletes the user
Journal Messages Structure
The Journal Message Structures, shown in Table A-2 on page A-3 in
Appendix A, “Export Journal Message Structure”, provides the details of all
of the current C•CURE 800/8000 journal database messages. This data is
structured in columns that contain only consistent types of data. Each
column in the table represents a field in the Journal table of the journal
export database. The table field name standards are shown inTable A-1 on
page A-2 in the Appendix A, “Export Journal Message Structure”.
Configuring Journal Export in the Administration Application

Configuring Journal Export in the Administration Application


The C•CURE 800/8000 Administration application contains a
Configure Journal Export dialog box. The Administration application
also contains Report configuration dialog boxes based on the Crystal
Reports.

The Configure Journal Export dialog box, shown in Figure 3-7 on page 3-20,
allows you to do a Journal Export, moving journal activity data from the
C•CURE 800 database to the Journal Export Database. Journal activity data
is historical activity log data with real time events, and does not include audit
trail information. See the “Overview” on page 3-2 for the definition of terms
and more information.

You can schedule how often journal activity data is exported from the journal,
as well as which journal activity data is exported.

Go to Options>Journal Export to access the Configure Journal Export dialog


box.

The Reports>Journal menu has the following related options:


 Journal Replay – Current journal replay and Audit Trail capability, see
Chapter 2 for more information.
 Predefined – Predefined Crystal-based reports are provided by Software
House. Predefined report executable files are stored in the
ccure800\4gl\reports\predefined folder. See “Running Enhanced
Reports” on page 3-29 for more information.
 Custom – User-supplied Crystal-based reports. Custom report
executable files are stored in the ccure800\4gl\reports\custom
folder. See “Running Enhanced Reports” on page 3-29 for more
information.

NOTE Incident IDs for Journal Incident Activity are exported into the Journal
Export Database as follows:
 For all messages but log messages—as the entire “TextData” field.
 For log messages—the Incident ID is the first portion of the
“TextData” field followed by part of the logged message text.

This field does not display in any of the C•CURE 800/8000 Predefined
Crystal-based reports. Consequently, you have to create a Custom Report
that includes the “TextData”field to see incident log information.

C•CURE 800/8000 Reports Guide 3–19


To Configure a Journal Export

1. Go to Options>Journal Export from the C•CURE


800/8000 Administration application menu.

2. The Configure Journal Export dialog box, shown in Figure 3-7, appears
with the Setup tab displayed. You use this dialog box to configure
Journal Export objects.

Figure 3-7: Configure Journal Export Dialog Box and Setup Tab

3. Provide the information from Table 3-2 in the top section of the dialog
box and in the Setup tab.

Table 3-2: Configure Journal Export Dialog Box - ID Section and Setup Tab Fields

Field/Button Do this...
Name Enter a unique name up to 50 characters long to identify the journal
export. If you enter the name of an existing journal export or other
security object, the system returns an error message indicating there is
a conflict.
Online Select Online to enable the journal export service and click OK in the
Configure Journal Export dialog box. Once enabled, the journal export
service is performed based on scheduling information.

Description Enter a description of the Journal Export object.

OK If online, click OK to save the configuration data.


Table 3-2: Configure Journal Export Dialog Box - ID Section and Setup Tab Fields, continued

Field/Button Do this...
Cancel Click the Cancel button to exit the dialog box without saving the
configuration data or the operations performed by the Erase Export
Journal button.

Name of user Enter the name of a user whose monitoring privilege and partition are
used to filter all data written to the journal export database. Double-click
to open a select list of available users. A warning is displayed when this
field is changed, indicating that filtering changes are only applied to
future data exported. The default value for this field is the currently
logged-in user.

Export Click to copy all personnel, personnel groups, and selected personnel
Personnel data fields to the Journal Export database. Group data, deleted personnel
records, and the personnel fields Int1 and Text1 are updated only via this
button. All other object information is also updated automatically during
the journal export.
NOTE: Export Personnel Data happens immediately; it is not based on
scheduling information.

Export Object Click to copy all object, area, and group data to the Journal Export
data database. This action also updates the status codes table. Group data,
area data, and deleted object records are updated only via this button.
NOTE: Export Object Data happens immediately; it is not based on
scheduling information.

Erase export Click to erase all data from all tables in the Journal Export database. A
journal warning message displays, asking you for confirmation. If any error is
encountered, it is reported and the erase operation terminated.
This operation only works on export databases with fewer than 1 million
records in the Journal table. Larger databases should be deleted and
rebuilt manually from the cc8x_journ_init database by re-initializing the
export journal database. See “Re-initializing the C•CURE Journal Export
Database” on page B-5 in Appendix B for more information.

4. Click the ODBC tab to open, as shown in Figure 3-8 on page 3-22.
Figure 3-8: Configure Journal Export Dialog Box- ODBC Tab

The Journal Export Service and Crystal Reports both use the values you
enter in the parameters in the ODBC tab to connect to the Journal Export
database.

5. Provide information from Table 3-3 in the ODBC tab.

Table 3-3: Configure Journal Export Dialog Box- ODBC Tab Fields

Field/Button Do this...
ODBC Data Source Select the currently available DSN for the Journal Export
(DSN) database. The DSN should be already created through the
Windows Control Panel. The default DSN is CC8X_Journ. If you
wish to create additional DSNs, see “Creating a DSN for the
Enhanced Reporting Database” on page 3-7.

Data source user ID Enter the user name used to connect to the Journal Export
database. Normally this is the same as the Data Source User ID
in the ODBC control panel. The default value is blank.

Data source password Enter the password used to connect to the Journal Export
database. (The password is case-sensitive.) The default value is
blank.

Test ODBC connection Click to attempt to connect to the Journal Export database using
to Database the specified parameters.
6. Click the Progress tab to open, as shown in Figure 3-9.

Figure 3-9: Configure Journal Export Dialog Box - Progress Tab

The Progress tab parameters are used only when you click either the
Export Personnel Data or Export Object Data button on the Setup tab.

7. Provide the information from Table 3-4 on page 3-24 in the Progress tab.
(User name and password are requested on both the Progress tab and on
the ODBC tab, as they may be different for these two connections.)
Table 3-4: Configure Journal Export Dialog Box - Progress Tab Fields

Field/Button Do this...
Host name Enter the computer name where the Journal Export
database is installed. The default value is blank.

Service name A default Service Name is provided with the installation of


Enhanced Reporting. The Service Name is the Windows
services file used to connect to the Journal Export database.
If you wish to create additional service names, see “Creating
a DSN for the Enhanced Reporting Database” on page 3-7.
The default value is ERDBSRV.
NOTE: When C•CURE 800/8000 activates a new journal,
the ODBC Data Source must be updated so that the
Database Name refers to the new journal file name,
and the Port Number refers to the new service
name.
Database name Enter the name of the actual database that is to be exported.
The default value is CC8X_Journ.

Database user ID Enter the user name used to connect to the Journal Export
database. Normally this is the same as the Data Source
User ID on the ODBC tab. The default value is blank.

Database password Enter the password used to connect to the Journal Export
database. Normally this is the same as the Data Source
Password on the ODBC tab. The default value is blank.

Test Progress connection to Click to attempt to connect to the Journal Export database
database using the specified parameters.

8. Click the Scheduling tab to open, as shown in Figure 3-10 on page 3-25.
Figure 3-10: Configure Journal Export Dialog Box - Scheduling Tab

The parameter values you enter for the Scheduling tab are used to
schedule journal export and message filtering based on time.
9. Provide the information from Table 3-5 in the Scheduling tab.

Table 3-5: Configure Journal Export Dialog Box - Scheduling Tab Fields

Field/Button Do this...
Export journal data only Enter a time specification (time spec) or double-click to get
during this time spec the Time Spec Selection browser and select a time spec.
Journal exports are performed only within the boundaries
of the time specification. The default value is $Always.
NOTE: Journal Exports will start only while this time spec is
activated. However, an active journal export will run
to completion, even if it completes after the time
spec period ends.
Table 3-5: Configure Journal Export Dialog Box - Scheduling Tab Fields, continued

Field/Button Do this...
Export every [hh:mm] during Enter the time interval during the time specification that the
time spec journal export is performed.
Example:
If you want a journal export performed every 15
minutes during the time specification, you would set
this interval at 0:15.
Minimum value is 10 minutes. Maximum value is 999
hours. Minutes range is from 0 to 59 minutes. The default
value is 0:10 (ten minutes).
NOTE: Be sure to set this value equal to or greater than 10
minutes to avoid slowing down the system
significantly.

Ignore messages older than Specify a date to be used on the initial journal export to a
new Journal Export database. Only journal data recorded
on or after the specified date is a candidate for export. The
default value is 12/31/1989 00:00 GMT (that time
component is not displayed).

Remove messages older Enter the number of days to indicate the date before which
than the journal export database is cleaned as part of the
journal export process. Journal messages that are too old
(occurred prior to the number of days entered) are deleted
at the end of every journal export. The default value is 180
days. The minimum value is 1 day. Zero days, which is
also allowed, indicates that messages should never be
removed.
NOTE: This is an approximation. To ensure that data is
properly removed, the cleanup process rounds to
the beginning of the current day and subtracts the
specified number of days plus one. All data more
current then this date is retained.

Since the Ignore messages older than field and Remove messages older than
field work in tandem, there is no point in exporting messages that will
immediately be removed.

Example:
Assuming that the current date is 01/01/2008 and you enter 01/01/2003 in
the Ignore messages older than field and 365 days in the Remove messages
older than field, the system then exports all journal messages between 2003
and 2008 and immediately deletes the messages between 2003 and 2007.
10. Click the SQL tab to open, as shown in Figure 3-11. Use the SQL tab to
define error logging.

Figure 3-11: Configure Journal Export Dialog Box - SQL Tab

11. Provide the information from Table 3-6 in the SQL tab.

Table 3-6: Configure Journal Export Dialog Box - SQL Tab Fields

Field/Button Do this...
Enable Logging Select this option to enable the logging of various
diagnostic messages from the journal export service.
Messages go into the following file:
ccure800\4gl\database\log\enRep_[dsn]_nnn.log
(Where [dsn] is the ODBC DSN [name], and nnn is a
numeric value that increases for each new log file)
The default value is unselected.

Maximum size (kb) of the log Enter the maximum size (in kb) to which the log file is
file allowed to grow. The range is 5 kb to 50,000 kb (50 mb).
The default is disabled.
Once logging is enabled, the default is 1000 kb (1 mb).
Table 3-6: Configure Journal Export Dialog Box - SQL Tab Fields, continued

Field/Button Do this...
Maximum number of log files Enter the Maximum Number of log files to be created.
Once this value is exceeded, older log files are deleted.
The range is 1 to 100. The default is disabled.
Once logging is enabled, the default is 10.
Running Enhanced Reports

Running Enhanced Reports


Creating a Journal Export Database, as described in the last section,
enables you to utilize Enhanced Reporting. Enhanced Reporting consists
of journal export, plus predefined and customized Crystal-based reports.

You can run the following types of enhanced reports from the C•CURE
Administration application Reports menu.
• Predefined Crystal-based reports – provided by Software House. The
report executable files are stored in ccure800\4gl\reports\
predefined folder.
Choose Reports>Journal>Predefined to access the Report Generation
for Predefined Journal Reports dialog box.
• Custom reports – Crystal-based reports developed by the user, dealer,
or outside consultant and stored in the ccure800\4gl\reports\custom
folder as executable files.
Choose Reports>Journal>Custom to access the Report Generation for
Custom Journal Reports dialog box.

By default, output from all reports is stored in the ccure800\4gl\user folder.


You can choose to save the report result elsewhere by defining another folder
in makeTAJob.ini using the TMPDIR section.

Example:
To save your batch report in C:\BatchReport1, set the defined folder on
the TMPDIR section of makeTAJob.ini as follows:
TMPDIR=C:\BatchReport1\

C•CURE 800/8000 Reports Guide 3–


Running Predefined Journal Reports
The Report Generation for Predefined Reports dialog box, shown in
Figure 3-12, allows you to select any of the Software House-supplied Crystal
Reports-based reports to run, based on data collected via the journal export.
Provide the information from Table 3-7 on page 3-31 in the dialog box.

NOTE You must perform a Journal Export, from the Setup tab on the
Configure Journal Export dialog box, before using Predefined Journal
Reports. You only have to do the export once, when you finish
configuring the Journal Export Database setup or when you change it.

The reports display on the Crystal Reports Viewer dialog box is shown in
Figure 3-21 on page 3-46. The Crystal Reports Viewer supports e-mailing and
printing report results.

Figure 3-12: Report Generation for Predefined Reports Dialog Box

All of the reports for the current version of C•CURE 800/8000 (except for Time
and Attendance) require a consistent set of Crystal report parameters, shown
in Figure 3-13 on page 3-32 and Figure 3-14 on page 3-33 and described in
Table 3-8 on page 3-33.

For the Time and Attendance report, the Administration application prompts
for the report parameters, as shown in Figure 3-16 on page 3-35 and described
in Table 3-9 on page 3-23. These parameters are passed to a preprocessor
routine that generates the statistical data for the report. The data is then
passed to Crystal Reports, which produces the report. See “Time and
Attendance Report Parameters” on page 3-35 for more information.
You can also schedule the Time and Attendance report and any of the other
predefined Journal reports to run at regular intervals. For information, see
“Scheduling Reports to Run” on page 3-48.

Table 3-7: Report Generation for Predefined Reports Dialog BoxFields

Fields/Buttons Do this...
Journal export database Enter the name of the Journal Export Database. You can
also double-click in the field to open the Journal Export
Selection browser and select a Journal Export Database
to use with the selected report.
NOTE: The name of the journal database is case-sensitive.
Make sure the name you type matches the case
exactly in order to retrieve the correct results.

Predefined Reports Directory The directory where the predefined report executable files
are stored. These executable files are read-only and
cannot be modified.

Predefined Reports list Select a report from the list:


 Admitted Access By Door Group
 Admitted Access By Door
 Input Activation By Input Group
 Input Activation By Input
 Rejected Access By Door Group
 Rejected Access By Door
 Time and Attendance
See “Predefined Journal Report Descriptions” on
page 3-37.

Run selected report Click to run the selected report

Close Click to exit this dialog box without running a report.


Predefined Journal Report Parameters
The Crystal Reports Enter Values dialog box, shown in Figure 3-13 for
individual objects and in Figure 3-14 on page 3-33 for group objects, provides
the standard parameters requiring data entry for most of the predefined
reports. See Table 3-8 on page 3-33 for descriptions of these parameters. (For
the Time and Attendance report, see “Time and Attendance Report
Parameters” on page 3-35.)

Figure 3-13: Enter Values Dialog Box


Figure 3-14: Enter Values Dialog Box for Groups

Table 3-8: Crystal Report Start Parameters Dialog Box Fields

Fields/Buttons Do this...
Parameter Fields Select a parameter for which a user-defined value is to be
specified. Once a parameter is selected, the data entry field(s) will
be displayed in the lower half of the dialog box.

Start date/time Select a start date/time for the report. Only journal messages on or
after this date/time will be considered. Click to open the
Calendar popup box (see Figure 3-15 on page 3-34) to select the
date/time or enter it in yyyy-mm-dd hh:mm:ss format. Range is 1/1/
1990 00:00 to now. Default is the current date/time.

End date/time Select an end date/time for the report. Only journal messages on
or before this date/time will be considered. Click to open the
Calendar popup box (see Figure 3-15 on page 3-34) to select the
date/time or enter it in yyyy-mm-dd hh:mm:ss format.Range is 1/1/
1990 00:00 to now. Default is the current date/time.
Table 3-8: Crystal Report Start Parameters Dialog Box Fields, continued

Fields/Buttons Do this...
Door Name/Input Specify the name of the door/input object to report on.
Name
 For door reports, specify a door/door group (depending on
the report) that you want to be the report subject.
 For input reports, specify an input/input group (depending
on the report) that you want to be the report subject.

Threshold Select a value to restrict messages greater than or equal to the


specified value.
NOTE: This field is only available with group reports.
 For door reports, this value restricts reporting to doors with
admits or rejected accesses greater than or equal to the
value specified.
 For input activation reports, this value restricts reporting to
inputs with a number of activations greater than or equal to the
value specified.
Range is 0 to 9999.

OK Click to complete the report. The Crystal Report Viewer dialog box
is displayed, as shown in Figure 3-21 on page 3-46.

Cancel Click to cancel the report.

Figure 3-15: Calendar Popup


Time and Attendance Report Parameters
Figure 3-16: Time and Attendance Report Dialog Box

See Table 3-9 on page 3-36 for descriptions of the Time and Attendance report
parameters and “Scheduling Reports to Run” on page 3-48 for information on
scheduling the report to run on a regular schedule.
Table 3-9: Time and Attendance Report Dialog Box Fields

Box Field/Button Do this...


Report description Read-only field that provides a description of the report.

Select personnel Person/Personnel Select either the Person (an individual record), or a Personnel
group group option. The corresponding field is enabled or disabled based
on this selection.

Person/Personnel Specify the person or personnel group to report on. Only one of
group these fields is enabled at any time. In either case, double-click to
get the standard selection for personnel/groups. The time and
attendance report provides information about the personnel/group
specified here.

Define boundary Readers/Area Select whether time and attendance reporting should be based on a
set of readers or a specified area:
 If you select Readers, the Entry reader and Exit reader fields
are enabled.
 If you select Area, the Area field is enabled.

Entry reader Specify the reader or reader group that personnel use to enter.
Double-click to get the standard selection for readers/groups.

Exit reader Specify the reader or reader group that personnel use to exit.
Double-click to get the standard selection for readers/groups.

Area Specify the area that is used for Time and Attendance reporting.
Entry readers for the area will be used by personnel to enter and
exit readers will be used to exit. Double-click to get the standard
selection for areas.

Flag records for which Select this option to indicate if an error report should be generated
time allowed in for any person who is logged in the boundary region for longer than
boundary exceeds: the specified number of hours. The number of hours is specified in
hours the fill-in field. Range is 1 to 999.

Select date/time range Time Zone Select a time zone for the report from the drop-down list.

Start date/time Specify a start date/time in MM/DD/YYYYhh:mm format. Only journal


messages on or after this date/time are considered. Range is
1/1/1990 00:00 to the current date and time.

End date/time Specify an end date/time in MM/DD/YYYYhh:mm format. Only


journal messages on or before this date/time are considered. Range
is 1/1/1990 00:05 to the current date and time.
Predefined Journal Report Descriptions
Predefined Journal Reports include seven reports: statistical reports and time
and attendance reports.

Admitted Access By Door Group and Admitted Access By Door

Reports on doors with admitted accesses greater than the user-specified


threshold.
 Parameters
• Door or door group
• Date/time range including start date/time and end date/time
• Threshold – Ignore readers with a number of admits less than
the threshold.
 Report Data Elements
• Door name
• Number of admits

Input Activation By Input Group and Input Activation By Input

Reports on inputs that have activated more than the user-specified threshold.
 Parameters
• Input or input group
• Date/time range including start date/time and end date/time
• Threshold– Ignore inputs with a number of activations fewer than the
threshold.
 Report Data Elements
• Input name
• Number of activations

Rejected Access By Door Group and Rejected Access By Door

Reports on doors with rejected access attempts greater than the user-specified
threshold.
 Parameters
• Door or door group
• Date/time range including start date/time and end date/time
• Threshold – Ignore readers with a number of accesses/rejects/errors
less than the threshold.
 Report Data Elements
• Door name
• Number of admits, rejects and errors

Time and Attendance

Report on amount of time a person spent in an area or facility.


 Parameters
• Personnel or personnel group
• Boundary
– Reader
Entry reader or reader group
Exit reader or reader group
- or -
– Area
– Max in-time (hh)—Error generated if person stays in boundary
region longer than this time
• Time zone
• Start date/time
• End date/time

The Time and Attendance report is divided into two or three sub-reports,
depending on the input parameters. The sub-reports have the following
detailed information:
1. Time and Attendance Report
Reports only valid clock-in and clock-out matches for personnel and
boundary selected. This sub-report is the first displayed and is always
included with the report.
• Report Data Elements Per Cardholder
– Personnel name (card number)
– Entry date time
– Entry reader
– Exit date time exit reader
– Hours (elapsed time within a single clock-in and clock-out time
interval)
– Total time (total time spent with boundary (hh:mm) per cardholder)
– Report total time total (total time spend within boundary
(hh:mm) for each cardholder)
2. Time and Attendance Error report: Total Person Time Exceeds Threshold
Reports only valid clock-in and clock-out matches for the personnel and
boundary selected which exceed the time interval (threshold) specified.
This sub-report is only included when the user selects the Flag Records
For Which Time Is Allowed in Boundary Exceeds (hh) check box.
• Report Data Elements Per Cardholder
– Personnel name (card number)
– Entry date name
– Entry reader
– Exit date time
– Exit reader
– Hours (Elapsed time within a single clock-in and clock-out time
interval)
– Total time (total time spent within boundary (hh:mm)
per cardholder)
– Grand total time spent within boundary (hh:mm) for all cardholder
3. Time and Attendance Error Report: No Entry or Exit Data
This sub-report generates a list of exceptions or error conditions detected
during the Time and Attendance analysis. These exceptions are listed at
the end of the report, as follows:
– Two sequential in-reads for a cardholder without an intermediate
out-read.
– Two sequential out-reads for a cardholder without an intermediate
in-read.
– First read for a cardholder is an out-read.
– Last read for a cardholder is an in-read.
– Cardholder is recorded within boundary region during any in/out
interval for greater than the specified Max time.
• Report Data Elements Per Cardholder
– Personnel name (card number)
– Entry date time
– Entry reader
– Exit date time
– Exit reader
– Error
Running Time and Attendance Reports in Microsoft Excel
If your C•CURE 800/8000 system is licensed for Enhanced Reporting, the
Time and Attendance report menu option can be found in the Reports menu
under Personnel. This report is similar to existing Personnel Reports in that
you are able to select Personnel, Card and User defined fields and save the
results in Excel.

This Enhanced Reporting Time and Attendance Report includes the same
fields found in the predefined Time and Attendance Crystal Report (which
can be found under Reports > Journal > Predefined > Time and Attendance).
See “Running Predefined Journal Reports” on page 3-30. This feature allows
you to combine new or existing Personnel Reports with these Time and
Attendance fields, including:
 Entry Reader
 Entry Date and Time
 Exit Reader
 Exit Date and Time
 Total Hours
 Flag records for which time allowed in boundary exceeds: [ ] hours

Creating a Time and Attendance Report in Excel

1. After selecting the Time and Attendance report menu item, the report
selection screen appears, as shown in Figure 3-17 on page 3-42.
Existing personnel reports are listed in the Time and Attendance Report
Selection dialog box. When you choose an existing personnel report and
click Run Report, the selected personnel fields are displayed on the first
Excel worksheet and are combined with time and attendance records
which are included in the second worksheet.
Figure 3-17: Report Selection Dialog Box

2. Select and existing personnel report and click the Run Report button
to display the report query screen, as shown in Figure 3-18 on page 3-
43.
You can also create a new Time and Attendance report when you select
the New Report button.
Figure 3-18: Time and Attendance Report Query Dialog Box

3. Double-click within the Journal export database field to display the


Journal Export selection screen, as shown in Figure 3-19 on page 3-44.
In order to successfully produce a Time and Attendance report, the
Journal Export database must be started and Journal Export must be
properly configured with all required connection parameters. The most
recent data in the Enhanced Reporting database provides a more accurate
report.
Figure 3-19: Journal Export Selection Dialog Box

4. Choose an existing journal export and click Select to display the Journal
Export Time and Attendance report.

NOTE A Wildcard search can be used to search for Journal Exports. See “Using
Wildcard Search” on page 1-5 for more information and examples.

5. You are able to query personnel records by double clicking on the Person
ID field. If the personnel identification is known, you can enter it into
the Person ID field. The system will retrieve that personnel record.
6. Double-click in the Personnel Group, Entry Reader, Exit Reader or Area
fields to display the standard object selection screen.
The results are presented in Excel. See the Microsoft Excel help
information.
Running Customized Journal Reports
The Report Generation for Custom Journal Reports dialog box, as shown in
Figure 3-20 on page 3-45, enables you to select and run a customized report.
The custom report selection browser is similar to the predefined report
selection browser. Customized reports, however, also prompt for their own
input.

The C•CURE 800/8000 Administration application launches the


customized report in the Crystal Reports Viewer dialog box, similarly to the
predefined journal report example shown in Figure 3-21 on page 3-46.

You can also schedule a custom Journal report to run at regular intervals.
For information, see “Scheduling Reports to Run” on page 3-48.

Figure 3-20: Report Generation for Custom Journal Reports Dialog Box
Viewing Predefined and Customized Journal Reports
See Table 3-10 for the description of the available navigation tools and other
options on the Crystal Reports Viewer dialog box, shown in Figure 3-21.

NOTE Crystal Reports does not support displaying reports in full size on
systems with video capture cards, such as FlashPoint 3DXPlus,
FlashPoint 3DPlus, FlashBus MV Lite, and FlashBus MV Plus.

Crystal Reports is not supported on Windows 2008 operating systems.

Figure 3-21: Crystal Reports Viewer Dialog Box

Table 3-10: Crystal Reports Viewer Toolbar Definitions

Button Name Description


Export Report Click to save or e-mail the report. You can save the
report to different formats.

Print Report Click to open a Windows Printer dialog box for printing
the report. You can select the size and orientation of the
printout, set the margins, or change the printer.
Table 3-10: Crystal Reports Viewer Toolbar Definitions, continued

Button Name Description


Toggle Group Click to enable/disable a column on the left that
Tree identifies the group name of each item in the report.

Navigation Click these buttons to navigate through the Reports


icons dialog box to:
 Beginning of report
 Back one page
 Forward one page
 End of report

Page Total/ Indicates which page of the report is currently


Locator displaying and the total number of pages.

Stop Loading Click to stop the running of the report.

Refresh Click to refresh the current report by rerunning it.

Search Text Click to search for a specific text segment within the
report. (Tool is not case-sensitive.)

Percentage Select the percentage at which to magnify or shrink the


selector report page.

Journal and Audit Trail Messages that Support Enhanced Reporting


The following journal messages support enhanced reporting:
 System Activity message:
Journal export database (jnl_export_objname) was reset
User selected Erase Export Journal button in the Administration Journal
Export Configuration dialog box.
 System Error messages:
Illegal journal message for journal export (jnl_export_objname)
Internal error indicating journal export does not currently support some
journal messages.
Journal export for jnl_export_objname had missing journals
(list_of_jnls)
Indicates one or more C•CURE 800/8000 journals were not available for
export. The list is a space-separated list, such as “1 5 12”.
Journal export for jnl_export_objname had connection problems
Indicates problems connecting to the Journal Export database.
Example:
Password failure, DSN failure, enhanced reports returns an error
status, crashes, or takes longer than the allowed time to complete a
task.

Scheduling Reports to Run


You can schedule the predefined Journal reports, including the Time and
Attendance report, and any custom Journal reports to run at regular
intervals as follows:
 Time and Attendance report from the makeTAJob.bat file
 Other predefined reports and any custom reports from the
makeAny1.bat file (the file name may be changed).

You can then save the report result to a file, e-mail it, or print it. Before you
can schedule the report, however, you must configure parameters in the *.ini
file.

Example:
makeTAJob.ini or makeAny1.ini file

The reports are designed to allow multiple jobs to be scheduled using


different *.ini files.

To Set the Scheduling Parameters

1. Select either of the following and then click Open.


• For the Time and Attendance report:
ccure800>4gl>Reports>Predefined>TA>MakeTAJob.ini
• For any other predefined or custom report:
ccure800>4gl>Reports>Predefined>MakeAny1.ini
2. In either of the preceding .ini files change the parameters to your
specifications, following the documentation within the file.
3. Save and close the file.

To Schedule an Enhanced Report

1. In the Windows Control Panel, double-click Scheduled Tasks.

2. Double-click Add a Scheduled Task. The Scheduled Task wizard opens

3. Click Next.
4. Click Browse to select the location of the batch (*.bat) file to run.

5. Select either of the following and then click Open.


• For the Time and Attendance report:
ccure800>4gl>Reports>Predefined>TA>MakeTAJob.bat
• For any other predefined or custom report:
ccure800>4gl>Reports>Predefined>MakeAny1.bat (you can
change the file name)

6. Specify the name of the job and it’s frequency (daily, weekly, monthly,
etc.) and click Next.

7. Specify when the task will run and click Next.

8. Enter the Windows username and password that is used to run the job,
confirm the password, and click Next.

9. Select Advanced Properties and click Finish.


The Run field will contain the name of the batch file to run at the
scheduled time. You can also add any required batch file parameters
here.
You can modify properties, including advanced properties of the job,
later by double-clicking your task from the Control Panel scheduled
tasks list or by right-clicking the task and selecting Properties.
Starting the Windows Scheduler Service

To Verify that the Windows Task Scheduler Service is Running

1. Go to Control Panel>Administrative Tools >Services and click


Services (local). The Component Services dialog box appears as shown
in
Figure 3-22. By default the Startup Type for the Task Scheduler service is
Automatic.

2. Change the StartupType to Automatic, if necessary, and start the


service. Scheduled reports will not run unless this service is started.

Figure 3-22: Component Services Dialog Box


A

Export Journal Message Structure

This appendix displays two tables. The first shows the naming suffixes within
the Journal database and the second illustrates the structure of the existing
C•CURE 800/8000 journal messages.

In this appendix
 Table Field Name Standards....................................................................................A-2
 Export Journal Message Structure ............................................................................... A-3

C•CURE 800/8000 Reports Guide A–1


Table Field Name Standards
Table A-1 shows the naming suffixes that make up the standard naming
convention used by the table field names within the Journal database.

Table A-1: Table Field Naming Suffixes

Suffix Description
ID A standard C•CURE 800/8000 database Object ID, Person ID, or Journal ID.
Provides a unique numeric identifier for each object, personnel, and journal
record.

GID A Global ID. This is only used with the Journal GID field. This value provides
a unique, incrementing value for each journal message. This ID enables you
to include journal data from multiple C•CURE 800/8000 systems. This field is
currently not used.

EUID Enterprise Unique ID. For this release, this field contains the object ID or
person ID.

CodeIDX There are several fields with this suffix. All these fields map to the Codes
table, which may be used to interpret these values.

CodesAIDX There is only one field with this suffix, AdmitCodesAIDX. This field is a
comma-separated list of admit codes. Each of these codes maps to the
Codes table, which may be used to interpret these values.

GMTDT Date/Time in Greenwich Mean Time (UCT).

LocalTZDT This field type stores the date/time in the time zone of the C•CURE 800/8000
server computer. PanelLocalTZDT is the only field that uses this suffix.
Export Journal Message Structure
Table A-2 illustrates the structure of the existing C•CURE 800/8000 journal messages. The data in each
journal message is structured to fit into the decompressed form of the Enhanced Reporting Journal table.

Table A-2: Journal Message Structure

Status
Message Message Person Person Asset Object Object Card Admit Reject Node Status Code Text
Code Type ID #1 ID #2 ID #1 #2 Number Codes Code Name Code #1 #2 Data CHUID

1 User Login/ User PID Node Application Login/ Invalid


Logout Name Code Out Username
Code

2 Card PID Escort Door ID Reader Card Admit Escort Door Extended Admit
Admitted PID ID Number Codes Code Direction Rdr Status Messag
Message e (Govt
Cards)

3 Card PID Door ID Reader Card Admit Reject Escort Door Extended Reject
Rejected ID Number Codes Code Code Direction Rdr Status Messag
Messages e (Govt
Cards)

4 Log User PID Event ID Message


Message Text

5 State User PID Object State Cause


Change ID Code Code

6 Manual User PID Graced Object Person Action Manual Count


C• Action Person ID Group Code Action
C ID ID Code
U
R 7 System Jnl Node Activity MAC
Activity Export Name Code Address
E Object
80 ID
0/
80 8 System Jnl Node Sys Error API Error See notes
Error Export Name Code Code
00 Object
R ID
ep
or 9 Device PID Object Object Dev. Act. Firmware
Activity (grace) ID ID Code Version.
ts
G 10 Device Object Related Error Sub- Firmware
Error/ ID Object Code Error Version.
Recovery ID Code

A
–3
A Table A-2: Journal Message Structure, continued
–4
Status
Message Message Person Person Asset Object Object Card Admit Reject Node Status Code Text
Code Type ID #1 ID #2 ID #1 #2 Number Codes Code Name Code #1 #2 Data CHUID
C•
11 Asset PID Asset Asset Asset
C Activity ID Admit Activity
U Codes Code
R
12 Asset PID Asset Door ID HHR ID Asset Reject Door Tag
E Movement ID Admit Code Direction Number
80 Authorized Codes
0/
80 13 Asset PID Asset Door ID HHR ID Asset Reject Door Tag
00 Movement ID Admit Code Direction Number
R Unauthorize Codes
d
ep
or 14 Asset PID Asset Door ID HHR ID Asset Reject Door Tag
ts Movement ID Admit Code Direction Number
G Attempted Codes

15 Asset PID Asset Area ID HHR ID Asset Tag


Location ID Admit Number
Update Codes

16 Watchtour User PID Guard Tour ID Action


Action PID Code

17 Watchtour Guard Tour ID Watchtour


Activity PID Activity
Code

18 Watchtour Guard Tour ID Watchtour


Error PID End Code

19 Watchtour Guard Tour ID Stop ID Watchtour


Stop PID Stop Code

20 NetVideo User PID Camera NV NV Action Segment


Activity ID Action Code Index
ID

21 Keypad PID Door ID Cmd ID Card Keypad Door


Command Number Activity Direction
Code

22 Intrusion Causer Zone ID IZ Activity


Zone Act PID Code
Table A-2: Journal Message Structure, continued

Status
Message Message Person Person Asset Object Object Card Admit Reject Node Status Code Text
Code Type ID #1 ID #2 ID #1 #2 Number Codes Code Name Code #1 #2 Data CHUID

23 Intrusion Causer Zone ID IZ Error


Zone Error PID Code

24 Area Area ID Person Area Act. Count


Activity Group Code
ID

Notes:

Message 4 - Only first 80 characters of message text will be exported.

Message 6 - Linkage to Manual Action table dropped (all Manual action definition data)

Message 8 - The Text Data field for this message contains API Name + ":" + Microsoft API error code, or a space separated list of missing journals

Message 2, 3, 11-15 - These messages contain a comma separated list of admit codes stored in a character string

C•
C
U
R
E
80
0/
80
00
R
ep
or
ts
G

A
–5
A–6 C•CURE 800/8000 Reports Guide
B

Enhanced Reporting Maintenance

This appendix describes several procedures useful for maintaining journal


export for enhanced reporting.

In this appendix
 Using the Progress Administration Service for Journal Export..............................B-2
 Re-initializing the C•CURE Journal Export Database .............................................. B-5

C•CURE 800/8000 Reports Guide B–1


Using the Progress Administration Service for Journal Export
The Progress Administration Service for OpenEdge 10.2A is used for
database administration. This service is automatically installed and
configured on the system where the Journal Export database is installed and
is used to start up the database server. To check that this service is running
follow the following procedure.

To Check the Progress Administrative Service Status

1. Go to Control Panel>Administrative Tools>Services. Select


AdminService for OpenEdge 10.2A. Right-click to display the context
drop-down menu, which indicates that the service is running when the
Stop option is visible, as shown in Figure B-1.

Figure B-1: Progress Administration Service


Using the Progress Administration Service for Journal Export

To Stop the Journal Export Database Server

1. Ensure that the Progress Administrative Services are started,


as explained in the previous task (see above).
2. Open the CCURE800>4gl>Database directory.
3. Double-click the batch file
named: stop_cc8x_journ.bat
-or-

1. You can also open a Windows command shell and change directory to the
\CCURE800 directory.
>cd d:\ccure800

2. Enter the command shown in Table B-1:

Table B-1: Stop Command Example

Stop Journal Export database Server Command

%DLC%\bin\dbman -database cc8x_journ -stop

To Start the Journal Export Database Server

1. Ensure that the Progress Administrative Services are started,


as explained above.
2. Open the CCURE800>4gl>Database directory.

3. Double-click the batch file


named: start_cc8x_journ.bat

To Start Additional Journal Export Database Servers

1. You can also open a Windows command shell and change directory to the
\CCURE800 directory.
>cd d:\ccure800

C•CURE 800/8000 Reports Guide B–3


2. Enter the commands shown in Table B-2 using the cc8x_journ names
that you have created for addition journal Export Databases:

Table B-2: Start Command Examples

Start Journal Export Database Server Command


%DLC%\bin\dbman -database cc8x_journ -start

%DLC%\bin\dbman -database cc8x_journ1 -start

%DLC%\bin\dbman -database cc8x_journ2 -start

For more information about initializing a second (or subsequent) export


journal database see “Initializing a Second C•CURE Journal Export
Database” on page B-6.

NOTE The Progress Administrative Services must be running when the above
commands are executed.

NOTE The Connection Manager Properties (conmgr.properties) file must be up-


to-date. The dbman command will start/stop databases using the
conmgr.properties file. See “Initializing a Second C•CURE Journal Export
Database” on page B-6.
Re-initializing the C•CURE Journal Export Database

Re-initializing the C•CURE Journal Export Database


The following procedure describes how to re-initialize the export journal
database. You can use this procedure as an alternative to using the Erase
export journal button in the Configure Journal Export dialog box Setup tab,
shown in Figure 3-7 on page 3-20. The advantage to using this procedure is
that it:
 Works on large databases (greater than 1 million records).
 Is often much faster on large databases under 1 million records.
 Reclaims disk space where the Erase Export Journal option does not.

To Re-initialize the C•CURE Journal Export Database

1. Using the AdminService for OpenEdge 10.2A, as described in “Using


the Progress Administration Service for Journal Export” on page B-2 and
shown in Figure B-2 on page B-8, Stop the journal export database server,
as described above in “To Stop the Journal Export Database Server” on
page B-3.
2. From the Windows command prompt, do the following:
• Enter:
C:\> CD %cc800root%\4gl\database
C:\> cc8x_journ_init Target_Folder YES
Replace Target_Folder with the directory where the export database
resides.
The YES indicates that an existing export database may be overwritten
and is case-sensitive.
Example:
In this example both CCURE800 and ENReports are on the D: drive.
C:\>D:
D:\> CD CCURE800\4gl\Database
D:\CCURE800\4gl\Database> cc8x_journ_init D:\ENReports YES

3. Using the AdminService for OpenEdge 10.2A, as described in “Using


the Progress Administration Service for Journal Export” on page B-2,
click Start to restart the journal export database server.

C•CURE 800/8000 Reports Guide B–5


Initializing a Second C•CURE Journal Export Database
The following procedure describes how to initialize a second (or subsequent)
export journal database. Configuring an additional export journal database
for enhanced reporting is done within the Connection Manager Properties
(conmgr.properties) file. The following the procedure allows you to configure
multiple journal export databases.

To Initialize a Second (or Subsequent) C•CURE Journal Export Database

1. Create a folder on the hard drive where the new export database will
reside.
Example:
D:\ENReports2

2. From the Windows command line, do the following:


• Enter:
C:\> CD %cc800root%\4gl\database
C:\> cc8x_journ_init Target_Folder
NO

Target_Folder is replaced with the directory where the new export


database resides.
The NO indicates that any existing export database cannot be
overwritten (this is a safety precaution). NO is also case-sensitive.
Example:
In this example both CCURE800 and ENReports2 are on the D: drive.
C:\>D:
D:\> CD CCURE800\4gl\Database
D:\CCURE800\4gl\Database> cc8x_journ_init D:\ENReports2 NO

3. Run the following command to create CC8x_Journ2 database by


copying the newly created CC8x_journ database:
D:\CCURE800\4gl\database>procopy D:\Enreports2\cc8x_journ
D:\Enreports2\cc8x_journ2
4. In the Windows Services file, add a service or port name for the new
database server. This file is usually in:
Re-initializing the C•CURE Journal Export Database

c:\Windows\system32\drivers\etc\services (the file has no


extension).
a. Find the entry for ERDBSRV and copy it.
b. Change the service name to ERDBSRV2, and increment the port
number by one (from 2900 to 2901, e.g.). The new entry should be
as follows:
ERDBSRV2 2901/tcp # CCURE800: Enhanced Reporting
database (CC8X_Journ)

When C•CURE 800/8000 activates a new journal, the ODBC Data Source
NOTE
must be updated so that the Database Name refers to the new journal
filename, and the Port Number refers to the new service name.

5. In the hard disk drive directory where C•CURE 800/8000 has been
installed, go to the CCURE800DLC10 folder, shown in Figure B-2 on
page B-8.

6. Open the Properties folder and double-click the Connection Manager


Properties (conmgr.properties) file, and choose Select the program
from a list and click OK. To open conmgr.properties, choose Notepad
and click OK. Save a renamed copy of the Connection Manager
Properties file, as a backup.

C•CURE 800/8000 Reports Guide B–7


Figure B-2: Progress C•CURE 800DLC10

7. Close the saved copy and reopen the original conmgr.properties file,
shown in Figure B-3 on page B-9.
8. Notice that there are three configuration sections in the Connection
Manager Properties file. Copy and paste each section - one below the
other - as shown outlined with dashed lines in Figure B-4 on page B-10.
Re-initializing the C•CURE Journal Export Database

Figure B-3: Progress C•CURE 800DLC10 - conmgr.properties - Original Source File

9. Next, modify identifiers in the configuration.CC8x_Journ journal


export database within the first section of the Connection Manager
Properties file, as shown in the example in Figure B-4 on page B-10 and
the text examples below:
Examples:
a. [configuration.cc8x_journ.defaultconfiguration] to
[configuration.cc8x_journ2.defaultconfiguration]
b. database=cc8x_journ to database=cc8x_journ2
c. servergroups=cc8x_journ.defaultconfiguration.defaultservergroup to
servergroups=cc8x_journ2.defaultconfiguration.defaultservergroup

10. Rename the database.CC8x_Journ journal export database identifier


within the second section of the Connection Manager Properties file, as
shown in the example in Figure B-4 on page B-10 and the text
examples below:

C•CURE 800/8000 Reports Guide B–9


Examples:
a. [database.cc8x_journ] to [database.cc8x_journ2]
b. configurations=cc8x_journ.defaultconfiguration to
configurations=cc8x_journ2.defaultconfiguration
c. displayname=CC8X_Journ to displayname=CC8X_Journ2

Figure B-4: Progress C•CURE 800DLC10 - conmgr.properties - Modified Source File

11. Rename the servergroup.CC8x_Journ journal export database server


group and port name identifiers within the third section of the
Connection Manager Properties file, as shown in the Figure B-4 example
and the text samples below:
Re-initializing the C•CURE Journal Export Database

Examples:
a. [servergroup.cc8x_journ.defaultconfiguration.defaultservergroup] to
[servergroup.cc8x_journ2.defaultconfiguration.defaultservergroup]
b. configuration=cc8x_journ.defaultconfiguration to
configuration=cc8x_journ2.defaultconfiguration
c. port=erdbsrv to port=erdbsrv2
12. Save the modified Connection Manager Properties file.

13. Using the AdminService for OpenEdge 10.2A, as described in “Using


the Progress Administration Service for Journal Export” on page B-2,
click Start to restart the journal export database server.

14. Create an ODBC DSN for the new database and test it, as described in
the next instruction set (“To Create an ODBC Data Source Name for
Enhanced Reporting”).
15. From the C•CURE 800/8000 Administration application create a
new journal export object for this database.

To Create an ODBC Data Source Name for Enhanced Reporting

1. Select the Control Panel and Administrative Tools from the Windows
Start menu.

Figure B-5: Selecting Administrative Tools from the Control Panel

2. Double-click the Data Sources (ODBC) icon in the Administrative Tools


window (see Figure B-6 on page B-12).

C•CURE 800/8000 Reports Guide B–11


Figure B-6: Selecting the Data Source (ODBC)

The ODBC Data Source Administrator window appears:

Figure B-7: ODBC Data Source Administrator - System DSN Tab

3. Select the System DSN tab and select the ProgressDB system DSN
(see Figure B-7).
4. Click the Add button. The Create New Data Source window appears
with a list of installed drivers see Figure B-8 on page B-13.
A data source name (DSN) specifies a data structure that contains the
information about a specific data source that an Open Database
Connectivity (ODBC) driver needs in order to connect to it.
Re-initializing the C•CURE Journal Export Database

Figure B-8: Select Progress OpenEdge 10.2A Driver

5. Select the Progress OpenEdge 10.2A Driver in the Create New Data
Source dialog box listing and click Finish. The ODBC Progress
OpenEdge Wire Protocol Driver Setup dialog box displays (as shown in
Figure B-9 on page B-14). To configure the ODBC Progress OpenEdge
10.2A Driver, see the next section (“To Set Up the Progress OpenEdge
10.2A Driver”).

To Set Up the Progress OpenEdge 10.2A Driver

1. In the General tab of the Progress OpenEdge 10.2A Driver Setup dialog
box enter field information as shown in Table B-3 and in Figure B-9 on
page B-14.

Table B-3: Progress OpenEdge 10.2A Driver Fields

Field Description
Data Source Name CFSRV (User-defined name of data source configuration, for example, CFSRV or any other name.)

Description: Optional description

Host Name Server where the database is located. You can enter localhost if the database is on the current server

Port Number 2901 (System TCP Port number for the Enhanced Reporting Journal.)

C•CURE 800/8000 Reports Guide B–13


Field Description
Database Name cf (Name of database to which you want to connect.)
NOTE: Must be entered as lower case cf.

User ID Login ID (User Name) to connect to the Database, such as sysprogress or odbcuser

Figure B-9: ODBC Progress OpenEdge 10.2A Driver Setup

2. Click Test Connect to try to connect to the data source using the
connection properties you configured.
If the ODBC driver is able to connect to the data source, it displays a
Connection Established! message.

3. Click OK. The ODBC Progress Driver Setup window reappears.

4. Click Apply.

To Configure Advanced Driver Settings

1. Click the Advanced tab to access the Advanced Progress OpenEdge


10.2A Driver settings.
2. On the Advanced tab, as shown in Figure B-10, select READ
COMMITTED in the Default Isolation Level field to prevent record
locking.

Figure B-10: Set READ COMMITTED in the OpenEdge 10.2A Driver - Advanced Tab

3. Enter a Fetch Array Size (the default value is 50).

4. The Enable Timestamp with Time Zone check box is selected by default.

5. You may also choose to select the Use Wide Character Types. This check
box is not selected by default.
6. Click OK to close the ODBC Progress Driver Setup window and set the
values you entered as the default values when you connect to the data
source.
7. The active data source appears in the ODBC Data Source Administrator
window (see Figure B-11 on page B-16) accessed from the Windows
Control Panel>Administrative Tools.
Figure B-11: Active Data Source in ODBC Data Source Administrator - System DSN Tab

The ODBC Data Source Administrator - System DSN tab lists all system
Data Source Names including that name and associated driver of each DSN.
Double-clicking a system DSN displays the driver-specific data source setup
dialog box.

If necessary, you can change the default values using this same procedure to
reconfigure your data source. You can also override the default values by
connecting to the data source using a connection string with alternative
values.

To prevent record locking, set READ COMMITTED in the Default Isolation


Level field on the Progress OpenEdge 10.2A Driver Advanced Tab. Do not
override the READ COMMITTED default setting.

Software House recommends that two separate DSNs be created, one used for
writing to the database, where the DSN would be setup as Read Committed
(as shown above in “To Configure Advanced Driver Settings” on page B-14),
and another DSN setup as Read Uncommitted to be used for reporting.

You can also set the isolation level in a Transact-SQL command in the
Windows command shell, using SQL Explorer in character mode. Please
refer to the section in the C•CURE 800/8000 ODBC Configuration Guide,
entitled: SQL Statements to Set Database Isolation Levels, for more
information.

B–16 C•CURE 800/8000 Reports Guide


Index

A
Audit Trail tab 2-22
Activity Journal reports
Audit Trail. See Audit Journal reports
creating 2-16
selecting
bi-directional doors 2-37
C
messages 2-33 C•CURE Central Reports 1-64
personnel 2-39 Manual Conflicts 1-64
security objects 2-34 Replication Queue 1-64
Administration Privilege Report 1-43 Server 1-64
displaying reports 1-45 CCURE.INI file 2-3
report sample 1-46 Choose Report Filename dialog box 1-23
Select Screen(s) dialog box 1-44 Configuration reports
View Report dialog box 1-45 configurable 1-13
Administrative Tools B-2 creating new 1-20, 1-25
AdminService for OpenEdge 10.2A B-2, B-5 defined 1-2
Areas and area groups, for roll call reports 1-53 deleting 1-25
Audit Journal reports modifying 1-19
creating reports 2-19 Non-configurable 1-13
displays object names 2-6 overview 1-28
incremental display 2-12 printing 1-22
processes object deletions 2-6 renaming 1-26
reporting options 2-15 saving 1-22
Reporting process viewing 1-21
selecting configuration.CC8x_Journ B-9
message types for reports 2-33, 2-34 Configure Journal Export dialog box 3-19
personnel for reports 2-39 Configuring
security objects 2-34 Journal Export in the Administration
security objects for reports 2-34, 2-37 Application 3-19
users for reports 2-41 roll call reports 1-54
setting replay date and time range 2-11
specifying type of replay 2-15
Index

conmgr.properties B-6, B-8 display results in Excel check box 1-7


Connection Manager Properties B-6 Displaying reports 1-41
Creating
Journal Activity Reports 2-15 E
Journal Audit Reports 2-19
Journal Incident Reports 2- Edit Roll Call Report dialog box 1-56
25 enabling incident tracking 2-25
Crystal Reports 3-19 Enhanced Reporting 3-2
Create New Data Source dialog box 3-8
Crystal reports 1-8
Crystal Reports 3-2
Crystal Reports Viewer dialog box 3-45
Reporting Interface 3-4
Current printer dialog box 1-57 Custom reports 3-29
Custom Journal reports database schema 3-14
overview 3-45 Definitions, Acronyms, and Abbreviations
scheduling 3-48 3-2
Journal Export Database
D overview 3-10
scheduling 3-10
database.CC8x_Journ B-9
selection criteria 3-11
Databases service operation 3-12
changing to a new journal 2-3 Journal table A-3
Enhanced Reporting Database 3-7 OBDC Data Source Administrator dialog box
Journal Export Database 3-7
Schema 3-14 Overview 3-2
Tables 3-15 Predefined Crystal-based reports
users 3-17 descriptions 3-37
Diag System introduction 3-29
enabling incident tracking running 3-29
UseIncidentId 2-25 Predefined Journal Reports 3-30
enabling Roll Call reports for selected Erase export journal B-5
personnel 1-58
Excel
RollCallEnableSelector 1-59
worksheet
maximum rows 1-8
Export Journal Message Structure A-3

G
Generating
predefined enhanced reports 3-30

Index–2 C•CURE 800/8000 Reports Guide


security reports Indexed fields for personnel 1-35
overview 1-2
Groups, area J
for roll call reports 1-53
Journal
databases, changing to a new journal 2-3
H
Journal and Audit Trail Messages that Support
Historical journal Enhanced Reporting 3-47
generating reports 2-8 System Activity message 3-47
incremental display 2-12 System Error messages 3-47
reporting options 2-15 Journal Export Database
selecting Export Journal Database Users 3-17
assets 2-18 initializing a second B-6
message types 2-17, 2-33 overview 3-10
personnel 2-18, 2-39 scheduling 3-10
security objects 2-17, 2-34 selection criteria 3-11
setting service operation 3-12
replay date and time range 2-11 reinitializing B-5
specifying type of replay 2-13 Configure Journal Export dialog box B-5
Schema 3-14
I Tables
Incident tab 2-31 Assets 3-15
Incident tracking Codes 3-16
creating incident reports 2-30 CodeTypes 3-15
definition 2-25 GroupMember 3-16
enabling 2-25 Journal 3-15
Incident ID generation 2-25 Objects 3-15
overview 2-25 Person 3-15
Event Incident 2-29 PersonGroupMember 3-16
incident groups 2-26 Servers 3-15
Viewing Journal Incident Journal Export Service 3-3
Reports Journal Message Structures 3-18
in a Tree Structure 2-48 Journal Replay - Audit Trail Tab 2-23
in Journal Activity Mode 2-46 Journal Replay dialog box 2-10
in Microsoft Excel 2-49
Journal replay. See Historical journal. 2-2
Journal reports
generating 2-8
Journal replay 3-19
Index

Journal replay dialog box 2-8 New Report Name dialog box 1-25
numbering 2-3
Non-configurable Configuration reports
running 2-43
defined 1-27
example 1-27
M
Maintenance Mode 2-14 O
Message types
ODBC
journal reports 2-13 Progress
activity reports 2-15, 2-33 OpenEdge Wire Protocol Driver Setup
audit reports 2-19 3-8
incident reports 2-28 ODBC DSN B-11
Microsoft Excel Open With dialog box 1-24
displaying journal reports in 1-7
OpenEdge 10.2A B-2
Miscellaneous Reports 1-50
OpenEdge 10.2A Driver 3-8
Actions 1-50
OpenEdge Wire Protocol Driver Setup 3-8
Authorized Cardholders 1-50
Authorized Cards on apC 1-50 Opening a Report in Another Application 1-23
Authorized Cards on Controller 1-50
Board 1-50 P
defined 1-2 Personnel Query dialog box
displaying 1-51, 1-65 for Journal 2-39
generating 1-51, 1-65 for Reports 1-33
View Report dialog box 1-51, 1-65 Personnel views 1-35
Modify Field dialog box 1-20 Personnel reports
Monitoring Privilege Reports 1-47 creating 1-30
generate a monitoring privilege report 1-47 defined 1-2
report sample 1-48 displaying 1-38
View Report dialog box 1-48 running 1-37
MS Excel Selecting personnel for 1-31
display results in Excel 1-7 View Report dialog box 1-39
displaying journal reports in 2-46 Predefined Crystal-based reports. See Predefined
Journal reports
N Predefined Journal reports
descriptions 3-37
NetVue Activity Messages
parameters 3-32
view the associated video segment 2-45
running 3-30
scheduling 3-48

Index–4 C•CURE 800/8000 Reports Guide


Print dialog box 1-22 Miscellaneous 1-12
Printer Selection dialog box 1-57 Node 1-11
Printing reports 1-22, 1-23 non-configurable 1-13
roll call 1-57 non-configurable report type 1-13
Progress Partition 1-11
AdminService for OpenEdge 10.2A B-2 Personnel 1-10
Progress OpenEdge 10.2A 3-8 Roles 1-10
Properties folder Roll Call 1-8
Connection Manager Properties B-7 Standard 1-9
Time Specification 1-11
Q Time Zone 1-11
user-configurable 1-13
Query user-defined 1-8
for Journal dialog box 2-39 User-Defined Reports 1-12
In Progress 1-37
Report Customization, for Enhanced (Crystal)
search guidelines 1-35 reports 3-6
Report Generation
R dialog box 1-7
Reinitialize the C•CURE 800/8000 Run Report 1-7
Journal Export Database B-5 Report Generation dialog box 1-27
report Edit Default 1-18
Area 1-10 Edit Report 1-17
Asset 1-9 Language 1-17
Automated Import 1-10 New Report 1-17
C•CURE Central 1-10 Query 1-34
Clearance 1-11 Records Selected 1-34
configurable report type 1-13 Restricted by Group 1-33
configuration 1-13 Run Report 1-18
Door 1-11 Selected Report 1-17
Elevator 1-11 View Last Report 1-18
Event 1-11 With allowed access by Door/Door Group
Groups 1-12 1-33
Guard Tour 1-11 Report Generation for Miscellaneous Reports
Hardware 1-10 dialog box 1-51, 1-65
Holiday 1-11 Report Generation for Monitoring Privilege
Intrusion Zone 1-11
Keypad Command 1-11
Map 1-11
Index

dialog box 1-47 Enter Parameter Values dialog box 3-32


Report Generation for Personnel dialog box 1-30 Crystal Reports Viewer
Report Generation for Roll Call dialog box 3-46
dialog box 1-54 Navigation icons 3-47
working with 1-54 Percentage selector 3-47
Report Generation for Users dialog box 1-40 custom reports
reportJournal 1-9 scheduling 3-48
Reports Edit Report dialog box 1-19
generating
Activity Report
predefined Crystal-based reports 3-30
activity log 2-15
include misread and unknown cards historical journal 2-44
2-18 incremental display 2-12
select assets for report 2-18 message types for reports 2-33
select message types for report 2-17 personnel for journal reports 2-
select personnel for report 2-18 39
select security items for report 2-17 security objects for reports 2-18, 2-34
Administration privilege 1-43 type of replay 2-13
Asset 1-3 incident tracking
Audit Report 2-44 creating incident reports 2-30
changes which are not audited 2-4 definition 2-25
creating 2-20 enabling 2-25
how audit trail displays names 2-6 event incident overview 2-29
incremental display 2-12 incident group overview 2-26
Journal Replay dialog box 2-20 Incident ID generation 2-25
message types for reports 2-33 overview 2-25
security objects for reports 2- viewing incident reports in a tree
structure 2-48
34 specify users 2-41
temporary record 2-6 viewing incident reports in journal
activity mode 2-46
type of replay 2-15 viewing incident reports in Microsoft
Audit Trail. See Reports Excel 2-49
Audit Report Journal Export
C•CURE Central Reports 1-64 configure 3-20
defined 1-2 ODBC tab 3-22
Creating Progress tab 3-23
Activity Reports 2-16 Scheduling tab 3-25
Audit Reports 2-19 Setup tab 3-20
Incident Reports 2-25 SQL tab 3-27
Crystal Reports Journal Export Database Schema 3-14
Journal Replay - Select Items dialog box 2-
35,
Index–6 C•CURE 800/8000 Reports Guide
2-38 Report both activity and audit logs 2-13
Journal Replay - Select Users dialog box 2- Report event incident logs 2-13
42 Journal Replay Audit Reports Report Maintenance Mode activity log
select assets for report 2-22 only 2-14
select personnel for reports 2-22 Select allowable message types 2-33
select security items for report 2-21 Start/End time 2-11
select type of audit replay 2-24 Time Zone 2-11
select types of changes made by users Time zone 2-11
2-23
Journal reports 2-8
select users who have made changes
2-24 Miscellaneous 1-50
Journal Replay dialog box 2-44 modifying 1-19
Journal Replay Incident Reports monitoring privilege 1-47
non-configurable configuration 1-21, 1-27,
select specific incident group for
replaying messages 2-32 1-28
select specific incident ID for replaying options for journal reporting 2-31
messages 2-32 Personnel Query for Journal
Journal Report $System Person View 2-40
Incident group 2-32 Personnel Query for Journal dialog box
Incident ID 2-32 personnel views 2-40
Incident Occurred Date/Time 2-32 Predefined Crystal-based reports 3-19
Journal Report dialog box generating 3-30
displaying activity/audit reports 2-43 scheduling 3-48
Journal Reports printing 1-22, 1-23
Begin replay 2-11 Printing and Saving a Report 1-21, 1-28
Display after replay completes 2-12 Report Generation Dialog Box 1-4
Display results in MS Excel 2-13 Report Generation dialog box 1-16
General tab of the Journal Replay dialog roll call 1-53
box 2-33 Running a Journal Report 2-43
Include Maintenance Mode activity 2-14 Running Customized Journal Reports 3-45
Journal Replay - Select Items dialog box saving 1-23
2-37 scheduling
Journal Replay - Select Message Types
dialog box 2-33 custom reports 3-48
Journal Replay dialog box 2-10, 2-11 predefined journal reports 3-
journal replay dialog box 2-39 48
Language 2-13 Time and Attendance reports 3-48
Replay date/time range 2-11 Time and Attendance Reports
Report activity log 2-13 description 3-38
Report audit log 2-13 scheduling 3-48
types of reports 1-2
user defined 1-62
Index

user privilege 1-40 Target_Folder B-5, B-6


User-Configurable Configuration Reports
1-13, 1-16 Time and Attendance reports
User-suppled Crystal-based reports description 3-38
Custom 3-19 scheduling 3-48
Roll Call Reports
configuring 1-54, 1-55 U
defined 1-2 unexpected re-formatting cells 1-8
displaying on Monitoring Station 1-54, 1-55 UseIncidentId, entry in Diag System 2-25
Edit Roll Call Report dialog box 1-55 User defined reports
editing 1-55 customize 1-62
for selected personnel 1-58 defined 1-2
generating a roll call report for selected
personnel 1-58 User Privilege Reports
overview 1-53 Admin Priv Report 1-44
running 1-57 Administration privilege 1-43
samples 1-60 defined 1-2
selecting a printer 1-56 generate
working with 1-54 administration privilege report 1-43
Run Roll Call Report dialog box 1-57 users report 1-40
monitoring privilege 1-47
overview 1-40
S
Report Generation for Administration
Saving reports 1-22, 1-23 Privilege dialog box 1-43
Scheduling system users 1-40
custom reports 3-48 Users of Admin Priv Report 1-44
predefined journal reports 3-48 Users of Screen Report 1-44
Time and Attendance Report 3-48 View Report dialog box 1-41
Search 1-5 User-Configurable Reports 1-16
servergroup.CC8x_Journ B-10 Users Report 1-40
Software House Member Center 0-xi Using the DiagSystem Utility for Setting Up
Journal Export B-2
SQL syntax 3-17
Stop Query 1-38 V
T View Report dialog box 1-20, 1-22, 1-24
sample Clearance Report 1-28
Table Field Name Standards A-2
Viewing
naming suffixes A-2
configuration report 1-21
configuration report in Microsoft Excel/

Index–8 C•CURE 800/8000 Reports Guide


Word 1-23
Journal Activity Reports
in MS Excel 2-46
NetVue messages 2-45
Journal Activity/Audit Reports 2-43
Journal Incident Reports
in a Tree Structure 2-48
in Journal Activity Mode 2-46
in Microsoft Excel 2-49
Reports
in Microsoft Excel 1-7

W
Wildcard search 1-5
examples 1-5
Windows Scheduler Service
starting 3-50
verifying it is running 3-50

You might also like