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

sort_sheet

sort_sheet($path,$sheet,$col,$is_ascending=true,$is_header_exists=false,$timeout=3000); - Сортировать Лист файла Excel по столбцу

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

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

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

    Пример использования
    <?php
    // Scenario: Sort an Excel sheet by column or all columns
    $xhe_host = getenv("RPABOT_HOST_URL");
    // Connect functional objects if not already connected
    if (!isset($path)){
      $path = "../../../Templates/init.php";
      require($path);
    }
    
    // beginning
    echo "\n<span >excelfile->".basename (__FILE__)."</span>\n";
    
    // Kill existing Excel processes
    SYSTEM::$excel->kill();
    
    // Example 1: Open the Excel file
    // Set arguments as variables
    $filePath = "test/test.xlsx";
    $visible = false;
    $debug = true;
    
    echo("\n\n1. Open the Excel file: ");
    $result = SYSTEM::$excel->open($filePath, $visible, $debug);
    if ($result) {
        echo("Success - Excel file '$filePath' opened\n");
    } else {
        echo("Failed - Could not open Excel file '$filePath'\n");
    }
    
    // Example 2: Sort sheet by column in ascending order
    // Set arguments as variables
    $sheetIndex = 0;
    $sortColumn = "C"; // Column C
    $ascending = true;
    
    echo("\n2. Sort sheet by column in ascending order: ");
    $result = SYSTEM::$excel->sort_sheet($filePath, $sheetIndex, $sortColumn, $ascending);
    if ($result) {
        echo("Success - Sheet sorted by column '$sortColumn' in ascending order\n");
    } else {
        echo("Failed - Could not sort sheet by column '$sortColumn' in ascending order\n");
    }
    
    // Example 3: Sort sheet by all columns in descending order
    // Set arguments as variables
    $sortColumnAll = "3"; // Column 3 (same as C)
    $ascending = false;
    
    echo("\n3. Sort sheet by all columns in descending order: ");
    $result = SYSTEM::$excel->sort_sheet($filePath, $sheetIndex, $sortColumnAll, $ascending);
    if ($result) {
        echo("Success - Sheet sorted by all columns in descending order\n");
    } else {
        echo("Failed - Could not sort sheet by all columns in descending order\n");
    }
    
    // Close the Excel file
    echo("\n4. Close the Excel file: ");
    $result = SYSTEM::$excel->close($filePath);
    if ($result) {
        echo("Success - Excel file '$filePath' closed\n");
    } else {
        echo("Failed - Could not close Excel file '$filePath'\n");
    }
    
    // end
    echo "\n";
    
    // Quit
    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>")
    
    # откроем
    path="test/test.xlsx";
    excel.kill();
    excel.open(path,false,true);
    
    # 1
    echo("1. Отсортируем лист по столбцу по возрастанию : ");
    echo(excel.sort_sheet("test/test.xlsx",0,"C",true));
    
    app.pause(0);
    
    # 2
    echo("\n2. Отсортируем лист по столбцу по убыванию: ");
    echo(excel.sort_sheet("test/test.xlsx",0,"C",false));
    
    app.pause(0);
    
    # закроем
    excel.close(path);
    
    # конец
    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_sheet_name</font><hr>");
    
    			// откроем
    			var path="test/test.xlsx";
    			excel.kill();
    			excel.open(path,false,true);
    
    			// 1
    			echo("1. Отсортируем лист по столбцу по возрастанию : ");
    			echo(excel.sort_sheet("test/test.xlsx",0,"C",true));
    
    			app.pause(0);
    
    			// 2
    			echo("\n2. Отсортируем лист по столбцу по убыванию: ");
    			echo(excel.sort_sheet("test/test.xlsx",0,"C",false));
    
    			app.pause(0);
    
    			// закроем
    			excel.close(path);
    
    			// конец
    			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>");
    
    // откроем
    var path="test/test.xlsx";
    excel.kill();
    excel.open(path,false,true);
    
    // 1
    echo("1. Отсортируем лист по столбцу по возрастанию : ");
    echo(excel.sort_sheet("test/test.xlsx",0,3,true));
    
    app.pause(0);
    
    // 2
    echo("\n2. Отсортируем лист по столбцу по убыванию: ");
    echo(excel.sort_sheet("test/test.xlsx",0,3,false));
    
    app.pause(0);
    
    // сохраним
    excel.save(path);
    
    // закроем
    excel.close(path);
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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