Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 5 Следующий »


Name

Description

TypeMandatory field

Parameters






ContextContext for working with a tabular document via ONLYOFFICE.Robin.OnlyOfficeCellYes
Macro Path

Path to the js file that contains the JS code for the macro

Acceptable file extension: .js

Robin.FilePathYes
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

  • The field does not need to be filled in if there are no input parameters in the macro
  • The field must be filled in if there are input parameters in the macro
  • There must be exactly as many elements in the collection as there are input parameters in the macro. Elements containing parameter values must be listed in the same order in which the corresponding 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

  • Since the types in Onlyoffice do not coincide with our types, for correct conversion of the macro result it is necessary to specify what type of data we expect to get
  • Field in the form of a dropdown list
  • Available list values:
    • String
    • Number
    • Collection
    • Table
    • Macro with no result
  • Default value - “Macro with no result”
  • If the result of the macro is a collection or a table, the action will return them as a collection of rows or a table with string values, respectively
  • The action will not terminate with an error if “Macro with no result” is selected and the action returns a result
Robin.StringNo

Results

ResultThe value returned by the running macro. If the macro returns nothing, the result will be emptyRobin.Object

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

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

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

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

      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. Заполнить параметры действия Close (ONLYOFFICE)


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

Результат

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



Вариант 2

Задача

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

Решение

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

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

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

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

Реализация

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

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

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

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

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

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

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

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

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

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

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

6. Заполнить параметры действия Close (ONLYOFFICE)


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

Результат

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

 







  • Нет меток