dream report getting started v3.3.pdf

35
Dream Report® Getting Started

Upload: kristen-collier

Post on 25-Dec-2015

295 views

Category:

Documents


4 download

TRANSCRIPT

Page 1: Dream Report Getting Started v3.3.pdf

Dream Report® Getting Started

Page 2: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 2/35

Table of Content

1. APPLICATION INTRODUCTION ............................................................................ 3

1.1. WARRANTY / TRADEMARKS........................................................................................ 3 1.2. CUSTOMER SUPPORT ............................................................................................... 3 1.3. SYSTEM REQUIREMENTS ........................................................................................... 3

2. INSTALLATION .................................................................................................... 4

2.1. INSTALLATION ....................................................................................................... 4 2.2. REMOVE / MODIFY ................................................................................................. 4 2.3. UPGRADE FOR A NEW MAJOR OR MINOR RELEASE ............................................................... 5 2.4. FOLDERS ORGANIZATION .......................................................................................... 5

3. PRODUCT OVERVIEW ........................................................................................... 6

3.1. BASE CONCEPT ...................................................................................................... 6 3.2. KEY DIFFERENTIATION ............................................................................................. 6 3.3. TECHNOLOGY ........................................................................................................ 6

4. PRODUCT INTERFACE .......................................................................................... 7

4.1. DREAM REPORT STUDIO ........................................................................................... 7 4.2. DREAM REPORT RUN TIME ........................................................................................ 7 4.3. DYNAMIC REPORT GENERATOR ................................................................................... 7 4.4. DREAM REPORT WEB PORTAL ..................................................................................... 8

5. PROJECT WORKFLOW .......................................................................................... 9

6. BUILDING A DREAM REPORT APPLICATION ...................................................... 10

6.1. STARTING PROJECT DEVELOPMENT BY LAUNCHING STUDIO ................................................ 10 6.2. USER MANAGEMENT .............................................................................................. 11 6.3. PHASE 1 – CONNECTION TO DATA SOURCES ................................................................. 12 6.4. PHASE 2 – DATA AND ALARM LOGGING ....................................................................... 13 6.5. PHASE 3 – REPORT DESIGN .................................................................................... 14 6.6. PHASE 4 – STATISTICAL AND ANALYTICAL VALUE EXTRACTION ............................................ 15

Object 1 - Single Data ............................................................................................ 15 Object 2 - Compound Data ..................................................................................... 18 Object 3 - Expression Data ..................................................................................... 19 Object 4 - Data Table ............................................................................................. 19 Object 5 - Alarm Table ........................................................................................... 20 Object 6 - SQL Table .............................................................................................. 21 Object 7 - Step Table ............................................................................................. 22 Object 8 – Automatic Statistical Table ...................................................................... 23 Object 9 - Free Table ............................................................................................. 24 Object 10 – Pie Graph ............................................................................................ 26 Object 11 – Bar Graph ........................................................................................... 27 Object 12 – Chart .................................................................................................. 28 Object 13 – Date and Time ..................................................................................... 30 Object 14 – Page Number ....................................................................................... 30 Object 15 – Report Name ....................................................................................... 30 Object 16 – Project Name ....................................................................................... 30

6.7. PHASE 5 – REPORT GENERATION AND DISTRIBUTION SETTINGS .......................................... 32 Report Generation On Schedule ............................................................................... 32 Report Generation On Condition .............................................................................. 33 Report Distribution................................................................................................. 33

RUNNING AN APPLICATION WITH DREAM REPORT RUN TIME .................................. 34

6.8. LAUNCHING DREAM REPORT RUN TIME........................................................................ 34 6.9. REPORT ON DEMAND ............................................................................................. 35

Page 3: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 3/35

1. Application Introduction

Dream Report is an advanced Enterprise Information Integration (E.I.I) and Proactive Reporting system enabling any company to log Data and Alarms from multiple data sources or connect to most historian

databases to create, generate and distribute advanced reports for a variety of industries.

1.1. Warranty / Trademarks

This document is for information only and is subject to change without prior notice. It does not represent a

commitment on the part of Ocean Data Systems. If you find any problem in the documentation, please

report them in writing. Ocean Data Systems does not warrant this documentation error-free. © Copyright 2004-2008 by Ocean Data Systems.

Dream Report® and Dream Connect™ are trademarks of Ocean Data Systems. All other products and brand names are trademarks of their respective companies.

1.2. Customer Support

You can receive technical support from your local distributor. To receive prompt support, make sure that

you complete the activation form available from Dream Report® Studio and send it to Ocean Data Systems at [email protected]

1.3. System Requirements

Before you install the application verify that you have the following Hardware:

Computer: Minimum Pentium IV 1Ghz

Memory: 256MB (recommended 512MB) Hard Disk: 150MB minimum for installation only

Operating systems supported:

Windows 2000 Professional,

Windows 2000 Server,

Windows XP Professional Edition,

Windows 2003 Server

Additional Software Requirements:

To visualize PDF files - you have to install Adobe Acrobat Reader

To use the Web Portal - you have to install IIS (Internet Information Server version 5.0, 5.1 and 6.0)

Page 4: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 4/35

2. Installation

2.1. Installation

Please launch the executable file named „DR_Release_Setup x.y.z.exe‟, and read carefully the End User

License Agreement.

Dream Report® has “Custom” installation type – By installing Dream Report the user will get a

“Components Dialog” where it is possible to select only the components that the user would like to install for his needs.

The user may specify the path where he would like to install Dream Report® on his computer but we

recommend keeping the default path.

The user can deactivate Dream Report Design Studio.

The user can select connectivity drivers from the available list. By default only 4 drivers are selected:

OPC driver, Simulation driver, ODBC driver and Analytical driver:

When finished, the user will be asked to restart his computer; some components have to be registered on

start-up of the operating system.

2.2. Remove / Modify

It is possible to modify or to remove Dream Report® from the computer by either:

1. Launching the original installation executable. 2. Or, in the windows control panel Add/Remove programs component.

Be aware that not all folders will be removed during uninstall process. Directories containing all developed

files will not be deleted. Also License and Template directories will not be erased.

Page 5: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 5/35

2.3. Upgrade for a new major or minor release

If the Dream Report® installer procedure auto upgrade feature is activated, it will automatically recognize

the version previously installed and start the upgrade. During this process all new files will be copied to

the appropriate place.

2.4. Folders Organization

By default the program installs the program in: “C:\Program Files\ODS\Dream Report”

And installs the following folders

Clipart : Library of Reports Backgrounds and Images Database : Multilanguage file (lexicon.mdb)

DR_Web_Portal : For all web configuration files

Help : With the Online Flash help files License : Where your product license and registration form will be saved

Project : Where all projects by default will be saved

Release Notes : With all the latest information about new release

Systems : With all the system application Files Templates : Where all templates will be saved

Utilities : Some utilities (Acrobat Reader, HASP driver etc.)

Page 6: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 6/35

3. Product Overview

3.1. Base concept

The Dream Report® concept is based on the integration of 5 functions. This unique combination positions it as the best proactive reporting solution available in the market.

3.2. Key differentiation

Dream Report® is a unique solution for three reasons: 1. It includes a communication kernel like any manufacturing system (HMI, SCADA, DCS systems…)

2. It enables data and alarm logging to any relational database

3. It generates and distributes reports in real time through its unique and powerful Run Time engine.

The integration of these unique functions into a user friendly studio, positions Dream Report® as the most

intuitive and easy to use complete reporting solution available in the market today.

In fact Dream Report® is the first reporting solution that can run in a standalone mode, collecting and

logging data itself, or be connected to any 3rd party system leveraging their historical database.

Two days training is usually enough to completely learn the product. This unique product allows customers

a unique advantage; they can avoid complex solutions based on the integration of multiple modules and

skill sets. Thus, the product adoption is fast and minimal support is needed to be fully autonomous.

3.3. Technology

Dream Report® was developed with the latest technology standard. It can exchange data using

Automation and Enterprise technologies such as OPC, Web Services, based on the new Microsoft .NET

Framework. Dream Report® Logger enables you to log clean and accurate data in any standard database such as SQL server, Oracle, Access, My SQL and more.

Dream Report® generates Reports in PDF format, but can also export all data into an Excel file.

Page 7: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 7/35

4. Product Interface

The product is divided in 2 main modules called “Studio” and “Run Time”.

Basically, projects are developed with the Studio, and executed with the Run Time.

4.1. Dream Report Studio

Dream Report Studio defines and configures:

Connection to real data sources

Connection to any historical database

Archive conditions for real time data and alarms Create and modify report templates

All statistical and analytical objects

Define report generation conditions Define report distribution

Project settings (user management, language, web,

macros, database …)

4.2. Dream Report Run Time

The Run Time executes and manages:

The access rights

The data and alarm acquisition

The data and alarm logging The queries to all historian databases

The report generation

The report distribution The web Portal

Moreover, for the day to day report management the Dynamic Report Generator Module and

Dream Report Web Portal have been developed.

4.3. Dynamic Report Generator

Dynamic Report Generator (DRG) enables you to change report settings and execute new reports on

demand without opening and making any change from the Studio.

This module is ideal to control and drive new report generation from any application (HMI, SCADA, DCS, MS Office, Windows …). It is available as

an ActiveX, a Web interface from the web portal and a Windows

application.

For any report available, the user can:

1. Either change the report period or force all objects in the template with a new time interval (for example template was

made for a daily report and he wants a weekly report). Also user

can select different batch id for a batch process report.

2. Or force the CPU time, in this case objects setting doesn‟t

change, DRG will generate a new report not based on the current date and time but the specified date and time selected.

3. User can specify a different report target for currently generated report.

Dream Report Studio

Dream Report Run Time

Page 8: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 8/35

4. The user can also dynamically change SQL WHERE condition in SQL tables defined in selected

report.

5. Finally users can also dynamically change data sources and tags assigned in the template selected using the mask.

4.4. Dream Report Web Portal

With Dream Report Web Portal any authorized user can access over the intranet or the internet any Dream Report Station to:

Visualize all reports archived

Generate new reports on demand

Change report settings before generation

The Dream Report Web Portal is ideal for distributing reports across the enterprise but also to customers,

organizations, suppliers and more…. It can be customized and fully integrated within any customer web portal

To access the Dream Report Web Portal the user must login

with his valid username and password.

Then he visualizes the list of his authorized reports with the

date and time of the last generation and the number of reports

in the history folder.

The portal will be automatically updated, each time the Run

Time generates a new report. The user can also force the Run

Time to generate a new report on demand.

Page 9: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 9/35

When he selects a report in the list, he switches automatically to the report summary.

The Dream Report Web Portal displays the latest report generated and also a list of previously generated reports that can be displayed by clicking on the report icon.

Users are free to add comments, print or email the report displayed.

5. Project Workflow

The following is a suggested workflow for designing an application

Phase 1 – Identify all real time sources and historical databases needed in the project

Phase 2 – Define some logging groups to create the historian database for the real time Data

Phase 3 – Create the report templates

Phase 4 – Extract all analytical values to put in reports Phase 5 – Define the automatic generation and distribution settings for each report

Page 10: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 10/35

6. Building a Dream Report Application

6.1. Starting Project Development by launching Studio

This icon will launch Dream Report studio

The following Wizard will open, allowing you to

open an existing project or to create a new one.

Configuration projects are saved with the suffix

*.drpj. When the project opens on your screen the

name of the project appears on the top bar of the

Studio.

When you open a new project, you must define the project settings.

The Wizard has 6 tabs:

- General - To define the project name, author and also users with their

associated rights

- Database Configuration -

To select the database used for logging data and its properties and

size limitations

- Web Configuration -

To list all stations connected over the web

- Project Path -

To define the folders and their location for reports, web, historians

- Log File -

To track all events

- Language -

To switch the Studio User Interface language online

Then the Studio opens. To facilitate product project development, the studio is divided in 2 sections named

Logger and Designer.

Logger Studio

Designer Studio

Page 11: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 11/35

To configure data source connections and data logging (Phase 1 and 2) you must display the Logger

Studio. To design reports and define their properties (phase 3, 4 and 5) you must switch to the Designer

Studio.

The navigation between the 2 sections is

done in the left side of the studio through

the buttons: Logger Studio

Report Designer Studio

This navigation methodology was not only done to facilitate project development, but also to protect the configuration of the communication and the database. Frequently System Integrators and project

engineers prepare all data needed to develop reports and give access rights to different end users

(management, finance, production …) to create their own reports without any risk to alter the data pipe.

6.2. User Management

From the project settings, in the General tab, you can open the user management windows.

There is no limitation in terms of users.

You simply must define a name and a

password and the rights for each user.

- Designer Studio -

Enables user to define and modify reports

- Logger Studio -

Enables user to define and modify driver configuration and logging properties

- Run Time - Enables user to control the Run Time

- Web Portal - Those users will have access to reports

over Dream Report web Portal

- User definition -

Enables user to define or modify user‟s

authorizations

Please note that each user can be suspended temporarily and can expire on a predefined date. It is also

possible to load Studio with a different language for each user.

Page 12: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 12/35

6.3. Phase 1 – Connection to Data Sources

To connect data sources you must define drivers

Then the driver configuration Wizard appears

Dream Report® supports 3 types of drivers

Real Time Data Real Time Alarms

History (using ODBC, HDA or custom

driver access)

Native drivers to SCADA systems for example

support all 3 drivers. This means you can

access their Data and Alarms in real time but also read their native history.

Dream Report® integrates OPC DA, AE and HDA Client. This means any OPC Server can connect and exchange data, alarms and history with it.

That‟s the reason why Dream Report® can be directly connected to most Devices, I/Os, PLC, Field buses,

Manufacturing Systems and other open applications.

Connection example and access with a history database

Suppose you have an access database to connect to Dream Report®, its structure is columns based and has multiple tables.

1. First step is to create the DSN using Microsoft ODBC driver to connect data source, we call it

“Process”. Process DB is a simulation database based on which our Demo is built. 2. Then in Dream Report Driver Configuration you declare a new data source named Process

3. You select History Driver “ODBC”

4. you click on Configure and the following Wizard

appears

5. You select the DSN previously created

6. You define the database structure (column in this

case) 7. You click on the Connect Button, and you will

see all tables for this database

Then, because Dream Report® supports predefined Data

and alarms objects, you simply must indicate by tables:

1. The field used for the Timestamp if you want to extract data Only

2. The Fields used for the alarm ID, Text, Priority,

Start time, End time and Ack time.

Thus, your database will be fully available in each Dream

Report Object.

Don‟t forget to click on Done to close this Wizard and to

add and save this driver instance definition to your list.

Page 13: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 13/35

6.4. Phase 2 – Data and Alarm Logging

Dream Report® enables you to connect multiple Real Time sources of data and alarms. Users can create

clean and accurate history for these data and alarms by defining logging groups.

Basically, users can create as many groups as

needed to obtain the optimum database configuration.

Groups are defined from the Logger Studio. Then the left part of the interface in divided

into 2 sections

Data Groups Alarm Groups

For Both the concept is the same. You simply

right click in the group area and Add Item Group. Then The Group Definition Wizard

is displayed.

You give a name for this group, select the

data source origin and click on the Add

Item button to select the Data wanted. The SHIFT and CTRL key will help you to

select data.

If you are creating Groups of alarms, an Alarm Priority filter is used to define the group.

(Ex: Group_Alarm1 from SCADA is between priority 0 to 50; Group_Alarm2 between 51 to 100 …)

Then, you simply define the

logging conditions.

< On Change, Each, On

Absolute and On Item Value Change

A scheduler enables you to log

data differently each day if needed

Enable Record On Event >

Any data from any data source can

be used as a condition

The actual Dream Report Release enables you to log more than 1000 events/sec (benchmark made with SQL Server 2005).

Page 14: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 14/35

6.5. Phase 3 – Report Design

Once all real time data sources are connected and database connectivity ready, you can shift to the

Designer Studio. To create a new report, right click in the list of reports and select New Report.

Designer Studio was built to be used by

any operator.

A Report can be made with multiple

pages. The following icons are the most used to create attractive reports

Add Page

Insert Text

Insert Picture / Logo

Insert background

The background can either be a color, or an image. If it‟s an image, this image can be applied to all pages

or to a specific page only.

Regarding Colors, Dream Report Designer Studio allows you to select the color

for fonts, lines and background.

The product also manages the transparent color and allows you to define your

own palette.

Page Template / Report Template

Any Report can be saved as a page or a report template to be loaded anytime to create new reports more quickly.

When you save a Page Template, the system only captures the static objects like Text, Forms, Images,

Background and also the base Objects, Date & Time, Report Name, Project Name and Page Number.

When you save a Report Template it captures the entire report with all Objects attached such as Pie, Bar,

Charts, Tables…with their base configuration (data source, tags and time settings).

Page 15: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 15/35

6.6. Phase 4 – Statistical and Analytical Value Extraction

The following toolbar allows you to extract data analysis using different object views.

Objects can be divided by categories.

The first 3 objects perform Data analysis and represent it as a text Result

Object 1 - Single Data

A. Definition

In the definition tab of the Wizard you select any tags coming either from “Dream Report History” or from any

“native historian Database” for any relative and/or absolute

time period:

The Current value

The Last value The Maximum value

The Minimum value The Sum value

The Integral value

The Average value The Weighted Average

It also provides the:

The timestamp of the First value

The timestamp of the Last value The timestamp of the Maximum value

The timestamp of the Minimum value

It calculates directly:

The System Availability (i)

The Standard Deviation (i)

Moreover it allows you to count: The number of values logged in the Database (i)

The number of alarms for an interval of priorities (i)

The duration between any value interval (i) To define your own counter with min-max limits (i)

On – OFF – ON/OFF (i)

It also calculates KPIs:

MKT – Mean Kinetic Temperature

And finally enables you to directly insert any SQL command (i)

(i): detail explanation just below

Know more about:

System availability: Gives you in % the time during the value was not equal to 0 for the period selected

In this example the system availability was

75% for 1hour

Text Objects

Page 16: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 16/35

Standard deviation:

The standard deviation is defined as the square root of the variance. This means

it is the root mean square (RMS) deviation from the average. It is defined this

way in order to give us a measure of dispersion that is a non-negative number, and has the same units as the data. For example, if the data are distance

measurements in meters, the standard deviation will also be measured in meters.

Number of values

logged in the database:

Count how many values are logged for the

value range specified

In this example if we count values between 100 and 200, result will be 2

Duration

Calculates the Duration time in HH:MM:SS for

the value Range specified.

In this example:

The Up time (1 to 1) is 00:45:00

The Down Time (0 to 0) is 00:15:00

ON - OFF Counter

Calculates how many times the digital tag went from 0 to 1 (ON) or 1 to 0 (OFF)

In this example: there is 3 ON and 2 OFF

ON/OFF Counter

Calculates a complete On OFF Wave

In this example there is 2 complete ON/OFF waves

Counter

Counts pulses from 0 to 4.294.967.296

If your pulse source has limits, please indicate

it to continue counting continuously. Dream Report will automatically recognize the rollover

of the source unit.

Alarm Counter

Count how many alarms are in the priority range specified

Do not forget to define alarm filters first

To create Filters you simply: Give a name

Select the alarm data source

Define the priority range

Add it as a new Filter

Then select the Group of alarms

you want to count and click OK.

Page 17: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 17/35

SQL Command

You can also directly define an SQL command

B. Representation

In the second tab of the wizard

You can select the following option:

Visible / Invisible: to display or not display the

analytical data in the report

Unit: the engineering unit selected will be automatically

displayed with the result

The decimal precision is configurable between 0 to 6

digits

The write back option enables to write the analytical item result of on any tag to any source connected

Show Result As option allows you to present a

calculation as a number – “Default Calculation”, as Bar Code and as Duration

The advanced display options enables:

A - To change numeric color (do not put text) Example: 0 to 10 -> Blue

11 to 90 -> Green

91 to 100 -> Red

B - To replace numeric by Text; Example

0 To 0: Stop

1 To 1: Run

Page 18: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 18/35

C. Advanced SQL Condition

It is an SQL WHERE command that enables you to add a specific condition to adjust the query.

For example: I want the Minimum Tank Value for January but only when Batch process was equal to 4

I will select the Tank level Tag

Insert period from Jan 1 to Jan 31

Put a Where command : where Batch= 4

Object 2 - Compound Data

Definition

Displays all previous analytics made and allows a manual selection (using SHIFT and CTRL KEY and

Mouse) to calculates between them:

The maximum

The Minimum

The Sum The Average

Objective is to enable fast calculations without doing

any expressions.

Page 19: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 19/35

Object 3 - Expression Data

Definition

Enables expressions using standard instruction

Mathematic

Boolean Trigonometric

User can mix analytical values and tags from different data sources.

The next six objects display a series of tags and alarms in table form

Object 4 - Data Table

A - Definition

This table displays a list of tag values. In the definition tab you select one or more tags

(click on Edit List) either from “Dream Report

History” or from any “External historian Database”.

You can choose to display from any relative and/or

absolute time period:

The Data logged in the database

The Moving Average values

A filter based on the value range and the Advanced

SQL condition tab, will help you to adjust your table query and visualize precisely the right information.

Example 1

B- Appearance – 3 columns orientation & Column-

Item Orientation

Table Objects

Page 20: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 20/35

Example 2

In the appearance options, you can define The table name

Set which column you want to display

(timestamp, source name, tag name, value) Customize the title of each column (click on

caption text)

Change all font properties

Set how many records you want to visualize Sort from the ending or from beginning

Object 5 - Alarm Table

A - Definition

It‟s a predefined object that extracts alarms

from either “Dream Report History” or from any “native historian Database”

The user must first create alarm filters (click on Edit List) and select the ones you want to

visualize in table

Use the CTRL Key to select multiple filters

After selection of the filter, select the time

period.

Page 21: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 21/35

B- Appearance

In the appearance section, you can define

– The table name

– Set which column you want to display (Start time, Ack time, End time, alarm text and

priority) and the order (move Up, Down)

– Customize the title of each column (click on

caption text, and change text as wanted) – Change all font properties

– Set how many records you want to visualize

– Sort from end or from start – Response Time

– Duration of Alarm

Alarm Table example

Object 6 - SQL Table

A - Definition

If the Data table and Alarm table don‟t meet your objective,

you may use an SQL table

The objective is to simply create your own table with the

desired fields.

This object is very powerful, and enables you to precisely extract and sort the Data you want to visualize

Directly insert the query against the database you want with all conditions attached.

Example:

Select start_time, end_time, priority, user, family, alarm from alarm where batch=[f#Previous_Batch] and family='tank3'

If user doesn‟t know how many columns are in the SQL

table, it is possible to write the following statement: SELECT

*. The width of each column will be set according to the size preset in the report.

Page 22: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 22/35

B- Appearance

Like other tables the appearance option enables you to

customize the entire table.

The key feature of the appearance option is the direct

capture of all fields in the select command of your SQL

query

The SQL table automatically creates the columns and

enables you to personalize the title of each column.

This simplifies the integration of any database with

Dream Report.

SQL table example

Object 7 - Step Table

A - Definition

This table was especially developed to periodically

display statistical values coming from moving tags

typically occurring in the automation Market.

The First step is to build the table structure

– Define number of columns – The time period

– Define the step (from minutes to Months)

Be careful you must adjust the time period to the step

otherwise you can be overwhelmed with data.

Ex: never select days in period if you want minutes as step

You will create thousands of calculations

STEP table example 1

Step Table can be presented in two ways, vertically and horizontally. This option can be specified in

Appearance.

Page 23: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 23/35

B- Appearance

The key thing in the appearance is to assign for each

column defined, the statistical value.

This is done through the last column in the right side

named Column Type

You can put the timestamp or a tag If you select tag, you will open the single data object with

all statistical values available: Last value Maximum value

Minimum value Sum value

Integral value

Average value Weighted Average

Duration Counters

STEP table example 2

In addition to step statistic calculation, the user can do advanced calculations on values calculated in the

step table and present results in the footer.

Object 8 – Automatic Statistical Table

A- Definition

The key thing in the AST object is

assigning for each item various

statistical calculations in a very fast and intuitive way.

This is done through the selection of items and then specifying functions

on the right that will be calculated in

the report.

When you select a tag, you will then

select statistical functions:

Last value Maximum value

Minimum value

Sum value Integral value

Average value

Weighted Average Duration

Counters

Page 24: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 24/35

B – Appearance

Here you can design the look and fill of AST object.

Automatic Statistical table example 1

Object 9 - Free Table

A- Definition

B – Appearance

For the table appearance use directly the

design toolbar in the main menu

You can change the color of:

Each text

Each cell background Each cell line

You can also change font and size for each text

A free table presents a collection of objects in table format.

Basically you define the number of columns and rows, and

then define for each cell its content.

You can Insert:

Free text Date and Time

Single data

Compound data Expression data

To do so, you just right click with your mouse in the cell The following menu will appear.

Free table example 1

Page 25: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 25/35

Free table example 2

Page 26: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 26/35

The next three objects are graphical objects; they enable the display or statistical values with different

views

Object 10 – Pie Graph

A- Definition

From the Pie Wizard you can define Pie Graphs of:

Data values Alarms

Logged values

Data are either from “Dream Report History” or from any “native historian Database”.

a) If you define a Pie of Data values then

you can compare

between multiple tags.

Last value

Maximum value Minimum value

Average value

b) If you define a Pie of Alarms, it means you want to

compare alarms from different groups

c) If you define a Pie of Logged values, it means you

want to compare logged values for different value

ranges.

B - Appearance

In the appearance options, you can define the Pie name

and display: – Pie legend

– Pie borders

– Values with or without units

– The percentage between slices – Change all font properties

D. C - Advanced SQL Condition

Is a WHERE command that allows you to add a specific

condition to adjust the Pie query. For example: I want to compare the average production

by production lines where Batch process was equal to 4.

– Put a Where command : where Batch= 4

Graphical Objects

Pie example

Page 27: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 27/35

Object 11 – Bar Graph

A- Definition

The Bar Graph enables you to cut a period into several segments to visualize and compare the

content of each (example: cut a week in days and compare each day of the week)

As in the Pie, the Bar chart enables you to define Bars of:

Data values

Alarms Logged values

Data are either from “Dream Report History” or from any “native historian Database”.

a) If you define a Bar of Data values then you can compare for each segment:

Last value

Maximum value Minimum value

Average value

Sum values Duration values

b) If you define a Bar of Alarms, it means you want to

compare alarms groups for each period

c) If you define a Bar of Logged values, you want to know

how many values were logged for each period

B - Appearance

In the appearance options, you can define the Bar name

and Display: – Bar legend

– X Scale

– Y Scales Limit management:

o Automatic o Automatic zero based

o Manual

o Manual item value based – Values

You can also define Grid, date and time format, Bar Type

and of course define font properties

E.

Page 28: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 28/35

F. C - Advanced SQL Condition

Is a WHERE command that allows you to add a specific condition to adjust the Bar query.

For example: I want to measure the machine Downtime

per day where Jim is the operator.

– Put a Where command : when user='Jim'

Object 12 – Chart

A- Definition

The Chart Object enables you to visualize multiple tags in one chart. Data are either from “Dream

Report History” or from any “native historian Database”.

Values

User can display a chart as: Interpolated line based on values logged in the

database

Interpolated line based on moving average values for each tags

XY chart

Linear Regression chart Power Regression chart

Graph Style

User can select to visualize

Line with mark chart (by default) Line only

Mark only

Scale

User can display the scale for each tag or uncheck the

scale they don‟t need. Each Tag is displayed according to its own scale, but

the user can select another scale as the scale

reference.

Page 29: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 29/35

B - Appearance

In the appearance options, you can define the Chart name and Display:

– Chart legend

– X Scale – Y Scales Limit management:

o Automatic

o Automatic zero based

o Manual You can also define the Grid interval, date and time

format and the font properties

Chart Type

User can select if he wants a value or time based chart

Chart Window option

Adjust the chart either to the period selected or to the data logged

In this example the chart configuration was defined for a time period between A and B, but there is only

data between A‟ and B‟.

If you select chart fit to time period then you will see the chart for the entire period (A,B)

If you select chart fit to data, the chart will be automatically adjusted (A‟,B‟)

C - Advanced SQL Condition

Is a WHERE command that enables you to add a specific condition to adjust the chart query. For example: I want to visualize only the chart for the batch 39

– Put a Where command : WHERE batch = 39 – In the chart window option we adjust the chart to the data

Page 30: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 30/35

Then the chart STARTS and is adjusted exactly when the batch starts and END also when the batch ends

Object 13 – Date and Time

A- Definition

Displays the month, the week, the day, the day of the week, the hour, the minutes and of course the

complete date and time in different formats

Date:

dd/mm/yyyy or dd/mm/yy

or mm/dd/yyyy or mm/dd/yy

Time

hh:mn:ss hh:mn

displaying hours either from 0 to 24 or 0 to 12 AM / PM

When you design a report that you know up front will have a flexible period of time set from the

DRG, then you can add the “Time and Date”

object twice and set the “Start of report period” and “End of report period” accordingly.

Object 14 – Page Number

A- Definition

Displays the current page number

Displays the total number of pages

Object 15 – Report Name

A- Definition

Displays the report name

Object 16 – Project Name

A- Definition

Displays the project name

Page 31: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 31/35

Example

Page 32: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 32/35

6.7. Phase 5 – Report Generation and Distribution Settings

To access the report settings, select a report and right click and then select Report properties.

The report settings wizard appears with

7 tabs:

1. General Tab is to define the report name, description, report

location…

2. Report Name Tab defines the report name rule under

which all generated reports will be saved. A very flexible name is generated, which can include textual prefix +

dynamically added suffix. The suffix can be based on

different variations of date and time formats as well meaningful item values: "Production_Report_"+[d#FULL_TIMESTAMP]+[i#Batch_ID]

3. Report generation on schedule 4. Report generation on event

5. Report distribution

6. Macros 7. Report authorization

Report Generation On Schedule

Dream Report® can automatically generate a report on a schedule

User can predefine the report generation schedule:

Yearly based

Monthly based

Weekly based - In this case they can set multiple combinations: example – Every day at 17:00

– Every Monday at 09:00 – Every Friday at 18:00

Time based (every hour for example)

Page 33: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 33/35

Report Generation On Condition

Dream Report® can automatically generate a report on an Event

User simply defines the event condition

He can select any tag from any source and assign the

condition: > : higher

< : lower

>= : higher or equal =< : lower or equal

= : equal

!= : different

When TRUE, Dream Report Run Time will generate the

report

Report Distribution

After being generated reports can be automatically distributed to one or more targets

By default Dream Report® archives reports in PDF

format. To specify the destination computer and folder

please refer to the project settings, tab “Project Paths”.

Reports can be printed. Each report can have a unique

printer distribution list.

Page 34: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 34/35

Reports can automatically be sent via email. Each

report has its own recipient list.

Dream report mailer has an integrated

SMTP server configuration. Users can define whether to send PDF or Excel format or

both.

After the report is processed by Dream Report runtime you may choose to open PDF or Excel reports automatically.

Running an Application with Dream Report Run Time

6.8. Launching Dream Report Run Time

This icon will launch Dream Report Run Time; you can also launch it from Dream Report Studio,

main menu, Run Time.

Application projects are saved with the suffix *.drt

When the Run Time is launched, it starts several tasks:

It initiates and launches data acquisition It starts the logger and logs data and alarms in the selected database (SQL server by default)

It loads all reports defined in the project and captures the settings for generation and distribution

It configures IIS

Page 35: Dream Report Getting Started v3.3.pdf

Dream Report Getting Started Ver 3.3 Page 35/35

From the user interface you can:

Activate or disable report generation

Visualize the status of each report

Pressing Change button enables you to load a different project

Pressing Reload Project button reloads the ongoing project with the last updates

Pressing Hide&Save button will keep the project running, minimize the window to the system tray and also save the definition of runtime options.

Pressing Exit button will close the current running project, close the window and the entire application.

Pressing Open report file button opens the last report generated.

6.9. Report on Demand

To generate a report on demand, click on the report name and then click the Generate button. A new

report will be generated immediately, saved and distributed according to its settings.