История страницы
...
Run external macro Version 1 (Net)
Группа действийAction group: Word
Описание
Действие запускает в Word-документе макрос, VBA-код которого указан в отдельном текстовом файле.
Более подробно по работе с макросами можно посмотреть тут:
Иконка действия
Параметры
Входные параметры
Контекст Экземпляр Word-документа, в котором будет запущен внешний макрос.
Путь к макросу Путь к текстовому файлу макроса, который содержит VBA-код.
Имя процедуры Имя вызываемой функции или подпрограммы, которая указана в VBA-коде макроса.
Входной параметр Значения входных параметров вызываемой функции или подпрограммы в коде макроса. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.
Выходные параметры
Результат Значение, возвращаемое запущенным макросом. Если указанный макрос ничего не возвращает, результат работы действия будет пустым.
Настройки
...
Свойство
...
Описание
...
Тип
...
Пример заполнения
...
Обязательность заполнения поля
...
Параметры
...
Контекст
...
Экземпляр Word-документа, в котором будет запущен внешний макрос.
...
Robin.Word
...
Да
...
Путь к макросу
...
Путь к текстовому файлу макроса, который содержит VBA-код.
...
Путь к файлу
...
Да
...
Description
The action runs a macro in a Word-document whose VBA code is specified in a separate text file.
Find more about working with macro here:
Action icon
Settings of parameters
| Parameter | Description |
|---|---|
| Context | Word-document instance where the external macro will be run. |
| Macro path | Path to the text file of the macro with the VBA code. |
| Procedure name | The name of the called function or subprogram that is specified in the VBA code of the macro. |
| Input parameter | Values of input parameters of the called function or subprogram in the macro code. The values of parameters must be specified in the same order in which these parameters are specified in the called function. |
Output parameters
Result - the value returned by the running macro. If the specified macro returns nothing, the result of the action will be empty.
Settings of parameters
| Property | Description | Type | Filling example | Mandatory field |
| Parameters | ||||
| Context | Instance of a Word document. | Robin.Word | Word context | Yes |
| Macro Path | Path to a macro text file that contains VBA code. | Robin.FilePath | Yes | |
| Procedure name | The name of the function or subroutine to call that is specified in the macro’s VBA code. | Robin.String | Yes | |
| Input parameter | Values of input parameters of the called function or subroutine. Parameters must be specified in the same order in which these parameters are specified in the called function. | Robin.Collection | No | |
| Results | ||||
| Result | The value returned by the running macro. If the specified macro does not return anything, the result of the action will be empty. | Robin.Collection | ||
Special conditions of use
- The "Trust access to the object model of VBA projects" checkbox must be checked in the security settings.
- If multiple parameters are to be specified, the user must specify a collection containing these parameters in the "Parameters" field.
- Parameter values must be specified in the same order in which these parameters are specified in the called function.
- Russian language is not supported in the macro (function) name.
Example of use
Task
There is a Word-document.
Run an external macro ReplaceEwithYo.bas in this document:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
Sub ReplaceEwithYo()
Selection.Find.ClearFormatting
Selection.Find.Replacement.ClearFormatting
With Selection.Find
.Text = "Е"
.Replacement.Text = "Ё"
.Forward = True
.Wrap = wdFindAsk
.Format = False
.MatchCase = False
.MatchWholeWord = False
.MatchWildcards = False
.MatchSoundsLike = False
.MatchAllWordForms = False
End With
Selection.Find.Execute Replace:=wdReplaceAll
End Sub |
Solution
Use the "Open document", "Run external macro", "Save as" actions.
Implementation
- Assemble a robot scheme with the actions.
- Set the "Open document" action parameters.
- Set the "Run external macro" action parameters.
- Set the "Save as" action parameters.
- Click "Start" in the top panel.
Result
The action runs an external macro in the Word-file, whose VBA code is specified in a separate text file.
...
Особые условия использования
- В параметрах безопасности должен быть выбран чек-бокс “Доверять доступ к объектной модели проектов VBA“.
- Если необходимо указать несколько параметров, пользователь должен указать в поле «Параметры» коллекцию, содержащую эти параметры.
- Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.
- Русский язык не поддерживается в названии макроса (функции).
Пример использования
Задача
Есть Word - документ. Нужно запустить в этом документе внешний макрос.
Решение
Для реализации действия нужны следующие действия - «Открыть», «Запустить внешний макрос».
Реализация
...
Результат
Действие запускает в Word-файле внешний макрос, VBA-код которого указан в отдельном текстовом файле.
Обзор
Инструменты контента