Взять таблицу / Get table
Действие возвращает значения ячеек из заданной области страницы в виде таблицы.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | 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 книги
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Контекст | Context | Контекст действия для работы с Excel-документом | Идентификатор контекста Excel | EXCEL_INSTANCE | Да |
Таблица | Table | Таблица, которая будет вставлена. | Таблица | Table1 | Да |
Столбец начальной ячейки | Start cell column | Столбец ячейки, в которую будет помещена верхняя левая ячейка таблицы. | Строка | Нет | |
Строка начальной ячейки | Start Cell Row | Строка ячейки, в которую будет помещена верхняя левая ячейка таблицы. | Число | Нет | |
С заголовком | Heading | Если значение равно "true", будет вставлена вся указанная таблица. Если значение равно "false", заголовком таблицы будет считаться ее первая строка, и таблица будет вставлена без этой строки | Чекбокс | Нет |
Особые условия использования
Отсутствуют
Копировать область в буфер / Copy range to clipboard
Сохраняет значения из заданной области.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | 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
Задает формат ячейкам указанного диапазона.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | 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 | Цвет, который будет установлен в выбранных ячейках. Выпадающий список допустимых цветов:
| 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 до Я / по возрастанию" | Robin.String | от A до Я / по возрастанию | Нет |
Особые условия использования
Меняется порядок только включенных в диапазон данных.
Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется.
Если установленный диапазон (поля "Начало диапазона" и "Конец диапазона") содержит данные:
- одной колонки (например, от "А1" до "А10"), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк. Параметр "Столбец" влияния на сортировку не оказывает.
- двух и более колонок (например, от "А1" до "C10"), то сортировка данных происходит по столбцу, указанному в параметре "Столбец". Если параметр "Столбец" не заполнен, то сортировка идет по первому столбцу в диапазоне.