История страницы
Name | Description | Type | Mandatory field | |
|---|---|---|---|---|
Parameters | Context | Context for working with a tabular document via ONLYOFFICE. | Robin.OnlyOfficeCell | Yes |
| Macro Path | Path to the js file that contains the JS code for the macro Acceptable file extension |
Запустить внешний макрос Редактор таблиц Версия 1 (Python)
Группа действий: ONLYOFFICE
Описание
Действие запускает в документе макрос, JS-код которого указан в отдельном файле.
Для работы с действием должно быть установлено приложение ONLYOFFICE.
Действие запускает макрос, указанный в отдельно файле формата .js. Язык, на котором написан макрос, должен быть JavaScript.
Примеры макросов - https://api.onlyoffice.com/plugin/macrosamples/
Более подробно ознакомиться с работой приложения ONLYOFFICE Редактор таблиц можно в Руководстве пользователя https://helpcenter.ONLYOFFICE.com/ru/userguides/docs-se.aspx
Иконка
Настройка параметров и их настройка
Название | Название | Описание | Тип данных | Обязательное | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Контекст | Контекст для работы с табличным документом через ONLYOFFICE. | Robin.OnlyOfficeCell | Да | Путь к макросу | Путь к файлу в формате js, который содержит JS-код макроса Допустимое расширение файла: .js | Robin.FilePath | ДаYes | Параметры | Robin.Collection | Нет | Тип результата |
| Parameters | Values for macro input parameters. Parameter values should be specified in the collection in the same order in which these parameters are listed in the macro code
| Robin.Collection | No | ||||||||
| Result type | The type of data that the macro should return as a result of its operation. If the macro does not return a result, this field can be left blank
Тип данных, которые должен вернуть макрос в результате своей работы. Если макрос не возвращает результат, то это поле можно не заполнять
| Robin.String | НетNo | ||||||||
Выходные параметрыResults | Результат | Result | The value returned by the running macro. If the macro returns nothing, the result will be emptyЗначение, возвращаемое запущенным макросом. Если макрос ничего не возвращает, результат будет пустым | Robin.Object |
Особые условия
- При запуске действий ONLYOFFICE документ должен быть закрыт.
...
4. Реализация полного цикла работы с таблицей должна содержать все 4 действия Редактора таблиц - "Открыть файл" -для начала работ с файлом, "Запустить внешний макрос." - для внесения изменений, "Сохранить файл" -для сохранения изменений и "Закрыть файл" по окончании работ с файлом.
Пример использования
Вариант1
Задача
Существует табличный документ: "Книга 1.xlsx". Необходимо открыть данный документ в ONLYOFFICE и внести изменения с помощью внешнего макроса
Решение
При запуске действий ONLYOFFICE документ должен быть закрыт.
...
Поэтому пример реализации будет содержать все 4 действия. Красная точка является точкой останова, т.е. на том действии, на которое мы ее поставим, робот перейдет в режим остановка. Для продолжения будет необходимо нажать кнопку "Старт".
Реализация
1.Открыть группу действий "ONLYOFFICE".
...
7. Нажать кнопку "Старт"..
Результат
Робот отработал успешно.
Вариант 2
Задача
Существует табличный документ: "Книга 1.xlsx". Необходимо открыть данный документ в ONLYOFFICE и внести изменения с помощью внешнего макроса без параметров
Решение
При запуске действий ONLYOFFICE документ должен быть закрыт.
...
Поэтому пример реализации будет содержать все 4 действия. Красная точка является точкой останова, т.е. на том действии, на которое мы ее поставим, робот перейдет в режим остановка. Для продолжения будет необходимо нажать кнопку "Старт".
Реализация
1.Открыть группу действий "ONLYOFFICE".
...
- в параметре "Путь к макросу" указать путь к папке, где размещен макрос
- в параметре "Тип результата", в выпадающем списке галочкой отметить выбранный тип
6. Для того, чтобы закрыть файл с изменениями, нужно последовательно воспользоваться действиями "Сохранить" и "Закрыть".
...
7. Нажать кнопку "Старт"..
Результат
Робот отработал успешно.
...
Обзор
Инструменты контента