TabletPOS Организация обмена облачное хранилище через FTP и Документ предназначен для пользователей программы TabletPOS и описывает процесс настройки автоматического обмена данными между TabletPOS и внешними АСТУ через FTPсервер и облачное хранилище со стороны TabletPOS. Документация от 19. 05. 2015 TabletPOS v. 2.1.0 2 [Содержание] Содержание Предварительная настройка .............................................................................................................. 4 FTP-сервер ...................................................................................................................................... 4 Облачное хранилище данных ....................................................................................................... 4 Внешняя АСТУ .............................................................................................................................. 4 Настройка каталогов и параметров обмена на мобильном устройстве ........................................ 5 Локальные каталоги ....................................................................................................................... 5 Автоматический обмен в TabletPOS ............................................................................................ 6 Синхронизация локальных и удалённых каталогов ................................................................... 8 Учётная запись FTP ................................................................................................................... 9 Учётная запись облачного хранилища данных ..................................................................... 11 Выполнение обмена ......................................................................................................................... 17 Загрузка справочников в TabletPOS ........................................................................................... 18 Выгрузка данных о продажах из TabletPOS .............................................................................. 18 3 [Предварительная настройка] Предварительная настройка Перед тем, как настраивать обмен на стороне TabletPOS должна быть выполнена настройка АСТУ, а также внешних систем (FTP-сервера или облачного хранилища данных). FTP-сервер FTP-сервер должен быть доступен с мобильного устройства (планшета или смартфона), на котором установлена программа TabletPOS. Чтобы проверить доступность сервера в адресной строке браузера на мобильном устройстве нужно ввести адрес FTP-сервера. При отсутствии соединения с FTP-сервером необходимо проверить настройки сети на мобильном устройстве, а также параметры FTP-сервера. При успешном соединении можно продолжать настраивать обмен по FTP. Облачное хранилище данных Для обмена через облачное хранилище данных необходимо: Создать аккаунт одного из облачных сервисов (DropBox, Google Drive, Yandex Disk или др.). Установить на настольный ПК приложение, дающее доступ к аккаунту облачного сервиса и обеспечивающее автоматическую синхронизацию из облачного хранилища в локальные директории на ПК. Приложение доступно на сайте соответствующего облачного сервиса. Внешняя АСТУ Используемая внешняя АСТУ должна поддерживать обмен в формате АТОЛ, а именно, выполнять следующие действия: формировать файл в формате АТОЛ, содержащий справочники (товаров, пользователей, налогов и пр.); формировать файл-флаг, сигнализирующий программе TabletPOS о наличии новых данных в справочниках; формировать файл-флаг запроса данных о продажах; загружать файлы в формате АТОЛ, содержащие данные о продажах; выкладывать файл справочников и файлы-флаги в соответствующие каталоги (на FTP-сервере или в облачном хранилище данных, в зависимости от используемого варианта обмена); забирать из соответствующего каталога файл с данными о продажах (с FTP-сервера или облачного хранилища данных). Далее выполнить настройку обмена в АСТУ в соответствии с рекомендациями сопроводительной документации. 4 [Настройка каталогов и параметров обмена на мобильном устройстве] Настройка каталогов и параметров обмена на мобильном устройстве Для настройки обмена на мобильном устройстве нужно выполнить следующие шаги: создать в системе локальные каталоги, из которых TabletPOS будет брать файл справочников и файлы-флаги, а также выгружать файл данных о продажах; выполнить в TabletPOS настройку параметров автоматического обмена с этими локальными каталогами; c помощью утилиты синхронизации связать данные локальные каталоги с удалёнными каталогами обмена (на FTP-сервере или в облачном хранилище данных). Android-клиенты облачных сервисов (в отличие от приложений для настольных ПК) не предоставляют возможностей для автоматической синхронизации между локальной директорией на мобильном устройстве и облачной. Поэтому автоматическую синхронизацию директорий необходимо настраивать средствами стороннего приложения (подробнее см. стр. 8). st Ниже подробно рассмотрен каждый из шагов. Локальные каталоги В TabletPOS различают входящий и исходящий каналы обмена. В качестве канала обмена указываются локальные каталоги. Нужно создать в системе: st st Локальный каталог, который будет использоваться для обмена данными – Exch. В каталоге Exch локальный каталог для входящего канала TabletPOS – spr. Из этого каталога TabletPOS будет забирать файлы-флаги и файл справочников. В каталоге Exch локальный каталог для исходящего канала TabletPOS – tranz. В этот каталог TabletPOS будет выкладывать файл с данными о продажах и файлы результатов обмена. В качестве входящего и исходящего канала может использоваться один и тот же локальный каталог. При использовании утилиты синхронизации FolderSyncLite в случае настройки двух отдельных каталогов для каналов загрузки и выгрузки для успешной синхронизации эти локальные каталоги должны быть помещены в один общий каталог, который используется только для обмена. 5 [Настройка каталогов и параметров обмена на мобильном устройстве] Автоматический обмен в TabletPOS Далее создать входящий и исходящий каналы обмена. Для этого в разделе приложения «Настройки/Параметры обмена/Каналы обмена» нужно нажать кнопку «Создать», затем настроить параметры, указав для каждого из соответствующего канала ранее созданный каталог: В разделе «Настройки/Параметры обмена» нажать кнопку «Настроить». Откроется окно параметров автоматического обмена, в котором все параметры разбиты на вкладки. Указать параметры обмена: 6 [Настройка каталогов и параметров обмена на мобильном устройстве] st Здесь на вкладке «Файлы» необходимо указывать имена файлов и файлов-флагов, которые указаны в параметрах обмена в АСТУ. st На вкладке «Каналы» нужно указать настроенные ранее каналы. Далее включить автоматический обмен с помощью переключателя «Состояние» в разделе «Настройки/Параметры обмена»: 7 [Настройка каталогов и параметров обмена на мобильном устройстве] Синхронизация локальных и удалённых каталогов Для синхронизации локальных каталогов с удалёнными можно воспользоваться бесплатной утилитой FolderSyncLite, которую нужно установить на мобильное устройство. Утилита доступна по адресу: https://play.google.com/store/apps/details?id=dk.tacit.android.foldersync.lite. После запуска будет предложено принять условия лицензионного соглашения, а также кратко ознакомиться с навигацией в приложении: В открывшемся меню приложения нажать кнопку «Создание новой синхронизации»: Будет запущен мастер создания нового задания синхронизации. Следуйте шагам мастера. 8 [Настройка каталогов и параметров обмена на мобильном устройстве] Шаг 1. Указать имя синхронизации: Шаг 2. Добавить новую учётную запись синхронизации. В зависимости от используемого варианта обмена настройте либо учётную запись FTP, либо учётную запись облачного хранилища данных. Учётная запись FTP Для добавления учётной записи FTP нужно нажать кнопку «Добавить аккаунт», затем указать тип учётной записи «FTP» и ввести параметры доступа к FTP-серверу: Для проверки соединения нужно нажать кнопку «Тест» (см. рисунок выше). 9 [Настройка каталогов и параметров обмена на мобильном устройстве] При успешном соединении с FTPсервером внизу окна появится надпись «Вход выполнен». Сохранить настройки и далее следовать указаниям мастера. Выбрать учётную запись, настроенную в предыдущем шаге, и перейти к следующему шагу мастера. 10 [Настройка каталогов и параметров обмена на мобильном устройстве] Учётная запись облачного хранилища данных Для добавления учётной записи облачного сервиса нужно нажать кнопку «Добавить аккаунт», затем указать тип учётной записи (выберите используемый облачный сервис): Указать имя учётной записи и настроить соединение кнопкой «Проверить подлинность учётной записи». 11 [Настройка каталогов и параметров обмена на мобильном устройстве] Выполнить вход в облачный сервис, указав имя аккаунта и пароль, а также разрешить приложению FolderSyncLite доступ к облачному хранилищу данных: При успешном соединении с облачным сервисом отобразятся его параметры. Сохранить настройки и далее следовать указаниям мастера. 12 [Настройка каталогов и параметров обмена на мобильном устройстве] Выбрать учётную запись, настроенную в предыдущем шаге, и перейти к следующему шагу мастера. Шаг 3. Указать тип синхронизации «Двусторонняя». 13 [Настройка каталогов и параметров обмена на мобильном устройстве] Шаг 4. В поле «Удалённая папка» указать папку в облачном хранилище, с которой обменивается АСТУ. В поле «Локальная папка» указать папку на мобильном устройстве, с которой обменивается TabletPOS. st 14 В примере локальные папки для входящего и исходящего каналов помещены в локальную папку Exch, её и указываем в поле «Локальная папка». [Настройка каталогов и параметров обмена на мобильном устройстве] Шаг 5. Для запуска настроенного задания по расписанию активировать флаг «Синхронизация по расписанию» и указать интервал – «Каждые 5 минут». Основная настройка задания завершена. 15 [Настройка каталогов и параметров обмена на мобильном устройстве] Шаг 6. В завершение настройки нужно указать необходимость синхронизации удалений в локальной директории на удалённую. Для этого выбрать настроенное задание в разделе «Задания» и в параметрах установить соответствующий флаг: При необходимости статус синхронизации можно посмотреть в разделе «Задания». 16 [Выполнение обмена] Выполнение обмена Таким образом, со стороны TabletPOS выполнена настройка автоматического обмена данными между TabletPOS и внешними АСТУ через FTP-сервер или облачное хранилище данных. В такой схеме обмен данными всегда инициируется внешней АСТУ с помощью файлов-флагов. Принципиальная схема автоматического обмена TabletPOS и АСТУ изображена на рисунке ниже. Android-устройство in.txt in_f.txt out_f.txt Канал 1 ПО для синхронизации Канал 2 TabletPOS out.txt load resultX .txt save resultX .txt FTP или облачный каталог Сервер с АСТУ ПО для синхронизации АСТУ 17 [Выполнение обмена] Загрузка справочников в TabletPOS 1. Внешняя АСТУ выкладывает на FTP-сервер или в облачную директорию файл справочников (на 2. 3. 4. 5. 6. схеме обмена – in.txt) и файл-флаг загрузки (на схеме обмена – in_f.txt). Утилита синхронизации на мобильном устройстве синхронизирует новые файлы во входящий канал TabletPOS (на схеме обмена – «Канал 1»). TabletPOS загружает файл справочников. После успешной загрузки данных TabletPOS удаляет из входящего канала файл-флаг и файл справочников. Также после загрузки файла TabletPOS формирует файл с результатом обмена (на рисунке loadresultX.txt) и отправляет его в исходящий канал. Утилита синхронизации на мобильном устройстве синхронизирует изменения в каналах обмена на FTP-сервер или в облачную директорию. Выгрузка данных о продажах из TabletPOS 1. Внешняя АСТУ выкладывает на FTP-сервер или в облачную директорию файл-флаг выгрузки (на схеме обмена – out_f.txt), который сигнализирует о том, что необходимо получить файл с данными о продажах. 2. Утилита синхронизации на мобильном устройстве синхронизирует файл-флаг во входящий канал TabletPOS (на схеме обмена – «Канал 1»). 3. TabletPOS формирует файл данных о продажах (на схеме обмена – out.txt) и отправляет его в исходящий канал. 4. Также после выгрузки файла TabletPOS формирует файл с результатом обмена (на схеме обмена – saveresultX.txt) и отправляет его в исходящий канал. 5. После успешной выгрузки и записи файлов TabletPOS удаляет файл-флаг из входящего каталога. 6. Утилита синхронизации на мобильном устройстве синхронизирует изменения в каналах обмена на FTP-сервер или в облачную директорию. 7. АСТУ загружает полученный файл. st Типы документов и период выгрузки данных для файла продаж указываются в настройках автоматического обмена на вкладке «Общее». st 18 В приведённом примере используется бесплатная утилита, которая позволяет выполнять синхронизацию не чаще, чем раз в 5 минут, при этом синхронизация не будет мгновенной. В худшем случае один цикл обмена может составлять порядка 10 минут. [Для заметок] 20