Чтение из ячейки

Read cell

Элемент считывает данные из ячейки Excel и сохраняет их в переменную.

Путь до файла, тип драйвера и другие базовые настройки указываются в контейнере Приложение Excel.

🔹 Совет. Если вам нужно прочитать формулу, воспользуйтесь элементом Чтение формулы из ячейки.

Свойства

Символ * в названии свойства указывает на обязательность его заполнения. Описание общих свойств см. в разделе Свойства элемента.

Свойство	Тип	Описание	Пример
Excel:
Ячейка*	String	Идентификатор ячейки, которую нужно прочитать	"A4"
Страница	String	Название страницы с указанной ячейкой	"Лист1"
Индекс страницы	Int32	Порядковый номер страницы	0
Вывод:
Данные*	Object	Название переменной для записи полученных данных из ячейки

Пример заполненных свойств:

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

RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning.

1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.

2. Распакуйте архив и откройте в Студии проект WorkWithExcelExample. Для процессов выбран тип Последовательность.

Только код

Ниже приведен пример использования элемента в процессе с типом Только код (Pure code):

C#

//app - [LTools.Office.ExcelApp] Приложение Excel
//cell - Ячейка: [String] Идентификатор ячейки (A4)
//data - Данные: [Object] Данные, полученные из ячейки
//sheet - Страница: [String] Наименование страницы
//sheetIdx - Индекс страницы: [Int32] Индекс страницы
//object data = app.ReadCell(cell, [sheet], [sheetIdx]);

LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, ".\\file.xlsx", ";", LTools.Office.Model.InteropTypes.DX);
object data = app.ReadCell("C5", "Лист1", 0);
		
//Вывод в лог
LTools.Workflow.PrimoApp.AddToLog(wf, data.ToString(), LTools.Enums.LogMessageType.Info);

Python

#app - [LTools.Office.ExcelApp] Приложение Excel
#cell - Ячейка: [String] Идентификатор ячейки (A4)
#data - Данные: [Object] Данные, полученные из ячейки
#sheet - Страница: [String] Наименование страницы
#sheetIdx - Индекс страницы: [Int32] Индекс страницы
#data = app.ReadCell(cell, [sheet], [sheetIdx]) #Object

app = LTools.Office.ExcelApp.Init(wf, ".\\file.xlsx", ";", LTools.Office.Model.InteropTypes.DX)
data = app.ReadCell("F4", "Лист1", 0) #Object
		
#Вывод в лог
LTools.Workflow.PrimoApp.AddToLog(wf, str(data), LTools.Enums.LogMessageType.Info)

JavaScript

//app - [LTools.Office.ExcelApp] Приложение Excel
//cell - Ячейка: [String] Идентификатор ячейки (A4)
//data - Данные: [Object] Данные, полученные из ячейки
//sheet - Страница: [String] Наименование страницы
//sheetIdx - Индекс страницы: [Int32] Индекс страницы
//var data = app.ReadCell(cell, [sheet], [sheetIdx]); //Object

let app = _lib.LTools.Office.ExcelApp.Init(wf, ".\\file.xlsx", ";", _lib.LTools.Office.Model.InteropTypes.DX);	
var data = app.ReadCell("D5", "Лист1", 0); //Object
		
//Вывод в лог
_lib.LTools.Workflow.PrimoApp.AddToLog(wf, data.toString(), _lib.LTools.Enums.LogMessageType.Info);