Взять таблицу Версия 10 (Net)
Группа действий: Word
Описание
Сохраняет таблицу из документа в переменную типа Таблица
Иконка
Параметры
Входные параметры
Контекст Уникальный идентификатор сеанса, к которому будет применено действие
Номер таблицы Порядковый номер таблицы в документе
С заголовком Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы
Убрать дубли заголовка Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы
Выходные параметры
Результат В результате получаем таблицу
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context name | Уникальный идентификатор сеанса, к которому будет применено действие | Идентификатор контекста Word | WordInstance* | Да |
Номер таблицы | Table number | Порядковый номер таблицы в документе Порядок начинается с 1 Значение по умолчанию "1" | Число | 1 | Нет |
С заголовком | Heading | Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы | Логический | true | Нет |
Убрать дубли заголовка | Remove duplicate header | Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1 | Логический | true | Нет |
Результаты | |||||
Результат | Result | Результирующая таблица | Таблица | Таблица_Word | Да |
Особые условия использования
Для чек-бокса "С заголовком":
Работа параметра: При значении "true" действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
При "false" первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.
Пример:
Забираем таблицу:
При включенном параметре в логе будет указано "Столбцов: 3; строк: 2", т.к. Первая строка взятой области стала заголовком с названиями столбцов "№", "Название" и "Тесты". К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы "Таблицы"). Если параметр выключен, то в логе будет указано "Столбцов: 3; строк: 3", названия столбцов в заголовке будут "1", "2" и "3".
Для чек-бокса "Убрать дубли заголовка":
- При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1.
Пример №1:
Есть таблица:
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№", "Название робота", "Тесты1", "Тесты2".
Пример №2:
Есть таблица:
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:
"Тест31", "Тест21", "Тест22", "Тест32", "Тест1".
- При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов
- Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3"
Пример использования
Задача
Необходимо сохранить таблицу из документа Word в переменную типа "таблица".
Решение
Воспользоваться действиями: "Открыть", "Взять таблицу", "Закрыть".
Реализация
- Собрать схему робота, состоящую из действий группы Word.
- Настроить параметры действия "Открыть".
- Настроить параметры действия "Взять таблицу".
- Настроить параметр действия "Закрыть".
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Таблица получена.