Create Enrollment Order

Рассмотрим пример робота, который предназначен для автоматического формирования и распечатки приказов на зачисление студентов. Входными данными служит реестр студентов (слушателей обучающей программы). Процесс часто используется в учебных заведениях и кадровых агентствах.

Проект робота состоит из двух диаграмм и трех файлов, один из которых в формате xlsx, а остальные – в формате docx.

Если описывать пошагово, то данный робот работает следующим образом:

1. Загружает таблицу данных из файла "П1_Обучение_шаблон.xlsx".

2. Перебирает ячейки с номером приказа.

3. Переходит к сценарию из диаграммы “CreateEnrollmentOrder_ProcessCreateWord”, которая вносит данные получает дату и время, преобразовывает их в текст, а затем вносит данные в "П1_Шаблон приказа о зачислении.docx", отправляет его на печать.

4. Заполняет “Шаблон приказа о зачислении.docx", сохраняет и печатает его.

Основная диаграмма проекта

Основная диаграмма проекта выглядит так (для удобства блоки диаграммы пронумерованы):

1. Блок “Старт” (с этого блока начинается любая диаграмма).

2. Блок “Загрузить Таблицу Данных” позволяет загрузить “Таблицу Данных” из Excel-документа. Для данного блока указаны следующие свойства:

• Путь к файлу (путь к Excel-документу, из которого необходимо загрузить информацию в Таблицу Данных);

• Заголовок (при установленном флаге первая строка будет использована в качестве заголовка);

• Лист (порядковый номер листа, данные из которого необходимо прочитать в Таблицу Данных).

1. Блок “Цикл для каждого (Таблица Данных)” циклично перебирает все строки таблицы данных.

1. Блок “Процесс” позволяет создавать сценарии, состоящие из нескольких диаграмм. Выполнение сценария продолжится с блока “Старт” указанной диаграммы проекта. Выполнение сценария вернется к текущему блоку и продолжится в текущей диаграмме, как только будет достигнут блок “Конец” во внешней диаграмме. Для блока “Процесс” указано свойство “Имя диаграммы” (имя файла диаграммы, в которой продолжится выполнение сценария).

1. Блок “Условие” проверяет указанное условие на истинность, после чего выполнение сценария продолжается в сторону выхода “Да” (если условие выполняется) или в сторону выхода “Нет” (если условие не выполнилось).

Условие записывается в формате: “переменная” равна (==)/ больше (>)/ меньше (<) “значение”.

Например: $a == “Привет”, то есть, если значение переменной $a равно “Привет”, то выход “Да”, в противном случае – выход “Нет”.

$Result > 5, то есть, если значение переменной $Result меньше 5, то выход “Да”, в противном случае – выход “Нет”.

В данном случае, в качестве условия установлено: -Not [string]::IsNullOrEmpty($Row[0]). Т. е., проверяет, что значение нулевой ячейки в этой строке не пустое.

1. Блок “Присвоить значение переменной” устанавливает новые значения для одной или нескольких переменных. В данном случае, в свойствах указано три значения, которые необходимо присвоить трем переменным, соответственно.

1. Блок “Присвоить значение переменной” устанавливает новые значения для одной или нескольких переменных. В данном случае, в свойствах указано одно значение, которое необходимо присвоить конкретной переменной.

1. Блок “Выполнить выражение PowerShell” запускает выполнение одного или нескольких выражений на языке, совместимом с PowerShell. В данном случае используется одно выражение: $ListFIO.Add($fio). Оно в список $ListFIO добавляет значение $fio.

1. Блок “Лог” позволяет выводить в лог произвольные сообщения и/или значения переменных в процессе работы сценария робота. Для данного блока указано свойство “Значение”. В кавычках указана текстовая константа, а имя переменной начинается с символа $. Т.е., данный блок записывает в лог робота сообщение об ошибке.

1. и 11. Блок “Конец” (этим блоком завершается работа сценария или возврат диаграммы подпроцесса в основной процесс).

Диаграмма “CreateEnrollmentOrder_ProcessCreateWord”

1. Блок “Старт” (с этого блока начинается любая диаграмма).

2. Блок “Цикл” позволяет повторить цепочку действий (блоков) несколько раз и при этом посчитать количество итераций цикла, записывая текущее количество в специальную переменную (указанную в свойстве “Цикл”), которую можно затем использовать в других блоках. При первом входе в блок значение переменной из свойства “Цикл” приравнивается к “Начальному значению” (в данном случае оно равно 0), а затем выполнение сценария продолжается в сторону выхода “Цикл” данного блока (в, так называемое, “тело цикла”). Как только выполнение сценария вновь дойдет до данного блока, значение переменной “Цикл” увеличится на значение “Шаг” (в данном случае, он равен 1), и вновь произойдет переход в сторону выхода «Цикл». Как только значение переменной “Цикл” станет больше или равно “Конечному значению” (в данном случае, оно задано переменной $ListFIO.Count), выполнение сценария продолжится в сторону нижнего выхода блока. Не забудьте соединить выход последнего блока в теле цикла со входом данного блока или какого-либо из предшествующих блоков.

1. Блок “Выполнить выражение PowerShell” запускает выполнение одного или нескольких выражений на языке, совместимом с PowerShell. В данном случае, используется одно выражение: $ListFIOString += ($Index+1).ToString() + ". " + $ListFIO[$Index] + [Environment]::NewLine. Оно добавляет к строке новую строку вида “1. Иванов Иван Иванович\r\n”.

1. Блок “Получить текущие дату и время” позволяет получить текущие дату и время в соответствии с настройками компьютера пользователя. Для данного блока указано одно свойство – “Результат” (возвращает текущие дату и время).

1. Блок “Преобразовать дату и время в текст” позволяет привести переменную типа “Дата и время” в формат текста. Для данного блока указаны следующие свойства:

• Значение (дата и время, которые необходимо конвертировать в текст);

• Формат (формат конвертирования даты и времени в текст).

1. Блок “Получить путь к файлу” получает полный путь к файлу с указанным именем. Для данного блока указано одно свойство “Имя файла” (имя файла вместе с его форматом).

1. Блок “Открыть документ” позволяет открыть Word-документ. Для данного блока указаны следующие свойства:

• Использовать COM (при установленном флаге работа будет производиться с помощью установленного Word);

• Путь к файлу (путь к Word-файлу, который требуется открыть).

1. Блок “Заменить все переменные в тексте” позволяет осуществить замену всех переменных %variable% в Word-документе. Для данного блока указаны следующие свойства:

• Ссылка на Word (ссылка на процесс обработки Word-документа. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на Word", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа);

• Ссылка на документ (ссылка на открытый Word-документ, в котором в данный момент происходит работа. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на документ", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа).

1. Блок “Получить путь к файлу” получает полный путь к файлу с указанным именем. Для данного блока указано одно свойство “Имя файла” (имя файла вместе с его форматом).

1. Блок “Сохранить документ” позволяет сохранить Word-документ. Для данного блока указаны следующие свойства:

• Ссылка на Word (ссылка на процесс обработки Word-документа, название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на Word", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа);

• Ссылка на документ (ссылка на документ, который необходимо сохранить. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на документ", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа);

• Путь к файлу (путь к Word-документу).

1. Блок “Распечатать документ” позволяет отправить на печать Word-документ. Для данного блока указаны следующие свойства:

• Ссылка на Word (ссылка на процесс обработки Word-документа. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на Word", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа);

• Ссылка на документ (ссылка на открытый Word-документ, в котором в данный момент происходит работа. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на документ", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа).

1. Блок “Закрыть документ” позволяет закрыть Word-документ. Для данного блока указаны следующие свойства:

• Ссылка на Word (ссылка на процесс обработки Word-документа. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на Word", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа);

• Ссылка на документ (ссылка на документ, который необходимо закрыть. Название переменной в данном свойстве должно совпадать с названием переменной в свойстве "Ссылка на документ", блоков "Создать документ" или "Открыть документ" из группы Word, которые ранее использовались для создания или открытия данного документа).

1. Блок “Лог” позволяет выводить в лог произвольные сообщения и/или значения переменных в процессе работы сценария робота. Для данного блока указано свойство “Значение”. В кавычках указана текстовая константа, а имя переменной начинается с символа $. Т.е., данный блок записывает в лог робота сообщение об ошибке.

1. и 15. Блок “Конец” (этим блоком завершается работа сценария или возврат диаграммы подпроцесса в основной процесс).