Запустить макрос
Элемент выполняет макрос Excel. Поддерживает работу только с драйвером Interop. Драйвер указывается в контейнере Приложение Excel.
Макросы — команды, записанные на языке VBA (Visual Basic for Applications). Они используются для автоматизации часто повторяющихся действий в Excel.
Перед выполнением элемента убедитесь, что в Excel включены макросы . В конце работы рекомендуем использовать элемент Сохранить документ, чтобы все изменения применились.
Свойства
Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.
| Свойство | Тип | Описание |
|---|---|---|
| Excel: | ||
| Наименование* | String | Имя макроса, указывается без названия файла |
| Аргументы* | List<object> | Входные значения макроса в случае, если он представляет собой пользовательскую функцию. Можно передавать до 10 аргументов |
| Видимость* | Boolean | Видимость Excel. По умолчанию чекбокс отключен — приложение Excel не отображается на экране |
| Асинхронный | Boolean | Определяет, нужно ли выполнять макрос асинхронно — в этом случае робот не будет дожидаться конца выполнения макроса и перейдет к следующему элементу. По умолчанию чекбокс отключен, макрос выполняется синхронно |
| Тайм-аут | int | Предельное время ожидания выполнения макроса (мс). По умолчанию время не задано |
| Вывод: | ||
| Переменная | Object | Название переменной, в которую запишется результат выполнения макроса |
Пример использования
RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning .
- Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
- Распакуйте архив и откройте в Студии проект WorkWithExcelExample.
- Элемент Запустить макрос находится в процессе
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);