Мастер-Тур:Дополнительный модуль Импорт прайс-листов — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Шаблоны)
(→‎Формирование нового профиля)
 
(не показана 1 промежуточная версия 1 участника)
Строка 24: Строка 24:
 
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
 
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
  
 +
<ul>
 +
<li>Эталонный шаблон<br></li>
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 
Правила импорта для «Эталонный шаблон»
 
Правила импорта для «Эталонный шаблон»
Строка 102: Строка 104:
 
|}
 
|}
 
</div></div><br />
 
</div></div><br />
−
<ul>
+
<br>[[Файл:471.PNG|Эталонный шаблон]]<br><br>
−
<li>Эталонный шаблон<br><br>[[Файл:471.PNG|Эталонный шаблон]]<br><br></li>
 
 
</ul>
 
</ul>
  
Строка 121: Строка 122:
 
Вся информация находится на первом листе xls-файла.
 
Вся информация находится на первом листе xls-файла.
 
Файл не должен быть защищен паролем и не должен содержать макросов (т.е. должен открываться сразу).<br>
 
Файл не должен быть защищен паролем и не должен содержать макросов (т.е. должен открываться сразу).<br>
−
'''Разбор таблицы с ценами'''<br>
+
 
−
1. Первая строка – название отеля, через запятую категория отеля (звездность), через запятую город отеля.<br>
+
{| class="wikitable"
−
2. Вторая строка – адрес отеля (не обрабатывается и в сопоставлении не участвует).<br>
+
! scope="col" width="70px" | Поле в примере
−
3. Третья строка – адрес сайта отеля (не обрабатывается и не сопоставлении не участвует).<br>
+
! scope="col" width="200px" | Содержание поля
−
4. Четвертая строка содержит общий период, за который вводятся цены (при импорте не используется – используются конкретные периоды из соответствующих ячеек), валюту, возраст детей, соответствующий детскому размещению<br>
+
! scope="col" width="300px" | С каким значением справочника МТ сопоставляется
−
5. Пятая строка – строка заголовков<br>
+
|-
−
6. Шестая строка – строка заголовков: <br>
+
|1
−
6.1. первые две ячейки – «RoomCategory», <br>
+
|Название отеля
−
6.2. третья ячейка – тип номера «SGL» (одноместный номер)<br>
+
|Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
−
6.3. четвертая  ячейка – тип номера «DBL» (двухместный номер)<br>
+
|-
−
6.4. пятая ячейка -  тип номера «Suite» (при импорте не используется)<br>
+
|2
−
6.5. шестая ячейка – «Apt» (эта колонка показывает, есть ли дополнительные места для данной категории номера)<br>
+
|Адрес отеля  
−
6.6. седьмая ячейка – тип размещения «Adult» (дополнительное размещение для взрослых)<br>
+
|Не обрабатывается и не сопоставлении не участвует
−
6.7. восьмая ячейка – тип размещения «Child» (дополнительное размещение для детей)<br>
+
|-
−
6.8. девятая ячейка – «Meal» (эта колонка показывает, включена ли стоимость завтрака в стоимость проживания)<br>
+
|3
−
6.9. десятая и одиннадцатая ячейки - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на завтрак.<br>
+
|Адрес в интернете
−
6.10. двенадцатая и тринадцатая  - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на ланч<br>
+
|Не обрабатывается и не сопоставлении не участвует
−
6.11. четырнадцатая и пятнадцатая  - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на ланч. Все остальные колонки в импорте не участвуют.<br>
+
|-
−
7. Седьмая строка – период дат, для которого импортируются цены<br>
+
|4
 +
|Общий период
 +
|Общий период, за который вводятся цены
 +
|-
 +
|5
 +
|Строка заголовков
 +
| -
 +
|-
 +
|6
 +
|Строка заголовков
 +
| -
 +
|-
 +
|6.1
 +
|RoomCategory
 +
|Строка заголовков
 +
|-
 +
|6.2
 +
|SGL
 +
|Тип номера
 +
|-
 +
|6.3
 +
|DBL
 +
|Тип номера
 +
|-
 +
|6.4
 +
|Suite
 +
|Тип номера (при импорте не используется)
 +
|-
 +
|6.5
 +
|Apt
 +
|Дополнительные места для данной категории номера
 +
|-
 +
|6.6
 +
|Adult
 +
|Дополнительное размещение для взрослых
 +
|-
 +
|6.7
 +
|Child
 +
|Дополнительное размещение для детей
 +
|-
 +
|6.8
 +
|Meal
 +
|Включена ли стоимость завтрака в стоимость проживания
 +
|-
 +
|6.9
 +
|Adult и Child (размещение для взрослых, основное и дополнительное)
 +
|Типы размещения, для которых в нижеследующих колонках задаются цены на завтрак
 +
|-
 +
|6.10
 +
|Adult и Child (размещение для взрослых, основное и дополнительное)
 +
|Типы размещения, для которых в нижеследующих колонках задаются цены на ланч
 +
|-
 +
|6.11
 +
|Adult и Child (размещение для взрослых, основное и дополнительное)
 +
|Типы размещения, для которых в нижеследующих колонках задаются цены на ланч
 +
|-
 +
|7
 +
|Период дат
 +
|Период дат, для которого импортируются цены
 +
|-
 +
|}
 
</div></div><br />
 
</div></div><br />
−
[[Файл:Bm086.png|Шаблон_1]]<br><br>
+
 
 +
</div></div>
 +
[[Файл:Bm086.png|Шаблон_1]]<br>
  
 
<li>Шаблон 2<br></li>
 
<li>Шаблон 2<br></li>
Строка 186: Строка 249:
 
</div></div><br />
 
</div></div><br />
 
<br>[[Файл:Bm087.png|Шаблон_2]]<br><br>
 
<br>[[Файл:Bm087.png|Шаблон_2]]<br><br>
−
<li>Шаблон 3<br><br>[[Файл:Bm088.png|Шаблон_3]]<br><br></li>
+
<li>Шаблон 3<br></li>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 4»
 +
<div class="mw-collapsible-content">
 +
В таблице обязательно должны присутствовать колонки SGL, DBL либо UNIT, заменяющий их. При наличии всех трех, UNIT игнорируется. Если отсутствуют SGL и DBL, для импорта цен этих типов номеров используется значение UNIT. Для  DBL используется значение UNIT/2 , для SGL значение UNIT. Например, если UNIT = 100, а значения SGL и DBL в файле цен отсутствуют, то после импорта цены будут равны SGL = 100 и DBL = 50.<br>
 +
Все поля обязательны для заполнения. Если цена отсутствует, значение ячейки должно быть N/A.
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Партнер
 +
|Справочник партнера
 +
|-
 +
|2
 +
|Название отеля
 +
|Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
 +
|-
 +
|3
 +
|Валюта
 +
|Сопоставляется с валютами в ПК «Мастер-Тур» (справочник «Курс национальной валют»)
 +
|-
 +
|4
 +
|Страна
 +
|Название страны
 +
|-
 +
|5
 +
|Город
 +
|Название города
 +
|-
 +
|6.1
 +
|Начало таблицы
 +
|В колонке «А» ячейка со словом «FROM».
 +
|-
 +
|6.2
 +
|Конец таблицы
 +
|Найти  в колонке «А» первую пустую ячейку после ячейки со словом «FROM».
 +
|-
 +
|6.3
 +
|Строка с  заголовком
 +
|Это одна строка, в которой встретилось слово «FROM» из предыдущих пунктов.
 +
|-
 +
|6.4
 +
|Последней колонки таблицы
 +
|Последняя непустая ячейка в строке заголовков.
 +
|-
 +
|7
 +
|Даты заезда
 +
|Дата начала находится в колонке «А», первая дата начала – под  ячейкой со словом «FROM». Дата окончания всегда находится в ячейке столбца «В» рядом с датой начала. «дд/мм/гггг» – без пробелов, через прямой слеш.
 +
|-
 +
|8
 +
|Тип питания
 +
|Сопоставляется с типом питания в ПК «Мастер-Тур» (справочник «Типы питания»)
 +
|-
 +
|9
 +
|Тип номера
 +
|Сопоставляется с типом номера в ПК «Мастер-Тур» (справочник «Типы номеров»)
 +
|-
 +
|}
 +
</div></div><br />
 +
<br>[[Файл:Bm088.png|Шаблон_3]]<br><br>
 
<li>Шаблон 4<br></li>
 
<li>Шаблон 4<br></li>
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
Строка 286: Строка 411:
 
</div></div><br />
 
</div></div><br />
 
[[Файл:Bm090.png|Шаблон_5]]<br><br>
 
[[Файл:Bm090.png|Шаблон_5]]<br><br>
−
<li>Шаблон 6<br><br>[[Файл:Bm091.png|Шаблон_6]]<br><br></li>
+
 
−
<li>Шаблон 7<br><br>[[Файл:Bm092.png|Шаблон_7]]<br><br></li>
+
 
−
<li>Шаблон 8<br><br>[[Файл:Bm093.png|Шаблон_8]]<br><br></li>
+
<li>Шаблон 6<br></li>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 6»
 +
<div class="mw-collapsible-content">
 +
1. Данные с ценами, которые нужно импортировать в ПК «Мастер-Тур» должны начинаются  с первой колонки,
 +
третьей строки. <br>
 +
2. Количество пустых строк между таблицами не должно превышать 9.<br>
 +
3. Количество столбцов не ограничено.<br>
 +
4. В одной таблице цены должны быть только в одной валюте.<br>
 +
5. Импортируется только первый лист/страница, остальные игнорируются.<br>
 +
6. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.
 +
<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Название города и отеля
 +
|Данный текст (до скобок) сопоставляется с названием отеля в справочниках ПК «Мастер-тур» - ячейка A3
 +
|-
 +
|2
 +
|Категория номера
 +
|Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров») - ячейка A3
 +
|-
 +
|3
 +
|Acc.
 +
|Сопоставляется с типом питания в ПК «Мастер-Тур»
 +
|-
 +
|4
 +
|Checkin
 +
|Дата начала действия цены в формате дд.мм.гггг
 +
|-
 +
|5
 +
|Checkout
 +
|Дата окончания действия цены в формате дд.мм.гггг
 +
|-
 +
|6
 +
|Chk in
 +
|Поле игнорируется
 +
|-
 +
|7
 +
|Cur.
 +
|Валюта цены, сопоставляется с валютой ПК «Мастер-Тур»
 +
|-
 +
|8
 +
|Apply Date
 +
|Поле игнорируется
 +
|-
 +
|9
 +
|Тип номера
 +
|Первая строка в названии колонки - сопоставляется с типом номера (справочник «Типы номеров») в ПК «Мастер-Тур»
 +
|-
 +
|10
 +
|Тип размещения
 +
|Все, после первой строки в названии колонки - сопоставляется с типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур»
 +
|-
 +
|}
 +
</div></div><br />
 +
[[Файл:Bm091.png|Шаблон_6]]<br><br>
 +
 
 +
 
 +
<li>Шаблон 7<br></li>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 7»
 +
<div class="mw-collapsible-content">
 +
1. Данные, которые нужно импортировать в ПК «Мастер-Тур», должны начинаются  с первой колонки,
 +
второй строки. <br>
 +
2. Количество столбцов с ценами не ограничено.<br>
 +
3. Импортируется только первый лист/страница, остальные игнорируются.<br>
 +
4. На одном листе могут быть данные по нескольким отелям, расположенным в разных городах/странах, но от одного партнера.<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Страна
 +
|Русское название страны
 +
|-
 +
|2
 +
|Город 
 +
|Русское название города
 +
|-
 +
|3
 +
|Название отеля 
 +
|Поле Название справочника отелей
 +
|-
 +
|4
 +
|Тип питания
 +
|Код типа питания в справочнике питаний
 +
|-
 +
|5
 +
|Партнер
 +
|Сопоставляется с кратким названием партнера
 +
|-
 +
|6
 +
|Название пакета
 +
|Название туристического пакета
 +
|-
 +
|7
 +
|Валюта
 +
|Код валюты
 +
|-
 +
|8
 +
|Цена за
 +
|Сопоставляется с типом периода, за который указана цена, в диалоге импорта ПК «Мастер-Тур» это одноименное поле.
 +
|-
 +
|9
 +
|Цена на заезд
 +
|Если «Цена за» равно «Весь период», значение данного поля (число) вносится в колонки «Продолжительность с…» и «Продолжительность по…». Иначе поле игнорируется.
 +
|-
 +
|10
 +
|Room type
 +
|Тип номера
 +
|-
 +
|11
 +
|Room Category 
 +
|Категория номера
 +
|-
 +
|12
 +
|Accomm type
 +
|Тип размещения
 +
|-
 +
|13
 +
|Дни недели действия цены
 +
|Порядковые номера дней недели по порядку, без пробелов
 +
|-
 +
|14
 +
|Дата начала действия цены
 +
|В формате дд.мм.гггг
 +
|-
 +
|15
 +
|Дата окончания действия цены
 +
|В формате дд.мм.гггг
 +
|-
 +
|}
 +
</div></div><br />
 +
<br>[[Файл:Bm092.png|Шаблон_7]]<br><br>
 +
<li>Шаблон 8<br></li>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 8»
 +
<div class="mw-collapsible-content">
 +
1. Анализ данных в фале начинается с первой ячейки – то есть первая строка, первый столбец.<br>
 +
2. Количество столбцов с ценами не ограничено.<br>
 +
3. На одном листе могут быть данные только по одному отелю. В одном файле может быть заполнен только один лист.<br>
 +
4. Формат дат должен быть указан в формате дд.мм.гг-дд.мм.гг, с точностью до знака.<br>
 +
5. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Название отеля 
 +
|Сопоставляется с названием с названием отеля
 +
|-
 +
|2
 +
|Тип питания
 +
|Код типа питания в справочнике питаний
 +
|-
 +
|3
 +
|Период действия цены
 +
|В формате дд.мм.гг-дд.мм.гг
 +
|-
 +
|4
 +
|Тип номера: категория номера
 +
|Тип и категория номера. В строке с указанием типа и категории номера должен быть заполнен только первый столбец.
 +
|-
 +
|5
 +
|Тип размещения
 +
|Сопоставляется с типом размещения
 +
|-
 +
|}
 +
</div></div><br />
 +
<br>[[Файл:Bm093.png|Шаблон_8]]<br><br>
 
</ul>
 
</ul>
  
Строка 296: Строка 596:
 
[[Файл:473.PNG]]<br><br>
 
[[Файл:473.PNG]]<br><br>
  
−
В окне создания профиля нужно указать название профиля, назначить партнера из списка партнеров, указать цену за… — за какой период будет считаться цена (за ночь, за день, за весь период), указать валюту, страну, тип цены. В поле <b>Макрос</b> необходимо указать физический путь к файлу макроса, на основе которого будет формироваться профиль. В данном случае это файл <font style="font-family:courier new">macroShablon_X.cs</font>. Теперь в окне Список профилей отобразился созданный профиль с названием <font style="font-family:courier new">Shablon_X</font>.
+
В окне создания профиля нужно указать название профиля, назначить партнера из списка партнеров, указать цену за… — за какой период будет считаться цена (за ночь, за день, за весь период), указать валюту, страну, тип цены. В поле <b>Макрос</b> необходимо указать физический путь к файлу макроса, на основе которого будет формироваться профиль. В данном случае это файл <font style="font-family:courier new">macroShablon_X.cs</font>. Теперь в окне Список профилей отобразился созданный профиль с названием <font style="font-family:courier new">Shablon_X</font> После создания профиля cs файл сохраняется в базу данных и для работы файл с компьютера уже не используется.
  
 
[[Файл:474.PNG]]<br><br>
 
[[Файл:474.PNG]]<br><br>

Текущая версия на 11:02, 30 августа 2016

Введение

Обзор

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

  • C помощью плагина за одну операцию импорта можно загрузить цены на все отели для данного партнера.
  • Клиент может использовать уже готовые шаблоны, либо заказать разработку нового, если таблицы с ценами отеля-партнера по своему формату не подходят ни под один из существующих шаблонов.

Установка модуля

В ПК «Мастер-Тур» версии 2009.2 и выше модуль устанавливается путем обновления клиентской части — в рабочий каталог приложения копируются два файла:

  • Megatec.MasterTour.Plugins.PriceLists.Import.dll
  • Megatec.MasterTour.Plugins.Synchronization.dll

Работа с модулем

Доступ к данному модулю осуществляется из окна «Отели/Круизы (Цены)» раздела Справочники, далее Надстройки → Импорт прайс-листов.

Шаблон с перечнем цен (.xls-файл) связян с соответствующим макросом (.cs-файл). Плагин закачивает данные из исходного .xls-файла с ценами, приводит полученную информацию к стандартному формату при помощи макроса и загружает ее в БД Мастер-Тура.

Шаблоны

Перед импортом цен, в диалоговом окне предлагается выбирать партнера, пакет, параметры цены (за ночь, за день и т.п.), валюту цен, страну. Выбор этих параметров не влияет на импорт, так как в процессе будут учитываться значения обозначенные в файле цен, а не указанные в диалоге. Однако, выбор партнера в диалоге определяет, для какого партнера будут сохранены сделанные сопоставления.
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):

  • Эталонный шаблон
    • развернуть

    Правила импорта для «Эталонный шаблон»



    Эталонный шаблон

Для модуля Импорт прайс-листов разработаны следующие шаблоны:

  • Шаблон 1
    • развернуть

    Правила импорта для «Шаблон 1»


    Шаблон_1

  • Шаблон 2
    • развернуть

    Правила импорта для «Шаблон 2»



    Шаблон_2

  • Шаблон 3
    • развернуть

    Правила импорта для «Шаблон 4»



    Шаблон_3

  • Шаблон 4
    • развернуть

    Правила импорта для «Шаблон 4»


    Шаблон_4

  • Шаблон 5
    • развернуть

    Правила импорта для «Шаблон 5»


    Шаблон_5


  • Шаблон 6
    • развернуть

    Правила импорта для «Шаблон 6»


    Шаблон_6


  • Шаблон 7
    • развернуть

    Правила импорта для «Шаблон 7»



    Шаблон_7

  • Шаблон 8
    • развернуть

    Правила импорта для «Шаблон 8»



    Шаблон_8

Формирование нового профиля

Для начала нужно создать профиль для импорта. Окно создания профиля вызывается при нажатии кнопки Обзор в окне Импорт прайс-листа, далее в окне Список профилей нажатием на кнопку Добавить новый элемент.

473.PNG

В окне создания профиля нужно указать название профиля, назначить партнера из списка партнеров, указать цену за… — за какой период будет считаться цена (за ночь, за день, за весь период), указать валюту, страну, тип цены. В поле Макрос необходимо указать физический путь к файлу макроса, на основе которого будет формироваться профиль. В данном случае это файл macroShablon_X.cs. Теперь в окне Список профилей отобразился созданный профиль с названием Shablon_X После создания профиля cs файл сохраняется в базу данных и для работы файл с компьютера уже не используется.

474.PNG

Импорт прайс-листа на основе профиля

Теперь можно приступить к самому импорту прайс-листа на основе профиля:

475.PNG

В поле Профиль для импорта выбираем созданный профиль с названием Shablon_X. Все данные, выбранные при создании этого профиля, автоматически перенеслись сюда. Можно выбрать название тура из списка Пакет, а также обязательно нужно указать физический путь к .xls-файлу шаблона, из которого будут импортироваться цены. В данном случае это файл Shablon_X.xls. После этого нажимаем кнопку Импорт — происходит сопоставление (синхронизация) всех предложенных надстройкой параметров из выбранного файла с соответствующими значениями в БД Мастер-Тура.

476.PNG

Если найдено значение, которое невозможно сопоставить автоматически, выводится диалог сопоставления справочников. В таком случае нужно выбрать из списка соответствующее значение. Если сопоставимого значения не существует в базе данных, его можно добавить в соответствующий справочник Мастер-Тура, нажав на кнопку Открыть справочник. После синхронизации всех справочных значений откроется предварительное окно перед импортом прайс-листа, где можно просмотреть, что с чем синхронизировалось:

477.PNG

При нажатии на кнопку Excel можно просмотреть исходные данные, преобразованные в стандартный формат (в эталонный шаблон):

478.PNG

Для завершения процедуры нажмите Импорт. Загруженные цены отображаются в окне «Отели/Круизы (Цены)»:

479.PNG

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