Web-сервисы: Сервис по работе с заявками

Введение

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

Установка

Для установки Сервиса по работе с заявками нужно создать директорию WebServices в каталоге c:/inetpub/wwwroot/MasterWeb и выложить туда распакованные файлы из архива mw-megatecwebservices-2007.2.XX.XXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки WebServices.

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

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

• 1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel).

• 2. В открывшемся окне выбрать Администрирование (Administrative Tools).

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

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

• 5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК».

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

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

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

Настройка

После установки «Поисковый сервис» доступен по адресу http://ip- адрес сервера Мастер-Веб/WebServices/BookingManager.asmx.

Настройки web.config приложения ПК Мастер-Web

Дополнительные настройки, задаваемые в файле web.config, находящемся в папке MasterWeb позволяют задать дополнительные условия для отображения и проверки данных.

Описание:Путь к приложению WebServices
Значение:Ссылка на приложение WebServices
Настройка:<add key="webServicesSource" value="http://localhost/MasterWeb/WebService"/>

Добавление секций

• 1. В секции <ConfigSections> необходимо добавить подсекцию:

<sectionGroup name="Megatec.Web.Services">
      <section name="servicesAccessibility" type="Megatec.Configuration.WebServicesSection, Megatec.Configuration"/>
    </sectionGroup> 

• 2. На одном уровне с секцией <ConfigSections> необходимо добавить секцию:

<Megatec.Web.Services>
    <servicesAccessibility Enabled="true">
      <Services>
        <add name="DoSearch" enabled="true"/>
      </Services>
    </servicesAccessibility>
  </Megatec.Web.Services> 

Работа в системе

Получение списка измененных путевок (метод GetChangedBookings)

Описание метода

Формирует список путевок, по которым были произведены изменения за заданный период.

Сигнатура метода

List<SimpleDogovor> GetChangedBookings(DateTime dateFrom, DateTime dateTo)

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

• dateFrom - дата, начиная с которой ищутся изменения;
• dateTo - дата, заканчивая которой ищутся изменения.

Возвращаемое значение

Коллекция путевок представленных классом SimpleDogovor

Определение наличия изменений в путевке (метод VerifyBookingChanges)

Описание метода

Определяет, были ли произведены изменения по конкретной путевке.

Сигнатура метода

bool VerifyBookingChanges(int dogovorKey, DateTime dateFrom, DateTime dateTo)

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

• dogovorKey – ключ путевки, по которой определяется наличие изменений;
• dateFrom - дата, начиная с которой ищутся изменения;
• dateTo - дата, заканчивая которой ищутся изменения.

Возвращаемое значение

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

Вспомогательные классы

Класс SimpleDogovor

Назначение класса

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

Описание класса

public class SimpleDogovor
    {
        public SimpleDogovor() { }

        public SimpleDogovor(int key, string code) { }
        
        /// <summary>
        /// Ключ путевки
        /// </summary>
        public int Key { get; set; }

        /// <summary>
        /// Код путевки
        /// </summary>
        public string Code  { get; set; }
    }