Web-сервисы: Сервис для работы с документами по путевке — различия между версиями
[досмотренная версия] | [досмотренная версия] |
Biryukov (обсуждение | вклад) м (Biryukov переименовал страницу Мастер-Web:Дополнительный модуль Сервис работы с документами по путевке в [[Мастер-Web:Дополнительный модуль С…) |
Porunova (обсуждение | вклад) |
||
Строка 25: | Строка 25: | ||
<add key = "connectionString" value = "Data Source=''ip-адрес сервера базы данных ПК Мастер-тур'';<br />Initial Catalog=''название базы данных ПК Мастер-тур'';User ID=''логин пользователя ПК Мастер-тур'';Password=''пароль пользователя ПК Мастер-тур''"/> | <add key = "connectionString" value = "Data Source=''ip-адрес сервера базы данных ПК Мастер-тур'';<br />Initial Catalog=''название базы данных ПК Мастер-тур'';User ID=''логин пользователя ПК Мастер-тур'';Password=''пароль пользователя ПК Мастер-тур''"/> | ||
+ | ==Базовый алгоритм работы с сервисом== | ||
+ | Данный сервис позволяет получить список доступных для печати документов, а также распечатать их по отдельности. Для этого, сервис предоставляет несколько методов. | ||
+ | |||
+ | *Во-первых, необходимо получить список доступных для печати документов по путевке. Для этого нужно вызывать [[Мастер-Web:Дополнительный модуль Сервис для работы с документами по путевке#Информация о возможных выгрузках|метод получения информации о возможных выгрузках]]. В ответе сервиса придет список описаний документов, в каждом из которых будет указан тип документа: файл или отчет. | ||
+ | |||
+ | *Для выгрузки какого-либо документа необходимо вызвать соответствующий его типу метод. Для файла - [[Мастер-Web:Дополнительный модуль Сервис для работы с документами по путевке#Получение одного файла|метод получения одного файла]], для отчета - [[Мастер-Web:Дополнительный модуль Сервис для работы с документами по путевке#Получение одного отчета|метод получения одного отчета]]. Входными параметрами данных методов являются данные, полученные при вызове метода получения информации о доступных выгрузках, а выходными - файл или отчет. | ||
==Методы web-сервиса== | ==Методы web-сервиса== | ||
===Информация о возможных выгрузках=== | ===Информация о возможных выгрузках=== |
Версия 12:30, 31 октября 2015
Версия статьи от 31-10-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-сервиса
Информация о возможных выгрузках
Метод доступен GET запросом по пути: Адрес сервиса/Documents/Код путевки.
Например, http://localhost/ReservationDocuments/Documents/EN50915999, где:
- http://localhost/ReservationDocuments - адрес сервиса
- EN50915999 - код путевки
Входные параметры
- Код путевки
Выходные параметры
- Тип документа (файл или отчет)
- Название документа
- Код документа (используется только для отчетов)
- GUID документа
Получение одного файла
Метод выгрузки файла доступен GET запросом по пути: Адрес сервиса/Documents/file/Guid файла.
Например, http://localhost/ReservationDocuments/Documents/file/E999D999-AF8C-999C-958F-E0F2C2E4E999, где:
- http://localhost/ReservationDocuments - адрес сервиса
- E999D999-AF8C-999C-958F-E0F2C2E4E999 - GUID файла
Входные параметры
- GUID файла
Выходные параметры
- Выходной поток с файлом
Получение одного отчета
Метод доступен GET запросом по пути: Адрес сервиса/Documents/report/Код путевки/GUID отчета/Код отчета.
Например, http://localhost/ReservationDocuments/Documents/report/AU50708002/2DF39999-E99F-480F-B870-364AA999F0FB/VCHR, где:
- http://localhost/ReservationDocuments - адрес сервиса
- AU50708002 - код путевки
- 2DF39999-E99F-480F-B870-364AA999F0FB - GUID отчета
- VCHR - код отчета
Входные параметры
- Код путевки
- GUID отчета
- Код отчета
Выходные параметры
- Выходной поток с файлом