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

Pages: |

| 2 | 3 | 4 | 5 | ... | 17 |

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

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

SAP Crystal Reports, версия для разработчиков Microsoft Visual

Studio

Версия документа: Support Package 10 - 2014-06-23

Руководство SAP Crystal Reports для

Visual Studio.NET SDK Developer

Guide

Содержание

1 Руководство SAP Crystal Reports.NET SDK Developer Guide............................ 4

1.1 Начало работы................................................................ .4 1.1.1 Что представляет собой версия SAP Crystal Reports для разработчиков Microsoft Visual Studio?.................................................................. 4 1.1.2 Миграция приложения SAP Crystal Reports.Net................................. 1.2 Настройка среды разработки..................................................... 1.2.1 Установка системы...................................................... 1.2.2 Настройка проекта...................................................... 1.3 Основные сведения о SDK....................................................... 1.3.1 Архитектура........................................................... 1.3.2 Элемент управления CrystalReportViewer..................................... 1.3.3 Особенности использования различных методов сохранения в SAP Crystal Reports........................................................................... 1.3.4 Масштабирование приложения............................................ 1.3.5 Использование SAP Crystal Reports в веб-ферме или веб-саду..................... 1.3.6 Работа с Crystal Reports как с веб-службой................................... 1.3.7 Вопросы безопасности.................................................. 1.4 Использование SDK........................................................... 1.4.1 Печать отчета......................................................... 1.4.2 Экспорт отчета........................................................ 1.4.3 Фильтрация данных параметрами или формулами............................. 1.4.4 Задание источника данных............................................... 1.4.5 Просмотр отчета...................................................... 1.4.6 Настройка элемента управления CrystalReportViewer........................... 1.4.7 Работа с отчетами SAP Crystal Reports только для чтения (RPTR).................. 1.5 Учебные пособия............................................................. 1.5.1 Учебные пособия по объектной модели CrystalReportViewer...................... 1.5.2 Учебные пособия по объектной модели ReportDocument........................ 1.5.3 Учебные пособия с сокращенным кодом в Visual Studio.......................... 1.5.4 Учебные пособия по подключению к данным................................. 1.5.5 Другие учебные пособия................................................ 1.6 Развертывание............................................................... 1.6.1 Компоненты развертывания.............................................. 1.6.2 Развертывание для Visual Studio........................................... 1.7 Создание отчетов............................................................ 1.7.1 Использование встроенного конструктора SAP Crystal Reports................... 1.7.2 Справочник формул................................................... 1.7.3 Справка по пользовательскому интерфейсу.................................. © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 2 Содержание защищены.

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

1 Руководство SAP Crystal Reports.NET SDK Developer Guide 1.1 Начало работы Эта интерактивная справка призвана помочь в разработке собственных веб-приложений или Windowsприложений с помощью SAP Crystal Reports.NET SDK. Она включает в себя учебные пособия и руководства по программированию, которые можно использовать для реализации SAP Crystal Reports.NET SDK.

1.1.1 Что представляет собой версия SAP Crystal Reports для разработчиков Microsoft Visual Studio?

С помощью версии SAP Crystal Reports для разработчиков Microsoft Visual Studio можно создавать сложные и профессиональные отчеты в программах, использующих графический интерфейс пользователя. В качестве источника данных для отчета можно использовать практически любую базу данных или данные из промежуточного источника, такого как набор результатов (например, набор данных ADO.NET). С помощью мастеров, которые есть в конструкторе GUI, можно задать форматирование, группировку, вывод диаграмм и другие критерии.

Отчет можно подключить к веб-приложению или приложению Windows с помощью одного из элементов управления средств просмотра SAP Crystal Reports для Visual Studio. Интерактивные представления отчетов, сформированные в приложениях Windows и в веб-клиентах, использующих спецификацию HTML 4.0, предоставляют такие возможности, как детализация диаграммы, перемещение по отчету и текстовый поиск.

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

CrystalReportViewer является самой простой объектной моделью.

ReportDocument представляет собой более расширенную объектную модель.

ReportClientDocument представляет собой наиболее полную объектную модель. Эта объектная модель доступна с помощью сервера RAS.

Объектная модель InfoObject реализует эффективные механизмы планирования и настройки отчетов в средах SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

Объектные модели CrystalReportViewer и ReportDocument доступны во всех версиях SAP Crystal Reports для разработчиков Microsoft Visual Studio. Для использования объектных моделей ReportClientDocument и InfoObject необходимо получить дополнительную лицензию. См. раздел Решения по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 66].

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

Возможность доступа к отчетам из каталога файлов.

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

Подключение к отчетам с помощью служб Crystal.

Выполнив обновление до уровня SAP Crystal Reports Server, можно обращаться к отчетам через сервер Выполнив обновление до уровня платформы SAP BusinessObjects Business Intelligence, можно обращаться к отчетам с помощью сервера страниц или сервера RAS, входящего в среду платформы SAP BusinessObjects Business Intelligence.

1.1.1.1 Функции, доступные в конструкторе SAP Crystal Reports Конструктор SAP Crystal Reports поддерживает ряд функций, недоступных в версии SAP Crystal Reports для разработчиков Microsoft Visual Studio:

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

1.1.2 Миграция приложения SAP Crystal Reports.Net В этом разделе предоставлены сведения о переносе приложения SAP Crystal Reports.Net в версию SAP Crystal Reports для разработчиков Microsoft Visual Studio.

Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio включает полный набор функций и доступна как бесплатно загружаемое приложение, которое интегрируется с Visual Studio 2010 или более поздней версии. Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio не поставляется с приложением "Конструктор SAP Crystal Reports".

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

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

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

Если файл проекта (любой файл ASPX, имеющий любые компоненты SAP Crystal Reports или файл web.config) заблокирован, обновление или исправление невозможно.

Связанные сведения Решения по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 66] Отчет на основе источника данных ADO.NET не будет работать, если проект предназначен для платформы.NET 4.x Framework Отчеты на основе источника данных ADO.NET не будут работать, если проект предназначен для платформы.NET 4.x Framework Возникает следующая ошибка: "Дополнительная информация: сборка смешанного режима скомпилирована для версии среды выполнения v2.0.50727 и не может быть загружена в исполняемый модуль 4.x без дополнительных сведений о конфигурации".

Чтобы устранить эту неполадку, обновите файл.config проекта. Добавьте следующие строки кода в раздел файла:

1.1.2.2 Ограничения для 64-разрядной версии В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio поддерживается 64-разрядная x (AMD64) архитектура. Однако архитектура IA64 (Itanium) в настоящее время не поддерживается.

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

Экспорт отчетов в формат HTML.

Компоненты географических карт.

Компоненты шрифта штрих-кодов Azalea.

1.2 Настройка среды разработки В данном разделе приводятся подробные инструкции по установке и настройке среды разработки, а также описание процесса создания проекта веб-сайта или приложения для Windows в версии SAP Crystal Reports для разработчиков Microsoft Visual Studio.

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

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

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

Выпуски Visual Studio Ultimate, Premium, и Professional поддерживаются для Visual Studio 2010 и более новых версий. Выпуски Visual Studio Express не поддерживаются SAP Crystal Reports.

Связанные сведения Решения по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 66] © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Существует несколько версий SAP Crystal Reports. Большая часть процедур, описанных в данном документе, относится к определенным версиям приложения. Чтобы извлечь максимальную пользу из данного документа, определите версию компонента SAP Crystal Reports, установленную на компьютере.

1.2.1.1.2.1 Определение используемой версии компонента SAP Crystal Reports Процедура 1. Перейдите в папку GAC (кэш глобальных сборок), расположенную в каталоге C:\WINNT\Assembly или C:\Windows\Assembly.

2. Найдите файл CrystalDecisions.CrystalReports.Engine.

Если на компьютере установлено несколько версий SAP Crystal Reports, в кэше глобальных сборок будет содержаться несколько таких файлов. Будет выделен файл CrystalDecisions.CrystalReports.Engine, поскольку этот файл включен в каждую версию SAP Crystal 3. Обратите внимание на отображаемый в окне столбец Версия.

В нем указана версия сборки.

4. Найдите максимальный номер для требуемой сборки.

5. Сравните версию сборки с номером версии на диаграмме версий SAP Crystal Reports.

SAP Crystal Reports, версия для разработчиков Microsoft 13.0.2000. Visual Studio (.NET 4.0 Framework) Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide В SAP Crystal Reports 2008 и SAP Crystal Reports 2008 SP1 используется одинаковый номер версии сборки.

Чтобы проверить, что установлено приложение SAP Crystal Reports 2008 SP1, убедитесь в том, что версия файла начинается с 12.1, а не с 12.0.

1.2.1.1.3 Установка службы обновления SAP Crystal Reports Контекст Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio предоставляет дополнительную службу обновления SAP Crystal Reports, которая проверяет наличие обновлений, исправлений и дополнений для SAP Crystal Reports.

Служба обновления версии SAP Crystal Reports для разработчиков Microsoft Visual Studio не входит в состав пакета установки. Ее необходимо загрузить и установить отдельно.

Процедура 1. После установки версии SAP Crystal Reports для разработчиков Microsoft Visual Studio запустите приложение Visual Studio и создайте веб-сайт или проект Windows.

2. В окне Solution Explorer щелкните правой кнопкой мыши выделенное полужирным шрифтом название 3. В диалоговом окне Добавление нового элемента выберите Crystal Report.

4. В поле Имя введите Test.rpt и нажмите кнопку Добавить.

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

В окне встроенного конструктора SAP Crystal Reports будет отображен новый отчет.

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

Если служба обновления SAP Crystal Reports не установлена, будет предложено ее установить.

Откроется веб-сайт службы обновления SAP Crystal Reports со ссылкой для загрузки этой службы.

7. Загрузите и установите службу обновления SAP Crystal Reports.

8. Повторно запустите программу Visual Studio.

9. Откройте Test.rpt.

Запустится встроенный конструктор SAP Crystal Reports, в котором будет отображен этот отчет.

10. В меню Crystal Reports выберите пункт Проверка наличия обновлений.

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

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

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

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

Связанные сведения Поддерживаемые версии среды Visual Studio [стр. 10] Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.2.1.2.1 Проверка установки компонента SAP Crystal Reports Контекст Чтобы убедиться, что компонент SAP Crystal Reports для Visual Studio установлен, проверьте наличие пункта SAP Crystal Reports в диалоговом окне добавления нового элемента в Visual Studio.

Процедура 1. Запустите Visual Studio.

2. Создайте новый веб-проект или проект Windows (с любым языком программирования) либо откройте существующий веб-проект или проект Windows.

3. В меню Проект выберите пункт Добавить новый элемент.

Файлы нового отчета нужно добавить непосредственно в новый проект. Невозможно создать новый отчет Crystal в Visual Studio с помощью меню Файл.

4. Убедитесь, что в диалоговом окне Добавление нового элемента присутствует пункт Crystal Reports.

1.2.1.2.2 Каталог средств просмотра Для доступа к средствам просмотра SAP Crystal Reports использует виртуальный каталог. Виртуальный каталог и все базовые пути к файлам являются уникальными для каждой версии SAP Crystal Reports.

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

1.2.1.2.2.1 Расположение по умолчанию каталога средств просмотра Если компонент SAP Crystal Reports был установлен с настройками и каталогами по умолчанию, виртуальный каталог средств просмотра должен быть настроен следующим образом.

SAP Crystal Reports, 4.x Framework Путь к файлу при использовании сервера разработки © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide SAP Crystal Reports, Платформа 2,0 Путь к файлу при использовании сервера разработки ботчиков Microsoft Visual Studio 1.2.1.2.2.2 Поиск местоположения каталога средств просмотра Процедура 1. В панели управления дважды щелкните элемент Администрирование, после чего дважды щелкните элемент Службы IIS.

2. В диалоговом окне Службы IIS разверните узел Веб-сайты и затем узел Веб-сайт по умолчанию.

3. Найдите все папки, содержащие папку crystalreportsviewers13.

4. Щелкните правой кнопкой мыши каждую из папок crystalreportsviewers13 и выберите пункт Свойства.

5. В диалоговом окне Свойства убедитесь, что значение Локальный путь соответствует конфигурации установленной версии SAP Crystal Reports или Visual Studio.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.2.2 Настройка проекта Данный раздел является ключевым как для опытных, так и для средних разработчиков. Демонстрирует рекомендации, которым нужно следовать при создании и настройке нового проекта Windows или вебпроекта либо веб-сайта с помощью версии SAP Crystal Reports для разработчика Microsoft Visual Studio.

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

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

1.2.2.1.1 Создание нового веб-сайта в Visual Studio Процедура 1. Запустите Visual Studio.

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

3. В диалоговом окне Создание веб-сайта выберите пункт Веб-сайт ASP.NET.

4. В раскрывающемся списке Расположение выберите пункт Файловая система.

5. В раскрывающемся списке Язык выберите требуемый язык кодировки.

6. В текстовом поле Расположение введите путь к каталогу C:\WebSites\, а в конце – имя проекта.

C:\WebSites\MyProjectName 7. Нажмите кнопку ОК.

1.2.2.1.2 Подготовка веб-формы Контекст В этом разделе речь пойдет о настройке класса code-behind для веб-формы.

Примечание Понятия "веб-форма", "страница ASPX" и "Default.aspx" в данном случае равнозначны.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. В Проводнике решений дважды щелкните элемент Default.aspx для открытия веб-формы.

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

Откроется класс code-behind. Этот класс имеет имя _Default. Файл класса называется Default.aspx.cs или Default.aspx.vb.

Если страница Default.aspx создана с использованием внутритекстового кода, ее код не помещается в отдельный файл. В таком случае удалите страницу ASPX и создайте ее наново. При создании страницы ASPX установите флажок "Сохранить код в отдельном файле".

3. Если данный класс пишется на Visual Basic, введите вверху класса "Option Strict On".

Как оптимальный вариант рекомендуется включать Option Strict On в начале каждого класса Visual Basic на веб-сайте. Во время написания кода будут использоваться лучшие практики объявления переменных со строгим соответствием типов и допустимое приведение типов, что проверяется во время компиляции. Принудительные проверки во время компиляции могут сократить число исключений во время выполнения.

1.2.2.1.2.2 Добавление выражений Imports/Using для ссылок на пространства имен Процедура 1. Откройте страницу Default.aspx.

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

Отобразится класс code-behind для веб-формы.

3. Над подписью класса добавьте объявление "Imports" [Visual Basic] или "using" [C#] вверху класса, содержащее следующие пространства имен SAP Crystal Reports.

Imports CrystalDecisions.CrystalReports.Engine Imports CrystalDecisions.Shared using CrystalDecisions.CrystalReports.Engine;

using CrystalDecisions.Shared;

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.2.2.1.2.3 Добавление вспомогательного private-метода в код конфигурации SAP Crystal Reports Процедура Внутри класса добавьте новый вспомогательный private-метод без возвращаемого значения с именем ConfigureCrystalReports().

Private Sub ConfigureCrystalReports() private void ConfigureCrystalReports() Метод ConfigureCrystalReports() дает пользователям возможность работать с отчетом во время выполнения. Он также контролирует программное взаимодействие с отчетом.

Следующие шаги Затем добавляется обработчик события Page_Init, из которого вызывается метод ConfigureCrystalReports(). Вызов метода ConfigureCrystalReports() из обработчика события гарантирует, что код конфигурации отчета Crystal будет запущен во время инициализации страницы.

1.2.2.1.2.4 Добавление обработчика события Page_Unit в класс code-behind Контекст Как правило, обработчик события Page_Load используется для ввода кода конфигурации в приложении ASP.NET, чтобы код вызывался во время события Page.Load. Однако код конфигурации отчета Crystal необходимо вызвать раньше, во время события Page.Init.

Процедура 1. Добавьте событие Page_Init в код.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Если кодирование осуществляется на Visual Basic, выберите пункт "События страницы" из левого верхнего раскрывающегося списка и событие Init из правого верхнего раскрывающегося списка.

Обработчик события Page_Init будет добавлен в класс code-behind.

Private Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Если кодирование осуществляется на C#, зайдите в обработчик события Page_Init с помощью синтаксиса, приведенного ниже.

private void Page_Init(object sender, EventArgs e) В веб-форме C# в среде Visual Studio версии 2005 и выше любой обработчик событий Page_Init, Page_Load или Page_PreRender в классе code-behind автоматически привязывается к событиям Init, Load или PreRender. Для вызова требуется точное соответствие подписи обработчика события.

Эта функция срабатывает, когда для параметра AutoEventWireup в директиве Page, расположенной в верхней части страницы ASPX в представлении HTML, установлено значение В предыдущих версиях Visual Studio.NET для директивы Page AutoEventWireup всегда было установлено значение False, однако в веб-формах C# в среде Visual Studio версии 2005 и выше для директивы Page AutoEventWireup по умолчанию установлено значение True.

2. в рамках обработчика события Page_Init для Visual Basic или C# введите вызов вспомогательного метода ConfigureCrystalReports().

ConfigureCrystalReports() ConfigureCrystalReports();

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

1.2.2.1.3 Добавление элемента управления CrystalReportViewer к веб-сайту Процедура 1. Откройте страницу Default.aspx.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 2. Нажмите кнопку Проект внизу формы.

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

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

4. Перетащите элемент управления CrystalReportViewer на веб-форму.

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

Результаты При добавлении в приложение элемента управления CrystalReportViewer cсылки на сборки SAP Crystal Reports будут автоматически добавлены в проект.

1.2.2.1.4 Настройка файла Web.Config В файле Web.Config веб-приложения ASP.NET хранятся такие глобальные настройки, как параметры подключения к базе данных, ссылки на сборки и параметры обработки ошибок. Файл имеет формат XML, корневой элемент которого всегда. Данная конфигурация представляет собой расширенную конфигурацию, которая не является обязательной.

Следующие элементы относятся исключительно к SAP Crystal Reports и могут быть добавлены в файл Web.Config.

Версии могут иметь другие номера в зависимости от используемого программного продукта.

В.NET 2.0 для тега section в файле Web.Config должен использоваться следующий синтаксис:

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

CrystalImageCleaner-Sleep устанавливает период времени в миллисекундах для спящего состояния программы очистки перед сканированием и очисткой файлов в каталоге динамических изображений.

CrystalImageCleaner-Age устанавливает минимальный возраст файла (мс) перед его удалением.

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

В рамках одного процесса обработчика ASP.NET может быть запущен только один процесс программы очистки изображений.

CrystalImageHandler Элемент CrystalImageHandler служит для отображения всех динамических изображений в элементе управления CrystalReportViewer. Данный параметр указывает процессу обработчика ASP.NET перенаправлять к внутреннему классу обработчика изображений запросы к CrystalImageHandler.aspx.

Если в файле Web.Config отсутствует параметр CrystalImageHandler, изображения на веб-сайте отображаться не будут. Данный элемент автоматически добавляется в файл Web.Config при добавлении к веб-сайту элемента управления CrystalReportViewer.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide documentView Элемент documentView управляет способом отображения отчета на основе. Доступны два параметра.

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

При задании значения weblayout отчет заполняет основу.

EnableTextClipping Элемент EnableTextClipping определяет, включена ли обрезка текста в поле. Если этому элементу присвоено значение true, текст, содержащийся в поле, не будет перекрывать текст вне него.

globalResourcePath Элемент globalResourcePath представляет собой ссылку на путь к каталогу файлов глобальных ресурсов. В указанном каталоге файлов находятся языковые ресурсы пользователя в виде © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide централизованного расположения, которые могут совместно использоваться несколькими вебприложениями. Указанный параметр позволяет получить доступ к глобальным ресурсам определенного веб-сайта. Стандартные файлы ресурсов отсутствуют в установке продукта SAP CrystalReports.NET, однако их можно загрузить с веб-сайта технической поддержки компании SAP BusinessObjects по ссылке:

http://help.sap.com. Данный элемент необходимо вручную добавить в файл Web.Config веб-сайта.

maxNumberListOfValues Элемент maxNumberListOfValues управляет количеством элементов LOV, которые будут посланы клиенту. Это влияет на количество значений, отображаемых на панели параметров. Если задано это значение, в списке значений отображаются только n первых значений. Можно будет постранично просматривать наборы значений в диалоговом окне "Дополнительно" на основании размера списка и значения элемента maxNumberListOfValues. Например, если есть 180 значений, и для элемента maxNumberListOfValues установлено значение 50, можно будет просмотреть первые 50 значений, указанных на панели параметров. Можно будет постранично просмотреть все 180 значений в диалоговом окне "Дополнительно", в котором будут отображены три группы из 50 значений и одна группа из значений.

Рекомендуется, чтобы это значение всегда было больше 0. Значение по умолчанию 200.

printControl Элемент printControl позволяет выполнять печать отчета непосредственно на локальном принтере.

Каталог установки по умолчанию: C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for.NET Framework 4.0\Common\Crystal Reports 2011\crystalreportviewers.

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

processingIndicatorDelay Элемент processingIndicatorDelay управляет временем задержки перед появлением индикатора обработки отчетов. Значение указывается в миллисекундах. Если задать значение 0, индикатор обработки отчетов будет отключен. Значение по умолчанию – 200 мс.

processingIndicatorText Элемент processingIndicatorText управляет текстом, отображаемым в индикаторе обработки отчетов.

Текст по умолчанию: "Дождитесь завершения обработки документа".

reportMappings Элемент reportMappings служит для преобразования веб-сайтов, созданных с помощью Visual Studio 2003, в которых применяются встроенные отчеты, в веб-сайты без встроенных отчетов в случае открытия их в среде Visual Studio 2005 или более поздней версии. Данный параметр служит для преобразования файла библиотеки DLL, созданной в среде Visual Studio 2003, в файл на диске. Visual Studio 2005 и не поддерживают встроенные веб-сайты, поэтому необходимо изменить файл Web.Config, чтобы существующие отчеты могли использоваться в указанных версиях Visual Studio. Данный элемент необходимо вручную добавить в файл Web.Config веб-сайта. Для параметра reportMappings необходимо указать абсолютный путь.

Данный элемент используется только при наличии Visual Studio 2005 или Visual Studio 2008.

resourceURI Элемент resourceURI задает расположение каталога crystalreportviewers в веб-приложении.

Каталог crystalreportviewers содержит все файлы, необходимые для средства просмотра.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide serverFileReportManager Элемент serverFileReportManager представляет собой веб-службу, которая используется для перечисления файлов сервера на компьютере сервера. Данный параметр позволяет получить список объектов (каталогов и отчетов) с удаленного компьютера. С помощью указанного параметра устанавливается корневой каталог файлов на сервере. В данном примере корневому каталогу задано значение c:\inetpub\wwroot. Данный элемент необходимо вручную добавить в файл Web.Config вебсайта.

Примечание Это соответствует классу serverFileReportManager.

UseAsynchronousRequests По умолчанию в средстве просмотра DHTML разрешены асинхронные запросы. Если нужно, чтобы кнопка Назад в пользовательском браузере работала со средством просмотра DHTML, необходимо отключить асинхронные запросы, установив этот параметр в false.

Примечание Рекомендуется не устанавливать для элемента UseAsynchronousRequests значение false. Это связано с тем, что при этом будет отключено диалоговое окно "Дополнительно" на панели параметров.

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

crystal_use_asynchronous_requests UseBrowserLocale Элемент UseBrowserLocale используется для получения языковых настроек из используемого браузера для элемента управления CrystalReportViewer. Если значение параметра истинно, элемент управления CrystalReportViewer будет использовать языковые настройки браузера. В противном случае используются языковые настройки, заданные в страницах. Данный элемент необходимо вручную добавить в файл Web.Config веб-сайта.

Пример файла Web.Config Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Связанные сведения Печать Веб Настройка локализации на основе браузера Веб Настройка глобальных или локальных пользовательских ресурсов Порядок действий: добавление или удаление ссылок в Visual Studio Версии SAP Crystal Reports 1.2.2.2 Настройка проекта Windows в Visual Studio Данный раздел является ключевым как для опытных, так и для средних разработчиков. В нем представлены основные правила создания и настройки нового проекта Windows с использованием отчетов версии SAP Crystal Reports для разработчика Microsoft Visual Studio.

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

1.2.2.2.1 Создание нового проекта Windows в Visual Studio Процедура 1. Запустите Visual Studio.

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

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

4. Из списка Шаблоны выберите пункт Приложение Windows Forms.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 5. В поле Имя замените имя проекта по умолчанию на имя вашего проекта.

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

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

1.2.2.2.2 Применение стандартных настроек проекта Visual Basic (необязательно) Контекст Для настройки проекта Visual Basic на работу с учебными пособиями необходимо внести в него некоторые изменения.

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

2. В окне Свойства выберите вкладку Компиляция.

3. В списке OptionStrict выберите пункт private-.

4. Закройте окно Свойства.

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

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

Принудительные проверки во время компиляции могут сократить число исключений во время 1.2.2.2.3 Подготовка Windows-формы в Visual Studio Контекст Традиционные приложения Windows в среде Visual Basic 6, как правило, определяют первую форму с именем Form1. Придерживаясь этой модели в проекте Windows, можно использовать одно и то же имя формы, Form1, с расширением.cs или.vb в зависимости от используемого языка.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. Если форма Form1 еще не отображается в главном окне, дважды щелкните элемент Form1 в Проводнике решений.

Форма Form1 откроется в конструкторе.

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

Отображается представление кода класса Form1. Отображение класса зависит от того, на чем закодировано приложение Windows – на Visual Basic или C#.

В C# класс Form1 отображает следующее:

Конструктор (Form1).

В Visual Basic класс Form1 отображает следующее:

Подпись класса (класс Form1).

Дополнительные методы и переменные класса Form1 содержатся в отдельном "частичном" классе. (Это справедливо как для C#, так и для Visual Basic.) Частичные классы рассматриваются далее в разделе "Настройка проекта Windows".

1.2.2.2.3.2 Добавление вспомогательного private-метода в код конфигурации SAP Crystal Reports Процедура 1. Добавьте к классу Form1 новый вспомогательный private-метод без возвращаемого значения с именем ConfigureCrystalReports().

Private Sub ConfigureCrystalReports() private void ConfigureCrystalReports() Затем нужно добавить обработчик события Form_Load и поместить вызов ConfigureCrystalReports() внутри обработчика события Form_Load. Это обеспечит автоматический запуск метода ConfigureCrystalReports() при загрузке формы.

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

3. Дважды щелкните Form1.

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

4. Внутри обработчика событий Form1_Load введите вызов метода ConfigureCrystalReports().

ConfigureCrystalReports() ConfigureCrystalReports();

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

1.2.2.2.4 Добавление элемента управления CrystalReportViewer 1.2.2.2.4.1 Добавление элемента управления CrystalReportViewer в приложение Windows Процедура 1. Откройте форму Windows в представлении проекта.

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

В предыдущих версиях SAP Crystal Reports для Visual Studio элемент управления CrystalReportViewer отображался в узле Crystal Reports.

3. Перетащите элемент управления CrystalReportViewer на форму.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.2.2.2.4.2 Добавление выражений Imports/Using для ссылок на пространства имен Процедура 1. Если папка References не отображается в Проводнике решений, на панели инструментов проводника решений нажмите кнопку "Показать все файлы" для отображения всех файлов проекта.

2. В Проводнике решений разверните папку References.

3. Убедитесь, что добавлены следующие сборки SAP Crystal Reports:

CrystalDecisions.CrystalReports.Engine CrystalDecisions.Shared 4. Выберите Form1, затем в меню Вид выберите пункт Код.

5. Над подписью класса добавьте объявление "Imports" [Visual Basic] или "using" [C#] вверху класса, содержащее следующие пространства имен SAP Crystal Reports.

Imports CrystalDecisions.CrystalReports.Engine Imports CrystalDecisions.Shared using CrystalDecisions.CrystalReports.Engine;

using CrystalDecisions.Shared;

1.3 Основные сведения о SDK 1.3.1.1 Выбор правильной объектной модели для проекта Чтобы правильно выбрать объектную модель для проекта, необходимо иметь представление о принципах работы элемента управления CrystalReportViewer и знать, как элемент управления CrystalReportViewer взаимодействует с другими объектными моделями.

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

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

Этот принцип лежит в основе элемента управления ASP.NET. Данные представления инкапсулируются в элементе управления, а затем этот элемент управления связывается с базовым объектом или объектной моделью, реализующей бизнес-логику.

Подобную архитектуру имеет элемент управления.NET CrystalReportViewer. Он работает как объект отображения в веб-форме или форме Windows (слой представления), и его можно связать с любой из указанных ниже объектных моделей.

Объектная модель ReportDocument Объектная модель ReportClientDocument (Report Application Server) Объектная модель InfoObject (SAP Crystal Reports Server или платформа SAP BusinessObjects Business Intelligence) В стандартном сценарии элемент управления CrystalReportViewer связывается с одной из объектных моделей, реализующих бизнес-логику, как правило, связанную с управлением отчетами.

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

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

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

Однако в большинстве сценариев связывания отчетов использование элемента управления CrystalReportViewer в качестве объектной модели не приветствуется. Вместо этого используется объектная модель ReportDocument по следующим причинам:

При использовании объектной модели CrystalReportViewer повышается вероятность конфликта объектных моделей. Не используйте объектную модель CrystalReportViewer с другими объектными моделями.

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

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Объектная модель ReportDocument ReportDocument – более мощная объектная модель по сравнению с CrystalReportViewer. Она поставляется в составе SAP Crystal Reports.NET SDK и обеспечивает расширенные возможности управления отчетами в коде.

Какую объектную модель использовать?

Если обновление до уровня SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence не планируется, при решении задач разработки с помощью SAP Crystal Reports SDK рекомендуется использовать объектную модель ReportDocument.

Примечание В SAP Crystal Reports 10 или более поздних версий, а также SAP Crystal Reports для Visual Studio 2005 и более поздних версий в целях упрощения обновления объектная модель ReportDocument была связана с объектной моделью ReportClientDocument.

1.3.1.2 Отказ от одновременного использования разных объектных моделей Не используйте объектную модель CrystalReportViewer с другими объектными моделями.

Элемент управления CrystalReportViewer корректно работает в качестве объектной модели только при том условии, что он непосредственно связывается с отчетом с помощью простой строки пути.

Однако если отчет инкапсулируется в одной из других объектных моделей (например, ReportDocument или ReportClientDocument), а затем элемент управления связывается с этой объектной моделью, использование объектной модели CrystalReportViewer не допускается. В таком случае ограниченная объектная модель, предоставляемая элементом управления CrystalReportViewer, дублировала бы более мощную объектную модель, с которой связан элемент управления. Кроме того, настройки, примененные к объектной модели CrystalReportViewer, не являются видимыми для других объектных моделей, что может привести к нежелательному поведению и возникновению исключений.

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

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

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

Роль встроенного конструктора SAP Crystal Reports в архитектуре Встроенный SAP Crystal Reports Designer включен в описание архитектуры, поскольку он выполняет решающую роль в SAP Crystal Reports для Visual Studio: он создает файлы отчетов для отображения.

Однако он необходим лишь во время конструирования отчетов. Задачи по отображению отчетов и взаимодействию с ними во время выполнения возложены на SAP Crystal Reports SDK. Следовательно, несмотря на то, что встроенный конструктор создает отчеты, используемые в архитектуре, сам он не является частью архитектуры.

Связанные сведения Использование встроенного конструктора SAP Crystal Reports [стр. 655] 1.3.1.4 Элементы управления средством просмотра отчетов В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio реализованы стандартные элементы управления формы для просмотра отчетов. Каждый из элементов управления несет комплексную информацию о макете отчета, которая заключена в объект графического интерфейса пользователя, размещенный на панели элементов.

Существует два элемента управления:

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Связанные сведения Использование элементов управления средства просмотра отчетов [стр. 44] В состав версии SAP Crystal Reports для разработчиков Microsoft Visual Studio входит пакет SDK, содержащий две объектные модели. Используя дополнительную лицензию, можно расширить SDK до четырех объектных моделей.

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

Каждая из объектных моделей предоставляет более высокий уровень мощности и сложности.

Простейшая объектная модель – это CrystalReportViewer.

Элемент управления CrystalReportViewer в Web Form или Windows Form по определению имеет базовый класс с таким же именем. Этот класс CrystalReportViewer предоставляет свойства и методы для изменения функциональных возможностей отображения элемента управления, а также для взаимодействия с классами, управляющими входами в базу данных, параметрами и формулами выбора. Этот набор классов является простейшей объектной моделью. Класс CrystalReportViewer существует в двух различных формах: одна в пространстве имен Windows, а другая в пространстве имен Интернета. Поэтому множество элементов такой объектной модели дублируются в обоих пространствах имен с некоторыми отличиями, чтобы поддерживать различия между платформами Windows и веб-платформами.

Классы этой модели содержатся в пространстве имен CrystalDecisions.Web для версии Web Form этого элемента управления или в пространстве имен CrystalDecisions.Windows.Forms для версии Windows Form этого элемента управления.

Более расширенная объектная модель –ReportDocument.

Класс ReportDocument является шлюзом к набору классов в пространстве имен Engine, включая Database, DataDefinition, ExportOptions, PrintOptions, ReportDefinition, ReportOptions и SummaryInfo. Это расширенный набор классов, предоставляющий мощные возможности настройки и взаимодействия с отчетом.

Классы этой объектной модели содержатся в пространстве имен CrystalDecisions.CrystalReports.Engine.

Далее перечислены объектные модели, которые можно получить путем обновления.

Объектная модель с большими возможностями изменения отчетов, называемая ReportClientDocument.

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

Классы этой объектной модели содержатся в группе пространств имен CrystalDecisions.ReportAppServer.

Объектная модель ReportClientDocument предоставляется вместе с сервером RAS, который требует дополнительного лицензирования. Сервер RAS входит в состав SAP Crystal Reports Server и платформы SAP BusinessObjects Business Intelligence.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Расширенная объектная модель InfoObject обеспечивает взаимодействие с функциями уровня платформы в SAP Crystal Reports Server и на платформе SAP BusinessObjects Business Intelligence.

Она предоставляется по лицензии SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

Этот класс выступает в роли шлюза для всей объектной модели SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

Классы этой объектной модели содержатся в группе пространств имен CrystalDecisions.Enterprise.

Объектная модель InfoObject предоставляется только с SAP Crystal Reports Server и платформой SAP BusinessObjects Business Intelligence и требует дополнительного лицензирования.

Связанные сведения Выбор правильной объектной модели для проекта [стр. 32] Сравнение решений по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 67] 1.3.1.5.1 Объектная модель CrystalReportViewer Класс CrystalReportViewer имеет две роли.

В форме Web Form или Windows Form класс CrystalReportViewer представлен в виде элемента управления.NET, который можно добавить в форму для отображения отчета. Сведения о роли этого класса, выполняемой в качестве элемента управления.NET, см. в разделе Элементы управления средством просмотра отчетов [стр. 35].

В базовом классе "code-behind" формы Web Form или Windows Form класс CrystalReportViewer предоставляет простейшую объектную модель SDK. Эта объектная модель будет рассмотрена ниже.

Простейший способ поместить отчет в форму Web Form или Windows Form — добавить в эту форму элемент управления CrystalReportViewer, а затем в классе "code-behind" назначить путь отчета в качестве строки для свойства ReportSource класса CrystalReportViewer.

Назначая путь отчета непосредственно элементу управления (вместо того, чтобы поместить отчет в более сложную объектную модель, например ReportDocument или ReportClientDocument), вы ограничиваете интерфейс до простейшей объектной модели CrystalReportViewer.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Версия объектной модели CrystalReportViewer для Windows содержит основные классы и события, которые являются одинаковыми для Windows-версии и веб-версии этой объектной модели.

Веб-версия объектной модели CrystalReportViewer содержит такие же классы и события, как и версия Windows, но помимо них она также содержит указанные далее события, связанные со способом загрузки страницы ASPX.

Связанные сведения Элементы управления средством просмотра отчетов [стр. 35] Связывание отчетов с объектной моделью CrystalReportViewer [стр. 174] 1.3.1.5.2 Объектная модель ReportDocument Класс ReportDocument предоставляет более расширенную объектную модель для SDK, чем объектная модель CrystalReportViewer.

Класс ReportDocument является частью пространства имен CrystalDecisions.CrystalReports.Engine. Он функционирует как шлюз к набору классов в пространстве имен Engine, которое имеет большее количество инструментов для программного управления отчетом.

Объектная модель ReportDocument В предыдущем разделе описывалось, как работать с базовой объектной моделью CrystalReportViewer, назначая строку пути отчета непосредственно элементу управления CrystalReportViewer.

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

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

Если же попытаться воспользоваться свойствами и методами CrystalReportViewer для управления отчетом, эти две объектные модели начнут конфликтовать, и их поведение будет непредсказуемым.

Сразу же после ввода дополнительной объектной модели ограничьте использование кода CrystalReportViewer только до набора свойств отображения.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Объектные модели ReportDocument и ReportClientDocument (RAS) В SAP Crystal Reports 9 эти две объектные модели были полностью разделены. В SAP Crystal Reports 10 и более поздних версиях существенное разделение между двумя объектными моделями было исключено.

Теперь объектная модель ReportDocument выполняет роль прокси-сервера для передачи функциональности (или набора функциональных возможностей) от объектной модели ReportClientDocument.

В SAP Crystal Reports 2008 доступ к ограниченной версии объектной модели ReportClientDocument предоставляется с помощью свойства ReportDocument.ReportClientDocument.

Связанные сведения Учебные пособия по объектной модели ReportDocument [стр. 343] В этом разделе представлены разные учебные пособия по объектной модели ReportDocument.

Связывание отчетов с объектной моделью ReportDocument [стр. 203] Объектная модель CrystalReportViewer [стр. 37] Выбор правильной объектной модели для проекта [стр. 32] 1.3.1.5.3 Объектная модель ReportClientDocument (RAS) Объектная модель ReportClientDocument представляет собой наиболее мощную и обширную модель для работы с отчетами. Эта объектная модель доступна только в составе сервера RAS, который в свою очередь доступен в виде неуправляемого сервера (RAS) или управляемого сервера (BOE).

Объектная модель ReportClientDocument состоит из множества классов в нескольких пространствах имен. Каждое пространство имен имеет префикс CrystalDecisions.ReportAppServer. Эта объектная модель отображает всю структуру отчета в SDK, что позволяет программным способом создавать, изменять и сохранять изменения в любой части отчета во время выполнения.

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

ReportDefinition соответствует макету отчета, как показано в конструкторе SAP Crystal Reports.

DataDefinition соответствует проводнику Field Explorer в конструкторе SAP Crystal Reports.

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

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

существующий RPT-файл, который был загружен из какой-либо папки, а затем изменен вместе с классами определения отчета и определения данных ReportClientDocument в SDK; либо совершенно новый, пустой отчет, созданный вместе с классами определения отчета и определения данных ReportClientDocument в SDK.

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

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

Дополнительную информацию об объектной модели ReportClientDocument см. в документации SAP BusinessObjects RAS.NET SDK.

ReportClientDocument в SAP Crystal Reports Программа SAP Crystal Reports 9 (расширенная версия) поставлялась вместе со сборками неуправляемого сервера RAS и RAS.NET, необходимыми для программирования с помощью объектной модели ReportClientDocument. Это позволяло разработчикам создавать проекты.NET, в которых использовались преимущества объектной модели ReportClientDocument.

Однако это также означало, что для проектов, созданных ранее с помощью объектной модели ReportDocument из состава SAP Crystal Report, требовалось полное перекодирование для объектной модели ReportClientDocument, предоставляемой в составе сервера RAS. Причина заключалась в том, что эти две объектные модели были полностью разделены.

ReportClientDocument в SAP Crystal Reports 10 и более поздних версиях В SAP Crystal Reports 10 фундаментальное разделение между объектными моделями было исключено. Это было сделано путем перезаписи роли объектной модели ReportDocument в прокси-сервер для передачи функциональности (или набора функциональных возможностей) от объектной модели ReportClientDocument. Классы объектной модели ReportDocument предоставляют такие же подписи свойств и методов, как и раньше, но основная функциональность была изменена таким образом, чтобы перенаправлять все свойства и методы к свойствам и методам более мощной объектной модели ReportClientDocument.

Это не означает, что базовая версия SAP Crystal Reports Developer получает полный доступ к неуправляемому серверу RAS или же объектной модели ReportClientDocument. Базовая версия SAP Crystal Reports все также имеет доступ только к объектной модели ReportDocument (даже несмотря на то, что объектная модель ReportDocument служит прокси-сервером для передачи набора функциональных возможностей объектной модели ReportClientDocument). Исходный модуль для создания отчетов, содержащийся в предыдущих версиях SAP Crystal Reports, был заменен встроенной версией модуля отчетов RAS с ограниченным набором возможностей.

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

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.3.1.5.4 Объектная модель InfoObject (BOE) Объектная модель InfoObject предоставляется в составе обновлений продуктов SAP Crystal Reports Server и платформы SAP BusinessObjects Business Intelligence.

Для получения дополнительной информации см. Решения по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 66].

Объектная модель InfoObject представляет собой объектную модель уровня платформы для SDK.

InfoObject выполняет роль базового класса, в котором несколько объектов Enterprise инкапсулированы в производные классы. Производный класс, представляющий отчеты, это класс CrystalDecisions.Enterprise.Desktop.Report.

Пакет SDK платформы SAP BusinessObjects Business Intelligence построен на базе класса объекта InfoObject и его вспомогательных классов.

Класс InfoObject В SDK класс InfoObject используется для представления разнообразных информационных объектов.

Сюда входят как физические объекты, например файлы отчетов или PDF-файлы, так и сетевые объекты, например пользователи, серверы и FTP-соединения.

Класс InfoObject является базовым классом для множества расширенных классов, которые представляют собой эти информационные объекты с более подробной информацией. Расширенные классы, наследуемые от InfoObject: Report, User, Server, Folder, Program, Ftp, Smtp, Word, Excel и Pdf.

Управляя InfoObject и расширенными экземплярами класса, можно создавать клиентские или административные настольные приложения.

Поддерживающие классы Класс InfoObject поддерживают два дополнительных класса.

Класс InfoStore Класс InfoStore выполняет роль контроллера или шлюза к репозиторию Индексированный Индексированный класс InfoObjects содержит несколько экземпляров класс InfoObjects InfoObject. Он используется InfoStore для перемещения экземпляров InfoObject Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Экземпляры InfoObject не могут управляться непосредственно классом InfoStore. Сначала они должны быть заключены в индексированный класс InfoObjects. С помощью этого индексированного класса можно добавлять, получать, обновлять или планировать отдельные экземпляры InfoObject.

Дополнительные сведения о пакете SDK для SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence см. в документации по пакету SDK для SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

Связанные сведения Выбор правильной объектной модели для проекта [стр. 32] 1.3.1.6 Сравнение архитектур решений по созданию отчетов SAP Business Intelligence Для создания отчетов SAP Business Intelligence предлагает следующие четыре решения:

SAP Crystal Reports, версия для разработчиков Microsoft Visual Studio SAP Crystal Reports Developer Неуправляемый сервер RAS (Report Application Server) SAP Crystal Reports Server или платформа SAP BusinessObjects Business Intelligence Основное архитектурное отличие между решениями по созданию отчетов состоит в том, как в каждом из них размещается и реализуется Report Engine.

Что такое Report Engine?

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

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

Другие основные элементы каждого из решений по созданию отчетов:

файл структуры отчета (RPT-файл);

источник данных;

средство просмотра отчетов;

платформа отчетов, реализованная в SAP Crystal Reports Server или на платформе SAP BusinessObjects Business Intelligence.

Report Engine использует файл структуры отчета (RPT-файл) в качестве шаблона. Затем он просматривает данные из источника данных и использует структуру отчета, чтобы обработать запрошенный в данный момент отчет и передать его в средство просмотра отчетов. Информация, полученная из средства просмотра или закодированная с помощью интерфейса SDK, инициирует последующую обработку из Report Engine, который выполняет с отчетом дальнейшие действия.

Отличие конфигураций Report Engine в различных решениях по созданию отчетов SAP Business Intelligence Report Engine является встроенным элементом.

В версии SAP Crystal Reports для разработчиков Microsoft Visual Studio элемент Report Engine встроен в приложение.

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

Report Engine выделен в отдельный процесс сервера отчетов.

В решении, которое использует неуправляемый сервер RAS, Report Engine выделен в отдельный процесс сервера. Этот процесс сервера может выполняться на одном и том же компьютере или же может быть перемещен на отдельное аппаратное устройство с целью увеличения производительности сервера приложений путем разгрузки его процессов обработки. Неуправляемый сервер RAS более недоступен в виде варианта обновления. Вместо этого рекомендуется выполнить обновление до SAP Crystal Reports Server. Для получения дополнительной информации см. Решения по созданию отчетов SAP BusinessObjects Business Intelligence [стр. 66].

Отдельный процесс сервера отчетов включен в полный комплект архитектуры платформы.

В решении SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence реализована полная архитектура платформы, которая включает отдельный процесс сервера отчетов (RAS). Управляемый сервер RAS становится единственным сервером среди множества других серверов архитектуры платформы. Эта архитектура предоставляет значительный набор дополнительных функций, таких как планирование, балансировка нагрузки, отказоустойчивость, а также вертикальная и горизонтальная масштабируемость.

1.3.2 Элемент управления CrystalReportViewer Для просмотра отчета Crystal в приложение необходимо добавить элемент управления CrystalReportViewer. Элемент управления CrystalReportViewer используется в.NET Framework для связывания с отчетами и их отображения. Элемент управления CrystalReportViewer включает по умолчанию элементы пользовательского интерфейса, помогающие при просмотре, сохранении и навигации по отчету.

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

руководство SAP Crystal Reports.NET API Reference.

Элемент управления CrystalReportViewer необходим только в случае, если предполагается отображать отчеты Crystal.

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

Панель инструментов CrystalReportViewer может быть удалена из средства просмотра.

Кнопки на панели инструментов CrystalReportViewer можно добавлять или удалять программными средствами.

Элемент управления CrystalReportViewer поддерживает настройку через CSS или с помощью тем.

Связанные сведения Настройка элемента управления CrystalReportViewer [стр. 228] Просмотр отчета [стр. 166] 1.3.2.1 Использование элементов управления средства просмотра отчетов Элементы управления средства просмотра отчетов представляют собой элементы управления.NET, которые можно добавлять к форме в приложении Windows или веб-приложении для отображения отчетов в этой форме.

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

Что такое элемент управления.NET?

Элементы управления Microsoft.NET являются специальными типами классов, отображаемыми на панели инструментов Visual Studio. Они добавляются к веб-форме или форме Windows как объекты графического © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide интерфейса пользователя и наследуют общий базовый класс элемента управления. К основным элементам управления.NET относятся: Button, DropDownList, CheckBox, TextBox и DataGrid.

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

Элементы управления Microsoft.NET для веб-форм и форм Windows функционально идентичны..NET Framework рассматривает каждую веб-страницу как форму, содержащую элементы управления, подобно приложению Windows.

Почему для просмотра отчетов в SAP Crystal Reports используются элементы управления.NET?

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

Использование элементов управления.NET позволяет объединить сложные процессы создания отчетов и отображения. Все данные сложных отчетов, которые ранее инкапсулировались только в автономном приложении SAP Crystal Reports, теперь инкапсулированы в элементе управления.NET в качестве средства просмотра отчетов.

Сколько элементов управления средства просмотра отчетов существует?

Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio поддерживает две версии элемента управления CrystalReportViewer: для веб-приложений и для приложений Windows. Элемент управления CrystalReportViewer из пространства имен CrystalDecisions.Web используется веб-проектами ASP.NET.

Элемент управления CrystalReportViewer из пространства имен CrystalDecisions.Windows.Forms используется проектами Windows.

Элемент управления CrystalReportPartsViewer используется для отображения только частей отчетов на веб-странице.

Отображение отчета с помощью элемента управления CrystalReportViewer Элемент управления CrystalReportViewer отображает только один отчет одновременно. В элементе управления отображается отчет, связанный с кодом. Чтобы отобразить в элементе управления определенный отчет, необходимо связать свойство ReportSource элемента управления с определенным отчетом. Во время выполнения элемент управления загружает отчет, связанный со свойством ReportSource, и отображает его.

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

crystalReportViewer1.ReportSource = "C:\WorldSalesReport.rpt" crystalReportViewer1.ReportSource = "C:\\WorldSalesReport.rpt";

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

Это основной способ связи отчета с элементом управления CrystalReportViewer.

Можно ли связать элемент управления CrystalReportViewer с объектами данных?

n° Элемент управления CrystalReportViewer можно связать с объектом отчета, но не с объектом данных.

Причиной этому является отличие назначения элемента управления CrystalReportViewer от других элементов управления.NET. Другие элементы управления.NET предназначены для связывания с данными и форматирования необработанных данных на странице. Так как встроенный конструктор SAP Crystal Reports автоматически выполняет эти действия каждый раз при создании отчета (отчет по умолчанию инкапсулирует извлечение и отображение данных), элемент управления CrystalReportViewer предназначен только для отображения объекта отчета.

Приведенная ниже таблица позволяет сравнить возможности связывания для элементов управления.NET и CrystalReportViewer.

ными.NET (например, DataGrid) DataReader, DataView, IDictionary, Элемент управления средства Объект отчета (инкапсулирую Файл отчета Crystal имеет Так как элемент управления CrystalReportViewer можно связать с объектом отчета, а не с объектом данных, свойство, определяющее источник отчета для средства просмотра отчета, называется ReportSource (а не DataSource).

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

Связанные сведения Просмотр отчета [стр. 166] 1.3.2.1.1 Добавление элемента управления CrystalReportViewer в приложение Windows Процедура 1. Откройте форму Windows в представлении проекта.

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

В предыдущих версиях SAP Crystal Reports для Visual Studio элемент управления CrystalReportViewer отображался в узле Crystal Reports.

3. Перетащите элемент управления CrystalReportViewer на форму.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.3.2.1.2 Добавление элемента управления CrystalReportViewer к веб-сайту Процедура 1. Откройте страницу Default.aspx.

2. Нажмите кнопку Проект внизу формы.

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

4. Перетащите элемент управления CrystalReportViewer на веб-форму.

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

1.3.2.1.3 Привязка элемента управления CrystalReportViewer к файлу на диске Контекст Самый простой способ выполнить привязку элемента управления CrystalReportViewer к отчету Crystal – установить для свойства ReportSource значение местоположения на диске. При запуске приложения будет отображен этот невстроенный отчет.

Благодаря этому отчет непосредственно связывается с элементом управления. Все программное взаимодействие с отчетом должно выполняться в пределах ограниченной объектной модели CrystalReportViewer.

Процедура 1. Добавьте элемент управления CrystalReportViewer к приложению Windows или веб-сайту.

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

4. Задайте для свойства ReportSource значение местоположения отчета в локальной файловой системе.

При работе с приложениями Windows Forms или веб-сайтом:

myCrystalReportViewer.ReportSource = "C:\MyReport.rpt" crystalReportViewer.ReportSource = "C:\\MyReport.rpt";

При работе с приложением WPF:

myCrystalReportViewer.ViewerCore.ReportSource = "C:\MyReport.rpt" crystalReportViewer.ViewerCore.ReportSource = "C:\\MyReport.rpt";

В Visual Studio 2005 и более поздних версиях при добавлении элемента управления.NET к веб-форме или форме Windows открывается панель быстрых задач. Это небольшая панель, отображаемая в верхнем правом углу элемента управления.NET. При открытии панель содержит флаговые кнопки и поля со списком, позволяющие разработчику выбрать параметры подключения и другие параметры для элемента управления. Эта возможность позволяет значительно сократить объем кода, который потребуется написать разработчику.

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

При работе с проектом Windows значения, выбранные на панели быстрых задач, используются для автоматической генерации кода в файле скрытого класса. Файл скрытого класса является "частичным" классом, действующим как дополнение к существующему классу форм Windows. Частичные классы являются нововведением в.NET Framework версии 2.0.

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

Панель быстрых задач широко используется элементом управления CrystalReportViewer. Параметры, доступные для выбора на панели, отличаются для веб-проектов и проектов для Windows.

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

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

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

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

Создать новый отчет Crystal...

Этот пункт меню позволяет создать отчет с помощью встроенного конструктора SAP Crystal Reports.

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

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

Выберите отчет Crystal Эта команда меню позволяет выбрать отчет Crystal или объект ReportDocument, который будет выполнять функцию источника отчета для элемента управления CrystalReportViewer.

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

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Очистить источник отчета Эта команда меню очищает свойство ReportSource элемента управления CrystalReportViewer.

Выберите вид панели инструментов:

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

Отобразить панель инструментов Этот флажок позволяет отобразить или скрыть панель инструментов элемента управления CrystalReportViewer.

Отобразить строку состояния Эта флаговая кнопка позволяет отобразить или скрыть строку состояния в элементе управления CrystalReportViewer.

Отменить фиксацию в родительском контейнере Этот пункт меню позволяет установить для свойства фиксации значение "Нет" или "Заполнение". По умолчанию при перемещении элемента управления CrystalReportViewer в форму Windows для свойства фиксации установлено значение "Заполнение". Если выбран этот пункт меню, значение "Нет" свойства фиксации позволяет изменять размер и перемещать элемент управления CrystalReportViewer в пределах формы Windows или других контейнеров (например, элемент управления панели в пределах формы Windows).

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

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

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

Сконфигурировать источник отчета...

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

Редактировать отчет...

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

Выберите вид панели инструментов:

Разрешить панель инструментов Этот флажок позволяет отобразить или скрыть панель инструментов элемента управления CrystalReportViewer.

Разрешить вид отчета Этот флажок позволяет отобразить или скрыть представление отчета в элементе управления CrystalReportViewer.

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

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

Когда в отчете отсутствует информация, необходимая для входа в систему базы данных SQL Server, возникает ошибка и отображается сообщение: "Сбой при входе в систему". Однако если флажок установлен, отображается подсказка для ввода недостающих учетных данных.

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

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

Связанные сведения Панель интеллектуальных задач CrystalReportViewer для проектов Windows [стр. 50] 1.3.2.3 Элемент управления CrystalReportPartsViewer Элемент управления CrystalReportPartsViewer используется в.NET Framework для связывания с отчетом Crystal и его отображения в виде серии связанных частей. Это позволяет существенно сократить пространство, необходимое для отображения данных отчета, что идеально для отображения небольших объемов информации из отчета на веб-странице портала.

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

Pages: |

| 2 | 3 | 4 | 5 | ... | 17 |

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

[ СКАЧАТЬ ОРИГИНАЛ ДОКУМЕНТА .pdf ]

Похожие работы:

«ТРЕБОВАНИЯ К ОРГАНИЗАЦИИ И ПРОВЕДЕНИЮ ГЕОЛОГО МИНЕРАГЕНИЧЕСКОГО КАРТИРОВАНИЯ масштабов 1 : 500 000 и 1 : 200 000 САНКТ ПЕТЕРБУРГ • 2009 МИНИСТЕРСТВО ПРИРОДНЫХ РЕСУРСОВ И ЭКОЛОГИИ РОССИЙСКОЙ ФЕДЕРАЦИИ ФЕДЕРАЛЬНОЕ АГЕНТСТВО ПО НЕДРОПОЛЬЗОВАНИЮ ФЕДЕРАЛЬНОЕ ГОСУДАРСТВЕННОЕ УНИТАРНОЕ ПРЕДПРИЯТИЕ ВСЕРОССИЙСКИЙ НАУЧНО ИССЛЕДОВАТЕЛЬСКИЙ ГЕОЛОГИЧЕСКИЙ ИНСТИТУТ ИМ. А. П. КАРПИНСКОГО ТРЕБОВАНИЯ К ОРГАНИЗАЦИИ И ПРОВЕДЕНИЮ ГЕОЛОГО МИНЕРАГЕНИЧЕСКОГО КАРТИРОВАНИЯ масштабов 1 : 500 000 и 1 : Санкт...»

«Р. Строуп, Дж. Гвартни АЗБУКА ЭКОНОМИКИ ISBN 5-88662-032-X © James D. Gwartney and Richard L. Stroup, What Everyone Should Know About Economics And Prosperty, 1993 © Авторизованный русский перевод: Институт национальной модели экономики, 1996 Издание является совместным проектом Института национальной модели экономики и The Fraser Institute, Canada Руководители проекта М. Бутина и Ю. Кочетыгова. Авторизованный перевод: Ю. Кочетыгова, В. Найшуль Редакция: В. Бойков, М. Бутина, В. Гребенников, Е....»

«http://server.ashmanov.com:8090/pap/bubble/ Жизнь внутри пузыря Игорь Ашманов Оглавление Жизнь внутри пузыря 1. Вступление: пузырь снова надувается? Интернет-проект — это всегда риск Кто и чем рискует внутри интернет-проекта Венчурные инвесторы Дикие инвесторы Менеджеры Откуда риск? О чём этот текст Disclaimer (он же отмазка) о соответствии реальности Опер велел про всех писать? 2. Пролог 3. Начало: розовые очки надежды Рунет-заря 1999 года Жизнь удалась РИФ — Съезд победителей Русский день в...»

«ООО Институт территориального планирования ГРАД КРАСНОЯРСКИЙ КРАЙ КАЗАЧИНСКИЙ РАЙОН МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ КАЗАЧИНСКИЙ СЕЛЬСОВЕТ ГЕНЕРАЛЬНЫЙ ПЛАН ПОЯСНИТЕЛЬНАЯ ЗАПИСКА КРАСНОЯРСКИЙ КРАЙ КАЗАЧИНСКИЙ РАЙОН МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ КАЗАЧИНСКИЙ СЕЛЬСОВЕТ ГЕНЕРАЛЬНЫЙ ПЛАН ПОЯСНИТЕЛЬНАЯ ЗАПИСКА Заказчик: Администрация Казачинского района Государственный контракт: №007 от 14.11. Исполнитель: ООО Институт территориального планирования Град Генеральный директор А. Н. Береговских Первый заместитель...»

«Министерство образования и науки Российской Федерации Федеральное государственное бюджетное образовательное учреждение высшего профессионального образования РОССИЙСКИЙ ГОСУДАРСТВЕННЫЙ УНИВЕРСИТЕТ ТУРИЗМА И СЕРВИСА Экономический факультет Кафедра менеджмента и бизнес-технологий ДИПЛОМНЫЙ ПРОЕКТ на тему: Проект мероприятий по совершенствованию инвестиционной деятельности ООО АВТ Групп по специальности: 080507.65 Менеджмент организации Павел Алексеевич Лукашов Студент кандидат экономических...»

«2 1. Цели освоения дисциплины Целью освоения дисциплины Технология и безопасность взрывных работ является получение студентами теоретических знаний и практических навыков по выбору и обоснованию параметров безопасных технологий ведения взрывных работ (ВР). Задачей изучения дисциплины является приобретение и развитие знаний, умений и навыков по технологи и безопасному ведению взрывных работ (ВР) в практической деятельности. Дисциплина формирует у студентов общее представление о различных...»

«VAS-RF_#07_2009_1ch:VAS-RF.qxd 30.06.2009 13:28 Page 28 Вестник Высшего Арбитражного Суда Российской Федерации № 7/2009 Артем Георгиевич Карапетов профессор Российской школы частного права, ректор Юридического института М-Логос, зав. кафедрой Государственной академии повышения квалификации (ГАСИС), кандидат юридических наук Доктрина условных сделок в России находится в зачаточном состоянии. Такие сделки воспринимаются как редкие исключения, а не ординарные правовые явления. Автор статьи...»

«1. Цели освоения дисциплины Целями освоения дисциплины Формирование мотивационно ориентированной образовательной среды в процессе обучения математике являются формирование и развитие у студентов профессиональных компетенций, формирование систематизированных знаний, умений и навыков в области теории и методики обучения математике и её основных методов, позволяющих подготовить конкурентноспособного выпускника для сферы образования, готового к инновационной творческой самореализации в...»

«Опыт Национального исследовательского университета Казанский государственный технологический университет по укреплению связей с промышленностью Приоритетом КГТУ является тесная связь с промышленными предприятиями России в области разработки и проектирования современных технологий, коммерциализации результатов НИР, подготовки и переподготовки кадров. Стратегическими партнерами КГТУ в подготовке специалистов и проведении совместных научно-исследовательских и опытно-конструкторских работ являются...»

«+ АНАЛИЗ РАБОТЫ за 2009/2010 учебный год ПЛАН РАБОТЫ на 2010/2011 учебный год частного общеобразовательного учреждения Лицей-интернат естественных наук Саратов 2010 1 Содержание Стр. 1. Анализ деятельности коллектива ЛИЕН за 2009/2010 учебный год. 3–21 2. Приоритетные задачи лицея-интерната на 2010/2011 учебный год. 22–23 3. Мероприятия по набору учащихся в лицей 4. План проведения педагогических советов 5. План проведения заседаний НМС 6. Система руководства и контроля 7. Мониторинг...»

«Интеллектуальный партнер РВК и Powered by Firrma.ru При поддержке 1. Есть такая традиция – противопоставлять Москву всей остальной России Долгое время этот стереотип правил умами почти всех энтузиастов, которые мечтали донести до остального мира свою идею. Они летели в Москву со всех уголков страны, без опыта, средств и связей. И большинство подобных историй заканчивалось трагически: разбитыми надеждами и нереализованными бизнес-моделями. Но этот стереотип постепенно развеивают сотни успешных...»

«ФЕДЕРАЛЬНОЕ АГЕНТСТВО ПО ТЕХНИЧЕСКОМУ РЕГУЛИРОВАНИЮ И МЕТРОЛОГИИ НАЦИОНАЛЬНЫЙ ГОСТ Р МЭК СТАНДАРТ 62086-2— РОССИЙСКОЙ 2005 ФЕДЕРАЦИИ Электрооборудование для взрывоопасных газовых сред НАГРЕВАТЕЛИ СЕТЕВЫЕ ЭЛЕКТРИЧЕСКИЕ РЕЗИСТИВНЫЕ Часть Требования по проектированию, установке и обслуживанию IEC 62086-2: Electrical apparatus for explosive gas atmospheres — Electrical resistance trace heating — Part 2: Application guide for design, installation and maintenance (IDT) Издание официальное БЗ 12—2005/...»

«Внеочередной выпуск от 27 декабря 2012 г. АННИНСКИЕ ВЕДОМОСТИ ИЗДАНИЕ СОВЕТА ДЕПУТАТОВ И МЕСТНОЙ АДМИНИСТРАЦИИ МУНИЦИПАЛЬНОГО ОБРАЗОВАНИЯ АННИНСКОЕ СЕЛЬСКОЕ ПОСЕЛЕНИЕ нансирования дефицита местного бюджета муниципаль- пальных органов муниципального образования АннинСовет депутатов ного образования Аннинское сельское поселение. ское сельское поселение МО Аннинское сельское поселение Утвердить перечень и коды главных администрато- 1. Утвердить расходы на обеспечение деятельноров доходов местного...»

«Концепция развития культуры Волгоградской области на период до 2020 года Содержание Содержание.. 1 1. Общие положения.. 3 2. Принципы развития культуры Волгоградской области. 7 3. Актуальность.. 8 4. Современное состояние.. 11 5. Цели, задачи и направления развития. 22 6. Механизмы реализации концепции.. 34 7. Прогноз результатов реализации концепции. 36 8. Основные показатели эффективности реализации концепции. 41 2 Концепция развития культуры Волгоградской области на период до года (далее -...»

«пищевая промышленность: наука и технологии Содержание В. Г. Гусакова. Поздравление от аграрного отделения нан Беларуси. 3 З. В. Ловкис. 10 лет в Пищевой Промышленности А. А. Шепшелев. международное сотрудничество: резулЬтаты и ПерсПективы развития К. И. Жакова, Е. С. Колядич. Продукты Питания для людей Пожилого возраста И. А. Громова, И. М. Почицкая. система контроля качества Пищевой Продукции и сырЬя в ресПуБлике БеларусЬ Н. Н. Петюшев. участие руП научно-Практический центр нан Беларуси По...»

«Министерство экономического развития, инвестиций и торговли Самарской области Фонд Региональный центр развития предпринимательства Самарской области Новые тренды по взаимодействию с иностранным капиталом. Совместные бизнес-проекты Материалы круглого стола Самара, 16 февраля 2012 года Оглавление Вступительное слово Регионы интересов предпринимателей Самарской области Опыт поддержки экспортно-ориентированных предприятий в регионах России Вступление России в ВТО – последствия для предпринимателей...»

«№ 5’ 2012 № 5’ 2012 А. Е. Касьянов, В. И. Сметанин, ФГБОУ ВПО МГУП, 2012 Содержание Габилу Худуш оглы Исмайылову 75 лет Мелиорация и рекультивация, экология Ольгаренко Г. В., Цекоева Ф. К. Планирование экологически безопасных режимов орошения агробиоценозов с учетом изменчивости гидрометеорологических условий Голованов А. И., Студенова К. С. Обоснование противопожарного шлюзования в Мещерской низменности Сметанин В. И., Хохлов В. И. Исследования работы водоприемного слоя дренажных труб из...»

«Впервые в формате Premium! С 16 по 19 октября выставка Мебельный клуб в первый раз прошла в новом формате – Premium. В эти даты МВЦ Крокус Экспо стал местом встречи ведущих производителей и поставщиков мебели, работающих в сегменте Средний +, Элит и Премиум, с представителями торговых компаний, гостиничного и ресторанного бизнеса, строительных и девелоперских организаций, дизайнерами, архитекторами, декораторами. www.mebelclub.com 16-19 октября 2013 года + 7 (495) 983 -06-70 + 7 (495) 223-...»

«Дорогие друзья я! Вы хорошо знаете, что в стране в н настоящее время р реализуются четыре приоритетных национальных проекта — в области е здраво оохранения, образоования, жилья и се ельского хозяйства Эти сферы а. в перввую очередь опре еделяют качество жизни людей и социальное благоп получие общества Однако здесь н а. накопилось немал сложных ло проблеем, решение к которых стало насущной и неотложной необхоодимостью. Именн поэтому Презид но дентом РФ В.В. Пуутиным была постав влена перед П...»

«Марк Сейфер Абсолютное оружие Америки Марк Сейфер Тесла с легкостью шагнул на 100 лет вперед, спровоцировав самую главную (и, как показало время, самую кровавую) техническую революцию. Он изобрел индукционный мотор, лампы дневного света и беспроводную связь, думая, что работает во благо, – снаряды с дистанционным управлением, летательный аппарат вертикального взлета и лазерное оружие. Могущество его было столь велико, что даже падение Тунгусского метеорита до сих пор считается делом его рук....»

наверх

<< ГЛАВНАЯ | КОНТАКТЫ

БЕСПЛАТНАЯ ЭЛЕКТРОННАЯ БИБЛИОТЕКА (Авторефераты, диссертации, методички, учебные программы, монографии)

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

БЕСПЛАТНАЯ ЭЛЕКТРОННАЯ БИБЛИОТЕКА
(Авторефераты, диссертации, методички, учебные программы, монографии)