{{keywords>мобильные решения Наполеон}}
{{description>Сервер обмена мобильной торговли "Наполеон"  }}
=====Сервер обмена программного комплекса "Наполеон"=====

====1. Установка сервера====

Компьютер, на который устанавливается сервер, должен быть доступен из внешней сети (Internet) по протоколу TCP, порт 8888. 

Серверу должны быть делегированы полные права на папку обмена (чтение, запись, создание и удаление фалов) и папку в который сервер установлен.
Минимальные требования к компьютеру для установки серверной части АСМТ «Наполеон»:

•	Операционная система: Windows 7;\\
•	Процессор: Celeron 2,8 ГГц;\\
•	Объём оперативной памяти: 4 Гб.


====2. Запуск сервера====

При установке серверной части «АСМТ Наполеон» на компьютер сервер автоматически устанавливается в меню «Автозагрузка» текущего пользователя. После перезагрузки компьютера значок сервера появится в трее.

{{:sr_1.jpg}}


====3. Настройка параметров====

Найдите в трее значок сервера и нажмите на правую кнопку мыши; в открывшемся меню выберите пункт «Настройки». 

{{:sr_2.jpg}}

Сервер попросит ввести пароль администратора. По умолчанию пароль администратора //admin//. После ввода правильного пароля откроется окно настроек сервера.

{{:sr_3.jpg}}

В этом окне можно изменить настройки сервера.

**«Папка обмена»** – указывает путь к файлам для обмена информацией с КИС (список торговых агентов, контрагенты, заявки и т.д.)

**«Порт»** – порт сервера для связи с внешними программами.

**«Запускать сервер»** – варианты запуска сервера:

•	//в трее// – сервер устанавливается в папку «Автозагрузка» текущего пользователя и будет запускаться при каждом входе пользователя в систему;\\
•	//как службу// – сервер устанавливается службой и стартует при запуске компьютера не зависимо от входа пользователя в систему. Имя службы сервера «Сервер комплекса "Наполеон"». Управление запуском и остановкой сервера в этом случае осуществляется через окно «Управление компьютером», закладка «Службы»;\\
•	//не инсталлирован// – выбор этого пункта отменяет автоматическую загрузку сервера при старте системы.\\

**«Изменить пароль...»** – выбор этого пункта позволяет изменить пароль администратора сервера. 

После изменения параметров необходимо перезапустить сервер.


====4. Протокол обмена====

Обмен сервера с клиентом происходит сессиями, во время которых клиент передает пакеты с запросами и данными, а сервер отправляет ответы.

Пакет передается по сети запакованным и (опционально) закодированным.

После распаковки и проверки контрольной суммы пакета сервер пытается определить пользователя: на основании переданных клиентом логина и пароля сервер идентифицирует пользователя и определяет его роль (администратор, менеджер или агент). Если сервер не может определить пользователя – клиенту возвращается ответ «Пользователь не определен».

Следующий этап – разбор команд пакета и выполнение связанных операций.

Команда __GET__ – получение данных заставляет сервер найти запрошенный объект и записать его в ответный пакет. В случае если объект не найден – сервер не сообщает об этом. В ответном пакете просто не будет данных этого объекта. Контроль целостности и корректности принятых данных – задача клиента.

Команда __PUT__ – записывает переданные объекты. При записи сервер сохраняет объекты во внешние таблицы (DBF) и/или во внутреннюю базу. Если запись прошла успешно, на КПК передается положительный ответ, если запись не прошла – передается сообщение об ошибке. Если внешней таблицы нет, сервер создает ее в соответствии с форматом объекта, если таблица есть, но часть полей в ней отсутствует – отсутствующие поля будут потеряны. 

При записи объекта в DBF – новые записи всегда добавляются в базу. 

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

После передачи и приема положительного ответа от сервера, на КПК статус заявки меняется на «отправлен».
Следующий этап обработки – загрузка данных в КИС. При загрузке данных КИС может формировать файлы подтверждения загрузки (POD<Код Агента>.DBF) в этот файл записывается поле CREATED из загружаемого документа. 

Во время следующего сеанса обмена сервер передаст эту информацию на КПК и документ на КПК поменяет статус на «в обработке».