printJob    Номер отчета, для которого требуется проверить корректность параметров подключения к источнику данных
tableN    Номер таблицы, для которой требуется проверить параметры подключения. Нумерация таблиц в отчете начинается с 0

Возвращаемые значения:
TRUE – если вызов удачен;
FALSE – если вызов неудачен.

Замечание
Если параметры подключения неверны, то можно отследить следующие ошибки:

Ошибка соединения    Код ошибки    Исправляется с помощью функции
Невозможно начать сессию    PE_ERR_DATABASESESSION    PESetNthTableSessionlnfo
Невозможно подключиться к серверу    PE_ERR_DATABASELOGON    PESetNthTableLogOnlnfo
Невозможно открыть таблицу    PE_ERR_DATABASELOCATION    PESetNthTableLocation

Параметры функции    Описание параметров
print Job    Номер отчета, для которого требуется выполнить проверку

Возвращаемые значения:
TRUE – если вызов удачен;
FALSE – если вызов неудачен.

Параметры функции    Описание параметров
print Job    Номер отчета, который необходимо изменять в пределах окна просмотра
level    Варианты размеров, которые вы можете установить, должны попадать в пределы от 25% до 400%. Так же можно использовать некоторые константы:
PE_ZOOM_FULL_SIZE
PE_ZOOM_SIZE_FIT_ONE_SIDE
PE_ZOOM_SIZE_FIT_BOTH_SIDES

Возвращаемые значения:
    TRUE – если вызов удачен;
    FALSE – если вызов неудачен.

£     Crystal Report Engine API – наиболее развитый, но и наиболее трудоемкий механизм;

£     Crystal Report ActiveX Control – самый простой и быстрый способ интеграции отчетов, но поддерживается не вся функциональность, доступная в Crystal Report Engine API;

£     Crystal Report Component для Delphi – компонент, созданный на основе функций Crystal Reports API, поддерживаются различные версии Delphi;

£     Crystal Report RDC (Report Designer Component) – компонент, позволяющий не только выполнять интеграцию существующих отчетов, но и создавать новые отчеты в момент работы приложения, требует дополнительного лицензирования.

Каждый из представленных механизмов обладает своими достоинствами и недостатками. Поэтому для того чтобы иметь возможность сравнить предлагаемые способы, рассмотрим несколько примеров интеграции отчетов в приложения. В качестве средств разработки будем использовать Borland Delphi 6.0 и Microsoft Visual Basic 6.0, а в качестве механизмов интеграции рассмотрим Crystal Report API, Crystal Report ActiveX Control и Crystal Report Component.

Примечание

Описание возможности интеграции отчетов Crystal Reports 9 в приложения можно найти в разделе документации Crystal Developers Help, поставляемой совместно с Crystal Reports 9. И хотя все примеры в документации и в этой книге ориентированы на использование Visual Basic и Delphi, можно также воспользоваться любыми средствами разработки, которые допускают использование API либо ActiveX.

Примечание

Многие из приведенных далее примеров содержат функции и типы, список которых приведен в Приложении 1 и Приложении 2.

Примечание

Файл CRDelphi.pas и примеры доступны только в дистрибутивах Crystal Reports 9 Developer или Advanced.

Примечание

После подключения указанных файлов к проекту необходимо откорректировать файлы. В тех строчках, которые содержат приблизительный путь к библиотекам crpe32.dll и crwrap.dll, необходимо указать действительный путь. Если этого не сделать, то приложение работать не будет.

Для удобства работы установим параметры экранной формы, как в табл. 9.1 или в табл. 9.2.

Таблица 9.1. Установка параметров экранной формы в проекте Delphi

Рис. 9.1. Проект и экранная форма Delphi

Рис. 9.2. Проект и экранная форма Visual Basic

Рис. 9.3. Настройка параметров фильтрации выбираемых файлов Delphi

Таблица 9.2. Установка параметров экранной формы в проекте Visual Basic

Далее можно приступить к описанию алгоритма вызова отчетов Crystal Report 9 нажатием кнопки Показать отчет. В обоих примерах компоненты ReportOpenDialog служат для выбора отчета, который необходимо открыть.

Примечание

Все функции Crystal Report Engine API именуются по общему принципу. Первые две буквы наименования функции или процедуры всегда РЕ, например, PEOpenEngine. Описание функций можно найти в Приложении 1.

Рис. 9.4. Настройка фильтрации выбираемых файлов Visual Basic

Схема 9.1. Алгоритм просмотра отчетов Crystal Reports 9 из приложения

Для удобства работы рекомендуется в разделе глобальных переменных объявить следующую переменную:

£     Для проекта Delphi – nPrintJob, тип данных Word;

£     Для проекта Visual Basic – nPrintJob, тип данных Integer.

В данном примере будет использовано всего четыре функции:

£     PEOpenEngine – загрузка компонентов Crystal Print Engine;

£     PEOpenPrintJob – загрузка в память выбранного отчета;

£     PEOutputToWindow – настройка параметров окна просмотра отчетов;

£     PEStartPrintJob – запуск отчета на просмотр.

Блок-схема алгоритма работы с отчетами представлена на схеме 9.1.

В листингах 9.4 и 9.5 дан текст процедур, реализующих алгоритм, представленный на схеме 9.1.