Lexema-RPA_Studio_Docs/docs/FileModule.md

8.5 KiB
Raw Blame History

Модуль «Работа с файлами»

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

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

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

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

![Screenshot](img/FM_1.png)

Набор доступных полей для заполнения меняется в зависимости от выбранного действия, подробное описание всех полей будет дано позже. ## Функциональность модуля ### Создание команды

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

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

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

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

![Screenshot](img/FM_2.png)

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

Кнопка ![Screenshot](img/FM_3.png) в заполняемых полях открывает стандартный диалог выбора файла или папки, в зависимости от выбранного действия. ## Перечень и описание действий ### Действие «Сохранить в файл»

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

![Screenshot](img/FM_4.png)

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

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

![Screenshot](img/FM_5.png)

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

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

![Screenshot](img/FM_6.png)

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

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

![Screenshot](img/FM_6_1.png)

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

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

![Screenshot](img/FM_6_2.png)

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

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

![Screenshot](img/FM_7.png)

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

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

![Screenshot](img/FM_7_1.png)

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

Действие создает новый файл с расширением .txt.

![Screenshot](img/FM_13.png)

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

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

![Screenshot](img/FM_14.png)

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

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

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

![Screenshot](img/FM_15.png)

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

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

«True» - если существует, и иначе «False».

![Screenshot](img/FM_16.png)

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

Действие перемещает папку, указанную во втором поле, в директорию, указанную в третьем поле.

![Screenshot](img/FM_8.png)

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

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

![Screenshot](img/FM_11.png)

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

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

![Screenshot](img/FM_12.png)

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

Действие проверяет существование указанной папки и записывает результат в переменную.

«True» - если существует, и иначе «False».

![Screenshot](img/FM_17.png)

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

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

![Screenshot](img/FM_17_1.png)

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

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

![Screenshot](img/FM_9.png)

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

Действие распаковывает ZIP-архив в указанную папку.

![Screenshot](img/FM_10.png)