Web-сервисы: Сервис для работы с документами по путевке
Версия статьи от 22-09-2015.
Содержание
[убрать]Введение
Данный модуль предназначен для отображения и выгрузки отчетов и файлов, прикрепленных к путевке. Файлы можно просматривать и распечатывать.
Установка
Для установки web-сервиса нужно создать отдельную директорию, например, ReservationDocuments (далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива ws-reservationDocuments-9.2.XX.XXXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки ReservationDocuments.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
- 1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools)
- 2. Запустить Internet Information Services (IIS) Manager
- 3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке ReservationDocuments, в которую установлен web-сервис «Сервис работы с документами по путевке», пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:
<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;
Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
Настройка
- Для прикрепления файлов к путевке необходимо воспользоваться дополнительным модулем Привязка файлов к путевке.
- Для прикрепления отчетов к путевке, в файле web.config сервиса в секции <reports></reports> необходимо прописать теги для подключения отчетных форм
Методы web-сервиса
Информация о возможных выгрузках
Метод доступен GET запросом по пути: Адрес сервиса/Documents/Код путевки.
Например, http://localhost/ReservationDocuments/Documents/EN50915999
Входные параметры
- Код путевки
Выходные параметры
- Тип файла (файл или отчет)
- Название файла
- Код файла (используется только для отчетов)
- GUID файла
Получение одного файла
Метод выгрузки файла доступен GET запросом по пути: Адрес сервиса/Documents/file/Guid файла.
Например, http://localhost/ReservationDocuments/Documents/file/E999D999-AF8C-999C-958F-E0F2C2E4E999.
Входные параметры
- GUID файла
Выходные параметры
- Выходной поток с файлом (в браузере скачивается файл)
Получение одного отчета
Метод доступен GET запросом по пути: Адрес сервиса/Documents/report/Код путевки/GUID отчета/Код отчета.
Например, http://localhost/ReservationDocuments/Documents/report/AU50708002/2DF35251-E08F-480F-B870-364AA866F0FB/VCHR
Входные параметры
- Код путевки
- GUID отчета
- Код отчета
Выходные параметры
- Выходной поток с файлом (в браузере скачивается файл)