Документация 0.4 Справочник действий

Записать в файл

file.writeText · Файлы

Записывает или дописывает текст в файл

Записывает текст в файл или дописывает его в конец. Подходит для простых отчётов, CSV, журналов своего формата. Папки, которых нет, создаются.

Свойства #

Свойство Имя в файле Значение Обязательное По умолчанию Описание
Путь path путь к файлу да —
Текст text многострочный текст да —
Дописать в конец append да/нет нет нет
Кодировка encoding выбор из списка нет utf-8 Значения: utf-8, windows-1251.

Результат #

Действие не возвращает значений.

Как работает #

  • Путь (path) — куда писать. Относительный путь (без диска) считается от папки, где сохранён файл процесса: data\clients.csv, ..\data\clients.xlsx. Значение можно собрать из переменных: {{ folder }}\{{ name }}.txt.
  • Текст (text) — с подстановками {{ }}; объект или список в одиночном {{ }} записывается как JSON.
  • Дописать в конец (append) — выключено: файл перезаписывается; включено: текст добавляется в конец (перевод строки добавьте сами в конце текста).
  • Кодировка (encoding): utf-8 без BOM или windows-1251.

Ошибки #

Код Причина и что делать
FileLocked Файл открыт в другой программе — закройте её
InvalidArgument Нет прав на запись в папку или путь некорректен
FileNotFound Указан несуществующий диск или сетевая папка
Unknown Другая ошибка ввода-вывода (например, нет места на диске)

Пример #

Дописать строку в CSV-журнал:

{
  "type": "file.writeText",
  "props": { "path": "out\\result.csv", "text": "{{ row['Номер'] }};{{ requestNumber }}\n", "append": true }
}