Удалить файл из карточки
Робот «Удалить файл из карточки» удаляет файл из файлового поля CRM-сущности Битрикс24 — сделки, контакта, компании или лида — по индексу (0 — первый, -1 — последний) либо очищает всё поле, если индекс не задан. На вход подаются тип сущности, её ID, код файлового поля и индекс. Возвращает признак success (Y/N) и число оставшихся файлов.
Робот убирает вложения из файлового поля CRM-сущности прямо в бизнес-процессе. На вход подаются: тип сущности (deal, contact, company или lead), ID сущности, код файлового поля и индекс файла. Если индекс не задан, поле очищается целиком; индекс 0 удаляет первый файл, -1 — последний, отрицательные значения отсчитываются с конца, а выходящий за границы индекс приводится к ближайшему существующему. На выходе: success — признак Y при успешном обновлении карточки, иначе N, и remaining — сколько файлов осталось в поле после удаления. Применяйте, чтобы удалить устаревший черновик договора при смене стадии сделки, очистить временные вложения после обработки или убрать лишний файл, оставив остальные. Если параметры неверны или сущность не найдена, робот возвращает success N; для уже пустого поля — success Y и remaining 0. Признаки success и remaining можно сравнивать в условии следующего шага бизнес-процесса.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Тип сущности: deal / contact / company / lead | string | да | |
| ID сущности | int | да | |
| Код файлового поля | string | да | |
| Индекс файла для удаления (0 = первый, -1 = последний). Оставьте пустым — очистить всё поле | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| Осталось файлов после удаления | int |
Сценарий: очистка временных вложений после согласования
- Сделка переходит на стадию «Согласовано»
- Робот удаляет первый файл из поля черновиков (индекс 0)
- В remaining возвращается число оставшихся файлов, success показывает Y или N