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

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):

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

Last updated