Перейти к содержимому

Исходный код вики Файловое хранилище

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

Интерфейс НЕЙРОСС