Введение
Данный документ предназначен для пользователей Crystal Reports 8.5 . Это краткое техническое описание содержит практическую информацию, важную для понимания выполнения отчетов в интернете (Web-отчёты) с помощью Crystal Enterprise и Crystal Reports Developer Edition.
Данный документ призван помочь быстро разобраться в тех возможностях работы с отчётами через интернет, которыми обладает Crystal Reports.
Три способа публикации отчётов в Web
1-й способ: Crystal Reports + ASP Reports Server
Crystal Reports 8.5 позволяет выполнять отчёты с помощью сервера ASP Reports Server (ASP - Active Server Pages, активные серверные страницы) - ASP-приложений на основе Report Design Component.
2-й и 3-й способы: через Crystal Enterprise
В Crystal Enterprise 8.0 предусмотрено 2 способа выполнения отчётов через интернет: "управляемый" (Managed) и "неуправляемый" (Unmanaged).
Далее будут рассмотрены эти способы, их преимущества и недостатки.
Сервер ASP Reports Server
Новое ядро Crystal Reports 8.0, которое позволяет создавать и выполнять отчёты, называется Report Design Component (RDC). Craxdrt.dll - библиотека динамической компоновки для RDC - может быть использована с Visual Basic, Active Server Pages (ASP) и другими языками программирования. Эти функции можно использовать для работы с отчётами в Crystal Reports v. 8.5 Developer Edition (устанавливается с компакт-диска Crystal Reports 8.5, а не с компакт-диска Crystal Enterprise 8.0).
Это очень мощный способ выполнения отчётов через интернет. На страницах ASP с помощью программы на языке VBScript или JavaScript можно выполнять, экспортировать и просматривать отчёты через интернет.
ASP даёт высокую степень управления отчётом. С помощью модели объектов RDC очень просто изменить расположение базы данных для отчёта, оператор SELECT языка SQL и формулу выбора записей.
Метод ASP позволяет внести в отчёт данные с помощью технологии ActiveX Data Objects (ADO). В Crystal Report можно использовать и просматривать через интернет любой источник данных, к которому можно подключиться и извлечь множество записей с помощью сценария ASP.
Метод ASP также позволяет создавать и изменять отчёты (для создания отчётов требуется дополнительная лицензия, за более подробной информацией обращайтесь к торговому представителю).
Недостатком метода ASP является необходимость обучения пользователей написанию сценариев. Как минимум, вы пишите приложение для выполнения и отправки отчёта через интернет, а если отчёт изменится, то Вам нужно соответствующим образом подстроить программу.
Если хотите воспользоваться методом ASP, то Вам необходимо загрузить и изучить примеры сценариев, которые содержатся в файле ASPXMPS85.EXE (его можно найти на нашей странице Support Site Files and Updates area поиском по имени файла). Большинство использующих этот метод разработчиков создают свои приложения на основе этих образцов.
Неуправляемые отчёты
При этом способе используются ссылки, указывающие на файлы отчётов (.rpt) в Вашем веб-приложении. В Crystal Reports версии 8.0 этот способ назывался методом WCS (Web Component Server) и методом URL. Этот способ прост в настройке и использовании, а также очень гибок, поскольку позволяет отправлять в строке с адресом URL сведения для подключения к базе данных, значения параметров, параметры просмотра. Благодаря своей простоте и большим возможностям этот метод отправки отчётов через интернет стал самым популярным.
Необходимая информация (сведения для соединения с базой данных, значения параметров и проч.) может быть передана на URL-адрес в отчёт, а при её отсутствии пользователю будет предложено ввести эти значения. Полную информацию о том, как отправлять эти значения, см. в информационном бюллетене ce8_urlcommands.pdf. (На странице http://support.crystaldecisions.com/docs выполните поиск по имени этого файла.)
С управляемыми и неуправляемыми отчётами можно работать в системах с Web-серверами под управлением Unix. Компонент, который соединяет Web-сервер с остальной частью системы Crystal Enterprise (CE), называется Web Connector (Web-коннектор); существуют различные его версии для ряда сборок Unix. Почти все компоненты CE работают под управлением операционных систем Windows NT и Windows 2000. Список протестированных платформ Unix см. в файле Platforms.txt в корневой папке на компакт-диске Crystal Enterprise.
Метод неуправляемых отчётов имеет два следующих недостатка.
Первый недостаток заключается в том, что элементы, передаваемые в строку адреса URL, хранятся на клиентском компьютере в виде файлов cookies, по одному файлу на каждый элемент. Поскольку протокол HTTP для большинства браузеров имеет предел 20 файлов cookie, метод WCS годится только для отчётов с небольшим количеством параметров, имен пользователей и паролей для баз данных и т.д. Дополнительные сведения см. в статье C2009665 из базы знаний.
Второй недостаток - при работе с защищённой базой данных приходится передавать Web-серверу пароль из браузера, что небезопасно, в результате чего защита БД оказывается бесполезной. Но для внутреннего применения это как правило не имеет значения. Если же защита очень важна, есть 3 выхода:
- Для защиты пароля от злоумышленников, при его передаче через сеть можно использовать безопасный протокол Secure Sockets Layer (HTTPS). Хотя, если пароль включён в ссылку, помешать пользователю увидеть его невозможно.
- Пользователи сервера баз данных Microsoft SQL Server могут настроить его так, чтобы он использовал для проверки подлинности имя и пароль пользователя, которые тот вводит при входе в Windows NT. В этом случае любой процесс, требующий подключения к SQL Server, может проходить проверку на подлинность без явного указания имени пользователя и пароля. Запуск сервера Crystal Page Server под разрешённой учётной записью NT позволит этому серверу подключаться к SQL Server без явного указания имени пользователя и пароля.
- Следующий способ - публикация отчёта в системе Crystal Enterprise и хранение имени пользователя и пароля для базы данных в Enterprise. See Appendix A below for steps to do this.
Управляемые отчёты
Управляемые отчёты используют WCS так же, как отчёты, отправляемые методом URL. У них есть ряд дополнительных функций:
- У Вас есть возможность запускать отчёты по мере необходимости или запускать их по расписанию, а результаты просматривать позже.
- Чтобы создать собственные приложения для планирования, выполнения и просмотра отчётов, можно разработать сценарии на языке VBScript или JavaScript Такие страницы с расширением *.CSP называются Crystal Server Pages. Существуют такие приложения-примеры как ePortfolio, а также мастер Web Wizard (Web-мастер), который поможет Вам создавать приложения.
- У Вас есть возможность хранить сведения для соединения с базой данных на сервере, чтобы пользователям не требовалось отправлять эти сведения через сеть.
- У Вас есть возможность включить в отчёт предупреждающие сообщения, которые будут выводиться при обнаружении серьёзной ситуации, и пользователи смогут увидеть эти сообщения в Вашем приложении.
- Отчёты хранятся в репозитарии файлов (File Repository). Пользователям Crystal Enterprise, не имеющим прав администратора, для доступа к этим файлам не требуются права NT.
Если у вас версия Crystal Enterprise 8.0 Professional:
- Вы можете определить пользователей и группы пользователей, чтобы контролировать их доступ в систему. В системе CE можно объединить защитные функции Windows NT и протокола LDAP (Lightweight Directory Access Protocol).
- Несколько компонентов (например, WCS) на нескольких компьютерах можно сделать частью единой системы. Таким образом, система CE является расширяемой (масштабируемой).
Дополнительные продукты
Продукт Crystal Analysis Professional можно использовать для конструирования OLAP-отчётов на основе кубов Microsoft OLAP, чтобы размещать эти отчёты в интернете. (Дополнительную информацию см. на нашем сайте на странице Crystal Analysis ).
Продукт Report Application Server добавляется для того, чтобы получить возможность создавать отчёты через интернет. Этот продукт является набором средств для разработки программного обеспечения (SDK) с примерами приложений. Вот, вкратце, его функции:
- Это приложение не требует установки дополнительного клиента на компьютере конечного пользователя, достаточно всего лишь Web-браузера. Предусмотрена возможность открывать существующие отчёты и создавать новые отчёты с нуля.
- Вы можете создавать новые отчёты и открывать существующие.
- У Вас есть возможность изменять расположения баз данных и сведения для соединения с ними, выбирать таблицы и поля, создавать и изменять ссылки, группы, итоги, формулы, диаграммы, карты и т. д.
- Встроенное средство просмотра DHTML позволяет обрабатывать события, экспортировать и печатать.
- Поскольку этот продукт является средством разработки ПО, все операции могут быть либо автоматизированы, либо выполняться с участием пользователя.
Дополнительную информацию см. на сайте Crystal Decisions на странице Report Application Server .
Дополнительную информацию об управляемых отчётах, а также их сравнение с "ванильным" методом WCS, см. в информационном бюллетене "Understanding Managed and Unmanaged Reporting" (Пояснения к управляемым и неуправляемым отчётам).
Недостатки
Есть ли у метода управляемых отчётов какие-либо недостатки? Если Вы не можете использовать такие примеры приложений как ePortfolio, или созданные Web-мастером, потому что они не удовлетворяют вашим требованиям, то Вы можете разработать собственные страницы CSP. Но так же как в методе ASP придётся писать сценарий, поэтому на разработку и сопровождение потребуется больше времени.
Запускать и просматривать отчёты можно также с использование адреса URL, без страниц CSP. Так иногда поступают те пользователи, которые предпочитают хранить имя пользователя и пароль для подключения к базе данных на сервере, чтобы не передавать их от клиента. Подробности см. в приложении А.
Полезными источниками информации по программированию CSP являются "Руководство Web-разработчика" (см. файл CE8_WebDeveloperHelp.exe ) и информационный бюллетень CE8 Customization: A Lesson in Using the Report Plug-in for Scheduling.
Итак, какой метод наиболее подходит? Теперь, когда Вы знаете возможности каждого из них, выберите тот, который самый простой и в то же время удовлетворяет всем вашим требованиям. Помните, у Вас также есть возможность комбинировать. Например, можно использовать метод ASP для отчётов, требующих ADO, и метод управляемых отчётов в случае, когда ADO не требуется, но необходимо надёжно хранить в секрете пароль к базе данных.
Установка
Если Вы работали с отчётами через интернет методом WCS с помощью Crystal Reports 8.0 версии 8.0 или более ранней, прочитайте файл http://support.crystaldecisions.com/communityCS/TechnicalPapers/cr8_to_ce8_ migration.pdf. Он был написан специально для таких пользователей как Вы.
Поддерживаемые среды
Для начала взглянем на маленький файл PLATFORMS.TXT, который находится в корневой директории компакт-диска с рассматриваемым продуктом. Его более новая версия находится в статье C2009003 базы знаний. Там перечислено всё то, с чем продукт тестировался - операционные системы, источники данных и т.д.
Если же что-то в этом списке отсутствует, то это не означает, что вы не сможете использовать это программное обеспечение. Как правило, служба технической поддержки помогает вам заставить работать ПО в тех средах, в которых оно "должно работать", например, вместе с пакетом обновления для системы Windows, который ещё не был выпущен во время тестирования продукта Crystal, или с веб-сервером, которого нет в упомянутом списке, но который совместим с CGI. И всё-таки, если у вас есть выбор, придерживайтесь этого списка.
ПРИМЕЧАНИЕ
Если проблемы возникнут с неподдерживаемой конфигурацией, то специалисты службы технической поддержки решать их не будут; но эти проблемы будут учтены при разработке следующего поколения нашего продукта.
Дополнительную информацию о поддерживаемых платформах см. в первом разделе заметок о версии (файл Release.rtf), который также находится в корне компакт-диска. Хотя для этого вполне достаточно и файла Platforms.txt.
В заметках о версии также есть список ошибок, которые были известны на момент выпуска продукта, но не были исправлены из-за нехватки времени. Помните об этом списке и обращайтесь к нему в случае затруднений. Чтобы получить более свежую информацию, на странице http://support.crystaldecisions.com/docs выберите в качестве продукта Crystal Enterprise, а в качестве типа документа - Release Notes (Заметки о версии).
Установка Crystal Reports
Crystal Reports рекомендуется устанавливать на компьютер, на который устанавливается Crystal Enterprise. Это не обязательно для правильной работы Crystal Enterprise, но всё же рекомендуется, потому что Crystal Reports - незаменимый инструмент тестирования, который помогает обеспечить правильное подсоединение отчётов к базе данных.
Большинство обращений в службу технической поддержки связано именно с проблемами подсоединения к базам данных. В большинстве случаев запуск конструктора Crystal Reports на компьютере, подсоединённом к интернету, помогает быстро найти и устранить причину неисправности.
Архитектура
Очень полезно ознакомиться с компонентами Crystal Enterprise и их функциями. Архитектура Crystal Enterprise сложнее, чем у Crystal Reports 8.0. Чтобы быстро ознакомиться с архитектурой, прочтите главу 2 файла Quick Start Guide.pdf, который находится в папке \doc на компакт-диске Crystal Enterprise.
Установка Crystal Enterprise
Установку Crystal Enterprise выполняйте по инструкциям, приведённым в упомянутом руководстве Quick Start Guide.
Дополнительную информацию см. в файле Installation Guide.pdf, который находится в той же папке.
Если во время установки появится сообщение "No Compatible Web Server found" (Обнаружен несовместимый веб-сервер), это означает, что программа установки пыталась сконфигурировать компонент Web Connector (веб-коннектор), но не смогла найти на компьютере подходящий Web-сервер. Если на компьютере установлен Web-сервер, отсутствующий в списке Platforms.txt, обратитесь в службу технической поддержки за программой, которая установит на компьютер Web-коннектор.
Лицензирование
Crystal Reports 8.0
По умолчанию лицензия на использование Crystal Reports версии 8.0 выдается на 5 пользователей, работающих одновременно. Это называется "лицензированием с одновременным использованием". При использовании методов ASP и WCS одновременно просматривать отчёты могут до 5 пользователей. При необходимости увеличить количество одновременно работающих с отчётами пользователей, требуется приобрести дополнительную лицензию.
В программное обеспечение этой версии не встроено средств, запрещающих его использование в случае, если отчёты будут просматриваться большим количеством пользователей, чем разрешено лицензией.
Crystal Reports Developer Edition версии 8.5 и Crystal Enterprise 8.0
По умолчанию лицензия на использование Crystal Reports 8.5 и Crystal Enterprise 8.0 тоже допускает одновременную работу не более 5 пользователей, и также предусмотрена возможность приобретения дополнительной лицензии на большее количество пользователей. Существуют и другие типы лицензий: именная лицензия и серверная лицензия. Для добавления возможностей, предусмотренных дополнительной лицензией, используются ключевые коды.
В Crystal Reports 8.5 и Crystal Enterprise 8.0 встроен следующий программный запрет на работу при превышении допустимого количества одновременно просматривающих пользователей: если лишний пользователь попытается просмотреть отчёт, то ему будет отказано в доступе.
Поскольку Crystal Reports и Crystal Enterprise являются отдельными продуктами, лицензии на них приобретаются по отдельности, и ключевые коды у них тоже различны.
Заключение
Затратив время на изучение возможностей Crystal Decisions по работе с отчётами через интернет, Вы быстрее выполните настройку и получите систему, удовлетворяющую всем вашим требованиям.
Приложение А: Использование управляемых отчётов для хранения информации для входа в базу данных
Управляемые отчёты нравятся пользователям возможностью хранить информацию для соединения с базой данных. Тут есть два больших преимущества:
- При использовании неуправляемых отчётов, имя пользователя и пароль для подключения к базе данных необходимо передавать серверу из браузера. Их можно спрятать методом POST, но это не дает надёжной защиты.
- Если отчёт содержит подотчёты, каждый из них должен извлечь из адреса URL имя пользователя и пароль к базе данных. Все передаваемые с URL элементы временно хранятся в своих файлах cookie для браузера, а поскольку типичный браузер не может обрабатывать более 20 файлов cookie, то отчёт с 0 подотчётами может не выполниться. Для параметров отчётов также требуются файлы cookie, по одному файлу на параметр.
Для просмотра управляемых отчётов не обязательно нужно писать сценарии для страниц CSP. Вот краткое руководство по превращению отчёта в управляемый отчёт CE и доступу через интернет:
- Перейдите на страницу http://ваш_веб-сервер/crystal/enterprise и щелкните на ней ссылку на консоль управления (Crystal Management Console).
- Войдите как администратор (по умолчанию поля для пароля надо оставить пустым).
- Щелкните Objects (Объекты) > New Report (Создать отчёт), перейдите к файлу отчёта, затем щелкните ОК.
- Выберите папку для отчёта, затем щелкните ОК.
- В списке объектов должен появиться ваш новый отчёт. Щелкните по заголовку этого нового отчёта.
- На вкладке "База данных" (Database) введите имена пользователей и пароли для всех баз данных. УБЕДИТЕСЬ, что флажок "Prompt the user for new value(s) when viewing" (Предлагать пользователю новые значения при просмотре) СНЯТ. Щелкните кнопку Update (Обновить), чтобы сохранить изменения.
- На вкладке Parameters (Параметры) установите для всех параметров значения по умолчанию. УБЕДИТЕСЬ, что флажок "Prompt the user for new value(s) when viewing" (Предлагать пользователю новые значения при просмотре) УСТАНОВЛЕН для ВСЕХ параметров.
- На вкладке Properties (Свойства) щёлкните Preview (Предварительный просмотр) и убедитесь, что отчёт выглядит как требуется. Посмотрите на поле с адресом URL и запишите идентификационный номер отчёта.
Вот пример адреса URL, который можно использовать для просмотра отчёта:
http://имя_сервера/viewrpt.cwr?ID=99&apsname= имя_сервера &apsuser=guest&apspassword=&apsauthtype=secEnterprise&promptex-ClientID="7"
В этом образце "имя_сервера" - это веб-сервер (и компьютер, на котором установлено ПО CE), а 99 - идентификатор отчёта. Чтобы увидеть управляемый отчёт, нужно проверить подлинность APS, поэтому следующими элементами этого адреса, которые передаются в CE, являются guest (пользователь с правами гостя), пустой пароль и apsauthtype. Последний элемент - пример установки значения параметра. Данный отчёт имеет параметр ClientID, которому присваивается значение 7. Полную информацию о том, как в адресе URL задавать значения параметров, см. в файле ce8_urlcommands.pdf .