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