Pages: | 1 | ... | 2 | 3 |

| 5 | 6 | ... | 17 |

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

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

1.4.4.1.3 Вход в защищенную базу данных SQL Server при использовании объектной модели ReportDocument В этом примере показано, как войти в базу данных, используя защищенную аутентификацию SQL.

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

Контекст Чтобы обновить информацию о подключении для отчета, используя объектную модель ReportDocument, необходимо сначала обновить свойство ConnectionInfo для каждого объекта Table в коллекции ReportDocument.Database.Tables. После того, как все свойства были обновлены, требуется вызвать метод Table.ApplyLogOnInfo, чтобы сохранить изменения.

Процедура 1. Создайте новый объект ConnectionInfo.

2. Задайте свойствам DatabaseName, UserID и Password объекта ConnectionInfo значения, требуемые Если указать только свойства DatabaseName, UserID и Password, будет выполнен вход на сервер по умолчанию для базы данных, указанной в отчете. Однако, если назначить альтернативное свойство ServerName, можно перенаправить отчет на другой сервер во время выполнения.

3. Извлеките экземпляр класса Tables из свойства Database класса ReportDocument.

Tables представляет собой индексированный класс, который содержит экземпляры класса Table.

4. Для каждого объекта Table в коллекции выполните следующие действия:

a) Извлеките экземпляр TableLogOnInfo из свойства LogOnInfo класса Table.

b) Обновите свойство ConnectionInfo объекта TableLogOnInfo.

c) Вызовите метод ApplyLogOnInfo, чтобы зафиксировать изменения.

Private Sub setDatabaseLogon(ByVal rd As ReportDocument, ByVal databaseName As String, ByVal userName As String, ByVal password As String) Dim myConnectionInfo As New ConnectionInfo() myConnectionInfo.DatabaseName = databaseName myConnectionInfo.UserID = userName myConnectionInfo.Password = password Dim myTables As Tables = rd.Database.Tables For Each myTable As Table In myTables Dim newLogonInfo As TableLogOnInfo = myTable.LogOnInfo Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide newLogonInfo.ConnectionInfo = myConnectionInfo myTable.ApplyLogOnInfo(newLogonInfo) private void setDatabaseLogon(ReportDocument rd, String databaseName, String userName, String password) ConnectionInfo connectionInfo = new ConnectionInfo();

connectionInfo.DatabaseName = databaseName;

connectionInfo.UserID = userName;

connectionInfo.Password = password;

Tables tables = rd.Database.Tables;

foreach (Table table in tables) TableLogOnInfo newLogonInfo = table.LogOnInfo;

newLogonInfo.ConnectionInfo = connectionInfo;

table.ApplyLogOnInfo(newLogonInfo);

Следующие шаги После задания данных входа в базу данных для экземпляра класса ReportDocument, обновите свойство ReportSource объекта CrystalReportViewer.

1.4.4.1.4 Вход в защищенную базу данных SQL Server с использованием элемента управления CrystalReportViewer Контекст При использовании объектной модели CrystalReportViewer для входа в защищенную базу данных SQL Server необходимо использовать классы из пространства имен CrystalDecisions.Shared.

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

Процедура 1. Создайте новый объект ConnectionInfo.

2. Задайте свойствам DatabaseName, UserID и Password объекта ConnectionInfo значения, требуемые © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Если указать только свойства DatabaseName, UserID и Password, будет выполнен вход на сервер по умолчанию для базы данных, указанной в отчете. Однако, если назначить альтернативное свойство ServerName, можно перенаправить отчет на другой сервер во время выполнения.

3. Извлеките экземпляр TableLogOnInfos из свойства LogOnInfo класса CrystalReportViewer.

TableLogOnInfos представляет собой индексированный класс, который содержит экземпляры класса TableLogOnInfo.

4. Для каждого объекта TableLogOnInfo в коллекции установите в качестве значения свойства ConnectionInfo объекта TableLogOnInfo объект ConnectionInfo.

Private Sub setDatabaseLogon(ByVal databaseName As String, ByVal userName As String, ByVal password As String) Dim myCconnectionInfo As New ConnectionInfo() Dim logOnInfos As TableLogOnInfos = crystalReportViewer.LogOnInfo For Each logOnInfo As TableLogOnInfo In logOnInfos logOnInfo.ConnectionInfo = myCconnectionInfo myCconnectionInfo.DatabaseName = databaseName myCconnectionInfo.UserID = userName myCconnectionInfo.Password = password private void setDatabaseLogon(String databaseName, String userName, String password){ ConnectionInfo connectionInfo = new ConnectionInfo();

TableLogOnInfos logOnInfos = crystalReportViewer.LogOnInfo;

foreach(TableLogOnInfo logOnInfo in logOnInfos) { logOnInfo.ConnectionInfo = connectionInfo;

connectionInfo.DatabaseName = databaseName;

connectionInfo.UserID = userName;

connectionInfo.Password = password;

1.4.4.2 Подключение к интерфейсу IDataReader Во многих проектах.NET для извлечения данных используется не DataSet, а DataReader. Например, обычный способ связать элемент управления (например GridView) с данными заключается в том, чтобы создать метод, который извлекает данные с помощью DataReader, а затем вернуть данные из этого метода через интерфейс IDataReader.

Встроенный конструктор отчетов SAP Crystal обеспечивает доступ к интерфейсу IDataReader при соблюдении определенных условий:

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Данные должны возвращаться из метода, через интерфейс IDataReader.

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

Классы этого поставщика данных расположены в пространстве имен System.Data.OleDb.

Метод должен быть объявлен как Shared [Visual Basic] или static [C#].

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

Чтобы создать отчет Crystal, использующий экземпляр IDataReader в качестве источника данных, необходимо создать библиотеку класса со статическим методом, возвращающим объект IDataReader.

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

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

Связанные сведения Учебное пособие: подключение к IDataReader [стр. 569] Из этого учебного пособия по соединению с данными вы узнаете, как подключиться к экземпляру IDataReader.

1.4.4.3 Подключение к наборам данных ADO.NET Объект набора данных ADO.NET – это коллекция классов набора данных, созданных в памяти. Набор данных ADO.NET можно создать на основе различных источников данных (включая базы данных Access, Oracle и SQL Server) с помощью конструктора наборов данных Visual Studio ADO.NET Dataset Designer.

Конструктор ADO.NET Dataset Designer отображает графическое представление базы данных с ее таблицами, полями и их соответствующими типами. Можно перетаскивать таблицы из Server Explorer в файл схем на вкладке конструктора "Схема".

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

Установить DataSet в качестве источника данных для отчета невозможно до тех пор, пока не создана и не скомпилирована библиотека класса.

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

При необходимости изменения данных в наборах данных после выполнения запроса.

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

Наборы данных являются XML-представлением данных, обычно из базы данных. Набор данных не эквивалентен отдельной таблице в базе данных; скорее он эквивалентен группе таблиц. Это представляет потенциальную проблему с масштабируемостью для отчетов. Если отчет извлекает несколько таблиц в набор данных с последующим объединением этих таблиц, обработка объединения должна выполняться в процессе взаимодействия отчета с каждой отдельной таблицей. Это неэффективный подход. Логичнее поместить выражения объединения в запрос, используемый для заполнения набора данных. В результате создается единая "псевдотаблица" с предварительно объединенными данными в наборе данных, что позволяет отчету сфокусироваться исключительно на отображении данных.

Связанные сведения Неиспользование наборов данных для простых запросов [стр. 70] Кэширование наборов данных в случае их использования [стр. 71] Учебное пособие: подключение к наборам данных ADO.NET [стр. 554] 1.4.4.4 Подключение к коллекциям объектов В SAP Crystal Reports 2008 предусмотрена возможность формирования отчетов на основе данных объектов. Данные объектов могут быть простыми, такими как строка или целочисленные значение. Они также могут быть сложными, такими как класс или коллекция. Коллекции должны представлять собой простые массивы или объекты типа IEnumerable. SAP Crystal Reports может работать с этими коллекциями объектов как с обычными источниками данных, что значительно расширяет выбор источников данных для отчетов Crystal.

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

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

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

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

Чтобы включить развертывание сложных типов, к свойству, возвращающему объект, который требуется развернуть, необходимо добавить атрибут CrystalComplexTypeExpansionLevels. Необходимо задать для атрибута CrystalComplexTypeExpansionLevels значение больше 1, чтобы выполнить развертку данных класса. Если атрибут CrystalComplexTypeExpansionLevels не будет установлен, SAP Crystal Reports не удастся получить доступ к данным поля внутри класса.

Представление простых данных В этом примере имеется два объекта: Employee и Person. Когда объект Employee добавляется к отчету в виде источника данных, свойство Employee.EmployeeID будет предоставляться в качестве допустимого поля, однако свойство Employee.Person не будет видимым, так как оно возвращает сложный тип данных.

Class Employee Private _employeeID As Integer Private _person As New Person() Public Property EmployeeID() As Integer Public ReadOnly Property Person() As Person End Class Class Person Private _name As String Public Property Name() As String © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide End Class class Employee int _employeeID;

Person _person = new Person();

class Person private String _name;

Разрешение развертывания сложных типов В предыдущем примере свойство Employee.Person является невидимым, так как оно возвращает сложный тип данных.

В этом примере атрибут CrystalComplexTypeExpansionLevels был добавлен к свойству Employee.Person, что позволяет дизайнеру отчетов видеть новое поле в Проводнике полей: PersonName.

Class Employee Private _employeeID As Integer Private _person As New Person() Public Property EmployeeID() As Integer Public ReadOnly Property Person() As Person Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide End Class Class Person Private _name As String Public Property Name() As String Set(ByVal value As String) End Class class Employee int _employeeID;

Person _person = new Person();

public int EmployeeID [CrystalDecisions.CrystalReports.Engine.CrystalComplexTypeExpansionLevels(1)] public Person Person class Person private String _name;

public String Name Связанные сведения Учебное пособие: подключение к коллекциям объектов [стр. 580] Из этого учебного пособия по соединению с данными вы узнаете, как использовать коллекцию объектов в качестве источника данных для отчета Crystal.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.4.5 Активация кэширования отчетов на веб-сайте SAP Crystal Reports Предпосылки В ходе приведенной процедуры используется функция интеллектуальных задач. Функция интеллектуальных задач доступна в Visual Studio 2005 и более поздних версиях.

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

Если интерфейсные классы для отчета не создаются, кэшированием управляет свойство EnableCaching элемента управления CrystalReportSource.

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

2. На странице Default.aspx выберите представление Источник.

3. Найдите тег XML для элемента управления CrystalReportSource.

4. Измените значение свойства EnableCaching с False на True.

Дополнительные сведения о кэшировании отчетов, интерфейсном классе кэшированного отчета и ситуациях, в которых следует и не следует использовать кэширование, см. в разделе Использование объекта Cache для сохранения объектной модели ReportDocument [стр. 60].

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide LINQ (языковой интегрированный запрос) – это компонент платформы Майкрософт, позволяющий выполнять запросы, используя любые источники данных.

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

Использование LINQ упрощает процесс формирования отчетов по коллекции объектов и позволяет выполнять запросы, подобные запросам SQL, по пользовательским объектам. Например, предположим, что есть база данных SQL, файл XML и файл Microsoft Access, содержащий данные, связанные с продажами. LINQ позволяет запрашивать из всех трех источников данных и отображать данные в одном отчете.

LINQ позволяет выполнять следующие операции:

сборку коллекции объектов из нескольких источников данных;

объединение двух коллекций объектов;

группировку элементов в коллекции.

Для использования LINQ совместно с SAP Crystal Reports необходимо установить следующее программное обеспечение:

Visual Studio 2008 или более поздней версии;

платформа.NET Framework версии 3.5;

SAP Crystal Reports Basic для Visual Studio 2008 или более поздней версии.

Связанные сведения Задание источника данных [стр. 153] Элемент управления CrystalReportViewer используется для просмотра отчетов Crystal. В SAP Crystal Reports.NET SDK есть два элемента управления CrystalReportViewer. Для веб-сайта следует использовать класс CrystalDecisions.Web.CrystalReportViewer. Для приложения Windows используется класс CrystalDecisions.Windows.Forms.CrystalReportViewer.

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

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

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

CrystalDecisions.Web.CrystalReportViewer Предоставляет свойства, методы и события для изменения и извлечения информации о внешнем виде и функциях элемента управления CrystalReportViewer.

CrystalDecisions.CrystalReports.Engine.ReportDocument Представляет отчет и содержит свойства и методы для определения, форматирования, загрузки, экспорта и печати отчета.

Связанные сведения Использование элементов управления средства просмотра отчетов [стр. 44] Элемент управления CrystalReportViewer [стр. 43] Сценарии связывания отчетов [стр. 172] 1.4.5.1 Сравнение встроенных и невстроенных отчетов В чем заключается различие между встроенными и невстроенными отчетами?

Встроенный отчет – это отчет, импортированный в проект Visual Studio или созданный в этом проекте. При встраивании отчета в проект для отчета автоматически генерируется интерфейсный класс. Тем самым обеспечивается доступ к отчету по имени, а не через отдельный экземпляр ReportDocument.

Невстроенный отчет – это отчет, который является внешним для проекта Visual Studio. Существует множество способов доступа к отчету и его загрузки в объектную модель (обеспечения программного взаимодействия с отчетом), однако для проекта отчет всегда будет оставаться внешним.

Как работает встроенный отчет?

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

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Платформа.Net Framework имеет ограничения на размер DLL-файлов. Это означает, что если проект содержит большие встроенные отчеты, он не может скомпилироваться. Для проектов, в которых используются большие отчеты, следует отключить сохраненные данные в отчете или изменить проект, чтобы в нем использовались невстроенные отчеты. Предельное значение размера зависит от версии.Net Framework. Для получения дополнительных сведений см. в документацию по.Net Framework.

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

Корневым классом объектной модели ReportDocument является класс ReportDocument.

Как работают невстроенные отчеты?

Для работы с невстроенными отчетами всегда используется внешний доступ. SDK поддерживает несколько способов доступа к невстроенным отчетам:

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

Отчет может быть предоставлен как веб-служба отчетов.

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

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

Объектная модель ReportDocument использует метод ReportDocument.Load() для загрузки отчета в объектную модель ReportDocument.

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

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

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

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

Встраивание отчетов в веб-проект Поддержка встраиваемых отчетов обеспечивается благодаря использованию поставщика сборки, который компилирует отчеты в DLL-файл. Чтобы встроить отчет в библиотеку DLL во время компиляции, параметру embedRptInResource в файле web.config необходимо присвоить значение true. Для доступа к классуоболочке через Intellisense необходимо поместить отчет в папку App_Code/Global решения.

Если отчет находится в папке App_Code/Global, и параметр embedRptInResource установлен в false, не удастся скопировать файл отчета в местоположение назначения при публикации веб-сайта. Для предотвращения этой проблемы скопируйте вместо этого веб-сайт в местоположение назначения.

Связанные сведения Настройка файла Web.Config [стр. 20] Элемент управления CrystalReportViewer единовременно отображает только один отчет. Чтобы отобразить в элементе управления определенный отчет, необходимо связать свойство ReportSource элемента управления с определенным отчетом. Во время выполнения элемент управления загружает отчет, связанный со свойством ReportSource, и отображает его.

Элемент управления CrystalReportViewer можно связать с файлом на диске, с объектом ReportDocument или с объектом ReportClientDocument. Привязка к объекту обеспечивает дополнительную Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide функциональность посредством объектных моделей ReportDocument и ReportClientDocument. Этот способ установки свойства ReportSource является предпочтительным.

Простейшая форма такого связывания выглядит следующим образом:

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

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

Элемент управления CrystalReportSource Элемент управления CrystalReportSource входит в состав новой тэговой модели разработки приложений, поставляемой с ASP.NET версии 2.0.

Примечание Элемент управления CrystalReportSource доступен только для веб-сайтов.

В структуре элемента управления DataSource визуальные элементы управления.NET подключаются к невизуальным (не относящимся к управлению отображаемыми данными) элементам управления DataSource. Эта новая структура DataSource инкапсулирует информацию о подключении данных, записанную в виде строк кода в элементах управления.NET в веб-форме.

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

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

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

2. Откройте веб-форму или форму 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";

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

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

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

2. Откройте веб-форму или форму Windows.

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

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

Dim rd As ReportDocument = New ReportDocument() rd.Load(reportPath) ReportDocument rd = new ReportDocument();

rd.Load(reportPath);

5. Присвойте свойству ReportSource объект ReportDocument.

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

myCrystalReportViewer.ReportSource = rd crystalReportViewer.ReportSource = rd;

myCrystalReportViewer.ViewerCore.ReportSource = rd crystalReportViewer.ViewerCore.ReportSource = rd;

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

Большинство веб-сайтов или проектов Windows полагается на два простейших сценария привязки:

установление связи с встроенным или с невстроенным отчетом.

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

Рекомендуемые сценарии связывания отчетов в SAP Crystal Reports Сценарии, связывающие отчеты с объектной моделью ReportDocument, как правило, предпочитаются сценариям, использующим объектную модель CrystalReportViewer. Причина заключается в том, что объектная модель ReportDocument предоставляет более эффективный API-интерфейс для программного взаимодействия с отчетом.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide В большинстве случаев предпочтительно использовать сценарий Связывание с классом встроенных отчетов [стр. 203]. Несмотря на то, что этот сценарий не является лучшим с точки зрения оптимизации производительности, он наиболее прост в использовании: отчет добавляется к проекту для создания интерфейсного класса отчета, после чего создается экземпляр интерфейсного класса отчета, который затем передается в элемент управления CrystalReportViewer. Так как интерфейсный класс отчета наследует от базового класса ReportDocument, пользователь имеет доступ ко всем возможностям объектной модели ReportDocument.

Другой распространенный способ привязки отчетов описывается в разделе Установка связи с невстроенным отчетом, загруженным в класс ReportDocument [стр. 205]. Он также обеспечивает доступ ко всем возможностям объектной модели ReportDocument, но работает с невстроенными отчетами, что позволяет изменять отчеты без перекомпиляции приложения.

Рекомендуемые сценарии связывания для Report Application Server (RAS) Для RAS можно использовать дополнительные сценарии связывания отчетов (в зависимости от настроек проекта).

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

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

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

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

При использовании версии SAP Crystal Reports для разработчиков Microsoft Visual Studio с SAP Crystal Reports Server или платформой SAP BusinessObjects Business Intelligence проекты, изначально созданные в SAP Crystal Reports (использующие встроенные отчеты), можно переносить в SAP Crystal Reports Server или на платформу SAP BusinessObjects Business Intelligence, сохраняя существующий код без изменений посредством публикации копий встроенных отчетов в SAP Crystal Reports Server или платформу SAP BusinessObjects Business Intelligence.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Связанные сведения Элементы управления средством просмотра отчетов [стр. 35] 1.4.5.3.1 Связывание отчетов с объектной моделью CrystalReportViewer Объектная модель CrystalReportViewer является самой простой из всех объектных моделей. В большинстве случаев из-за ограниченных возможностей вместо этой объектной модели рекомендуется использовать более мощную объектную модель ReportDocument.

Связанные сведения Объектная модель CrystalReportViewer [стр. 37] Установка связи с путем к каталогу в коде [стр. 174] 1.4.5.3.1.1 Установка связи с путем к каталогу в коде Объектная модель В этом сценарии связывания отчетов используется объектная модель CrystalReportViewer.

Расположение отчетов Отчеты расположены в каталоге.

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

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

Упрощенная реализация: отпадает необходимость в объявлении и инициализации классов. Этот сценарий обходит использование объектной модели ReportDocument путем передачи отчета непосредственно в элемент управления CrystalReportViewer.

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

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

Связанные сведения Установка связи с путем к каталогу с помощью окна "Свойства" [стр. 176] 1.4.5.3.1.1.1 Привязка элемента управления CrystalReportViewer к файлу на диске Контекст Самый простой способ выполнить привязку элемента управления CrystalReportViewer к отчету Crystal – установить для свойства ReportSource значение местоположения на диске. При запуске приложения будет отображен этот невстроенный отчет.

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

2. Откройте веб-форму или форму Windows.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 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";

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

Расположение отчетов Отчеты хранятся в каталоге.

Описание Этот сценарий является альтернативной версией самого простого сценария связывания отчетов Установка связи с путем к каталогу в коде [стр. 174]. Отчет в каталоге связывается по его строке пути с элементом управления CrystalReportViewer, но при этом устанавливается присвоение в окне "Свойства" (непосредственно свойству ReportSource или свойству DataBindings>ReportSource).

В случае веб-проекта строка пути к отчету вставляется непосредственно в код HTML страницы ASPX, а не в код класса code-behind.

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

Предварительный просмотр во время проектирования – это функция, доступная на веб-сайтах, но она является нововведением в проектах Windows.

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

Недостатки В случае веб-приложения необходимо вызвать метод DataBind() для элемента управления CrystalReportViewer в классе code-behind, поскольку связывание происходит на странице HTML.

Это ограничение удалено в SAP Crystal Reports для Visual Studio 2005.

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

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

Связанные сведения Установка связи с элементом управления CrystalReportSource (веб-сайты в Visual Studio) [стр. 178] 1.4.5.3.1.2.1 Установка связи с путем к каталогу при помощи окна "Свойства" Процедура 1. Создайте новый веб-проект или проект Windows.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 2. Из панели инструментов перетащите элемент управления CrystalReportViewer на веб-форму или форму Windows.

3. Щелкните элемент управления CrystalReportViewer, чтобы выделить его.

4. В окне Свойства назначьте строку пути к каталогу свойству ReportSource.

Путь к каталогу указывает на образцы отчетов в Visual Studio 2005.

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

C:\Program Files\Microsoft Visual Studio 8.0\Crystal Reports\Samples\En\Reports \Feature Examples\Hierarchical Grouping.rpt 5. Для просмотра отчета постройте и запустите свой проект.

1.4.5.3.1.3 Установка связи с элементом управления CrystalReportSource (веб-сайты в Visual Studio) Объектная модель В этом сценарии связывания отчетов используется объектная модель CrystalReportViewer.

Расположение отчетов Отчеты хранятся в каталоге.

Описание Этот сценарий является альтернативной версией самого простого сценария связывания отчетов Установка связи с путем к каталогу в коде [стр. 174]. В этом сценарии выполняется привязка отчета с использованием новой модели разработки, основанной на тегах, и с уменьшенным количеством кода, модели ASP.NET версии 2.0.

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

В этом сценарии с помощью функции Smart Tasks создается элемент управления CrystalReportSource.

Затем необходимо выбрать отчет для элемента управления CrystalReportSource.

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

С помощью объявляющего элемента XML теги и, вложенные в тег, можно связать с рядом невидимых элементов, доступных в структурах Parameter и DataSource.

Структуры Parameter и DataSource являются новыми функциями ASP.NET 2.0. Они включают следующие элементы управления: ControlParameter или QueryStringParameter, а также SqlDataSource либо JetDataSource.

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

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

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

Те же преимущества, что и перечисленные в разделе Установка связи с путем к каталогу в коде [стр.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.5.3.1.3.1 Привязка элемента управления CrystalReportSource с использованием модели уменьшенного количества кода Процедура 1. Перетащите элемент управления CrystalReportViewer на веб-форму.

2. В верхнем правом углу элемента управления CrystalReportViewer нажмите небольшую кнопку треугольной формы.

Откроется панель интеллектуальных задач с именем Задачи CrystalReportViewer. В списке Выбрать источник отчета отображается надпись.

3. Щелкните список Выбрать источник отчета и выберите пункт.

Откроется диалоговое окно Создание источника отчета.

4. В текстовом поле Укажите имя элемента управления оставьте значение по умолчанию CrystalReportSource1.

5. Щелкните список Укажите отчет для элемента управления CrystalReportSource и выберите пункт Альтернативный выбор -. Этот параметр позволяет создавать новый отчет Crystal.

6. Выберите отчет для отображения в элементе управления CrystalReportViewer и щелкните OK.

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

Связанные сведения Учебное пособие: настройка веб-сайта с сокращенным кодом при помощи программы SAP Crystal Reports с использованием панели интеллектуальных задач [стр. 513] В данном учебном пособии вы научитесь использовать новую модель разработки приложений на основе тегов в среде Visual Studio. Следует придерживаться модели разработки с сокращенным кодом для настройки веб-сайта с помощью программы SAP Crystal Reports с использованием панели интеллектуальных задач.

1.4.5.3.1.4 Установка связи с URL-адресом веб-службы отчетов Объектная модель В этом сценарии связывания отчетов используется объектная модель CrystalReportViewer.

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

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

Преимущества Широкое распространение: отчеты могут располагаться в любом месте в Интернете.

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

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

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

Внутри метода ConfigureCrystalReports() (созданного в разделе Настройка проекта [стр. 16]) назначьте строку URL-адреса веб-службы отчетов свойству ReportSource класса CrystalReportViewer.

myCrystalReportViewer.ReportSource = _ "http://localhost/TestProject/World_Sales_ReportService.asmx" crystalReportViewer.ReportSource = "http://localhost/TestProject/World_Sales_ReportService.asmx";

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

Связанные сведения Работа с Crystal Reports как с веб-службой [стр. 83] 1.4.5.3.1.5 Сценарии связывания CrystalReportViewer, использующие службу Crystal Services Использование службы Crystal Services в Visual Studio Версия SAP Crystal Reports для разработчиков Microsoft Visual Studio обеспечивает программный доступ к файлам сервера с помощью служб Crystal.

Использование службы Crystal Services в Visual Studio В Visual Studio 2003 доступ к отчетам Crystal можно осуществлять с помощью узла Crystal Services в Server Explorer. После установки SAP Crystal Reports и Crystal Services службы Crystal Services отображаются в виде подузла для каждого сервера, присутствующего в Server Explorer.

При развертывании узла Crystal Services отображаются списки отчетов, находящихся в перечисленных ниже местоположениях.

Локальный каталог на жестком диске.

Сервер RAS (Report Application Server) Crystal Enterprise (CE) Любой отчет из этих списков можно перетащить в веб-форму или форму Windows.

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

Для доступа к центральному серверу управления платформы SAP BusinessObjects Business Intelligence может потребоваться настройка параметров брандмауэра. Порт по умолчанию для CMS – 6400. Для получения сведений об адресе в сети и настройках порта для системы платформы SAP BusinessObjects Business Intelligence обратитесь к системному администратору. Дополнительные сведения о настройке портов см. в руководстве администратора платформы SAP BusinessObjects Business Intelligence.

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

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

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

В этой таблице представлены службы Crystal, включенные в SAP Crystal Reports для Visual Studio 2003. Эти службы Crystal Services отображают группу отчетов в локальном каталоге или на сервере вебкомпонентов (WCS) для Crystal Enterprise. Отчеты содержатся в двух различных интерфейсных классах:

ServerFileReport для отчетов в локальном каталоге и EnterpriseReport для отчетов на сервере WCS для Crystal Enterprise.

мый службами Crystal Services Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide мый службами Crystal Services 1.4.5.3.1.5.1 Установка связи с серверными файлами (VS.NET 2003) Объектная модель В этом сценарии связывания отчетов используется CrystalReportViewer.

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

Обзор служб Crystal Services Этот сценарий связывания отчетов применяется к отчетам, доступ к которым осуществляется с узла сервера Crystal Services в Server Explorer.

В этом разделе рассматривается вложенный узел Server Files служб Crystal Services в среде Visual Studio.NET 2003.

[SERVERNAME] Службы Crystal Описание Вложенный узел Server Files получает доступ к отчетам, предоставленным в качестве веб-служб отчетов из локального каталога, а затем отображает их. Эти отчеты предоставляются с помощью протокола вебслужб отчетов. В Visual Studio.NET 2003 для доступа к серверным файлам щелкните узел Server Files в разделе Crystal Services.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Преимущества Централизованный доступ к отчетам: предоставляет одну точку доступа ко всем отчетам в каталоге с образцами отчетов, которые создают эффективный репозиторий отчетов на локальном жестком Недостатки Заменяется в программах SAP Crystal Reports 9 и 10 узлом Crystal Services неуправляемого сервера RAS. Подробные сведения см. в приведенном выше разделе "Описание".

Настройка файлов сервера Файлы сервера предоставляются как узел Crystal Services в SAP Crystal Reports для Visual Studio 2003. При установке программы SAP Crystal Reports 9 или 10 (полных версий) поверх версии, включенной в Visual Studio 2003, узел Server Files не отображается как видимый.

Каждый выпуск SAP Crystal Reports Developer поддерживает файлы сервера в пакете SDK. Однако для работы с файлами сервера в этой версии требуется кодирование вручную.

Связанные сведения Настройка файлов сервера в службах Crystal Services [стр. 87] Установка связи с Crystal Enterprise (VS.NET 2003) [стр. 189] Использование службы Crystal Services [стр. 86] Предпосылки Необходимо установить SAP Crystal Reports для Visual Studio 2003.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Контекст Службы Crystal Services не устанавливаются по умолчанию во время установки Visual Studio.NET 2003.

При выполнении данной процедуры службы Crystal Services будут установлены с установочного компактдиска Visual Studio.Net 2003.

Процедура 1. На установочном компакт-диске Microsoft Visual Studio.NET найдите программу SAP Crystal Reports.

2. Выберите Crystal Web Services.

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

1.4.5.3.1.5.1.2 Использование узла Crystal Services>Server Files Предпосылки Установлена программа SAP Crystal Reports для Visual Studio 2003, а также проверена ее работоспособность.

Или установлена программа SAP Crystal Reports 9 или более поздняя версия, а также проверена ее работоспособность.

В программах SAP Crystal Reports 9 и 10 узел Server Files заменяется (он больше не отображается в качестве узла в разделе Crystal Services). Однако серверные файлы все еще можно кодировать Данная процедура работает только с проектами, созданными из Настройка проекта [стр. 16]. Настройка проекта включает специальные ссылки на пространство имен и конфигурацию кода, необходимую для выполнения данной процедуры. Выполнение процедуры без этой конфигурации невозможно.

Процедура 1. В меню "Вид) выберите пункт Другие окна, а затем Server Explorer.

2. Разверните службы Crystal Services, а затем разверните пункт Server Files.

3. Выберите отчет из дерева Server Files и перетащите его на форму.

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

После создания и настройки классов, наследуемых от System.ComponentModel.Component (например ServerFileReport), в области созданного кода конструктора в нижней части формы в представлении "Конструктор" появится значок созданного класса.

В нижней части режима проектирования появится объект serverFileReport1.

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

В этой области инициализируется и настраивается класс ServerFileReport.

5. Внутри метода ConfigureCrystalReports() (созданного при настройке проекта) назначьте экземпляр ServerFileReport свойству ReportSource элемента управления CrystalReportViewer.

myCrystalReportViewer.ReportSource = serverFileReport crystalReportViewer.ReportSource = serverFileReport1;

Следующие шаги Для просмотра отчета постройте и запустите свой проект.

Предпосылки Установлена программа SAP Crystal Reports для Visual Studio 2003, а также проверена ее работоспособность.

Или установлена программа SAP Crystal Reports 9 или более поздняя версия, а также проверена ее работоспособность.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. Внутри метода ConfigureCrystalReports() (созданного при настройке проекта) объявите экземпляр ServerFileReport.

Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _ New CrystalDecisions.Shared.ServerFileReport() CrystalDecisions.Shared.ServerFileReport serverFileReport = new CrystalDecisions.Shared.ServerFileReport();

2. Установите для свойства ObjectType элемента ServerFileReport значение REPORT.

myServerFileReport.ObjectType = CrystalDecisions.

[Shared].EnumServerFileType.REPORT serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;

3. Установите для свойства ReportPath элемента ServerFileReport отчет и его подкаталог.

myServerFileReport.ReportPath = "\General Business\World Sales Report.rpt" serverFileReport.ReportPath = "\\General Business\\World Sales Report.rpt";

4. Установите для свойства WebServiceURL элемента ServerFileReport виртуальный каталог средства просмотра для текущей установленной версии SAP Crystal Reports.

В этом примере кода виртуальный каталог средства просмотра настроен для программы SAP Crystal myServerFileReport.WebServiceUrl = "http://localhost/crystalreportviewers10/ ServerFileReportService.asmx" serverFileReport.WebServiceUrl = "http://localhost/crystalreportviewers10/ ServerFileReportService.asmx";

5. Задайте свойство ReportSource элемента управления CrystalReportViewer экземпляру ServerFileReport.

myCrystalReportViewer.ReportSource = myServerFileReport crystalReportViewer.ReportSource = serverFileReport1;

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 2003) Данный сценарий связывания относится к прежней технологии и предназначен для пользователей, у которых на данный момент установлен Crystal Enterprise. Приложение Crystal Enterprise заменено приложением SAP Crystal Reports Server и платформой SAP BusinessObjects Business Intelligence.

Объектная модель В этом сценарии связывания отчетов используется CrystalReportViewer (см. раздел Связывание отчетов с объектной моделью CrystalReportViewer [стр. 174]).

Расположение отчетов Отчет расположен на сервере Web Component Server (сервере веб-компонентов) в программе Crystal Enterprise версии 8, 8.5, 9 или 10. Отчеты с сервера веб-компонентов обрабатываются как веб-службы отчетов с помощью веб-службы EnterpriseReportService.asmx. Эта веб-служба расположена в виртуальном каталоге средств просмотра на сервере веб-компонентов.

В этом разделе рассматривается вложенный узел Crystal Enterprise служб Crystal Services в среде Visual Studio.NET 2003.

[SERVERNAME] Службы Crystal Описание Вложенный узел Crystal Enterprise получает доступ к отчетам, обработанным в качестве веб-служб отчетов с сервера веб-компонентов, а затем отображает их.

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide На сервере, просматриваемом в данный момент в Server Explorer, запущена программа Crystal Enterprise 8 или 8.5.

Если требуется соединиться с приложением Crystal Enterprise 9 или более поздней версии, SAP Crystal Reports для Visual Studio 2003 необходимо обновить до SAP Crystal Reports Developer (версии WCS (сервер веб-компонентов) программы Crystal Enterprise установлен на сервере Crystal Enterprise.

Сервер веб-компонентов по умолчанию установлен в программах Crystal Enterprise 9 и 10. В программах Crystal Enterprise 8 и 8.5 сервер веб-компонентов необходимо устанавливать отдельно.

Чтобы настроить веб-службы отчетов на сервере Crystal Enterprise 10, необходимо установить Visual Studio.NET 2003 на сервере Crystal Enterprise, а затем запустить пользовательскую установку специально для добавления служб Crystal Services.

Если администратор Crystal Enterprise не хочет устанавливать полную версию Visual Studio.NET на сервере Crystal Enterprise, он может вместо этого выполнить следующие действия:

Установить управляемый модуль объединения.msm.

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

После успешного отображения отчетов в службах Crystal Services выберите отчет и перетащите его в вебформу или форму Windows. После перетаскивания на форму отчет переносится в класс-обертку отчета, а затем отображается в виде экземпляра отчета в лотке компонентов.

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

Установка служб Crystal Services Службы Crystal Services не устанавливаются по умолчанию во время установки Visual Studio.NET 2003.

Для добавления служб Crystal Services загрузите установочный компакт-диск Microsoft Visual Studio.NET, перейдите к программе SAP Crystal Reports, выберите веб-службы Crystal Web Services и нажмите кнопку обновления.

Преимущества Легкий доступ к отчетам Crystal Enterprise из веб-приложения или приложения Windows.

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

В программах SAP Crystal Reports 9 и 10 службы Crystal Services обновлены до другого классаобертки и протокола соединения.

Связанные сведения Каталог средств просмотра [стр. 14] Использование службы Crystal Services [стр. 86] Установка связи с серверными файлами (Visual Studio 2005 и более поздние версии) [стр. 192] 1.4.5.3.1.5.2.1 Получение доступа к службам Crystal Services>Crystal Enterprise в Server Explorer Процедура 1. В меню Видвыберите пункт Другие окна, а затем Server Explorer.

2. Если сервер Crystal Enterprise расположен на компьютере, отличном от локального (рекомендуется):

a) Щелкните правой кнопкой мыши элемент Серверы и выберите команду Добавить сервер...

b) В диалоговом окне Добавление сервера в поле Компьютеры введите сетевое имя сервера Crystal Enterprise, а затем нажмите кнопку ОК.

c) В узле Серверы разверните вложенный узел нового добавленного сервера, а затем внутри него разверните вложенный узел Службы Crystal Services.

d) В диалоговом окне Вход в Enterprise введите значения в поля Имя пользователя и Пароль, а затем 3. Если сервер Crystal Enterprise расположен на локальном компьютере:

a) В узле Серверы разверните вложенный узел локального компьютера, а затем внутри него разверните вложенный узел Службы Crystal Services.

b) В диалоговом окне Вход в Enterprise введите значения в поля Имя пользователя и Пароль, а затем Результаты Все готово для настройки служб Crystal Services>Crystal Enterprise в веб-проекте или проекте Windows.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.5.3.1.5.2.2 Настройка отчета Crystal Services>Crystal Enterprise Предпосылки Данная процедура работает только с проектами, созданными из Настройка проекта [стр. 16]. Настройка проекта включает специальные ссылки на пространство имен и конфигурацию кода, необходимую для выполнения данной процедуры. Выполнение процедуры без этой конфигурации невозможно.

Процедура 1. Выберите отчет во вложенном узле Crystal Enterprise и перетащите его на веб-форму или форму В нижней части формы в лотке компонентов появится объект enterpriseReport1.

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

В этой области инициализирован и настроен класс EnterpriseReport.

3. Внутри метода ConfigureCrystalReports() (созданного в разделе Настройка проекта [стр. 16]) назначьте экземпляр EnterpriseReport свойству ReportSource элемента управления CrystalReportViewer.

myCrystalReportViewer.ReportSource = enterpriseReport crystalReportViewer.ReportSource = enterpriseReport1;

4. Для просмотра отчета постройте и запустите свой проект.

1.4.5.3.1.5.3 Установка связи с серверными файлами (Visual Studio 2005 и более поздние версии) Объектная модель В этом сценарии связывания отчетов используется объектная модель CrystalReportViewer.

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

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

Описание Веб-служба Server Files получает доступ к отчетам, предоставленным в качестве веб-служб отчетов из локального каталога, а затем отображает их. В Visual Studio 2005 и более поздних версиях доступ к серверным файлам предоставляется программными средствами.

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

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

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Связанные сведения Настройка файлов сервера в Visual Studio 2005 и более поздних версий [стр. 90] 1.4.5.3.1.5.3.1 Кодирование серверных файлов вручную Предпосылки Веб-служба отчетов, предоставляющая доступ к серверным файлам с помощью программных средств, настроена, а также проверена ее работоспособность.

Или – программа SAP Crystal Reports Developer установлена, а также проверена ее работоспособность.

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

Процедура 1. Внутри метода ConfigureCrystalReports() (созданного в разделе Настройка проекта [стр. 16]) объявите экземпляр ServerFileReport.

Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _New CrystalDecisions.Shared.ServerFileReport() CrystalDecisions.Shared.ServerFileReport serverFileReport = new CrystalDecisions.Shared.ServerFileReport();

2. Установите для свойства ObjectType элемента ServerFileReport значение REPORT.

myServerFileReport.ObjectType = CrystalDecisions.

[Shared].EnumServerFileType.REPORT serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;

3. Задайте для свойства ReportPath элемента ServerFileReport отчет и его подкаталог.

myServerFileReport.ReportPath = "\General Business\World Sales © 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide serverFileReport.ReportPath = "\\General Business\\World Sales Report.rpt";

4. Задайте для свойства WebServiceURL отчета ServerFileReport расположение веб-службы отчетов.

Если установлен выпуск SAP Crystal Reports Developer, данное свойство будет использоваться в качестве виртуального каталога средства просмотра для текущей установленной версии программы SAP Crystal Reports; дополнительные сведения см. в разделе Каталог средств просмотра [стр. 14]. Если программа SAP Crystal Reports Developer не установлена, данное свойство будет использоваться в качестве URL-адреса веб-службы отчетов, созданной в разделе Настройка файлов сервера в Visual Studio 2005 и более поздних версий [стр. 90].

В приведенном ниже коде виртуальный каталог средства просмотра настроен для программы SAP Crystal Reports для Visual Studio 2005.

myServerFileReport.WebServiceUrl = "http://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx" serverFileReport.WebServiceUrl = "http://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx";

5. Задайте свойство ReportSource элемента управления CrystalReportViewer экземпляру ServerFileReport.

myCrystalReportViewer.ReportSource = myServerFileReport crystalReportViewer.ReportSource = serverFileReport1;

1.4.5.3.1.5.4 Привязка к SAP Crystal Reports Server или платформе SAP BusinessObjects Business Intelligence (Visual Studio) Объектная модель В этом сценарии связывания отчетов используется CrystalReportViewer (см. раздел Связывание отчетов с объектной моделью CrystalReportViewer [стр. 174]).

Расположение отчетов Отчет располагается на сервере веб-компонентов (WCS) в SAP Crystal Reports Server или на платформе SAP BusinessObjects Business Intelligence. Отчеты с сервера веб-компонентов обрабатываются как вебSAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide службы отчетов с помощью веб-службы EnterpriseReportService.asmx. Эта веб-служба расположена в виртуальном каталоге средств просмотра на сервере веб-компонентов.

В этом разделе рассматривается вложенный узел "Службы SAP Crystal Reports" служб Crystal Services в среде Visual Studio.

[SERVERNAME] Службы SAP Crystal Reports Описание Подузел платформы SAP BusinessObjects Business Intelligence обращается к отчетам, которые были предоставлены веб-службами отчетов с сервера WCS платформы SAP BusinessObjects Business Intelligence, и отображает их.

Чтобы корректно отображать список доступных отчетов с сервера WCS платформы SAP BusinessObjects Business Intelligence в подузле платформы SAP BusinessObjects Business Intelligence, необходимо соблюдать следующие условия.

На сервере, который вы просматриваете в окне "Проводник сервера", должна выполняться платформа SAP BusinessObjects Business Intelligence.

Для настройки веб-служб отчетов на платформе SAP BusinessObjects Business Intelligence необходимо установить среду Visual Studio на сервер платформы SAP BusinessObjects Business Intelligence и повторно запустить выборочную установку для добавления служб Crystal.

Для правильной установки и настройки файла EnterpriseReportService.asmx в пределах виртуального каталога средств просмотра требуется установка среды Visual Studio на сервере платформы SAP BusinessObjects Business Intelligence, а также выборочная установка служб Crystal.

Если администратору Crystal Enterprise не требуется устанавливать полную версию среды Visual Studio на сервер платформы SAP BusinessObjects Business Intelligence, вместо этого можно выполнить следующие действия:

Установить управляемый модуль объединения.msm.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide После успешного отображения отчета в службах SAP BusinessObjects Services можно установить связь элемента управления CrystalReportsViewer с любым из перечисленных отчетов. Дополнительные сведения см. в документации по платформе SAP BusinessObjects Business Intelligence.

Преимущества Удобный доступ к отчетам платформы SAP BusinessObjects Business Intelligence из веб-приложений или приложений Windows.

В программах SAP Crystal Reports 9 и 10 службы Crystal Services обновлены до другого классаобертки и протокола соединения.

Связанные сведения Каталог средств просмотра [стр. 14] Использование службы Crystal Services [стр. 86] Выбор правильной объектной модели для проекта [стр. 32] 1.4.5.3.1.5.4.1 Установка связи с путем к каталогу при помощи окна "Свойства" Процедура 1. Создайте новый веб-проект или проект Windows.

2. Из панели инструментов перетащите элемент управления CrystalReportViewer на веб-форму или форму Windows.

3. Щелкните элемент управления CrystalReportViewer, чтобы выделить его.

4. В окне Свойства назначьте строку пути к каталогу свойству ReportSource.

Путь к каталогу указывает на образцы отчетов в Visual Studio 2005.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Из-за функции предварительного просмотра во время проектирования отчет отображается в режиме предварительного просмотра.

1.4.5.3.1.6 Установка связи с ReportSource (SAP Crystal Reports Server или SAP BusinessObjects Enterprise 11) На этой странице описаны функции, недоступные в версии SAP Crystal Reports для разработчиков Microsoft Visual Studio, но содержащиеся в одной из обновленных версий.

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

Расположение отчетов Доступ к отчетам осуществляется с сервера страниц на платформе SAP BusinessObjects Business Intelligence.

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

Класс ReportSource не связан с объектной моделью. Если необходимо изменить параметры или установки базы данных, можно воспользоваться ограниченной объектной моделью, поставляемой с элементом управления CrystalReportViewer. Однако для полноценного программного изменения отчета требуется использовать другой сценарий привязки отчетов SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

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

Преимущества Максимальное быстродействие. Обеспечивает лучшую производительность при отображении отчета из приложения SAP Crystal Reports Server или с платформы SAP BusinessObjects Business Intelligence.

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

Ограниченная доступность: этот сценарий доступен только в Crystal Enterprise версии 10, SAP Crystal Reports Server или SAP BusinessObjects Enterprise XI.

Связанные сведения Связывание отчетов с объектной моделью ReportDocument [стр. 203] 1.4.5.3.1.6.1 Привязка элемента управления CrystalReportViewer к отчету, который обслуживается сервером страниц SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence Предпосылки Выполнена установка и проверка работоспособности приложения SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence.

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Выполнена установка и проверка работоспособности пакета SDK для SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence (включая сборки.NET).

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

Процедура 1. Найдите и запишите имя сервера SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence. В данном примере для сервера выбрано имя "BOE01".

a) Чтобы узнать имя сервера, щелкните правой кнопкой мыши значок "Мой компьютер" и выберите b) В диалоговом окне "Свойства системы" перейдите на вкладку "Сетевая идентификация".

c) Имя компьютера отображено в поле "Полное имя компьютера".

2. Для публикации файла Chart.rpt на сервере SAP Crystal Reports Server или платформы SAP BusinessObjects Business Intelligence используйте мастер публикации.

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

3. Добавьте в проект ссылки на следующие сборки:

CrystalDecisions.Enterprise.Framework CrystalDecisions.Enterprise.InfoStore CrystalDecisions.Enterprise.Viewing.ReportSource CrystalDecisions.ReportAppServer.Controllers 4. В меню Вид выберите пункт Код для просмотра класса code-behind для этой веб-формы или формы Windows. Над классом добавьте оператор "Imports" [Visual Basic] или "using" [C#] для пространства имен CrystalDecisions.Enterprise.

Imports CrystalDecisions.Enterprise Imports CrystalDecisions.Enterprise.Viewing Imports CrystalDecisions.ReportAppServer.Controllers using CrystalDecisions.Enterprise;

using CrystalDecisions.Enterprise.Viewing;

using CrystalDecisions.ReportAppServer.Controllers;

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.5.3.1.6.2 Вход в программу SAP Crystal Reports Server или SAP BusinessObjects Enterprise Процедура 1. Внутри метода ConfigureCrystalReports() (созданного в разделе Настройка проекта [стр. 16]) объявите строковую переменную serverName и задайте ей имя сервера SAP Crystal Reports Server или SAP BusinessObjects Enterprise.

Dim serverName As String = "BOE01" string serverName = "BOE01";

2. Объявите и инициализируйте класс SessionMgr.

Dim mySessionMgr As SessionMgr = New SessionMgr() SessionMgr sessionMgr = new SessionMgr();

3. Передайте имя пользователя (Administrator), пароль (пустой), переменную serverName и тип входа в систему (secEnterprise) методу Logon экземпляра SessionMgr и извлеките его как экземпляр EnterpriseSession.

Dim myEnterpriseSession As EnterpriseSession = mySessionMgr.Logon( _ "Administrator", "", serverName, "secEnterprise") EnterpriseSession enterpriseSession = sessionMgr.Logon( "Administrator", "", serverName, "secEnterprise");

4. Извлеките службу InfoStore (как EnterpriseService) из метода GetService объекта EnterpriseSession.

Dim myEnterpriseService As EnterpriseService = _ myEnterpriseSession.GetService("InfoStore") EnterpriseService enterpriseService = enterpriseSession.GetService("InfoStore");

5. Объявите и инициализируйте InfoStore и передайте извлеченную службу EnterpriseService в качестве параметра в InfoStore.

Dim myInfoStore As InfoStore = New InfoStore(myEnterpriseService) InfoStore infoStore = new InfoStore(enterpriseService);

Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.5.3.1.6.3 Извлечение отчета иерархической группировки из программы SAP Crystal Reports Server или SAP BusinessObjects Enterprise Процедура 1. Чтобы переназначить значение экземпляра EnterpriseService вспомогательной службе отчетов сервера страниц, передайте строку "PSReportFactory" методу GetService() объекта EnterpriseService.

myEnterpriseService = myEnterpriseSession.GetService("PSReportFactory") enterpriseService = enterpriseSession.GetService("PSReportFactory");

2. Возвратите свойство Interface объекта EnterpriseService как объектную переменную.

Dim psrfObject As Object = myEnterpriseService.Interface Object psrfObject = enterpriseService.Interface;

3. Приведите объектную переменную к экземпляру PSReportFactory.

Dim myPSReportFactory As PSReportFactory = CType(psrfObject, PSReportFactory) PSReportFactory psReportFactory = (PSReportFactory)psrfObject;

4. Введите строку запроса к серверу SAP Crystal Reports Server или SAP BusinessObjects Enterprise для получения отчета.

Dim queryString As String = "Select SI_ID, SI_NAME, SI_PARENTID From CI_INFOOBJECTS " _ string queryString = "Select SI_ID, SI_NAME, SI_PARENTID From CI_INFOOBJECTS " + "Where SI_PROGID='CrystalEnterprise.Report' " + "And SI_NAME Like 'Chart'";

5. Передайте строку запроса методу Query объекта InfoStore, чтобы извлечь индексированный класс InfoObjects, содержащий результат запроса.

Dim myInfoObjects As InfoObjects = myInfoStore.Query(queryString) InfoObjects infoObjects = infoStore.Query(queryString);

6. Извлеките InfoObject из первого столбца индексированного класса InfoObjects.

Dim myInfoObject As InfoObject = myInfoObjects(1) InfoObject infoObject = infoObjects[1];

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 7. Объявите и заполните экземпляр ReportSource из метода OpenReportSource() экземпляра PSReportFactory путем передачи свойства ID объекта InfoObject.

Dim myReportSource As ReportSource = myPSReportFactory.OpenReportSource(myInfoObject.ID) ReportSource reportSource = psReportFactory.OpenReportSource(infoObject.ID);

8. Установите связь экземпляра ReportSource со свойством ReportSource элемента управления CrystalReportViewer.

myCrystalReportViewer.ReportSource = myReportSource crystalReportViewer.ReportSource = reportSource;

9. Для просмотра отчета постройте и запустите свой проект.

Отчет отобразится на сервере страниц в пределах программы SAP Crystal Reports Server или SAP BusinessObjects Enterprise на основе его идентификатора. При использовании альтернативного метода получения доступа к reportID (например выборе идентификатора со списка отчетов системы управления DropDownList) не понадобится запрашивать хранилище InfoStore и создавать объект InfoObject для извлечения reportID.

1.4.5.3.2 Связывание отчетов с объектной моделью ReportDocument Объектная модель ReportDocument является более эффективной моделью, входящей в состав версии SAP Crystal Reports для разработчиков Microsoft Visual Studio. Именно эту объектную модель рекомендуется использовать при разработке проектов в версии SAP Crystal Reports для разработчиков Microsoft Visual Studio.

1.4.5.3.2.1 Связывание с классом встроенных отчетов Объектная модель В этом сценарии связывания отчетов используется объектная модель ReportDocument.

Расположение отчетов Отчеты встраиваются в проект.

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

Описание В этом сценарии отчет встраивается в проект. Для встраивания отчета можно создать новый отчет со встроенным конструктором SAP Crystal Reports (который содержится в Visual Studio) или импортировать существующий отчет в проект. При создании или встраивании отчета для его представления автоматически создается класс-обертка отчета. Имя класса-обертки совпадает с именем отчета. Он выводится из базового класса ReportDocument и поэтому наследует все свойства и методы ReportDocument, что делает его частью объектной модели ReportDocument.

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

Широкое программное взаимодействие: обеспечение доступа к мощной объектной модели ReportDocument.

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

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

1.4.5.3.2.1.1 Привязка класса встроенного отчета Контекст При создании или встраивании отчета для его представления автоматически создается класс-обертка отчета. Имя класса-обертки совпадает с именем отчета. Он выводится из базового класса ReportDocument и поэтому наследует все свойства и методы ReportDocument, что делает его частью объектной модели ReportDocument.

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide Процедура 1. Добавьте к форме Windows элемент управления CrystalReportViewer.

Все версии SAP Crystal Reports поддерживают привязку к классу встроенного отчета для приложений Windows. Некоторые конфигурации предоставляют поддержку для данного сценария привязки для веб-сайтов посредством улучшенного поставщика построений.

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

3. Создайте экземпляр класса-обертки отчета.

Dim myReport As New QuarterlySalesReport() QuarterlySalesReport myReport = new QuarterlySalesReport();

4. Назначьте его свойству ReportSource элемента управления CrystalReportViewer.

myCrystalReportViewer.ReportSource = myReport crystalReportViewer.ReportSource = myReport;

1.4.5.3.2.2 Установка связи с невстроенным отчетом, загруженным в класс ReportDocument Объектная модель В этом сценарии связывания отчетов используется объектная модель ReportDocument.

Расположение отчетов Отчеты расположены в каталоге файлов.

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

В Установка связи с путем к каталогу в коде [стр. 174] устанавливается связь с отчетами по их строкам пути к каталогу; однако вместо непосредственного связывания путей к каталогу со средством просмотра они передаются в метод ReportDocument.Load(). Благодаря этому возможно использование объектной модели ReportDocument.

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

Преимущества Небольшие затраты на обслуживание: отчеты можно добавлять, удалять или изменять без перекомпиляции приложения.

Широкое программное взаимодействие: обеспечение доступа к мощной объектной модели ReportDocument.

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

Недостатки Ограниченное распространение: отчеты должны находиться на том же компьютере, что и приложение.

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

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

© 2014 SAP AG или аффилированная компания SAP. Все права Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide 1.4.5.3.2.2.1 Установка связи с невстроенным отчетом при помощи объектной модели ReportDocument Предпосылки Данная процедура работает только с проектами, созданными из Настройка проекта [стр. 16]. Настройка проекта включает специальные ссылки на пространство имен и конфигурацию кода, необходимую для выполнения данной процедуры. Выполнение процедуры без этой конфигурации невозможно.

Процедура 1. Добавьте оператор "Imports" [Visual Basic] или "using" [C#] в верхней части класса для пространства имен CrystalDecisions.CrystalReports.Engine.

Объявление этого пространства имен требуется для доступа к классу ReportDocument без префикса пространства имен.

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

2. Перейдите к файлу World Sales Report.rpt в подкаталоге General Business для конкретной версии программы SAP Crystal Reports.

3. Скопируйте в буфер обмена полный путь к каталогу, включая файл World Sales Report.rpt.

4. Внутри метода ConfigureCrystalReports() (созданного в разделе Настройка проекта [стр. 16]) объявите строковую переменную reportPath и назначьте строку с путем к каталогу World Sales Report, скопированную на предыдущем этапе.

Dim reportPath As String = _ "C:\Program Files\Microsoft Visual Studio 9.0\" _ & "Crystal Reports\Samples \En\Reports\General Business\" _ & "World Sales Report.rpt" string reportPath = "C:\\Program Files\\Microsoft Visual Studio 9.0\\" + "Crystal Reports\\Samples \\En\\Reports\\General Business\\" + "World Sales Report.rpt";

5. Под объявлением строки объявите экземпляр ReportDocument.

Dim myReportDocument As ReportDocument = New ReportDocument() Руководство SAP Crystal Reports для Visual Studio.NET SDK Developer Guide ReportDocument reportDocument = new ReportDocument();

6. Загрузите строковую переменную, содержащую путь к невстроенному отчету, в ReportDocument.

myReportDocument.Load(reportPath) reportDocument.Load(reportPath);

7. Назначьте экземпляр ReportDocument (содержащий на данный момент загруженный невстроенный отчет) свойству ReportSource элемента управления CrystalReportViewer.

myCrystalReportViewer.ReportSource = myReportDocument crystalReportViewer.ReportSource = reportDocument;

8. Для просмотра отчета постройте и запустите свой проект.

1.4.5.3.2.3 Связывание с классом кэшированных встроенных отчетов Объектная модель В этом сценарии связывания отчетов используется объектная модель ReportDocument.

Расположение отчетов Отчеты встраиваются в проект.

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

В данном сценарии элемент управления CrystalReportViewer связывается с классом утилит управления кэш-памятью, благодаря чему автоматически обрабатывается кэширование отчетов в объекте ASP.NET Cache.

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

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

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

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

Недостатки Большая нагрузка на сервер: отчеты, остающиеся в объекте ASP.NET Cache, могут создавать нагрузку на ресурсы памяти сервера.

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

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

Pages: | 1 | ... | 2 | 3 |

| 5 | 6 | ... | 17 |

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

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

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

«2.4. Работодатель должен предоставлять другой стороне имеющуюся у него информацию, необходимую для ведения коллективных переговоров. 2.5. Представители сторон обязуются в ходе переговоров с пониманием относиться к доводам друг друга; внимательно выслушивать их, совместно искать возможные решения, позволяющие максимально удовлетворять интересы сторон. 2.6. В ходе переговоров представители от каждой стороны вправе прерывать заседания, проводить консультации, экспертизы, запрашивать необходимые...»

«ТОМ СТО ШЕСТЬДЕСЯТ ПЕРВЫЙ МОСКВА 2012 г. ИЗДАЕТСЯ с 1766 г. Вольное экономическое общество России Научные труды ВЭО России XV ВСЕРОССИЙСКИЙ КОНКУРС НАУЧНЫХ РАБОТ МОЛОДЕЖИ ЭКОНОМИЧЕСКИЙ РОСТ РОССИИ 2012 г. При реализации проекта Всероссийский конкурс научных работ молодежи Экономический рост России используются средства государственной поддержки, выделенные в качестве гранта Фондом подготовки кадрового резерва Государственный клуб по итогам конкурса, проведенного в соответствии с распоряжением...»

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

«Плата за природопользование: значение, состояние вопроса и перспективы П.В.Касьянов Оглавление рентных факторов в платном природопользовании и в экономике России в 1.Роль целом 1.1.Введение 1.2. Природный капитал в составе национального богатства 1.3. Доля платежей за природопользование в доходах бюджета 2. Действующая система платежей за природопользование 2.1. Краткая характеристика и выборочная статистика. 2.2 Налог на добычу полезных ископаемых 2.3. Платежи за пользование лесным фондом 2.4....»

«ЦЕНТР ПЕТЕРБУРГСКОЕ ВОСТОКОВЕДЕНИЕ ® m.v VII Серия основана в 1993 году ЦЕНТР 'ПЕТЕРБУРГСКОЕ ВОСТОКОВЕДЕНИЕ' Российская Академия наук Институт востоковедения Санкт-Петербургский филиал Тексты Кумрана Введение, перевод с древнееврейского и арамейского и комментарии А. М. Газова-Гинзберга, М. М. Елизаровой и К. Б. Старковой Санкт-Петербург 1996 ББК Ш161—011 Т 30 Утверждено к печати Ученым советом Санкт-Петербургского филиала Института востоковедения РАН Серия Памятники культуры Востока...»

«УДК 330.4+338.3+ 51-77 Е.Ю. Лискина НЕКОТОРЫЕ МАТЕМАТИЧЕСКИЕ МОДЕЛИ НАЛОГОВ И СБОРОВ В РОССИИ В статье проанализированы модели налога на добавленную стоимость и налогов и сборов с доходов физического лица в Российской Федерации. Получена реальная зависимость ставки налогового бремени от величины заработной платы. Приведены расчетные примеры. Выявлены следующие противоречия в существующем налоговом законодательстве: способ возмещения налога на добавленную стоимость; ставка налогового бремени...»

«СПРАВОЧНИК ДЛЯ ИНВЕСТОРОВ В МОЛДАВСКИЙ АГРАРНЫЙ СЕКТОР С ВЫСОКОЙ ДОБАВЛЕННОЙ СТОИМОСТЬЮ Проект Конкурентоспособность сельского хозяйства и развитие предприятий Май, 2012 1 Данный справочник был разработан консалтинговой компанией BIS по контракту с Проектом Конкурентоспособность сельского хозяйства и развитие предприятий (ACED) с сентября по декабрь 2011 года. Цель документа - привлечь отечественных и иностранных инвесторов в молдавское сельское хозяйство с высокой стоимостью (СХВС). Справочник...»

«Министерство образования и науки Российской Федерации Ярославский государственный университет им. П. Г. Демидова ОЧЕРКИ ПО ТОРГОВОМУ ПРАВУ Сборник научных трудов Под редакцией кандидата юридических наук Е. А. Крашенинникова Выпуск 18 Ярославль 2011 1 УДК 347.7 (06) ББК Х 623я43 О 95 Рекомендовано Редакционно-издательским советом университета в качестве научного издания. План 2010/2011 года Очерки по торговому праву : сб. науч. тр. / под ред. О 95 Е. А. Крашенинникова ; Яросл. гос. ун-т им. П....»

«МЕСТНОЕ САМОУПРАВЛЕНИЕ Г. ТАГАНРОГ РОСТОВСКОЙ ОБЛАСТИ ГОРОДСКАЯ ДУМА ГОРОДА ТАГАНРОГА РЕШЕНИЕ 26.05.2011 № 303 Об утверждении отчета об исполнении бюджета муниципального образования Город Таганрог за 2010 год В соответствии со статьей 21 Устава муниципального образования Город Таганрог, Решением Городской Думы от 29.09.2005 № 117 Об утверждении Положения О порядке проведения публичных слушаний в городе Таганроге, Решением Городской Думы от 26.05.2011 № 302 Об утверждении результатов публичных...»

«КаК упаКовать бизнес под франчайзинг практики и рекомендации Демонстрационная версия 2011 г. Оглавление Введение Франчайзинг как бизнес-модель Отраслевая и географическая структура рынка франчайзинга в мире и РФ Глобальные тенденции франчайзинга и специфика развития франчайзинга в РФ. 11 Модели построения франчайзинговой сети Система мотивации франчайзи Франшизоспособность бизнеса Критерии оценки франшизоспособности бизнеса Оценка целесообразности развития по франчайзингу Как упаковать бизнес...»

«Приложение № 1 УТВЕРЖДАЮ: /Волкова М.И./ Председатель Закупочной комиссии 02 июля 2013 года Согласовано на заседании Закупочной комиссии Протокол № П 17-1 от 02 июля 2013 года ДОКУМЕНТАЦИЯ ПО ОТКРЫТОМУ ЗАПРОСУ ПРЕДЛОЖЕНИЙ на право заключения Договора на оказание услуг по проведению предварительных и периодических медицинских осмотров работников ЗАО Петроэлектросбыт. Санкт-Петербург 2013 г. Содержание ОБЩИЕ ПОЛОЖЕНИЯ 1. 1.1 Общие сведения о процедуре запроса предложений 1.2 Правовой статус...»

«Фонд поддержки творческих инициатив студентов П о с в я щ а е т с я 6 5 -л е т и ю ОКБ имени Артема Ивановича Микояна ПРОБЛЕМЫ СОЗДАНИЯ ПЕРСПЕКТИВНОЙ АВИАЦИОННОЙ ТЕХНИКИ - 2004 УДК 629.735.33 Проблемы создания перспективной авиационной техники. Сборник статей научно – исследовательских, проектно-конструкторских и технологических работ студентов, молодых ученых и инженеров. / под ред. проф. Ю.Ю. Комарова, В.А. Мхитаряна, Р.Д. Лисина. - М.: Изд-во МАИ, 2004. - с.: ил. В сборнике содержатся статьи...»

«Челябинская область приступает к модернизации образования 02.08.2011 - 14:23 В Челябинской области стартует проект по комплексной модернизации системы общего образования, реализация которого позволит создать соответствующие всем современным требованиям условия обучения. В рамках проекта запланировано повышение заработной платы учителей, развитие материально-технической базы школ, решение проблем малокомплектных школ в сельской местности, модернизация базовых школ и создание центров...»

«МЕЖОТРАСЛЕВОЙ КАТАЛОГ ПРОМЫШЛЕННАЯ ЭКОЛОГИЯ-2011 Межотраслевой каталог для специалистов промышленных предприятий поможет найти актуальную информацию о ведущих производителях экологического оборудования, ООО ИНТЕХЭКО проектных и инжиниринговых компаниях, имеющих www.intecheco.ru реальный опыт решения различных экологических задач в промышленности, газоочистки, пылеулавливания, водоподготовки и водоочистки, переработки отходов, экологического мониторинга и охраны окружающей среды. МЕЖОТРАСЛЕВОЙ...»

«ПРОЕКТ СТРАТЕГИЯ СОЦИАЛЬНО-ЭКОНОМИЧЕСКОГО РАЗВИТИЯ КАЛИНИНГРАДСКОЙ ОБЛАСТИ НА СРЕДНЕ- И ДОЛГОСРОЧНУЮ ПЕРСПЕКТИВУ 2 СОДЕРЖАНИЕ РАЗДЕЛ ХАРАКТЕРИСТИКА СОЦИАЛЬНОЭКОНОМИЧЕСКОГО I. 4 ПОЛОЖЕНИЯ КАЛИНИНГРАДСКОЙ ОБЛАСТИ Глава 1. Общая оценка ситуации 4 Глава 2. Характеристика основных отраслей 6 Глава 3. Характеристика человеческого капитала и отраслей социальной сферы 53 Глава 4. Государственное управление и гражданское общество Глава 5. Приграничное сотрудничество Раздел II. ВНЕШНИЙ КОНТЕКСТ СТРАТЕГИИ...»

«56-IVВ-23,24-ПЗ ООО Общество с ограниченной ответственностью ССП СибирьСпецПроект 630007, РФ г. Новосибирск, ИНН 5407472630, КПП 540701001 ул. Коммунистическая, 1. р/сч. 40702810302010000231 в Новосибирском филиале ОАО ОТП БАНК т/факс 346-05-07, тел. 346-49-89 г. Новосибирска, к./счет 30101810900000000798, БИК 045005798 [email protected] Проект планировки территории и проект межевания территории кварталов №23, 24 Восточного планировочного района (IV очередь строительства) города Нижневартовска...»

«РОССИЙСКАЯ ФЕДЕРАЦИЯ ПРАВИТЕЛЬСТВО КАЛИНИНГРАДСКОЙ ОБЛАСТИ ПОСТАНОВЛЕНИЕ 12 декабря 2012 года № 970 г. Калининград О согласовании проекта схемы территориального планирования муниципального образования Полесский муниципальный район В соответствии с частью 2 статьи 21 Градостроительного кодекса Российской Федерации, частью 10 статьи 11 Федерального закона от 20 марта 2011 года № 41-ФЗ О внесении изменений в Градостроительный кодекс Российской Федерации и отдельные законодательные акты Российской...»

«УТВЕРЖДЕНА Приказом Генерального директора ОАО Гратис №01/10 ГР-ОД от 19 ноября 2010 г. ПРОЕКТНАЯ ДЕКЛАРАЦИЯ по объекту капитального строительства: Многоэтажный жилой комплекс с объектами социальной и инженерной инфраструктуры (первая очередь строительства микрорайона №9 г.п. Одинцово Московской области) (по состоянию на 19 ноября 2010 года) Информация о застройщике объекта капитального строительства: Многоэтажный жилой комплекс с объектами социальной и инженерной инфраструктуры (первая очередь...»

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

«САНИТАРНЫЕ НОРМЫ, ПРАВИЛА И ГИГИЕНИЧЕСКИЕ НОРМАТИВЫ РЕСПУБЛИКИ УЗБЕКИСТАН САНИТАРНЫЕ ПРАВИЛА ДЛЯ ПРЕДПРИЯТИЙ ЧЕРНОЙ МЕТАЛЛУРГИИ СанПиН РУз № Издание официальное Ташкент – 2009 г. САНИТАРНЫЕ НОРМЫ, ПРАВИЛА И ГИГИЕНИЧЕСКИЕ НОРМАТИВЫ РЕСПУБЛИКИ УЗБЕКИСТАН УТВЕРЖДАЮ Главный Государственный санитарный врач Республики Узбекистан _ Б.И. НИЯЗМАТОВ 2009 г. САНИТАРНЫЕ ПРАВИЛА ДЛЯ ПРЕДПРИЯТИЙ ЧЕРНОЙ МЕТАЛЛУРГИИ СанПиН РУз № Издание официальное Несоблюдение санитарных норм, правил и гигиенических...»

наверх

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

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

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

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