Запустить внешний макрос / Run external macro
Группа действий: Word
Описание
Действие запускает в Word-документе макрос, VBA-код которого указан в отдельном текстовом файле.
Параметры
Входные параметры
Контекст Экземпляр Word-документа, в котором будет запущен внешний макрос.
Путь к макросу Путь к текстовому файлу макроса, который содержит VBA-код.
Имя процедуры Имя вызываемой функции или подпрограммы, которая указана в VBA-коде макроса.
Входной параметр Значения входных параметров вызываемой функции или подпрограммы в коде макроса. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.
Выходные параметры
Результат Значение, возвращаемое запущенным макросом. Если указанный макрос ничего не возвращает, результат работы действия будет пустым.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Экземпляр Word-документа, в котором будет запущен внешний макрос. | Robin.Word | Да | |
Путь к макросу | Путь к текстовому файлу макроса, который содержит VBA-код. | Путь к файлу | Да | |
Имя процедуры | Имя вызываемой функции или подпрограммы, которая указана в VBA-коде макроса. | Строка | Да | |
Входной параметр | Значения входных параметров вызываемой функции или подпрограммы в коде макроса. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции. | Коллекция | Нет | |
Результаты | ||||
Результат | Значение, возвращаемое запущенным макросом. Если указанный макрос ничего не возвращает, результат работы действия будет пустым. | Коллекция |
Особые условия использования
- В параметрах безопасности должен быть выбран чек-бокс “Доверять доступ к объектной модели проектов VBA“.
2. Если необходимо указать несколько параметров, пользователь должен указать в поле «Параметры» коллекцию, содержащую эти параметры.
3. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.
4. Русский язык не поддерживается в названии макроса (функции).
Пример использования
Задача: вставить диаграмму в Word с помощью макроса https://www.businessstudio.ru/wiki/docs/v4/doku.php/ru/creating_user_reports/use_macros_in_reports/examples/chart_insert .
Данный макрос содержится в текстовом файле.
Решение: воспользоваться действиями "Открыть", "Запустить внешний макрос"
Реализация:
- Собрать схему робота, состоящую из действий:
Результат:
Пример использования
Задача: Есть Word - документ. Нужно запустить в этом документе внешний макрос.
Решение: Для реализации действия нужны следующие действия - «Открыть», «Запустить внешний макрос».
Реализация:
- Настроить параметры для действия «Открыть».
2. Настроить параметры для действия «Запустить внешний макрос».
3. Нажать на кнопку «Старт» в верхней панели.
Результат:
Действие запускает в Word-файле макрос, VBA-код которого указан в отдельном текстовом файле.