Version 8.1 by admin on 2026/06/17 20:48

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