Last modified by superadmin on 2026/06/24 21:40

Show last authors
1 Раздел предназначен для администрирования Платформы НЕЙРОСС в части организации хранения файлов непосредственно на сервере Платформы. Доступ к разделу осуществляется под учётной записью с правом **Общее конфигурирование** или под учётной записью root ~[[[Управление пользователями>>doc:neyross.Настройка Платформы НЕЙРОСС.Управление пользователями.WebHome||shape="rect"]]]. Функция файлового хранилища реализована с версии 20.10 Платформы НЕЙРОСС.
2
3 {{info}}
4 **Переход к функционалу**:
5
6 * С версии 20.40 ~[[[doc:ui.Рабочий стол НЕЙРОСС.Изменения интерфейса НЕЙРОСС.WebHome]]]: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > [[doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Накопители и файлы.WebHome]] > Вкладка Файловое хранилище.
7 * До версии 20.39 включительно: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > Файловое хранилище.
8 {{/info}}
9
10 == Функции хранилища ==
11
12 Файловое хранилище позволяет:
13
14 * загрузить файл произвольного формата и размера;
15 * просмотреть содержимое загруженного файла (обеспечивается просмотр только изображений);
16 * скопировать ссылку на файл;
17 * изменить содержимое файла с сохранением ссылки неизменной;
18 * экспортировать все содержимое файлового хранилища в ZIP-архив для последующего импорта на другой узел Платформа НЕЙРОСС;
19 * импортировать все содержимое файлового хранилища из ZIP-архива;
20 * определить, требуется ли авторизация для доступа к изображению.
21
22 == Назначение файлового хранилища ==
23
24 Файлы из хранилища могут использоваться локально (то есть непосредственно на сервере Платформы НЕЙРОСС) формами, плагинами и скриптами. Также хранилище может использоваться как сетевой диск с правами только на чтение для распространения документов или любых других данных в локальной сети организации. Удалённому пользователю достаточно перейти по предоставленной ссылке посредством веб-браузера, загрузка файла инициируется автоматически. Ниже приведены примеры использования файлового хранилища.
25
26 === Оформление пропусков и форм ввода данных в корпоративном стиле ===
27
28 Файлы изображений из файлового хранилища могут использоваться в формах печати пропусков и формах ввода данных в качестве подложек, отдельно стоящих изображений или элементов дизайна (например, кнопок) и предназначены для оформления АРМ Бюро пропусков и самих пропусков в корпоративном стиле. При этом возможно обновление изображений без необходимости правки шаблонов форм ввода и печати пропусков.
29
30 [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@s_bp_printcard.png||width="260"]]
31
32 === Обмен произвольными документами внутри организации ===
33
34 Файлы произвольного формата и размера могут быть загружены в файловое хранилище с целью распространения внутри организации. Вы можете предоставить доступ к файлам без требования авторизации любому лицу с доступом к локальной сети организации. Это могут быть инструкции, файлы обновлений и любые другие данные. При этом вы можете изменять содержимое без необходимости обновлять ссылку. Таким образом, пользователь может самостоятельно проверять наличие любых новых вводных, хоть меню столовой на сегодня.
35
36 [[image:attach:file_storage.png||width="500"]]
37
38
39 == Окно раздела ==
40
41 Вы можете добавить произвольное количество файлов любого формата, осуществить экспорт готового хранилища на другой узел Платформа НЕЙРОСС либо импорт готового хранилища на свою Платформу.
42
43 [[image:attach:s_file_storage_wnd.png||height="250"]]
44
45 1. [[Добавить файл в хранилище>>doc:||anchor="Файловоехранилище-Добавлениефайла"]]
46 1. (((
47 Список файлов в хранилище: перечень полей приведён в таблице ниже.
48
49 |=(((
50 Поле
51 )))|=(((
52 Комментарий
53 )))
54 |(((
55 Название
56 )))|(((
57 Назначается администратором в процессе добавления файла
58 )))
59 |(((
60 Тип
61 )))|(((
62 Рассчитывается автоматически по добавленному содержимому
63 )))
64 |(((
65 Метки
66 )))|(((
67 Произвольный набор меток. Может использоваться для объединения файлов по какому-либо признаку взамен папок.
68 )))
69 |(((
70 Дата создания
71 )))|(((
72 Время добавления файла в хранилище
73 )))
74 |(((
75 Дата изменения
76 )))|(((
77 Время последнего изменения содержимого файла
78 )))
79 |(((
80 Дата доступа
81 )))|(((
82 Время последнего запроса файла
83 )))
84 |(((
85 Авторизация
86 )))|(((
87 Требуется или нет ввод учётных данных пользователя для доступа к файлу.
88 )))
89 |(((
90 (((
91 [[image:attach:ui.Параметры узла.WebHome@fa-link.png||thumbnail="true" width="20"]]
92 )))
93 )))|(((
94 [[Cсылка на файл>>doc:||anchor="Файловоехранилище-Ссылканафайл"]]
95 )))
96 |(((
97 (((
98 [[image:attach:ui.Параметры узла.WebHome@btn_prp.png||thumbnail="true" width="24"]]
99 )))
100 )))|(((
101 Команды управления файлом: [[Изменить (переименовать, заменить, скачать)>>doc:||anchor="Файловоехранилище-Заменасодержимогофайла"]], [[Удалить>>doc:||anchor="Файловоехранилище-Удалениефайла"]].
102 )))
103 )))
104 1. [[#Экспорт и импорт файлового хранилища>>doc:||anchor="Файловоехранилище-Экспортиимпортфайловогохранилища"]]: перенос содержимого хранилища с одного узла Платформа НЕЙРОСС на другой.
105
106 {{error}}
107 **ХРАНЕНИЕ ФАЙЛОВ**
108
109 Перед загрузкой файла большого размера убедитесь, что на системном диске достаточно свободного места. Если места недостаточно, файл не будет загружен, в интерфейсе отобразится сообщение об ошибке.
110
111 Файлы хранилища размером, не превышающим 1 Мб, хранятся непосредственно в базе данных Платформы НЕЙРОСС и включаются в резервную копию Платформы НЕЙРОСС. Файлы большего размера будут излишне увеличивать размер резервной копии, поэтому такие файлы сохраняются в папку на системном диске или в соответствующем volume, а в базу данных записывается ссылка на файл.
112 {{/error}}
113
114 == {{id name="Файловоехранилище-Добавлениефайла"/}}Добавление файла ==
115
116 Нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_plus_circle.png||thumbnail="true" height="17"]]**Добавить файл**.
117
118 [[image:attach:file_storage_add.png||height="250"]]
119
120 В отобразившемся окне:
121
122 * В поле **Название** введите название файла. Оно будет отображаться в списке файлов [2] в поле **Название**.
123 * (((
124 В поле **Доступ с авторизацией** установите переключатель в положение [[image:attach:ui.Параметры узла.WebHome@fa-on.png||thumbnail="true" height="18"]]**Включено**, если скачивание файла должно осуществляться только после после авторизации на узле Платформа НЕЙРОСС.
125
126 {{info}}
127 **ПОДСКАЗКА**
128
129 Для предоставления простого доступа к файлу по ссылке вида
130
131 {{code language="java"}}
132 http://[ip-адрес]/api/v1/storage/get_content/?uuid=f368f8b0-31d0-4699-b030-1435f7c29459
133 {{/code}}
134
135 где [ip-адрес], ip-адрес или доменное имя Платформы НЕЙРОСС
136
137 переключатель должен быть установлен в положение [[image:attach:ui.Параметры узла.WebHome@fa-off.png||thumbnail="true" height="18"]] **Выключено**.
138 {{/info}}
139 )))
140 * (((
141 В поле **Метки**, нажмите **Добавить метку** и введите произвольный текст-подсказку. Меток может быть несколько.
142
143 {{info}}
144 Фильтр по меткам будет добавлен в будущих версиях Платформы НЕЙРОСС.
145 {{/info}}
146 )))
147 * Укажите путь к файлу. Нажмите на кнопку **Добавить**.
148
149 [[image:attach:file_storage_add2.png]]
150
151 Файл будет загружен на сервер и отобразится в списке файлов [2].
152
153 == {{id name="Файловоехранилище-Ссылканафайл"/}}Ссылка на файл ==
154
155 Чтобы получить ссылку на файл, в строке файла нажмите на иконку [[image:attach:ui.Параметры узла.WebHome@fa-link.png||thumbnail="true" width="20"]].
156
157 [[image:attach:file_storage_link.png||height="159"]]
158
159 В отобразившемся окне нажмите **Копировать**. Затем закройте окно.
160
161 {{info}}
162 Для локального использования ссылки на текущем узле Платформа НЕЙРОСС, например, — в формах Бюро пропусков, удалите первую часть ссылки с ip-адресом:
163
164 {{code language="java"}}
165 /api/v1/storage/get_content/?uuid=a0e4671f-d179-498b-af3d-080fa181575e
166 {{/code}}
167
168 Для «внешних» пользователей используйте полную ссылку. Если настроен DNS, IP-адрес может быть заменён доменным именем сервера.
169 {{/info}}
170
171
172 {{id name="Файловоехранилище-download"/}}
173
174 == {{id name="Файловоехранилище-Скачиваниефайлаизхранилища"/}}Скачивание файла из хранилища ==
175
176 Чтобы скачать файл с любого компьютера локальной сети (в том числе, с рабочего места оператора):
177
178 В строке файла, содержимое которого требуется заменить, раскройте список команд [[image:attach:btn_prp.png||thumbnail="true" width="20"]] и выберите **Изменить**.
179
180 В отобразившемся окне:
181
182 * Нажмите на кнопку **Скачать файл.**
183
184 Файл будет загружен в папку загрузок браузера. Размер и расширение файла не изменится.
185 \\**[[image:attach:file_storage_edit.png]]**
186
187
188 {{error}}
189 **HTTP**
190
191 При подключению по протоколу HTTP (без использования данных) возможно получение предупреждения о блокировке скачивания. Нажмите **Сохранить**.
192
193 [[image:attach:file_storage_download.png||data-xwiki-image-style-border="true" height="126" width="331"]]
194
195
196 **UUID**
197
198 Скачанный файл при повторной загрузке в хранилище будет иметь другой UUID. Вследствие этого нарушится работа некоторых алгоритмов (например, будет не найден шаблон печати). При необходимости простой замены файла на новую версию используйте функцию замены содержимого ~[[[#Замена содержимого файла>>doc:||anchor="Файловоехранилище-Заменасодержимогофайла"]]]. Для переноса файлов на другой узел Платформа НЕЙРОСС используйте функцию экспорта всего файлового хранилища и последующего импорта на новом узле ~[[[#Экспорт и импорт файлового хранилища>>doc:||anchor="Файловоехранилище-Экспортиимпортфайловогохранилища"]]].
199 {{/error}}
200
201
202 == {{id name="Файловоехранилище-Заменасодержимогофайла"/}}Замена содержимого файла ==
203
204 Чтобы изменить содержимое файла без изменения ссылки:
205
206 В строке файла, содержимое которого требуется заменить, раскройте список команд [[image:attach:ui.Параметры узла.WebHome@btn_prp.png||thumbnail="true" width="20"]] и выберите **Изменить**.
207
208 [[image:attach:file_storage_edit.png]]
209
210 В отобразившемся окне:
211
212 * Нажмите **Скачать файл**, если нужен старый экземпляр файла, и измените его.
213 * В поле **Новое содержимое** укажите путь к новому файлу.
214 * Нажмите на кнопку **Сохранить**.
215
216 {{info}}
217 Вы также можете изменить другие параметры файла: название, требование авторизации, набор меток.
218 {{/info}}
219
220 == {{id name="Файловоехранилище-Удалениефайла"/}}Удаление файла ==
221
222 Чтобы удалить файл, в строке файла раскройте список команд и выберите **Удалить**.
223
224 В окне подтверждения нажмите **Да**.
225
226 == {{id name="Файловоехранилище-Экспортиимпортфайловогохранилища"/}}Экспорт и импорт файлового хранилища ==
227
228 Функция экспорта и импорта файлового хранилища позволяют переносить файлы с одного узла Платформа НЕЙРОСС на другой.
229
230 {{info title="Пример"}}
231 На узле 1 в файловое хранилище загрузили файлы изображений для шаблонов бюро пропусков, настроили и проверили шаблоны. Затем требуется перенести эти шаблоны на узел 2. Импорт шаблонов форм ввода данных и печати пропусков осуществляется посредством АРМ НЕЙРОСС Доступ ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка форм ввода данных.WebHome]], [[neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка шаблона печати пропуска.WebHome]]]. Импорт файлов осуществляется средствами данного раздела.
232 {{/info}}
233
234 {{info}}
235 **ПОДСКАЗКА**
236
237 При импорте в непустое хранилище оно не очищается, загружаются новые данные и обновляются «старые» файлы. Поиск дубликатов осуществляется по уникальному идентификатору (UUID).
238 {{/info}}
239
240 **Экспорт файлового хранилища:**
241
242 * Нажмите на кнопку **Экспорт**. Будет начата процедура создания файла архива.
243 * (((
244 Дождитесь сообщения о завершении процедуры:
245
246 {{code language="java"}}
247 Экспорт файлов хранилища успешно завершен
248 {{/code}}
249 )))
250 * (((
251 Файл архива будет сформирован и сохранён в папку загрузок браузера.
252
253 {{code language="java"}}
254 storage_export_[Дата]_[Ключ]
255 {{/code}}
256
257 , где
258 [Дата] — текущая дата в формате ГГГГММДД
259 [Ключ] — ключ,
260 Например: storage_export_20231103_163228
261 )))
262
263
264
265 **Импорт файлового хранилища**
266
267 * Нажмите на кнопку **Импорт**.
268 * В новом окне укажите путь к файлу архива, нажмите на кнопку **Импортировать**.
269 [[image:attach:file_storage_import.png]]
270 * (((
271 Дождитесь окончания процедуры импорта и сообщения:
272
273 {{code language="java"}}
274 Файлы успешно импортированы
275 {{/code}}
276 )))