Справка Human Emulator excelfile: get_name_for_new

Интерфейс

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

get_name_for_new_sheet

get_name_for_new_sheet($path,$name); - Получить название для нового листа. Подбирается уникальное имя с учетом существующих названий Листов.

Если данному параметру присвоить значение "guid", то команда вернет статистически уникальный 128-битный идентификатор.

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

$path – Путь к файлу Excel

$name – Предполагаемое название нового листа

После выполнения функции возвращаемое значение будет равно одному из двух :

результат – название для нового Листа

пусто / null – ошибка

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

<?php

// Scenario: Get name for new sheet in 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);
}

echo "\n<span >excelfile->" . basename(__FILE__) . "</span>\n";

// Initialize Excel
SYSTEM::$excel->kill();

// Example 1: Get new sheet name with specified name
echo("Example 1: Get new sheet name with specified name : ");
// Extract method arguments into variables
$filePath = "test/test.xlsx";
$sheetName = "new sheet";
echo(SYSTEM::$excelfile->get_name_for_new_sheet($filePath, $sheetName) . "\n");

// Example 2: Get new sheet name with number
echo("\nExample 2: Get new sheet name with number : ");
// Extract method arguments into variables
$sheetName2 = "guid";
echo(SYSTEM::$excelfile->get_name_for_new_sheet($filePath, $sheetName2) . "\n");

// Example 3: Get new sheet name with special character replacement
echo("\nExample 3: Get new sheet name with special character replacement : ");
// Extract method arguments into variables
$sheetName3 = "\\new [sheet] ?/";
echo(SYSTEM::$excelfile->get_name_for_new_sheet($filePath, $sheetName3) . "\n");

// End of script
echo "\n";

// Quit application
WINDOW::$app->quit();
?>

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7026"
from xweb_human_emulator import *

# начало
echo("<hr><font color=blue>excelfile.set_cell</font><hr>")

# 1 
echo("\n1. Добавим ячейку в 8 ряд : ");
echo(excelfile.add_cell("test\\test.xlsx",0,8,"added new text"));

# 2
echo("\n2. Добавим ячейку в последний ряд : ");
echo(excelfile.add_cell("test\\test.xlsx",0,-1,"last row new text"));

# посмотрим
app.shell_execute("open","test\\test.xlsx");

# конец
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.set_cell</font><hr>");

			// 1 
			echo("1. Получим новое имя листа : ");
			echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","new sheet"));

			// 2
			echo("\n2. Получим новое имя листа с номером : ");
			echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","guid"));

			// 3 
			echo("\n3. Получим новое имя листа с заменой лишних симвовлов: ");
			echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","\\new [sheet] ?/"));

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

			app.quit();            
	  }
}

xhe_host="127.0.0.1:7040";
echo=require("../../../Templates JS/init.js");

// начало
echo("<hr><font color=blue>excelfile.get_cell</font><hr>");

// 1 
echo("1. Получим новое имя листа : ");
echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","new sheet"));

// 2
echo("\n2. Получим новое имя листа с номером : ");
echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","guid"));

// 3 
echo("\n3. Получим новое имя листа с заменой лишних симвовлов: ");
echo(excelfile.get_name_for_new_sheet("test\\test.xlsx","\\new [sheet] ?/"));

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

// Quit
app.quit();

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

Интерфейс

get_name_for_new_sheet

Функционал