Запустить макрос

Run macro

Элемент выполняет макрос Excel. Поддерживает работу только с драйвером Interop. Драйвер указывается в контейнере Приложение Excel.

Макросы — команды, записанные на языке VBA (Visual Basic for Applications). Они используются для автоматизации часто повторяющихся действий в Excel.

Перед выполнением элемента убедитесь, что в Excel включены макросы. В конце работы рекомендуем использовать элемент Сохранить документ, чтобы все изменения применились.

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

Свойство	Тип	Описание
Excel:
Наименование*	String	Имя макроса, указывается без названия файла
Аргументы*	List<object>	Входные значения макроса в случае, если он представляет собой пользовательскую функцию. Можно передавать до 10 аргументов
Видимость*	Boolean	Видимость Excel. По умолчанию чекбокс отключен — приложение Excel не отображается на экране
Асинхронный	Boolean	Определяет, нужно ли выполнять макрос асинхронно — в этом случае робот не будет дожидаться конца выполнения макроса и перейдет к следующему элементу. По умолчанию чекбокс отключен, макрос выполняется синхронно
Тайм-аут	int	Предельное время ожидания выполнения макроса (мс). По умолчанию время не задано
Вывод:
Переменная	Object	Название переменной, в которую запишется результат выполнения макроса

Пример использования

RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning.

1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.

2. Распакуйте архив и откройте в Студии проект WorkWithExcelExample.

3. Элемент Запустить макрос находится в процессе Main, в контейнере Приложение Excel Interop.

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

C#

LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX);
app.RunMacro("macro", null, true);

Python

app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX)
app.RunMacro("macro", null, true)

JavaScript

var app = _lib.LTools.Office.ExcelApp.Init(wf, "file", ";", _lib.LTools.Office.Model.InteropTypes.DX);
app.RunMacro("macro", null, true);