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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][непроверенная версия]
(→‎Шаблоны)
(→‎Шаблоны)
Строка 21: Строка 21:
  
 
===Шаблоны===
 
===Шаблоны===
 +
Перед импортом цен, в диалоговом окне предлагается выбирать партнера, пакет, параметры цены (за ночь, за день и т.п.), валюту цен, страну. Выбор этих параметров не влияет на импорт, так как в процессе будут учитываться значения обозначенные в файле цен, а не указанные в диалоге. Однако, выбор партнера в диалоге определяет, для какого партнера будут сохранены сделанные сопоставления.<br>
 
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
 
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Эталонный шаблон»
 +
<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
 +
|Дата окончания действия цены
 +
|В формате дд.мм.гггг
 +
|-
 +
|11
 +
|Продолжительность
 +
|Импортируется в колонки «Продолжительность с…» и «Продолжительность по…»
 +
|-
 +
|12
 +
|Нетто и брутто по первому дню
 +
|Если 2 - равносильно отмеченному чек-боксу в диалоге импорта; 1 - чек-бокс не отмечен; 0 - анализируется, был ли отмечен чек-бокс в форме и учитывается это значение.
 +
|-
 +
|13
 +
|Room type
 +
|Тип номера
 +
|-
 +
|14
 +
|Room Category
 +
|Категория номера
 +
|-
 +
|15
 +
|Accomm type
 +
|Тип размещения
 +
|-
 +
|16
 +
|Дни недели действия цены
 +
|Порядковые номера дней недели по порядку, без пробелов. Дни первой строки соответствуют ценам первой строки, дни второй ценам второй и т.д.
 +
|-
 +
|}
 +
</div></div><br />
 
<ul>
 
<ul>
 
<li>Эталонный шаблон<br><br>[[Файл:471.PNG|Эталонный шаблон]]<br><br></li>
 
<li>Эталонный шаблон<br><br>[[Файл:471.PNG|Эталонный шаблон]]<br><br></li>
Строка 28: Строка 108:
 
Для модуля <b>Импорт прайс-листов</b> разработаны следующие шаблоны:
 
Для модуля <b>Импорт прайс-листов</b> разработаны следующие шаблоны:
 
<ul>
 
<ul>
−
<li>Шаблон 1<br><br>[[Файл:Bm086.png|Шаблон_1]]<br><br></li>
+
<li>Шаблон 1<br></li>
−
<li>Шаблон 2<br><br>[[Файл:Bm087.png|Шаблон_2]]<br><br></li>
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 1»
 +
<div class="mw-collapsible-content">
 +
1. Файл состоит из нескольких таблиц с ценами, каждая таблица – новый отель. <br>  
 +
2. Заголовка перед таблицами нет, первая непустая строка – начало таблицы с ценами. <br>
 +
3. Таблицы разделяются пустыми строками. <br>
 +
4. Во всем файле первая колонка не заполнена, поэтому пустой считается строка, у которой не заполнена вторая ячейка. <br>
 +
5. ''Все строки рассматриваются начиная со второй ячейки''.<br>
 +
'''Ограничения'''<br>
 +
Данные, которые содержатся между таблицами с ценами, не обрабатываются.
 +
Вся информация находится на первом листе xls-файла.
 +
Файл не должен быть защищен паролем и не должен содержать макросов (т.е. должен открываться сразу).<br>
 +
'''Разбор таблицы с ценами'''<br>
 +
1. Первая строка – название отеля, через запятую категория отеля (звездность), через запятую город отеля.<br>
 +
2. Вторая строка – адрес отеля (не обрабатывается и в сопоставлении не участвует).<br>
 +
3. Третья строка – адрес сайта отеля (не обрабатывается и не сопоставлении не участвует).<br>
 +
4. Четвертая строка содержит общий период, за который вводятся цены (при импорте не используется – используются конкретные периоды из соответствующих ячеек), валюту, возраст детей, соответствующий детскому размещению<br>
 +
5. Пятая строка – строка заголовков<br>
 +
6. Шестая строка – строка заголовков: <br>
 +
6.1. первые две ячейки – «RoomCategory», <br>
 +
6.2. третья ячейка – тип номера «SGL» (одноместный номер)<br>
 +
6.3. четвертая  ячейка – тип номера «DBL» (двухместный номер)<br>
 +
6.4. пятая ячейка -  тип номера «Suite» (при импорте не используется)<br>
 +
6.5. шестая ячейка – «Apt» (эта колонка показывает, есть ли дополнительные места для данной категории номера)<br>
 +
6.6. седьмая ячейка – тип размещения «Adult» (дополнительное  размещение для взрослых)<br>
 +
6.7. восьмая ячейка – тип размещения «Child» (дополнительное размещение для детей)<br>
 +
6.8. девятая ячейка – «Meal» (эта колонка показывает, включена ли стоимость завтрака в стоимость проживания)<br>
 +
6.9. десятая и одиннадцатая ячейки - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на завтрак.<br>
 +
6.10. двенадцатая и тринадцатая  - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на ланч<br>
 +
6.11. четырнадцатая и пятнадцатая  - типы размещения «Adult» (размещение для взрослых, основное и дополнительное) и «Child» (размещение для детей, основное и дополнительное), для которых в нижеследующих колонках задаются цены на ланч<br>
 +
Все остальные колонки в импорте не участвуют.
 +
7. Седьмая строка – период дат, для которого импортируются цены<br>
 +
</div></div><br />
 +
[[Файл:Bm086.png|Шаблон_1]]<br><br>
 +
 
 +
<li>Шаблон 2<br></li>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 2»
 +
<div class="mw-collapsible-content">
 +
1. В одной таблице цены должны быть только в одной валюте.<br>
 +
2. Импортируется только первый лист/страница, остальные игнорируются.<br>
 +
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Название отеля
 +
|Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
 +
|-
 +
|2
 +
|Тип питания
 +
|Сопоставляется с типом питания в ПК «Мастер-Тур» (справочник «Типы питания»)
 +
|-
 +
|3
 +
|Категория комнаты
 +
|Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
 +
|-
 +
|4
 +
|Период действия цены
 +
|Дата начала действия цены в формате дд.мм.гггг - Дата окончания действия цены в формате дд.мм.гггг
 +
|-
 +
|5
 +
|RELEASE PERIOD
 +
|Релиз-период
 +
|-
 +
|6
 +
|Тип номера
 +
|Сопоставляется с типом номера в ПК «Мастер-Тур» (справочник «Типы номеров»)
 +
|-
 +
|7
 +
|Цена
 +
|Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат
 +
|-
 +
|}
 +
</div></div><br />
 +
<br>[[Файл:Bm087.png|Шаблон_2]]<br><br>
 
<li>Шаблон 3<br><br>[[Файл:Bm088.png|Шаблон_3]]<br><br></li>
 
<li>Шаблон 3<br><br>[[Файл:Bm088.png|Шаблон_3]]<br><br></li>
−
<li>Шаблон 4<br><br>[[Файл:Bm089.png|Шаблон_4]]<br><br></li>
+
<li>Шаблон 4<br></li>
−
<li>Шаблон 5<br><br>[[Файл:Bm090.png|Шаблон_5]]<br><br></li>
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 4»
 +
<div class="mw-collapsible-content">
 +
1.Данные с ценами, которые нужно импортировать в ПК «Мастер-Тур» должны начинаться с колонки содержащей текст «Расчетные цены». Все данные, содержащиеся в таблице, начинающейся в этой колонке будут импортированы в ПК «Мастер-Тур», данные содержащиеся левее этой колонки и данные в отдельных таблицах правее будут проигнорированы.<br>
 +
2.По горизонтали цены на каждое новое средство размещения(Отель, пансионат, круизный лайнер) должны начинаться с названия средства размещения. Максимальное количество строк между двумя таблицами цен 20.<br>
 +
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Расчетные цены
 +
|Колонка, с которой начинаются данные для импорта в ПК «Мастер-Тур»
 +
|-
 +
|2
 +
|Название отеля
 +
|Сопоставляется с названием отеля из справочника ПК «Мастер-Тур»
 +
|-
 +
|3
 +
|Тип питания
 +
|Единожды сопоставляется с типом питания в ПК «Мастер-Тур»
 +
|-
 +
|4
 +
|Категория номера
 +
|Единожды сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
 +
|-
 +
|5
 +
|Тип размещения
 +
|Единожды сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур»
 +
|-
 +
|6
 +
|Период действия цен
 +
|Период действия цены в формате дд.мм.гг-дд.мм.гг
 +
|-
 +
|7
 +
|Цена
 +
|Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат
 +
|-
 +
|}
 +
</div></div><br />
 +
[[Файл:Bm089.png|Шаблон_4]]<br>
 +
<li>Шаблон 5<br></li>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:650px">
 +
Правила импорта для «Шаблон 5»
 +
<div class="mw-collapsible-content">
 +
1. Формат данных и названий полей таблицы должен  строго соответствовать примеру. <br>
 +
2. Если отсутствует значение цены или времени пребывания, ячейка должна содержать 0.<br>
 +
3. В файле цен допустима только одна страница (или лист). Данные на других страницах игнорируются.<br>
 +
{| class="wikitable"
 +
! scope="col" width="70px" | Поле в примере
 +
! scope="col" width="200px" | Содержание поля
 +
! scope="col" width="300px" | Правила импорта в МТ
 +
|-
 +
|1
 +
|Data_from
 +
|Период начала действия цены в формате дд/мм/гггг
 +
|-
 +
|2
 +
|Data_to
 +
|Период окончания действия цены в формате дд/мм/гггг
 +
|-
 +
|3
 +
|Страна
 +
|Сопоставляется с названием страны из справочника ПК «Мастер-Тур»
 +
|-
 +
|4
 +
|Город
 +
|Сопоставляется с названием города из справочника ПК «Мастер-Тур»
 +
|-
 +
|5
 +
|Название отеля
 +
|Сопоставляется с названием отеля из справочника ПК «Мастер-Тур»
 +
|-
 +
|6
 +
|Вид номера
 +
|Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
 +
|-
 +
|7
 +
|Тип размещения + Тип Номера
 +
|Сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур»
 +
|-
 +
|8
 +
|Время пребывания
 +
|Соответствует значению поля «Продолжительность по…» экрана цен ПК «Мастер-тур»
 +
Начиная с релиза 2009.2.16 существует возможность в поле «Время пребывания» задавать продолжительность в виде «x-y», где х – значение, которое будет записано в поле «Продолжительность с», y – значение, которое будет записано в поле «Продолжительность по».
 +
|-
 +
|9
 +
|Питание
 +
|Сопоставляется с типом питания в ПК «Мастер-Тур»
 +
|-
 +
|10
 +
|Цена
 +
|Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат
 +
|-
 +
|}
 +
</div></div><br />
 +
[[Файл:Bm090.png|Шаблон_5]]<br><br>
 
<li>Шаблон 6<br><br>[[Файл:Bm091.png|Шаблон_6]]<br><br></li>
 
<li>Шаблон 6<br><br>[[Файл:Bm091.png|Шаблон_6]]<br><br></li>
 
<li>Шаблон 7<br><br>[[Файл:Bm092.png|Шаблон_7]]<br><br></li>
 
<li>Шаблон 7<br><br>[[Файл:Bm092.png|Шаблон_7]]<br><br></li>

Версия 09:39, 7 мая 2015

Введение

Обзор

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

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

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

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

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

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

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

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

Шаблоны

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

развернуть

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


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

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

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

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

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


    Шаблон_1

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

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



    Шаблон_2

  • Шаблон 3

    Шаблон_3

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

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


    Шаблон_4

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

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


    Шаблон_5

  • Шаблон 6

    Шаблон_6

  • Шаблон 7

    Шаблон_7

  • Шаблон 8

    Шаблон_8

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

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

473.PNG

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

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=15640»