История страницы
Оглавление |
---|
Выбрать ячейку / Cell activate
Получить значение из ячейки / Get cell value
...
Получает значение из указанной ячейкиДелает выбранную ячейку активной.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие | Robin.Excel |
EXCEL_INSTANCE | Да | ||
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.String |
Лист2 | Нет | ||||
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Отсчет порядковых номеров начинается с "1". Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.Numeric | 1 | Нет |
Ячейка | Cell | Адрес ячейки, |
из которой будет |
взято значение. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String |
B4 | Да | ||||
Результаты | |||||
Результат | Result | Переменная, в которую будет записано значение из ячейки. Тип полученной переменной зависит от формата ячейки, из которой было взято значение. | Robin.Object | 5 |
Особые условия использования
Стиль ссылок "R1C1" не поддерживается.
Получить значение из ячейки / Get cell value
Проверить пустая ли ячейка / Is cell empty
...
Проверяет отсутствие значения в ячейкеПолучает значение из указанной ячейки.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.String | Лист2 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Отсчет порядковых номеров начинается с "1". Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.Numeric | 1 | Нет |
Ячейка | Cell | Адрес ячейки, из которой будет взято значение. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String | B4 | Да |
Результаты | |||||
Результат | Result | Переменная, в которую будет |
Тип полученной переменной зависит от формата ячейки, из которой было взято значение.
Robin.String
или
Robin.Numeric
или
Robin.DateTime
или Robin.Object если это эффективнее
записан результат проверки. Если ячейка:
| Robin.Boolean | False |
Особые условия использования
Стиль ссылок "R1C1" не поддерживается.
...
Установить значение ячейки /
...
Set cell
...
value
...
Устанавливает значение в указанную ячейку
...
Получает текст из указанной ячейки.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.String | Лист2 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Отсчет порядковых номеров начинается с "1". Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.Numeric | 1 | Нет |
Ячейка | Cell | Адрес ячейки, |
в которую будет |
записано значение. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String |
A1 | Да |
Значение |
Value |
Значение, которое будет записано в выбранную ячейку. Формат результирующих данных в ячейке должен соответствовать типу введенных данных. В случаях несоответствия формат ячейки меняется на общий |
. | Robin. |
Object |
5000ед | Да |
Особые условия использования
Если в ячейке уже есть данные, они будут перезаписаны.
Стиль ссылок "R1C1" не поддерживается.
Проверить пустая ли ячейка / Is cell empty
Очистить ячейку / Clear cell
...
Удаляет значение из заданной ячейкиПроверяет отсутствие значения в ячейке.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel |
ExelInstance*, где * - порядковый номер контекста, запущенного в данном алгоритме | Да | ||
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.String |
Лист1 | Нет | ||||
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Отсчет порядковых номеров начинается с "1". Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен. | Robin.Numeric | 1 | Нет |
Ячейка | Cell | Адрес ячейки, |
значение которой будет |
очищено. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String |
Переменная, в которую будет записано значение из ячейки.
Если ячейка:
- пустая, то "Правда (True)".
- заполнена, то - "Ложь (False)".
B2 | Да |
Особые условия использования
Стиль ссылок "R1C1" не поддерживается.
Установить значение ячейки / Set cell value
Исполнить формулу / Apply formula to cell (перенести из подгруппы "Общее")
...
Исполняет формулу в выбранной ячейкеУстанавливает значение в указанную ячейку.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование |
страницы, к |
которой будет применено действие |
. | Robin.String |
Лист1 | Нет | |
Индекс листа | Sheet index | Порядковый номер |
страницы, к |
которой будет применено действие. |
Нумерация начинается с "1". |
Один из параметров "Имя листа" или "Индекс листа" должен быть заполнен.
Robin.Numeric | 1 | Нет |
Ячейка | Cell | Адрес ячейки, в которую будет |
записан результат выполнения формулы. |
Формат заполнения:"ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String | A1 | Да |
Формула |
Formula |
Формула, |
по которой будет |
Формат результирующих данных в ячейке должен соответствовать типу введенных данных.
В случаях несоответствия формат ячейки меняется на общийвыполнено вычисление в ячейке. Должна начинаться с символа "=". | Robin.String |
или Robin.Object если это эффективнее
=COUNTIF(I3:I{Rows},"Да") | Да | ||||
Локальный язык | Local language | Использовать локальный язык формул. По умолчанию false. | Robin.Boolean | true | Нет |
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".
Необходимо исполнить формулу по подсчету количество записей на странице.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Исполнить формулу.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Исполнить формулу".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Формула". Указываем формулу для выполнения вычислений в ячейке.
- Параметр "Результат". Указываем переменную, в которую должен быть записан результат выполнения формулы.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ содержит результат выполнения формулы в заданной ячейке.
Особые условия использования
Стиль ссылок "R1C1" не поддерживается.