История страницы

...

Get table Version 2 (Python)

...

Action group:

...

Office

Описание

Действие возвращает значения ячеек из заданной области страницы в виде таблицы. 

Image Removed

Настройки

...

Description

The action returns cell values from the specified area of the page as a table.

Action icon

Image Added

Settings of parameters

Особые условия

Special conditions of use

For the "With Header" parameter

...

: 

...

From excel we get the table:

При

включенном параметре в логе будет указано "СтолбцовWith this parameter enabled, the log will show "Columns: 3; строкrows: 2" , т.к. Первая строка взятой области стала заголовком с названиями столбцов "№", "Название" и "Тесты". К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы "Таблицы"). Если параметр выключен, то в логе будет указано "Столбцов: 3; строк: 3", названия столбцов в заголовке будут "1", "2" и "3".

Для параметра "Убрать дубли заголовка"

...

• При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.
• Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3".

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

Задача: существует файл Книга1.xlsx необходимо записать значения со строки 1-4 столбца А в переменную "Таблица" , сохранить и закрыть документ. 

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

Реализация:

...

because the first row of the taken area has become a header with the column names ‘No.’, ‘Title’, and ‘Tests’. These headers cannot be accessed as a row of data to read, but you can use the column names to access a specific cell or column (by actions from the "Tables" group). If the option is off, the log will show "Columns: 3; rows: 3", the column names in the header will be ‘1’, ‘2’ and ‘3’.

For the "Remove duplicate header" option

• When true, the header of the tabular value that the actions return as a result will have indices added to the same column names. The numbering starts with 1. 
  Example No.1:
  There is a table in a file with the extension xlsx:
  Image Added
  With "Remove duplicate header" = true, and "With Header" = True, the "Take Table" action will return a table of 10 rows and 4 columns. The column names of this table will be "No.", "Robot Name", "Tests1", "Tests2".
  
  Example No.2:
  There is a table in a file with the extension xlsx:
  Image Added
  When "Remove duplicate header" = true, and "With Header" = True, the "Take Table" action will return a table of 4 rows and 5 columns. The column names of this table will be:
  "Test31", ‘Test21’, ‘Test22’, ‘Test32’, ‘Test1’.

• If false, the column names will remain the same. Actions on net that return/process such tables with duplicated column names will crash with an error, because net cannot have a header with the same column names.
• For example, the source table has columns "Test1", "Test" and "Test". If we add indexes only to the current doubles, the names will become "Test1", "Test1" and "Test2", i.e. new doubles with the name "Test1" will appear. Therefore, when renaming a particular column, the action should check if another column already has such a name and if there is such a match, the current column should have the next index. That is, in this case the action will rename the columns as "Test1", "Test2" and "Test3".

Example of use

Task

There is a file Book1.xlsx it is necessary to write values from row 1-4 of column A to the variable "Table", save and close the document. 

Solution

Use the actions "Open", "Get table", "Save".

Implementation

1. Assemble a robot scheme consisting of actions:Image Added
2. Set the parameter for the "Open" action. 
   In the "File path" field specify the path to the file Book1.xlsx
   
   Image Added
3. Customize parameters for the "Retrieve table" action. 
   In the "Context" field specify the context created in step 1
   In the "Start cell row" field specify the value = 1.
   In the "End cell row" field specify the value = 4. 
   In the "Start cell column" field specify the value = A. 
   In the "End Cell Column" field, specify the value =A. 
   Specify in the "Result" field a variable of the "Table" type created in advance. 
   Image Added
4. Set the parameter for the "Save" action. 
   Specify the context of the opened document in the Context field.
   
   Image Added
5. Launch the robot using the "Start" button in the top panel.
   
   

Result

The program robot completed successfully.

Cell values from the specified area are written to the variable "Table".

...

Результат:

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