Синхронизация данных между клиентским и серверным приложением/en: различия между версиями

Материал из SmartPlayer
(Новая страница: «Data Synchronization Between Client and Server Applications»)
 
(Новая страница: «== '''Description of the Situation''' == To ensure users can verify that statistics from the client application (on the device) have been successfully transferred to the server application, the "Data Actualization" functionality has been implemented. {{Note|Currently, this functionality is available for Android OS client applications and is under development for Windows, Linux, and Raspberry PI.|warn}} == '''Workflow Logic''' == The server application sends...»)
 
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Description of the Situation''' ==
== '''Описание ситуации''' ==
To ensure users can verify that statistics from the client application (on the device) have been successfully transferred to the server application, the "Data Actualization" functionality has been implemented.
Чтобы у пользователя была возможность быть уверенным в том что статистика с клиентского приложения (из устройства) передалась на серверное приложение появилась функциональность "Актуализация".
{{Note|Currently, this functionality is available for Android OS client applications and is under development for Windows, Linux, and Raspberry PI.|warn}}
{{Note|На данный момент функциональность доступна для клиентского приложения на Android OS и в разработке для  Windows, Linux, Raspberry PI.|warn}}
== '''Workflow Logic''' ==
== '''Логика работы''' ==
The server application sends a request to the client application (device) to retrieve data about unsent statistics. Simultaneously, it sends a second request to transmit this statistics.
Серверное приложение отправляет запрос на клиентское приложение (устройство) чтобы получить данные по неотправленной статистике. Также единовременно отправляется второй запрос на отправку данной статистики. <br><br>
The client application (device) then begins responding with information about the amount of unsent statistics accumulated on the device.
После этого клиентское приложение (устройство) начинает отправлять в ответ информацию сколько неотправленной статистики скопилось на устройстве.<br><br>
Upon request, the device sends all data objects to the server application. After processing the objects, the server application sends a follow-up request about the number of unprocessed objects. In this case, the client application responds that there are 0 unprocessed objects and completes the data transmission.
Устройство, по запросу, отправляет все объекты на серверное приложение. После обработки объектов серверное приложение отправляет повторный запрос на количество необработанных объектов. В таком случае клиентское приложение отвечает, что необработанных объектов 0 и завершает отправку данных.<br><br>
After these actions, the "Progress Status" column in the personal account will display "Completed". The "Progress Status" column will also show the date of the last data actualization.
После данных действия в личном кабинете, в столбце "Статус прогресса" будет указано - "Завершено". Также в столбце "Статус прогресса" появится дата последней актуализации данных.
== '''Action Algorithm''' ==
== '''Алгоритм действия''' ==
To use this functionality, the user must register or log in to their SmartPlayer account.
Для того, чтобы воспользоваться данной функциональностью пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer.<br>
Next, they need to navigate to the "Reports" section and find the "Actualization" category.
Далее ему необходимо перейти в раздел "Отчеты" и найти категорию "Актуализация".
[[File:Отчет_и_актуализация.png|thumb|center| Example of the "Reports" section and "Actualization" category display|800px]]
[[File:Отчет_и_актуализация.png|thumb|center| Пример отображения раздела "Отчёты" и категории "Актуализация"|800px]]
On the actualization page, users will see device information containing the following parameters:
Открыв страницу актуализации, пользователь увидит страницу с информацией об устройствах, которая содержит следующие параметры:
* Checkbox (select all devices) - allows selecting all devices for actualization
* Чекбокс(галочка) выбрать все устройства - позволяет выделить все устройства для актуализации
* Identifier - displays the device ID
* Идентификатор - отображается идентификатор устройства
* Name - shows the device name
* Название - отображается название устройства
* Last Actualization - displays the date and time of the last data actualization
* Последняя актуализация - отображается дата и время последней актуализации данных
* Unprocessed Objects - shows the number of unprocessed objects
* Необработанных объектов - отображается количество необработанных объектов
* Progress Status - displays the device actualization progress status
* Статус прогресса - отображается статус прогресса актуализации устройства
[[File:Актуализация_главная.png|thumb|center| Example of the "Actualization" category page with parameters|800px]]
[[File:Актуализация_главная.png|thumb|center| Пример отображения страница категории "Актуализация" с параметрами|800px]]
The next step requires the user to select the desired device. The device must be in the on-line status.
Следующим шагом пользователю необходимо выделить нужное устройство. Устройство обязательно должно быть в статусе on-line.
[[File:Выделение_устройства.png|thumb|center| Example of a selected on-line device|800px]]
[[File:Выделение_устройства.png|thumb|center| Пример отображения выделенного on-line устройства|800px]]
Once the device is selected, the user should navigate to the left side of the screen and click the "Actualize" button on the page interface.
Как только устройство будет выделено пользователь должен переместиться в левую часть экрана, найти и нажать на кнопку "Актуализировать" в интерфейсе страницы.
[[File:Кнопка_актуализировать.png|thumb|center| Example of the "Actualize" button display|800px]]
[[File:Кнопка_актуализировать.png|thumb|center| Пример отображения кнопки "Актуализировать"|800px]]
The data actualization process will begin and may take up to 5 minutes. Upon completion, the "Progress Status" column will show "Completed" and the unprocessed objects field will display 0.
Запуститься процесс актуализации данных, который может длиться до 5 минут. Как только процесс актуализации статистики будет окончен пользователь увидит в столбце "Статус прогресса" значение "Завершено" и в поле количество необработанных объектов будет значение равное 0.
[[File:Статус_завершено.png|thumb|center| Example of object count and "Completed" status display|800px]]
[[File:Статус_завершено.png|thumb|center| Пример отображения количества объектов и статуса "Завершено"|800px]]
== '''Video Tutorial''' ==
== '''Видеоинструкция''' ==
[https://vk.com/video-227547238_456239061 Device Data Actualization]
[https://vk.com/video-227547238_456239061 Актуализация данных устройства]
== '''Additional Information''' ==
== '''Дополнительная информация''' ==
If this article doesn't help you use the functionality as intended or if you have remaining questions after reading it, you can raise these questions in the "Discussions" section at the top of the page.
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_синхронизации.png|thumb|center| Example of the "Discussions" tab on the wiki page|800px]]
[[File:Обсуждение_синхронизации.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Additional information can also be found on the page [[How Users Can Interact with the "Discussions" Section]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</div>

Текущая версия от 09:43, 26 марта 2025

Description of the Situation

To ensure users can verify that statistics from the client application (on the device) have been successfully transferred to the server application, the "Data Actualization" functionality has been implemented.

Currently, this functionality is available for Android OS client applications and is under development for Windows, Linux, and Raspberry PI.

Workflow Logic

The server application sends a request to the client application (device) to retrieve data about unsent statistics. Simultaneously, it sends a second request to transmit this statistics. The client application (device) then begins responding with information about the amount of unsent statistics accumulated on the device. Upon request, the device sends all data objects to the server application. After processing the objects, the server application sends a follow-up request about the number of unprocessed objects. In this case, the client application responds that there are 0 unprocessed objects and completes the data transmission. After these actions, the "Progress Status" column in the personal account will display "Completed". The "Progress Status" column will also show the date of the last data actualization.

Action Algorithm

To use this functionality, the user must register or log in to their SmartPlayer account. Next, they need to navigate to the "Reports" section and find the "Actualization" category.

Example of the "Reports" section and "Actualization" category display

On the actualization page, users will see device information containing the following parameters:

  • Checkbox (select all devices) - allows selecting all devices for actualization
  • Identifier - displays the device ID
  • Name - shows the device name
  • Last Actualization - displays the date and time of the last data actualization
  • Unprocessed Objects - shows the number of unprocessed objects
  • Progress Status - displays the device actualization progress status
Example of the "Actualization" category page with parameters

The next step requires the user to select the desired device. The device must be in the on-line status.

Example of a selected on-line device

Once the device is selected, the user should navigate to the left side of the screen and click the "Actualize" button on the page interface.

Example of the "Actualize" button display

The data actualization process will begin and may take up to 5 minutes. Upon completion, the "Progress Status" column will show "Completed" and the unprocessed objects field will display 0.

Example of object count and "Completed" status display

Video Tutorial

Device Data Actualization

Additional Information

If this article doesn't help you use the functionality as intended or if you have remaining questions after reading it, you can raise these questions in the "Discussions" section at the top of the page.

Example of the "Discussions" tab on the wiki page

Additional information can also be found on the page How Users Can Interact with the "Discussions" Section