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

get_all_pos_by_text

get_all_pos_by_text($path,$sheet,$text,$exactly=true,$is_match_case=true,$col="",$timeout=3000); - Получить позицию всех ячеек с заданным текстом

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

  • $path – Путь к исходному файлу Excel
  • $sheet – Номер Листа
  • $text – текст для поиска
  • $exactly – точное соответствие текста?
  • $is_match_case – Учитывать регистр символов
  • $col – Колонка. Буквенное значение позиции колонки. Пример: "D". Если значение пустое, то поиск производится для всех колонок.
  • $timeout – Таймаут ожидания выполнения операции, сек

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

    Пример использования
    <?php 
    // Scenario: Demonstrates how to get all cell positions containing specified text in an Excel file
    
    $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;
    $searchText1 = "new";
    $searchText2 = "Aafsdas";
    $searchText3 = "A?";
    $column = "A";
    
    // Kill any existing Excel processes
    SYSTEM::$excel->kill();
    
    // Open the Excel file
    SYSTEM::$excel->open($filePath, false, true);
    
    // Example 1: Get positions of cells with specified text
    echo("\nExample 1: Get positions of cells with specified text\n");
    $positions = SYSTEM::$excel->get_all_pos_by_text($filePath, $sheetIndex, $searchText1, false);
    if ($positions) {
        echo("Found positions for text '$searchText1':\n");
        var_export($positions);
    } else {
        echo("No positions found for text '$searchText1'\n");
    }
    
    // Example 2: Get positions of cells with non-existent text
    echo("\nExample 2: Get positions of cells with non-existent text\n");
    $positions = SYSTEM::$excel->get_all_pos_by_text($filePath, $sheetIndex, $searchText2, false);
    if ($positions) {
        echo("Found positions for text '$searchText2':\n");
        var_export($positions);
    } else {
        echo("No positions found for text '$searchText2'\n");
    }
    
    // Example 3: Get positions of cells with specified text in a specific column
    echo("\nExample 3: Get positions of cells with specified text in a specific column\n");
    $positions = SYSTEM::$excel->get_all_pos_by_text($filePath, $sheetIndex, $searchText3, false, false, $column);
    if ($positions) {
        echo("Found positions for text '$searchText3' in column '$column':\n");
        var_export($positions);
    } else {
        echo("No positions found for text '$searchText3' in column '$column'\n");
    }
    
    // Close the Excel file
    SYSTEM::$excel->close($filePath);
    
    // 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>excelfile.get_rows_count</font><hr>")
    
    excel.kill();
    excel.open("test\\test.xlsx",false,true);
    
    # 1 
    echo("\n1. Получим позиции ячеек с заданным текстом: ");
    poss=excel.get_all_pos_by_text("test\\test.xlsx",0,"new",False);
    for i in range(0, len(poss) ):
    	echo(poss[i]," ");
    
    # 2
    echo("\n2. Получим позиции ячеек с несуществующим текстом: ");
    echo(excel.get_all_pos_by_text("test\\test.xlsx",0,"Aффф",False));
    
    # 3 
    echo("\n3. Получим позиции ячеек с заданным текстом в заданом столбце :  ");
    poss=excel.get_all_pos_by_text("test\\test.xlsx",0,"new",False,False,"B");
    for i in range(0, len(poss) ):
    	echo(poss[i]," ");
    
    # конец
    echo("<hr><br>")
    
    # Quit
    app.quit()
    #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_sheet_number_by_name</font><hr>");
    
    			// 1 
    			echo("\n1. Получим позиции ячеек с заданным текстом: ");
    			excel.get_all_pos_by_text("test\\test.xlsx",0,"new",false).ForEach(Console.WriteLine);
    
    			// 2
    			echo("\n2. Получим позиции ячеек с несуществующим текстом: ");
    			excel.get_all_pos_by_text("test\\test.xlsx",0,"Aффф",false).ForEach(Console.WriteLine);
    
    			// 3 
    			echo("\n\n3. Получим позиции ячеек с заданным текстом в заданом столбце :  ");
    			excel.get_all_pos_by_text("test\\test.xlsx",0,"new",false,false,"C").ForEach(Console.WriteLine);
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7010";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excelfile.get_rows_count</font><hr>");
    
    // 1 
    echo("\n1. Получим позиции ячеек с заданным текстом: ");
    console.log(excel.get_all_pos_by_text("test\\test.xlsx",0,"new",false));
    
    // 2
    echo("\n2. Получим позиции ячеек с несуществующим текстом: ");
    console.log(excel.get_all_pos_by_text("test\\test.xlsx",0,"Aффф",false));
    
    // 3 
    echo("\n3. Получим позиции ячеек с заданным текстом в заданом столбце :  ");
    console.log(excel.get_all_pos_by_text("test\\test.xlsx",0,"new",false,false,"D"));
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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