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

convert

convert($inpath,$outpath,$timeout=3000,$delimeter=""); - Конвертировать файл в другой формат. Формат конвертации определяется по расширению файлов.

Варианты расширения результирующего файла 'xlsx','xls','csv','txt','html','pdf','xps' (требует чтобы был установлен Excel не ниже 15 версии на компьютере)

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

  • $inpath – путь к исходному файлу для конвертирования
  • $outpath – путь к итоговому файлу для конвертирования.
  • $timeout – Таймаут ожидания выполнения операции, сек
  • $delimeter – Разделитель. Если входной файл в формате CSV

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

    Пример использования
    <?php 
    // Scenario: Demonstrates how to convert Excel files between different formats
    
    $xhe_host = "localhost:7010";
    // 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);
    }
    
    // Kill any existing Excel processes
    SYSTEM::$excel->kill();
    
    // Example 1: Convert xlsx to xls
    echo("\nExample 1: Convert xlsx to xls\n");
    
    // Set variables for method arguments
    $sourceFile1 = "test/test_to_convert.xls";
    $targetFile1 = "test/test_from_xlsx.xls";
    
    // Convert xlsx to xls
    $result = SYSTEM::$excel->convert($sourceFile1, $targetFile1);
    if ($result) {
        echo("Successfully converted $sourceFile1 to $targetFile1\n");
    } else {
        echo("Failed to convert $sourceFile1 to $targetFile1\n");
    }
    
    // Example 2: Convert xls to xlsx
    echo("\nExample 2: Convert xls to xlsx\n");
    
    // Set variables for method arguments
    $sourceFile2 = "test/test_from_xlsx.xls";
    $targetFile2 = "test/test_from_xls.xlsx";
    
    // Convert xls to xlsx
    $result = SYSTEM::$excel->convert($sourceFile2, $targetFile2);
    if ($result) {
        echo("Successfully converted $sourceFile2 to $targetFile2\n");
    } else {
        echo("Failed to convert $sourceFile2 to $targetFile2\n");
    }
    
    // Example 3: Convert xlsx to csv (comma delimiter not used)
    echo("\nExample 3: Convert xlsx to csv (comma delimiter not used)\n");
    
    // Set variables for method arguments
    $sourceFile3 = "test/test_to_convert.xlsx";
    $targetFile3 = "test/test_from_xlsx.csv";
    
    // Convert xlsx to csv
    $result = SYSTEM::$excel->convert($sourceFile3, $targetFile3);
    if ($result) {
        echo("Successfully converted $sourceFile3 to $targetFile3\n");
    } else {
        echo("Failed to convert $sourceFile3 to $targetFile3\n");
    }
    
    // Example 4: Convert xlsx to txt (tab delimiter not used)
    echo("\nExample 4: Convert xlsx to txt (tab delimiter not used)\n");
    
    // Set variables for method arguments
    $sourceFile4 = "test/test_to_convert.xlsx";
    $targetFile4 = "test/test_from_xlsx.txt";
    
    // Convert xlsx to txt
    $result = SYSTEM::$excel->convert($sourceFile4, $targetFile4);
    if ($result) {
        echo("Successfully converted $sourceFile4 to $targetFile4\n");
    } else {
        echo("Failed to convert $sourceFile4 to $targetFile4\n");
    }
    
    // Example 5: Convert xlsx to html
    echo("\nExample 5: Convert xlsx to html\n");
    
    // Set variables for method arguments
    $sourceFile5 = "test/test_to_convert.xlsx";
    $targetFile5 = "test/test_from_xlsx.html";
    
    // Convert xlsx to html
    $result = SYSTEM::$excel->convert($sourceFile5, $targetFile5);
    if ($result) {
        echo("Successfully converted $sourceFile5 to $targetFile5\n");
    } else {
        echo("Failed to convert $sourceFile5 to $targetFile5\n");
    }
    
    // Example 6: Convert csv to xlsx with comma delimiter
    echo("\nExample 6: Convert csv to xlsx with comma delimiter\n");
    
    // Set variables for method arguments
    $sourceFile6 = "test/test_to_convert_comma.csv";
    $targetFile6 = "test/test_from_comma_csv.xlsx";
    $maxRows6 = 3000;
    $delimiter6 = ",";
    
    // Convert csv to xlsx with comma delimiter
    $result = SYSTEM::$excel->convert($sourceFile6, $targetFile6, $maxRows6, $delimiter6);
    if ($result) {
        echo("Successfully converted $sourceFile6 to $targetFile6 with comma delimiter\n");
    } else {
        echo("Failed to convert $sourceFile6 to $targetFile6 with comma delimiter\n");
    }
    
    // Example 7: Convert csv to xlsx with semicolon delimiter
    echo("\nExample 7: Convert csv to xlsx with semicolon delimiter\n");
    
    // Set variables for method arguments
    $sourceFile7 = "test/test_to_convert_semicolon.csv";
    $targetFile7 = "test/test_from_semicolon_csv.xlsx";
    $maxRows7 = 3000;
    $delimiter7 = ";";
    
    // Convert csv to xlsx with semicolon delimiter
    $result = SYSTEM::$excel->convert($sourceFile7, $targetFile7, $maxRows7, $delimiter7);
    if ($result) {
        echo("Successfully converted $sourceFile7 to $targetFile7 with semicolon delimiter\n");
    } else {
        echo("Failed to convert $sourceFile7 to $targetFile7 with semicolon delimiter\n");
    }
    
    // Quit the application
    WINDOW::$app->quit();
    ?>
    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
    
    xhe_host = "127.0.0.1:7022"
    from xweb_human_emulator import *
    
    # начало
    echo("<hr><font color=blue>excelfile.set_sheet_name</font><hr>")
    
    # 1
    echo("1. Конвертнем xlsx->xsl: ")
    echo(excel.convert("test\\test_to_convert.xls", "test\\test_from_xlsx.xls") . "\n")
    
    # 2
    echo("n2. Конвертнем xls->xslx: ")
    echo(excel.convert("test\\test_from_xlsx.xls", "test\\test_from_xls.xlsx") . "\n")
    
    # 3 Разделитель запятая (аргумент delimiter не используется)
    echo("3. Конвертнем xlsx->csv: ")
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.csv") . "\n")
    
    # 4 разделитель табуляция (аргумент delimiter не используется)
    echo("4. Конвертнем xlsx->txt: ")
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.txt") . "\n")
    
    # 5
    echo("5. Конвертнем xlsx->html: ")
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.html") . "\n")
    
    # 6 Разделитель запятая
    echo("5. Конвертнем csv->html разделитель запятая (,): ")
    echo(excel.convert("test\\test_to_convert_comma.csv", "test\\test_from_comma_csv.xlsx", 3000, ",") . "\n")
    
    # 7 Разделитель точка с запятой
    echo("7. Конвертнем csv->html разделитель точка с запятой (): ")
    echo(excel.convert("test\\test_to_convert_semicolon.csv", "test\\test_from_semicolon_csv.xlsx", 3000, "") . "\n")
    
    
    # конец
    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 = "localhost:7010";
    			InitXHE();
    
    			// начало
    			echo("<hr><font color=blue>excelfile.convert</font><hr>");
    
                // 1 
                echo("1. Конвертнем xlsx->xsl: ");
                echo(excel.convert("test\\test_to_convert.xls", "test\\test_from_xlsx.xls") + "\n");
    
                // 2
                echo("n2. Конвертнем xls->xslx: ");
                echo(excel.convert("test\\test_from_xlsx.xls", "test\\test_from_xls.xlsx") + "\n");
    
                // 3 Разделитель запятая (аргумент delimiter не используется)
                echo("3. Конвертнем xlsx->csv: ");
                echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.csv") + "\n");
    
                // 4 разделитель табуляция (аргумент delimiter не используется)
                echo("4. Конвертнем xlsx->txt: ");
                echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.txt") + "\n");
    
                // 5
                echo("5. Конвертнем xlsx->html: ");
                echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.html") + "\n");
    
                // 6 Разделитель запятая
                echo("5. Конвертнем csv->html разделитель запятая (,): ");
                echo(excel.convert("test\\test_to_convert_comma.csv", "test\\test_from_comma_csv.xlsx", 3000, ",") + "\n");
    
                // 7 Разделитель точка с запятой
                echo("7. Конвертнем csv->html разделитель точка с запятой (;): ");
                echo(excel.convert("test\\test_to_convert_semicolon.csv", "test\\test_from_semicolon_csv.xlsx", 3000, ";") + "\n");
    
            // конец
            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_cell</font><hr>");
    
    // 1
    echo("1. Конвертнем xlsx->xsl: ");
    echo(excel.convert("test\\test_to_convert.xls", "test\\test_from_xlsx.xls") + "\n");
    
    // 2
    echo("n2. Конвертнем xls->xslx: ");
    echo(excel.convert("test\\test_from_xlsx.xls", "test\\test_from_xls.xlsx") + "\n");
    
    // 3 Разделитель запятая (аргумент delimiter не используется)
    echo("3. Конвертнем xlsx->csv: ");
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.csv") + "\n");
    
    // 4 разделитель табуляция (аргумент delimiter не используется)
    echo("4. Конвертнем xlsx->txt: ");
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.txt") + "\n");
    
    // 5
    echo("5. Конвертнем xlsx->html: ");
    echo(excel.convert("test\\test_to_convert.xlsx", "test\\test_from_xlsx.html") + "\n");
    
    // 6 Разделитель запятая
    echo("5. Конвертнем csv->html разделитель запятая (,): ");
    echo(excel.convert("test\\test_to_convert_comma.csv", "test\\test_from_comma_csv.xlsx", 3000, ",") + "\n");
    
    // 7 Разделитель точка с запятой
    echo("7. Конвертнем csv->html разделитель точка с запятой (;): ");
    echo(excel.convert("test\\test_to_convert_semicolon.csv", "test\\test_from_semicolon_csv.xlsx", 3000, ";") + "\n");
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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