Сравнение версий

Старая версия 4

changes.mady.by.user lismaili@rpa-robin.ru

Сохранено

по сравнению с

Новая версия 5

changes.mady.by.user lismaili@rpa-robin.ru

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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


Название

Название 

Описание

Тип данныхОбязательное

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







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

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

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

Robin.FilePathДа
Параметры

Значения для входных параметров макроса. Значения параметров нужно указывать в коллекции в том же порядке, в котором эти параметры перечислены в коде макроса


  • Поле не нужно заполнять, если в макросе нет входных параметров
  • Поле нужно обязательно заполнить, если в макросе есть входные параметры
  • В коллекции должно быть ровно столько элементов, сколько входных параметров в макросе. Элементы, содержащие значения параметров, должны быть указаны в том же порядке, в котором соотв. параметры перечислены в коде макроса.
Robin.Collection Нет
Тип результата

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


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

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

РезультатЗначение, возвращаемое запущенным макросом. Если макрос ничего не возвращает, результат будет пустымRobin.Object

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

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

...

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

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

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


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

...

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


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

Задача

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

Решение

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

  • Для того, чтобы открыть документ необходимо установить на рабочую область действие "Открыть" ONLYOFFICE 
  • Корректно заполнить параметр "Путь к файлу" - указать файл с доступным расширением
  • Внести в него изменения
  • Сохранить файл


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

Реализация

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

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

Image Added

Вариант 1

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

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

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

Image Added

3. Внести изменения в файл вручную.

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

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


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


Image Added

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

Результат

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