(495) 925-0049, ITShop интернет-магазин 229-0436, Учебный Центр 925-0049
  Главная страница Карта сайта Контакты
Поиск
Вход
Регистрация
Рассылки сайта
 
 
 
 
 

Crystal Reports XI и Visual Studio.NET: развертывание приложений

Зайцев С.Л.

Оглавление

Аннотация

Business ObjectsCrystal DecisionsВ этой статье обсуждаются возможности для развертывания приложений Visual Studio .NET с использованием автономной версии Crystal Reports XI для работы как с Visual Studio 2002, так и с Visual Studio 2003. Описывается работа как с объединенными модулями, так и интерактивными установочными пакетами.

Введение

Crystal Reports XI

Crystal Reports XI расширяет возможности генерации отчетов Crystal Reports на платформу Microsoft .NET. Вы можете использовать Crystal Reports Designer в Visual Studio .NET (VS .NET) для создания нового или модификации уже имеющегося отчета Crystal.

Вы можете хранить отчет на локальном компьютере, или опубликовать его с использованием Report Web Service на web-сервере. В зависимости от того, разрабатываете ли вы Windows или web-приложение, вы можете работать с отчетом либо с помощью Windows Forms Viewer, либо с помощью Web Forms Viewer.

Включение отчетов в приложения .NET

При добавлении отчетов в Windows-приложения .NET или в web-приложения, по умолчанию они добавляются к приложению как встроенный ресурс. Это означает, что отчет будет скомпилирован в манифесте сборки, и не будет загружаться из отдельного файла отчета (.RPT).

Работа с отчетом в качестве встроенного ресурса позволяет поставлять и разворачивать приложения .NET без отдельной поставки файлов отчетов. Преимущество заключается в отсутствии для приложения необходимости в развертывании внешних файлов отчетов, поэтому конечные пользователи не могут их модифицировать. Но имеется и недостаток - если отчет необходимо модифицировать, придется перекомпилировать все приложение и снова развернуть его для сохранения изменений в отчете.

Для предотвращения компиляции отчетов в манифест сборки в качестве встроенного ресурса, используйте следующие шаги:

  1. После добавления отчета в проект, выделите отчет в окне .NET Solution Explorer.
  2. В окне Properties измените свойство Build Action с Embedded Resource на None.

При использовании вышеуказанных шагов отчет не будет скомпилирован в манифест сборки, таким образом, отчет будет загружаться с жесткого диска. Отчеты могут быть загружены с диска с помощью указания файлового пути, с использованием метода Load объекта ReportDocument.

При развертывании приложений, не имеющих встроенных файлов отчетов, это файлы должны быть вручную добавлены при настройке проекта. Преимущество хранения отчетов вне сборки заключается в том, что отчеты могут быть легко модифицированы и повторно развернуты без необходимости в перекомпиляции и развертывании всей сборки. Недостаток заключается в том, что жестко заданные типы объектов не могут быть использованы в приложении, а отчеты должны загружаться с жесткого диска.

Обзор методов развертывания

Существует два метода развертывания runtime-файлов Crystal Reports XI на целевом компьютере:

  • Использование модулей слияния (merge modules)
  • Использование интерактивной установки (также известной как "неограниченной" (redistributable) или серверной установки)

В обоих сценариях устанавливаются одни и те же файлы, тем не менее, методы развертывания отличаются. Модули слияния предназначены тем разработчикам, которые хотят включить runtime-файлы Crystal Reports вместе с установочным пакетом в сопутствующее приложение. Интерактивная установка предназначена для тех, кто хочет просто развернуть эти файлы на серверном компьютере в качестве автономной задачи.

Развертывание с использованием модулей слияния

Компоненты, предназначенные для добавления в настройку проектов для поставки и развертывания приложений Crystal Reports 10, включают:

  • Файлы отчетов (.RPT)
  • Модули слияния Crystal Reports

Файлы отчетов (.RPT)

Файлы отчетов (.RPT) следует поставлять при развертывании приложений .NET. Способ развертывания файлов отчетов зависит от имеющихся потребностей и архитектуры приложения. см. предыдущий раздел , за подробной информацией по развертыванию файлов отчетов.

Модули слияния Crystal Reports

Модули слияния, которые необходимо добавлять в настройку проекта, устанавливаются с Crystal Reports XI в каталог C:\Program Files\Common Files\Merge Modules. Обновленные версии модулей слияния можно найти на сайте технической поддержки Business Objects по следующему адресу.

Поиск файла:
crxi_net_merge_modules.zip

Предшествующие версии Crystal Reports для развертывания отчетов требовали включения трех или более модулей в настройку проекта. Для Crystal Reports XI, необходимо включить только один файл слияния, при этом второй является опциональным:

  • Crystal11_NET_EmbeddedReporting.msm
  • CrystalReports11_maps.msm (опционально)

Crystal11_NET_EmbeddedReporting.msm

Этот модуль слияния содержит элементы управления CrystalReportViewer, SDK-сборки Crystal Reports .NET, SDK-сборки RAS, ядро обработки отчетов, компоненты базы данных и компоненты экспорта. Этот модуль слияния всегда требуется для приложений Crystal Reports XI .NET.

Запустите на выполнение файл модуля слияния (.MSI) на компьютере, где вы разворачиваете приложение, и при появлении приглашения введите ключевой код Crystal Reports XI. (см. раздел Получение и добавление ключевого кода, где приведена дополнительная информация.)

CrystalReports11_Maps.msm

Этот модуль слияния используется для инсталляции файлов, требуемых для отображения в отчетах географических карт. Этот модуль слияния требуется только в том случае, если в отчет включена картографическая информация.

Развертывание с использованием интерактивной установки

Интерактивная установка может выполняться только при работе с полной версией Crystal Reports XI редакций Developer или Server.

При развертывании web-приложения, или при развертывании Windows-приложений на одном и том же компьютере, рекомендуется, чтобы зависимости (dependencies) Crystal были установлены отдельно. Этот пакет WindowsIinstaller находится в C:\Program Files\Common Files\Merge Modules - и имеет название CrystalReports11_NET_EmbeddedInstall.msi. Обновленные версии установочного пакета можно найти на сайте технической поддержки Business Objects по следующему адресу: http://support.businessobjects.com/search

Поиск файла:
crXI_net_server_install.zip

Запустите на выполнение установочный файл (.MSI) на компьютере, где вы разворачиваете приложение, и при появлении приглашения введите ключевой код Crystal Reports XI. (см. раздел Получение и добавление ключевого кода, где приведена дополнительная информация.)

Получение и добавление ключевого кода

Когда модуль слияния Сrystal11_NET_EmbeddedReporting.msm добавляется в настройку проекта, то его свойство Keycode требует введения ключевого кода. Этот ключевой код высылается по электронной почте при регистрации продукта. Это ключевой код также может быть найден в меню справки Visual Studio.NET, для это нужно щелкнуть по пункту About Microsoft Development Environment. Это ключевой код указан в разворачивающемся списке с перечислением установленных продуктов: Installed Products.

Состоящий из 23 цифр ключевой код должен быть введен в свойство LicenseKey модуля слияния Crystal11_NET_EmbeddedReporting.msm.

Примечание: Информацию по ошибкам введения ключевых кодов можно получить в разделе "Дополнительная информация".

Развертывание Web-приложений ASP.NET

В следующей процедуре предполагается, что у вас уже есть web-приложение или приложение web-сервисов, готовое для использования. Для развертывания Web-приложений ASP .NET с использованием модулей слияния Crystal Reports XI:

  1. В VS .NET, откройте ваше web-приложение и в меню View щелкните Solution Explorer. Находясь в Solution Explorer, щелкните правой клавишей мыши по вашему web-приложению, затем щелкните по Add и затем - по New Project.
  2. Появится диалоговое окно добавления нового проекта Add New Project. Щелкните по Setup and Deployment Projects на левой панели и затем по Web Setup Project на правой панели. Щелкните OK.
  3. Находясь в Solution Explorer, щелкните правой клавишей мыши по Web Setup Project, затем щелкните по Add и затем - по Project Output.
  4. Появится диалоговое окно Add Project Output Group. При нажатой клавише Ctrl щелкните по Primary Output и по Content Files. Щелкните OK.
    После добавления в проект Primary Output, будут добавлены некоторые обнаруженные зависимости.
    Зависимости dotnetfxredist_x86_enu.msm и dotnetcrystalreports.msm должны быть удалены, если они все еще присутствуют. Для исключения этих файлов, в Solution Explorer щелкните правой клавишей мыши по файлу и затем по Exclude.
  5. В Solution Explorer, щелкните правой клавишей мыши на WebSetup и выберите Add, затем щелкните на Merge Module.
  6. Появится диалоговое окно Add Modules (добавление модулей). Щелкните на модуле слияния Crystal11_NET_EmbeddedReporting.msm, а затем по Open для добавления его в ваш проект. Щелкните OK.

Примечание: При развертывании web-приложения, использующего набор данных ADO .NET, вам необходимо также включить два дополнительных модуля слияния, указанных выше в разделе "Runtime".

  1. Находясь в вашем проекте WebSetup, щелкните по модулю слияния Crystal11_NET_EmbeddedReporting.msm для отображения свойств.
  2. Раскройте список MergeModuleProperties и введите действительный ключевой код в окно свойств Keycode. Дополнительная информация приведена в разделе "Ключевой код".
    Данный шаг является обязательным при развертывании Crystal Reports для приложений Visual Studio.NET.

Вы можете провести пользовательскую настройку вашей инсталляции, исключив ненужную базу данных и файлы экспорта. Обратитесь к разделу "Пользовательская настройка вашей инсталляции".

Для создания вашей настройки Web-проекта, выделите и щелкните правой клавишей мыши по вашему пакету развертывания (WebSetup1) в Solution Explorer, затем щелкните по Build. Теперь вы готовы к развертыванию вашего Web-приложения ASP.NET.

Развертывание приложения Windows

В следующей процедуре предполагается, что у вас уже есть Windows-приложение, готовое для использования. Для развертывания Windows-приложения с использованием модулей слияния:

  1. В VS .NET, откройте ваше web-приложение и затем щелкните по меню View в Solution Explorer. В Solution Explorer, щелкните правой кнопкой мыши по вашему Windows-приложению, щелкните по Add и затем по New Project.
  2. Появится диалоговое окно добавления нового проекта Add New Project. Щелкните по Setup and Deployment Projects на левой панели и затем - по Setup Project на правой панели. Щелкните OK.
  3. Находясь в Solution Explorer, щелкните правой кнопкой по Setup Project, затем Add и затем щелкните по Project Output.
  4. Появится диалоговое окно Add Project Output Group. При нажатой клавише Ctrl щелкните по Primary Output и по Content Files. Щелкните OK.
    После добавления в проект Primary Output будут добавлены некоторые обнаруженные зависимости. Зависимости dotnetfxredist_x86_enu.msm и dotnetcrystalreports.msm должны быть удалены, если они все еще присутствуют. Для исключения этих файлов, в Solution Explorer щелкните правой кнопкой мыши по файлу и затем щелкните по Exclude.
  5. Находясь в Solution Explorer, щелкните правой кнопкой мыши по Setup Project и выберите Add, затем щелкните по Merge Module.
  6. Появится диалоговое окно Add Modules (добавление модулей). Щелкните по модулю слияния Crystal11_NET_EmbeddedReporting.msm и затем по Open для добавления этого файла в ваш проект. Щелкните OK.

Примечание: Если вы развертываете Windows-приложение, использующее набор данных ADO.NET, вам необходимо также включить два дополнительных модуля слияния, указанных выше в разделе "Runtime".

  1. Находясь в вашем Setup Project, щелкните по модулю слияния Crystal11_NET_EmbeddedReporting.msm для отображения свойств.
  2. Раскройте список MergeModuleProperties и введите действительный ключевой код в окно свойств Keycode. Дополнительная информация приведена в разделе "Ключевой код".
    Данный шаг является обязательным при развертывании Crystal Reports для приложений Visual Studio .NET.
  3. Для создания вашей настройки Web-проекта, выделите и щелкните правой клавишей мыши по вашему пакету развертывания (setup1) в Solution Explorer, затем щелкните по Build. Теперь вы готовы к развертыванию вашего Windows-приложения.

Пользовательская настройка вашей инсталляции

В Crystal Reports 11 и в Visual Studio .NET, модуль слияния Crystal11_NET_EmbeddedReporting.msm позволяет вам указывать установочные опции для драйверов баз данных, драйверов экспорта и виртуального IIS-каталога crystalreportviewers11.

По умолчанию, все это устанавливается с Crystal11_NET_EmbeddedReporting.msm.

Выберите, какие драйвера баз данных нужно устанавливать

  1. В вашем проекта развертывания щелкните по Crystal11_NET_EmbeddedReporting.msm и в окне Property, разверните список MergeModuleProperties.
  2. Установите значение для определенного драйвера равным 1, для включения этого драйвера в ваш проект развертывания.
  3. Установите значение для определенного драйвера равным 0, для исключения этого драйвера из вашего проекта развертывания.

Название свойства для драйверов баз данных

Описание

InstallACT Драйвер базы данных Crystal Reports для баз данных ACT.
InstallBTRIEVE Драйвер базы данных Crystal Reports для баз данных Pervasive.
InstallCDO32 Драйвер базы данных Crystal Data Object.
InstallCRDB_ADO Драйвер базы данных Crystal Reports для объектов данных Microsoft ActiveX / OLE DB.
InstallCRDB_ADOPLUS Драйвер базы данных Crystal Reports для Microsoft ADO.NET.
InstallCRDB_CDO Драйвер базы данных Crystal Reports для объектов данных Crystal.
InstallCRDB_COM Драйвер базы данных Crystal Reports для провайдера данных COM.
InstallCRDB_DATASET Драйвер базы данных Crystal Reports для провайдера DataSet.
InstallCRDB_ODBC Драйвер базы данных Crystal Reports для ODBC.
InstallCRDB_ORACLE Драйвер базы данных Crystal Reports для Oracle.
InstallCRDB_QUERY Драйвер базы данных Crystal Reports для данных запросов.
InstallDAO Драйвер базы данных Crystal Reports для объектов Microsoft Data Access Objects.
InstallFIELDDEF Драйвер базы данных Crystal Reports для определения полей.
InstallFILESYSTEM Драйвер базы данных Crystal Reports для данных файловой системы.
InstallIBM_DB2 Драйвер базы данных Crystal Reports для сервера DB2.
InstallINFORMIX Драйвер базы данных Crystal Reports для сервера Informix Online.
InstallP2BBDE Драйвер базы данных Crystal Reports для IDAPI.
InstallP2BXBSE Драйвер базы данных Crystal Reports для xBase.
InstallP2IXBSE_DLL Физическая библиотека DLL Crystal Reports для xBase.
InstallP2SACL Драйвер базы данных Crystal Reports для Public Folder ACL.
InstallP2SEVT Драйвер базы данных Crystal Reports для журнала регистрации событий NT.
InstallP2SEXSR Драйвер базы данных Crystal Reports для Exchange Server Admin.
InstallP2SMAPI Драйвер базы данных Crystal Reports для Exchange. Папки и адресная книга.
InstallP2SMSIIS Драйвер базы данных Crystal Reports для журнальных файлов IIS.
InstallP2SOUTLK Драйвер базы данных Crystal Reports для данных Outlook.
InstallP2SREPL Драйвер базы данных Crystal Reports для Exchange Public Folder Replica.
InstallP2STRACK Драйвер базы данных Crystal Reports для журнала отслеживания сообщений Exchange Server.
InstallP2SWBLG Драйвер базы данных Crystal Reports для журнальных файлов Web.
InstallSYBASE Драйвер базы данных Crystal Reports для Sybase.

Выберите, какой драйвер экспорта следует установить

  1. Находясь в вашем проекте развертывания, щелкните по Crystal11_NET_EmbeddedReporting.msm и в окне Property, разверните список MergeModuleProperties.
  2. Установите значение для определенного драйвера равным 1, для включения этого драйвера в ваш проект развертывания.
  3. Установите значение для определенного драйвера равным 0, для исключения этого драйвера из вашего проекта развертывания.

Название свойства для драйверов экспорта

Описание

InstallU2DMAPI Драйвер экспорта Crystal Reports для формата экспорта MAPI.
InstallU2DNOTES Драйвер экспорта Crystal Reports для формата экспорта Lotus Notes Database Destination.
InstallU2DVIM Драйвер экспорта Crystal Reports для формата экспорта Lotus Notes Mail.
InstallU2FCR Драйвер экспорта Crystal Reports для формата экспорта отчетов (Report).
InstallU2FHTML Драйвер экспорта Crystal Reports для формата экспорта HTML 4.0.
InstallU2ODBC Драйвер экспорта Crystal Reports для формата экспорта ODBC.
InstallU2FPDF Драйвер экспорта Crystal Reports для экспорта в формате PDF.
InstallU2FREC Драйвер экспорта Crystal Reports для формата экспорта в виде записей (Records).
InstallU2FRTF Драйвер экспорта Crystal Reports для формата экспорта Rich Text (rtf).
InstallU2SEPV Драйвер экспорта Crystal Reports для формата значений с разделителями.
InstallU2FTEXT Драйвер экспорта Crystal Reports для текстового формата экспорта.
InstallU2FXLS Драйвер экспорта Crystal Reports для формата экспорта Excel.
InstallU2FXML Драйвер экспорта Crystal Reports для формата экспорта XML.

Выберите, куда следует установить программы просмотра Crystal

  1. Находясь в вашем проекте развертывания, щелкните по Crystal11_NET_EmbeddedReporting.msm и в окне Property, разверните список MergeModuleProperties.
  2. Установите значение свойства равным 1, для включения инсталляции crystalreportviewers11 виртуального каталога IIS в ваш проект развертывания.
  3. Установите значение свойства равным 0, для исключения инсталляции crystalreportviewers11 виртуального каталога IIS в ваш проект развертывания.

Название свойства для установки виртуального каталога

Описание

InstallViewerVirtualDir Свойство для контроля того, где именно будет установлен виртуальный каталог IIS crystalreportviewers11.

Развертывание файлов среды выполнения

.NET Framework

Так как проекты, созданные в VS.NET относятся к .NET Framework, то Framework должна также поставляться и устанавливаться на целевом компьютере. Когда создается настройка проекта, то обычно Framework автоматически не включается. Имеется несколько способов поставки Framework. За дальнейшей информацией обратитесь на следующий сайт: http://msdn.microsoft.com/netframework/downloads/framework1_1/

ADO.NET

Если какой-либо из файлов отчетов использует объекты баз данных ADO .NET, вам потребуется включить следующие два объединенных модуля:

  • Для VS .NET 2002, используйте VC_CRT.msm и VC_STL.msm
  • Для VS .NET 2003, используйте VC_User_CRT71_RTL_X86_---.msm и VC_User_STL71_RTL_X86_--- .msm. Эти два объединенных модуля требуются по причине того, что драйвер базы данных, Crdb_adoplus.dll, является зависимым от следующих файлов, которые устанавливают объединенные модули:
    • Для VS .NET 2002 - Msvcr70.dll и Msvcp70.dll
    • Для VS .NET 2003 - Msvcr71.dll и Msvcp71.dll

Примечание: Файлы от этих объединенных модулей должны быть доступны для приложения. Они должны быть указаны либо в системном пути, либо находится в каталоге приложения. Рекомендуется, чтобы эти файлы были установлены в каталоге приложения. Если эти файлы недоступны приложению, то при попытке обработки отчетов появятся ошибки времени выполнения.

Информацию описаний keycode-ошибок можно искать по следующему адресу:

  • c2010681 - Сообщение об ошибке: "Invalid or missing Keycodev2.dll", выдаваемое при развертывании приложений .NET
  • c2012716 - Сообщение об ошибке: "... job failed because a free license could not be obtained..."
  • c2011205 - Сообщение об ошибке: "Cannot find keycodev2.dll or invalid keycode", выдаваемое в VS .NET

Для дополнительной информации и ресурсам по .NET, посетите один из следующих сайтов:

Ссылки по теме


 Распечатать »
 Правила публикации »
  Обсудить материал в конференции Microsoft »
Обсудить материал в конференции SAP Business Objects »
Обсудить материал в конференции Дизайн, графика, обработка изображений »
Написать редактору 
 Рекомендовать » Дата публикации: 27.02.2006 
 

Магазин программного обеспечения   WWW.ITSHOP.RU
SAP® Crystal Presentation Design 2016 WIN INTL NUL
Microsoft Office 365 Бизнес премиум. Подписка на 1 рабочее место на 1 год
SAP Crystal Reports 2008 INTL WIN NUL License
Microsoft SQL CAL 2017 Sngl OLP 1License NoLevel UsrCAL
Microsoft Visual Studio Professional 2017 Sngl OLP 1License NoLevel
 
Другие предложения...
 
Курсы обучения   WWW.ITSHOP.RU
 
Другие предложения...
 
Магазин сертификационных экзаменов   WWW.ITSHOP.RU
 
Другие предложения...
 
3D Принтеры | 3D Печать   WWW.ITSHOP.RU
 
Другие предложения...
 
Новости по теме
 
Рассылки Subscribe.ru
Информационные технологии: CASE, RAD, ERP, OLAP
Безопасность компьютерных сетей и защита информации
Новости ITShop.ru - ПО, книги, документация, курсы обучения
Программирование на Microsoft Access
CASE-технологии
Вопросы и ответы по MS SQL Server
Corel DRAW - от идеи до реализации
 
Статьи по теме
 
Новинки каталога Download
 
Исходники
 
Документация
 
Обсуждения в форумах
Пишу программы на заказ для студентов (187)
Пишу для студентов на с, с++, паскаль в средах ms visual studio, qt, builder, borland c, delphi....
 
Пишу программы на заказ профессионально (2282)
Пишу программы на заказ на языках Pascal (численные методы, списки, деревья, прерывания) под...
 
Ищу программиста для написания программы (21)
Ищу программиста ,владеющего Вижуал Бэйсик и программированием в Экселе, для написания...
 
Corel. Сохранение файла в старом формате. (26)
у меня есть горящий вопрос по Корелу и никто мне не может дать на него ответ. Я работаю в...
 
Настройка меню "Пуск" Windows 7 при помощи реестра (3)
Скажите пожалуйста, а как можно закрепить ярлыки программ с помощью твиков реестра в левой части...
 
 
 



    
rambler's top100 Rambler's Top100