Version 1.1 by pugachevskaya_elena on 2025/09/18 21:14

Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 (% style="color: rgb(23,43,77);" %)Раздел предназначен для администрирования Платформы НЕЙРОСС в части организации хранения файлов непосредственно на сервере Платформы. Доступ к разделу осуществляется под учётной записью с правом (%%)**Общее конфигурирование**(% style="color: rgb(23,43,77);" %) или под учётной записью root ~[(%%)[[Управление пользователями>>url:https://support.itrium.ru/pages/viewpage.action?pageId=923238997||style="text-decoration: none;" shape="rect"]](% style="color: rgb(23,43,77);" %)]. Функция файлового хранилища реализована с версии 20.10 Платформы НЕЙРОСС.
5
6 {{info}}
7 **Переход к функционалу**:
8
9 * С версии 20.40 ~[[[doc:ui.Рабочий стол НЕЙРОСС.Изменения интерфейса НЕЙРОСС.WebHome]]]: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > [[doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Накопители и файлы.WebHome]] > Вкладка Файловое хранилище.
10 * До версии 20.39 включительно: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > Файловое хранилище.
11 {{/info}}
12 {{/layout-cell}}
13
14 {{layout-cell}}
15 [[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание:
16
17 {{toc depth="2"/}}
18 {{/layout-cell}}
19 {{/layout-section}}
20
21 {{layout-section ac:type="single"}}
22 {{layout-cell}}
23 \\
24
25 {{excerpt atlassian-macro-output-type="INLINE"}}
26 == {{id name="Файловоехранилище-Функциихранилища"/}}Функции хранилища ==
27
28 Файловое хранилище позволяет:
29
30 * загрузить файл произвольного формата и размера;
31 * просмотреть содержимое загруженного файла (обеспечивается просмотр только изображений);
32 * скопировать ссылку на файл;
33 * изменить содержимое файла с сохранением ссылки неизменной;
34 * экспортировать все содержимое файлового хранилища в ZIP-архив для последующего импорта на другой узел Платформа НЕЙРОСС;
35 * импортировать все содержимое файлового хранилища из ZIP-архива;
36 * определить, требуется ли авторизация для доступа к изображению.
37
38 == {{id name="Файловоехранилище-Назначениефайловогохранилища"/}}Назначение файлового хранилища ==
39
40 Файлы из хранилища могут использоваться локально (то есть непосредственно на сервере Платформы НЕЙРОСС) формами, плагинами и скриптами. Также хранилище может использоваться как сетевой диск с правами только на чтение для распространения документов или любых других данных в локальной сети организации. Удалённому пользователю достаточно перейти по предоставленной ссылке посредством веб-браузера, загрузка файла инициируется автоматически. Ниже приведены примеры использования файлового хранилища.
41
42 === {{id name="Файловоехранилище-Оформлениепропусковиформвводаданныхвкорпоративномстиле"/}}Оформление пропусков и форм ввода данных в корпоративном стиле ===
43
44 Файлы изображений из файлового хранилища могут использоваться в формах печати пропусков и формах ввода данных в качестве подложек, отдельно стоящих изображений или элементов дизайна (например, кнопок) и предназначены для оформления АРМ Бюро пропусков и самих пропусков в корпоративном стиле. При этом возможно обновление изображений без необходимости правки шаблонов форм ввода и печати пропусков.
45
46 [[image:confluenceAttach:page:neyross.Управление пропусками@s_bp_printcard.png||width="260"]]
47
48 === {{id name="Файловоехранилище-Обменпроизвольнымидокументамивнутриорганизации"/}}Обмен произвольными документами внутри организации ===
49
50 Файлы произвольного формата и размера могут быть загружены в файловое хранилище с целью распространения внутри организации. Вы можете предоставить доступ к файлам без требования авторизации любому лицу с доступом к локальной сети организации. Это могут быть инструкции, файлы обновлений и любые другие данные. При этом вы можете изменять содержимое без необходимости обновлять ссылку. Таким образом, пользователь может самостоятельно проверять наличие любых новых вводных, хоть меню столовой на сегодня.
51
52 [[image:attach:file_storage.png||width="500"]]
53 {{/excerpt}}
54
55 \\
56
57 == {{id name="Файловоехранилище-Окнораздела"/}}(% style="letter-spacing: -0.008em;" %)Окно раздела(%%) ==
58
59 Вы можете добавить произвольное количество файлов любого формата, осуществить экспорт готового хранилища на другой узел Платформа НЕЙРОСС либо импорт готового хранилища на свою Платформу.
60
61 [[image:attach:s_file_storage_wnd.png||height="250"]]
62
63 1. [[Добавить файл в хранилище>>doc:||anchor="Файловоехранилище-Добавлениефайла"]]
64 1. (((
65 Список файлов в хранилище: перечень полей приведён в таблице ниже.
66
67 (% class="wrapped" %)
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 )))|(((
96 Время последнего изменения содержимого файла
97 )))
98 |(((
99 Дата доступа
100 )))|(((
101 Время последнего запроса файла
102 )))
103 |(((
104 Авторизация
105 )))|(((
106 Требуется или нет ввод учётных данных пользователя для доступа к файлу.
107 )))
108 |(((
109 (% class="content-wrapper" %)
110 (((
111 [[image:attach:ui.Параметры узла.WebHome@fa-link.png||thumbnail="true" width="20"]]
112 )))
113 )))|(((
114 [[Cсылка на файл>>doc:||anchor="Файловоехранилище-Ссылканафайл"]]
115 )))
116 |(((
117 (% class="content-wrapper" %)
118 (((
119 [[image:attach:ui.Параметры узла.WebHome@btn_prp.png||thumbnail="true" width="24"]]
120 )))
121 )))|(((
122 Команды управления файлом: [[Изменить (переименовать, заменить, скачать)>>doc:||anchor="Файловоехранилище-Заменасодержимогофайла"]], [[Удалить>>doc:||anchor="Файловоехранилище-Удалениефайла"]].
123 )))
124 )))
125 1. [[#Экспорт и импорт файлового хранилища>>doc:||anchor="Файловоехранилище-Экспортиимпортфайловогохранилища"]]: перенос содержимого хранилища с одного узла Платформа НЕЙРОСС на другой.
126
127 {{error}}
128 **ХРАНЕНИЕ ФАЙЛОВ**
129
130 Перед загрузкой файла большого размера убедитесь, что на системном диске достаточно свободного места. Если места недостаточно, файл не будет загружен, в интерфейсе отобразится сообщение об ошибке.
131
132 Файлы хранилища размером, не превышающим 1 Мб, хранятся непосредственно в базе данных Платформы НЕЙРОСС и включаются в резервную копию Платформы НЕЙРОСС. Файлы большего размера будут излишне увеличивать размер резервной копии, поэтому такие файлы сохраняются в папку на системном диске или в соответствующем volume, а в базу данных записывается ссылка на файл.
133 {{/error}}
134
135 == {{id name="Файловоехранилище-Добавлениефайла"/}}Добавление файла ==
136
137 Нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_plus_circle.png||thumbnail="true" height="17"]]**Добавить файл**.
138
139 [[image:attach:file_storage_add.png||height="250"]]
140
141 В отобразившемся окне:
142
143 * В поле **Название** введите название файла. Оно будет отображаться в списке файлов [2] в поле **Название**.
144 * (((
145 В поле **Доступ с авторизацией** установите переключатель в положение [[image:attach:ui.Параметры узла.WebHome@fa-on.png||thumbnail="true" height="18"]]**Включено**, если скачивание файла должно осуществляться только после после авторизации на узле Платформа НЕЙРОСС.
146
147 {{info}}
148 **ПОДСКАЗКА**
149
150 Для предоставления простого доступа к файлу по ссылке вида
151
152 {{code}}
153 http://[ip-адрес]/api/v1/storage/get_content/?uuid=f368f8b0-31d0-4699-b030-1435f7c29459
154 {{/code}}
155
156 где [ip-адрес], ip-адрес или доменное имя Платформы НЕЙРОСС
157
158 переключатель должен быть установлен в положение [[image:attach:ui.Параметры узла.WebHome@fa-off.png||thumbnail="true" height="18"]] **Выключено**.
159 {{/info}}
160 )))
161 * (((
162 В поле **Метки**, нажмите **Добавить метку** и введите произвольный текст-подсказку. Меток может быть несколько.
163
164 {{info}}
165 Фильтр по меткам будет добавлен в будущих версиях Платформы НЕЙРОСС.
166 {{/info}}
167 )))
168 * Укажите путь к файлу. Нажмите на кнопку **Добавить**.
169
170 [[image:attach:file_storage_add2.png]]
171
172 Файл будет загружен на сервер и отобразится в списке файлов [2].
173
174 == {{id name="Файловоехранилище-Ссылканафайл"/}}Ссылка на файл ==
175
176 Чтобы получить ссылку на файл, в строке файла нажмите на иконку [[image:attach:ui.Параметры узла.WebHome@fa-link.png||thumbnail="true" width="20"]].
177
178 [[image:attach:file_storage_link.png||height="159"]]
179
180 В отобразившемся окне нажмите **Копировать**. Затем закройте окно.
181
182 {{info}}
183 Для локального использования ссылки на текущем узле Платформа НЕЙРОСС, например, — в формах Бюро пропусков, удалите первую часть ссылки с ip-адресом:
184
185 {{code}}
186 /api/v1/storage/get_content/?uuid=a0e4671f-d179-498b-af3d-080fa181575e
187 {{/code}}
188
189 Для «внешних» пользователей используйте полную ссылку. Если настроен DNS, IP-адрес может быть заменён доменным именем сервера.
190 {{/info}}
191
192 \\{{id name="Файловоехранилище-download"/}}
193
194 == {{id name="Файловоехранилище-Скачиваниефайлаизхранилища"/}}Скачивание файла из хранилища ==
195
196 Чтобы скачать файл с любого компьютера локальной сети (в том числе, с рабочего места оператора):
197
198 В строке файла, содержимое которого требуется заменить, раскройте список команд [[image:attach:btn_prp.png||thumbnail="true" width="20"]] и выберите **Изменить**.
199
200 В отобразившемся окне:
201
202 * Нажмите на кнопку **Скачать файл.**
203
204 Файл будет загружен в папку загрузок браузера. Размер и расширение файла не изменится.**
205 \\[[image:attach:file_storage_edit.png]]**
206
207 \\
208
209 {{error}}
210 **HTTP**
211
212 При подключению по протоколу HTTP (без использования данных) возможно получение предупреждения о блокировке скачивания. Нажмите **Сохранить**.
213
214 [[image:attach:file_storage_download.png||width="331" data-xwiki-image-style-border="true" height="126"]]
215
216 \\
217
218 **UUID**
219
220 Скачанный файл при повторной загрузке в хранилище будет иметь другой UUID. Вследствие этого нарушится работа некоторых алгоритмов (например, будет не найден шаблон печати). При необходимости простой замены файла на новую версию используйте функцию замены содержимого ~[[[#Замена содержимого файла>>doc:||anchor="Файловоехранилище-Заменасодержимогофайла"]]]. Для переноса файлов на другой узел Платформа НЕЙРОСС используйте функцию экспорта всего файлового хранилища и последующего импорта на новом узле ~[[[#Экспорт и импорт файлового хранилища>>doc:||anchor="Файловоехранилище-Экспортиимпортфайловогохранилища"]]].
221 {{/error}}
222
223 \\
224
225 == {{id name="Файловоехранилище-Заменасодержимогофайла"/}}(% style="font-size: 20.0px;letter-spacing: -0.008em;" %)Замена содержимого файла(%%) ==
226
227 Чтобы изменить содержимое файла без изменения ссылки:
228
229 В строке файла, содержимое которого требуется заменить, раскройте список команд [[image:attach:ui.Параметры узла.WebHome@btn_prp.png||thumbnail="true" width="20"]] и выберите **Изменить**.
230
231 [[image:attach:file_storage_edit.png]]
232
233 В отобразившемся окне:
234
235 * Нажмите **Скачать файл**, если нужен старый экземпляр файла, и измените его.
236 * В поле **Новое содержимое** укажите путь к новому файлу.
237 * Нажмите на кнопку **Сохранить**.
238
239 {{info}}
240 Вы также можете изменить другие параметры файла: название, требование авторизации, набор меток.
241 {{/info}}
242
243 == {{id name="Файловоехранилище-Удалениефайла"/}}Удаление файла ==
244
245 Чтобы удалить файл, в строке файла раскройте список команд и выберите **Удалить**.
246
247 В окне подтверждения нажмите **Да**.
248
249 == {{id name="Файловоехранилище-Экспортиимпортфайловогохранилища"/}}Экспорт и импорт файлового хранилища ==
250
251 Функция экспорта и импорта файлового хранилища позволяют переносить файлы с одного узла Платформа НЕЙРОСС на другой.
252
253 {{info title="Пример"}}
254 На узле 1 в файловое хранилище загрузили файлы изображений для шаблонов бюро пропусков, настроили и проверили шаблоны. Затем требуется перенести эти шаблоны на узел 2. Импорт шаблонов форм ввода данных и печати пропусков осуществляется посредством АРМ НЕЙРОСС Доступ ~[[[confluencePage:page:neyross.Настройка форм ввода данных]], [[confluencePage:page:neyross.Настройка шаблона печати пропуска]]]. Импорт файлов осуществляется средствами данного раздела.
255 {{/info}}
256
257 {{info}}
258 **ПОДСКАЗКА**
259
260 При импорте в непустое хранилище оно не очищается, загружаются новые данные и обновляются «старые» файлы. Поиск дубликатов осуществляется по уникальному идентификатору (UUID).
261 {{/info}}
262
263 **Экспорт файлового хранилища:**
264
265 * Нажмите на кнопку **Экспорт**. Будет начата процедура создания файла архива.
266 * (((
267 Дождитесь сообщения о завершении процедуры:
268
269 {{code}}
270 Экспорт файлов хранилища успешно завершен
271 {{/code}}
272 )))
273 * (((
274 (% style="letter-spacing: 0.0px;" %)Файл архива будет сформирован и сохранён в папку загрузок браузера.\\
275
276 {{code}}
277 storage_export_[Дата]_[Ключ]
278 {{/code}}
279
280 , где
281 (% style="letter-spacing: 0.0px;" %)[Дата] — текущая дата в формате ГГГГММДД
282 [Ключ] — ключ,
283 Например: storage_export_20231103_163228
284 )))
285
286 \\
287
288 **Импорт файлового хранилища**
289
290 * Нажмите на кнопку **Импорт**.
291 * В новом окне укажите путь к файлу архива, нажмите на кнопку **Импортировать**.
292 [[image:attach:file_storage_import.png]]
293 * (((
294 Дождитесь окончания процедуры импорта и сообщения:
295
296 {{code}}
297 Файлы успешно импортированы
298 {{/code}}
299 )))
300 {{/layout-cell}}
301 {{/layout-section}}
302 {{/layout}}