История страницы
...
Sort Version 10 (Net)
Группа действийAction group: Excel
Описание
Действие выполняет сортировку таблицы по столбцу.
...
Description
The action sorts the table by column.
Icon
...
Параметры
Входные параметры
Контекст Контекст действия для работы с Excel-документом.
Имя столбца сортировки Наименование столбца, по которому будет проведена сортировка.
Индекс столбца сортировки Индекс столбца, по которому будет проведена сортировка.
Имя столбца начальной ячейки Имя столбца начальной ячейки (начало диапазона), от которой будет установлен диапазон сортировки.
Индекс столбца начальной ячейки Индекс столбца начальной ячейки (начало диапазона), от которой будет установлен диапазон сортировки.
Строка начальной ячейки Строка начальной ячейки, от которой будет установлен диапазон сортировки.
Имя столбца конечной ячейки Имя столбца конечной ячейки (конец диапазона), до которой будет установлен диапазон сортировки.
Индекс столбца конечной ячейки Индекс столбца конечной ячейки (конец диапазона), до которой будет установлен диапазон сортировки.
Строка конечной ячейки Строка конечной ячейки, до которой будет установлен диапазон сортировки.
Порядок Порядок сортировки.
Настройки
...
Свойство
...
Описание
...
Тип
...
Пример заполнения
...
Обязательность заполнения поля
...
Параметры
...
Контекст
...
Контекст действия для работы с Excel-документом
...
Robin.Excel
...
Контекст excel
...
Да
...
Имя столбца сортировки
...
Наименование столбца, по которому будет проведена сортировка. Если поле не заполнено то берется значение из поля „Индекс столбца сортировки“. Если поля наименование и индекс столбца сортировки не заполнены, то сортировка идет по первому столбцу в диапазоне.
...
Robin.String
...
Нет
...
Индекс столбца сортировки
...
Индекс столбца, по которому будет проведена сортировка. Если поле „Наименование столбца сортировки“ заполнено то значение этого поля игнорируется. Если поля наименование и индекс столбца сортировки не заполнены, то сортировка идет по первому столбцу в диапазоне.
...
Robin.Numeric
...
Нет
...
Имя столбца начальной ячейки
...
Имя столбца начальной ячейки (начало диапазона), от которой будет установлен диапазон сортировки. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки».
...
Robin.String
...
Нет
...
Индекс столбца начальной ячейки
...
Индекс столбца начальной ячейки (начало диапазона), от которой будет установлен диапазон сортировки. Если поле не заполнено, то берется граница используемой области.
...
Robin.Numeric
...
Нет
...
Строка начальной ячейки
...
Строка начальной ячейки, от которой будет установлен диапазон сортировки.
...
Robin.Numeric
...
Нет
...
Имя столбца конечной ячейки
...
Имя столбца конечной ячейки (конец диапазона), до которой будет установлен диапазон сортировки. Если поле не заполнено, то берется значение из поля «Индекс столбца конечной ячейки».
...
Robin.String
...
Нет
...
Индекс столбца конечной ячейки
...
Индекс столбца конечной ячейки (конец диапазона), до которой будет установлен диапазон сортировки. Если поле не заполнено, то берется граница используемой области.
...
Robin.Numeric
...
Нет
...
Строка конечной ячейки
...
Строка конечной ячейки, до которой будет установлен диапазон сортировки.
...
Robin.Numeric
...
Нет
...
Порядок
...
Порядок сортировки. Меняется порядок только включенных в диапазон данных. Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется. Если установленный диапазон содержит данные одной колонки (например, от «А1» до «А10»), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк - параметры «Имя столбца сортировки» и «Индекс столбца сортировки» влияния на сортировку не оказывают. Если установленный диапазон содержит данные двух и более колонок (например, от «А1» до «C10»), то сортировка данных происходит по столбцу, указанному в параметрах «Имя столбца сортировки» или «Индекс столбца сортировки». Если параметры «Имя столбца сортировки» и «Индекс столбца сортировки» не заполнены, то сортировка идет по первому столбцу в диапазоне.
...
Robin.String
...
Нет
Settings of parameters
Property | Description | Type | Example of filling in | Obligatory to fill in the field |
Parameters | ||||
Context | Action context for working with an Excel document | Excel instance | Excel context | Yes |
Sort column name | Name of the column to be sorted by. If the field is not filled in, the value from the " Sort column index" field is taken. If the sorting column name and index fields are not filled in, sorting is performed by the first column in the range. | String | No | |
Sort column index | The index of the column by which the sorting will be performed. If the "Sort column name" field is filled in, the value of this field is ignored. If the sorting column name and index fields are not filled in, sorting is performed by the first column in the range. | Numeric | No | |
Start cell column name | The column name of the initial cell (range start) from which the sorting range will be set. If the field is not filled in, the value from the "Start cell column index" field is taken. | String | No | |
Start cell column index | The column index of the initial cell (range start) from which the sorting range will be set. If the field is not filled in, the boundary of the used area is taken. | Numeric | No | |
Start cell row | The starting cell string from which the sort range will be set. | Numeric | No | |
End cell column name | The column name of the end cell (end of range) to which the sort range will be set. If the field is not filled in, the value from the "End cell column index" field is taken. | String | No | |
End cell column index | The column index of the end cell (end of range) to which the sorting range will be set. If the field is not filled in, the boundary of the used area is taken. | Numeric | No | |
End cell row | The end cell string to which the sort range will be set. | Numeric | No | |
Order | Sort order. Only the order of the data included in the range is changed. The order of the data in the table that were not included in the sorting range is not changed. If the set range contains data of one column (for example, from "A1" to "A10"), the data sorting is performed only within this column and the set range of rows - the parameters "Sort column name" and "Sort column index" do not influence the sorting. If the set range contains data of two or more columns (for example, from "A1" to "C10"), the data sorting is performed by the column specified in the "Sort column name" or "Sort column index" parameters. If the parameters "Sort column name" and "Sort column index" are not filled in, the sorting is performed by the first column in the range. | String | No |
Special conditions of use
Only the order of the data included in the range is changed.
The order of data in the table that were not included in the sorting range is not changed.
If the set range (fields "Start cell row" and "End cell row") contains data:
- one column (for example, from "A1" to "A10"), the data is sorted only within this column and the set range of rows. The "Column" parameter has no effect on sorting.
- two or more columns (for example, from "A1" to "C10"), the data sorting is performed by the column specified in the "Column" parameter. If the "Column" parameter is not filled in, sorting is performed by the first column in the range.
Example of use
Task
There is an Excel document with a table of countries:
You need to sort a list alphabetically from A to Z.
Solution
Use the "Open", "Sort", "Save" actions.
Implementation
- Assemble a robot scheme consisting of the actions:
- Fill in the parameters for the "Open" action. In the "Path to file" field, specify the path to the required Excel file. Check the Visible = true checkbox to display robot actions on the screen.
- Fill in the parameters for the "Sort" action. Fill the "Context" parameter and the "Order" field by specifying the value "A to Z". The other parameters do not need to be filled in this case, as it is necessary to apply sorting to the whole table.
- Fill in the parameters for the "Save" action. In the "Context" parameter specify the context of the Excel document.
- Launch the robot using the "Start" button in the top panel.
Result
The program robot completed successfully.
The sorting is done correctly.
Особые условия использования
Меняется порядок только включенных в диапазон данных.
Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется.
Если установленный диапазон (поля "Start cell row" и "End cell row") содержит данные:
- одной колонки (например, от "А1" до "А10"), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк. Параметр "Столбец" влияния на сортировку не оказывает.
- двух и более колонок (например, от "А1" до "C10"), то сортировка данных происходит по столбцу, указанному в параметре "Столбец". Если параметр "Столбец" не заполнен, то сортировка идет по первому столбцу в диапазоне.
Пример использования
Задача
Cуществует Excel-документ с таблицей:
Необходимо отсортировать список по алфавиту от А до Я.
Решение
Воспользоваться действиями "Открыть", "Отсортировать", "Сохранить".
Реализация
...
Результат
Программный робот отработал успешно.
Сортировка выполнена верно.