Найти начальную/конечную строку
Элемент помогает определить границы данных в рамках указанного столбца. Путь до файла указывается в контейнере Приложение Excel.
В результате вы получите номера первой и последней строки с данными. Способы определения этих строк настраиваются в свойствах элемента.
Свойства
Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. здесь.
| Свойство | Тип | Описание | Пример |
|---|---|---|---|
| Excel: | |||
| Диапазон | String | Диапазон считывания ячеек. Например, "A1:D12". Если указан символ "*", то будет прочитан весь лист. Если значение не указано, будет прочитан выделенный диапазон | "*" |
| Столбец с данными* | String | Адрес столбца, в котором нужно найти данные | "А1" |
| Страница | String | Название страницы Excel. Если указан индекс, название можно не заполнять | "Лист1" |
| Индекс страницы | Int32 | Номер страницы Excel. Нумерация начинается с нуля. Если указано название страницы, номер можно пропустить | 0 |
| Строка заголовков | Boolean | Определяет, содержит ли первая строка заголовки таблицы. По умолчанию чекбокс не установлен — считается, что первая строка не содержит заголовки | |
| Смещение индекса первой строки | Int32 | Количество строк, которые следует прибавить к номеру первой строки. Например, когда в таблице есть скрытые строки | 0 |
| Индекс последней строки | - | Признак, по которыму вы хотите определять номер последней строки. Возможные значения: 1. First Empty Row (по умолчанию) — если выбрано это значение, то последней строкой будет считаться первая пустая строка. 2. Last Populated Row — вернет номер последней строки, содержащей данные | First Empty Row |
| Разрешенное число пустых строк | Int32 | Позволяет установить количество последовательных пустых строк, разрешенных в данных, прежде чем будет определено, что диапазон закончился. По умолчанию пустые строки в данных не разрешены | 2 |
| Вывод: | |||
| Начало диапазона данных | Int32 | Название переменной, в которую запишется начало диапазона данных. Фактически — номер первой строки с данными | |
| Конец диапазона данных | Int32 | Название переменной, в которую запишется конец диапазона данных |
На рисунке ниже приведен пример заполненных свойств. В данном случае робот будет искать начальную и конечную строку таблицы на листе «Персонал таблица». Последняя строка диапазона определяется первой пустой строкой. Ячейка столбца, с которой будет считаться количество строк с данными, определена как “Е1”.
Пример использования
RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning .
- Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
- Распакуйте архив и откройте в Студии проект WorkWithExcelExample.
- Элемент Найти начальную/конечную строку находится в процессе
Main.ltw. Описание процесса можно найти в файлах проекта.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, @"c:\file.xlsx");
Tuple<int, int> data = app.FindFirstAndLastDataRow("A1:C22", null, 0, "A1");