Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Действие сохраняет таблицу из документа в переменную типа Таблица.

Иконка действия

Параметры

...

и их настройки

Входные параметры

Контекст                                               Контекст для работы с документом

Номер таблицы                                   Порядковый номер таблицы в документе. Порядок начинается с 1. Значение по умолчанию 1

С заголовком                                       Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы

Убрать дубли заголовка                      Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1

Выходные параметры

Результат                                            Результирующая таблица

Настройки

Свойство

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Параметры

Контекст

Контекст для работы с документом

Robin.OpenTextDo cOpenTextDoc


Да

Номер таблицы

Порядковый номер таблицы в документе. Порядок начинается с 1. Значение по умолчанию 1

Robin.Numeric


Нет

С заголовком

Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы

Robin.Boolean

true

Нет

Убрать дубли заголовка

Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1

Robin.Boolean

true

Нет

Результаты

Результат

Результирующая таблица

Robin.DataTable



Особые условия использования

Для параметра "С заголовком".

Забираем таблицу:.

При выключенном параметре "С заголовком" у действия "Вставить таблицу" в логе будет указано.

 

При включенном параметре параметре "С заголовком" у действия "Вставить таблицу" в логе будет указано.

 

Рассмотрим пример по получению таблицы и ее вставке в документ в зависимости от настроенного параметра "С заголовком". 

...

  • При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. 
    Пример №1:
    Есть таблица:.

    При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№", "Название робота", "Тесты1", "Тесты2".

    Пример №2:
    Есть таблица:

    При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:

    "Тест31", "Тест21", "Тест22", "Тест32", "Тест1".

...

Пример использования 

Задача: существует
Существует файл test.docx. Необходимо открыть документ и получить оттуда таблицу с данными (таблица только одна в документе). Далее, сохранить документ и закрыть. 

Решениевоспользоваться
Воспользоваться действием "Открыть", "Взять таблицу", "Сохранить", "Закрыть". 

Реализация:

  1. Собрать схему робота, состоящую из действий: "Открыть", "Взять таблицу", "Сохранить", "Закрыть". 

  2.  Заполнить  параметр действия "Открыть". 
    В поле "Путь к файлу" указать путь к файлу test.docx.

  3. Заполнить параметры для действия "Взять таблицу".
    В поле "Контекст" указать созданный контекст в п.1.
    В поле "Номер таблицы" указать  -1. 
    В поле "Результат" указать переменную типа "таблица", куда будет записана полученная таблица с данными.
  4. Заполнить параметр для действия "Сохранить". 
    В поле "Контекст" указать контекст открытого документа.
  5. Заполнить параметр "Контекст" для действия "Закрыть". 

  6. Нажать на кнопку "Старт" в верхней панели. 

Результат:

Программный робот отработал успешно. Таблица из документа успешно сохранена в переменную.  Файл сохранен и закрыт.

...