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

Версия статьи от {{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:Руководство пользователя. Администрирование ПК Мастер-Web#Пользователи системы|пользователей]] для работы в системе бронирования ПК «Мастер-Web».

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

==Настройка плагина для 20 релиза==
После установки надстройка '''Автоматическая регистрация партнера''' доступна по адресу <code><nowiki>http://ip-адрес сервера/MasterWeb/PartnerRegistration.aspx</nowiki></code>.

===Настройки в файле WEB.CONFIG===
Настройки задаются в файле <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».

[[Файл: ep_114.png|x500px|Настройки модуля регистрации партнеров]]<br />
<br />

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

==Работа в системе==
===Регистрация партнера===
Модуль '''Автоматическая регистрация партнера''' доступен по адресу: <code><nowiki>http://ip-адрес сервера/MasterWebStandard/PartnerRegistration.aspx</nowiki></code>.

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

[[Файл: am_842.png|x500px|Настройки формы для регистрации партнера]]<br />
<br />

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

[[Файл:ep_017.png|x500px|Форма регистрации партнера]]<br />
<br />

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

[[Файл: am_843.png|x500px|Личный кабинет]]<br />
<br />

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

После того, как все необходимые поля заполнены, нужно нажать кнопку '''Зарегистрироваться'''. При этом регистрационные данные партнера запишутся в базу. При этом агентству будет ''отправлено письмо'' с логином и паролем в системе бронирования.
При регистрации нового партнера проверка производится по полю '''ИНН'''.<br />
 <span style="color:red">Внимание!</span> Регистрировать партнеров с '''одинаковым ИНН''' можно '''только''' если они принадлежат '''одной группе партнеров'''.
Если в базе данных уже существует партнер с таким '''ИНН''', то пользователю выдастся соответствующее сообщение.<br />
Информацию о новом партнере можно посмотреть в [[Мастер-Тур:База данных «Партнеры»|справочнике «Партнеры»]] ПК «Мастер-Тур».

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

[[Файл: am_946.png|x500px|Вход в «Личный кабинет»]]<br />
<br />

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

[[Файл: am_947.png|x500px|Личный кабинет]]<br />
<br />

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

[[Файл: am_945.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_Дополнительные_модули]]