Взять таблицу / Get table

Действие возвращает значения ячеек из заданной области страницы в виде таблицы.

Документация ROBIN > Область > image2021-9-2_9-42-15.png

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Контекст действия для работы с Excel-документом	Идентификатор контекста Excel	EXCEL_INSTANCE	Да
Столбец начальной ячейки	Start cell column	Столбец начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области.	Строка		Нет
Строка начальной ячейки	Start Cell Row	Строка начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области.	Число		Нет
Столбец конечной ячейки	Destination cell column	Столбец конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Строка		Нет
Строка конечной ячейки	Destination cell string	Строка конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Число		Нет
Пропустить скрытые	Skip hidden	Логическая переменная. Если значение параметра равно True, то возвращаются только видимые строки и столбцы, иначе - все.	Логический	true	Нет
Результаты
Результат	Result	Переменная, в которую будут записаны значения выбранного диапазона.	Таблица	Данные_с_фильтром

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

Отсутствуют.

Вставить таблицу / Insert table

Действие записывает данные из переменной типа Таблица в заданную область активной страницы Excel книги

Документация ROBIN > Область > image2021-9-2_10-6-35.png

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Контекст действия для работы с Excel-документом	Идентификатор контекста Excel	EXCEL_INSTANCE	Да
Таблица	Table	Таблица, которая будет вставлена.	Таблица	Table1	Да
Столбец начальной ячейки	Start cell column	Столбец ячейки, в которую будет помещена верхняя левая ячейка таблицы.	Строка		Нет
Строка начальной ячейки	Start Cell Row	Строка ячейки, в которую будет помещена верхняя левая ячейка таблицы.	Число		Нет
С заголовком	Heading	Если значение равно "true", будет вставлена вся указанная таблица. Если значение равно "false", заголовком таблицы будет считаться ее первая строка, и таблица будет вставлена без этой строки	Чекбокс		Нет

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

Отсутствуют

Копировать область в буфер / Copy range to clipboard

Сохраняет значения из заданной области.

Документация ROBIN > Область > image2021-9-2_10-7-24.png

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Уникальный идентификатор сеанса, к которому будет применено действие.	Идентификатор контекста Excel	EXCEL_INSTANCE	Да
Столбец начальной ячейки	Start cell column	Столбец начальной ячейки (начало диапазона), от которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Строка		Нет
Строка начальной ячейки	Start Cell Row	Строка начальной ячейки (начало диапазона), от которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Число		Нет
Столбец конечной ячейки	Destination cell column	Столбец конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Строка		Нет
Строка конечной ячейки	Destination cell string	Строка конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области.	Число		Нет
Пропустить скрытые	Skip hidden	Копировать только видимые ячейки.	Логический	true	Нет

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

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

Вставить значения из буфера / Paste range from clipboard

Ввести значение из буфера в указанную ячейку.

Название действия в репозитории - RangePaste

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Уникальный идентификатор сеанса, к которому будет применено действие	Robin.Excel	EXCEL_INSTANCE	Да
Ячейка	Cell	Адрес ячейки, от которой будет вставлено содержимое из буфера. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. По умолчанию А1.	Robin.String	B4	Нет
Вставить значения	Paste values	Если значение параметра равно True, будут вставлены значения ячеек из области. По умолчанию False.	Robin.Boolean	True	Нет
Вставить исходный формат	Paste source format	Если значение параметра равно True, будет вставлен скопированный исходный формат. По умолчанию False.	Robin.Boolean	True	Нет
Вставить формулы	Paste formulas	Если значение параметра равно True, будут вставлены формулы из области. По умолчанию False.	Robin.Boolean	True	Нет

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

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

Очистить область / Clear range

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

Название действия в репозитории - RangeClear

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Уникальный идентификатор сеанса, к которому будет применено действие	Robin.Excel	EXCEL_INSTANCE	Да
От	Start cell	Адрес начальной ячейки диапазона, от которой будет установлена удаляемая область. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области.	Robin.String	A1	Нет
До	End cell	Адрес конечной ячейки диапазона, до которой будет установлена удаляемая область. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области.	Robin.String	B3	Нет

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

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

Установить формат диапазона / Set range format

Задает формат ячейкам указанного диапазона.

Документация ROBIN > Область > image2021-9-2_10-12-29.png

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Контекст действия для работы с Excel-документом	Идентификатор контекста Excel	EXCEL_INSTANCE	Да
Столбец начальной ячейки	Start cell column	Столбец начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области.	Строка		Нет
Строка начальной ячейки	Start Cell Row	Строка начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области.	Число		Нет
Столбец конечной ячейки	Destination cell column	Столбец конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками.	Строка		Нет
Строка конечной ячейки	Destination cell string	Строка конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками.	Число		Нет
Формат	Format	Формат, который будет установлен в выбранных ячейках	Строка		Да
Маска формата	Format mask	Маска для создания настраиваемого формата. Правила для масок пользовательского формата: 1) Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки. 2) Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст. 3) 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35. 4) # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится 5) (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д. 6) [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой.	Строка		Нет

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

Если адрес "До" будет меньше адреса "От", будет использована область которая ограничивается этими ячейками.

Правила для масок пользовательского формата:

Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки.
Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст.
0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35.
# (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится
(пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д.
[ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой.

Установить цвет диапазона / Set range color

Задает цвет ячейкам указанного диапазона.

Название действия в репозитории - RangeSetColor.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Уникальный идентификатор сеанса, к которому будет применено действие	Robin.Excel	EXCEL_INSTANCE	Да
От	Start cell	Адрес начальной ячейки диапазона. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области.	Robin.String	A1	Нет
До	End cell	Адрес конечной ячейки диапазона. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области.	Robin.String	A1000	Нет
Цвет	Color	Цвет, который будет установлен в выбранных ячейках. Выпадающий список допустимых цветов: Нет цвета - No color Белый - White Темно-красный - Dark Red Красный - Red Оранжевый - Orange Желтый - Yellow Светло-зеленый - Light Green Зеленый - Green Голубой - Light Blue Синий - Blue Темно-синий - Dark Blue Фиолетовый - Purple Настраиваемый - Custom	Robin.String	Синий	Да
RGB	RGB	RGB код для создания настраиваемого цвета. Водится в формате: {значение для канала R}, {значение для канала G}, {значение для канала B}. Поле становится активным после выбора значения "Настраиваемый" в параметре "Цвет" (решение на уровне студии).	Robin.String	100, 50, 45	Нет

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

Если адрес "До" будет меньше адреса "От", будет использована область которая ограничивается этими ячейками.

Отсортировать / Sort (перемещено из Общего)

Сортирует данные в таблице.

Название действия в репозитории - Sort - RangeSort.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Context	Уникальный идентификатор сеанса, к которому будет применено действие	Robin.Excel	EXCEL_INSTANCE	Да
Столбец	Column	Наименование столбца, по которому будет проведена сортировка. Если столбец не указан, то сортировка идет по первому в диапазоне.	Robin.String	А	Нет
Начало диапазона	Start cell	Адрес начальной ячейки, от которой будет установлен диапазон сортировки. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. По умолчанию применяются границы используемой области из контекста.	Robin.String	A1	Нет
Конец диапазона	End cell	Адрес конечной ячейки, до которой будет установлен диапазон сортировки. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. По умолчанию применяются границы используемой области из контекста.	Robin.String	В1000	Нет
Порядок	Order	Порядок сортировки. Выпадающий список: от A до Я / по возрастанию от Я до A / по убыванию По умолчанию "от A до Я / по возрастанию"	Robin.String	от A до Я / по возрастанию	Нет

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

Меняется порядок только включенных в диапазон данных.

Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется.

Если установленный диапазон (поля "Начало диапазона" и "Конец диапазона") содержит данные:

одной колонки (например, от "А1" до "А10"), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк. Параметр "Столбец" влияния на сортировку не оказывает.
двух и более колонок (например, от "А1" до "C10"), то сортировка данных происходит по столбцу, указанному в параметре "Столбец". Если параметр "Столбец" не заполнен, то сортировка идет по первому столбцу в диапазоне.