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

Ключ

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

Оглавление

Выбрать ячейку /  Cell activate

Получить значение из ячейки / Get cell value

...

Получает значение из указанной ячейкиДелает выбранную ячейку активной.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры
КонтекстContextУникальный идентификатор сеанса, к которому будет применено действиеRobin.Excel
ExelInstance*, где * - порядковый номер контекста, запущенного в данном алгоритме
EXCEL_INSTANCEДа
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.String
Лист1
Лист2Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.

Отсчет порядковых номеров начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.Numeric1Нет
ЯчейкаCell

Адрес ячейки,

которая

из которой будет

активной

взято значение.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.String

A2Да
B4Да
Результаты
РезультатResult

Переменная, в которую будет записано значение из ячейки.


Тип полученной переменной зависит от формата ячейки, из которой было взято значение.

Robin.Object

5

Особые условия использования

Стиль ссылок "R1C1" не поддерживается.

Получить значение из ячейки / Get cell value

Проверить пустая ли ячейка / Is cell empty

...

Проверяет отсутствие значения в ячейкеПолучает значение из указанной ячейки.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры
КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.StringЛист2Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.

Отсчет порядковых номеров начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.Numeric1Нет
ЯчейкаCell

Адрес ячейки, из которой будет взято значение.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.String

B4Да
Результаты
РезультатResult

Переменная, в которую будет

записано значение из ячейки.

Тип полученной переменной зависит от формата ячейки, из которой было взято значение.

Robin.String

или

Robin.Numeric

или

Robin.DateTime

или Robin.Object если это эффективнее

5Да

записан результат проверки.

Если ячейка:

  • пустая, то "Правда (True)".
  • заполнена, то - "Ложь (False)".
Robin.BooleanFalse

Особые условия использования

Стиль ссылок "R1C1" не поддерживается.

...

Установить значение ячейки /

...

Set cell

...

value

...

Устанавливает значение в указанную ячейку

...

Получает текст из указанной ячейки.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действиеRobin.ExcelEXCEL_INSTANCEДа
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.StringЛист2Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.

Отсчет порядковых номеров начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.Numeric1Нет
ЯчейкаCell

Адрес ячейки,

из которой

в которую будет

взято

записано значение.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.String

B3


A1Да
Результаты
Значение
Результат
Value
Result

Значение, которое будет записано в выбранную ячейку.


Формат результирующих данных в ячейке должен соответствовать типу введенных данных.

В случаях несоответствия формат ячейки меняется на общий

Переменная, в которую будет записано значение из ячейки

.

Robin.

String

Object

Result

5000ед

Да

Особые условия использования 

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

Стиль ссылок "R1C1" не поддерживается.

Проверить пустая ли ячейка / Is cell empty

Очистить ячейку / Clear cell

...

Удаляет значение из заданной ячейкиПроверяет отсутствие значения в ячейке.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.Robin.Excel
EXCEL_INSTANCE

ExelInstance*, где * - порядковый номер контекста, запущенного в данном алгоритме

Да
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.String
Лист2
Лист1Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.

Отсчет порядковых номеров начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.Numeric

1Нет
ЯчейкаCell

Адрес ячейки,

из

значение которой будет

взято значение

очищено.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.String

B4ДаРезультатыРезультатResult

Переменная, в которую будет записано значение из ячейки.

Если ячейка:

  • пустая, то "Правда (True)".
  • заполнена, то - "Ложь (False)".
Robin.BooleanFalse
B2Да

Особые условия использования

Стиль ссылок "R1C1" не поддерживается.

Установить значение ячейки / Set cell value

Исполнить формулу / Apply formula to cell (перенести из подгруппы "Общее")

...

Исполняет формулу в выбранной ячейкеУстанавливает значение в указанную ячейку.

Настройки

Свойство

Англ. наименование

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя листаSheet name

Наименование

листа

страницы, к

которому

которой будет применено действие

.Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен

.

Robin.String
Лист2
Лист1Нет
Индекс листаSheet index

Порядковый номер

листа

страницы, к

которому

которой будет применено действие.

Отсчет порядковых номеров

Нумерация начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

Robin.Numeric

1Нет
ЯчейкаCell

Адрес ячейки, в которую будет

записано значение

записан результат выполнения формулы.

Заполнять в формате

Формат заполнения:"ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.StringA1Да
Значение
Формула
Value
Formula
Значение

Формула,

которое

по которой будет

записано в выбранную ячейку.

Формат результирующих данных в ячейке должен соответствовать типу введенных данных.

В случаях несоответствия формат ячейки меняется на общий

выполнено вычисление в ячейке.

Должна начинаться с символа "=".

Robin.String

или Robin.Object если это эффективнее

=COUNTIF(I3:I{Rows},"Да")

Да
Локальный языкLocal language

Использовать локальный язык формул.


По умолчанию false.

Robin.BooleantrueНет

5000ед

Да

Особые условия использования 

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

Стиль ссылок "R1C1" не поддерживается.

Очистить ячейку / Clear cell

Удаляет значение из заданной ячейки.

Настройки

...

Свойство

...

Англ. наименование

...

Описание

...

Тип

...

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

...

Обязательность заполнения поля

...

Context

...

ExelInstance*, где * - порядковый номер контекста, запущенного в данном алгоритме

...

Наименование листа, к которому будет применено действие.

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

...

Порядковый номер листа, к которому будет применено действие.

Отсчет порядковых номеров начинается с "1".

Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.

...

Robin.Numeric

...

Адрес ячейки, значение которой будет очищено.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

...

Robin.String

...

По умолчанию используются формулы на английском языке.

Посмотреть наименования функций можно на официальном сайте: https://support.office.com/en-gb/article/excel-functions-by-category-5f91f4e9-7b42-46d2-9bd1-63f26a86c0eb

Для использования локального (в нашем случае русского) языка необходимо сделать пометку в поле "Локальный язык".

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

Задачи:

Существует Excel-документ "Test.xlsx".

Image Added

Необходимо исполнить формулу по подсчету количество записей на странице. 

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Исполнить формулу.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
  3. Помещаем в рабочее пространство студии действие "Исполнить формулу". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Формула". Указываем формулу для выполнения вычислений в ячейке.
    3. Параметр "Результат". Указываем переменную, в которую должен быть записан результат выполнения формулы.
      Image Added
  4. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
  5. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ содержит результат выполнения формулы в заданной ячейке.

Image Added

Особые условия использования

Стиль ссылок "R1C1" не поддерживается.