Получить файлы папки с ограничением результата
Робот «Получить файлы папки с ограничением результата». Возвращает имена и размеры доступных файлов папки для дальнейших шагов.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора, который собирает обзор содержимого папки для следующего шага. Возвращает список доступных файлов с именами и размерами без ручного переписывания, показывая возможное сокращение выдачи.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID папки | Целое число | Обязательное; значение по умолчанию не задано |
| Максимум файлов в результате | Целое число | Обязательное; по умолчанию 100 |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID папки Диска.
- Выберите предел результата от 1 до 1000, по умолчанию 100.
- Получите JSON файлов и общее количество доступных файлов.
- Проверьте признак сокращения прежде, чем называть список полным.
- Передавайте необходимые ID и имена следующему действию; для вложенной папки требуется отдельное чтение её ID.
Учебный пример и ожидаемый результат
В папке 50 доступно 120 файлов, лимит 100. Ожидается сокращённый JSON и общее количество 120 с положительным признаком сокращения. Чтобы получить до 120 результатов, задайте достаточный предел в разрешённом диапазоне. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- Файлы в формате JSON: строка.
- Общее количество доступных файлов: целое число.
- Результат сокращён: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Читается только указанная папка, без рекурсивного обхода. Проверяется до 10 000 объектов, доступность ограничена правами приложения. Список имён не означает скачивание файлов или подтверждение их содержимого.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.