Импорт баз данных — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м (Пример создания простого шаблона для загрузки вложений)
м (Шаблон как отдельный файл)
 
(не показано 13 промежуточных версий 2 участников)
Строка 1: Строка 1:
== Пример создания простого шаблона ==
+
== Логика загрузки заказов ==
  
Для импорта базы рассылки в формате MS Excel или DBF (а также любого другого формата, поддерживаемого MS Excel), создайте заказ, в который необходимо импортировать, потом в главном меню основного окна программы выберите пункт «Связь» → «Импорт БД из Excel» (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:
+
Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.
  
[[Файл:Импорт из Excel.png|center]]
+
Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».
  
 +
В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.
  
В окне импорта необходимо выбрать заказ, в который нужно импортировать базу, шаблон загрузки, а также указать имя файла-источника, из которого необходимо загружать.  
+
В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.
  
Редактирование шаблонов доступно путем нажатия на кнопку «Шаблоны…».<br />
+
MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].
Шаблон состоит из заголовка, который в себя включает название шаблона, номер первой загружаемой строки в файле, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки может задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля (кратко по-английски), описания (развернуто по-русски), значения по умолчанию, и значения. Если поле «значение» пустое – система использует значение поля «значение по умолчанию». Поля «значение» и «значение по умолчанию» описывают преобразования данных на [[Руководство программиста|внутреннем языке разработки]].
 
  
Процесс импорта реестра заказов из excel в систему будет выполнен на примере построения шаблона с именем “Example”. На рисунке ниже изображено содержимое excel файла с заказами клиента. Набор столбцов реестра – типовой и содержит 13 полей, по желанию набор полей можно расширить или же сократить.
+
== Создание шаблона загрузки ==
 +
Чтобы создать шаблон:
 +
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
 +
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]
  
 +
Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.
  
[[Файл:Excel_шаблон.png|850px|center]]
+
'''Примечание'''. Не рекомендуем самостоятельно писать скрипты для вкладок '''Дополнительно'''. Если надо изменить логику обработки заказов, обратитесь в службу поддержки MeaSoft.
  
 +
'''Поля вкладки «Основное»'''
  
'''Примечание: '''На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-M), однако данное представление в пакете MS Office может отличаться от привычного - иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов excel - соответствие цифровой нумерации буквенной  происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘a’, 2-‘b’, 3-‘c’ и т.д.)
+
'''Название'''. Укажите название шаблона.
  
[[Файл:R1C1.png|center]]
+
'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.
  
 +
'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.
  
'''Примечание: '''Обработка программой реестра заказов из excel файла происходит с первой вкладки документа, поэтому таблица заказов должна находиться на первой вкладке.  
+
'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
 +
* условие выполнено — формируется новый заказ из строки;
 +
* условие не выполнено — пропускает строку и переходит к следующей.
  
Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку «Шаблоны…» в окне “Импорт из Excel”. Буквенные соответствия столбцов excel файла указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем “Example”. Для поля “Адрес получателя” указано значение с функцией MakeAddress(буква столбца с адресом из реестра в excel файле). Функция MakeAddress(s) – помогает и позволяет синтакcически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Описание других полей интуитивно понятно и не требует дополнительных комментариев.
+
'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.
  
 +
'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.
  
[[Файл:Template1.png|550px|center]]
+
'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.
  
 +
'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.
  
На рисунке ниже для двух полей периода времени доставки “c”-“до” производится автоматическое добавление символов разрядности минут “:00”, приводящее содержимое загружаемой ячейки excel к внутреннему стандарту программы. Дополнительно для поля “Поручение” производится автоматическое суммирование содержимого ячеек excel “i+l”, при этом содержимое двух ячеек дополнительно разделяется запятой с пробелом.
+
'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.
  
 +
'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.
  
[[Файл:Template2.png|550px|center]]
+
В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
 +
* '''Поле''' — внутреннее имя параметра заказа;
 +
* '''Название''' — название параметра в MeaSoft;
 +
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
 +
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».
  
 +
Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.
  
Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона “Example” происходит в соответствии со структурой и содержимым ячеек реестра в excel файле.
+
== Как указать лист с заказами в Excel-файле ==
 +
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
 +
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
 +
# Перейдите на вкладку '''Дополнительно'''.
 +
# В поле '''Скрипт до загрузки''' напишите формулу:
 +
<?>
 +
SetSheet(х);
  
 +
В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.
  
[[Файл:Zakaz2.png|700px|center]]
+
== Как загрузить заказы ==
  
 +
=== Загрузка из одного файла ===
 +
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
 +
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
 +
# Перейдите на вкладку '''Заказы''' и создайте новый [[Работа с заказами#Карточка заказа|заказ]].
 +
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel'''. Откроется окно «Импорт из Excel»:[[Файл:Импорт из эксель.png|none]]
 +
# В поле '''Формат''' выберите шаблон импорта.
 +
# В поле '''Заказ''' укажите номер созданного заказа или выберите его из списка по кнопке [[Файл:More.png]]. В этот заказ будут загружены данные файла.
 +
# В поле '''Файл''' нажмите на кнопку [[Файл:More.png]] справа и укажите путь к файлу MS Excel с информацией о заказах.
 +
# Нажмите '''Старт''', чтобы начать импорт данных.
  
После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из excel файла. Для этого в окне Импорт из Excel, последовательно указываем тип шаблона для обработки реестра заказов в excel, номер заказа и файл реестра. По нажатию на кнопку “Cтарт” происходит последовательная обработка строк excel файла, ячейки которой считываются в БД заказов программы “КС 2008”. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей.
+
=== Загрузка из нескольких файлов ===
 +
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
 +
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
 +
# В главном меню выберите '''Связь''' > '''Импорт БД из папки'''. Откроется окно «Импорт из папки»:[[Файл:Importfromfolder.png|none]]
 +
# В поле '''Папка''' нажмите на кнопку [[Файл:More.png]] справа и укажите укажите путь к папке с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
 +
# В поле '''Клиент''' укажите название клиента, для которого будет создан заказ. В поле работает автозаполнение при вводе.
 +
# В списке '''Шаблон''' выберите шаблон импорта для обработки первого файла в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
 +
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка, в панели внизу отобразится отчет о количестве обработанных записей.
 +
# Если в списке остались элементы, повторите действия, начиная с пункта 4, для следующего файла.
  
[[Файл:Import.png|center]]
+
==Автозамена==
  
== Примеры модификаций содержимого ячеек при помощи формул ==
+
При оформлении заказа клиенты и покупатели могут указывать один и тот же адрес в разных форматах, что ведет к ошибкам [[Модуль_«Карта»#Геокодирование|геокодирования]].
  
Иногда, для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться специальными функциями (полное описание языка приведено по ссылке http://wiki.courierexe.ru/index.php/Руководство_программиста). Простые примеры применения данных функций рассмотрены ниже:
+
Чтобы привести адрес к [[Знакомство_с_программой#Ввод адресной информации|требуемому формату]], вы можете настроить правила автозамены для загруженных извне заказов. Для выполнения операции требуются права «Администрирование».
 
  
'''1.'''Пример содержимого ячейки Excel “F”: “Россия, Москва, Горького ул., д. 23”
+
Чтобы настроить автозамену:
 +
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel''' и в окне «Импорт из Excel» нажмите на кнопку '''Автозамена'''. Откроется окно «Настройка автозамены»:[[Файл:Настройка автозамены.png|none]]
 +
# Нажмите F3 и создайте новое правило автозамены. При нажатии на кнопку '''ОК''' в списке правил добавится еще одна строка.<br>Чтобы изменить правило, щелкните дважды на его строке. Чтобы удалить правило, используйте комбинацию клавиш CTRL+F8.
 +
# После создания правил с помощью кнопок '''Вверх''' и '''Вниз''' определите их порядок. Автозамены применяются к адресу последовательно сверху вниз.
  
Задача: Копировать  из ячейки слово "Москва".
+
Автозамену можно отключить для определенных режимов срочности. Для этого в справочнике '''Статусы''' > '''17 Виды срочности''' для режима срочности установите 7 параметр первой строки в значение 1. Подробнее см. раздел «[[Виды срочности]]».
  
Решение: '''PARAM(replace(f, ' ', ','), 2)'''
+
Автозамены, предусмотренные исходным кодом системы:
 +
* следующие слова удаляются из начала адреса еще до срабатывания пользовательской автозамены:
 +
вул.,ул.,пр.,проспект,проезд,шоссе ,шоссе,аллея,ул ,пр-д,пер.,пер ,ул ,пр ,пр-т,пр-кт,бульвар,бул.,бул ,набережная,наб.,наб
  
Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем "Москва".
+
* если улица не найдена, но в справочнике есть другая улица, название которой отличается на одну букву, срабатывает подмена одной буквы в названии улицы. Если улица была указана корректно, укажите ее вручную. Система «запомнит» эту улицу, и ошибка больше не повторится.
  
 +
== Шаблон как отдельный файл ==
 +
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
 +
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}
  
'''2.'''Пример содержимого ячейки Excel “J”: “с 11 до 18”
+
=== Сохранить шаблон в файл ===
 +
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
 +
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
 +
# Нажмите '''Сохранить в файл'''.
 +
# Выберите папку и нажмите '''Сохранить'''.
  
Задача А: приведение строки к стандартному типу времени ЧЧ:ММ  (например, для времени доставки).  Необходимо к значению времени “11” добавить значение “:00”.
+
Сохранение шаблона:
 +
[[Файл:Vlog 12_1.png|center|300px]]
  
Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''
+
=== Добавить в систему шаблон из файла ===
 +
# Перейдите в '''Связь''' '''Импорт БД из Excel''' → '''Шаблоны'''.
 +
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
 +
# Нажмите '''Добавить из файла'''.
 +
# Выберите XML-файл шаблона и нажмите '''Открыть'''.
  
Комментарий: Поиском слева ищем в строке значение “c”, после читаем второй параметр, разделенный символом пробел – число “11”, затем к нему прибавляем  значение “:00”. На выходе получаем “11:00”.
+
Загрузка шаблона:
 +
[[Файл:Vlog 12_2.png|center|300px]]
  
Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ  (например, для времени доставки). Необходимо к значению времени “18” добавить значение “:00”.
+
== Пример создания простого шаблона для загрузки вложений ==
 +
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}
  
Решение: '''RIGHT(J, 2)+':00''''
+
Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:
  
Комментарий: Копируем справа от начала строки 2 символа – значение  ”18”, затем к нему прибавляем  значение “:00”. На выходе получаем “18:00”.
 
  
 +
[[Файл:vlog 1.png|none]]
  
'''3.'''Пример содержимого ячейки Excel “A”: “'забор груза'”, либо “'забор'”
 
  
Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова “'забор груза'”, либо “'забор'” – подставлять в ячейку цифру “0”,  
+
В окне импорта выберите имя (формат) шаблона загрузки, заказ, в который необходимо импортировать базу, а также указать имя файла-источника, из которого необходимо загружать реестр:
иначе подставлять следующий порядковый номер.
 
  
Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''
 
  
Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается – подставиться значение “0”, если не соблюдается - подставлять следующий порядковый номер (функция GetNewNumber).
+
[[Файл:vlog 2.png|none]]
  
  
'''4.'''Пример содержимого ячейки Excel “K” -“забрать документы”, содержимого ячейки Excel “L” - “поставить печать”:
+
Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.
  
Задача: сложить одержимое двух ячеек для загрузки поля “поручение курьера”.  
+
Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).
  
Решение: '''k+', '+l'''
+
Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:
  
Комментарий:  Выполняем сложение содержимого двух ячеек “K” и “L”, разделенного запятой и пробелом. На выходе получаем “забрать документы, поставить печать”.
 
  
 +
[[Файл:vlog_3.png|none|1000px]]
  
'''5.'''Пример содержимого ячейки “масса, грамм” в Excel “N”: “2500”
 
  
Задача: Перевод значения ячейки “масса” из грамм в килограмм.  
+
В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.
  
Решение: '''n/1000'''
+
Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):
  
Комментарий:  Выполняем операцию деления. На выходе получаем значение для поля масса “2.5 ”.
 
  
 +
[[Файл:vlog 4.png|none]]
  
'''6.'''Пример расчета сроков доставки
 
  
Задача: Рассчитать планируемую дату доставки на основе [[Справочники#Тарифы для междугородной доставки|сроков доставки]]
+
'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.
  
Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''
+
Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.
  
Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg - дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source - код клиента, по нему будет найден тариф с указанными сроками. Mode - режим срочности. TownTo, TownFrom - коды городов отправителя и получателя.
+
Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.
Примечание:
 
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate
 
  
== Пример создания простого шаблона для загрузки вложений ==
+
Описание других полей интуитивно понятно и не требует дополнительных комментариев.
  
Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем,  в главном меню основного окна программы  выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:
 
  
 +
[[Файл:vlog 5.png|none]]
  
[[Файл:vlog_1.png|center]]
 
  
 +
В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).
  
В окне импорта выберите имя (формат) шаблона загрузки, заказ, в который необходимо импортировать базу, а также указать имя файла-источника, из которого необходимо загружать реестр:
+
Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):
  
  
[[Файл:vlog_2.png|center]]
+
Query update address a join
 +
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
 +
        sum(b.kol_vo) as kol_vo
 +
  from address a join boxes b on b.address=a.code
 +
  where a.zakaz=%zakaz%
 +
  group by b.address) b on a.code=b.address
 +
set
 +
a.kol_vo=b.kol_vo,
 +
a.rur=b.price,
 +
a.mass=CalcAddressMass(a.code)
 +
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null
  
 +
[[Файл:vlog 6.png|none]]
  
Редактирование шаблонов доступно путем нажатия на кнопку '''«Шаблоны…»'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши '''«F3»'''.
 
  
Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''«значение»''' пустое – программа использует значение поля '''«значение по умолчанию»'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).
+
Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.
  
Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''“пример”'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:
+
Далее переходим во вкладку '''«Вложения»''':
  
  
[[Файл:vlog_3.png|center]]
+
[[Файл:vlog 7.png|none]]
  
  
В данном реестре мы видим, что заказы №1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами №4-6.  
+
Ставим галку '''«Загружать вложения»'''.
  
Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel - соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т.д.):
+
Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.
  
 +
Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.
  
[[Файл:vlog_4.png|center]]
+
Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:
  
  
'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.
+
[[Файл:vlog 8.png|none]]
  
Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''“Импорт из Excel”'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''“пример”'''.
 
  
Для поля '''“Адрес получателя”''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) – помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.
+
* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.
  
Описание других полей интуитивно понятно и не требует дополнительных комментариев.
+
Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:
  
  
[[Файл:vlog_5.png|center]]
+
[[Файл:vlog 9.png|none]]
  
 +
 +
После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:
  
В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).
 
  
Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой [ссылка]):
+
[[Файл:vlog 10.png|none]]
  
  
Query update address a join
+
Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
+
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:
        sum(b.kol_vo) as kol_vo
 
  from address a join boxes b on b.address=a.code
 
  where a.zakaz=%zakaz%
 
  group by b.address) b on a.code=b.address
 
set
 
a.kol_vo=b.kol_vo,
 
a.rur=b.price,
 
a.mass=b.mass
 
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null
 
  
[[Файл:vlog_6.png|center]]
 
  
 +
[[Файл:vlog_11.png|none|1000px]]
  
Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.
+
== Примеры модификаций содержимого ячеек при помощи формул ==
 +
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.
 +
   
  
Далее переходим во вкладку '''«Вложения»''':  
+
'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»
  
 +
Задача: Копировать из ячейки слово «Москва».
  
[[Файл:vlog_7.png|center]]
+
Решение: '''PARAM(replace(f, ' ', ','), 2)'''
  
 +
Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».
  
Ставим галку '''«Загружать вложения»'''.
 
  
Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.
+
'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»
  
Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Ввод данных|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.
+
Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».
  
Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона “пример” происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:
+
Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''
  
 +
Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».
  
[[Файл:vlog_8.png|center]]
+
Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».
  
 +
Решение: '''RIGHT(J, 2)+':00''''
  
*Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.
+
Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».
  
Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:
 
  
 +
'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»
  
[[Файл:vlog_9.png|center]]
+
Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
 +
иначе подставлять следующий порядковый номер.
  
+
Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''
После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''“Cтарт”''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в  базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:
 
  
 +
Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).
  
[[Файл:vlog_10.png|center]]
 
  
 +
'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:
  
Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
+
Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ №120340) и продолжить работу в программе:
 
  
 +
Решение: '''k+', '+l'''
  
[[Файл:vlog_11.png|center]]
+
Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».
  
== Примечания ==
 
  
Примеры построения простых шаблонов рассмотрены в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в систему КС2008).
+
'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»
  
Любой шаблон может быть выгружен/загружен из системы и сохранен в виде внешнего файла (в формате XML) из контекстного меню '''"Сохранить в файл"/"Добавить из файла"''' в окне общего списка шаблонов системы (кнопка '''"Шаблоны"'''). Однако, при процедуре импорта/экспорта шаблона не копируется вкладка '''"Услуги"''', которая предназначена для загрузки дополнительных услуг из реестра. Это связано с тем, что в каждой системе порядок следования и название услуг могут отличаться. Настройки этой вкладки требуется однократно выполнять в ручном режиме после импорта шаблона.
+
Задача: Перевод значения ячейки «масса» из грамм в килограмм.
  
[[Файл:vlog_12.png|center]]
+
Решение: '''n/1000'''
  
 +
Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".
  
== Групповая загрузка файлов-реестров из папки ==
 
[[Файл:Importfromfolder.png|thumb|250px|right|'''рис.1 Интерфейс групповой загрузки фалов-реестров''']]
 
В системе предусмотрена возможность групповой обработки файлов с реестром через основное меню '''"Связь - Импорт БД из папки"'''. Интерфейс такой загрузки представлен на рисунке. Процедура группового импорта представляет собой следующий алгоритм действий пользователя:
 
  
1.В поле '''"Папка"''' кнопкой выбрать папку, в которой находятся предполагаемые к загрузке файлы-реестров в формате Excel. Содержимое выбранной папки отобразится в виде списка файлов в окне интерфейса (отображаются все файлы Excel вне зависимости от их содержимого).
+
'''6.'''Пример расчета сроков доставки
  
2.В поле '''"Клиент"''' указать название клиента, для которого система автоматически создаст новый заказ на вкладке '''"Заказы"'''.
+
Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]
  
3.В поле '''"Шаблон"''' указать тип шаблона, соответствующего самому верхнему реестру в списке. Очевидно, что для удобства обработки, имя каждого файла реестра должно содержать название клиента и(-или) название шаблона загрузки.
+
Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''
  
4.Кнопка '''"Загрузить"''' обработает первый верхний файл списка (отображаемый в среднем окне интерфейса). После успешной загрузки реестра, загруженный файл исчезнет из списка.
+
Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
 
+
Примечание:
5.Процедура циклически повторяется начиная с п.1 для каждого файла-реестра (пока список в среднем окне не будет пуст).
+
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Текущая версия на 12:55, 31 мая 2022

Логика загрузки заказов

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье «Руководство программиста». Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. на официальном сайте Microsoft Office.

Создание шаблона загрузки

Чтобы создать шаблон:

  1. Перейдите в Связь > Импорт БД из Excel, затем в окне «Импорт из Excel» нажмите на кнопку Шаблоны. Откроется окно со списком шаблонов.
  2. Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:
    Vlog 5.png

Для загрузки по шаблону достаточно настроить вкладку Основное. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

Примечание. Не рекомендуем самостоятельно писать скрипты для вкладок Дополнительно. Если надо изменить логику обработки заказов, обратитесь в службу поддержки MeaSoft.

Поля вкладки «Основное»

Название. Укажите название шаблона.

Личный шаблон. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

Первая строка. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле Условие загрузки пустое, то система создаст заказ на основе заголовка таблицы.

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

Адрес не пустой. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

Контролировать уникальность шифра. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

Только в недоставленных. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

Идентификация отправителя. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: Нет, Юр. лицо, ИНН, ID.

Столбец и Строка. Укажите столбец и строку с информацией об отправителе.

Пересчитать стоимость после загрузки. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:

  • Поле — внутреннее имя параметра заказа;
  • Название — название параметра в MeaSoft;
  • По умолчанию — значение параметра, если столбец «Значение» пустой;
  • Значение — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра Адрес получателя используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

Как указать лист с заказами в Excel-файле

По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:

  1. Откройте существующий шаблон на редактирование или добавьте новый шаблон.
  2. Перейдите на вкладку Дополнительно.
  3. В поле Скрипт до загрузки напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

Как загрузить заказы

Загрузка из одного файла

  1. Убедитесь, что в MeaSoft есть запись клиента, от имени которого будет создан заказ. Для этого перейдите на вкладку Клиенты и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите Вывести.
  2. Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки Основное, Реквизиты и Финансы.
  3. Перейдите на вкладку Заказы и создайте новый заказ.
  4. В главном меню выберите Связь > Импорт БД из Excel. Откроется окно «Импорт из Excel»:
    Импорт из эксель.png
  5. В поле Формат выберите шаблон импорта.
  6. В поле Заказ укажите номер созданного заказа или выберите его из списка по кнопке More.png. В этот заказ будут загружены данные файла.
  7. В поле Файл нажмите на кнопку More.png справа и укажите путь к файлу MS Excel с информацией о заказах.
  8. Нажмите Старт, чтобы начать импорт данных.

Загрузка из нескольких файлов

  1. Убедитесь, что в MeaSoft есть запись клиента, от имени которого будет создан заказ. Для этого перейдите на вкладку Клиенты и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите Вывести.
  2. Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки Основное, Реквизиты и Финансы.
  3. В главном меню выберите Связь > Импорт БД из папки. Откроется окно «Импорт из папки»:
    Importfromfolder.png
  4. В поле Папка нажмите на кнопку More.png справа и укажите укажите путь к папке с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
  5. В поле Клиент укажите название клиента, для которого будет создан заказ. В поле работает автозаполнение при вводе.
  6. В списке Шаблон выберите шаблон импорта для обработки первого файла в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
  7. Нажмите Загрузить. Система обработает первый файл и уберет его из списка, в панели внизу отобразится отчет о количестве обработанных записей.
  8. Если в списке остались элементы, повторите действия, начиная с пункта 4, для следующего файла.

Автозамена

При оформлении заказа клиенты и покупатели могут указывать один и тот же адрес в разных форматах, что ведет к ошибкам геокодирования.

Чтобы привести адрес к требуемому формату, вы можете настроить правила автозамены для загруженных извне заказов. Для выполнения операции требуются права «Администрирование».

Чтобы настроить автозамену:

  1. В главном меню выберите Связь > Импорт БД из Excel и в окне «Импорт из Excel» нажмите на кнопку Автозамена. Откроется окно «Настройка автозамены»:
    Настройка автозамены.png
  2. Нажмите F3 и создайте новое правило автозамены. При нажатии на кнопку ОК в списке правил добавится еще одна строка.
    Чтобы изменить правило, щелкните дважды на его строке. Чтобы удалить правило, используйте комбинацию клавиш CTRL+F8.
  3. После создания правил с помощью кнопок Вверх и Вниз определите их порядок. Автозамены применяются к адресу последовательно сверху вниз.

Автозамену можно отключить для определенных режимов срочности. Для этого в справочнике Статусы > 17 Виды срочности для режима срочности установите 7 параметр первой строки в значение 1. Подробнее см. раздел «Виды срочности».

Автозамены, предусмотренные исходным кодом системы:

  • следующие слова удаляются из начала адреса еще до срабатывания пользовательской автозамены:
вул.,ул.,пр.,проспект,проезд,шоссе ,шоссе,аллея,ул ,пр-д,пер.,пер ,ул ,пр ,пр-т,пр-кт,бульвар,бул.,бул ,набережная,наб.,наб
  • если улица не найдена, но в справочнике есть другая улица, название которой отличается на одну букву, срабатывает подмена одной буквы в названии улицы. Если улица была указана корректно, укажите ее вручную. Система «запомнит» эту улицу, и ошибка больше не повторится.

Шаблон как отдельный файл

Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.

Note.png При выгрузке и загрузке шаблона система не копирует настройки на вкладке Услуги. Укажите эти настройки вручную после импорта шаблона.

Сохранить шаблон в файл

  1. Перейдите в СвязьИмпорт БД из ExcelШаблоны.
  2. Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
  3. Нажмите Сохранить в файл.
  4. Выберите папку и нажмите Сохранить.

Сохранение шаблона:

Vlog 12 1.png

Добавить в систему шаблон из файла

  1. Перейдите в СвязьИмпорт БД из ExcelШаблоны.
  2. Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
  3. Нажмите Добавить из файла.
  4. Выберите XML-файл шаблона и нажмите Открыть.

Загрузка шаблона:

Vlog 12 2.png

Пример создания простого шаблона для загрузки вложений

Note.png Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы «Заказы»), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню «Связь» → «Импорт БД из Excel» (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:


Vlog 1.png


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


Vlog 2.png


Чтобы редактировать шаблон, нажмите на кнопку Шаблоны. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле значение пустое — программа использует значение поля значение по умолчанию. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [1]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем «пример». На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:


Vlog 3.png


В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):


Vlog 4.png


Примечание: Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку «Шаблоны…» в окне «Импорт из Excel». Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем «пример».

Для поля «Адрес получателя» указано значение с функцией MakeAddress(буква столбца с адресом из реестра в Excel файле). Функция MakeAddress(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки «Автозамена…» в окне «Импорт из Excel».

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


Vlog 5.png


В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку «Дополнительно» и в окне «Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)» ввести следующий скрипт (первая строка должна быть пустой):


Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass, 
       sum(b.kol_vo) as kol_vo
 from address a join boxes b on b.address=a.code
 where a.zakaz=%zakaz%
 group by b.address) b on a.code=b.address
set 
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null
Vlog 6.png


Этот скрипт необходим для суммирования значений переменных «количество», «масса» и «цена» вложений в карточке корреспонденции.

Далее переходим во вкладку «Вложения»:


Vlog 7.png


Ставим галку «Загружать вложения».

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле «Код товара» используется как артикул в номенклатуре поставщика (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке «Получатель» единицы корреспонденции заполняются следующим образом:


Vlog 8.png


  • Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке «Вложения» единицы корреспонденции заполнятся так:


Vlog 9.png


После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне «Импорт из Excel», последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку «Cтарт» происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:


Vlog 10.png


Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий. После этого мы можем перейти во вкладку «Адреса» где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:


Vlog 11.png

Примеры модификаций содержимого ячеек при помощи формул

Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться специальными функциями. Простые примеры применения функций рассмотрены ниже.


1.Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: PARAM(replace(f, ' ', ','), 2)

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».


2.Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: LEFT(REMSPACE(replace(J, 'с', )), 2)+':00'

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: RIGHT(J, 2)+':00'

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».


3.Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0», иначе подставлять следующий порядковый номер.

Решение: if((C='забор груза')+(C='забор'), 0, GetNewNumber)

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).


4.Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: k+', '+l

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».


5.Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: n/1000

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".


6.Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе сроков доставки

Решение: CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.

Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate