Выгрузка логов при нестабильном интернете/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Log Upload with Unstable Internet»
 
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Situation Description''' ==
== '''Описание ситуации''' ==
The development of the SmartPlayer platform brings new useful functionality. Previously, if the connection was lost during log upload, the task created in the SmartPlayer personal account became infinite and remained in the log, thus creating additional load on the server application. Now the implementation has changed, and the user can cancel, delete, or successfully complete the task in the event log after the connection is restored. More details on how the new implementation works are described below.
Развитие платформы SmartPlayer добавляет новый полезный функционал. Ранее при потере соединения во время загрузки логов задача, создаваемая в личном кабинете SmartPlayer становилась бесконечной и не пропадала из журнала, тем самым создавала дополнительную нагрузку на серверное приложение. Теперь же реализация изменилась и пользователь в журнале событий может отменить, удалить и успешно завершить задачу после появления соединения. Ниже будет подробнее описано, как работает новая реализация.
== '''Action Algorithm''' ==
== '''Алгоритм действия''' ==
First, the user must register or log in to the SmartPlayer personal account.<br>
Первоначально пользователю необходимо зарегистрироваться/авторизоваться в личном кабинете SmartPlayer.<br>
Next, the user needs to go to the "Devices" section of the personal account and select the desired device.
Следующим шагом пользователю необходимо перейти в раздел «Устройства» личного кабинета и выбрать нужное устройство.
[[File:Уведомление2.jpg|thumb|center| Example of the "Devices" section and selected device in the SmartPlayer personal account|800px]]
[[File:Уведомление2.jpg|thumb|center| Пример отображения раздела «Устройства» и выбранного устройства в личном кабинете SmartPlayer|800px]]
A control panel for the device will open on the right side. In this panel, the user needs to click the "Export logs" line.
Cледующим шагом справа от устройства откроется панель управления устройством. В этой панели пользователю необходимо нажать на строку «Выгрузить логи».
[[File:Пункт_выгрузки_логов.jpg|thumb|center| Example of the "Export logs" line in the SmartPlayer personal account|800px]]
[[File:Пункт_выгрузки_логов.jpg|thumb|center| Пример отображения строки «Выгрузить логи» в личном кабинете SmartPlayer|800px]]
After clicking the line, a modal window for log export will appear. In this window, the user must select the type of logs to be exported:
Кликнув на строку пользователю откроется модальное окно с выгрузкой логов. В этом окне необходимо выбрать тип выгружаемых логов:
* current only for the current working session of the device (logs recorded after the last device reboot);
* актуальные только за текущую рабочую сессию устройства (логи, которые фиксировались после последнего перезапуска устройства);
* full logs for the entire period of device operation.
* полные логи за всё время работы устройства.
[[File:Окно_выгрузки.jpg|thumb|center| Example of the modal window for selecting the type of logs to export |800px]]
[[File:Окно_выгрузки.jpg|thumb|center| Пример отображения модального окна с выбором типа логов для выгрузки |800px]]
To start the export process, the user must click the "Start" button.<br>
Для запуска процесса выгрузки логов пользователю необходимо нажать на кнопку «Запустить».<br>
After launching the log export process, a notification will appear in the lower-left part of the personal account screen.
После запуска процесса выгрузки в личном кабинете появится уведомление в левой нижней части экрана.
[[File:Уведомление.jpg|thumb|center| Example of a log export notification|800px]]
[[File:Уведомление.jpg|thumb|center| Пример отображения уведомления о выгрузке логов|800px]]
This notification contains a "Go to" button, which can be clicked to go to the "Devices" section and the "Device Log" category.
В этом уведомлении присутствует кнопка «Перейти» по которой можно кликнуть и перейти в раздел «Устройства» и категорию «Журнал устройств».
[[File:Уведомление_кроп.jpg|thumb|center| Example of the "Go to" button in the log export notification|800px]]
[[File:Уведомление_кроп.jpg|thumb|center| Пример отображения кнопки «Перейти» в уведомлении о выгрузке логов|800px]]
{{Note| All exported logs can also be viewed in the "Devices" section under the "Device Log" category.
{{Note| Все выгруженные логи также можно просмотреть в разделе «Устройства» в категории «Журнал устройств».
[[File:Раздел_в_боковом_меню.jpg|thumb|center| Example of the "Device Log" category location in the personal account|800px]]|warn}}
[[File:Раздел_в_боковом_меню.jpg|thumb|center| Пример отображения расположение категории «Журнал устройств» в личном кабинете|800px]]|warn}}
== '''Viewing the Device Log''' ==
== '''Просмотр журнала устройств''' ==
After navigating to the "Device Log" category, the user can view all exported logs from devices.
После перехода в категорию «Журнал устройств» пользователь может ознакомиться со всеми выгруженными логами с устройств.
[[File:Раздел_в_боковом_меню.jpg|thumb|center| Example of the "Device Log" category location in the personal account|800px]]
[[File:Раздел_в_боковом_меню.jpg|thumb|center| Пример отображения расположение категории «Журнал устройств» в личном кабинете|800px]]
In the "Device Log" category, the user will see a list of log tasks.
В категории «Журнал устройств» пользователь увидит список задач по логам.
[[File:Статусы_задач.jpg|thumb|center| Example of the "Device Log" category with task list|800px]]
[[File:Статусы_задач.jpg|thumb|center| Пример отображения категории «Журнал устройств» со списком задач|800px]]
{{Note|If there are no tasks (exported logs) in the "Device Log" category, the page looks like this:
{{Note|Если в категории «Журнал устройств» нет задач (выгруженных логов), страница выглядит так:
[[File:Раздел_без_задач.jpg|thumb|center| Example of an empty "Device Log" main page|800px]]|warn}}
[[File:Раздел_без_задач.jpg|thumb|center| Пример отображения пустой главной страницы категории «Журнал устройств»|800px]]|warn}}
== '''Exported Task (Log) Statuses''' ==
== '''Статусы выгруженных задач (логов)''' ==
All exported tasks can be divided into the following groups:
Все выгруженные задачи можно разделить на следующие группы:
# In progress the task (log) is currently being formed. Indicated by an empty circle and the corresponding value in the "Progress" column.
# В процессе задача (лог), который находится в процессе формирования. Обозначается пустым кругом и в столбце «Прогресс» указано соответствующее значение.
# Canceled the task (log) was canceled during upload. Indicated by a yellow circle and the same name in the "Progress" column.
# Отменен задача (лог), который был отменен в процессе загрузки. Обозначается жёлтым кругом и имеет в столбце «Прогресс» одноименный статус.
# Uploaded the task (log) was successfully generated on the server and uploaded to the personal account. Indicated by a green circle and the same name in the "Progress" column.
# Загружен задача (лог), который был полностью сформирован на серверном приложении и загружен в личный кабинет. Обозначается зелёным кругом и имеет в столбце «Прогресс» одноименный статус.
[[File:Статусы_задач_новые.jpg|thumb|center| Example of task (log) status display|800px]]
[[File:Статусы_задач_новые.jpg|thumb|center| Пример отображения статуса задач (логов)|800px]]
{{Note|While the task (log) is being generated, the user can cancel it by clicking the "Cancel upload" line.
{{Note|В процессе формирования задачи (лога) пользователь может отменить его нажав на строку «Отменить выгрузку».
[[File:Отмена_задачи_в_прогрессе.jpg|thumb|center| Example of the "Cancel upload" line|800px]]|warn}}
[[File:Отмена_задачи_в_прогрессе.jpg|thumb|center| Пример отображения строки «Отменить выгрузку»|800px]]|warn}}
== '''Completed Tasks''' ==
== '''Выполненные задачи''' ==
After the task (log) is completed, the user can perform the following actions:
После формирования задачи (логов) пользователь может проделать следующие действия:
# Download.
# Скачать.
# Delete.
# Удалить.
[[File:Скачивание_готовых_логов.jpg|thumb|center| Example of "Download" and "Delete" buttons for exported log tasks|800px]]
[[File:Скачивание_готовых_логов.jpg|thumb|center| Пример отображения кнопок «Скачать» и «Удалить» для выгруженных задач (логов)|800px]]
== '''Bulk Task Selection''' ==
== '''Массовый выбор задач''' ==
The user can select multiple log tasks at once using checkboxes. All selected tasks will appear in the top-right part of the screen, and a control panel for the selected tasks will open.
Пользователь может выбрать сразу несколько задач (логов) выделив их с помощью чекбоксов (галочек). Все выделенные устройства отобразятся в правой верхней части экрана и откроется панель управления для выделенных задач.
[[File:Массовый_выбор_задач.jpg|thumb|center| Example of selected log tasks display|800px]]
[[File:Массовый_выбор_задач.jpg|thumb|center| Пример отображения выделенных задач (логов)|800px]]
After selecting the desired log tasks, the user can perform the following actions:
Выделив нужные задачи (логи), пользователь может проделать следующие действия:
# Export click the download button with the corresponding icon (arrow pointing down).
# Выгрузить нажать на кнопку загрузить с соответствующей иконкой (стрелка, направленная вниз).
# Delete click the button with the trash bin icon to delete the selected tasks.
# Удалить нажать на кнопку, которая удалит выделенные задачи (иконка в виде мусорной корзины).
# Deselect a button to clear the selection of all log tasks.
# Отменить выбор кнопка, которая позволяет снять выделение со всех логов (задач).
[[File:Удаление_выбранных_задач.jpg|thumb|center| Example of buttons for interacting with selected tasks|800px]]
[[File:Удаление_выбранных_задач.jpg|thumb|center| Пример отображения кнопок для взаимодействия с выделенными устройствами|800px]]
== '''Additional Information''' ==
== '''Дополнительная информация''' ==
If this article does not help use the functionality as intended or if there are questions after reading it, they can be asked 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 [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</div>

Текущая версия от 10:03, 8 октября 2025

Situation Description

The development of the SmartPlayer platform brings new useful functionality. Previously, if the connection was lost during log upload, the task created in the SmartPlayer personal account became infinite and remained in the log, thus creating additional load on the server application. Now the implementation has changed, and the user can cancel, delete, or successfully complete the task in the event log after the connection is restored. More details on how the new implementation works are described below.

Action Algorithm

First, the user must register or log in to the SmartPlayer personal account.
Next, the user needs to go to the "Devices" section of the personal account and select the desired device.

Example of the "Devices" section and selected device in the SmartPlayer personal account

A control panel for the device will open on the right side. In this panel, the user needs to click the "Export logs" line.

Example of the "Export logs" line in the SmartPlayer personal account

After clicking the line, a modal window for log export will appear. In this window, the user must select the type of logs to be exported:

  • current — only for the current working session of the device (logs recorded after the last device reboot);
  • full — logs for the entire period of device operation.
Example of the modal window for selecting the type of logs to export

To start the export process, the user must click the "Start" button.
After launching the log export process, a notification will appear in the lower-left part of the personal account screen.

Example of a log export notification

This notification contains a "Go to" button, which can be clicked to go to the "Devices" section and the "Device Log" category.

Example of the "Go to" button in the log export notification
All exported logs can also be viewed in the "Devices" section under the "Device Log" category.
Example of the "Device Log" category location in the personal account

Viewing the Device Log

After navigating to the "Device Log" category, the user can view all exported logs from devices.

Example of the "Device Log" category location in the personal account

In the "Device Log" category, the user will see a list of log tasks.

Example of the "Device Log" category with task list
If there are no tasks (exported logs) in the "Device Log" category, the page looks like this:
Example of an empty "Device Log" main page

Exported Task (Log) Statuses

All exported tasks can be divided into the following groups:

  1. In progress — the task (log) is currently being formed. Indicated by an empty circle and the corresponding value in the "Progress" column.
  2. Canceled — the task (log) was canceled during upload. Indicated by a yellow circle and the same name in the "Progress" column.
  3. Uploaded — the task (log) was successfully generated on the server and uploaded to the personal account. Indicated by a green circle and the same name in the "Progress" column.
Example of task (log) status display
While the task (log) is being generated, the user can cancel it by clicking the "Cancel upload" line.
Example of the "Cancel upload" line

Completed Tasks

After the task (log) is completed, the user can perform the following actions:

  1. Download.
  2. Delete.
Example of "Download" and "Delete" buttons for exported log tasks

Bulk Task Selection

The user can select multiple log tasks at once using checkboxes. All selected tasks will appear in the top-right part of the screen, and a control panel for the selected tasks will open.

Example of selected log tasks display

After selecting the desired log tasks, the user can perform the following actions:

  1. Export — click the download button with the corresponding icon (arrow pointing down).
  2. Delete — click the button with the trash bin icon to delete the selected tasks.
  3. Deselect — a button to clear the selection of all log tasks.
Example of buttons for interacting with selected tasks

Additional Information

If this article does not help use the functionality as intended or if there are questions after reading it, they can be asked 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 Как взаимодействовать пользователю с разделом "Обсуждения"