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