Introduction to Using Crystal Reports with ClearSCADA
This driver is a stand-alone driver. It provides additional functionality to enable ClearSCADA to interface with specific supported systems or devices. To interact successfully with such systems or devices, you need to:
- Install and run the driver
- Ensure that the driver is licensed
- Configure the required database items and settings on the driver
- Ensure that the database items (and any database items on which they depend) have valid, saved, configuration and are 'In Service'.
Intended Audience
This guide is intended for:
- Engineers who are responsible for:
- Configuring ClearSCADA to interface with the third-party Crystal Reports™ application
- Using the third-party Crystal Reports™ application to produce reports that contain ClearSCADA data.
(Such engineers are expected to have the appropriate experience or knowledge of the Crystal Reports™ application.)
- Operators and engineers who work with the reports that contain ClearSCADA data
- System administrators who are investigating unexpected conditions related to the Crystal Reports driver.
This guide contains technical information that is intended for users that are sufficiently familiar with ClearSCADA configuration and operation. Before reading this driver guide, ensure that you are familiar with:
- ClearSCADA configuration practices, procedures, and the configuration of properties that are common to many database items. For more information, see the ClearSCADA Guide to Core Configuration, and the ClearSCADA Guide to Core Point Configuration.
- Driver structure, components, and configuration properties, pick actions, and status attributes that are common to many drivers. For more information, see the ClearSCADA Guide to Drivers.
Some sections of this guide are intended for operator-level users. These sections are intended for users that are familiar with the navigational and operational aspects of ClearSCADA. Before reading the operational sections in this guide, ensure that you are familiar with:
- The ClearSCADA user interfaces (ViewX and WebX), the various types of display, their navigation and operation. For more information, see the ClearSCADA Guide to ViewX and WebX Clients.
Document Scope
This guide explains the configuration and features associated with ClearSCADA's Crystal Reports driver. The Crystal Reports driver enables ClearSCADA to interface with the third-party Crystal Reports™ application to produce professional customized reports that contain data from the ClearSCADA database.
You can use the Crystal Reports driver to enable ClearSCADA to interface with SAP Crystal Reports 2013 or SAP Crystal Reports 2016.
Crystal Reports is a powerful application that allows you to structure reports to your requirements. You can then generate and display your reports, print your reports out, or export your reports to a variety of formats and destinations for data analysis. For instance, you might want to transfer your reports to disk, or export reports in Adobe AcrobatTM format and send them via e-mail to a system engineer or manager.
Much of the structure and layout of a report is performed using the Crystal Reports application. As such, we advise that any reports or report templates are produced by engineers that have the appropriate experience or knowledge of the Crystal Reports application.
The ClearSCADA Guide to the Crystal Reports Driver explains the ClearSCADA interface to the Crystal Reports application and the ClearSCADA specific features related to producing reports. You can use the ClearSCADA Crystal Reports driver to interface with SAP Crystal Reports 2013 or SAP Crystal Reports 2016. For more information on the version(s) of Crystal Reports and the editions that ClearSCADA supports, see Installation on ViewX Clients on Which You Want to Edit Reports.
This document explains how to:
- Install Crystal Reports
- Plan Your Reports
- Configure Your Reports (taking into account the Important Guidelines on Configuring and Generating Reports)
- Trigger Your Reports Automatically (see Activating a Report Action Automatically).
It also explains:
- Driver-specific aspects that are of interest to operators, including:
- Using Actions Associated with Crystal Reports
- Using the Crystal Reports Viewer
- Working with the Reports List.
- Driver-specific aspects that may be of interest to system administrators and engineers when investigating unexpected behavior relating to the Crystal Reports driver. The driver-specific aspects include:
For information on using the Crystal Reports software or writing formulae to produce the reports you require, see the documentation supplied with the Crystal Reports application.
SAP - the owner of Crystal Reports - requires that each operational installation of the Crystal Reports runtime module used within a server application requires a license, which impacts ClearSCADA.
Schneider Electric is obligated to implement the current SAP licensing rules for Crystal Reports, which requires each new ClearSCADA server that intends to use the Crystal Reports runtime to be correctly licensed. The installation of any ClearSCADA server that requires the Crystal Reports runtime module to be operational requires the purchase of an additional license.
The application of Crystal Reports runtime licensing rules is to be retrospective for users running Crystal Reports 2008 or later, which impacts all ClearSCADA users that have ClearSCADA 2010 R3 or newer. As a result, ClearSCADA users that request an upgrade to their ClearSCADA license that supports ClearSCADA 2010 R3 or newer will be required to purchase a Crystal Reports runtime license per server to continue using Crystal Reports.
SAP Crystal Reports runtime modules are no longer selected or installed by default during the installation of ClearSCADA pre-requisites.
The SAP Crystal Reports runtime components are NOT installed by default. If you intend to install them you must purchase a Crystal Reports runtime license for each server on which these components are to be operational (clients do not need a license to use the runtime components). For servers on which the runtime components are operational, the Crystal Reports runtime license is included with the ClearSCADA Crystal Reports driver license. Please contact your Schneider sales representative for more information.
If you intend using Crystal Reports on your system, you also need to install the Crystal Reports prerequisites and driver on any
ClearSCADA users that do not use Crystal Reports are not impacted by this change.