engЗапустить внешний макрос Редактор таблиц

Запустить внешний макрос Редактор таблиц Версия 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	Да
	Параметры	Значения для входных параметров макроса. Значения параметров нужно указывать в коллекции в том же порядке, в котором эти параметры перечислены в коде макроса Поле не нужно заполнять, если в макросе нет входных параметров Поле нужно обязательно заполнить, если в макросе есть входные параметры В коллекции должно быть ровно столько элементов, сколько входных параметров в макросе. Элементы, содержащие значения параметров, должны быть указаны в том же порядке, в котором соотв. параметры перечислены в коде макроса.	Robin.Collection	Нет
	Тип результата	Тип данных, которые должен вернуть макрос в результате своей работы. Если макрос не возвращает результат, то это поле можно не заполнять Т.к. типы в Onlyoffice не совпадают с нашими типами, для корректной конвертации результата макроса нужно уточнять, какой тип данных мы ожидаем получить Поле в виде выпадающего списка Доступные значения списка: Строка Число Коллекция Таблица Макрос без результата Значения списка на англ.: String Number Collection Table Macro with no result Значение по умолчанию- "Макрос без результата" Если результат макроса - коллекция или таблица, то действие вернет их как коллекцию строк или таблицу со строковыми значениями, соответственно Действие не завершится с ошибкой, если выбрано "Макрос без результата", а действие возвращает результат.	Robin.String	Нет
Выходные параметры	Результат	Значение, возвращаемое запущенным макросом. Если макрос ничего не возвращает, результат будет пустым	Robin.Object

Особые условия

При запуске действий ONLYOFFICE документ должен быть закрыт.

2. Расширения файлов, которые может открыть действие: .xlsx, .xls, ods.

3. Для корректного запуска действий при работе с ОС Windows необходимо добавить engПлагин ONLYOFFICE.

4. Реализация полного цикла работы с таблицей должна содержать все 4 действия Редактора таблиц - "Открыть файл" -для начала работ с файлом, "Запустить внешний макрос." - для внесения изменений, "Сохранить файл" -для сохранения изменений и "Закрыть файл" по окончании работ с файлом.

Пример использования

Вариант1

Задача

Существует табличный документ: "Книга 1.xlsx". Необходимо открыть данный документ в ONLYOFFICE и внести изменения с помощью внешнего макроса

Решение

При запуске действий ONLYOFFICE документ должен быть закрыт.

Для того, чтобы открыть документ необходимо собрать и запустить робота, предварительно заполнив его параметры.

Если мы хотим внести изменения в открытый файл, то сначала необходимо запустить действие "Внешний макрос", внести изменения в файл и запустить действие engСохранить Редактор таблиц .

Поэтому пример реализации будет содержать все 4 действия. Красная точка является точкой останова, т.е. на том действии, на которое мы ее поставим, робот перейдет в режим остановка. Для продолжения будет необходимо нажать кнопку "Старт".

Реализация

1.Открыть группу действий "ONLYOFFICE".

2. Для реализации робота собрать следующую схему робота:

3. Переместить на рабочую область студии действие "Открыть", предварительно разместив файл для загрузки в одной из папок на компьютере.

4. Заполнить параметры действия "Открыть Редактор таблиц", указав путь к файлу. Подробнее можно посмотреть тут: engОткрыть Редактор таблиц

5. Заполнить параметры действия "Запустить внешний макрос Редактор таблиц".

Для этого нужно:

a. Создать на компьютере папку, в которой будут размещены макросы и исходный файл.

b. Последовательно заполнить поля "Контекст" (1), "Путь к макросу" (2), "Параметры"(3), "Тип результата"(4).

- в параметре "Путь к макросу" указать путь к папке, где размещен макрос
- в параметре "Параметры" указать количество записей и прописать , при необходимости, их значение
- в параметре "Тип результата", в выпадающем списке галочкой отметить выбранный тип

6. Для того, чтобы закрыть файл с изменениями, нужно последовательно воспользоваться действиями "Сохранить" и "Закрыть".

7. Для этого на схеме необходимо кликнуть курсор на действие engСохранить Редактор таблиц , и заполнить поле "Параметры" для этого действия.

6. Заполнить параметры действия engЗакрыть Редактор таблиц

7. Нажать кнопку "Старт"..

Результат

Робот отработал успешно.