Работа с диском в бизнес-процессе Битрикс24: переименование загруженного файла + готовый пример

Самая популярная статья в моем блоге - это Работа с файлами и папками в бизнес-процессах Битрикс24, 2016 год. Когда я настраивала этот процесс для заказчика, столкнулась с тем, что загружаемый файл нужно переименовывать, но специальных настроек для этого нет. В комментариях к статье описала примерный алгоритм, как это сделать с помощью запуска дополнительного бизнес-процесса в диске. Получилась вполне рабочая схема без программных доработок, но с ограничением: корректно можно было только дописать что-то в начало названия файла, но не полностью поменять его. Если очень коротко, то проблема сводилась к тому, что нужно было в бизнес-процессе как-то получать расширение файла.

Настройка для переименования загружаемого файла так и не появилась, 2020 год 😂, но зато в бизнес-процессах появились функция калькулятора выражений explode и итератор, и, если очень захотеть, то переименовать файл с их помощью можно 😉

Будем настраивать упрощенный процесс:
Инициатор запускает процесс Загрузка договора с полями Номер договора с типом Строка и Договор с типом Файл. Загруженный файл автоматом сохраняется на общем диске в папке Договоры с названием Договор №{Номер договора}.{Расширение исходного файла}.

В общем диске создаем новый бизнес-процесс с названием Переименование файла с параметром Новое название. Этот процесс НЕ должен запускаться на создание/изменение.

Полностью схема процесса выглядит так:

1. В множественную переменную Название файла (массив) с типом Строка записываем выражение {{=explode('.',{=Document:NAME})}}. Эта функция разобьет имя файла на подстроки по разделителю точка. Для названия файла всегда будет 2 подстроки - название и расширение файла. Для того чтобы получить расширение мы всё это и делаем.

2. Запускаем итератор по переменной Название файла (массив).

3. На каждой итерации, а их будет 2, сохраняем значение итератора в переменную Значение итератора с типом Строка. Соответственно, на последней итерации мы сохраним в переменную расширение файла.

4. В переменной Новое название файла с типом Строка формируем новое название файла из значения параметра бизнес-процесса и полученного расширения: {=Template:new_name}.{=Variable:iterator_value}

Процесс в диске уже можно протестировать: для любого файла из общего диска запустить вручную бизнес-процесс Переименование файла, задать параметр и убедиться, что файл переименовался, а расширение при этом сохранилось.

Переходим к настройке основного процесса, полностью его схема выглядит так:

1. Загружаем исходный файл в диск.

2. Формируем в переменной Новое название файла (без расширения) значение параметра, который передадим в следующее действие: Договор №{=Document:PROPERTY_NOMER_DOGOVORA}. 

3. Запускаем бизнес-процесс Переименование файла для загруженного файла, в параметр передаем значение переменной Новое название файла (без расширения): 

Теперь можно тестировать весь процесс. Запускаем:

Мой Текстовый документ.docx сохранился в папке Договоры на Общем диске с новым названием Договор №165_34.docx:

Думаю, что с настройкой основного процесса проблем быть не должно: если вы так же как и я столкнулись с проблемой получить расширение файла, значит с первой частью вы уже разобрались. Если с настройкой шаблона в общем диске есть сложности, то можете скачать мой шаблон по ссылке, заимпортировать на свой портал и посмотреть детали настройки😀