Помимо ручного добавления точек (ТТ) в систему так же можно загрузить файлы (базу точек) в формате .xml и .xls документов.Для этого во вкладке "План" нажимаем кнопку "Импорт".В появившемся окне выбираем тип файла .xml или .xls , выбираем нужный файл в директории папок и нажимаем открыть.Начнется загрузка данных в систему. По окончанию система уведомит о количестве загруженных точек.
Образец кодировки .xml документа:
<?xml version="1.0" encoding="UTF-8"?><plan><tt><code1C>код точки</code1C><name>сеть точки</name><client>название точки</client><address>адрес точки</address> <date>дата посещения</date> <merch>имя сотрудника согласно системе</merch> <user>имя ответственного согласно системе</user> </tt><plan>
Образец таблицы .xls документа:
Код
Название
Торговая сеть, клиент
Широта
Долгота
Радиус
Адрес
Дополнительно
Ответственный
Курьер
Дата
1
Строительный магазин №5
Магазин-склад
150
Киев,улица Деревообрабатывающая, 5
1746
примечание: Дата посещения;имя сотрудника;имя ответственного; указывается в случае постановки точек в план посещений.
По умолчанию срок хранения точек в базе -14 дней. Если файл импорта содержит в названии "_NODATEDEL", то ТТ, полученные из него не помечаются к удалению через 14 дней. Например: база точек_NODATEDEL.xlsФайл .xml должен иметь кодировку UTF-8Файл .xls должен быть в формате XLS 97-2003При заливке точек через вкладку ПЛАН нажав кнопку ИмпортПоявляется подобное уведомление о принятых точках:
Что означает что в базу загружено 44 точки. Ниже идет указание строк которые не загружены в систему. Т.е. из файла с 50 точками не загружены строки 16,29,32,44,46,49. По причине отсутствия какой либо информации (нет адреса). Так как файл может содержать много строк (строки после 51 пустые) то система уведомляет что в них так же отсутствует информация. Т.е. на уведомления строки 52 и выше не обращаем внимание. Заливаем точки, не принятые исправляем и заливаем снова.
Так же возможно добавления точек (ТТ) по API добавив по точке или загрузив файл XML.Добавление по точке.Для этого необходимо:1. Авторизироваться (подключить сессию)
Запрос ConnectToServer
Назначение:
Подключение к серверу (установление сессии)
Параметры запроса:
login – имя пользователя
pass – пароль пользователя
tz – отклонение временной зоны пользователя от UTC в минутах (например, для Киева -180 в летнее время)
Ответ:
Строка:
«ок» - подключение прошло успешно.
Иные ответы возвращаются при ошибке подключения. Возможные варианты:
"Неверное имя пользователя или пароль"
"Данный пользователь заблокирован. Обратитесь к администратору."
"Ошибка подключения. Обратитесь к администратору."
Пример ответа
<string>ok</string>
Пример для GET запроса:http://api.skyriver.ua/WebSky/service.php/ConnectToServer?login=test&pass=test&tz=-180
В случае правильного логина и пароля и успешного подключения также возвращается HTTP cookie с параметрами сессии, для использования при отсылке следующих запросов.2. Добавить новую ТТ Запрос SetTT
Изменить или добавить торговые точки
code1C – уникальный код торговой точки (обязательное поле)
name – текстовое имя точки
client – текстовое имя торговой сети точки
address– адреса торговой точки
lon – долгота центра торговой точки, градусы
lat – широта центра торговой точки, градусы
radius – радиус торговой точки, в метрах (по умолчанию 100м)
comment – комментарий, текстовая информация от торговой точке
user – имя (логин) прикрепленного к данной ТТ пользователя (СПВ)
enabled – задействована ли торговая точка (по умолчанию - да)
«ok» - действие выполнено успешно.
"Отсутствует доступ"
"Ошибка добавления"
Пример для GET запроса:
http://api.skyriver.ua/WebSky/service.php/SetTT?code1C=T1200023&name=new-tt&client=new-client&lon=30.3453&lat=35.5657&user=sean3. Закрыть сессию
Запрос Disconnect
Разорвать текущую сессию
а – отладочный параметр необязательный к заполнению
http://api.skyriver.ua/WebSky/service.php/Disconnect?a=1
Загрузка файла XML.Для этого необходимо:1. Авторизироваться (подключить сессию)
В случае правильного логина и пароля и успешного подключения также возвращается HTTP cookie с параметрами сессии, для использования при отсылке следующих запросов.2. Загрузить файл XML
Запрос SetPlanFromXML
Изменить План Маршрутов Мерчендайзера
Только HTTP POST
plan_file – данные (файл) в формате XML со следующей структурой:
<?xml version="1.0" encoding="utf-8"?>
<plan>
<tt>
<code1C>к1373/1</code1C>
<date>2012-10-28</date>
<merch>mr leluh (EMU)</merch>
<id_tt>2</id_tt>
<id_object>2</id_object>
</tt>
…
где
id_tt – идентификатор торговой точки в БД
id_object – идентификатор объекта мониторинга (торгового агента) в БД
code1C – уникальный код торговой точки
date – дата посещения торговой точки (формат [ГГГГ-ММ-ДД] в локальном времени пользователя, пример, "2012-09-30")
merch – текстовое имя объекта мониторинга (торгового агента), который должен посетить точку
Обязательно наличие одного из двух полей id_tt или code1C – в случае если присутствуют оба поля, приоритет отдается id_tt
Обязательно наличие одного из двух полей id_ object или merch – в случае если присутствуют оба поля, приоритет отдается id_ object
XML со следующими параметрами:
info – результат добавления каждого пункта плана
<ArrayOfObjTree>
<info>ok</info>
<info>Ошибка вставки данных</info>
</ArrayOfObjTree>
Пример реализации отсылки файла на сервер методом HTTP POST для языка C# можно посмотреть тут:
http://www.techcoil.com/blog/sending-a-file-and-some-form-data-via-http-post-in-c/
Вкладення: test-plan.xls
« Повернутися
Powered by Help Desk Software HESK, in partnership with SysAid Technologies
