Professional Documents
Culture Documents
Ccure 800 8000 v10 - 3 Reports Guide - rh0 - LT - en
Ccure 800 8000 v10 - 3 Reports Guide - rh0 - LT - en
Version 10.3
Reports Guide
REVISION H0
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.
Preface
How to Use this Manual........................................................................................viii
Conventions Used in This Manual............................................................................x
Finding More Information.......................................................................................xi
Software House Customer Support Center............................................................xii
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
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
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
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
NOTE Indicates a note. Notes call attention to any item of information that may
be of special importance.
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.
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
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.
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.
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
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.
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.
3. Click Search....
The Object List field shows results such as:
• officebuilding1
• officebuilding12
• officebuilding212
Using Wildcard Search
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:
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:
Period
The search string for any period should include two ~~ in front. For example,
to search for *..* you need to input the following string: *~~.~~.*
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.
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.
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.
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
Door Door
Elevator Elevator
Event Event
Floor Floor
Map Map
Node Node
Miscellaneous Actions
Authorized Cardholders
Authorized Cards on apC
Authorized Cards on Controller
Board
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)
Area
Event Clearance
Clearance
Custom Clearance
Door Clearances
Partition
Partition Configuration
Partition
Floor Holiday
Holiday List
Holiday
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.
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
Table 1-4: Report Generation Dialog Box Fields and Buttons for Configurable Reports
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
2. Select an application from the list and click OK to open your report in
the selected format.
Creating a New Configuration Report
1. On the Report Generation dialog box, click New Report. The New
Report Name dialog box, Figure 1-10, opens.
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.
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.
Table 1-6: Report Generation Dialog Box Fields and Buttons for Non-Configurable Reports
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.
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.
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.
NOTE The Run Report button is unavailable until you perform a query.
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.
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.
Table 1-7: Report Generation for Personnel Dialog Box Fields and Buttons
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.
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.
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.
NOTE If no records are found by the query, the system displays a message.
When you run the query, the Personnel Query in Progress dialog box
opens, as shown Figure 1-16.
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.
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
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.
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.
2. Select the report you want to generate from the Select Report 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:
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.
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.
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. 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.
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.
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.
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
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.
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.)
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
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.
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.
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.
Example:
You might need a report that lists all the fire wardens in a building and
the floor for which each is responsible.
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
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:
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.
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
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
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.
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
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.
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.
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.
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.
Example:
If a clearance is deleted, the audit messages record changes to all
personnel records which included that clearance.
Example:
The second reader on the third floor apC/8x panel 3rdFC1 would be
named 3rdFC1 apC:1 R2.
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.
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
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.
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
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
Include Select this option to include all activity messages from Intrusion
Maintenance Zones in Maintenance Mode.
Mode activity
Creating Activity Reports
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.
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
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
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.)
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
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.
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
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
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
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
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
To enable Incident ID
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
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.
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.
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.
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
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
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
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.
NOTE Microsoft Excel must be installed on your system to view results in Excel.
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.
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
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.
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.
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
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.
2. Click Add. The Create New Data Source dialog box opens, shown in
Figure 3-4.
4. Enter all relevant information in the dialog box and click Apply.
5. Click OK.
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
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.
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.
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.
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
The Journal Export database consists of the tables shown in Table 3-1.
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.
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
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.
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.
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.
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.
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.
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.
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.
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
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.
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\
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.
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.
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.
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.
OK Click to complete the report. The Crystal Report Viewer dialog box
is displayed, as shown in Figure 3-21 on page 3-46.
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
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.
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
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
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
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
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.
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.
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
Search Text Click to search for a specific text segment within the
report. (Tool is not case-sensitive.)
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
3. Click Next.
4. Click Browse to select the location of the batch (*.bat) file to run.
6. Specify the name of the job and it’s frequency (daily, weekly, monthly,
etc.) and click Next.
8. Enter the Windows username and password that is used to run the job,
confirm the password, and click Next.
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
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.
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.
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
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)
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
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
Notes:
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
In this appendix
Using the Progress Administration Service for Journal Export..............................B-2
Re-initializing the C•CURE Journal Export Database .............................................. B-5
1. You can also open a Windows command shell and change directory to the
\CCURE800 directory.
>cd d:\ccure800
1. You can also open a Windows command shell and change directory to the
\CCURE800 directory.
>cd d:\ccure800
NOTE The Progress Administrative Services must be running when the above
commands are executed.
1. Create a folder on the hard drive where the new export database will
reside.
Example:
D:\ENReports2
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.
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
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.
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.
1. Select the Control Panel and Administrative Tools from the Windows
Start menu.
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
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”).
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.
Field Description
Data Source Name CFSRV (User-defined name of data source configuration, for example, CFSRV or any other name.)
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.)
User ID Login ID (User Name) to connect to the Database, such as sysprogress or odbcuser
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.
4. Click Apply.
Figure B-10: Set READ COMMITTED in the OpenEdge 10.2A Driver - Advanced Tab
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.
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.
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
G
Generating
predefined enhanced reports 3-30
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
W
Wildcard search 1-5
examples 1-5
Windows Scheduler Service
starting 3-50
verifying it is running 3-50