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