добавлен модуль работа с файлами

2020-05-20 17:51:18 +05:00
parent b6de0f2eb4
commit 9c72dead0b
47 changed files with 104 additions and 7 deletions
@@ -0,0 +1,9 @@
+# <H1 align="center">Модуль "Закрыть Excel-файл"</h1> 
+
+<p> Excel-модуль работает с файлами следующим образом – как только он начинает работу с некоторым файлом, то он открывает его (в фоновом, незаметном для пользователя, режиме), и держит открытым до конца работы робота. Это было сделано для ускорения работы модуля Excel – если модулей, использующих один и тот же файл, к примеру, несколько, пришлось бы несколько раз открывать и сохранять файл столько раз, сколько он используется что отразилось бы на быстродействии программы. В связи с этим, файл открывается при первом его использовании в модуле Excel и сохраняется только один раз – в самом конце. Но! Так как файл является открытым, с самим файлом нельзя ничего делать – переносить, архивировать, удалять за ненадобностью (например, провели расчеты в новом файле, взяли данные и затем его удалили), так как он занят. Для таких задач существует модуль «Закрыть Excel-файл» - он закрывает и сохраняет заданные ему файлы. Если эти файлы впоследствии снова будут использоваться – они опять откроются и, в следующий раз, будут закрыты либо этим же модулем, либо в конце работы робота.</p>
+## Интерфейс модуля
+<p> Интерфейс модуля состоит из одного поля и списка путей к файлам, которые необходимо закрыть.</p>
+<H1 align="center">![Screenshot](img/excel_61.png)</h1>
+<p> Поле «Путь к файлу» заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его вручную, нажав на кнопку с изображением папки, находящуюся в поле для ввода.</p> 
+<p> По кнопке «Добавить» указанный в поле «Путь к файлу» путь будет занесен в «Список файлов». </p>
+<p> По кнопке «Удалить» можно удалить выбранный путь из «Списка файлов».</p>
@@ -0,0 +1,66 @@
+# <H1 align="center">Модуль «Работа с файлами»</h1> 
+
+<p> Модуль «Работа с файлами» предназначен для изменения расположения файлов, их копирования, архивирования, создания папки и переноса файлов в неё, в общем, для манипуляции с файлами и директориями.</p>
+
+## Интерфейс модуля
+<p> Окно модуля объединяет три группы элементов.
+<p> Первая группа элементов – это набор полей и кнопок для создания команды. Вторая – непосредственно список команд. И третья – это область предварительного просмотра текстовых файлов.
+<H1 align="center">![Screenshot](img/FM_1.png)</h1> 
+## Функциональность модуля
+### Создание команды
+<p> Команда создается следующим образом – выбирается необходимое действие, заполняются остальные поля – нажимается кнопка «Добавить», по которой команда добавляется в «Список команд».  
+### Редактирование команды
+<p> Для того чтобы отредактировать команду, выделите её в списке команд щелчком левой кнопкой мыши, после чего все поля в левой верхней части окна «Работа с файлами» заполнятся в соответствии с выбранной командой. Измените те поля, которые требуется отредактировать, и, убедившись, что в списке команд все еще выбрано нужное действие, нажмите на кнопку «Редактировать».
+### Удаление команды
+<p> Для удаления команды необходимо выбрать её в списке команд и нажать на кнопку «Удалить».
+### Отключение/включение команды
+<p> Созданные команды можно отключать и обратно включать. Отключенные команды не будут выполняться. Сделать это можно, нажав на соответствующую отключаемой команде строку правой кнопкой мыши и выбрав «Отключить/включить».
+<H1 align="center">![Screenshot](img/FM_2.png)</h1>
+### Выбор файла/папки
+<p> Кнопка ![Screenshot](img/FM_3.png) в заполняемых полях открывает стандартный диалог выбора файла или папки, в зависимости от выбранного действия. 
+## Перечень и описание действий
+### Действие «Сохранить в файл»
+<p> Действие перезаписывает существующий текстовый файл, записывая в него строку, указанную в поле «Значение».
+<H1 align="center">![Screenshot](img/FM_4.png)</h1>
+### Действие «Считать файл»
+<p> Действие считывает весь текст из выбранного файла и записывает его в указанную переменную.
+<H1 align="center">![Screenshot](img/FM_5.png)</h1>
+### Действие «Получить список файлов в папке»
+<p> Действие создает переменную-список, в которой лежат пути до каждого файла в папке. 
+<H1 align="center">![Screenshot](img/FM_6.png)</h1>
+### Действие «Переместить файл»
+<p> Действие перемещает выбранный файл в указанную папку.
+<H1 align="center">![Screenshot](img/FM_7.png)</h1>
+### Действие «Переместить папку»
+<p> Действие перемещает папку, указанную во втором поле, в директорию, указанную в третьем поле.
+<H1 align="center">![Screenshot](img/FM_8.png)</h1>
+### Действие «Заархивировать папку»
+<p> Действие создает ZIP-архив с указанным именем, добавляя в него содержимое выбранной папки.
+<H1 align="center">![Screenshot](img/FM_9.png)</h1>
+### Действие «Распаковать архив»
+<p> Действие распаковывает ZIP-архив в указанную папку.
+<H1 align="center">![Screenshot](img/FM_10.png)</h1>
+### Действие «Создать папку»
+<p> Действие создает папку с указанным названием в выбранной директории.
+<H1 align="center">![Screenshot](img/FM_11.png)</h1>
+### Действие «Удалить папку»
+<p> Действие удаляет выбранную папку.
+<H1 align="center">![Screenshot](img/FM_12.png)</h1>
+### Действие «Создать файл txt»
+<p> Действие создает новый файл с расширением .txt.
+<H1 align="center">![Screenshot](img/FM_13.png)</h1>
+### Действие «Удалить файл»
+<p> Действие удаляет выбранный файл.
+<H1 align="center">![Screenshot](img/FM_14.png)</h1>
+### Действие «Скопировать файл»
+<p> Действие копирует выбранный файл в указанную директорию. 
+<p> В поле «Путь до конечного файла» необходимо ввести путь до папки, в которую файл должен скопироваться, и его название с расширением так, как будто файл уже есть. Новое название может отличаться от исходного.
+<H1 align="center">![Screenshot](img/FM_15.png)</h1>
+### Действие «Проверить существование файла»
+<p> Действие проверяет существование указанного файла и записывает результат в переменную.
+<p> «True» - если существует, и иначе «False».
+<H1 align="center">![Screenshot](img/FM_16.png)</h1>
+### Действие «Проверить существование папки»
+<p> Действие проверяет существование указанной папки и записывает результат в переменную.
+<p> «True» - если существует, и иначе «False».
+<H1 align="center">![Screenshot](img/FM_17.png)</h1>
@@ -203,10 +203,4 @@
 #### Действие «Границы»
 <p> Действие добавляет или изменяет границы выбранных ячеек на указанном листе. Предполагает настройку расположения границ – внешние, внутренние, только правая и др., цвет границ и их стиль – толстая, тонкая, штриховая линия и др.
 <H1 align="center">![Screenshot](img/excel_60.png)</h1>
-## Модуль «Закрыть Excel-файл»
-<p> Excel-модуль работает с файлами следующим образом – как только он начинает работу с некоторым файлом, то он открывает его (в фоновом, незаметном для пользователя, режиме), и держит открытым до конца работы робота. Это было сделано для ускорения работы модуля Excel – если модулей, использующих один и тот же файл, к примеру, несколько, пришлось бы несколько раз открывать и сохранять файл столько раз, сколько он используется что отразилось бы на быстродействии программы. В связи с этим, файл открывается при первом его использовании в модуле Excel и сохраняется только один раз – в самом конце. Но! Так как файл является открытым, с самим файлом нельзя ничего делать – переносить, архивировать, удалять за ненадобностью (например, провели расчеты в новом файле, взяли данные и затем его удалили), так как он занят. Для таких задач существует модуль «Закрыть Excel-файл» - он закрывает и сохраняет заданные ему файлы. Если эти файлы впоследствии снова будут использоваться – они опять откроются и, в следующий раз, будут закрыты либо этим же модулем, либо в конце работы робота.
-<p> Интерфейс модуля состоит из одного поля и списка путей к файлам, которые необходимо закрыть.
-<H1 align="center">![Screenshot](img/excel_61.png)</h1>
-<p> Поле «Путь к файлу» заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его вручную, нажав на кнопку с изображением папки, находящуюся в поле для ввода. 
-<p> По кнопке «Добавить» указанный в поле «Путь к файлу» путь будет занесен в «Список файлов». 
-<p> По кнопке «Удалить» можно удалить выбранный путь из «Списка файлов».
+
@@ -6,6 +6,34 @@ nav:
        - 'Кликер': 'clicker.md'
        - 'Поиск изображения': 'ImageSearch.md'
        - 'Поиск изображений': 'ImagesSearch.md'
+        - 'Запустить процесс': 'StartProcess.md'
+        - 'Завершить процесс': 'EndProcess.md'
+        - 'Условие': 'Condition.md'
+        - 'Цикл': 'Cycle.md'
+        - 'Вычисления': 'Calculation.md'
+        - 'Работа с файлами': 'FileModule.md'
+        - 'Код С#': 'CCode.md'
+        - 'Распознавание текста': 'OCR.md'
+        - 'Распознавание текста ABBYY': 'FROCR.md'
+        - 'Работа с браузером': 'WorkBrowser.md'
+        - 'Обработка текста': 'TextAnalysis.md'
+        - 'SQL': 'SQL.md'
+        - '1C': '1C.md'
+        - 'Отправить письмо': 'SendEmail.md'
+        - 'Считать письма': 'ReadEmail.md'
+        - 'HTTP GET запрос': 'HTTPGET.md'
+        - 'HTTP POST запрос': 'HTTPPOST.md'
+        - 'Break': 'Break.md'
+        - 'JSON': 'JSON.md'
+        - 'Интерфейс': 'Iterface.md'
+        - 'Закрыть Excel-файл': 'CloseExcel.md'
+        - 'WHILE': 'WHILE.md'
+        - 'Пауза': 'Pause.md'
+        - 'Робот': 'Robot.md'
+        - 'Return': 'Return.md'
+        - 'Word': 'Word.md'
+        - 'Прокси': 'Proxy.md'
+        - 'Try/Catch': 'TryCatch.md'
  
    - About: about.md
 theme: readthedocs