История страницы
Взять таблицу
...
Версия 2 (Python)
Группа действий: Офис
...
Описание
Действие возвращает значения ячеек из заданной области страницы в виде таблицы.
Иконка действия
...
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|
Параметры | ||||
Контекст | Контекст действия для работы с таблицей ods/xlsx | Robin.OpenSheetD oc | Да | |
Строка начальной ячейки | Строка начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области. | Robin.Numeric | Нет | |
Строка конечной ячейки | Строка конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области | Robin.Numeric | Нет | |
Столбец начальной ячейки | Столбец начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области | Robin.String | Нет | |
Столбец конечной ячейки | Столбец конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Если поле не заполнено, то берется граница используемой области | Robin.String | Нет | |
С заголовком | Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы. | Robin.Boolean | true | Нет |
Убрать дубли заголовка | Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. | Robin.Boolean | true | Нет |
Результаты | ||||
Результат | Переменная, в которую будут записаны данные диапазона | Robin.DataTable |
Особые условия
Для параметра "С заголовком":
...
- При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.
- Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3".
Пример
...
использования
Задача: существует файл Книга1
Существует файл Книга1.xlsx необходимо записать значения со строки 1-4 столбца А в переменную "Таблица", сохранить и закрыть документ.
Решение: воспользоваться
Воспользоваться действием "Открыть", "Взять таблицу", "Сохранить".
...
- Собрать схему робота, состоящую из действий:
- Настроить параметр для действия "Открыть".
В поле "Путь к файлу" указать путь к файлу Книга1.xlsx
В поле "Строка конечной ячейки" указать значение = 4.
В поле "Столбец начальной ячейки" указать значение = А.
В поле "Столбец конечной ячейки" указать значение =А.
Указать в поле "Результат" переменную типа "Таблица", заранее созданную.- Настроить параметр для действия "Сохранить".
В поле "Контекст" указать контекст открытого документа. - Нажать на кнопку "Старт" в верхней панели.
Результат:
Программный робот отработал успешно. Значения ячеек из заданной области записаны в переменную "Таблица".