Загрузка информации из XLSX списком/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Loading Information from XLSX as a List»
 
Нет описания правки
 
(не показаны 2 промежуточные версии 2 участников)
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
<languages/>
== '''Описание ситуации''' ==
== '''Situation Description''' ==
Развивая платформу SmartPlayer команда разработки добавляет новые и новые возможности. Теперь при настройке расписания у пользователя есть возможность добавить списком информацию об объектах из ".xlsx" - файла.
While developing the SmartPlayer platform, the development team continues to add new features. Now when configuring schedules, users can add object information from ".xlsx" files in bulk.
== '''Алгоритм действия''' ==
== '''Action Algorithm''' ==
Первым шагом для пользователя является - авторизация в личном кабинете SmartPlayer.<br>
The first step for the user is to log in to the SmartPlayer personal account.<br>
Следующим шагом пользователю необходимо перейти в раздел "Расписание".
Next, the user needs to navigate to the "Schedule" section.
[[File:Раздел_расписание.png|thumb|center| Пример отображения раздела "Расписание" в личном кабинете|800px]]
[[File:Раздел_расписание.png|thumb|center| Example of "Schedule" section in personal account|800px]]
Далее пользователю необходимо выбрать новое устройство и применить трансляцию.
Then the user should select a new device and apply a broadcast.
[[File:Выбранное_устройство.png|thumb|center| Пример отображения выбора устройства|800px]]
[[File:Выбранное_устройство.png|thumb|center| Example of device selection|800px]]
[[File:Выбор_трансляции.png|thumb|center| Пример отображения выбора трансляции|800px]]
[[File:Выбор_трансляции.png|thumb|center| Example of broadcast selection|800px]]
В процессе пользователю откроется тулбар справа в котором необходимо нажать на кнопку "Показать расписание".
During this process, a right-side toolbar will appear where the user needs to click "Show Schedule".
[[File:Показать_расписание.png|thumb|center| Пример отображения кнопки "Показать расписание" в тулбаре|800px]]
[[File:Показать_расписание.png|thumb|center| Example of "Show Schedule" button in toolbar|800px]]
На экране откроется новая страница с календарём. В ней нужно выбрать дату, от которой начнётся отсчёт расписания и нажать в тулбаре справа иконку в виде "+", под названием "Добавить расписание".
A new calendar page will open. Select the start date for the schedule and click the "+" icon in the right toolbar labeled "Add Schedule".
[[File:Добавить_расписание трансляции.png|thumb|center| Пример отображения выделения даты в календаре и иконки для добавления расписания|800px]]
[[File:Добавить_расписание трансляции.png|thumb|center| Example of date selection in calendar and schedule addition icon|800px]]
Система автоматически откроет новое окно, в котором пользователь должен обязательно произвести настройку параметров расписания.
The system will automatically open a new window where the user must configure schedule parameters.
[[File:Параметры_расписания.png|thumb|center| Пример отображения параметров расписания|800px]]
[[File:Параметры_расписания.png|thumb|center| Example of schedule parameters|800px]]
После всех описанных ранее шагов пользователю необходимо нажать на строку "Выбрать из файла". Таким образом он получит возможность загрузить ".xlsx" - файл с информацией.  
After these steps, click "Select from file" to upload an ".xlsx" file with information.
[[File:Выбрать_из_файла.png|thumb|center| Пример отображения настройки "Выбрать из файла"|800px]]
[[File:Выбрать_из_файла.png|thumb|center| Example of "Select from file" setting|800px]]
Загрузив файл, пользователь должен нажать на кнопку "Подробнее" в правом верхнем углу.  
After uploading, click "Details" in the top right corner.
[[File:Кнопка_подробнее.png|thumb|center| Пример отображения кнопки "Подробнее"|800px]]
[[File:Кнопка_подробнее.png|thumb|center| Example of "Details" button|800px]]
Таким образом он получит доступ к списку позиций из ".xlsx" - файлу и просмотреть какие устройства попали в список "Выбрано", а какие в "Не выбрано".
This provides access to the ".xlsx" file's item list, showing which devices fall into available categories:
[[File:Добавленные_значения.png|thumb|center| Пример отображения списков "Выбрано" и "Не выбрано" в ".xlsx" - файле|800px]]
* Selected
{{Note|Перенос устройств из списка "Не выбрано" в список "Выбрано" будет автоматическим. Этот перенос основан и работает на принципе сравнения данных с сервером. Загруженный список также имеется и на сервере что позволяет провести сравнение и выбрать нужные устройства.|warn}}
* Not selected
== '''Видеоинструкция''' ==  
[[File:Добавленные_значения.png|thumb|center| Example of "Selected" and "Not selected" lists in ".xlsx" file|800px]]
[https://vk.com/video-227547238_456239054 Загрузка информации из ".XLSX" - файла списком]
{{Note|Device transfer from "Not selected" to "Selected" happens automatically via server data comparison. The uploaded list exists on the server enabling this matching process.|warn}}
== '''Дополнительная информация''' ==
== '''File Example''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
Users can download and review a properly formatted sample file here: [https://docs.google.com/spreadsheets/d/1fm-lCWFOI11dW-607i7etYAWGlbTS4ig/edit?usp=drive_link&ouid=112553925670345352283&rtpof=true&sd=true link].
[[File:Обсуждение_загрузки_информации.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
The file contains two key parameters:
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
# Key field - must contain "digitalSignage"
</div>
# Device names - must match naming conventions in SmartPlayer personal account
[[File:Основные_поля.png|thumb|center| Example of required fields|800px]]
{{Note|Users must manually configure their files following this example.|warn}}
The sample file helps users create proper server-compatible files. Correctly prepared files are automatically detected by the client's server, which categorizes each ".xlsx" entry as selected/not selected.
=== '''Alternative Upload Method''' ===
For convenient ".xlsx" file configuration, users can:
Navigate to the "Devices" section
[[File:Устрйоства.png|thumb|center| Example of "Devices" section in personal account|800px]]
Select the folder with target devices
[[File:Выбранная_группа_устройств.png|thumb|center| Example of selected device folder|800px]]
After checkbox selection, find "Export Devices" in the right toolbar
[[File:Выгрузить_устройство.png|thumb|center| Example of "Export Devices" button|800px]]
Download and reconfigure the file following the sample format
[[File:Устройства из лк.png|thumb|center| Example of exported device file|800px]]
== '''Video Tutorial''' ==
[https://vk.com/video-227547238_456239054 Bulk upload from ".XLSX" files]
== '''Additional Information''' ==
For unresolved issues, please use the "Discussions" section at the page top.
[[File:Обсуждение_загрузки_информации.png|thumb|center| Example of "Discussions" tab on wiki-page|800px]]
More details at [[Как взаимодействовать пользователю с разделом "Обсуждения"]]

Текущая версия от 12:16, 13 мая 2025

Situation Description

While developing the SmartPlayer platform, the development team continues to add new features. Now when configuring schedules, users can add object information from ".xlsx" files in bulk.

Action Algorithm

The first step for the user is to log in to the SmartPlayer personal account.
Next, the user needs to navigate to the "Schedule" section.

Example of "Schedule" section in personal account

Then the user should select a new device and apply a broadcast.

Example of device selection
Example of broadcast selection

During this process, a right-side toolbar will appear where the user needs to click "Show Schedule".

Example of "Show Schedule" button in toolbar

A new calendar page will open. Select the start date for the schedule and click the "+" icon in the right toolbar labeled "Add Schedule".

Example of date selection in calendar and schedule addition icon

The system will automatically open a new window where the user must configure schedule parameters.

Example of schedule parameters

After these steps, click "Select from file" to upload an ".xlsx" file with information.

Example of "Select from file" setting

After uploading, click "Details" in the top right corner.

Example of "Details" button

This provides access to the ".xlsx" file's item list, showing which devices fall into available categories:

  • Selected
  • Not selected
Example of "Selected" and "Not selected" lists in ".xlsx" file
Device transfer from "Not selected" to "Selected" happens automatically via server data comparison. The uploaded list exists on the server enabling this matching process.

File Example

Users can download and review a properly formatted sample file here: link. The file contains two key parameters:

  1. Key field - must contain "digitalSignage"
  2. Device names - must match naming conventions in SmartPlayer personal account
Example of required fields
Users must manually configure their files following this example.

The sample file helps users create proper server-compatible files. Correctly prepared files are automatically detected by the client's server, which categorizes each ".xlsx" entry as selected/not selected.

Alternative Upload Method

For convenient ".xlsx" file configuration, users can: Navigate to the "Devices" section

Example of "Devices" section in personal account

Select the folder with target devices

Example of selected device folder

After checkbox selection, find "Export Devices" in the right toolbar

Example of "Export Devices" button

Download and reconfigure the file following the sample format

Example of exported device file

Video Tutorial

Bulk upload from ".XLSX" files

Additional Information

For unresolved issues, please use the "Discussions" section at the page top.

Example of "Discussions" tab on wiki-page

More details at Как взаимодействовать пользователю с разделом "Обсуждения"