=====================================================
Шаблон описания действия 2.0.3
=====================================================


Получить данные из ячейки/Get Data Cell
------------------------------------------------------

*Группа действий: Данные из таблицы*

__________________________________________________________


.. image:: images/image.png

Назначение 
----------------------

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

Для выполнения данного действия в схеме робота должна быть заведена переменная с типом "Таблица", в нее занесены значения.


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

**Данные из таблицы/Data table** 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  

Переменная, из которой необходимо взять значение ячейки.

Переменная выбирается из выпадающего списка, для выбора доступны все переменные с типом "Таблица"

+---------------------------+--------------+
| **Свойство параметра**    | **Значение** |
+---------------------------+--------------+
| Тип                       | Таблица      |
+---------------------------+--------------+
| Обязательность заполнения | Да           |
+---------------------------+--------------+

**Имя столбца/Name column** 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  

Наименование колонки таблицы, содержащейся в переменной, указанной в поле "Данные из таблицы". 

Значение должно соответствовать наименованию колонки таблицы, вводится вручную. Cм раздел Особенности

+---------------------------+--------------+
| **Свойство параметра**    | **Значение** |
+---------------------------+--------------+
| Тип                       | Строка       |
+---------------------------+--------------+
| Обязательность заполнения | Нет          |
+---------------------------+--------------+

**Номер столбца/Index column**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  

Номер колонки исходной таблицы, содержащейся в переменной, указанной в поле "Данные из таблицы".

Значение должно соответствовать номеру искомого столбца, нумерация столбцов начинается с нуля. Значение по умолчанию: 0. Cм раздел Особенности
 
+---------------------------+--------------+
| **Свойство параметра**    | **Значение** |
+---------------------------+--------------+
| Тип                       | Число        |
+---------------------------+--------------+
| Обязательность заполнения | Нет          |
+---------------------------+--------------+
| Значение по умолчанию     | Нет          |
+---------------------------+--------------+

**Номер строки/Index row** 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  

Номер строки исходной таблицы, содержащейся в переменной, указанной в поле "Данные из таблицы".

Значение должно соответствовать номеру искомой строки, нумерация строк начинается с нуля. *Значение по умолчанию: 0*

+---------------------------+--------------+
| **Свойство параметра**    | **Значение** |
+---------------------------+--------------+
| Тип                       | Число        |
+---------------------------+--------------+
| Обязательность заполнения | Да           |
+---------------------------+--------------+

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

**Результат/Result** 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  

Переменная, в которую запишется результат выполнения действия.

Переменная выбирается из выпадающего списка, для выбора доступны все переменные с типом "Строка"

+---------------------------+--------------+
| **Свойство параметра**    | **Значение** |
+---------------------------+--------------+
| Тип                       | Строка       |
+---------------------------+--------------+
| Обязательность заполнения | Да           |
+---------------------------+--------------+




.. note::  Адрес ячейки, из которой нужно взять значение, составляется из *Имя столбца* + *Номер строки* либо *Номер столбца* + *Номер строки*. Заполнение поля *Имя столбца* имеет больший приоритет, чем *Номер столбца*. То есть при заполнении имени столбца поиск значения будет осуществляться по имени столбца, в противном случае по номеру.  
 Переменную типа Таблица можно заполнить с помощью действий: Взять таблицу(xml), Данные из таблицы и Область из таблицы(Excel), Получить(Outlook), Получить сообщение(Почта), Получить таблицу(Базы данных)

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

.. image:: images/scrin.png

Пример использования
----------------------
* `Пример описания схемы робота <https://confluence.itbs.it.ru/pages/viewpage.action?pageId=263719533>`_