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

sort_sheet

sort_sheet($path,$sheet,$cols,$is_ascending=true,$is_header_exists=false,$timeout=3000); - Сортировать Лист файла Excl по одному или нескольким столбцам

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

  • $path – Путь к файлу Excel
  • $sheet – Номер Листа для копирования
  • $cols – диапазон буквенных обозначений колонок с разделителем ';' или ','. Пример: "C,D"
  • $is_ascending – Восходящая сортировка Да/Нет
  • $is_header_exists – Существует ли заголовок Да/Нет. Выполнять сортировку с учетом наличия заголовков Колонок в первой строке Листа
  • $timeout – Таймаут ожидания выполнения операции, сек

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

    Пример использования
    <?php
    
    // Scenario: Sort sheets 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: Sort sheet by columns in descending order
    echo("\nExample 1: Sort sheet by columns in descending order : ");
    // Extract method arguments into variables
    $excelFilePath = "test/test.xlsx";
    $sheetNumber = 0;
    $columns = "C,D";
    $sortAscending = false;
    $result = SYSTEM::$excelfile->sort_sheet($excelFilePath, $sheetNumber, $columns, $sortAscending);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    // View the result
    WINDOW::$app->shell_execute("open", $excelFilePath);
    
    // End of script
    echo "\n";
    
    // Quit the application
    WINDOW::$app->quit();
    ?>
    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
    
    xhe_host = "127.0.0.1:7012"
    from xweb_human_emulator import *
    
    # начало
    echo("<hr><font color=blue>excelfile.set_sheet_name</font><hr>")
    
    excel.kill();
    
    # 1
    echo("1. Отсортируем лист по столбцам по убыванию : ");
    echo(excelfile.sort_sheet("test\\test.xlsx",0,"C,E",false));
    
    # посмотрим
    app.shell_execute("open","test\\test.xlsx");
    
    app.pause(0);
    excel.kill();
    
    # 2
    echo("\n2. Отсортируем лист по столбцам по с учетом заголовка : ");
    echo(excelfile.sort_sheet("test\\test.xlsx",0,"A",true,true));
    
    # посмотрим
    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.sort_sheet</font><hr>");
    
    			excel.kill();
    
    			// 1
    			echo("1. Отсортируем лист по столбцам по убыванию : ");
    			echo(excelfile.sort_sheet("test\\test.xlsx",0,"C,D",false));
    
    			// посмотрим
    			app.shell_execute("open","test\\test.xlsx");
    
    			app.pause(0);
    			excel.kill();
    
    			// 2
    			echo("\n2. Отсортируем лист по столбцам по с учетом заголовка : ");
    			echo(excelfile.sort_sheet("test\\test.xlsx",0,"C",true,true));
    
    			// посмотрим
    			app.shell_execute("open","test\\test.xlsx");
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7012";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excelfile.get_cell</font><hr>");
    
    excel.kill();
    
    // 1
    echo("1. Отсортируем лист по столбцам по убыванию : ");
    echo(excelfile.sort_sheet("test\\test.xlsx",0,"C,D",false));
    
    // посмотрим
    app.shell_execute("open","test\\test.xlsx");
    
    app.pause(0);
    excel.kill();
    
    // 2
    echo("\n2. Отсортируем лист по столбцам по с учетом заголовка : ");
    echo(excelfile.sort_sheet("test\\test.xlsx",0,"C",true,true));
    
    // посмотрим
    app.shell_execute("open","test\\test.xlsx");
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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