Wiki source code of Файловое хранилище
Version 1.1 by pugachevskaya_elena on 2025/09/18 21:14
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
1.1 | 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}} |