Настройка модуля автоматизации
Модуль интеграции с внешними системами предназначен для выполнения периодических заданий импорта/экспорта/обработки данных. Модуль представляет из себя Службу Windows, которая каждые 10 секунд проверяет, наличие заданий в таблице scheduler.jobs с прошедшим временем следующего выполнения, и выполняет эти задания.
Заданиями для модуля интеграции (модуля автоматизации) могут быть примеры таких заданий, как:
- Оборудование: Автопечать продажных/возвратных чеков, автоматическое ежедневное формирование Z-отчета для фискальных регистраторов;
- Отчеты: Всевозможные e-mail оповещения в формате Excel (например, отчет о доставке);
- SMS оповещения: автоматические SMS рассылки для клиентов/курьеров;
- Интеграция: Процесс обмена заказами и их статусами с другими компаниями (например, курьерскими службами, интернет магазинами);
- Автоматический экспорт-импорт информации с БД систем других производителей (например, WMS-системами "системами управления складом").
Установка
Настройка
параметры ini файла:
SMTPProtocol - тип протокола отправки почты: 0 - SMTP, 1 - SSL, 2 - TLS
Создание заданий
Задания описываются в текстовом виде в поле TEXT таблицы jobs. В одном тексте может быть несколько заданий, разделенных пустой строкой, за исключением случая, когда текст начинается с префикса интерпретатора ("<?>"). Задание может быть следующих видов: Интерпретируемый код, Импорт данных, Выполнение запроса (возможно, с экспортом результата).
Интерпретируемый код
Если задание начинается с префикса интерпретатора, то весь последующий код обрабатывается им.
Импорт данных
input, OperNo, FileType, Param1, Param2, Param3, Param4, Param5, Param6
| Параметр | Описание |
|---|---|
| input | Признак типа задания - импорт данных |
| OperNo | Номер действия. Значения: 0 - загрузка по FTP, SFTP. 1 - Получение почты. |
| FileType | Тип файла. Принимает значения:
0 - Формат "Йота" 1 - Формат "Сони" 2 - Формат "Омни" 3 - Стандартный формат заказов 4 - Стандартный формат отчетов 5 - Пользовательская процедура импорта |
| Param1 | Полный путь к папке на FTP-сервере (вместе с именем сервера) (для SFTP используйте sftp://имя_сервера) |
| Param2 | Имя пользователя FTP-сервера |
| Param3 | Пароль FTP-сервера |
| Param4 | Маска имен файлов, подлежащих загрузке |
| Param5 | Код клиента (поле courier.clients.code), для привязки загруженных заказов |
| Param6 | Активное соединение FTP. Для использования активного режима укажите active |
При задании "1" - Импорт почты система получает почту по всем аккаунтам из таблицы Accounts и загружает их в таблицы messages и attachment
Экспорт данных
query, OperNo, FileType, Param1, Param2, Param3, Param4, Param5, Param6 QueryText
Модуль выполняет запрос QueryText, и передает результат его выполнения функции отправки, описанной в первой строке задания.
| Параметр | Описание |
|---|---|
| query | Признак типа задания - экспорт данных |
| OperNo | Номер действия. Значения:
0 - Только выполнение запроса. 1 - Отправка по электронной почте 2 - Выгрузка файла на FTP, SFTP-сервер 3 - Выгрузка заказов в систему "Аксиомус" 4 - Проверка статусов с системе "Аксиомус" 5 - Синхронизация с системой "Эмпрана" 6 - Отправка складских остатков в систему "Эмпрана" 7 - Запрос координат курьеров в сервисе Google |
| FileType | Тип файла. Принимает значения:
1 - Формат CSV 2 - Формат "Сони" 3 - Формат XLS 4 - формат CSV (с заголовками) |
Значения параметров 1-6 зависят от типа операции:
Тип операции - 0: Не используются.
Тип операции - 1:
| Параметр | Описание |
|---|---|
| Param1 | Адрес e-mail для отправки |
| Param2 | Тема сообщения. Если пусто - "CourierAutoReport" |
| Param3 | Текст сообщения. Если пусто - "see attachment" |
| Param4 | Маска имени файла. Доступны шаблоны %DT%, %D%, %T% - Дата/время в форматах YYYYMMDDHHMMSS, YYYYMMDD, HHMMSS соответственно. Если пусто - используется ДатаВремя |
| Param5 | Не используется |
| Param6 | Не используется |
Тип операции - 2:
| Параметр | Описание |
|---|---|
| Param1 | Полный путь к папке на FTP-сервере (вместе с именем сервера) (для SFTP используйте "sftp://имя_сервера...") |
| Param2 | Имя пользователя FTP-сервера |
| Param3 | Пароль FTP-сервера |
| Param4 | Маска имен файла. Доступны шаблоны %DT%, %D%, %T% - Дата/время в форматах YYYYMMDDHHMMSS, YYYYMMDD, HHMMSS соответственно. Если пусто - используется ДатаВремя |
| Param5 | Активное соединение FTP. Для использования активного режима укажите active |
| Param6 | Не используется |
Типы операции - 3, 4:
| Параметр | Описание |
|---|---|
| Param1 | Имя пользователя системы "Аксиомус" |
| Param2 | Пароль системы "Аксиомус" |
| Param3 | Не используется |
| Param4 | Не используется |
| Param5 | Не используется |
| Param6 | Не используется |
Тип операции - 5:
| Параметр | Описание |
|---|---|
| Param1 | Адрес сервера системы "Эмпрана" |
| Param2 | Имя пользователя системы "Эмпрана" |
| Param3 | Пароль системы "Эмпрана" |
| Param4 | Код клиента (поле courier.clients.code), для привязки загруженных заказов |
| Param5 | Символьный код города системы "Эмпрана" |
| Param6 | Не используется |
Тип операции - 6:
| Параметр | Описание |
|---|---|
| Param1 | Адрес сервера системы "Эмпрана" |
| Param2 | Имя пользователя системы "Эмпрана" |
| Param3 | Пароль системы "Эмпрана" |
| Param4 | Код клиента (поле courier.clients.code), для привязки загруженных заказов |
| Param5 | Символьный код города системы "Эмпрана" |
| Param6 | Не используется |
Обязательно указать запрос! Например, select 1!
Тип операции - 7:
Параметры не используются!
Обязательно указать запрос! Например, select 1!
Примеры использования
Импорт заказов в стандартном формате с FTP-сервера
input, 0, 4, myftphost.ru/upload/foulder/, MyUserName, MyPassword, *_orders.csv, 123, active
Экспорт заказов в CSV-файле на FTP-сервер
query, 0 replace scheduler.sent (code, sent, source, rectype) select a.code, 'F', b.source, 2 from courier.address a join zakaz b on a.zakaz=b.code left join scheduler.sent s on s.code=a.code and s.source=b.source and s.rectype=2 where a.ldtime>=date_sub(now(), interval 7 day) and s.code is null and b.source=123 query, 2, 1, myftphost.ru/upload/foulder/, MyUserName, MyPassword, MY-ORD-%DT% select a.code, a.strbarcode, a.target, a.name, a.address, a.phone, a.rur from scheduler.sent s join courier.address a on s.code=a.code where s.sent='F' and s.source=123 and s.rectype=2 query, 0 update scheduler.sent set sent='T' where sent='F' and source=123 and rectype=2
Данное задание состоит из 3-х подзаданий. В первом - запрос собирает коды корреспонденции, измененной за последние 7 дней, но не добавленных в очередь отправки в таблице sent. Во втором происходит формирование CSV-файла с заказами, у которых стоит отметка, что они не отправлены (sent.sent='F'), и отправка файла на FTP-сервер. В последнем подзадании запрос отмечает всю корреспонденцию отправленной. Если на втором этапе, при отправке файла произойдет ошибка, то этот, третий запрос не будет выполнен, заказы останутся в состоянии "не отправлен", и в следующий раз будет предпринята повторная попытка их отправки.
