Документация 0.4 Справочник действий
Прочитать файл
file.readText · Файлы
Читает текстовый файл целиком
Читает текстовый файл целиком в переменную: CSV, JSON, лог, шаблон письма. Для таблиц Excel используйте
excel.readRange.
Свойства #
| Свойство | Имя в файле | Значение | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|---|
| Путь | path |
путь к файлу | да | — | |
| Кодировка | encoding |
выбор из списка | нет | utf-8 |
Значения: utf-8, windows-1251. |
Результат #
Значение выхода сохраняется в переменную, выбранную для него в свойствах шага (раздел выходов).
| Выход | Имя в файле |
|---|---|
| Текст | text |
Как работает #
- Путь (
path) — путь к файлу. Относительный путь (без диска) считается от папки, где сохранён файл процесса:data\clients.csv,..\data\clients.xlsx. Значение можно собрать из переменных:{{ folder }}\{{ name }}.txt. - Кодировка (
encoding):utf-8(по умолчанию) илиwindows-1251— для файлов из старых программ, где кириллица в UTF-8 превращается в „кракозябры“. - JSON из текста разбирается выражением:
JSON.parse(text); CSV — например,text.split('\n').map(l => l.split(';')).
Ошибки #
| Код | Причина и что делать |
|---|---|
FileNotFound |
Файла или папки нет — проверьте путь; путь без диска считается от папки процесса |
FileLocked |
Файл открыт другой программой на запись — закройте её |
InvalidArgument |
Нет доступа к файлу (права Windows) или путь некорректен |
Unknown |
Другая ошибка ввода-вывода — текст ошибки в сообщении |
Пример #
{ "type": "file.readText", "props": { "path": "settings.json", "encoding": "utf-8" }, "out": { "text": "settingsText" } }
Затем control.assign с выражением JSON.parse(settingsText).