Обмен файлами с сервером GROTEM

Структура системного каталога решения

При развертывании решения сервер создает каталог с именем, совпадающим с именем решения в директории, указанной в параметре "SolutionsFolder" файла web.config.
Каталог решения содержит системные папки, необходимые для работы решения, а также папку "filesystem", в которой хранятся все пользовательские файлы.
Список системных папок может быть изменен в будущем, поэтому не стоит создавать сценариев, основывающихся на структуре системного каталога.
Для обмена следует использовать интерфейсы, предоставляемые сервером GROTEM по протоколам WebDAV и FTP

Структура каталога filesystem

Каталог "filesystem" состоит из 3-х пространств - "shared", "private" и "exchange"

"shared" содержит файлы и папки, общие для всех мобильных агентов и доступные для них в режиме "только чтение".
"private" содержит подпапку для каждого мобильного агента, имя папки совпадает с его GUID. Мобильный агент имеет доступ только к своей папке private в режиме "чтение-запись".
"exchange" предназначено для обмена файлами в процессе внедрения и никак не участвует в обмене с мобильным агентом.

Структура виртуального каталога

При подключении клиента по протоколу WebDAV или FTP сервер создает виртуальную директорию, структура которой зависит от роли клиента.

Пользователь "root"
Виртуальный каталог содержит файлы и папки системного каталога решения в режиме "только чтение". Данная роль необходима исключительно для административных функций - просмотр логов, версий решения etc.
Пользователь "admin"
Виртуальный каталог содержит файлы и папки каталога "filesystem" в режиме "чтение и запись". Это основная роль, необходимая для создания сценариев обмена файлами с сервером.
Мобильный агент
Виртуальный каталог содержит папку "shared" каталога "filesystem/shared" в режиме "только чтение", папку "private" каталога "filesystem/private/%UserGUID%" в режиме "чтение-запись" и 2 виртуальных файла "shared.txt" и "private.txt", задача которых возвратить информацию о файлах в соответствующих каталогах за один запрос для уменьшения времени синхронизации с мобильным агентом.

WebDAV

Авторизация

Используется "Basic" авторизация
Для пользователей "root" и "admin" пароль совпадает с паролем решения
Для мобильного агента имя пользователя совпадает с GUID пользователя, пароль - пароль на вход в мобильное приложение.

Точка подключения

Точка подключения к WebDAV серверу имеет вид http(s)://%адрес сервера GROTEM%/%имя решения%/webdav, порт зависит от настроек сайта IIS (80 по умолчанию), например:

Клиенты

Для работы с WebDAV сервером GROTEM можно использовать любой WebDAV клиент - броузер, Far Manager etc
Настраиваем подключение..
Вуаля !
Для создания сценариев обмена используется любой программный объект для работы по HTTP протоколу, например HttpСоединение из 1С

Сервис thumbnail

WebDAV сервер позволяет получать миниатюры изображений, для этого необходимо добавить параметр "size" к ссылке на картинку, например:

http://localhost/webapp/test/webdav/shared/pic.jpg?size=100

Поддерживаемые форматы:

gif
jpg
png

Фильтрация каталога shared

WebDAV сервер позволяет включить режим фильтрации каталога shared. В этом режиме мобильный агент будет получать только файлы, привязанные к объектам данных модели согласно фильтрам синхронизации решения. Например если торговый агент из всего множества торговых точек имеет доступ только к точкам своей территории, при синхронизации с WebDAV сервером он получит файлы изображений только своих точек.

Режим фильтрации включается в файле settings.xml. По умолчанию режим выключен.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
	<server>
		<filterShared value="yes" />
	</server>
</configuration>

FTP