Образец File Share Data Processing Extension

Изменения: 5 декабря 2005 г.

FsiDataExtension — это простой модуль обработки данных для файловой системы Windows. Образец пользуется для запроса содержимого любой общей сетевой папки классами DirectoryInfo и FileSystemInfo библиотеки Microsoft .NET Framework. Образец использует интерфейсы модуля обработки данных наряду с другими классами платформы .NET Framework. В этом образце применяется следующее соглашение об именах: префикс «Fsi» (сокращение от «File Share Information» — сведения об общей папке). Этот образец не поддерживается в операционных системах на платформе Itanium.

При установке SQL Server образцы автоматически не устанавливаются. Указания по установке образцов см. в разделе Установка образцов.

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

Требования

Для запуска образца FsiDataExtension необходимы навыки работы с Microsoft Visual Studio и языком Visual C# либо Microsoft Visual Basic. Кроме того, должно быть установлено следующее программное обеспечение:

• среда Microsoft Visual Studio 2005 или совместимая среда разработки (для просмотра файлов проекта);
• Microsoft SQL Server 2005, включая службы Reporting Services;
• платформа Microsoft .NET Framework версии 2.0;
• Образцы служб Reporting Services. Установку образцов можно выбрать в процессе установки SQL Server 2005. Для этого выпуска выбор установки образцов приводит к установке отдельной программы установки, которую можно запустить для извлечения и установки образцов. Установщик можно запустить из программной группы Microsoft SQL Server 2005, расположенной в меню Пуск;
• сервер отчетов, на доступ к которому имеется разрешение (если планируется использование образца расширения для добавления возможностей по обработке данных на сервере).

Расположение

Образец расположен в подкаталоге Extension Samples\FsiDataExtension Sample каталога образцов служб Reporting Services.

Например:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

Построение образца

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

Если файл ключа для строгого имени еще не создавался, создайте его следующим образом.

To generate a strong name key file

1. Откройте командную строку Microsoft Visual Studio 2005. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

   -- или --

   Откройте командную строку Microsoft .NET Framework. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

2. Используйте команду CD, чтобы сменить текущий каталог командной строки и перейти в каталог, в котором установлены образцы.

   Примечание.
   Чтобы определить каталог, в котором установлены образцы, нажмите кнопку Пуск, укажите пункты Все программы, Microsoft SQL Server, Документация и учебные материалы, а затем выберите пункт Каталог образцов. Если использовался каталог установки по умолчанию, то образцы расположены в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\100\Samples».

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

   sn -k SampleKey.snk

   Важно!
   Дополнительные сведения о паре ключей для строгого имени см. в статье по строгим именам и безопасности для платформы .NET Framework в центре разработчиков .NET в MSDN.

Компиляция образца с помощью пакета .NET Framework SDK

1. Скопируйте файл Microsoft.ReportingServices.Interfaces.dll из папки сервера отчетов \bin в папку с образцами.

2. Чтобы создать образец модуля обработки данных Microsoft.Samples.ReportingServices.FsiDataExtension.dll, выполните следующие команды:

   csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll
   

Компиляция образца при помощи среды Visual Studio .NET

1. Откройте файл решения FsiDataExtension (FsiDataExtensionCS.sln или FsiDataExtensionVB.sln) в среде Visual Studio 2005.

2. Выберите проект FsiDataExtension в обозревателе решений.

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

   Откроется диалоговое окно Добавление ссылок.

4. Перейдите на вкладку .NET.

5. Нажмите кнопку Обзор и найдите файл Microsoft.ReportingServices.Interfaces на локальном диске. По умолчанию сборка расположена в каталоге ReportServer\bin. Нажмите кнопку ОК.

   Выбранная ссылка будет добавлена в проект.

6. В меню Построить выберите пункт Построить решение.

Развертывание образца

После завершения предыдущих шагов библиотека Microsoft.Samples.ReportingServices.FsiDataExtension.dll может быть развернута на сервере отчетов или в конструкторе отчетов для использования в запущенных отчетах с пользовательскими источниками данных.

Развертывание образца

1. Скопируйте файл Microsoft.Samples.ReportingServices.FsiDataExtension.dll на сервер отчетов. Модули сервера отчетов по умолчанию находятся в папке «C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin».

2. Скопируйте сборку в конструктор отчетов. Модули конструктора отчетов по умолчанию находятся в папке «C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies».

3. Добавьте следующий пункт к файлам конфигурации RSReportServer.config и RSReportDesigner.config в элемент Data (по умолчанию файл RSReportDesigner.config располагается в каталоге «C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies», а файл RSReportServer.config — в каталоге «C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer»):

   <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
   

4. Чтобы включить обычный конструктор запросов для образца модуля обработки данных, добавьте следующую запись в файл RSReportDesigner.config в элемент <Designer>.

   <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
   

Дополнительные сведения о развертывании модулей обработки данных см. в разделе Deploying a Data Processing Extension.

Настройка защиты доступа к коду в данном образце

1. Откройте файл конфигурации политики сервера отчетов (rssrvpolicy.config). По умолчанию файл находится в папке «C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer».

2. Модулям обработки данных следует предоставлять полный уровень доверия. Для этого в конец раздела групп кода в файле конфигурации добавьте следующие данные:

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

3. Если образец модуля обработки данных используется в конструкторе отчетов, то повторите шаги 1 и 2, используя файл конфигурации предварительного просмотра политики конструктора отчетов (rspreviewpolicy.config) и следующую группу кода:

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

   Файл конфигурации rspreviewpolicy.config по умолчанию находится в папке «C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies».

   Дополнительные сведения по безопасности платформы .NET Framework и служб Reporting Services см. в разделе Understanding Code Access Security in Reporting Services.

Создание отчета, использующего модуль FsiDataExtension

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

Примечание.
Перед созданием отчета необходимо развернуть образец модуля обработки данных из общей папки в конструкторе отчетов и на сервере отчетов. Необходимо также разрешить использовать обычный конструктор запросов для данного модуля. Дополнительные сведения см. выше в подразделе «Развертывание модуля FsiDataExtension».

Создание проекта отчета

1. Нажмите кнопку Пуск, укажите пункт Все программы, затем Microsoft SQL Server 2005 и выберите пункт Среда Business Intelligence Development Studio.

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

3. В списке Типы проектов выберите Проекты бизнес-аналитики.

4. В списке Шаблоны выберите Проект сервера отчетов.

5. В поле Имя введите FsiReportProject.

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

Создание отчета

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

2. В списке Категории выберите Report Project.

3. В списке Шаблоны выберите Отчет.

4. В поле Имя введите текст FsiReport, а затем нажмите кнопку Добавить.

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

1. На вкладке «Данные» в списке Набор данных выберите пункт <Новый набор данных...>.

   Откроется диалоговое окно Источник данных.

2. На вкладке Общие в поле Имя введите текст FsiDataSource.

3. В списке Тип выберите Сведения об общей папке.

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

5. На вкладке Учетные данные выберите один из типов учетных записей сервера. Можно ввести имя пользователя и пароль для общей папки, к которой будет обращаться образец модуля обработки данных. Выберите пункт Использовать встроенную проверку подлинности Windows, затем выберите Указанное имя и пароль и введите учетные данные или выберите Запрос ввести учетные данные и введите строку запроса.

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

6. Нажмите кнопку ОК, чтобы сохранить источник данных.

Просмотр набора данных

1. В представлении «Данные» отображается обычный конструктор запросов. В списке Тип команды выберите Text.

2. В области запросов прямо под панелью инструментов обычного конструктора запросов введите путь к доступной общей сетевой папке. Например, это может быть путь \\Computer1\Public.

3. На панели инструментов обычного конструктора запросов нажмите кнопку Выполнить (!).

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

Создание макета отчета

1. В представлении «Макет» в области элементов нажмите кнопку Table.

2. Перетащите управляющий элемент Table в область конструктора.

3. В окне Поля перетащите окно Имя в первую ячейку строки Подробности. При необходимости добавьте в таблицу дополнительные поля.

Предварительный просмотр отчета

1. Для предварительного просмотра отчета щелкните вкладку Просмотр. В зависимости от настроек учетной записи для модуля FsiDataSource может потребоваться ввод имени пользователя и пароля.

См. также

Задачи

Компиляция и запуск примеров кода
Образцы служб SQL Server Reporting Services

Другие ресурсы

Образцы Extension (службы Reporting Services)
Implementing a Data Processing Extension

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений