История страницы

...

Группа действий: ONLYOFFICE

...

Описание

Действие возвращает контекст для работы с табличным документом ONLYOFFICEзапускает в документе макрос, JS-код которого указан в отдельном файле.

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

Действие открывает документ в видимом режиме.

Если робот открывает несколько документов, то они будут открыты тем способом, который указан в настройках приложения. Открывать:

вкладки одного приложения
отдельные экземпляры приложения

Если документ в формате ods запаролен, то

действие не сможет обработать его, нужно получить контекст для дальнейшей обработки документа и ввода пароля с помощью других действий
действие не завершится с ошибкой

запускает макрос, указанный в отдельно файле формата .js. Язык, на котором написан макрос, должен быть JavaScript.

Примеры макросов - https://api.onlyoffice.com/plugin/macrosamples/4. Автоматическое закрытие документа не предусмотрено. Для закрытия документа необходимо использовать действие «Закрыть» группы "ONLYOFFICE", подгруппы "Редактор таблиц".

Более подробно ознакомиться с работой приложения ONLYOFFICE Редактор таблиц можно в Руководстве пользователя https://helpcenter.ONLYOFFICE.com/ru/userguides/docs-se.aspx

Иконка

Image RemovedImage Added

Настройка параметров и их настройка

Название

Обязательное

Название

Описание

Тип данных

Обязательное

Входные параметры

Контекст

Контекст для работы с табличным документом через ONLYOFFICE.

Robin.OnlyOfficeCell

Да

Путь к макросу

Путь к файлу в формате js, который содержит JS-код макроса

Допустимое расширение файла: .js

Robin.FilePath

Да

Путь к файлу, который необходимо открыть. Поддерживаемые форматы: xlsx, xls, ods.

Robin.FilePath


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

Выходные параметры

КонтекстКонтекст для работы с табличным документом через ONLYOFFICE.Robin.OnlyofficeCell

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

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

...

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

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

Вариант1

Задача

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

Решение

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

Для того, чтобы открыть документ необходимо :

Установить на рабочую область действие "Открыть" ONLYOFFICE
Корректно заполнить параметр "Путь к файлу" - указать файл с доступным расширением.
Запустить робота

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

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

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

...

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

Вариант 1

Задача- открыть файл в ONLYOFFICE

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

Image Removed

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

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

Результат

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

Image Removed

Действие открыло файл с таблицей и вернуло контекст для работы с табличными действиями ONLYOFFICE.

Вариант 2

Задача- открыть файл в ONLYOFFICE и закрыть, не вносив в него изменения

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

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

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

Image Added

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

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

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

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

Image Added

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

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

Image Added

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

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

Результат

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

Image Removed

Действие открыло и закрыло файл с таблицей.