humanemulator.net — справка. Продукт, демо и покупка — на хуманэмулятор.рф | Демо | Купить | API | Changelog

get_row

get_row($path,$sheet,$row,$use_value2=true,$only_visible=false); - Получить строку как массив

Функция на вход принимает параметры:

  • $path – Путь к файлу Excel
  • $sheet – Номер Листа (отсчет от 0)
  • $row – Номер строки
  • $use_value2 – Получить значение ячеек, как вариант 2 (без учета значка валюты или варианта написания даты)? Да/Нет
  • $only_visible – Использовать значения только видимых ячеек? Да/Нет

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • результат – Значения строки в виде массива или NULL
  • пусто / null – ошибка

    Пример использования
    <?php 
    // Scenario: Demonstrates how to get the content of a specific row in an Excel sheet
    
    $xhe_host = getenv("RPABOT_HOST_URL");
    // Connect functional objects if not already connected
    if (!isset($path)){
        // Path to the init.php file for connecting to the XHE API
        $path = "../../../Templates/init.php";
        // Including init.php grants access to all classes and functionality for working with the XHE API
        require($path);
    }
    
    // Set variables for method arguments
    $filePath = "test/test.xlsx";
    $sheetIndex = 0;
    $rowNumber1 = 1;
    $rowNumber2 = 2;
    $rowNumber3 = 3;
    
    // Kill any existing Excel processes
    SYSTEM::$excel->kill();
    
    // Example 1: Get row #1
    echo("\nExample 1: Get row #$rowNumber1\n");
    $rowData1 = SYSTEM::$excel->get_row($filePath, $sheetIndex, $rowNumber1);
    if ($rowData1 !== null) {
        echo("Successfully retrieved row #$rowNumber1\n");
        echo("Row content:\n");
        var_export($rowData1);
    } else {
        echo("Failed to get row #$rowNumber1\n");
    }
    
    // Example 2: Get row #2
    echo("\nExample 2: Get row #$rowNumber2\n");
    $rowData2 = SYSTEM::$excel->get_row($filePath, $sheetIndex, $rowNumber2);
    if ($rowData2 !== null) {
        echo("Successfully retrieved row #$rowNumber2\n");
        echo("Row content:\n");
        var_export($rowData2);
    } else {
        echo("Failed to get row #$rowNumber2\n");
    }
    
    // Example 3: Get row #3
    echo("\nExample 3: Get row #$rowNumber3\n");
    $rowData3 = SYSTEM::$excel->get_row($filePath, $sheetIndex, $rowNumber3);
    if ($rowData3 !== null) {
        echo("Successfully retrieved row #$rowNumber3\n");
        echo("Row content:\n");
        var_export($rowData3);
    } else {
        echo("Failed to get row #$rowNumber3\n");
    }
    
    // Quit the application
    WINDOW::$app->quit();
    ?>
    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
    
    xhe_host = "127.0.0.1:7010"
    from xweb_human_emulator import *
    
    # начало
    echo("<hr><font color=blue>excel.get_row</font><hr>")
    
    path="test\\test.xlsx"
    
     # Закрыть все процессы Excel
    excel.kill()
    # откроем
    #excel.open(path,false,true)
    #sleep(2)
    
    # 1 
    echo("\n1. Получим первую строку : ")
    echo(excel.get_row("test\\test.xlsx",0, 1))
    
    # закроем
    #sleep(5)
    #excel.close(path)
    
    # конец
    echo("<hr><br>")
    #region using
    
    using System;
    using System.Diagnostics;
    using System.Collections.Generic;
    using System.Linq;
    using System.IO;
    using System.Text;
    using System.Threading;
    
    using XHE;
    using XHE.XHE_DOM;
    using XHE.XHE_System;
    using XHE.XHE_Window;
    using XHE.XHE_Web;
    
    #endregion
    
     class Program:XHEScript
     {
    	  static void Main(string[] args)
    	  {
    			// init XHE
    			server = Environment.GetEnvironmentVariable("RPABOT_HOST_URL");
    			InitXHE();
    
    			// начало
    			echo("<hr><font color=blue>excelfile.get_cell</font><hr>");
    
    			// откроем
    			excel.kill();
    			var path="test\\test.xlsx";
    			excel.open(path,false,true);
    			sleep(4);
    
    			// 1 
    			echo("\n1. Получим строку : ");
    			echo(excel.get_row("test\\test.xlsx",0,1));
    
    			// закроем
    			sleep(5);
    			excel.close(path);
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7010";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excel.get_row</font><hr>");
    
    // Закрыть все процессы Excel
    excel.kill();
    var path="test\\test.xlsx";
    
    // 1 
    echo("\n1. Получим строку : ");
    console.log(excel.get_row("test\\test.xlsx",0,1));
    
    /*
    // откроем
    excel.open(path,false,true);
    
    // закроем
    app.sleep(50);
    excel.close(path);
    */
    // конец
    echo("\n");
    
    // Quit
    app.quit();

    =============================================
    excel    Объекты    DOM  System  Vision  Web  Window        
    =============================================
    если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум
    .