Главная >> Проекты

Pages: | 1 | ... | 11 | 12 |

| 14 | 15 | ... | 17 |

«Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Содержание 1 Руководство SAP Crystal Reports.NET SDK Developer Guide............................ 4 1.1 Начало ...»

-- [ Страница 13 ] --

Локализованные строки для элемента управления CrystalReportViewer отображаются на текущем 3. Закройте Viewer.txt.

Командная строка Visual Studio.

5. Перейдите к каталогу файлов ресурсов:

cd c:\CrystalReportViewer_resource_files\ro\ 6. Запустите утилиту Resgen для компиляции файлов.txt, придерживаясь приведенного ниже синтаксиса.

Не ставьте пробелы перед или после запятой.

resgen /compile CRWebFormViewer.txt,CrystalDecisions.Web.resources resgen /compile SCRShared.txt,CrystalDecisions.Shared.resources resgen /compile Viewer.txt,CrystalDecisions.Windows.Forms.resources 7. Запустите утилиту al.exe для создания динамически подключаемой библиотеки для каждого файла В имени выхода расширение resources.dll меняется на custom_resources.dll.

al.exe /t:lib /embed:CrystalDecisions.Web.resources /culture:ro / © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide out:CrystalDecisions.Web.custom_resources.dll al.exe /t:lib /embed:CrystalDecisions.Shared.resources /culture:ro / out:CrystalDecisions.Shared.custom_resources.dll al.exe /t:lib /embed:CrystalDecisions.Windows.Forms.resources /culture:ro / out:CrystalDecisions.Windows.Forms.custom_resources.dll 8. Введите dir, чтобы просмотреть скомпилированные динамически подключаемые библиотеки.

Компиляция ресурсов для этого подкаталога завершена.

9. Если у вас есть другие пользовательские языки, которые требуется скомпилировать, повторите операции этого раздела для каждого языка.

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

10. По завершении компиляции пользовательских ресурсов закройте командную строку Visual Studio.

Следующие шаги В следующем разделе описана процедура настройки проекта веб-сайта или проекта Windows для доступа к пользовательским ресурсам из глобального или пользовательского расположения.

Если вы создаете веб-узел, перейдите к Настройка глобальных или локальных пользовательских ресурсов [стр. 601].

При сборке проекта Windows переходите к разделу Настройка многоязыковой поддержки клиентов для приложения Windows [стр. 608].

1.5.5.1.4 Настройка многоязыковой поддержки клиентов для веб-сайта 1.5.5.1.4.1 Настройка глобальных или локальных пользовательских ресурсов Веб-сайт получает доступ к языковым ресурсам глобально (на системном уровне) или локально (из папки веб-сайта).

Пользовательские языковые ресурсы можно помещать в глобальное или локальное расположение.

Языковые ресурсы по умолчанию всегда доступны глобально.

Если файлы ресурсов не входят в комплект установки продукта, их можно загрузить с веб-сайта SAP BusinessObjects и установить отдельно.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Для глобального предоставления пользовательских ресурсов их необходимо поместить в центральное расположение в каталоге файлов, из которого они могут совместно использоваться различными вебприложениями. Чтобы затем получить доступ к этим глобальным ресурсам на определенном веб-сайте, следует добавить ссылку на путь к каталогу глобальных ресурсов в файл Web.config. Для правильной загрузки глобальных ресурсов имя папки с файлами ресурсов должно соответствовать выбранному языковому стандарту.

Чтобы предоставлять пользовательские ресурсы локально, следует поместить их непосредственно в папку веб-сайта. Для правильной загрузки локальных ресурсов версия файлов ресурсов и имя папки с файлами ресурсов должно соответствовать выбранному языковому стандарту.

Глобальный подход больше подходит для веб-сайтов, поскольку он позволяет обслуживать все веб-сайты из одного расположения на веб-сервере и предотвращает дублирование и опасность несоответствия между версиями.

Чтобы получить доступ к глобальным пользовательским ресурсам (более типично для веб-сайтов) В файле Web.config добавьте ключ globalResourcePath к узлу appSettings.

Получение доступа к локальным пользовательским ресурсам (менее типично для веб-сайтов) Скопируйте подкаталог пользовательских ресурсов (в данном случае, подкаталог ro) из папки C:

\CrystalReportViewer_resource_files\ в каталог bin папки веб-сайта. Если каталог bin не существует в веб-проекте, создайте его, щелкнув правой кнопкой мыши имя проекта и выбрав команду Создать папку. Присвойте вновь созданной папке имя bin.

Если вы добавили ключ globalResourcePath, как описано для глобальных ресурсов, то локальные ресурсы игнорируются. Это происходит потому, что глобальные ресурсы имеют преимущество над локальными в иерархии доступа.

Теперь веб-сайт настроен для глобального или локального доступа к пользовательским языковым ресурсам, а также для глобального доступа к языковым ресурсам по умолчанию. Однако пока ни один конкретный язык не задан для просмотра, поэтому на этом этапе элемент управления CrystalReportViewer остается в языковом стандарте по умолчанию.

Последующие разделы посвящены локализации на основе браузера, на основе страниц и на основе среды веб-сервера.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.5.5.1.4.2 Настройка локализации на основе браузера Контекст В данном разделе рассказывается о сценарии динамической локализации на основе браузера. В этом сценарии свойство элемента управления CrystalReportViewer определяет, что динамическая локализация будет основываться на параметрах языка клиентского браузера.

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

Процедура 1. Запустите браузер.

В данном учебном пособии предполагается, что используется Internet Explorer, но возможно применение и других браузеров, совместимых с HTML 4.0.

2. В Internet Explorer, в меню Сервис, выберите пункт Свойства обозревателя.

3. В диалоговом окне Свойства обозревателя на вкладке Общие нажмите кнопку Языки...

4. В диалоговом окне Выбор языка нажмите кнопку Добавить...

5. Добавьте 4 следующих языка:

Немецкий (Австрия) [de-at] Французский (Франция) [fr] Итальянский (Италия) [it] 6. Выберите Итальянский (Италия) [it] и нажмите кнопку Переместить вверх. Повторяйте эту операцию до тех пор, пока Итальянский (Италия) [it] не окажется вверху списка.

7. Нажмите кнопку ОК, затем еще раз ОК, и закройте браузер.

8. Откройте веб-сайт в среде Visual Studio, затем выполните сборку и компиляцию.

9. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов CrystalReportViewer.

Строки подсказки по-прежнему отображаются на английском языке, а настройка языка вашего браузера игнорируется. Необходимо настроить параметр с именем UseBrowserLocale в файле проекта Web.config так, чтобы элемент управления CrystalReportViewer отображал языковой стандарт браузера при визуализации строковых значений подсказки.

10. Закройте браузер, чтобы выйти из режима отладки.

11. Откройте файл Web.config.

12. В теге введите следующие вложенные теги, чтобы задать для свойства UseBrowserLocale значение true.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Файл Web.config может иметь только один блок configSections, и этот блок должен быть первым дочерним объектом тега configuration. Если файл Web.config уже включает блок configSections, измените этот раздел, включив в него теги sectionGroup и section, как показано ниже.

В предыдущих версиях SAP Crystal Reports свойства CrystalReportViewer включали свойство UseBrowserLocale. В настоящее время это свойство исключено и заменено вышеуказанным параметром в файле Web.config. Если в файл Web.config не включена ни одна запись, UseBrowserLocale по умолчанию принимает значение false.

13. Повторно соберите и скомпилируйте приложение.

14. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов CrystalReportViewer.

Строки подсказки теперь отображаются на итальянском языке. Следующим этапом является изменение языковых настроек браузера на немецкие.

15. В Internet Explorer, в меню Сервис, выберите пункт Свойства обозревателя.

16. В диалоговом окне Свойства обозревателя на вкладке Общие нажмите кнопку Языки...

17. Выберите Немецкий (Австрия) [de-at] и нажмите кнопку Переместить вверх. Повторяйте эту операцию до тех пор, пока Немецкий (Австрия) [de-at] не окажется вверху списка.

18. Нажмите кнопку ОК, а затем снова ОК, чтобы вернуться в браузер.

19. Нажмите кнопку Обновить.

20. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов CrystalReportViewer.

Строки подсказки теперь отображаются на немецком языке.

21. Повторите описанную процедуру для языков Французский (Франция) [fr] и Румынский [ro].

В каждом случае выбор языка в браузере определяет, какая строка отображается в элементе управления CrystalReportViewer.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide В данном пособии описывалась компиляция пользовательских ресурсов румынского языка на основе строк языка, заимствованных из каталога испанского языка, поэтому пользовательские подсказки румынского языка будут отображаться на испанском языке.

22. Вернитесь в среду Visual Studio и нажмите кнопку Остановить, чтобы выйти из режима отладки.

Результаты Вы успешно настроили динамическую локализацию с помощью параметров на основе браузера. В следующем разделе речь пойдет о настройке локализации с помощью параметра на странице ASPX.

1.5.5.1.4.3 Настройка локализации для веб-страницы на основе страниц Контекст Из этого раздела вы узнаете о сценарии динамической локализации на основе страниц. В этом сценарии динамическая локализация определяется директивой "Страница" страницы Default.aspx.

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

Процедура 1. Откройте файл Web.config.

2. В теге введите следующие вложенные теги, чтобы задать для свойства UseBrowserLocale значение "ложь".

3. Откройте страницу Default.aspx в представлении Проект.

4. Щелкните страницу Default.aspx, чтобы выделить ее.

5. В окне Свойства задайте для свойства Региональные стандарты значение it-IT.

Если свойство Региональные стандарты не отображается, выберите пункт Документ из списка в верхней части окон Свойства.

6. Повторно соберите и скомпилируйте приложение.

7. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов CrystalReportViewer.

Строки подсказки отображаются на итальянском языке.

8. Вернитесь в среду Visual Studio и нажмите кнопку Остановить, чтобы выйти из режима отладки.

Результаты В этом сценарии настроены следующие параметры:

Для свойства CrystalReportViewer.UseBrowserLocale задано значение "Ложь". Следовательно, языковой стандарт браузера, в качестве которого в предыдущей пошаговой процедуре был задан испанский язык, игнорируется.

Директива страницы "Региональные стандарты" установлена на итальянский язык.

Следовательно, строки подсказки отображаются на итальянском языке.

Следующие шаги Динамическая локализация с помощью параметров на основе страниц успешно настроена. В следующем разделе вы узнаете о том, как настроить локализацию с помощью языкового стандарта веб-сервера.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide веб-сайта Контекст Из этого раздела вы узнаете о сценарии динамической локализации на основе среды веб-сервера. В этом сценарии динамическая локализация определяется параметрами языкового стандарта среды для вебсервера.

Поскольку локализация основана на среде, в этом сценарии весь веб-сайт отображается на одном языке.

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

Языковой стандарт среды является параметром для веб-сайта по умолчанию. Если выбрать настройку директивы региональных стандартов определенной страницы или свойства UseBrowserLocale определенного элемента управления CrystalReportViewer на веб-сайте, эти настройки переопределят параметр языкового стандарта среды по умолчанию и предоставят возможность персонализированной локализации на уровне страницы или элемента управления CrystalReportViewer.

Процедура 1. Откройте страницу Default.aspx в представлении Проект.

В верхней части окна свойств отображается группа "Документ".

2. В окне Свойства отключите свойство Culture.

3. На компьютере разработки (для целей данного пособия его роль выполняет веб-сервер) измените языковой стандарт среды по умолчанию на панели управления Язык и региональные стандарты на Немецкий (Австрия).

Подробные инструкции по правильной настройке языкового стандарта среды в Windows XP или Windows 2000 см. в конце данного пособия в разделе Справочник: Настройка языкового стандарта 4. Если требуется перезагрузить компьютер, чтобы применить региональные стандарты, сделайте это 5. Повторно запустите веб-сайт в среде Visual Studio, а затем выполните сборку и компиляцию.

6. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов CrystalReportViewer.

7. После того, как отображаемый язык будет подтвержден, закройте браузер, чтобы выйти из режима отладки.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Результаты В данном сценарии:

Для свойства CrystalReportViewer.UseBrowserLocale задано значение False (эта операция описана выше в данном пособии). Следовательно, настройка языкового стандарта браузера, установленная в последний раз на испанский язык, игнорируется.

Региональные стандарты для страницы отключены. Поэтому указания на уровне страницы отсутствуют.

Выбором локализации по умолчанию является языковой стандарт среды веб-сервера, для которого только что было задано значение "Немецкий (Австрия)".

Следовательно, строки подсказки отображаются на немецком языке.

На этом демонстрация многоязыковой поддержки клиентов с динамической локализацией на веб-сайтах завершается. Остальные разделы посвящены динамической локализации в проектах Windows.

1.5.5.1.5 Настройка многоязыковой поддержки клиентов для приложения Windows Проект Windows получает доступ к языковым ресурсам глобально (на системном уровне) или локально (из исполняемой папки Windows).

Пользовательские языковые ресурсы можно помещать в глобальное или локальное расположение.

Языковые ресурсы по умолчанию всегда доступны глобально.

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

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

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

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide ресурсам Процедура 1. Измените настройки региональных стандартов на "Румынский".

Подробные инструкции по правильной настройке языкового стандарта среды в Windows XP или Windows 2000 см. в конце данного пособия в разделе Справочник: Настройка языкового стандарта 2. Скопируйте подкаталог языка ro из папки C:\CrystalReportViewer_resource_files\ в папку с исполняемым файлом Windows.

При разработке это, вероятно, будет папка \bin\debug\.

3. Скомпилируйте и запустите приложение Windows.

4. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов.

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

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

1.5.5.1.5.2 Доступ к глобальным пользовательским ресурсам (менее типичный подход для приложений Windows) Контекст В этом разделе приводятся пояснения по доступу к глобальным ресурсам.

Процедура 1. Измените настройки региональных стандартов на "Румынский".

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Подробные инструкции по правильной настройке языкового стандарта среды в Windows XP или Windows 2000 см. в конце данного пособия в разделе Справочник: Настройка языкового стандарта 2. В проводнике Windows найдите подкаталог с проектом Windows, который содержит исполняемый \[ПУТЬ_К_ПРОЕКТУ]\bin\debug\ 3. В этом подкаталоге создайте новый файл конфигурации XML со следующей информацией:

4. Сохраните этот файл под тем же именем, что и исполняемый файл, но добавьте расширение.config.

Имя исполняемого файла: CS_Win_Multilingual.exe Имя файла конфигурации: CS_Win_Multilingual.exe.config В Windows-приложениях Visual Basic этот файл, возможно, сгенерирован автоматически. В этом случае добавьте узел в существующем узле автоматически сгенерированного файла конфигурации.

5. Скомпилируйте и запустите приложение Windows.

6. Переместите курсор мыши так, чтобы он оказался над кнопками на панели инструментов.

1.5.5.1.6 Справочник: Настройка языкового стандарта среды Данный раздел относится как к веб-сайтам, так и к проектам Windows в той части, где требуется изменить языковой стандарт среды. В данном примере в региональных параметрах задан "Немецкий (Австрия)".

Приведенные ниже инструкции применимы к Windows XP и Windows 2000.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.5.5.1.6.1 Чтобы настроить языковой стандарт среды в Windows XP Процедура 1. Нажмите кнопку Пуск, выберите Панель управления, а затем Язык и региональные стандарты.

2. На вкладке Региональные параметры в списке Выберите элемент из списка или нажмите кнопку "Настройка", чтобы задать форматы самостоятельно выберите Немецкий (Австрия).

3. На вкладке Языки нажмите кнопку Подробнее...

Отображается диалоговое окно "Языки и службы текстового ввода".

4. На вкладке Параметры нажмите кнопку Добавить...

5. В диалоговом окне Добавление языка ввода выполните следующее:

a) В списке Язык ввода выберите Немецкий (Австрия).

b) В списке Раскладка клавиатуры или метод ввода (IME) выберите Немецкая (IBM).

6. Нажмите кнопку ОК.

7. В списке Язык ввода по умолчанию выберите Немецкий (Австрия), после чего нажмите кнопку ОК.

8. В списке Язык программ, не поддерживающих Юникод выберите Немецкий (Австрия).

9. Нажмите кнопку Применить, а затем ОК.

Результаты В Windows XP нет необходимости перезагружать компьютер, чтобы эти изменения вступили в силу.

1.5.5.1.6.2 Настройка языкового стандарта среды в Windows Процедура 1. В меню Пуск выберите Настройка, Панель управления, а затем Язык и региональные стандарты.

Отображается панель управления "Язык и региональные стандарты".

2. На вкладке Общие выполните следующие действия:

a) В списке Языковой стандарт (расположение) выберите Немецкий (Австрия).

b) Нажмите кнопку Установить по умолчанию...

c) В диалоговом окне Выбор языка системы выберите Немецкий (Австрия) и нажмите кнопку ОК.

3. На вкладке Языки ввода выполните следующее:

a) Нажмите кнопку Добавить...

b) В диалоговом окне Добавление языка ввода выберите в списке Язык ввода Немецкий (Австрия).

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide c) В списке Раскладка клавиатуры или метод ввода (IME) выберите Немецкая (IBM), после чего 4. Нажмите кнопку Применить.

Отображается диалоговое окно с запросом на установку файлов с жесткого диска или с компактдиска службы установки Windows.

5. Нажмите кнопку Да и продолжайте установку.

По завершении установки в диалоговом окне "Изменение языка и стандартов" отображается запрос на перезагрузку компьютера.

6. Нажмите кнопку Да.

Следующие шаги В Windows 2000 необходимо перезагрузить компьютер, чтобы эти изменения вступили в силу.

1.5.5.2 Учебное пособие: создание библиотеки пользовательских функций В данном учебном пособии приводятся инструкции по созданию библиотеки пользовательских функций, доступ к которой может осуществляться из эксперта формул во встроенном конструкторе SAP Crystal Reports.

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

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

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

Библиотека пользовательских функций (User Function Library, UFL) представляет собой библиотеку класса.NET со следующими характеристиками:

Префиксом в имени проекта является строка "CRUFL".

Проект состоит из интерфейса и класса реализации.

Интерфейс и класс реализации имеют атрибуты COM и GUID.

После компиляции сборка регистрируется для COM Interop, так что она рассматривается как объект © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Сборка/объект COM добавляется в глобальный кэш сборок, что делает сборку или объект доступными для всех приложений.NET на компьютере.

Затем эта сборка/объект COM (библиотека пользовательских функций, или UFL) начинает отображаться во встроенном конструкторе SAP Crystal Reports в виде настраиваемой функции ("Функции>Дополнительные функции>u2lcom.dll").

Примеры кода Данное учебное пособие содержит образцы кода на языках Visual Basic и C#, демонстрирующие готовую версию проекта. Следуя инструкциям пособия, создайте новый проект или откройте проект примера кода, чтобы начать работу с завершенной версией.

Примеры кода хранятся в папках, упорядоченных по языку и типу проекта. Ниже приведены имена папок для каждой версии примера кода.

Библиотека классов C#: CRUFL_CS_ExchangeRate Библиотека классов VB: CRUFL_VB_ExchangeRate База данных Xtreme В этом учебном пособии используется пример базы данных под названием Xtreme. Файл xtreme.mdb базы данных включен в пакет примеров кода SAP Crystal Reports.NET SDK. Чтобы использовать базу данных Xtreme, необходимо вручную создать соединение ODBC с ней.

Связанные сведения Каталог образцов отчетов [стр. 15] Контекст В этом разделе описан процесс создания библиотеки классов UFL и ее настройки с целью регистрации для COM Interop.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. Запустите Visual Studio.

2. В меню Файл выберите команду Создать, а затем Проект.

3. В диалоговом окне Создание проекта выберите папку языка C# или Visual Basic из списка Типы 4. В списке Шаблоны выберите элемент Библиотека классов.

5. В поле Имя введите одно из следующих имен:

CRUFL_VB_ExchangeRate (Visual Basic) CRUFL_CS_ExchangeRate (C#) Все библиотеки пользовательских функций должны иметь префикс CRUFL, чтобы они могли распознаваться встроенным конструктором SAP Crystal Reports.

6. Нажмите кнопку ОК.

7. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, и выберите команду Свойства.

8. Откройте вкладку Построение/Компиляция.

9. Если вы работаете в Visual Basic, в списке OptionStrict выберите пункт On.

10. С помощью прокрутки перейдите вниз окна Построение/Компиляция и выберите Зарегистрировать для COM Interop.

Параметр "Зарегистрировать для COM Interop" означает, что утилита regasm.exe осуществляет автоматическую регистрацию сборки по завершении компиляции проекта. Поэтому нет необходимости запускать regasm.exe вручную из командной строки.

11. В меню Файл выберите команду Сохранить все.

12. Закройте окно Компиляция/Построение.

Результаты Теперь можно создавать интерфейс.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.5.5.2.2 Создание интерфейса с помощью атрибутов COM Контекст В данном разделе описывается создание интерфейса и его настройка с помощью атрибутов COM.

Процедура 1. Удалите класс по умолчанию (Class1).

2. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, укажите пункт Добавить, а затем выберите команду Класс.

3. В поле Имя введите "IExchangeUfl" и нажмите кнопку Добавить.

4. Измените подпись класса с class на interface и задайте область действия public.

В Visual Basic не забудьте изменить начальную и конечную подписи. В C# удалите конструктор.

Public Interface IExchangeUfl public interface IExchangeUfl 5. Над объявлением класса добавьте следующий оператор using/Imports:

Imports System.Runtime.InteropServices using System.Runtime.InteropServices;

6. В меню Сервис выберите команду Создать GUID.

7. В диалоговом окне Создание GUID в области Формат GUID нажмите кнопку Формат реестра.

8. Выберите Создать GUID.

9. Нажмите кнопку Копировать и закройте диалоговое окно.

10. Над объявлением интерфейса создайте атрибут с тремя значениями: ComVisible, InterfaceType и Guid (в C#) или GuidAttribute (в Visual Basic) с кавычками строки параметров.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide В Visual Basic для лучшей читабельности добавьте символ подчеркивания после закрывающего тега, который помещает класс на следующую строку.

Public Interface IExchangeUfl [ComVisible(), InterfaceType(), Guid("")] public interface IExchangeUfl 11. Введите значение параметра "True" [Visual Basic] или "true" [C#] в атрибут ComVisible.

12. Введите значение параметра ComInterfaceType.InterfaceIsDual из перечисления ComInterfaceType в атрибут InterfaceType.

13. Вставьте значение GUID из буфера обмена в значение параметра атрибута Guid. Будьте внимательны и удалите все фигурные скобки и символы возврата каретки.

Не используйте GUID, имеющийся во фрагменте кода ниже. Создайте уникальный GUID для своего Public Interface IExchangeUfl [ComVisible(true), InterfaceType(ComInterfaceType.InterfaceIsDual), Guid("E7A4EC98-BF2B-4006-B266-74C74421C394")] public interface IExchangeUfl 14. В интерфейсе IExchangeUfl создайте метод подписи.

Этим методом подписи станет имя функции, предоставляемой во встроенном конструкторе SAP Crystal Reports.

Function ConvertUSDollarsToCDN(ByVal usd As Double) As Double double ConvertUSDollarsToCDN(double usd);

15. Закройте окно интерфейса.

1.5.5.2.3 Создание класса реализации с помощью атрибутов COM Контекст В этом разделе описана процедура создания класса реализации, реализующего интерфейс IExchangeUfl, и последующая настройка этого класса с помощью атрибутов COM.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, выберите команду Добавить, а затем Класс.

2. В поле Имя введите "ExchangeUfl" и нажмите кнопку Добавить.

3. Измените подпись класса для реализации интерфейса IExchangeUfl.

Public Class ExchangeUfl : Implements IExchangeUfl public class ExchangeUfl : IExchangeUfl 4. Над объявлением класса добавьте следующий оператор using/Imports:

Imports System.Runtime.InteropServices using System.Runtime.InteropServices;

5. В меню Сервис выберите команду Создать GUID.

6. В диалоговом окне Создание GUID в области Формат GUID нажмите кнопку Формат реестра.

7. Выберите Создать GUID.

8. Нажмите кнопку Копировать и закройте диалоговое окно.

9. Над объявлением класса создайте атрибут с тремя значениями: ComVisible, ClassInterface и Guid (в C#) или GuidAttribute (в Visual Basic) с кавычками строки параметров.

Public Class ExchangeUfl : Implements IExchangeUfl [ComVisible(), ClassInterface(), Guid("")] public class ExchangeUfl : IExchangeUfl 10. Введите значение параметра "True" [Visual Basic] или "true" [C#] в атрибут ComVisible.

11. Введите значение параметра ClassInterfaceType.None из перечисления ClassInterfaceType в атрибут ClassInterface.

12. Вставьте значение GUID из буфера обмена в значение параметра атрибута Guid. Будьте внимательны и удалите все фигурные скобки и символы возврата каретки.

Не используйте GUID, имеющийся в данном фрагменте кода. Создайте уникальный GUID для своего Public Class ExchangeUfl : Implements IExchangeUfl [ComVisible(true), ClassInterface(ClassInterfaceType.None), Guid("F5DCE88F-AD38-4a9a-9A69-0F8DC0EDB4E3")] public class ExchangeUfl : IExchangeUfl 13. В ExchangeUfl создайте договорной метод подписи из интерфейса с помощью открытого метода.

Это будет имя функции, предоставляемой во встроенном конструкторе SAP Crystal Reports.

Public Function ConvertUSDollarsToCDN1(ByVal usd As Double) As Double Implements IExchangeUfl.ConvertUSDollarsToCDN public double ConvertUSDollarsToCDN(double usd) © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 14. В методе создайте условный блок, который проверяет, превышает ли параметр метода usd значение Double.MaxValue, и если да, возвращает исключение.

Выполнить такую проверку необходимо во избежание опасности переполнения.

If usd > Double.MaxValue Then Throw New Exception("Переданное значение больше максимального значения, допустимого для Double.") if(usd > Double.MaxValue) throw new Exception("Переданное значение больше максимального значения, допустимого для Double.");

15. После проверки, выполненной условным блоком, верните параметр метода usd, умноженный на обменный курс 1,45.

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

return (usd * 1.45);

16. В меню Файл выберите команду Сохранить все.

17. Закройте окно класса.

1.5.5.2.4 Присвоение ключа строгого имени библиотеке классов Контекст В этом разделе описана процедура присвоения ключа строгого имени библиотеке классов.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, и выберите команду Свойства.

2. Откройте вкладку Подписи.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 3. Установите флажок Добавление подписи сборки.

4. В комбинированном списке Выбор файла ключей строгого имени: выберите пункт 5. В диалоговом окне Создать ключ строгого имени в текстовом поле Имя файла ключей: введите строковое значение.

Например, возможным строковым значением может быть ваша фамилия и сегодняшняя дата.

6. Снимите флажок Защитить файл ключей паролем и нажмите кнопку ОК.

7. Закройте окно Подписи.

8. В меню Построение выберите команду Построение решения.

9. Закройте Visual Studio.

Следующие шаги Далее следует добавить сборку в глобальный кэш сборок (GAC).

1.5.5.2.5 Добавление сборки в глобальный кэш сборок Контекст В этом разделе рассказывается о добавлении сборки в глобальный кэш сборок (GAC).

Процедура 1. Найдите проект в Проводнике Windows на своем компьютере.

2. В созданном проекте найдите подкаталог \bin\Debug\. Подтвердите, что DLL-библиотека сборки находится в этом каталоге.

3. Скопируйте путь к каталогу DLL-библиотеки в буфер обмена.

4. Нажмите кнопку Пуск, выберите пункт Программы > Microsoft Visual Studio > Инструменты Visual Studio, а затем Командная строка Visual Studio.

5. Необходимо заменить каталог на тот, который содержит DLL-библиотеку. Для этого начните с ввода команды смены каталога:

6. Добавьте пробел после команды cd, а затем щелкните правой кнопкой мыши и вставьте путь к каталогу из буфера.

7. Нажмите клавишу Enter.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Проверьте, изменился ли каталог на тот, который содержит DLL-библиотеку сборки.

8. Введите следующую команду и замените DLL-библиотеку сборки, отображаемую во фрагменте кода, именем нужной вам DLL-библиотеки сборки.

gacutil -if CRUFL_CS_ExchangeRate.dll 9. Нажмите клавишу Enter.

После этого должно отобразиться сообщение о том, что сборка добавлена в кэш. Если появляется сообщение об ошибке, еще раз проверьте написание имени файла DLL-библиотеки сборки и запустите gacutil повторно.

10. Закройте командную строку Visual Studio.

11. В проводнике Windows найдите подкаталог \assembly\, расположенный в каталоге \Windows\ или \WinNT\.

Теперь добавленная сборка должна отображаться в подкаталоге сборки (он называется GAC, или глобальный кэш сборок).

Результаты Теперь можно создать отчет Crystal, который обращается к этой пользовательской функции.

1.5.5.2.6 Добавление пользовательской функции в отчет Crystal Предпосылки Данная процедура работает только с проектами, созданными из Настройка проекта [стр. 16]. Настройка проекта включает специальные ссылки на пространство имен и конфигурацию кода, необходимую для выполнения данной процедуры. Выполнение процедуры без этой конфигурации невозможно.

Контекст В данном разделе описана процедура создания отчета Crystal, обращающегося к пользовательской функции.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, укажите пункт Добавить, а затем выберите команду Добавить новый элемент.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 2. В диалоговом окне Добавление нового элемента в представлении Шаблоны выберите шаблон с именем Отчет Crystal.

3. В поле Имя введите имя FunctionTest.rpt, затем нажмите кнопку Добавить.

4. На панели Создание нового документа Crystal Report диалогового окна Галерея Crystal Reports выберите С помощью мастера отчетов.

5. На панели Выбор мастера выберите параметр Стандарт, затем нажмите кнопку ОК.

6. На панели Доступные источники данных окна Мастер создания стандартных отчетов разверните папку Создать новое соединение.

7. В открывшейся подпапке разверните папку ODBC (RDO).

8. В окне ODBC (RDO) выберите правильную запись ODBC DSN для базы данных Xtreme, затем нажмите кнопку Готово.

Папка ODBC (RDO) развернется и отобразит базу данных Xtreme.

9. Разверните узел Таблицы и выберите таблицу Клиент.

10. Дважды щелкните таблицу Customer, чтобы переместить ее на панель Выбранные таблицы, после чего нажмите кнопку Далее.

11. Удерживая клавишу CTRL, щелкните Имя клиента, Продажи за прошлый год и Город.

12. Нажмите значок >, чтобы переместить эти поля в панель Отображаемые поля, а затем нажмите кнопку 13. В области Доступные поля в группе Поля отчета выберите Клиент.Город, щелкните символ >, чтобы переместить поле в область Группировать по, и нажмите кнопку Готово.

Отчет FunctionTest создается и загружается в основное окно Visual Studio.

14. Если Проводник полей не отображается, на панели инструментов Crystal Reports нажмите кнопку Переключение вида поля.

Для отображения Проводника полей также можно открыть меню Crystal Reports и выбрать пункт Проводник полей.

15. В Проводнике полей щелкните правой кнопкой мыши элемент Поля формул и выберите команду Создать...

16. В диалоговом окне Имя формулы введите имя MyFunctionFormula, а затем выберите Использовать Отображается окно мастера формул с четырьмя панелями по горизонтали.

17. На третьей панели разверните список Функции.

18. Разверните список Дополнительные функции, а в нем – список UFL Visual Basic (u212lcomm.dll).

Отображается созданная функция: CSExchangeRateExchangeUflConvertUSDollarsToCDN (или VBExchangeRateExchangeUflConvertUSDollarsToCDN).

19. Дважды щелкните функцию CSExchangeRateExchangeUflConvertUSDollarsToCDN (или VBExchangeRateExchangeUflConvertUSDollarsToCDN).

Функция CSExchangeRateExchangeUflConvertUSDollarsToCDN() (или VBExchangeRateExchangeUflConvertUSDollarsToCDN()) отображается в нижней области, где теперь можно создать формулу.

20. В нижней области установите курсор внутрь скобок функции.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 21. Во второй области разверните список Поля отчета, затем дважды щелкните Клиент.Продажи за прошлый год.

"Клиент.Продажи за прошлый год" вводится в виде параметра в функцию ConvertUSDollarsToCDN.

22. На панели инструментов нажмите кнопку Проверить.

Осуществляется проверка формулы: ошибок не найдено.

23. Закройте редактор формул.

24. Из Проводника полей в узле Поля формул перетащите MyFunctionFormula вправо от поля Продажи за прошлый год в разделе отчета Подробности.

25. Упорядочите поля, чтобы они правильно располагались в отчете.

26. Выберите Предварительный просмотр основного отчета.

Отображается отчет, в котором пользовательская функция рассчитала значение в поле MyFunctionFormula.

27. Нажмите кнопку Основной отчет для выхода из режима предварительного просмотра.

1.5.5.2.7 Создание отчета FunctionTest в качестве невстроенного отчета и его привязка к элементу управления CrystalReportViewer Контекст В Настройка проекта [стр. 16] мы поместили элемент управления CrystalReportViewer на веб- или Windows-форму. На предыдущем этапе вы добавили отчет FunctionTest в проект.

В данном разделе приводятся пояснения по созданию отчета FunctionTest в качестве невстроенного отчета и его привязке к элементу управления CrystalReportViewer.

Процедура 1. Откройте веб-форму или форму Windows.

2. В меню Вид выберите команду Код.

3. Добавьте новое объявление уровня класса для класса-обертки отчета ReportDocument, используя имя переменной functionTestReport. Установите для него модификатор доступа private.

Класс ReportDocument является элементом пространства имен CrystalDecisions.CrystalReports.Engine. Объявление "Imports" [Visual Basic] или "using" [C#] добавлено для этого пространства имен в Настройка проекта [стр. 16]. Создание экземпляра Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide ReportDocument и загрузка отчета в пространство имен позволяют получить доступ к отчету с помощью SDK, не встраивая этот отчет.

Private functionTestReport As ReportDocument private ReportDocument functionTestReport;

4. В методе ConfigureCrystalReports() (созданном в разделе Настройка проекта [стр. 16]) создайте класс ReportDocument.

functionTestReport = New ReportDocument() functionTestReport = new ReportDocument();

5. В следующей строке вызовите метод Load() экземпляра ReportDocument и вставьте его в имя файла Сверните имя файла отчета в метод Server.MapPath() (веб-проект) или сопоставьте имя отчета строке, возвращенной Application.StartupPath() (форма Windows). Для веб-проектов будет автоматически создан путь к файлу отчета на основе названия отчета. Для проектов форм Windows необходимо копировать отчет в каталог, содержащий исполняемый файл.

functionTestReport.Load(Server.MapPath("FunctionTest.rpt")) functionTestReport.Load(Server.MapPath("FunctionTest.rpt"));

6. В следующей строке после загрузки отчета свяжите свойство ReportSource объекта CrystalReportViewer с экземпляром ReportDocument.

myCrystalReportViewer.ReportSource = functionTestReport crystalReportViewer.ReportSource = functionTestReport;

Все готово к сборке и запуску проекта.

7. В меню Отладка выберите команду Начать.

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

8. Вернитесь в среду Visual Studio и нажмите кнопку Остановить, чтобы выйти из режима отладки.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide В этом разделе описан процесс развертывания для веб- или Windows-приложений, использующих SAP Crystal Reports.

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

Развертывание веб-сайтов и проектов Windows, использующих SAP Crystal Reports, доступно только в том случае, если на компьютере установлена версия SAP Crystal Reports для разработчиков Microsoft Visual Studio.

1.6.1 Компоненты развертывания Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio поддерживает проекты развертывания, позволяющие развертывать приложения на целевых компьютерах. Используются такие проекты развертывания: установочный проект для приложений Windows и установочный проект вебприложения для веб-сайтов.

Чтобы распространить приложение Visual Studio, использующее SAP Crystal Reports, проекту необходимы описанные ниже компоненты в зависимости от типа выполняемого развертывания.

Установщик Windows (MSI) Компоненты, позволяющие клиентам просматривать приложения,.NET Framework версии 1.x или Компоненты.NET, необходимые для работы приложения.

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

Дополнительные компоненты сторонних производителей, которые необходимо развернуть для работы приложения, это сборки SAP Crystal Reports. Сборки SAP Crystal Reports – это DLL-файлы, необходимые для просмотра, экспорта и печати отчета. Эти сборки развертываются в виде отдельного MSI-файла из файлов приложения и RPT-файлов.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide При развертывании веб-сайта ASP.NET в проект развертывания необходимо включить следующие файлы:

файлы Aspx;

файлы Aspx.cs или Aspx.vb;

изображения, HTML-файлы или CSS-файлы.

При развертывании приложения Windows в проект развертывания необходимо включить следующие файлы:

файлы Form.cs или Form.vb;

файлы Form.Designer.cs или Form.Designer.vb;

Resources.resx;

Resources.Designer.cs или Resources.Designer.vb;

изображения, HTML-файлы или CSS-файлы.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Развертывание ClickOnce При развертывании приложения Windows с помощью развертывания ClickOnce необходимо скопировать все файлы приложения и RPT-файлы на веб-сервер отдельно от файлов.NET Framework, которые также копируются на этот веб-сервер. После этого можно установить самую последнюю версию приложения на целевой компьютер с общей веб-страницы. Файлы приложения, включаемые в проект развертывания:

файлы Form.cs или Form.vb;

файлы Form.Designer.cs или Form.Designer.vb;

Resources.resx;

Resources.Designer.cs или Resources.Designer.vb;

изображения, HTML-файлы или CSS-файлы.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide К выходным файлам проекта относятся файлы веб- или Windows-приложений, которые необходимо добавить к проектам развертывания. Добавить можно один или несколько из описанных ниже типов выходных файлов проекта.

Параметр Основные выходные файлы добавляет все DLL- и EXE-файлы, созданные из веб- или Windows-приложений.

В SAP Crystal Reports для Visual Studio 2005 и более поздних версиях были внесены изменения, и из веб-сайтов были исключены DLL- и EXE-файлы. Поэтому к веб-сайтам основные выходные файлы не добавляются.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Параметр Файлы содержимого добавляет файлы Web.config, Global.asax и все формы Web Forms (ASPX-страницы), созданные в веб-приложениях, или файл App.ico для приложений Windows.

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

Основные выходные файлы необходимо добавить к установочным проектам Winform, а файлы содержимого – к веб-проектам, содержащим ASPX-файлы.

Файлы отчета, которые необходимо включить в проект развертывания, зависят от сценария связывания, используемого с веб- или Windows-проектами. В сценариях связывания SAP Crystal Reports используются как встроенные, так и невстроенные отчеты.

В приложениях версии SAP Crystal Reports для разработчиков Microsoft Visual Studio внедренные отчеты компилируются непосредственно в приложение. Поэтому приложение можно развертывать без необходимости отдельного распространения файлов отчета.

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

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

Установка связи с невстроенным отчетом, загру женным в класс ReportDocument [стр. 205] Установка связи с невстроенным отчетом, загру женным в класс утилит управления кэш-памя Связывание с классом встроенных отчетов [стр.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Связывание с классом кэшированных встроен ных отчетов [стр. 208] Установка связи с Crystal Enterprise (SAP Crystal Reports 10 и более поздние версии) [стр. 222] Связанные сведения Сравнение встроенных и невстроенных отчетов [стр. 167] Для развертывания приложения Visual Studio.NET на целевом компьютере необходимо установить.NET Framework до того, как будет установлен проект развертывания. При создании проекта развертывания.NET Framework по умолчанию не включен.

Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio поддерживает.Net Framework 2. и более поздней версии, включая платформу версии 4.0.

.NET Framework можно загрузить на веб-сайте Microsoft.

1.6.1.4 Поддержка 64-разрядных приложений Приложение, разработанное в.NET 2.0 Framework и более поздних версиях, может работать на 32- и 64разрядных компьютерах. В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio поддерживается 32- и 64-разрядная x64 (AMD64) архитектура.

Разработка 64-разрядного приложения Далее описаны возможные сценарии разработки 64-разрядного приложения.

С помощью 32-разрядной версии SAP Crystal Reports для разработчиков Microsoft Visual Studio на компьютере под управлением 32-разрядной ОС Windows.

С помощью 32-разрядной версии SAP Crystal Reports для разработчиков Microsoft Visual Studio на сервере под управлением 64-разрядной ОС Windows. Администратор должен установить на сервере 64-разрядную среду CLR и 64-разрядные компоненты времени выполнения распространяемого пакета SAP Crystal Reports.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide С помощью 32-разрядной версии SAP Crystal Reports для разработчиков Microsoft Visual Studio в среде WOW64 (эмулятор х86 для выполнения 32-разрядных приложений на 64-разрядном компьютере) на сервере или рабочей станции под управлением 64-разрядной ОС Windows. 32- и 64-разрядные распространяемые пакеты времени выполнения SAP Crystal Reports должны быть установлены на одном и том же компьютере.

1.6.1.5 Распространяемый пакет исполняемого модуля SAP Crystal Reports Распространяемый пакет исполняемого модуля SAP Crystal Reports содержит сборки, необходимые для запуска приложений.NET, разработанных в SAP Crystal Reports SDK.

Если версия SAP Crystal Reports для разработчиков Microsoft Visual Studio не установлена на целевом компьютере, распространяемый пакет устанавливаться отдельно.

В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio представлены следующие типы распространяемых модулей установки:

Распространяемые модули с типом MSI предназначены для развертываний ClickOnce, групповой Модули объединения с типом MSM предназначены для разработчиков, создающих собственные среды установки, которые будут встраиваться в исполняемый модуль CR.NET в среде установки хоста.

Пакет MSI имеет одинаковые с модулями MSM компоненты, но не разрешает одинаковые параметры конфигурации. Пакет MSI используется только для полного развертывания встроенной платформы создания отчетов SAP Crystal Reports.NET.

ния отчетов SAP Crystal Reports.NET, многоязычная Имя файла:

CRRuntime_32bit_13_x.msi CRRuntime_64bit_13_x.msi Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Встроенная платформа созда MSM Встроено в уста Содержит следующие группы компонен ния отчетов SAP Crystal Имя файла:

CRRuntime_13_0_xx.msm Связанные сведения Файлы языковых ресурсов [стр. 233] 1.6.1.5.2 Выполнение автоматической установки исполняемого модуля SAP Crystal Reports Контекст Автоматическая установка выполняется из командной строки и не требует взаимодействия с пользователем.

Процедура 1. Запустите командную строку.

2. Укажите путь к файлу установщика Windows.

3. Запустите исполняемый файл CRRuntime_32bit_13_x.msi или CRRuntime_64bit_13_x.msi.

msiexec.exe /i "C:\install.msi" /qn Результаты Исполняемый модуль SAP Crystal Reports будет установлен автоматически.

1.6.1.5.3 Параметры установки модулей объединения (дополнительно) В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio модули объединения, добавленные в проект развертывания, позволяют включать или исключать определенную базу данных SAP Crystal Reports и драйверы экспорта. В этом задании будет рассмотрена конфигурация параметров установки.

1.6.1.5.3.1 Чтобы изменить определенный параметр установки Процедура 1. Откройте проект развертывания в Visual Studio.

2. В Проводнике решений разверните узел проекта установки. Выберите модуль объединения, добавленный в проект развертывания на основе типа компьютера, на котором выполняется развертывание.

3. В окне Свойства разверните узел (MergeModuleProperties). Откроется таблица с драйверами, доступными для установки.

4. Установите значение определенного драйвера.

Установите значение 1, чтобы включить драйвер в проект развертывания.

Установите значение 0, чтобы исключить драйвер из проекта развертывания.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.6.1.5.3.2 Параметры установки SAP Crystal Reports драйверы базы данных © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Драйверы экспорта Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Другие 1.6.2 Развертывание для Visual Studio Существует два способа выполнить развертывание проекта, использующего версию SAP Crystal Reports для разработчиков Microsoft Visual Studio:

Развертывание с помощью ClickOnce Развертывание с помощью установщика Windows Развертывание с помощью установщика Windows Развертывание с помощью установщика Windows является предпочтительным способом развертывания проектов, использующих компоненты версии SAP Crystal Reports для разработчиков Microsoft Visual Studio. При использовании установщика Windows можно развертывать проекты и веб-серверы на отдельных компьютерах.

Преимущества:

Позволяет произвести обновление исполняемого модуля SAP Crystal Reports с помощью последних пакетов обновления или исправлений без повторного развертывания приложения.

Файлы времени выполнения SAP Crystal Reports устанавливаются только один раз.

Позволяет конечному пользователю выполнять автоматическую установку.

Ограничения:

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Отдельная установка приложения и компонентов исполняемого модуля SAP Crystal Reports.

Устанавливаются все драйверы базы данных и экспорта.

Развертывание с помощью ClickOnce Развертывание с помощью ClickOnce упрощает развертывание приложений Windows в сети. Используя развертывание с помощью ClickOnce, конечный пользователь теперь имеет возможность установить последнюю версию приложения с общей веб-страницы вместо того, чтобы развертывать приложение Windows на каждый отдельный компьютер назначения.

Преимущества:

Позволяет конечному пользователю одним щелчком мыши установить приложение и все его зависимости, такие как.NET Framework или SAP Crystal Reports.

Автоматически выполняет поиск новой версии приложения, после чего загружает и устанавливает обновление.

Ограничения:

Не работает с.NET 1.x Framework.

Увеличенное время установки для исполняемого модуля SAP Crystal Reports.

Развертывание модулей объединения Развертывание модулей объединения можно использовать для развертывания приложений Windows и вебпроектов. С помощью развертывания модулей объединения можно прикрепить набор компонентов, который исключит конфликт версий и другие проблемы установки. Компоненты могут включать файл.dll, ресурсы, записи регистрации, логику установки и связанные файлы.

Преимущества:

Позволяет выбирать базу данных и драйвера экспорта для установки.

Отдельная установка приложения и компонентов исплняемого модуля Crystal Reports.

Конечные пользователи не получают подсказки для ввода ключевого кода продукта во время установки. Ключевой код продукта встроен в программу установки.

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

Интерфейс пользователя, указывающий идентификатор торговой марки Crystal Reports или Business Objects, не показывается пользователю.

Ограничения:

Обновление компонентов исполянемого модуля Crystal Reports требует повторной установки с последними модулями объединения и повторного развертывания приложения на целевом компьютере.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Чтобы работать с пособиями по развертыванию в данном разделе, необходимо выполнить следующие требования Настройка проекта [стр. 16].

Проверьте, соблюдены ли следующие требования:

Установлена среда Visual Studio.

Веб-приложение или приложение Windows, использующее SAP Crystal Reports.

Установщик Windows предоставляет файлы исполняемого модуля SAP Crystal Reports, необходимые для проекта развертывания.

Связанные сведения Поддерживаемые версии среды Visual Studio [стр. 10] 1.6.2.2 Развертывание ClickOnce для Visual Studio В данном разделе приведены пояснения по развертыванию проектов при помощи технологии ClickOnce.

Технология развертывания ClickOnce позволяет сократить время и усилия, затрачиваемые на развертывание приложений Windows в сети. Вместо того, чтобы распространять по одному исполняемому файлу на каждый отдельный жесткий диск, технология развертывания ClickOnce позволяет разместить исполняемый файл на общей веб-странице, с которой все пользователи могут его запустить. В процессе запуска один экземпляр извлекается на жесткий диск пользователя, поэтому его можно использовать для повторного запуска приложения локально. Однако эта локальная копия регулярно проверяет исходный исполняемый файл на веб-странице на наличие обновлений.

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

1.6.2.2.1 Установка параметров развертывания ClickOnce Предпосылки У вас должно быть готовое приложение Windows, которое использует SAP Crystal Reports.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Контекст Необходимо установить свойства безопасности и публикации в окне свойств приложения.

Свойство Security задает полномочия для приложения. По умолчанию для развертывания ClickOnce имеется ограниченное подмножество полномочий. Можно задать полномочия для развертывания только на клиентских компьютерах в сети Интранет или Интернет, либо предоставить полные полномочия.

Свойство Publish задает местоположение развертывания в виде URL-адреса веб-сайта, адреса FTPсервера или пути к файлу. Кроме того, это свойство задает необходимые компоненты и обновления для развернутого приложения.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, и выберите пункт Свойства.

2. Откройте вкладку Защита.

3. Установите параметр Включить настройки защиты ClickOnce.

По умолчанию для ClickOnce установлен параметр защиты Это абсолютно надежное приложение.

4. Откройте вкладку Публикация и нажмите кнопку Предварительные условия.

5. В диалоговом окне Обязательные компоненты в списке Выбор обязательных компонентов для установки выберите нужную версию.Net Framework и версию SAP Crystal Reports. Подробнее см. ниже.

Если перед развертыванием приложения Windows клиенты самостоятельно устанавливают нужную версию SAP Crystal Reports и рабочей среды.NET Framework, продолжительность установки значительно уменьшается.

6. Нажмите кнопку ОК.

7. На вкладке Публикация нажмите кнопку Обновления. В диалоговом окне Обновления приложения должны быть установлены следующие параметры:

a) Установите Проверять на наличие обновлений приложения.

b) В списке Выберите время проверки на наличие обновлений приложения выберите Перед запуском 8. Нажмите кнопку ОК для закрытия диалогового окна.

9. В меню Файл выберите команду Сохранить все.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.6.2.2.2 Публикация приложения Windows Контекст В данном разделе приводятся инструкции по использованию мастера публикаций для публикации приложения Windows на веб-сайте.

При изменении приложения на компьютере разработчика опубликуйте приложение повторно и настройте свойства обновления. Если на клиентском компьютере открывается более старая версия приложения, клиент получает уведомление о новой версии приложения Windows.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши имя проекта, выделенное жирным шрифтом, и выберите команду Опубликовать.

2. Когда отобразится диалоговое окно Мастер публикаций, укажите расположение, в котором требуется опубликовать это приложение, и нажмите кнопку Далее.

3. В диалоговом окне Сделать приложение доступным автономно? нажмите кнопку Да, это приложение будет доступно в интерактивном или автономном режиме, а затем кнопку Далее.

4. В диалоговом окне Готово к публикации! запишите URL-адрес ресурса, на котором публикуется приложение, и нажмите кнопку Готово.

1.6.2.2.3 Установка и запуск приложения Windows на клиентском компьютере Контекст Для завершения развертывания по технологии ClickOnce необходимо открыть опубликованный веб-сайт на клиентском компьютере и выбрать вариант, который будет использоваться при установке приложения Windows.

Процедура 1. Откройте окно веб-браузера на клиентском компьютере.

2. В адресной строке обозревателя введите URL-адрес опубликованного веб-сайта, созданного при выполнении предыдущей процедуры.

http://localhost/ProjectName/publish.htm © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide На опубликованном веб-сайте отображается имя вашего приложения Windows.

3. Веб-сайт содержит ссылки для установки и запуска приложения Windows с обязательными компонентами или без них.

Откройте ссылку Запуск, чтобы запустить приложение, если вы уже установили обязательные компоненты на клиентском компьютере.

Нажмите кнопку Установить, чтобы установить обязательные компоненты на клиентский компьютер и запустить приложение.

4. Установите приложение, приняв условия лицензионного соглашения, если оно будет выведено.

5. По завершении установки доступ к приложению Windows осуществляется через меню Пуск.

1.6.2.3 Развертывание с помощью установщика Windows для Visual Studio В этом разделе приводятся пояснения по развертыванию проектов, использующих версию SAP Crystal Reports для разработчиков Microsoft Visual Studio, с помощью технологии установщика Windows.

Установщик Windows позволяет работать с менее объемными проектами развертывания и уменьшает время установки.

Установщик Windows можно использовать в том случае, когда на одном компьютере назначения установлено много проектов развертывания. В этом случае файлы исполняемого модуля SAP Crystal Reports устанавливаются только один раз.

1.6.2.3.1 Создание нового проекта развертывания вебсайта с помощью установщика Windows Для развертывания веб-сайта следуйте инструкциям, приведенным в данном разделе пособия.

Для развертывания веб-сайта, использующего версию SAP Crystal Reports для разработчиков Microsoft Visual Studio, необходимо сначала создать проект веб-установки. Затем добавьте выходные файлы, необходимые для запуска приложения. Последним этапом будет сборка файлов установки, которые выполнят развертывание веб-сайта.

1.6.2.3.1.1 Создание проекта веб-установки для вебсайтов Предпосылки Для этого необходим веб-сайт, на котором используется SAP Crystal Reports.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Контекст В этом примере приведены сведения, необходимые для создания проекта веб-установки для веб-сайтов на основе проектов развертывания, имеющихся в Visual Studio.

Процедура 1. Откройте веб-сайт в среде Visual Studio.

2. В меню Файл выберите команду Добавить, а затем Новый проект.

3. Перейдите к панели Типы проектов в диалоговом окне Добавить новый проект.

4. Разверните узел Другие типы проектов и выберите пункт Проекты установки и развертывания.

5. На панели Шаблоны нажмите кнопку Проект веб-установки.

6. Выберите соответствующее имя проекта и укажите его расположение, после чего нажмите кнопку ОК.

В рамках настоящего пособия проект настройки имеет присвоенное по умолчанию имя WebSetup1.

7. На вкладке Файловая система нажмите кнопку Папка веб-приложения.

8. В окне Свойства пропишите в свойстве DefaultDocument начальную страницу веб-сайта (файл ASPX).

В качестве значения свойства VirtualDirectory проекта веб-установки задано имя проекта.

1.6.2.3.1.2 Добавление выходных файлов в проект вебустановки Контекст В этом разделе описан процесс добавления в проект веб-установки выходных файлов, используемых на веб-сайте.

Процедура 1. В Проводнике решений щелкните правой кнопкой мыши элемент WebSetup1, выберите команду Добавить, а затем Вывод проекта....

2. В диалоговом окне Добавление группы вывода проекта выберите Файлы содержимого и Основной вывод (при наличии).

Оставьте имеющееся значение параметра Конфигурация ("Активная").

Контекст При сборке проекта веб-установки создаются файлы программ установки для копирования их на другие компьютеры. Для развертывания веб-сайта можно запустить любую из этих программ установки на компьютере назначения.

Процедура 1. В окне Обозреватель решений щелкните правой кнопкой мыши элемент WebSetup1 и выберите пункт Свойства.

В рамках настоящего пособия проект настройки имеет присвоенное по умолчанию имя WebSetup1.

2. Измените конфигурацию решения на Выпуск.

3. В меню Построение выберите пункт Построение WebSetup1.

Результаты В рамках процесса построения создаются следующие файлы установщика:

setup.exe setup1.msi 1.6.2.3.1.4 Развертывание проекта веб-установки Предпосылки Для сервера приложений целевого компьютера необходимо задать номер версии, соответствующий версии.NET Framework, которая использовалась для построения проекта установки.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. Вне Visual Studio перейдите к каталогу, в котором сохранен ваш проект развертывания.

2. Дважды щелкните папку WebSetup1.

3. Откройте папку Release, чтобы найти файлы, построенные проектом веб-установки.

4. Скопируйте все файлы на компьютер назначения.

5. Распространите отчеты Crystal, используемые на веб-сайте.

Подробные сведения о том, какие сценарии привязки требуют распространения файлов отчета, см. в разделе Файлы отчета [стр. 629].

6. На компьютере назначения дважды щелкните Setup.exe или WebSetup1.msi для установки вебсайта.

7. Чтобы просмотреть развернутый веб-сайт, откройте окно веб-браузера на компьютере назначения.

Затем введите в адресной строке http://localhost/WebSetup1.

Замените параметр localhost именем сервера.

1.6.2.3.2 Создание нового проекта развертывания приложения Windows с помощью установщика Windows Для развертывания приложений Windows следуйте инструкциям, приведенным в данном разделе пособия.

Для развертывания приложения Windows, использующего версию SAP Crystal Reports для разработчиков Microsoft Visual Studio, необходимо сначала создать проект установки приложения Windows. Затем добавьте выходные файлы, необходимые для запуска приложения. Последним этапом будет сборка файлов установки, которые выполнят развертывание приложения Windows.

1.6.2.3.2.1 Создание проекта установки для приложений Windows Предпосылки Необходимо иметь готовое приложение Windows, использующее SAP Crystal Reports.

Контекст В этом примере приведены сведения, необходимые для создания проекта веб-установки для веб-сайтов на основе проектов развертывания, имеющихся в Visual Studio.

2. В меню Файл выберите команду Добавить, а затем Новый проект.

3. Перейдите к панели Типы проектов в диалоговом окне Добавить новый проект.

4. Разверните узел Другие типы проектов и выберите пункт Проекты установки и развертывания.

5. На панели Шаблоны нажмите кнопку Проект установки.

6. Выберите соответствующее имя проекта и укажите его расположение, после чего нажмите кнопку ОК.

В рамках настоящего пособия проект установки имеет присвоенное по умолчанию имя Setup1.

1.6.2.3.2.2 Добавление выходных файлов в проект установки Windows Контекст В этом примере описан процесс добавления в проект установки выходных файлов, используемых приложением Windows.

Процедура 1. В обозревателе решений щелкните правой кнопкой мыши элемент Setup1, выберите командуДобавить, а затем пункт Вывод проекта.

2. В диалоговом окне Добавление группы вывода проекта выберите Основной вывод. Оставьте имеющееся значение параметра Конфигурация ("Активная").

1.6.2.3.2.3 Построение проекта установки Windows Предпосылки На целевом компьютере должна быть установлена необходимая версия.NET Framework.

Контекст При сборке проекта установки создаются файлы программ установки для копирования их на другие компьютеры. Для развертывания приложения Windows можно запустить любую из этих программ установки на компьютере назначения.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. В окне Обозреватель решений щелкните правой кнопкой мыши элемент Setup1 и выберите пункт 2. Измените конфигурацию решения на Выпуск.

3. В меню Построение выберите пункт Построение Setup1.

Результаты В рамках процесса построения создаются следующие файлы установщика:

setup.exe setup1.msi 1.6.2.3.2.4 Развертывание проекта установки Windows Процедура 1. Вне Visual Studio перейдите к каталогу, в котором сохранен ваш проект развертывания.

2. Дважды щелкните папку Setup1.

3. Откройте папку Release, чтобы найти файлы, сборка которых была осуществлена на основе проекта настройки.

4. Скопируйте все файлы на компьютер назначения.

5. Распространите отчеты SAP Crystal Reports, используемые в приложении Windows.

Подробнее о том, какие сценарии привязки требуют распространения файлов отчета, см. в разделе Файлы отчета [стр. 629].

6. На компьютере назначения дважды щелкните файл Setup.exe или Setup1.msi, чтобы установить приложение Windows.

7. Чтобы просмотреть приложение Windows, перейдите в установленное расположение C:\Program Files\Business Objects\Setup1, а затем дважды щелкните файл EXE приложения Windows.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.6.2.3.3 Выполнение автоматической установки с помощью службы установки Windows Контекст Служба установки Windows позволяет выполнить автоматическую установку на клиентском компьютере.

Автоматическая установка выполняется из командной строки и не требует взаимодействия с пользователем.

Процедура 1. Запустите командную строку.

2. Укажите путь к файлу установщика Windows.

3. Запустите исполняемый файл msiexec.exe.

Замените параметр "C:\install.msi" путем к файлу установщика Windows.

msiexec.exe /i "C:\install.msi" /qn Выполняется установка приложения.

1.6.2.4 Развертывание объединенных модулей в Visual Studio Процедуры в следующих разделах создают проекты развертывания модулей объединения для веб-сайтов или приложений Windows, использующих версию SAP Crystal Reports для разработчиков Microsoft Visual Studio.

При использовании сценариев связывания отчетов для служб Crystal Services необходимо использовать другие процедуры развертывания, не описанные в этом учебном пособии.

Развертывание с помощью установщика Windows является предпочтительным способом развертывания проектов, использующих компоненты версии SAP Crystal Reports для разработчиков Microsoft Visual Studio.

Связанные сведения Развертывание с помощью установщика Windows для Visual Studio [стр. 641] Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.6.2.4.1 Создание нового проекта развертывания вебсайта с помощью модулей объединения Для развертывания веб-сайта следуйте инструкциям, приведенным в данном разделе пособия.

Для развертывания веб-сайта, использующего версию SAP Crystal Reports для разработчиков Microsoft Visual Studio, необходимо сначала создать проект веб-установки. Затем добавьте выходные файлы и модули объединения, необходимые для запуска приложения. Последним этапом будет сборка файлов установки, которые выполнят развертывание веб-сайта.

1.6.2.4.1.1 Создание проекта веб-установки для вебсайтов Предпосылки Для этого необходим веб-сайт, на котором используется SAP Crystal Reports.