1924
правки
Изменения
Нет описания правки
== Пример создания простого шаблона для загрузки вложений ==
Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel» ''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:
Редактирование шаблонов доступно путем нажатия на кнопку '''«Шаблоны…»'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши '''«F3»'''.
Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''«значение» ''' пустое – программа использует значение поля '''«значение по умолчанию»'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).
Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''“пример”'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:
'''Примечание: ''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.
Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…» ''' в окне '''“Импорт из Excel”'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''“пример”'''.
Для поля '''“Адрес получателя” ''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) – помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…» ''' в окне '''«Импорт из Excel»'''.
Описание других полей интуитивно понятно и не требует дополнительных комментариев.
В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).
Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно» ''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)» ''' ввести следующий скрипт (первая строка должна быть пустой [ссылка]):
<code>
Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса» ''' и '''«цена» ''' вложений в карточке корреспонденции.
Далее переходим во вкладку '''«Вложения»''':
Ставим галку '''«Загружать вложения»'''.
Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.
Поле '''«Код товара» ''' используется как артикул в номенклатуре поставщика (актуально при использовании модуля складского учёта, см. раздел Модуль складского учета). В нашем случае оно пустое.
Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона “пример” происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель» ''' единицы корреспонденции заполняются следующим образом:
*Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.
Поля на вкладке '''«Вложения» ''' единицы корреспонденции заполнятся так:
После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''“Cтарт” ''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:
Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданныхв шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса» ''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ №120340) и продолжить работу в программе:
== Важные примечания Примечания ==
Примеры построения простых шаблонов рассмотрены в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в систему КС2008).
Любой шаблон может быть выгружен/загружен из системы и сохранен в виде внешнего файла (в формате XML) из контекстного меню '''"Сохранить в файл"/"Добавить из файла" ''' в окне общего списка шаблонов системы (кнопка '''"Шаблоны"'''). Однако, при процедуре импорта/экспорта шаблона не копируется вкладка '''"Услуги"''', которая предназначена для загрузки дополнительных услуг из реестра. Это связано с тем, что в каждой системе порядок следования и название услуг могут отличаться. Настройки этой вкладки требуется однократно выполнять в ручном режиме после импорта шаблона.
[[Файл:vlog_12.png|center]]
