Завантаження масиву файлів в одному полі через компонент File

Оновлений компонент форми File надає можливість зберігати масив файлів в одному полі. Усі завантажені файли показуються на формі, а також є можливість їх перегляду шляхом завантаження файлів.

1. Налаштування оновленого компонента file для завантаження масиву файлів

  1. Увійдіть до кабінету адміністратора регламентів

    import users(officer) 01

  2. Оберіть розділ Моделювання UI-форм.

    component file multiple values 01

  3. Натисніть Створити нову форму.

    component file multiple values 02

  4. Вкажіть бізнес-назву форми й службову назву форми.

    component file multiple values 03

  5. Оберіть розділ Оновлені. Зі списку оберіть компонент File і перетягніть його до області налаштування форми.

    component file multiple values 04

  6. Виконайте основні налаштування компонента.

    component file multiple values 05

  7. На вкладці Data оберіть прапорець Multiple Values. Це дозволить завантажувати масив файлів на формі.

    component file multiple values 06

  8. Виконайте усі необхідні налаштування компонента і натисніть Save.

2. Особливості завантаження масиву файлів

Налаштування розміру одного файлу у компоненті File стосується кожного окремого файлу, а не масиву файлів у полі. Максимальний чи мінімальний розмір файлу на формі має відповідати налаштуванням розміру файлу, а також бути у заданому форматі.

Максимальний та мінімальний розмір одного файлу з масиву визначається у полях File Maximum Size та File Minimum Size.

Налаштування сукупного максимального та мінімального розміру масиву файлів визначається в окремих полях: Maximum total size та Minimum total size.

Обмеження на сукупний об’єм масиву файлів, що завантажуються через бізнес-процес:

  • При моделюванні форми для завантаження масиву файлів (у компоненті File на вкладці Data активується чекбокс Multiple Values), у моделювальника на вкладці File з’являються два поля:

    • Maximum total size — максимальний сукупний об’єм файлів, що завантажуються.

    • Minimum total size — мінімальний сукупний об’єм файлів, що завантажуються.

  • Максимально можливе значення для поля Maximum total size — 100 MB. Це значення встановлюється для поля за замовчуванням, користувач може змінити його лише в меншу сторону. Це забезпечує дотримання технічних обмежень, що були встановлені адміністратором реєстру.

  • Ліміт стосується окремо кожного поля масиву файлів (1 поле, тобто 1 Upload-віджет) на формі, а не сумарно всієї сторінки (форми).

  • Якщо сукупний об’єм файлів, що завантажуються, перевищує 100 MB, то користувач знизу поля для завантаження бачить повідомлення:

    "Сукупний розмір завантажених файлів перевищує 100 MB".

Див. також — Керування обмеженнями на завантаження цифрових документів.
component file multiple values 08
Зображення 1. Максимальний сукупний обсяг файлів, що завантажуються через один компонент File

  1. Вкажіть допустимий формат файлу для завантаження (File Pattern).

    В системі існує спеціалізована функція під назвою save_digital_document(), яка відповідає за процес завантаження файлів (цифрових документів) всередині реєстру.

    При використанні цієї функції, система автоматично проводить процедуру валідації файлів, що завантажуються через UI-форми Кабінетів користувачами. Валідація полягає в перевірці файлів на відповідність певним обмеженням, зокрема щодо допустимих типів файлів.

    Наразі підтримуються наступні формати файлів для завантаження:

    • "application/pdf": "pdf"

    • "image/png": "png"

    • "image/jpeg": "jpg", "jpeg"

    • "text/csv": csv

    • "application/octet-stream": "asics"

    • "application/pkcs7-signature": "p7s"

    Ви можете ввести значення як application/pdf, так і .pdf тощо.

    Використовуйте кому (",") як роздільник для визначення декількох форматів у полі.

    component file multiple values 08 3

  2. Задайте будь-яке значення для сукупного максимального об’єму файлів для завантаження. Наприклад, 10MB.

  3. Задайте будь-яке значення для сукупного мінімального об’єму файлів для завантаження. Наприклад, 1MB.

    component file multiple values 08 1
    Зображення 2. Визначення обмежень у налаштуваннях компонента File
    component file multiple values 08 2
    Зображення 3. Завантаження одного файлу визначеного формату
    component file multiple values 09
    Зображення 4. Завантаження багатьох файлів визначених форматів

Також усі файли з масиву, що додаються, повинні мати унікальну назву, у разі, якщо формат файлу однаковий.

component file multiple values 11

Оновлений компонент file підтримує одночасне завантаження декількох файлів, як через вікно "Відкриття файлу", так і через перетягування багатьох файлів одночасно. Або можна додавати кожен файл окремо.

component file multiple values 07

Усі завантажені файли показуються на формі. Можливо видалити окремо кожен файл, натиснувши хрестик (🗙) біля назви файлу, а також переглянути завантажений файл, натиснувши на його назву.

component file multiple values 10

З міркувань безпеки, користувачі не мають змоги завантажувати файли, в яких було вручну змінено розширення. Іншими словами, контент файлу, який завантажується до системи, повинен відповідати його розширенню. Наприклад, якщо в .docx-файлі змінено розширення на .pdf, то при спробі завантаження такого файлу на формі Кабінету, користувач отримає помилку валідації.

component file multiple values 12

3. Пов’язані сторінки