Web-сервисы: Сервис для прикрепления файлов к туристам

Материал из Megatec
Перейти к: навигация, поиск

Версия статьи от 1-06-2012.

Введение

Данный модуль предназначен для прикрепления файлов (документов) к туристам. Файлы можно просматривать и распечатывать в ПК "Мастер-Тур" и ПК "Мастер-Web". Подробнее см. Модуль "Печать документов".

Установка

Для установки web-сервиса нужно создать отдельную директорию, например, TouristInfoService(далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива ws-touristInfoService-9.2.XX.XXXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки TouristInfoService.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:

  • 1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools)


857.PNG

  • 2. Запустить Internet Information Services (IIS) Manager


858.PNG

  • 3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».


859.PNG

Подключение к базе данных ПК «Мастер-Тур»

В файле web.config, расположенном в папке TouristInfoService, в которую установлен web-сервис «Сервис для прикрепления файлов к туристам», пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:

<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>

Настройка

После установки «Сервис для прикрепления файлов к туристам» доступен по адресу: http://ip-адрес сервера Мастер-Веб/TouristInfoService/TouristInfoService.svc

Методы web-сервиса

Поиск туриста

Метод ищет туриста в системе по различным параметрам.

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

Если при поиске произошла ошибка, то ее код вернется в параметре ErrorCode, а описание – в параметре ErrorMsg выходной коллекции метода. При этом значения остальных параметров выходной коллекции могут быть не определены.

Входные параметры

Название параметра

Тип

Обязательный

Значения

Значение по умолчанию

Surname

String

да

фамилия туриста

-

Name

String

да

имя туриста

-

Gender

Int

да

пол туриста

-

BirthDate

DateTime

нет

дата рождения

-

PassportSeries

String

нет

серия паспорта

-

PassportNumber

String

нет

номер паспорта

-

TurDate

DateTime

нет

дата заезда по путевке

-

Service

ServiceType

нет

услуга в путевке

-

DogovorKey

Int

Нет

Ключ путевки

-

Выходные параметры

Поля выходной коллекции:

  • TouristKey (Int) – ключ туриста (таблица Turist)
  • Service – ключи услуги
  • ErrorCode (Int) – код ошибки
  • ErrorMsg (String) – описание ошибки

Список исключений

  • Турист не найден
  • Неверный формат данных
  • Необработанное исключение

Прикрепление файлов к туристам

Метод загружает файл в БД, привязывая его к туристу.

Входные параметры

Название параметра

Тип

Обязательный

Значения

Значение по умолчанию

DocType

Int[]

да

Ключ типа документа (таблица DocumentGroups).Подробнее см. Описание справочника "Группы документов".

-

DocTitle

String

да

Название документа

-

FileName

String

да

Имя файла

-

TouristKey

Int

да

Ключ туриста (таблица Turist)

-

File

Byte

да

Файл

-

DocNumber1

String

нет

Номер документа (поле TU_Numdoc таблицы TurService)

-

DocNumber2

String

нет

Номер подтверждения поставщика (поле DL_Doccodepartner таблицы tbl_DogovorList)

-

ServiceKey

int

нет

Ключ услуги в путевке

 

Выходные параметры

Поля выходной коллекции:

  • ErrorCode (Int) – код ошибки
  • ErrorMsg (String) – описание ошибки

Список исключений

  • Не удалось прикрепить файл
  • Турист не найден
  • Указанный тип документа отсутствует в справочнике
  • Необработанное исключение
  • Не указан servicekey (Если переданы параметры DocNumber1и/или DocNumber2)

Удаление туриста

Метод удаляет привязанные к туристу файлы указанного типа.

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

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

Входные параметры

Название параметра

Тип

Обязательный

Значения

Значение по умолчанию

TouristKey

Int

да

ключ туриста (таблица Turist)

-

DocType

Int

нет

Ключ типа документа (таблица DocumentGroups).Подробнее см. Описание справочника "Группы документов".

-

Выходные параметры

Поля выходной коллекции:

  • ErrorCode (Int) – код ошибки
  • ErrorMsg (String) – описание ошибки

Список исключений

  • Не удалось удалить файл
  • Турист не найден
  • Указанный тип документа отсутствует в справочнике
  • Файл не найден
  • Необработанное исключение

Описание типов данных

ServiceType

Тип ServiceType - это сложная структура, содержащая параметры:

Название параметра

Тип

Обязательный

Значения

Значение по умолчанию

ServiceClass

Int

Нет

ключ класса услуги

-

ServiceCode

Int

Нет

ключ услуги (0-любой)

DL_code

-

ServiceDate

DateTime

Нет

дата начала услуги

-

ServiceKey

int

нет

Ключ услуги в путевке

DL_key