Справка Human Emulator excel: get_pos_by

Интерфейс

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

get_pos_by_text

get_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 find the position of a cell containing specific text 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 = 1;
$searchText1 = "1";
$searchText2 = "1";
$specificColumn = "D";

// Kill any existing Excel processes
SYSTEM::$excel->kill();

// Open the Excel file
SYSTEM::$excel->open($filePath, false, true);

// Example 1: Get position of cell with specific text
echo("\nExample 1: Get position of cell with specific text\n");
$position1 = SYSTEM::$excel->get_pos_by_text($filePath, $sheetIndex, $searchText1, false);
if ($position1 !== null) {
    echo("Found text '$searchText1' at position: ");
    var_export($position1);
} else {
    echo("Text '$searchText1' not found in sheet #$sheetIndex\n");
}

// Example 2: Get position of cell with specific text in a specific column
echo("\nExample 2: Get position of cell with specific text in a specific column\n");
$position2 = SYSTEM::$excel->get_pos_by_text($filePath, $sheetIndex, $searchText2, false, false, $specificColumn);
if ($position2 !== null) {
    echo("Found text '$searchText2' in column $specificColumn at position: ");
    var_export($position2);
} else {
    echo("Text '$searchText2' not found in column $specificColumn of sheet #$sheetIndex\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. Получим позицию ячейки с заданным текстом: ");
print(excel.get_pos_by_text("test\\test.xlsx",0,"new",false));

# 2
echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
echo(excel.get_pos_by_text("test\\test.xlsx",0,"new",false,false,"D"));

# конец
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. Получим позицию ячейки с заданным текстом: ");
			echo(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false).ToString());

			// 2
			echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
			echo(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false,"D").ToString());

			// конец
			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_pos_by_text("test\\test.xlsx",0,"new",false));

// 2
echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
console.log(excel.get_pos_by_text("test\\test.xlsx",0,"new",false,false,"D"));

// конец
echo("\n");

// Quit
app.quit();

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

Интерфейс

get_pos_by_text

Функционал