• EN
    RU

excel/get_row

get_row(only_visible, path, sheet, row, use_value2=true)

Данная команда позволяет получить данные из строки excel-файла в виде массива. То есть данные из каждой ячейки строки будут являться значениями очередного элемента одномерного массива.

Команда на вход принимает параметры:
  • only_visible – получить только видимые ячейки
  • path – путь к файлу
  • sheet – номер листа
  • row – номер строки
  • use_value2 – в каком формате получать данные. При значении данного параметра true команда записывает в массив базовое значение ячейки (может быть пустым, строковым, ошибкой, числом (двойным) или логическим). При значении данного параметра false команда записывает в массив то же самое, за исключением того, что если ячейка была отформатирована как валюта или дата, она запишет как валюту VBA (которая может усекать десятичные разряды) или дату VBA. Использование use_value2=false обычно является плохой идеей, потому что вы можете не получить реальное значение из ячейки, плюс к этому команда работает медленнее. Подробнее: здесь

После отработки команда возвращает результат своей работы в робот:
  • массив в котором содержаться данные из ячеек строки





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

<?php $xhe_host = "127.0.0.1:7020";
 
// подключим объект для управления RPAbot, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excel->".basename(__FILE__)."</font><hr>";
 
$excel->kill();
$path = "test\\test.xlsx";
 
// 1 
echo("1. Получим значение каждой ячеки строки excel-файла в массив: ");
print_r($excel->get_row($path, 0, 1));
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>