Transition from PCRE 2.7.x/3.7.x to Harmoni 1.0 For COM Customers

Frequently Asked Questions

Transition from PCRE 2.7.x/3.7.x to Harmoni 1.0 For .NET and COM Customers
FAQ# 26-02090403

Architectural differences:

With Parallel Crystal, PCRE v2.7.x is meant for Crystal Reports 7 users and PCRE v3.7.x is for Crystal Reports 9 users: each Parallel Crystal version corresponds to one version of Crystal Reports from Seagate/Crystal Decisions, now Business Objects.

Beginning with Harmoni, our CORBA framework now supports multiple document engines to be run at the same time, including Crystal Reports 7, Crystal Reports 9, and Microsoft Word 10 and Word 11 on a single machine.

Harmoni automates the following three types of engines:

Crystal Reports Print Engine (CRPE32 - Crystal Reports v7.0.1.100)

Crystal Reports Print Engine (CRPE32 - Crystal Reports, v9.2.0.448 Advanced Edition)

MS Word (Word 10/Office XP and Word 11/2003)

Yet another change from PCRE to Harmoni is that Harmoni no longer uses Dynalivery's "Mango" or emf2pdf.dll library for generating PDF documents. Instead Harmoni will use our all-Java Saffron Document Server to generate high fidelity PDF, HTML, RTF, SVG, JPEG and PNG outputs. Saffron is included in PCRE 2.7.x/3.7.x as an option.

Installation steps:

Please review the information in the Harmoni installation guide prior to beginning the installation.

Server

1) Uninstall Parallel Crystal 2.7.x/3.7.x

2) Make the following registry edits

From HKEY_LOCAL_MACHINE\SOFTWARE, make sure the Dynalivery registry key is deleted.

3) Make sure the Dynalivery folder in the path to Parallel Crystal installation is deleted.

4) Prerequisite Software for a Harmoni 1.0 Server Installation

1. Windows 2000 (SP3 or greater)
2. Crystal Decisions Crystal Reports v7.0.1.100 for Crystal 7 Engine users.
3. Crystal Decisions Crystal Reports v9.2.0.448 for Crystal 9 Engine users.
4. Word 10 /Office XP and Word 11/ 2003 for Word Engine users.

5) Install Harmoni v1.0 from the CD.

Client (middle tier)

1) Uninstall Parallel Crystal 2.7.x/3.7.x

2) Make the following registry edits

From HKEY_LOCAL_MACHINE\SOFTWARE, make sure the Dynalivery registry key is deleted.

3) Install the Harmoni v1.0 client libraries only, from the CD.

Porting .NET and COM applications from PCRE 2.7.x/3.7.x to Harmoni

1) Please refer to the FAQ titled: Major API changes from PCRE 2.7.x/3.7.x to Harmoni.

2) If you are a .NET user, make sure you include a reference to the <path_to_Dynalivery>\Harmoni\bin\HarmoniClient.dll when you compile your C# code.

3) Your C# application must add an imports or using statement for the Harmoni namespace.

4) For detailed information and code samples, please refer to Chapter 3 entitled “Using the Client Package” of the Harmoni Developer’s Manual. If you are a Crystal Reports Engine user, please review the information in the section entitled “Report Generation for Crystal Engine”. If you are using the Word Engine, please refer to the “Document Generation Using Word Engine” section of the Harmoni Developer’s Manual.

5) Code sequence for COM has changed from a 4 line code to a 2 line code as shown below.

PCRE API Sequence
1) Set client = Server.CreateObject("PCRE.PCREApplicationClient")
2) Set gateway = client.getGateway
3) Gateway.setHost "hostname"
4) Client.Connect

Harmoni APISequence
1) Set client = Server.CreateObject("Harmoni.HarmoniApplicationClient")
2) client.ConnectToHost "hostname", "cr7"

References:

1) “Major API Changes from PCRE 2.7.x/3.7.x to Harmoni 1.0” FAQ

2) Note: Harmoni is based on Dynalivery's APIs for PCRE 2.7.2.x and 3.7.2.x, plus extensions. It is effectively the PCRE 2.8/3.8 upgrade for Crystal Reports users with active Dynalivery support agreements. Customers who wish to migrate from PCRE 2.6/3.6 directly to Harmoni should read this FAQ in conjunction with: http://www.dynalivery.com/customersupport/faq/2_6-2_7COMupgrade.html about the steps to migrate from PCRE 2.6/3.6 to 2.7/3.7.