User's Guide

User's Guide

Introduction

Using ActiveReports' Documentation Chapter 1 - Installation

Chapter 2 - Using ActiveReports for the First Time Chapter 3 - Printer and Page Settings

Chapter 4 - Binding Reports to Data Controls Chapter 5 - Bound Reporting and Grouping< /P> Chapter 6 - Unbound Reporting and Grouping Chapter 7 - Using Subreports

Chapter 8 - Dynamic (Run-Time) Reporting< /P> Chapter 9 - Creating Reports from an XML Document Chapter 10 - Additional Report Types

Chapter 11 - Organizing Reports with the TOC and Frame Control Chapter 12 - Hyperlinking, CSS and ActiveReports

Chapter 13 - Saving and Loading Chapter 14 - Scripting

Chapter 15 - Using ActiveReports' ActiveX Viewer Control Chapter 16 - ActiveReports on the Web

Support and Licensing

Introduction

Introduction

ActiveReports leverages the latest technologies including ActiveX, XML, ActiveScripting and CSS to provide you with full integration, open architecture, and a user-friendly interface.

Using ActiveReports' Documentation

Using ActiveReports' Documentation

Document Conventions Documentation Overview Sample Reports

Document Conventions

Document Conventions

This book uses the following typographical conventions:

Convention                                                         Description

bold               Programming language terms in text

italic               In Syntax italics indicate placeholders for information you would supply.

Dialog box elements are displayed in italics

Embedded Caps

monospace font Keyboard Shortcuts

Language terms are capitalized for readability. The language is not case sensitive. Code Syntax and Examples

Delete means the Delete or Del key on your numeric keypad

Escape means the Escape or Esc key on your keyboard

Enter means Enter, Return, or the Carriage Return key on your keyboard

Ctrl-Key, Shift Key, and Alt-Key are two key combinations. Press and hold the first key then press the second key and release. For example, Ctrl-Z, press and hold the Control key and press the Z letter key on your keyboard.

Mouse Actions Click: Click the primary (left) mouse button once

Right-click: Click the secondary (right) mouse button once

Double-click: Click the primary (left) mouse button twice without moving the mouse while clicking

Shift-click: Press and hold the SHIFT key on your keyboard and click the primary (left) mouse button

Documentation Overview

Documentation Overview

ActiveReports' documentation consists of two separate manuals.

Developer's Guide

The Developer's Guide, which is broken into several smaller organized chapters, gives an overview of the fundamentals for using ActiveReports. It introduces users to the way ActiveReports works and describes the design-time and run-time user interface. In addition, it demonstrates a variety of examples and techniques for using ActiveReports in both simple and advanced reporting scenarios. The Developer's Guide's purpose is to provide a firm foundation from which new ActiveReports users can build their projects. The ideas presented in this manual are keys for beginning report designers. More complex samples and specialized information can be found in our knowledgebase at http://www.datadynamics.com/kb. The information in the knowledgebase can be used in conjunction with this manual to provide more complex solutions to reporting problems.

Developer's Reference Manual

The Developer's Reference Manual details the ActiveReports object model. It describes the properties, methods, and events for ActiveReports' internal objects and controls.

ActiveReports 2.x Features

ActiveReports 2.x Features

ActiveX Designer

ActiveReports is based on the Active Designer specification. This allows a component to be integrated into the hosting design environment while allowing it to make full use of its services.

The designer is a fully compliant ActiveX control and object host. You can insert ActiveX controls or OLE objects, such as graphs and documents, into your reports. OLE objects can be bound to BLOB fields in your database.

User Friendly interface

ActiveReports is modeled after Visual Basic's form designer with many additional enhancements and features. This provides a familiar UI to help make report designing possible in a timely manner.

Familiar Programming Language

ActiveReports uses Visual Basic as its primary design language through object-based events and methods. This allows you to leverage your Visual Basic skills without having to learn a foreign formula or scripting language.

Small Distribution Overhead

ActiveReports' designer DLL is roughly 1.5 MB and it does not require any additional DLLs to distribute. The internet-enabled Report Viewer ActiveX control is very small at only 456KB.

Powerful Object Model

ActiveReports objects are exposed through COM for complete control over all aspects of your report. The designer provides an easy to use environment while the object model provides programmable controls, sections, and printing options.

Multithreaded Reporting Engine

ActiveReports is multithreaded allowing reports to be generated very quickly and efficiently. ActiveReports has the ability to generate multiple reports simultaneously.

Table of Contents and Navigation History objects

The viewer contains a programmable table of contents tree allowing users to quickly jump between report sections.

Lightweight, Internet-enabled, ActiveX Control

The ActiveReports ActiveX control, ARView2, can be used to preview reports on the Internet or Intranet with a very small client cab file download. The ActiveX control provides the same features found when viewing the report in a Win32 application.

RTF, PDF, EXCEL, HTML, TIFF and Delimited Text Exports

ActiveReports includes multiple export filters to transform your report output into Rich Text Format for word- processing, Portable Document Format (PDF) for global file transfer, EXCEL format, HTML format for web viewing, TIFF format for faxing, and delimited text for spreadsheets and database use.

Online Searchable Knowledgebase

http://www.datadynamics.com/kb

Data Dynamics provides an online searchable knowledgebase allowing all Data Dynamics customers to search for helpful articles on any of Data Dynamics' products. The Knowledgebase contains many useful articles and running samples on ActiveReports2.

New Features

Enhanced ActiveReports 2.0 Viewer Control

The ActiveReports 2.0 viewer control now has several advanced features. Users can preview multiple pages simultaneously, utilize the new text search feature to search through a report for a specified text string, and report pages can now be copied to the clipboard and pasted in another document. The viewer control also has enhanced IntelliMouse support, a splitter control, and the ability to add custom icons.

Expanded Toolbar in the Designer

The designer's toolbar has several new options. The additions include a page setup menu for modifying page settings, printer settings and style layouts during design time. Menus now include options to save and load reports from RPX files (ActiveReports' custom XML file format), a style drop-down box for applying global and specialized styles, and several new controls.

New PageSettings Collection and Page Setup Designer

ActiveReports 2.0 now uses a page settings collection that allows each page to be easily modified. The PageSettings collection contains properties for setting margins, printer orientation, collation, duplex printing, and page sizes. The page setup dialogs allow page and printer settings to be modified at design time rather than requiring the changes to be made at run time. With the added support for mirror margins and gutters, ActiveReports 2.0 makes publishing easy.

Note: PageBottomMargin, PageTopMargin, PageLeftMargin, PageRightMargin are no longer used.

New XML Features

New XML enhancements allow reports to be loaded and saved at design time and run time. Also, the addition

of an XML data control allows easy access to XML database structures.

New Hyperlink Capabilities

ActiveReports 2.0 adds hyperlink events to the report and viewer control, providing hyperlinking to URLs, TOC entries, and other reports.

Drill-Down Capability

With the addition of the new hyperlink event, users can set up hyperlinks to other ActiveReports as well as URLs. This allows ActiveReports to emulate drill-down reporting.

A typical scenario would be for users to click on a parent record in one report and have another report displayed containing all of the child records.

Enhanced Exporting Capabilities

The export filters now support hyperlinks and the ability to save a report into a byte array rather than to disk. The PDF export has been updated to support font embedding and international character set support. The RDF export allows for password protection and compression during saving as well as TOC exporting.

ActiveReports 2.0 Architectural Overview

ActiveReports 2.0 Architectural Overview

Format

A report section contains a group of controls that are processed and printed at the same time as a single unit. ActiveReports defines the following section types:

Report Header

A report can have one report header section that prints at the beginning of the report. It is generally used to print a report title, a summary table, a chart or any information that needs to appear only once at the report's start.

Report Footer