Мастер-Web:Дополнительный модуль Автоматическая регистрация партнера — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Новая страница: «==Введение== Данный модуль предназначен для регистрации партнеров через веб-интерфейс. Рег...»)
 
 
(не показана 51 промежуточная версия 7 участников)
Строка 1: Строка 1:
 +
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице
 +
 +
<table style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1">
 +
<tr>
 +
<td>
 +
Более ранние версии:<br />
 +
[http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Регистрация_партнера&stableid=5474 До 2009.2.20.15 включительно]<br />
 +
[http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Автоматическая_регистрация_партнера&stableid=14507 До 2009.2.20.22 включительно]<br />
 +
</td>
 +
</tr>
 +
</table>
 +
<br />
 
==Введение==
 
==Введение==
−
Данный модуль предназначен для регистрации партнеров через веб-интерфейс. Регистрационные данные при этом попадают в справочник «Партнеры» ПК Мастер-Тур. Так же при регистрации партнера создается один или несколько пользователей для работы в системе бронирования ПК Мастер-Web.
+
Обрабатывается только в версии 9.2.<br />
 +
В версии 15 данный функционал уже встроен в [[Мастер-Тур(15):Поиск вариантов программ туров#Регистрация агентства|стандартную поставку продукта]].<br />
 +
Данный модуль предназначен для ''регистрации'' партнеров через ''веб-интерфейс''. Регистрационные данные при этом попадают в [[Мастер-Тур:База данных «Партнеры»|справочник «Партнеры»]] ПК «Мастер-Тур». Так же при регистрации партнера создается один или несколько [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Пользователи системы|пользователей]] для работы в системе бронирования ПК «Мастер-Web».
 +
 
 
==Установка==
 
==Установка==
−
Для установки надстройки «Регистрация партнера» нужно выложить распакованные файлы из архива mw-prtregs-2007.2.XX.XXXX.zip в каталог, где лежит ПК Мастер-Web.
+
Для установки дополнительного модуля '''Автоматическая регистрация партнера''' нужно выложить распакованные файлы из архива<br />
−
==Настройка==
+
<code>mw-prtregs-2007.2.XX.XXXX.zip</code><br />
−
После установки надстройка «Регистрация партнера» доступна по адресу http://ip-адрес сервера/MasterWeb/PartnerRegistration.aspx.  
+
в каталог, где лежит ПК «Мастер-Web».
 +
 
 +
==Настройка плагина для 20 релиза==
 +
После установки надстройка '''Автоматическая регистрация партнера''' доступна по адресу <code><nowiki>http://ip-адрес сервера/MasterWeb/PartnerRegistration.aspx</nowiki></code>.
 +
 
 
===Настройки в файле WEB.CONFIG===
 
===Настройки в файле WEB.CONFIG===
−
Настройки задаются в файле web.config основного приложения ПК Мастер-Web.
+
Настройки задаются в файле <code>'''web.config'''</code> основного приложения ПК «Мастер-Web».
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="35%" | Описание
 +
! width="28%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 1
 +
| Включение дополнительного модуля '''Автоматическая регистрация партнера'''
 +
|
 +
*'''true''' – дополнительный модуль ''включен'';
 +
*'''false''' или '''отсутствие настройки''' – дополнительный модуль ''выключен''.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="PartnerRegistration" value="true" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Количество дней, после которых доступ в ПК «Мастер-Web» закрывается, если не выставлен [[Мастер-Тур:База данных «Партнеры»#Классификация по признакам|признак «заключен договор»]]
 +
| Количество дней
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorDeniedLoginAfterRegDays" value="10" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Дата (день и месяц), до которой действует договор.
 +
<span style="color:red">Если дата еще '''не наступила''', то договор до '''текущего''' года, если '''наступила''' - до '''следующего'''.</span>
 +
| Дата в формате '''DD.MM'''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorExpireDateDdMm" value="01.06"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| E-mail адрес, на который будет отправлена копия письма о регистрации партнера
 +
| E-mail адрес пользователя
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorSendMail" value="admin@test.ru"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Дополнительные e-mail адреса, на которые будет отправлено уведомление о регистрации партнера
 +
| E-mail адреса, на которые должно отправляться уведомление о новой регистрации партнера через ''точку с запятой''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorSendMailWithoutAttachment" value="mail@megatec.ru;mail1@megatec.ru"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 6
 +
| Настройка, включающая '''расширенный режим редактирования данных''' представителей в '''личном кабинете''' пользователя в модуле '''Автоматическая регистрация партнера'''.
 +
При включенном '''расширенном режиме''' появляется возможность заполнить поля '''Паспорт''' ('''общегражданский'''): '''серия''', '''номер''', '''кем выдан''', '''дата выдачи'''; '''Адрес''': '''страна''', '''город''', '''индекс''', '''адрес'''; '''Телефон'''; '''E-mail'''; '''Факс'''
 +
|
 +
*'''true''' – ''включить расширенный режим'' редактирования данных представителей;
 +
*'''false''' или '''отсутствие настройки''' – ''обычный'' режим редактирования представителей.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="userDataControlExMode" value="true"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 7
 +
| Настройка, определяющая '''[[Мастер-Тур:База данных «Партнеры»#Включение партнера в группу|группу комиссий]]''', к которой будут привязываться партнеры при регистрации в модуле '''Автоматическая регистрация партнера'''
 +
|'''Ключ группы комиссий''' из таблицы <code>'''[PrtGroups]'''</code>, к которой будут ''привязываться'' партнеры при ''регистрации''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDefaultGroup" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 8
 +
| Настройка, позволяющая отключить копирование данных партнера (адрес, телефон и т.д.) его представителям при регистрации в модуле '''Автоматическая регистрация партнера'''
 +
|
 +
*'''true''' – ''отключить копирование данных'' партнера его представителям;
 +
*'''false''' или '''отсутствие настройки''' – данные партнера ''копируются'' его представителям
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="dontUsePartnerRegData" value="true"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 9
 +
| Настройка, включающая отправку сообщения на адрес, указанный в настройке '''partnerDogovorSendMail''', при '''изменении данных''' партнера (телефон, адрес или e-mail) в экране '''Личный кабинет''' в модуле '''Автоматическая регистрация партнера'''
 +
|
 +
*'''true''' – ''отправлять сообщение'' об изменении данных партнера;
 +
*'''false''' или '''отсутствие настройки''' – сообщение об изменении данных партнера ''не отправляется''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="notifyWhenPartnerDogovorUpdate" value="true"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 10
 +
| Настройка, включающая возможность '''редактирования данных''' в личном кабинете для пользователей, '''не являющихся суперюзерами'''.
 +
При включенной настройке ''отсутствует возможность редактировать'' такие данные, как '''логин''', '''юридическое имя''', '''юридический адрес''', '''ИНН''', '''КПП''', '''страна''', '''город''', '''р/с''', '''к/с''', '''наименование банка''', '''БИК''', '''система налогообложения'''. <span style="color:red">Данные поля можно заполнить '''только 1 раз'''.</span>
 +
|
 +
*'''true''' – разрешить пользователям, не являющимся суперюзерами, редактировать свои данные в личном кабинете;
 +
*'''false''' или '''отсутствие настройки''' – пользователи, не являющиеся суперюзерами, не могут редактировать свои данные.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="nonSuperUserIsEditor" value="true"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, определяющая '''период действия партнёрского договора в днях''', при регистрации пользователя в модуле '''Автоматическая регистрация партнера'''.
 +
<span style="color:red">Данная настройка работает '''только''' при выключенной настройке '''partnerDogovorExpireDateDdMm'''</span>.
 +
|Период действия договора в днях
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorExpirePeriod" value="365"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 12
 +
| Настройка, определяющая какой договор должен отображаться в экране Личный кабинет (модуль Автоматическая регистрация партнера)
 +
|
 +
*'''isdefault''' – в личном кабинете отображается ''договор по умолчанию'';
 +
*'''datebegin''' или '''отсутствие настройки''' – отображать ''самый последний'' из действующих договоров
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="partnerDogovorSortOrder" value="isdefault"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 13
 +
| Настройка, позволяющая '''автоматически''' проставлять партнеру [[Мастер-Тур:База данных «Партнеры»#Классификация по признакам|признаки]] при он-лайн регистрации партнера через модуль '''Автоматическая регистрация партнера'''
 +
|'''Ключ признака партнера''' из таблицы <code>'''[PrtTypes]'''</code>.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="autoSetOnRegisterPartnerTypes" value="11,12"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 14
 +
| Определяет, использовать ли признак '''Проверка реквизита''' из справочника [[Мастер-Тур:Справочники#Страны|«Страны»]] при проверке корректности ввода ИНН
 +
|
 +
*'''true''' – использовать признак '''Проверка ИНН''' - проверка проводится только для тех стран, у которых '''включен''' признак '''Проверка реквизита''';
 +
*'''false''' или '''отсутствие настройки''' – проверка ИНН проводится для '''всех''' стран
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="useCheckINNSetting" value="true" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
|}
 +
 
 +
===Настройки в файле «prtRegSettings.xml»===
 +
Файл '''prtRegSettings.xml''' находится в каталоге <code>'''.../templates'''</code> основного приложения ПК «Мастер-Web».
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="35%" | Описание
 +
! width="28%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
| 1
 +
| '''Создание договора'''.
 +
Должен быть подключен [[Мастер-Web:Подключение отчета 4030 «Агентский договор»|отчет 4030 «Агентский договор»]]
 +
|
 +
*'''true''' – договор ''создается'';
 +
*'''false''' или '''отсутствие настройки''' – договор ''не создается''.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<Dogovor Make="true"></Dogovor>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Признаки партнера, которые проставляются партнеру при регистрации и обновлении договора
 +
| '''Ключ признака партнера''' (поле '''PT_Id''' из таблицы '''[PrtTypes]''')
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<PrtTypes>
 +
    <PrtType ID="7"></PrtType>
 +
    <PrtType ID="1003"></PrtType>
 +
    ...
 +
</PrtTypes>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Признак партнера который присваивается партнеру, если он использует упрощенный тип налогообложения
 +
| '''Ключ признака партнера''' (поле '''PT_Id''' из таблицы '''[PrtTypes]''')
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<UnitarySystemToPrtType ID="1002"></UnitarySystemToPrtType>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| Партнер, с которым заключается договор
 +
| '''Ключ партнера''' (поле '''PR_KEY''' из таблицы '''[Partners]''')
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<PartnerDogovorAbonent Key="10764"></PartnerDogovorAbonent>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Страны, для которых разрешена автоматическая регистрация партнера.
 +
| '''Ключ страны''' - указываются через запятую (поле '''СN_KEY''' из таблицы '''[Country]''')
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<PreselectedCountry PreselectedCountriesKeys="90,359"></PreselectedCountry>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
|}
 +
 
 +
==Настройка плагина для 21 релиза==
 +
===Настройка полей для регистрации===
 +
Настройка полей для регистрации партнера осуществляется в экране [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Настройки|Настройки]] '''Системы Администрирования''' ПК «Мастер-Web».
 +
<br />
 +
Отображаются поля для регистрации только при включенной настройке '''PartnerRegistration''' в значении '''true'''.
 +
[[Файл: am_623.png|x500px|Настройки формы для регистрации партнера]]<br />
 +
<br />
 +
 
 +
Данные настройки определяют ''какие данные'' о партнере должны ''заполняться'' при регистрации. Здесь же можно изменить ''названия регистрационных полей'', а также добавить ''информационное сообщение'' пользователю, которое будет выдаваться в случае, когда ''обязательное'' поле ''не было заполнено''.
 +
<br>
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR>
 +
Для того, чтобы разблокировать чекбокс колонок "Обязательный" и "Видимый", необходимо внести изменения в файл <code>regForm.xml</code>,<br>расположенный по пути: <code>//MasterWeb/Admin/templates/regForm.xml</code>.
 +
У строки с необходимым полем нужно удалить параметр '''Required''' для чекбокса колонки "Обязательный", параметр '''Visible'''<br>для чекбокса колонки "Видимый". После этого, пользователь сможет выставить необходимые значения данных полей<br>в экране [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Настройки|Настройки]] Системы Администрирования ПК «Мастер-Web». Для того, чтобы снова заблокировать чекбоксы, необходимо<br>вернуть параметры в данный файл.
 +
<BR>
 +
 
 +
===Настройка модуля регистрации партнеров===
 +
Настройка модуля регистрации партнеров осуществляется в экране [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Настройки|Настройки]] '''Системы Администрирования''' ПК «Мастер-Web».
 +
 
 +
[[Файл: Ak_073.png|x500px|Настройки модуля регистрации партнеров]]<br />
 +
<br />
 +
[[Файл:am_063.png|left|Предупреждение]]<br />
 +
С 1 января 2017 года вступили в силу положения Федерального закона от 02.03.2016 № 49-ФЗ «О внесении изменений в отдельные законодательные акты
 +
Российской Федерации в целях совершенствования законодательства, регулирующего туристскую деятельность» (далее – Федеральный закон № 49-ФЗ), в связи
 +
с чем вводится ограничение на осуществление бронирования партнёрами, не указавшими реестровый номер.
 +
Установить дату, начиная с которой данное ограничение начинает функционировать, можно в [[Мастер-Тур:Администрирование системы#Дополнительные настройки|дополнительных настройках]] ПК «Мастер-Тур».
 +
<span style="color:red">Настройка работает, начиная с релиза '''9222SP0'''.</span>
 +
 
 +
В случае, если осуществляется проверка реестрового номера, то при авторизации партнёр с незаполненным значением реестрового номера увидит сообщение:<br>
 +
[[Файл:Ak_078.png]]<br>
 +
При этом авторизация выполнена не будет и, соответственно, осуществить бронирование невозможно.
 +
 
 +
==Подготовка данных==
 +
Предварительной подготовки данных данный модуль не требует.
 +
 
 +
==Работа в системе==
 +
===Регистрация партнера===
 +
Модуль '''Автоматическая регистрация партнера''' доступен по адресу: <code><nowiki>http://ip-адрес сервера/MasterWebStandard/PartnerRegistration.aspx</nowiki></code>.
 +
 
 +
Вход в экран может быть осуществлен из любого экрана ПК «Мастер-Web»:
 +
 
 +
[[Файл: am_842.png|x500px|Настройки формы для регистрации партнера]]<br />
 +
<br />
 +
 
 +
При входе в экран открывается форма для ''заполнения регистрационных полей''.
 +
 
 +
[[Файл:Ak_074.png|x500px|Форма регистрации партнера]]<br />
 +
<br />
 +
 
 +
''По умолчанию'' при регистрации добавляется ''один пользователь'' для работы в '''Системе Бронирования''' ПК «Мастер-Web».<br />
 +
Дополнительных пользователей можно добавить в '''Личном кабинете'''.
 +
 
 +
[[Файл: Ak_072.png|x500px|Личный кабинет]]<br />
 +
<br />
 +
 
 +
В экране '''Личный кабинет''' запрещено редактирование полей '''Страна''' и '''Город'''. Если по каким-либо причинам они не были заполнены, сохранить
 +
данные в экране '''Личный кабинет''' невозможно.
 +
 
 +
После того, как все необходимые поля заполнены, нужно нажать кнопку '''Зарегистрироваться'''. При этом регистрационные данные партнера запишутся в базу. При этом агентству будет ''отправлено письмо'' с логином и паролем в системе бронирования.
 +
При регистрации нового партнера проверка производится по полю '''ИНН'''.<br />
 +
<span style="color:red">Внимание!</span> Регистрировать партнеров с '''одинаковым ИНН''' можно '''только''' если они принадлежат '''одной группе партнеров'''.
 +
Если в базе данных уже существует партнер с таким '''ИНН''', то пользователю выдастся соответствующее сообщение.<br />
 +
Информацию о новом партнере можно посмотреть в [[Мастер-Тур:База данных «Партнеры»|справочнике «Партнеры»]] ПК «Мастер-Тур».
 +
 
 +
===Личный кабинет===
 +
У зарегистрированного партнера есть возможность внести изменения в свои регистрационные данные. Для этого агентству необходимо авторизоваться в любом экране ПК Мастер-Web, после чего появится возможность входа в личный кабинет:
 +
 
 +
[[Файл: am_946.png|x500px|Вход в «Личный кабинет»]]<br />
 +
<br />
 +
 
 +
После того как необходимые изменения внесены нужно нажать на кнопку «Сохранить изменения».
 +
 
 +
[[Файл: Ak_076.png|x500px|Личный кабинет]]<br />
 +
<br />
 +
 
 +
Если пользователь ПК «Мастер-Web» является '''суперпользователем''' или влючена настройка '''nonSuperUserIsEditor''' а так же включена настройка '''<Dogovor Make="true"></Dogovor>''' в файле <code>prtRegSettings.xml</code>, то в экране '''Личный кабинет''' есть кнопка '''Перезаключить договор'''.
 +
 
 +
[[Файл: Ak_077.png|x500px|Перезаключить договор]]<br />
 +
<br />
 +
 
 +
При нажатии на кнопку происходит '''повторное сохранение данных партнера''', введенных в личном кабинете; у партнера снимается признак '''Заключен договор'''; партнеру '''присваиваются признаки''', указанные в настройке '''<PrtTypes>''' в файле <code>prtRegSettings.xml</code>; '''создается договор''' с параметрами, указанными в настройках в файлах <code>web.config</code> и <code>prtRegSettings.xml</code>.
 +
 
 +
===Договор с партнером===
 +
 
 +
====Плагин «Автоматическая генерация номера договора» (DogovorNumberGenerator)====
 +
 
 +
=====Установка плагина=====
 +
Для установки плагина нужно выложить распакованные файлы из архива<br />
 +
<code>mw-dogovornumbergenerator-9.2.ХХ.ХХХХХ.zip</code><br />
 +
в каталог, где установлен ПК «Мастер-Web».<br />
 +
 
 +
В файл <code>web.config</code> основного приложения необходимо добавить в секцию <code>'''<spring><objects>'''</code> следующий тег:
 +
<pre style="white-space:pre-wrap; word-wrap:break-word;">
 +
<object name="prtRegDogNumber" type="MasterWebStandard.Extra.DogovorNumberGenerator.DogovorNumber, MasterWebStandard.Extra.DogovorNumberGenerator"/>
 +
</pre>
 +
 
 +
Измененная секция должна выглядеть так:
 +
<pre style="white-space:pre-wrap; word-wrap:break-word;">
 +
<spring>...
 +
<objects>
 +
<object name="prtRegDogNumber" type="MasterWebStandard.Extra.DogovorNumberGenerator.DogovorNumber, MasterWebStandard.Extra.DogovorNumberGenerator"/>
 +
</objects>
 +
</spring>
 +
</pre>
 +
 
 +
=====Настройки в файле WEB.CONFIG (для 20 релиза)=====
 +
В файл <code>web.config</code> необходимо добавить следующие настройки:
 +
 
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="1450px"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 1
 +
| Настройка, задающая '''формат номера''' договора.
 +
| В значении настройки можно указать следующие динамические поля:
 +
*'''{year}''' - ''текущий'' год ('''4 цифры''');<br />
 +
*'''{yearshort}''' - ''текущий'' год ('''2 последние цифры''');<br />
 +
*'''{month}''' - ''текущий'' месяц (число от '''1''' до '''12''');<br />
 +
*'''{dogNumber}''' - номер ''договора'', который ''инкрементируется'' с каждым ''созданием договора'' и ''сбрасывается'', в соответствии с настройкой '''dogNumberGenIncrementPeriod'''.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="dogNumberGenFormat" value="TESTNUM{yearshort}-{dogNumber}" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Настройка, определяющая '''период сбрасывания счётчика''' договоров.
 +
|
 +
*'''none''' – счетчик договоров ''никогда'' не сбрасывается;<br />
 +
*'''year''' – счетчик сбрасывается в ''начале каждого года'';<br />
 +
*'''month''' – счетчик сбрасывается в ''начале каждого месяца''.<br />
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="dogNumberGenIncrementPeriod" value="year" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Настройка, определяющая '''счетчик номеров''' договоров из базы данных ПК «Мастер-Тур».
 +
|
 +
*'''Ключ счетчика номеров договоров''' из таблицы <code>[BlankRangeTypes]</code>.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="dogNumberGenKey" value="1003"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
|}
 +
 
 +
=====Справочник «Типы документов»=====
 +
В справочнике [[Мастер-Тур:Справочники#Типы документов|Типы документов]] ПК «Мастер-Тур» необходимо добавить новый тип документа для агентского договора. Ключ этого типа документа из таблицы <code>[BlankRangeTypes]</code> должен быть прописан в настройке '''dogNumberGenKey'''.<br />
 +
 
 +
[[Файл: am_845.png|x500px|Типы документов]]<br />
 +
<br />
 +
 
 +
=====Справочник «Пачки бланков»=====
 +
Счетчики хранятся в справочнике [[Мастер-Тур:Справочники#Пачки бланков|Пачки бланков]] (таблице <code>[BlankRanges]</code> в базе данных ПК «Мастер-Тур»). Они создаются автоматически.<br />
 +
 
 +
[[Файл: am_846.png|x500px|Пачки бланков]]<br />
 +
<br />
 +
 
 +
===Отчет 4030 «Агентский договор»===
 +
Для формирования договора с агентом при регистрации в дополнительном модуле '''Автоматическая регистрация партнера''' необходимо [[Мастер-Web:Подключение отчета 4030 "Агентский договор"|подключить отчет 4030 «Агентский договор»]].
  
 
[[Category:Мастер-Web_Дополнительные_модули]]
 
[[Category:Мастер-Web_Дополнительные_модули]]

Текущая версия на 08:36, 17 сентября 2020

Версия статьи от 17-09-2020. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице

Более ранние версии:
До 2009.2.20.15 включительно
До 2009.2.20.22 включительно


Введение

Обрабатывается только в версии 9.2.
В версии 15 данный функционал уже встроен в стандартную поставку продукта.
Данный модуль предназначен для регистрации партнеров через веб-интерфейс. Регистрационные данные при этом попадают в справочник «Партнеры» ПК «Мастер-Тур». Так же при регистрации партнера создается один или несколько пользователей для работы в системе бронирования ПК «Мастер-Web».

Установка

Для установки дополнительного модуля Автоматическая регистрация партнера нужно выложить распакованные файлы из архива
mw-prtregs-2007.2.XX.XXXX.zip
в каталог, где лежит ПК «Мастер-Web».

Настройка плагина для 20 релиза

После установки надстройка Автоматическая регистрация партнера доступна по адресу http://ip-адрес сервера/MasterWeb/PartnerRegistration.aspx.

Настройки в файле WEB.CONFIG

Настройки задаются в файле web.config основного приложения ПК «Мастер-Web».

№ Описание Значение Настройка
1 Включение дополнительного модуля Автоматическая регистрация партнера
  • true – дополнительный модуль включен;
  • false или отсутствие настройки – дополнительный модуль выключен.
 
<add key="PartnerRegistration" value="true" />
2 Количество дней, после которых доступ в ПК «Мастер-Web» закрывается, если не выставлен признак «заключен договор» Количество дней 
<add key="partnerDogovorDeniedLoginAfterRegDays" value="10" />
3 Дата (день и месяц), до которой действует договор.

Если дата еще не наступила, то договор до текущего года, если наступила - до следующего.

Дата в формате DD.MM 
<add key="partnerDogovorExpireDateDdMm" value="01.06"/>
4 E-mail адрес, на который будет отправлена копия письма о регистрации партнера E-mail адрес пользователя 
<add key="partnerDogovorSendMail" value="admin@test.ru"/>
5 Дополнительные e-mail адреса, на которые будет отправлено уведомление о регистрации партнера E-mail адреса, на которые должно отправляться уведомление о новой регистрации партнера через точку с запятой 
<add key="partnerDogovorSendMailWithoutAttachment" value="mail@megatec.ru;mail1@megatec.ru"/>
6 Настройка, включающая расширенный режим редактирования данных представителей в личном кабинете пользователя в модуле Автоматическая регистрация партнера.

При включенном расширенном режиме появляется возможность заполнить поля Паспорт (общегражданский): серия, номер, кем выдан, дата выдачи; Адрес: страна, город, индекс, адрес; Телефон; E-mail; Факс

  • true – включить расширенный режим редактирования данных представителей;
  • false или отсутствие настройки – обычный режим редактирования представителей.
 
<add key="userDataControlExMode" value="true"/>
7 Настройка, определяющая группу комиссий, к которой будут привязываться партнеры при регистрации в модуле Автоматическая регистрация партнера Ключ группы комиссий из таблицы [PrtGroups], к которой будут привязываться партнеры при регистрации 
<add key="partnerDefaultGroup" value="1"/>
8 Настройка, позволяющая отключить копирование данных партнера (адрес, телефон и т.д.) его представителям при регистрации в модуле Автоматическая регистрация партнера
  • true – отключить копирование данных партнера его представителям;
  • false или отсутствие настройки – данные партнера копируются его представителям
 
<add key="dontUsePartnerRegData" value="true"/>
9 Настройка, включающая отправку сообщения на адрес, указанный в настройке partnerDogovorSendMail, при изменении данных партнера (телефон, адрес или e-mail) в экране Личный кабинет в модуле Автоматическая регистрация партнера
  • true – отправлять сообщение об изменении данных партнера;
  • false или отсутствие настройки – сообщение об изменении данных партнера не отправляется
 
<add key="notifyWhenPartnerDogovorUpdate" value="true"/>
10 Настройка, включающая возможность редактирования данных в личном кабинете для пользователей, не являющихся суперюзерами.

При включенной настройке отсутствует возможность редактировать такие данные, как логин, юридическое имя, юридический адрес, ИНН, КПП, страна, город, р/с, к/с, наименование банка, БИК, система налогообложения. Данные поля можно заполнить только 1 раз.

  • true – разрешить пользователям, не являющимся суперюзерами, редактировать свои данные в личном кабинете;
  • false или отсутствие настройки – пользователи, не являющиеся суперюзерами, не могут редактировать свои данные.
 
<add key="nonSuperUserIsEditor" value="true"/>
11 Настройка, определяющая период действия партнёрского договора в днях, при регистрации пользователя в модуле Автоматическая регистрация партнера.

Данная настройка работает только при выключенной настройке partnerDogovorExpireDateDdMm.

Период действия договора в днях 
<add key="partnerDogovorExpirePeriod" value="365"/>
12 Настройка, определяющая какой договор должен отображаться в экране Личный кабинет (модуль Автоматическая регистрация партнера)
  • isdefault – в личном кабинете отображается договор по умолчанию;
  • datebegin или отсутствие настройки – отображать самый последний из действующих договоров
 
<add key="partnerDogovorSortOrder" value="isdefault"/>
13 Настройка, позволяющая автоматически проставлять партнеру признаки при он-лайн регистрации партнера через модуль Автоматическая регистрация партнера Ключ признака партнера из таблицы [PrtTypes]. 
<add key="autoSetOnRegisterPartnerTypes" value="11,12"/>
14 Определяет, использовать ли признак Проверка реквизита из справочника «Страны» при проверке корректности ввода ИНН
  • true – использовать признак Проверка ИНН - проверка проводится только для тех стран, у которых включен признак Проверка реквизита;
  • false или отсутствие настройки – проверка ИНН проводится для всех стран
 
<add key="useCheckINNSetting" value="true" />

Настройки в файле «prtRegSettings.xml»

Файл prtRegSettings.xml находится в каталоге .../templates основного приложения ПК «Мастер-Web».

№ Описание Значение Настройка
1 Создание договора.

Должен быть подключен отчет 4030 «Агентский договор»

  • true – договор создается;
  • false или отсутствие настройки – договор не создается.
 
<Dogovor Make="true"></Dogovor>
2 Признаки партнера, которые проставляются партнеру при регистрации и обновлении договора Ключ признака партнера (поле PT_Id из таблицы [PrtTypes]) 
<PrtTypes>
    <PrtType ID="7"></PrtType>
    <PrtType ID="1003"></PrtType>
    ...
</PrtTypes>
3 Признак партнера который присваивается партнеру, если он использует упрощенный тип налогообложения Ключ признака партнера (поле PT_Id из таблицы [PrtTypes]) 
<UnitarySystemToPrtType ID="1002"></UnitarySystemToPrtType>
4 Партнер, с которым заключается договор Ключ партнера (поле PR_KEY из таблицы [Partners]) 
<PartnerDogovorAbonent Key="10764"></PartnerDogovorAbonent>
5 Страны, для которых разрешена автоматическая регистрация партнера. Ключ страны - указываются через запятую (поле СN_KEY из таблицы [Country]) 
<PreselectedCountry PreselectedCountriesKeys="90,359"></PreselectedCountry>

Настройка плагина для 21 релиза

Настройка полей для регистрации

Настройка полей для регистрации партнера осуществляется в экране Настройки Системы Администрирования ПК «Мастер-Web». 

Отображаются поля для регистрации только при включенной настройке PartnerRegistration в значении true.

Настройки формы для регистрации партнера

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

Предупреждение


Для того, чтобы разблокировать чекбокс колонок "Обязательный" и "Видимый", необходимо внести изменения в файл regForm.xml,
расположенный по пути: //MasterWeb/Admin/templates/regForm.xml.
У строки с необходимым полем нужно удалить параметр Required для чекбокса колонки "Обязательный", параметр Visible
для чекбокса колонки "Видимый". После этого, пользователь сможет выставить необходимые значения данных полей
в экране Настройки Системы Администрирования ПК «Мастер-Web». Для того, чтобы снова заблокировать чекбоксы, необходимо
вернуть параметры в данный файл.


Настройка модуля регистрации партнеров

Настройка модуля регистрации партнеров осуществляется в экране Настройки Системы Администрирования ПК «Мастер-Web».

Настройки модуля регистрации партнеров

Предупреждение


С 1 января 2017 года вступили в силу положения Федерального закона от 02.03.2016 № 49-ФЗ «О внесении изменений в отдельные законодательные акты 
Российской Федерации в целях совершенствования законодательства, регулирующего туристскую деятельность» (далее – Федеральный закон № 49-ФЗ), в связи 
с чем вводится ограничение на осуществление бронирования партнёрами, не указавшими реестровый номер.
Установить дату, начиная с которой данное ограничение начинает функционировать, можно в дополнительных настройках ПК «Мастер-Тур».
Настройка работает, начиная с релиза 9222SP0.

В случае, если осуществляется проверка реестрового номера, то при авторизации партнёр с незаполненным значением реестрового номера увидит сообщение:
Ak 078.png
При этом авторизация выполнена не будет и, соответственно, осуществить бронирование невозможно.

Подготовка данных

Предварительной подготовки данных данный модуль не требует.

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

Регистрация партнера

Модуль Автоматическая регистрация партнера доступен по адресу: http://ip-адрес сервера/MasterWebStandard/PartnerRegistration.aspx.

Вход в экран может быть осуществлен из любого экрана ПК «Мастер-Web»:

Настройки формы для регистрации партнера

При входе в экран открывается форма для заполнения регистрационных полей.

Форма регистрации партнера

По умолчанию при регистрации добавляется один пользователь для работы в Системе Бронирования ПК «Мастер-Web».
Дополнительных пользователей можно добавить в Личном кабинете.

Личный кабинет

В экране Личный кабинет запрещено редактирование полей Страна и Город. Если по каким-либо причинам они не были заполнены, сохранить
данные в экране Личный кабинет невозможно.

После того, как все необходимые поля заполнены, нужно нажать кнопку Зарегистрироваться. При этом регистрационные данные партнера запишутся в базу. При этом агентству будет отправлено письмо с логином и паролем в системе бронирования. При регистрации нового партнера проверка производится по полю ИНН.

Внимание! Регистрировать партнеров с одинаковым ИНН можно только если они принадлежат одной группе партнеров.

Если в базе данных уже существует партнер с таким ИНН, то пользователю выдастся соответствующее сообщение.
Информацию о новом партнере можно посмотреть в справочнике «Партнеры» ПК «Мастер-Тур».

Личный кабинет

У зарегистрированного партнера есть возможность внести изменения в свои регистрационные данные. Для этого агентству необходимо авторизоваться в любом экране ПК Мастер-Web, после чего появится возможность входа в личный кабинет:

Вход в «Личный кабинет»

После того как необходимые изменения внесены нужно нажать на кнопку «Сохранить изменения».

Личный кабинет

Если пользователь ПК «Мастер-Web» является суперпользователем или влючена настройка nonSuperUserIsEditor а так же включена настройка <Dogovor Make="true"></Dogovor> в файле prtRegSettings.xml, то в экране Личный кабинет есть кнопка Перезаключить договор.

Перезаключить договор

При нажатии на кнопку происходит повторное сохранение данных партнера, введенных в личном кабинете; у партнера снимается признак Заключен договор; партнеру присваиваются признаки, указанные в настройке <PrtTypes> в файле prtRegSettings.xml; создается договор с параметрами, указанными в настройках в файлах web.config и prtRegSettings.xml.

Договор с партнером

Плагин «Автоматическая генерация номера договора» (DogovorNumberGenerator)

Установка плагина

Для установки плагина нужно выложить распакованные файлы из архива
mw-dogovornumbergenerator-9.2.ХХ.ХХХХХ.zip
в каталог, где установлен ПК «Мастер-Web».

В файл web.config основного приложения необходимо добавить в секцию <spring><objects> следующий тег: 

<object name="prtRegDogNumber" type="MasterWebStandard.Extra.DogovorNumberGenerator.DogovorNumber, MasterWebStandard.Extra.DogovorNumberGenerator"/>

Измененная секция должна выглядеть так: 

<spring>...
<objects>
<object name="prtRegDogNumber" type="MasterWebStandard.Extra.DogovorNumberGenerator.DogovorNumber, MasterWebStandard.Extra.DogovorNumberGenerator"/>
</objects>
</spring>
Настройки в файле WEB.CONFIG (для 20 релиза)

В файл web.config необходимо добавить следующие настройки:

№ Описание Значение Настройка
1 Настройка, задающая формат номера договора. В значении настройки можно указать следующие динамические поля:
  • {year} - текущий год (4 цифры);
  • {yearshort} - текущий год (2 последние цифры);
  • {month} - текущий месяц (число от 1 до 12);
  • {dogNumber} - номер договора, который инкрементируется с каждым созданием договора и сбрасывается, в соответствии с настройкой dogNumberGenIncrementPeriod.
 
<add key="dogNumberGenFormat" value="TESTNUM{yearshort}-{dogNumber}" />
2 Настройка, определяющая период сбрасывания счётчика договоров.
  • none – счетчик договоров никогда не сбрасывается;
  • year – счетчик сбрасывается в начале каждого года;
  • month – счетчик сбрасывается в начале каждого месяца.
 
<add key="dogNumberGenIncrementPeriod" value="year" />
3 Настройка, определяющая счетчик номеров договоров из базы данных ПК «Мастер-Тур».
  • Ключ счетчика номеров договоров из таблицы [BlankRangeTypes].
 
<add key="dogNumberGenKey" value="1003"/>
Справочник «Типы документов»

В справочнике Типы документов ПК «Мастер-Тур» необходимо добавить новый тип документа для агентского договора. Ключ этого типа документа из таблицы [BlankRangeTypes] должен быть прописан в настройке dogNumberGenKey.

Типы документов

Справочник «Пачки бланков»

Счетчики хранятся в справочнике Пачки бланков (таблице [BlankRanges] в базе данных ПК «Мастер-Тур»). Они создаются автоматически.

Пачки бланков

Отчет 4030 «Агентский договор»

Для формирования договора с агентом при регистрации в дополнительном модуле Автоматическая регистрация партнера необходимо подключить отчет 4030 «Агентский договор».

Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Автоматическая_регистрация_партнера&oldid=24697»