МОДУЛЬ «РАБОТА С ФАЙЛАМИ»
Основные моменты модуля
Модуль «Работа с файлами» предназначен для изменения расположения файлов, их копирования, архивирования, создания папки и переноса файлов в неё, в общем, для манипуляции с файлами и директориями.
Интерфейс модуля
Окно модуля объединяет три группы элементов.
Первая группа элементов – это набор полей и кнопок для создания команды. Вторая – непосредственно список команд. И третья – это область предварительного просмотра текстовых файлов.
Набор доступных полей для заполнения меняется в зависимости от выбранного действия, подробное описание всех полей будет описано дальше.
Функциональность модуля
Создание команды
Команда создается следующим образом – выбирается необходимое действие, заполняются остальные поля – нажимается кнопка «Добавить», по которой команда добавляется в «Список команд».
Редактирование команды
Для того чтобы отредактировать команду, выделите её в списке команд щелчком левой кнопкой мыши, после чего все поля в левой верхней части окна «Работа с файлами» заполнятся в соответствии с выбранной командой. Измените те поля, которые требуется отредактировать, и, убедившись, что в списке команд все еще выбрано нужное действие, нажмите на кнопку «Редактировать».
Удаление команды
Для удаления команды необходимо выбрать её в списке команд и нажать на кнопку «Удалить».
Отключение/включение команды
Созданные команды можно отключать и обратно включать. Отключенные команды не будут выполняться. Сделать это можно, нажав на соответствующую отключаемой команде строку правой кнопкой мыши и выбрав «Отключить/включить».
Выбор файла/папки
Кнопка в заполняемых полях открывает стандартный диалог выбора файла или папки, в зависимости от выбранного действия.
Описание действий, доступных в модуле
Модуль содержит 19 действий, позволяющих работать с папками и файлами, каждое из которых состоит из своего набора полей для настройки. Ниже описаны все действия модуля.
Модуль имеет возможность работы с сетевыми папками, для этого предусмотрены поля «Домен», «Пользователь» и «Пароль». Остальные поля заполняются в соответствии с выбранным действием.
Перечень и описание действий
Действие «Сохранить в файл»
Действие перезаписывает существующий текстовый файл, записывая в него строку, указанную в поле «Значение».
Действие «Считать файл»
Действие считывает весь текст из выбранного файла и записывает его в указанную переменную.
Поле «Начальная кодировка» отвечает за выбор кодировки, которая будет использоваться при чтении из файла.
Действие «Получить список файлов в папке»
Действие создает переменную-список, в которой лежат пути до каждого файла в папке.
ПРИМЕР.
Пусть имеется папка «Робот», в которой находится 3 Excel-файла. Тогда в модуле Excel мы можем работать с каждым из файлов, например, чтобы работать с первым, нужно записывать в поле «Имя файла» v.files[0].
Переменная после выполнения действия будет выглядеть как на рисунке 6:
Действие «Добавить текст в файл»
Действие добавляет текст к уже существующему в файле, не перетирая его данных.
Действие «Добавить переход на новую строку»
Действие добавляет символ перехода на новую строку в текст файла.
Действие «Переместить файл»
Действие перемещает выбранный файл в указанную папку. В поле «Переменная» можно, но не обязательно, ввести название переменной, в которую будет возвращен новое расположение до файла (в ниже представленном примере – C:\Users\user\Desktop\Документы\text.docx).
Если файл в конечной директории уже существует – он будет перезаписан.
Действие «Переименовать файл»
Действие меняет имя выбранного файла на указанное в поле «Имя файла».
Если файл с таким же именем уже существует – он будет перезаписан.
Действие «Создать файл»
Действие создает новый текстовый файл с расширением по умолчанию .txt. Если указано другое расширение, то будет создан файл с соответствующим расширением. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение созданного файла.
Если файл с таким именем уже существует – он будет перезаписан.
Действие «Удалить файл»
Действие удаляет выбранный файл.
Действие «Скопировать файл»
Действие копирует выбранный файл в указанную директорию.
В поле «Путь до конечного файла» необходимо ввести путь до папки, в которую файл должен скопироваться, и его название с расширением так, как будто файл уже есть. Новое название может отличаться от исходного.
Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение нового файла.
Если файл с таким именем уже существует – он будет перезаписан.
Действие «Проверить существование файла»
Действие проверяет существование указанного файла и записывает результат в переменную. Результат имеет тип bool, то есть true - если существует, и иначе false.
Действие «Переместить папку»
Действие перемещает папку, указанную поле «Путь к папке», в директорию, указанную в поле «Путь до конечной папки». Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено новое расположение перемещаемой папки.
Если папка с таким именем в конечной папке уже существует – программа выдаст ошибку и не переместит папку.
Действие «Создать папку»
Действие создает папку с указанным названием в выбранной директории. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение новой папки.
Если создаваемая папка уже существует – программа не создаст новую папку и не выдаст ошибку. Перед созданием папки проверяйте её наличие другими действиями модуля.
Действие «Удалить папку»
Действие удаляет выбранную папку.
Действие «Проверить существование папки»
Действие проверяет существование указанной папки и записывает результат в переменную. Результат имеет тип bool, то есть true - если существует, и иначе false.
Действие «Получить список папок в папке»
Действие создает переменную-список, в которой лежат пути до каждого файла в папке.
Действие «Заархивировать папку»
Действие создает ZIP-архив с указанным именем, добавляя в него содержимое выбранной папки. Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение созданного архива.
Если архив с таким именем уже существует – программа выдаст ошибку.
Действие «Распаковать архив»
Действие распаковывает архив в указанную папку. Поддерживаются типы архивов 7z, zip. При наличии пароля он вводится в соответствующее поле «Пароль».
Действие «Получить base64 из файла»
ДДействие преобразовывает файл в строку, закодированную стандартом Base64. Это может пригодиться при загрузке файла базу данных, отправке в веб-запросах и другом.