МОДУЛЬ «РАБОТА С ФАЙЛАМИ»

Основные моменты модуля

Модуль «Работа с файлами» предназначен для изменения расположения файлов, их копирования, архивирования, создания папки и переноса файлов в неё, в общем, для манипуляции с файлами и директориями.

Интерфейс модуля

Окно модуля объединяет три группы элементов.

Первая группа элементов – это набор полей и кнопок для создания команды. Вторая – непосредственно список команд. И третья – это область предварительного просмотра текстовых файлов.

Рис. 1. Окно модуля

Набор доступных полей для заполнения меняется в зависимости от выбранного действия, подробное описание всех полей будет описано дальше.

Функциональность модуля

Создание команды

Команда создается следующим образом – выбирается необходимое действие, заполняются остальные поля – нажимается кнопка «Добавить», по которой команда добавляется в «Список команд».

Редактирование команды

Для того чтобы отредактировать команду, выделите её в списке команд щелчком левой кнопкой мыши, после чего все поля в левой верхней части окна «Работа с файлами» заполнятся в соответствии с выбранной командой. Измените те поля, которые требуется отредактировать, и, убедившись, что в списке команд все еще выбрано нужное действие, нажмите на кнопку «Редактировать».

Удаление команды

Для удаления команды необходимо выбрать её в списке команд и нажать на кнопку «Удалить».

Отключение/включение команды

Созданные команды можно отключать и обратно включать. Отключенные команды не будут выполняться. Сделать это можно, нажав на соответствующую отключаемой команде строку правой кнопкой мыши и выбрав «Отключить/включить».

Рис. 2. Контекстное меню команды

Выбор файла/папки

Кнопка в заполняемых полях открывает стандартный диалог выбора файла или папки, в зависимости от выбранного действия.

Описание действий, доступных в модуле

Модуль содержит 19 действий, позволяющих работать с папками и файлами, каждое из которых состоит из своего набора полей для настройки. Ниже описаны все действия модуля.

Модуль имеет возможность работы с сетевыми папками, для этого предусмотрены поля «Домен», «Пользователь» и «Пароль». Остальные поля заполняются в соответствии с выбранным действием.

Перечень и описание действий

Действие «Сохранить в файл»

Действие перезаписывает существующий текстовый файл, записывая в него строку, указанную в поле «Значение».

Рис. 3. Пример настройки действия «Сохранить в файл»

Действие «Считать файл»

Действие считывает весь текст из выбранного файла и записывает его в указанную переменную.

Рис. 4. Пример настройки действия «Считать файл»

Поле «Начальная кодировка» отвечает за выбор кодировки, которая будет использоваться при чтении из файла.

Действие «Получить список файлов в папке»

Действие создает переменную-список, в которой лежат пути до каждого файла в папке.

Рис. 5. Пример настройки действия «Получение списка файлов»

ПРИМЕР.

Пусть имеется папка «Робот», в которой находится 3 Excel-файла. Тогда в модуле Excel мы можем работать с каждым из файлов, например, чтобы работать с первым, нужно записывать в поле «Имя файла» v.files[0].

Переменная после выполнения действия будет выглядеть как на рисунке 6:

Рис. 6. Пример переменной, в которой содержится список файлов

Действие «Добавить текст в файл»

Действие добавляет текст к уже существующему в файле, не перетирая его данных.

Рис. 7. Пример настройки действия «Добавить текст в файл»

Действие «Добавить переход на новую строку»

Действие добавляет символ перехода на новую строку в текст файла.

Рис. 8. Пример настройки действия «Добавить переход на новую строку»

Действие «Переместить файл»

Действие перемещает выбранный файл в указанную папку. В поле «Переменная» можно, но не обязательно, ввести название переменной, в которую будет возвращен новое расположение до файла (в ниже представленном примере – C:\Users\user\Desktop\Документы\text.docx).

Если файл в конечной директории уже существует – он будет перезаписан.

Рис. 9. Пример настройки действия «Перемещение файла»

Действие «Переименовать файл»

Действие меняет имя выбранного файла на указанное в поле «Имя файла».

Если файл с таким же именем уже существует – он будет перезаписан.

Рис. 10. Пример настройки действия «Переименовать файл»

Действие «Создать файл»

Действие создает новый текстовый файл с расширением по умолчанию .txt. Если указано другое расширение, то будет создан файл с соответствующим расширением. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение созданного файла.

Если файл с таким именем уже существует – он будет перезаписан.

Рис. 11. Пример настройки действия «Создать файл»

Действие «Удалить файл»

Действие удаляет выбранный файл.

Рис. 12. Пример настройки действия «Удалить файл»

Действие «Скопировать файл»

Действие копирует выбранный файл в указанную директорию.

В поле «Путь до конечного файла» необходимо ввести путь до папки, в которую файл должен скопироваться, и его название с расширением так, как будто файл уже есть. Новое название может отличаться от исходного.

Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение нового файла.

Если файл с таким именем уже существует – он будет перезаписан.

Рис. 13. Пример настройки действия «Скопировать файл»

Действие «Проверить существование файла»

Действие проверяет существование указанного файла и записывает результат в переменную. Результат имеет тип bool, то есть true - если существует, и иначе false.

Рис. 14. Пример настройки действия «Проверить существование файла»

Действие «Переместить папку»

Действие перемещает папку, указанную поле «Путь к папке», в директорию, указанную в поле «Путь до конечной папки». Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено новое расположение перемещаемой папки.

Если папка с таким именем в конечной папке уже существует – программа выдаст ошибку и не переместит папку.

Рис. 15. Пример настройки действия «Перемещение папки»

Действие «Создать папку»

Действие создает папку с указанным названием в выбранной директории. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение новой папки.

Если создаваемая папка уже существует – программа не создаст новую папку и не выдаст ошибку. Перед созданием папки проверяйте её наличие другими действиями модуля.

Рис. 16. Пример настройки действия «Создание папки»

Действие «Удалить папку»

Действие удаляет выбранную папку.

Рис. 17. Пример настройки действия «Удалить папку»

Действие «Проверить существование папки»

Действие проверяет существование указанной папки и записывает результат в переменную. Результат имеет тип bool, то есть true - если существует, и иначе false.

Рис. 18. Пример настройки действия «Проверить существование папки»

Действие «Получить список папок в папке»

Действие создает переменную-список, в которой лежат пути до каждого файла в папке.

Рис. 19. Пример настройки действия «Проверить существование папки»

Действие «Заархивировать папку»

Действие создает ZIP-архив с указанным именем, добавляя в него содержимое выбранной папки. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение созданного архива.

Если архив с таким именем уже существует – программа выдаст ошибку.

Рис. 20. Пример настройки действия «Заархивировать папку»

Действие «Распаковать архив»

Действие распаковывает архив в указанную папку. Поддерживаются типы архивов 7z, zip. При наличии пароля он вводится в соответствующее поле «Пароль».

Рис. 21. Пример настройки действия «Распаковать архив»

Действие «Получить base64 из файла»

ДДействие преобразовывает файл в строку, закодированную стандартом Base64. Это может пригодиться при загрузке файла базу данных, отправке в веб-запросах и другом.

Рис. 22. Пример настройки действия «Получить base64 из файла»