Компоненты
Файловый менеджер
Хранилище файлов привязано к конкретному боту — другие боты эти файлы не видят. Сюда кладут документы, картинки, архивы: всё, что нужно передать между шагами сценария или сохранить до следующего блока. Работать можно с одним файлом или сразу несколькими; поддерживаются папки, переименование и перенос.
В разделе «Проблемы» — три колонки: текст сообщения, что за ним стоит, и что делать. Точные формулировки в интерфейсе могут немного отличаться от указанных.
Что это
Каждый бот работает с отдельным хранилищем — файлы одного бота недоступны другому. Загружать можно по одному или сразу несколько; папки поддерживают вложенность, переименование и перемещение. Поиск по имени и фильтр по типу доступны там, где это предусмотрено в интерфейсе продукта.
Кому доступен
Файловый менеджер видят не все. Нужна либо полная роль на боте — как у владельца или администратора — либо отдельная роль файлового менеджера; название зависит от продукта. Добавьте пользователя в нужного бота и назначьте ему одну из этих ролей.
Если сотруднику нужен доступ только к файлам без сценариев и настроек — достаточно «файловой» роли, если она есть в продукте и это укладывается в политику доступа.
Ограничения
Хранилище по тарифу (общий объём на бота)
Цифра в таблице — весь объём, который занимает файловый менеджер этого бота, без разбивки по папкам.
| Тариф | Макс. объём (на бота) |
|---|---|
| Free | 500 МБ |
| Full | 3 ГБ |
| Premium | 10 ГБ |
| Professional | 100 ГБ |
| Unlimited | 300 ГБ |
Фиксированные лимиты продукта (для всех тарифов)
Эти ограничения действуют независимо от тарифа.
| Правило | Значение |
|---|---|
| Максимальный размер одного файла | 50 МБ |
| Максимум файлов в одной папке | 1 000 |
| Максимум вложенных папок у одного родителя | 50 |
| Максимальная глубина дерева папок | 5 уровней |
| Максимальная длина названия (поле имени файла или папки) | 500 символов |
| Поиск по имени: максимум результатов | 10 |
| Поиск по типу и имени: допустимый диапазон и размер страницы списка | от 1 до 100; размер страницы 50 |
Возможные проблемы и что делать
Найдите строку с текстом, который видите на экране. В средней колонке — что это значит, в правой — что делать.
Доступ
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Доступ запрещён (Access denied) | Действие запрещено: неверная роль, другой бот, другой компонент либо для этого бота нет файлового менеджера. | Проверьте роль пользователя, убедитесь, что он добавлен в правильного бота и что компонент «Файловый менеджер» подключён. Работайте только с теми папками и файлами, на которые есть права. |
Загрузка одного файла
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Нет файла или неверный формат запроса (Invalid or missing file. Send multipart/form-data with field "file".) | До сервера не дошёл нормальный файл: часто при загрузке в окне выбора ничего не выбрали или не нажали «Открыть»/«ОК». | Откройте выбор файла, укажите нужный, подтвердите выбор и повторите загрузку. Должен быть прикреплён настоящий файл, а не пустая отправка. |
| Файл слишком большой (File size must not exceed 50 MB.) | Файл больше жёсткого лимита. | Уменьшите, разбейте или сожмите файл; оставайтесь в пределах 50 МБ. |
| Нужен файл (File is required) | Файл обязателен, а его нет — чаще всего в окне выбора файла ничего не отметили. | Выберите файл в стандартном окне «Открыть», подтвердите, затем снова отправьте форму. |
| Сообщение об ошибке в данных (First validation message) | Не прошла одна из проверок: неверная папка, недопустимое имя или другое поле — в тексте сказано, что именно. | Прочитайте сообщение и исправьте то поле, на которое оно указывает. |
| Квота хранилища исчерпана (File manager storage quota exceeded.) | После загрузки суммарный объём бота превысил квоту по тарифу. | Удалите лишнее, загрузите что-то поменьше или перейдите на тариф с большим объёмом. |
| Слишком много файлов в папке (Maximum 1000 files per folder) | В папке уже максимальное число файлов. | Освободите место, используйте другую папку или удалите старые файлы. |
| Временный файл не читается (Upload source file is not readable) | Сбой на этапе чтения файла: глюк, битая копия или необычный источник. | Повторите загрузку с диска. Если снова ошибка — попробуйте другой файл или другой браузер; при повторе обратитесь в поддержку. |
| Размер не удалось прочитать (Could not read upload file size) | Файл исчез или не читается сразу после выбора. | Загрузите ещё раз; при повторе выберите файл заново или сохраните копию на диск и оттуда. |
| Размеры не совпадают (Upload size mismatch (declared X, file Y)) | В подсказке два числа — ожидаемый размер и фактический, они разошлись. | Запустите загрузку снова с тем же файлом с диска или переприкрепите его в форме. |
| Нельзя загрузить пустоту (Content for upload cannot be empty.) | Ушла пустая «загрузка» без реального содержимого. | Выберите нормальный непустой файл и отправьте ещё раз. |
| Источник не читается (указан путь) (Upload source is not readable: path) | Система не смогла взять файл с указанного места (сетевой диск, съём носителя и т.п.). | Скопируйте файл в обычную папку на компьютере и загрузите оттуда. |
| Источник пуст или размер неизвестен (Upload source is empty or size could not be determined.) | Файл пустой, повреждён или не поддаётся подсчёту размера. | Возьмите другой файл или пересохраните документ и загрузите снова. |
| Ошибка проверки формы (Web form validation text) | Не выполнено одно из правил для полей — длина имени, размер файла или другое. Текст сообщения укажет на конкретное поле. | Сократите имя, уменьшите файл или исправьте указанное поле. Пределы: имя до 500 символов, файл до 50 МБ. |
Загрузка нескольких файлов
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Файлы в запросе не найдены (No files. Send multipart/form-data with field "files[]" (recommended) or "files".) | На сервер ничего не пришло: чаще всего при открытии окна «Выбрать файлы» ничего не отметили или не подтвердили выбор. | В стандартном окне выбора отметьте один или несколько файлов, нажмите «Открыть»/«ОК» и снова отправьте. Без выбранных в диалоге файлов система нечего принимать. |
| Сообщение об ошибке в данных (First validation message) | Не прошла одна из проверок — папка, имя или другое поле. Текст укажет на конкретное место. | Исправьте поле, на которое указывает сообщение, и повторите действие. |
| Нужен хотя бы один файл (At least one file is required) | Список пуст — по смыслу то же: при загрузке не выбрали ни одного файла. | Добавьте хотя бы один файл через окно выбора, затем отправьте снова. |
| Некорректные файлы (One or more files are invalid.) | Как минимум один файл не подошёл (тип, размер, повреждение). | Выберите другие файлы или уменьшите размер; при сомнении прикрепляйте по одному и смотрите, какой не проходит. |
| Один из файлов слишком большой (Each file size must not exceed 50 MB.) | Как минимум один файл больше 50 МБ. | Загружайте меньшие файлы (каждый до 50 МБ). |
| Доступ запрещён (Access denied) | То же, что в таблице про доступ. | Приведите в порядок роли, бота и компонент; открывайте только разрешённое вам. |
| Слишком много файлов в папке (Maximum 1000 files per folder) | Целевая папка заполнена. | Распределите по разным папкам или удалите часть файлов. |
| Квота хранилища исчерпана (File manager storage quota exceeded.) | То же, что и при одной загрузке: на боте не остаётся свободного места в рамках тарифа. | Освободите место на боте или смените тариф на больший. |
| Иное сообщение об ошибке (Other error text) | Причина обычно из того же набора, что при одиночной загрузке: неверные поля, заполненная папка, нечитаемый файл. | Найдите похожую строку в таблице «Загрузка одного файла» и действуйте по ней. |
Папки: создание и перемещение
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Доступ запрещён (Access denied) | Нет доступа или ресурс не в вашей зоне. | Проверьте роли, бота, компонент и что папка ваша по правам. |
| Дерево слишком глубокое (Maximum directory depth is 5 levels) | Нельзя сделать дерево глубже пяти уровней. | Упростите структуру или выберите другого родителя, чтобы вписаться в лимит. |
| Слишком много вложенных папок (Maximum 50 directories per folder) | У этого родителя уже 50 вложенных папок. | Создавайте папки под другим уровнем или сначала удалите лишние вложенные папки. |
| Нельзя вложить папку в саму себя (Cannot move directory into itself) | Новая «родительская» папка совпадает с той, что переносите. | Укажите другого родителя, не тот же каталог. |
| Нельзя вложить папку в потомка (Cannot move directory into its descendant (would create a cycle)) | Пытаетесь сунуть папку внутрь её же подпапки — так нельзя. | Переместите в папку вне этой ветки. |
| Нельзя переместить папку в саму себя (Directory cannot be moved into itself) | Другая формулировка той же ошибки — папка снова оказалась выбрана как родитель для самой себя. | Родителем не должен быть сам переносимый каталог. |
| Новая родительская папка — из другого бота (New parent directory must be in the same component) | Родитель относится к хранилищу другого бота. | Выберите родителя только из файлового менеджера этого бота. |
| Нельзя вложить в подпапку (Cannot move directory into its descendant) | Коротко то же про «цикл»: нельзя в свою ветку вниз. | Не указывайте в качестве родителя папку внутри переносимой папки. |
Перемещение файлов (тот же лимит по количеству)
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Доступ запрещён (Access denied) | Как в таблице «Доступ» выше. | Сделайте то же, что для «Доступ запрещён» вверху страницы. |
| Слишком много файлов в папке (Maximum 1000 files per folder) | Папка, куда переносите, уже забита по лимиту. | Освободите место в ней, выберите другую папку или удалите лишние файлы. |
«Не найдено» и сбитые ссылки
| Сообщение | Что это значит | Что сделать |
|---|---|---|
| Файл не найден (File not found) | Такого файла уже нет, ссылка устарела, или вам нельзя его видеть. Это не про ситуацию «в загрузке не выбрали файлы» — тогда в таблицах выше пишут про пустой список в окне выбора. | Обновите список файлов, откройте тот, что реально есть. Если везде чисто — загрузите файл заново. |
| Папка не найдена (Directory not found) | Такой папки нет, она удалена, или к ней нет доступа (другой бот, права). | Выберите папку из дерева у этого бота или создайте новую, куда класть файлы. |
| Компонент файлов не найден (FileComponent not found) | К боту ещё не подключали файловый менеджер. | Включите или привяжите компонент «Файловый менеджер» к боту, потом снова откройте экран с файлами. |