Web-сервисы: Сервис для получения списка турагентств — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Новая страница: «Версия статьи от {{REVISIONDAY}}.{{REVISIONMONTH}}.{{REVISIONYEAR}}. <table style="background-color:#ffffcc;color:black" border="1" cellpadding="10" c...»)
 
Строка 10: Строка 10:
  
 
==Установка==
 
==Установка==
Для установки веб-сервиса «Список турагенств» необходимо скопировать папку <b>AgencyListService</b> в корневой каталог IIS (по умолчанию —  C:\inetpub\wwwroot), а затем преобразовать её в приложение в диспетчере служб IIS. В список активных протоколов и сайта, и приложения нужно добавить ''net.tcp'':
+
Для установки веб-сервиса «Список турагенств» необходимо скопировать папку из архива <b>AgencyListService.zip</b> в корневой каталог IIS (C:\inetpub\wwwroot по умолчанию), а затем преобразовать её в приложение в диспетчере служб IIS. В список активных протоколов и сайта, и приложения нужно добавить <font style="font-style:italic">net.tcp</font>:
  
[[Файл:Bm034.png|Доп. параметры приложения]]
+
[[Файл:Bm034.png|Доп. параметры приложения]]<br><br>
  
После установки «Список турагенств» доступен по адресу <nowiki>http://server IP/AgencyListService/AgencyListService.svc</nowiki>.
+
В файле <b>Web.config</b> из директории приложения в секции <b>appSettings</b> прописывается подключение к базе данных, например:
 +
<span style="color:#0000FF"><appSettings>
 +
  <add <font style="color:#FF0000">key</font><font style="color:#000000">=</font><font style="color:#8000FF">"serviceServer"</font> <font style="color:#FF0000">value</font><font style="color:#000000">=</font><font style="color:#8000FF">"s94\grey"</font>/>
 +
  <add <font style="color:#FF0000">key</font><font style="color:#000000">=</font><font style="color:#8000FF">"serviceDatabase"</font> <font style="color:#FF0000">value</font><font style="color:#000000">=</font><font style="color:#8000FF">"Fade2009"</font>/>
 +
  <add <font style="color:#FF0000">key</font><font style="color:#000000">=</font><font style="color:#8000FF">"defaultUserName"</font> <font style="color:#FF0000">value</font><font style="color:#000000">=</font><font style="color:#8000FF">"Thersenight"</font>/>
 +
  <add <font style="color:#FF0000">key</font><font style="color:#000000">=</font><font style="color:#8000FF">"defaultPassword"</font> <font style="color:#FF0000">value</font><font style="color:#000000">=</font><font style="color:#8000FF">"dil8Iusae4m"</font>/>
 +
</appSettings></span>
 +
После установки «Список турагенств» доступен по адресу <font style="color:#3366BB"><nowiki>http://server IP/AgencyListService/AgencyListService.svc</nowiki></font>.
  
 
==Настройка==
 
==Настройка==
Строка 20: Строка 27:
 
  <font style="color:#0000FF">insert into</font> [SystemSettings] <font style="color:#808080">(</font>[SS_ParmName]<font style="color:#808080">,</font>[SS_ParmValue]<font style="color:#808080">)</font> <font style="color:#0000FF">values</font> <font style="color:#808080">(<font style="color:#FF0000">'SYSActivityDays'</font>,<font style="color:#FF0000">'3'</font>)</font>
 
  <font style="color:#0000FF">insert into</font> [SystemSettings] <font style="color:#808080">(</font>[SS_ParmName]<font style="color:#808080">,</font>[SS_ParmValue]<font style="color:#808080">)</font> <font style="color:#0000FF">values</font> <font style="color:#808080">(<font style="color:#FF0000">'SYSActivityDays'</font>,<font style="color:#FF0000">'3'</font>)</font>
 
<ul>
 
<ul>
<li>При наличии настройки <b>SYSActivityDays</b> с заданным периодом (''n'' — целое число, дни) активными считаются агентства с признаком «Даёт клиентов», имеющие хотя бы одну бронь у туроператора, созданную в указанный временной промежуток (за ''n'' последних дней).</li>
+
<li>При наличии настройки <b>SYSActivityDays</b> с заданным периодом (<font style="font-style:italic">n</font> — целое число, дни) активными считаются агентства с признаком «Даёт клиентов», имеющие хотя бы одну бронь у туроператора, созданную в указанный временной промежуток (за <font style="font-style:italic">n</font> последних дней).</li>
 
<li>При отсутствии настройки <b>SYSActivityDays</b> активными считаются все агентства из базы данных «Партнёры» (таблицы [Partners]), имеющие признак «Даёт клиентов».</li>
 
<li>При отсутствии настройки <b>SYSActivityDays</b> активными считаются все агентства из базы данных «Партнёры» (таблицы [Partners]), имеющие признак «Даёт клиентов».</li>
 
</ul>
 
</ul>
Строка 54: Строка 61:
 
   </MethodParameters>
 
   </MethodParameters>
 
  </GetAgencies></span>
 
  </GetAgencies></span>
<li><b>GetCities</b> — метод возвращает все города с активными турагенствами по ключу страны [CN_KEY] из таблицы [Country]. При значении параметра ''-1'' будут выведены все города без фильтрации по стране:</li>
+
<li><b>GetCities</b> — метод возвращает все города с активными турагенствами по ключу страны [CN_KEY] из таблицы [Country]. При значении параметра <font style="font-style:italic">-1</font> будут выведены все города без фильтрации по стране:</li>
 
  <span style="color:#0000FF"><GetCities>
 
  <span style="color:#0000FF"><GetCities>
 
   <MethodParameters>
 
   <MethodParameters>

Версия 10:45, 28 августа 2012

Версия статьи от 28.08.2012.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 2009.2.15


Введение

Веб-сервис «Список турагенств» предназначен для вывода информации об активных турагенствах.

Установка

Для установки веб-сервиса «Список турагенств» необходимо скопировать папку из архива AgencyListService.zip в корневой каталог IIS (C:\inetpub\wwwroot по умолчанию), а затем преобразовать её в приложение в диспетчере служб IIS. В список активных протоколов и сайта, и приложения нужно добавить net.tcp:

Доп. параметры приложения

В файле Web.config из директории приложения в секции appSettings прописывается подключение к базе данных, например:

<appSettings>
 <add key="serviceServer" value="s94\grey"/>
 <add key="serviceDatabase" value="Fade2009"/>
 <add key="defaultUserName" value="Thersenight"/>
 <add key="defaultPassword" value="dil8Iusae4m"/>
</appSettings>

После установки «Список турагенств» доступен по адресу http://server IP/AgencyListService/AgencyListService.svc.

Настройка

В таблице [SystemSettings] создаётся настройка SYSActivityDays, определяющая период активности агентства:

insert into [SystemSettings] ([SS_ParmName],[SS_ParmValue]) values ('SYSActivityDays','3')
  • При наличии настройки SYSActivityDays с заданным периодом (n — целое число, дни) активными считаются агентства с признаком «Даёт клиентов», имеющие хотя бы одну бронь у туроператора, созданную в указанный временной промежуток (за n последних дней).
  • При отсутствии настройки SYSActivityDays активными считаются все агентства из базы данных «Партнёры» (таблицы [Partners]), имеющие признак «Даёт клиентов».

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

Веб-сервис «Список турагенств» включает в себя три метода:

  1. GetAgencies — метод возвращает активные турагенства по ключу города [CT_KEY] из таблицы [CityDictionary], например:
  2. <GetAgencies>
      <MethodParameters>
        <AgencyArray>
          <AgencyArray0>
            <Address isNull="true" />
            <AnalysisDuration>0</AnalysisDuration>
            <CityKey>63</CityKey>
            <CountryKey>3</CountryKey>
            <Email>adaptabiz@adaptabiz.com</Email>
            <Fax>+33 616-8-915</Fax>
            <FullName>Adaptabiz Co.</FullName>
            <LegalAddress isNull="true" />
            <Name>Adaptabiz</Name>
            <Phone>+33 616-8-905</Phone>
            <Representatives attr0="RepresentativeArray" isNull="false">
              <RepresentativeArray0>
                <Email>abiz@adaptabiz.com</Email>
                <FullName>abiz</FullName>
                <Phone>+33 616-8-925</Phone>
              </RepresentativeArray0>
            </Representatives>
            <Url>adaptabiz.com</Url>
          </AgencyArray0>
        </AgencyArray>
      </MethodParameters>
    </GetAgencies>
    
  3. GetCities — метод возвращает все города с активными турагенствами по ключу страны [CN_KEY] из таблицы [Country]. При значении параметра -1 будут выведены все города без фильтрации по стране:
  4. <GetCities>
      <MethodParameters>
        <CityArray>
          <CityArray0>
            <Key>275</Key>
            <Name>Арльберг</Name>
          </CityArray0>
          <CityArray1>
            <Key>207</Key>
            <Name>Берлин</Name>
          </CityArray1>
          <CityArray2>
            <Key>63</Key>
            <Name>Брюссель</Name>
          </CityArray2>
          <CityArray3>
            <Key>35</Key>
            <Name>Вена</Name>
          </CityArray3>
          <CityArray4>
            <Key>403</Key>
            <Name>Канильо</Name>
          </CityArray4>
        </CityArray>
      </MethodParameters>
    </GetCities>
    
  5. GetCountries — метод без параметров, возвращает все страны, в которых расположены активные турагенства:
  6. <GetCountries>
      <MethodParameters>
        <CountryArray>
          <CountryArray0>
            <Key>90</Key>
            <Name>Австрия</Name>
          </CountryArray0>
          <CountryArray1>
            <Key>376</Key>
            <Name>Андорра</Name>
          </CountryArray1>
          <CountryArray2>
            <Key>3</Key>
            <Name>Бельгия</Name>
          </CountryArray2>
          <CountryArray3>
            <Key>40</Key>
            <Name>Германия</Name>
          </CountryArray3>
        </CountryArray>
      </MethodParameters>
    </GetCountries>