File Upload

Основы

Функция загрузки файлов позволяет пользователям загружать двоичные и текстовые файлы и обрабатывать эти данные в ускоренном режиме для отправки в локальное или удаленное хранилище и другие серверные системы.

Тип файла

Вы можете ввести массив строк, чтобы ограничить типы загружаемых файлов. Значение по умолчанию для параметра file type пустое, что означает, что предварительно не задано никаких ограничений. Каждое строковое значение в указанном массиве типов файлов должно быть уникальным спецификатором типа файла в одном из следующих форматов.

• Допустимое расширение имени файла без учета регистра, начинающееся с символа точки ("."), например .png, .txt или .pdf

• Допустимая строка в формате MIME без расширения

• Строка audio/* указывает на любой аудиофайл

• Строка video/* указывает на любой видеофайл

• Строка image/* указывает на любой файл изображение

Например, когда значение типа файла равно [".pdf", ".mp4", "image/*"], вы можете загружать файлы PDF, MP4 и любые типы изображений.

Тип загрузки

Вы можете решить, загружать ли один файл, несколько файлов или целый каталог.

Отображение загруженных файлов

Включите или выключите Отображение списка загружаемых файлов, чтобы отобразить или скрыть список загружаемых файлов. Вы также можете настроить это свойство с помощью JS-кода. По умолчанию его значение равно true.

В списке загруженных файлов представлены имена всех загруженных файлов в хронологическом порядке. Вы также можете просмотреть названия загруженных файлов с помощью свойства files[index].name. При наведении курсора мыши на файл 🗑️ появится значок, и вы можете нажать на него, чтобы удалить соответствующий файл.

Разбор файлов

Переключите функцию Синтаксического анализа файлов, и Apeekflow попытается преобразовать структуру данных загруженного файла в объекты, массивы или строки. Это работает со структурированными текстовыми данными, такими как файлы Excel, JSON и CSV.

Вы можете получить доступ к обработанному результату через свойство parsedValue.

Для каждого загруженного файла будет предпринята попытка анализа Apeekflow, и вы сможете получить доступ к данным файлов в массиве.

// access the structured content of an uploaded File in Apeekflow Apps
file1.parsedValue[0]
// the array contains the data for each uploaded file.
file1.parsedValue[0], file1.parsedValue[1], file1.parsedValue[2]

Валидация

На вкладке Validation вы можете настроить количество разрешенных к загрузке файлов, а также минимальный и максимальный размер одного загружаемого файла.

Максимальное количество файлов

Если выбран тип загрузки Несколько или Каталог, вы можете установить максимальное количество загружаемых файлов, чтобы ограничить максимальное количество загружаемых файлов. Если количество загружаемых файлов превысит это пороговое значение, самые старые загруженные файлы будут заменены последними.

Размер файла

Вы можете задать минимальный и максимальный размер загружаемых файлов, используя единицы измерения: kb, mb, gb или tb. Размер файла по умолчанию определяется в байтах. Когда размер загружаемого файла превысит допустимое значение, вы увидите глобальное предупреждение.

Доступ к загруженным файлам

Файлы, загруженные с помощью компонента file upload, сохраняются в кэш-памяти браузера в строковом формате в кодировке base64. Чтобы сохранить эти файлы в источниках данных, вам необходимо создать запросы для подключения к базам данных или API. Вы можете просмотреть свойства загруженных файлов в браузере данных на левой панели или получить доступ к именам свойств в{{}} или JS-запросы с помощью JS-кода. Обычно используются следующие свойства.

• value: Список содержимого загруженных файлов, закодированного в base64.

// Access the File content (represented as base64)
{{file1.value[0]}} // will return "WwogIHsKICAgICJpZCI6ICJkODE5NGI3Mi1lZGNiLTRhMWMtYTRlMC1lZT...

• files: Список метаданных загруженных файлов, включая uid, name, type, size, and lastModified.

// Access the File metadata information. 

{{file1.files[0].name}} // will return "open_issues.json"

{{file1.files[0].type}} // will return "application/json"

{{file1.files[0].type}} // will return "247285" (in bytes)

• parsedValue: Список значений проанализированных файлов.