Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Version 2.3.0.1
Change Log Created 2009-12-03
Proofread by D.Glebenok: 2009-W50. 1 change incorporated W51
Topic Creating a BIS-compatible report using Microsoft Report Builder
Table of Contents
1 INTRODUCTION 2
1.1 INTENDED AUDIENCE 2
1.2 OVERVIEW 2
1.3 ABBREVIATIONS USED 2
1.4 TYPOGRAPHICAL CONVENTIONS USED IN THIS DOCUMENT 2
2 INSTALLATION AND PREREQUISITES 2
2.1 PREREQUISITES 2
2.2 INSTALLATION STEPS 2
3 CREATING A BIS-CAPABLE REPORT 3
Page 1 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
1 Introduction
1.1 Intended Audience
System administrators who wish to use Microsoft SQL Server Report Builder to create new
report formats, or customize old formats, for display in the BIS Event Log.
1.2 Overview
This document takes the system administrator step-by-step through a simple example of
creating a new report which can later be viewed in BIS. For more detailed information about the
use of the Microsoft Report Builder, please consult the manufacturer’s documentation.
1.3 Abbreviations used
BIS: Building Integration System from Bosch Security Systems.
MRB: Microsoft Report Builder.
1.4 Typographical conventions used in this document
Names of locations (directories), files, tabs and controls in bold
Commands to be entered by the user in courier font
2 Installation and prerequisites
2.1 Prerequisites
BIS is successfully installed on a server in your network. An SQL Server 2008 instance was
successfully defined for the BIS Event Log during the BIS installation.
2.2 Installation steps
The Microsoft Report Builder (hereafter MRB) is provided on the BIS installation DVD under the
following directory:
BIS\3RD party\SQL2008\ReportBuilder\2.0\
Double-click the .msi file to install the Report Builder.
Page 2 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
During the installation you will be prompted to enter the Report Server. This is the SQL Server
2008 instance which you defined for the Event Log during the installation of BIS. You should
enter this analogously to the following form (assuming that you gave your SQLServer 2008
instance the default name of BISReports)
http://<Name_of_your_SQL2008_Server_computer>:8080/Reportserver_BISReports
3 Creating a BIS-capable report
Step Action Result / Screenshot
1 Start the Report
Builder
Page 3 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
2 Select the edge of
the data container
and delete the
wizards by
context menu.
3 Insert a table by
right-clicking and
selecting Insert >
Table.
The Dataset
Properties dialog
appears.
Page 4 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
4 Click New… to
open the Data
source properties
dialog. Select the
Radio button Use
a shared
connection…
Click the
Browse… button.
Report Builder
retrieves the
name of the
source from the
network. This
should be (or
should include)
the Event Log
Datasource
defined during
setup.
Select it and click
OK.
Page 5 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
5 From the Dataset
properties dialog
select the Query
type Stored
Procedure.
For this example,
select the stored
procedure name
getAddresses
Page 6 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
6 Name and
manipulate the
table to the
desired format.
We have called
our example My
new report
Page 7 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
7 Configure the
table by dragging
the desired data
into the desired
columns.
Page 8 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
8 Apply any other
formatting you
desire for the
table.
Page 9 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
9 Test the report
within the Report
Builder by clicking
Run
Page 10 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
10 View the resulting
table within
Report Builder.
Page 11 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
11 Return to the
Report Designer
by pressing F8
Page 12 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
12 As a security
measure, BIS
always queries
the parameter
userPermission
before displaying
a report.
Hence we need to
add this
parameter to all
reports displayed
by the BIS Event
Log.
Right-click
Parameters and
click Add
Parameter…
Page 13 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
13 The Parameter
must be named
userPermission.
Blank and null
values should be
allowed, and it
can remain
hidden (i.e. the
parameter need
not appear at the
top of the report
in the BIS event
log).
If the parameter is
not to remain
hidden, then a
suitable prompt
text can be
entered under
Prompt:
Page 14 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
14 Ensure that the
parameter
userPermsission
now appears
under the
Parameters
directory
Page 15 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
15 Save the report in
the My Reports
directory.
We have named
our example
MyNewRep.rdl
Page 16 of 17
Security Systems
From Our Reference Tel Fax Location OT
ST-ACS/PG PBR Date: 12/15/2009
White Paper
Creating a BIS-compatible report using Microsoft Report Builder
16 Start the BIS
Client (or refresh
the reports list
with the refresh
button). The new
report appears as
MyNewRep in the
list of reports (see
step 15), and My
New Report in
the title (see step
6). Paging is
handled
automatically.
End of procedure
Page 17 of 17
