История страницы
...
Группа действий: 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
Иконка
Настройка параметров и их настройка
Название |
---|
Название | Описание | Тип данных | Обязательное | |
---|---|---|---|---|
Входные параметры | Контекст | Контекст для работы с табличным документом через ONLYOFFICE. | Robin.OnlyOfficeCell | Да |
Путь к макросу | Путь к файлу в формате js, который содержит JS-код макроса Допустимое расширение файла: .js | Robin.FilePath | Да |
Путь к файлу, который необходимо открыть. Поддерживаемые форматы: xlsx, xls, ods.
Параметры | Значения для входных параметров макроса. Значения параметров нужно указывать в коллекции в том же порядке, в котором эти параметры перечислены в коде макроса
| Robin.Collection | Нет |
Тип результата | Тип данных, которые должен вернуть макрос в результате своей работы. Если макрос не возвращает результат, то это поле можно не заполнять
| Robin.String | Нет |
Выходные параметры | Результат | Значение, возвращаемое запущенным макросом. Если макрос ничего не возвращает, результат будет пустым | Robin.Object |
---|
Выходные параметры
Особые условия
- При запуске действий ONLYOFFICE документ должен быть закрыт.
...
4. Реализация полного цикла работы с таблицей должна содержать все 4 действия Редактора таблиц - "Открыть файл" -для начала работ с файлом, "Запустить внешний макрос." - для внесения изменений, "Сохранить файл" -для сохранения изменений и "Закрыть файл" по окончании работ с файлом.,
5. Следует отметить, что если запустить действие "Открыть" и просто посмотреть документ, не внося в него никаких изменений, то документ сам автоматически не закроется и останется открытым. Для того, чтобы закрыть документ, необходимо обязательно запустить действие "Закрыть".
Пример использования
Задача
Существует табличный документ: "Книга 1.xlsx". Необходимо открыть данный документ в ONLYOFFICE .и внести изменения с помощью внешнего макроса
Решение
При запуске действий ONLYOFFICE документ должен быть закрыт.
...
- Установить на рабочую область действие "Открыть" ONLYOFFICE
- Корректно заполнить параметр "Путь к файлу" - указать файл с доступным расширением.
Для того, чтобы открыть документ необходимо:
- Запустить робота
Следует отметить, что если запустить действие "Открыть" и просто посмотреть документ, не внося в него никаких изменений, то документ сам автоматически не закроется и останется открытым. Для того, чтобы закрыть документ "как есть", необходимо запустить действие "Закрыть". Более подробно можно посмотреть тут: Закрыть ONLYOFFICE
...
Вариант 1
Задача- открыть файл в ONLYOFFICE в ONLYOFFICE , внести в него изменения с помощью внешнего макроса и закрыть
Переместить на рабочую область студии действие "Открыть", предварительно разместив файл для загрузки в одной из папок на компьютере.
4. Заполнить параметры действия "Открыть", указав путь к файлу.
...
Действие открыло файл с таблицей и вернуло контекст для работы с табличными действиями ONLYOFFICE.
Вариант 2
Задача- открыть файл в ONLYOFFICE и закрыть, не вносив в него изменения
1.Для реализации робота собрать следующую схему робота:
2.Переместить на рабочую область студии действия "Открыть" и "Закрыть", предварительно разместив файл для загрузки в одной из папок на компьютере.
3. Заполнить параметры действия "Открыть", указав путь к файлу.
4. Для того, чтобы закрыть файл без изменений, нужно воспользоваться действием "Закрыть".
5. Для этого на схеме необходимо кликнуть курсор на действие "Закрыть" , и заполнить поле "Параметры" для этого действия. Подробнее можно посмотреть тут:
6. Заполнить параметры действия "Закрыть". Подробнее можно посмотреть тут;
7. Нажать кнопку "Старт"..
Результат
Робот отработал успешно.
Действие открыло и закрыло файл с таблицей.
Вариант 2
Задача- открыть файл в ONLYOFFICE и закрыть, не вносив в него изменения
1.Для реализации робота собрать следующую схему робота:
2.Переместить на рабочую область студии действия "Открыть" и "Закрыть", предварительно разместив файл для загрузки в одной из папок на компьютере.
3. Заполнить параметры действия "Открыть", указав путь к файлу.
4. Для того, чтобы закрыть файл без изменений, нужно воспользоваться действием "Закрыть".
5. Для этого на схеме необходимо кликнуть курсор на действие "Закрыть" , и заполнить поле "Параметры" для этого действия. Подробнее можно посмотреть тут:
6. Заполнить параметры действия "Закрыть". Подробнее можно посмотреть тут;
7. Нажать кнопку "Старт".
Результат
Робот отработал успешно.
Действие открыло и закрыло файл.
Вариант 3
Задача- открыть файл в ONLYOFFICE , внести в него изменения и закрыть
1.Для реализации робота собрать следующую схему робота:
2.Переместить на рабочую область студии действия "Открыть" и "Закрыть", предварительно разместив файл для загрузки в одной из папок на компьютере.
3. Заполнить параметры действия "Открыть", указав путь к файлу.
4. Для того, чтобы закрыть файл без изменений, нужно воспользоваться действием "Закрыть".
5. Для этого на схеме необходимо кликнуть курсор на действие "Закрыть" , и заполнить поле "Параметры" для этого действия. Подробнее можно посмотреть тут:
6. Заполнить параметры действия "Закрыть". Подробнее можно посмотреть тут;
...
...
Результат
Робот отработал успешно.
...