Логика синхронизации
При инициализации базы MSSQL по метаданным в каждую таблицу добавляются служебные поля IsDeleted и Timestamp. IsDeleted - поле boolean типа, флаг удаленной записи. Timestamp - поле типа bigint, содержащее в себе время последней модификации записи.
Протокол и точки подключения
- Обмен данными осуществляется посредством передачи сжатых в zip json документов POST запросом по протоколу HTTP
- Конечная точка имеет вид http(s)://%адрес сервера бит-мобайл%/%имя решения%/device/DefaultScope/DownloadChanges, номер порта зависит от конфигурации web сервера IIS (по умолчанию 80 для http и 443 для https), например:
http://superagent.ru/bitmobile/device/DefaultScope/DownloadChanges - Используется "Basic" авторизация, имя пользователя и пароль зависят от решения
- Кодировка - UTF-8
Структура json документа
- Id - guid
- TimestampFrom - время последней синхронизации клиента с сервером
- TimestampTo - новое время последней синхронизации клиента с сервером. Оно должно быть использовано в качестве значения TimestampFrom при следующей синхронизации
- DeletedEntities - массив удалённых записей в формате json
- ChangedEntities - массив изменённых записей в формате json
- FiltersToApply - список фильтров для удаления неактуальных данных на клиенте
Структура json объекта отдельной записи
- Tablename - имя таблицы
- Fields - json объект с полями записи
Порядок синхронизации
- Клиент отправляет свой документ с данными и заполненным полем TimestampFrom, в нем передается время последней успешной синхронизации с сервером.. Если это поле = 0, то синхронизация считается начальной и клиент получит полный набор данных с сервера.
- Сервер получает документ с данными, заполняет в нём поле TimestampTo текущей датой и выполняет обновление записей или помечает их как удаленные. Всем затронутым записям присваивается одно и то же значение Timestamp = TimestampTo
- Сервер получает список записей в таблицах, изменённых после TimestampFrom, и возвращает клиенту JSON документ с данными. В этом документе значение TimestampTo является датой последней успешной синхронизации и должно быть запомнено клиентом.