LibreOffice_Calc plugin

Плагин для работы с ячейками, строками и столбцами в LibreOffice Calc.

Версия: 2.1

Дата релиза: 21 ноября 2022

Список методов плагина

get_cell

Получить значение ячейки

get_cell(string path, int row, int col)
path Путь к файлу
row Номер строки
col Номер столбца

Описание возврата: Возвращает текст ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_cell');

// Создать и получить путь к тестовому файлу
$filePath = $test->get_test_file_full_path('SampleData.ods');

// 1
echo "1. Получить значение ячейки [2,3]: \n";
echo $libreoffice_calc->get_cell($filePath, 2, 3)."\n";

// 2
echo "\n2. Получить значение ячейки [5,1]: \n";
echo $libreoffice_calc->get_cell($filePath, 5, 1)."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_cell')

// Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

// 1
echo("1. Получить значение ячейки [2,3]: \n")
echo(`${libreoffice_calc.get_cell(filePath, 2, 3)}\n`)

// 2
echo("\n2. Получить значение ячейки [5,1]: \n")
echo(`${libreoffice_calc.get_cell(filePath, 5, 1)}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_cell')

# Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

# 1
print("1. Получить значение ячейки [2,3]: ")
print(libreoffice_calc.get_cell(filePath, 2, 3))

# 2
print("\n2. Получить значение ячейки [5,1]: ")
print(libreoffice_calc.get_cell(filePath, 5, 1))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_cell_by_table

Получить значение ячейки с указанием таблицы

get_cell_by_table(string path, int row, int col, string table_name)
path Путь к файлу
row Номер строки
col Номер столбца
table_name Название таблицы в документе

Описание возврата: Возвращает текст ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_cell_by_table');

// Создать и получить путь к тестовому файлу
$filePath = $test->get_test_file_full_path('SampleData.ods');

// 1
echo "1. Получить значение ячейки [2,3] в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table($filePath, 2, 3, "Oscar Ages")."\n";

// 2
echo "\n2. Получить значение ячейки [5,1] в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table($filePath, 5, 1, "Oscar Ages")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_cell_by_table')

// Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

// 1
echo("1. Получить значение ячейки [2,3] в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages")}\n`)

// 2
echo("\n2. Получить значение ячейки [5,1] в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table(filePath, 5, 1, "Oscar Ages")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_cell_by_table')

# Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

# 1
print("1. Получить значение ячейки [2,3] в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages"))

# 2
print("\n2. Получить значение ячейки [5,1] в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table(filePath, 5, 1, "Oscar Ages"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_cell_by_position

Получить значение ячейки используя название позиции ячейки

get_cell_by_position(string path, string cell_position)
path Путь к файлу
cell_position Позиция ячейки (пример - A20)

Описание возврата: Возвращает текст ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_cell_by_position');

// Создать и получить путь к тестовому файлу
$filePath = $test->get_test_file_full_path('SampleData.ods');

// 1
echo "1. Получить значение ячейки B5: \n";
echo $libreoffice_calc->get_cell_by_position($filePath, "B5")."\n";

// 2
echo "\n2. Получить значение ячейки C3: \n";
echo $libreoffice_calc->get_cell_by_position($filePath, "C3")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_cell_by_position')

// Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

// 1
echo("1. Получить значение ячейки B5: \n")
echo(`${libreoffice_calc.get_cell_by_position(filePath, "B5")}\n`)

// 2
echo("\n2. Получить значение ячейки C3: \n")
echo(`${libreoffice_calc.get_cell_by_position(filePath, "C3")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_cell_by_position')

# Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

# 1
print("1. Получить значение ячейки B5: ")
print(libreoffice_calc.get_cell_by_position(filePath, "B5"))

# 2
print("\n2. Получить значение ячейки C3: ")
print(libreoffice_calc.get_cell_by_position(filePath, "C3"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_cell_by_table_and_position

Получить значение ячейки используя позицию ячейки и название таблицы

get_cell_by_table_and_position(string path, string table_name, string cell_position)
path Путь к файлу
table_name Название таблицы в документе
cell_position Позиция ячейки (пример - A20)

Описание возврата: Возвращает текст ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_cell_by_table_and_position');

// Создать и получить путь к тестовому файлу
$filePath = $test->get_test_file_full_path('SampleData.ods');

// 1
echo "1. Получить значение ячейки B5 в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table_and_position($filePath, "Oscar Ages", "B5")."\n";

// 2
echo "\n2. Получить значение ячейки C3 в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table_and_position($filePath, "Oscar Ages", "C3")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_cell_by_table_and_position')

// Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

// 1
echo("1. Получить значение ячейки B5 в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B5")}\n`)

// 2
echo("\n2. Получить значение ячейки C3 в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "C3")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_cell_by_table_and_position')

# Создать и получить путь к тестовому файлу
filePath = test.get_test_file_full_path('SampleData.ods')

# 1
print("1. Получить значение ячейки B5 в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B5"))

# 2
print("\n2. Получить значение ячейки C3 в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "C3"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_cell_color

Установить фон/цвет текста в ячейке

set_cell_color(string path, int row, int col, string foreground_color, string background_color)
path Путь к файлу
row Номер строки
col Номер столбца
foreground_color Цвет текста
background_color Цвет фона

Цвет ячейки устанавливается как в CSS, используя HEX-code (пример, #FF0000).

Описание возврата: Возвращает логическое значение true в случае успешного форматирования ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_cell_color');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Установить шрифт оранжевый, фон зеленый для ячейки [2,3]: \n";
$res1 = $libreoffice_calc->set_cell_color($filePath, 2, 3, "#e75322", "#22e74a");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//2
echo "\n2. Установить шрифт оранжевый, фон синий для ячейки [5,1]: \n";
$res2 = $libreoffice_calc->set_cell_color($filePath, 5, 1, "#e75322", "#227ee7");
$res2 = $res2 ? 'true' : 'false';
echo $res2."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_cell_color')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Установить шрифт оранжевый, фон зеленый для ячейки [2,3]: \n")
res1 = libreoffice_calc.set_cell_color(filePath, 2, 3, "#e75322", "#22e74a")
echo(`${res1}\n`)

//2
echo("\n2. Установить шрифт оранжевый, фон синий для ячейки [5,1]: \n")
res2 = libreoffice_calc.set_cell_color(filePath, 5, 1, "#e75322", "#227ee7")
echo(`${res2}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_cell_color')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Установить шрифт оранжевый, фон зеленый для ячейки [2,3]: ")
res1 = libreoffice_calc.set_cell_color(filePath, 2, 3, "#e75322", "#22e74a")
print(res1)

#2
print("\n2. Установить шрифт оранжевый, фон синий для ячейки [5,1]: ")
res2 = libreoffice_calc.set_cell_color(filePath, 5, 1, "#e75322", "#227ee7")
print(res2)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_cell_color_by_table

Установить фон/цвет текста в ячейке с указанием таблицы

set_cell_color_by_table(string path, int row, int col, string table_name, string foreground_color, string background_color)
path Путь к файлу
row Номер строки
col Номер столбца
table_name Название таблицы в документе
foreground_color Цвет текста
background_color Цвет фона

Цвет ячейки устанавливается как в CSS, используя HEX-code (пример, #FF0000).

Описание возврата: Возвращает логическое значение true в случае успешного форматирования ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_cell_color_by_table');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Установить шрифт оранжевый, фон зеленый ячейки [2,3] в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->set_cell_color_by_table($filePath, 2, 3, "Oscar Ages", "#e75322", "#22e74a");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//2
echo "\n2. Установить шрифт оранжевый, фон синий ячейки  [5,1] в таблице Oscar Ages:  \n";
$res1 = $libreoffice_calc->set_cell_color_by_table($filePath, 5, 1, "Oscar Ages", "#e75322", "#227ee7");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_cell_color_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Установить шрифт оранжевый, фон зеленый ячейки [2,3] в таблице Oscar Ages: \n")
res1 = libreoffice_calc.set_cell_color_by_table(filePath, 2, 3, "Oscar Ages", "#e75322", "#22e74a")
echo(`${res1}\n`)

//2
echo("\n2. Установить шрифт оранжевый, фон синий ячейки  [5,1] в таблице Oscar Ages:  \n")
res1 = libreoffice_calc.set_cell_color_by_table(filePath, 5, 1, "Oscar Ages", "#e75322", "#227ee7")
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_cell_color_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Установить шрифт оранжевый, фон зеленый ячейки [2,3] в таблице Oscar Ages: ")
res1 = libreoffice_calc.set_cell_color_by_table(filePath, 2, 3, "Oscar Ages", "#e75322", "#22e74a")
print(res1)

#2
print("\n2. Установить шрифт оранжевый, фон синий ячейки  [5,1] в таблице Oscar Ages:  ")
res1 = libreoffice_calc.set_cell_color_by_table(filePath, 5, 1, "Oscar Ages", "#e75322", "#227ee7")
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_cell_color_by_position

Установить фон/цвет текста в ячейке используя название позиции ячейки

set_cell_color_by_position(string path, string cell_position, string foreground_color, string background_color)
path Путь к файлу
cell_position Позиция ячейки (пример - A20)
foreground_color Цвет текста
background_color Цвет фона

Цвет ячейки устанавливается как в CSS, используя HEX-code (пример, #FF0000).

Описание возврата: Возвращает логическое значение true в случае успешного форматирования ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_cell_color_by_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Установить шрифт оранжевый, фон зеленый ячейки B4 \n";
$res1 = $libreoffice_calc->set_cell_color_by_position($filePath, "B4", "#e75322", "#22e74a");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//2
echo "\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  \n";
$res2 = $libreoffice_calc->set_cell_color_by_position($filePath, "C5", "#e75322", "#227ee7");
$res2 = $res2 ? 'true' : 'false';
echo $res2."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_cell_color_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Установить шрифт оранжевый, фон зеленый ячейки B4 \n")
res1 = libreoffice_calc.set_cell_color_by_position(filePath, "B4", "#e75322", "#22e74a")
echo(`${res1}\n`)

//2
echo("\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  \n")
res2 = libreoffice_calc.set_cell_color_by_position(filePath, "C5", "#e75322", "#227ee7")
echo(`${res2}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_cell_color_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Установить шрифт оранжевый, фон зеленый ячейки B4 ")
res1 = libreoffice_calc.set_cell_color_by_position(filePath, "B4", "#e75322", "#22e74a")
print(res1)

#2
print("\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  ")
res2 = libreoffice_calc.set_cell_color_by_position(filePath, "C5", "#e75322", "#227ee7")
print(res2)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_cell_color_by_table_and_position

Установить фон/цвет текста в ячейке используя позицию ячейки и название таблицы

set_cell_color_by_table_and_position(string path, string table_name, string cell_position, string foreground_color, string background_color)
path Путь к файлу
table_name Название таблицы в документе
cell_position Позиция ячейки (пример - A20)
foreground_color Цвет текста
background_color Цвет фона

Цвет ячейки устанавливается как в CSS, используя HEX-code (пример, #FF0000).

Описание возврата: Возвращает логическое значение true в случае успешного форматирования ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_cell_color_by_table_and_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Установить шрифт оранжевый, фон зеленый ячейки B4 в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->set_cell_color_by_table_and_position($filePath, "Oscar Ages", "B4", "#e75322", "#22e74a");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//2
echo "\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  \n";
$res1 = $libreoffice_calc->set_cell_color_by_table_and_position($filePath, "Oscar Ages", "C5", "#e75322", "#227ee7");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_cell_color_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Установить шрифт оранжевый, фон зеленый ячейки B4 в таблице Oscar Ages: \n")
res1 = libreoffice_calc.set_cell_color_by_table_and_position(filePath, "Oscar Ages", "B4", "#e75322", "#22e74a")
echo(`${res1}\n`)

//2
echo("\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  \n")
res1 = libreoffice_calc.set_cell_color_by_table_and_position(filePath, "Oscar Ages", "C5", "#e75322", "#227ee7")
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_cell_color_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Установить шрифт оранжевый, фон зеленый ячейки B4 в таблице Oscar Ages: ")
res1 = libreoffice_calc.set_cell_color_by_table_and_position(filePath, "Oscar Ages", "B4", "#e75322", "#22e74a")
print(res1)

#2
print("\n2. Установить шрифт оранжевый, фон синий ячейки C5 в таблице Oscar Ages:  ")
res1 = libreoffice_calc.set_cell_color_by_table_and_position(filePath, "Oscar Ages", "C5", "#e75322", "#227ee7")
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_change

Изменить значение ячейки

cell_change(string path, int row, int col, string cell_content)
path Путь к файлу
row Номер строки
col Номер столбца
cell_content Содержимое ячейки

Описание возврата: Возвращает логическое значение true в случае успешного изменения текста ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_change');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Значение ячейки ячейки [2,3]: \n";
echo $libreoffice_calc->get_cell($filePath, 2, 3)."\n";

//2
echo "\n2. Изменяем значение ячейки: \n";
$res1 = $libreoffice_calc->cell_change($filePath, 2, 3, "new value");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//3
echo "\n3. Значение ячейки ячейки [2,3]: \n";
echo $libreoffice_calc->get_cell($filePath, 2, 3)."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_change')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Значение ячейки ячейки [2,3]: \n")
echo(`${libreoffice_calc.get_cell(filePath, 2, 3)}\n`)

//2
echo("\n2. Изменяем значение ячейки: \n")
res1 = libreoffice_calc.cell_change(filePath, 2, 3, "new value")
echo(`${res1}\n`)

//3
echo("\n3. Значение ячейки ячейки [2,3]: \n")
echo(`${libreoffice_calc.get_cell(filePath, 2, 3)}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_change')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Значение ячейки ячейки [2,3]: ")
print(libreoffice_calc.get_cell(filePath, 2, 3))

#2
print("\n2. Изменяем значение ячейки: ")
res1 = libreoffice_calc.cell_change(filePath, 2, 3, "new value")
print(res1)

#3
print("\n3. Значение ячейки ячейки [2,3]: ")
print(libreoffice_calc.get_cell(filePath, 2, 3))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_change_by_table

Изменить значение ячейки в таблице

cell_change_by_table(string path, int row, int col, string table_name, string cell_content)
path Путь к файлу
row Номер строки
col Номер столбца
table_name Название таблицы в документе
cell_content Содержимое ячейки

Описание возврата: Возвращает логическое значение true в случае успешного изменения текста ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_change_by_table');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Значение ячейки ячейки [2,3] в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table($filePath, 2, 3, "Oscar Ages")."\n";

//2
echo "\n2. Изменяем значение ячейки: \n";
$res1 = $libreoffice_calc->cell_change_by_table($filePath, 2, 3, "Oscar Ages", "changed value 2");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//3
echo "\n3. Значение ячейки ячейки [2,3] в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table($filePath, 2, 3, "Oscar Ages")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_change_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Значение ячейки ячейки [2,3] в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages")}\n`)

//2
echo("\n2. Изменяем значение ячейки: \n")
res1 = libreoffice_calc.cell_change_by_table(filePath, 2, 3, "Oscar Ages", "changed value 2")
echo(`${res1}\n`)

//3
echo("\n3. Значение ячейки ячейки [2,3] в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_change_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Значение ячейки ячейки [2,3] в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages"))

#2
print("\n2. Изменяем значение ячейки: ")
res1 = libreoffice_calc.cell_change_by_table(filePath, 2, 3, "Oscar Ages", "changed value 2")
print(res1)

#3
print("\n3. Значение ячейки ячейки [2,3] в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table(filePath, 2, 3, "Oscar Ages"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_change_by_position

Изменить значение ячейки по позиции

cell_change_by_position(string path, string cell_position, string cell_content)
path Путь к файлу
cell_position Позиция ячейки (пример - A20)
cell_content Содержимое ячейки

Описание возврата: Возвращает логическое значение true в случае успешного изменения текста ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_change_by_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Значение ячейки ячейки B4: \n";
echo $libreoffice_calc->get_cell_by_position($filePath, "B4")."\n";

//2
echo "\n2. Изменяем значение ячейки: \n";
$res1 = $libreoffice_calc->cell_change_by_position($filePath, "B4", "changed value 2");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//3
echo "\n3. Значение ячейки ячейки [2,3]: \n";
echo $libreoffice_calc->get_cell_by_position($filePath, "B4")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_change_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Значение ячейки ячейки B4: \n")
echo(`${libreoffice_calc.get_cell_by_position(filePath, "B4")}\n`)

//2
echo("\n2. Изменяем значение ячейки: \n")
res1 = libreoffice_calc.cell_change_by_position(filePath, "B4", "changed value 2")
echo(`${res1}\n`)

//3
echo("\n3. Значение ячейки ячейки [2,3]: \n")
echo(`${libreoffice_calc.get_cell_by_position(filePath, "B4")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_change_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Значение ячейки ячейки B4: ")
print(libreoffice_calc.get_cell_by_position(filePath, "B4"))

#2
print("\n2. Изменяем значение ячейки: ")
res1 = libreoffice_calc.cell_change_by_position(filePath, "B4", "changed value 2")
print(res1)

#3
print("\n3. Значение ячейки ячейки [2,3]: ")
print(libreoffice_calc.get_cell_by_position(filePath, "B4"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_change_by_table_and_position

Изменить значение ячейки по позиции в таблице

cell_change_by_table_and_position(string path, string table_name, string cell_position, string cell_content)
path Путь к файлу
table_name Название таблицы в документе
cell_position Позиция ячейки (пример - A20)
cell_content Содержимое ячейки

Описание возврата: Возвращает логическое значение true в случае успешного изменения текста ячейки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_change_by_table_and_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Значение ячейки ячейки B4 в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table_and_position($filePath, "Oscar Ages", "B4")."\n";

//2
echo "\n2. Изменяем значение ячейки: \n";
$res1 = $libreoffice_calc->cell_change_by_table_and_position($filePath, "Oscar Ages", "B4", "changed value 2");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

//3
echo "\n3. Значение ячейки ячейки B4 в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_cell_by_table_and_position($filePath, "Oscar Ages", "B4")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_change_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Значение ячейки ячейки B4 в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B4")}\n`)

//2
echo("\n2. Изменяем значение ячейки: \n")
res1 = libreoffice_calc.cell_change_by_table_and_position(filePath, "Oscar Ages", "B4", "changed value 2")
echo(`${res1}\n`)

//3
echo("\n3. Значение ячейки ячейки B4 в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B4")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_change_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Значение ячейки ячейки B4 в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B4"))

#2
print("\n2. Изменяем значение ячейки: ")
res1 = libreoffice_calc.cell_change_by_table_and_position(filePath, "Oscar Ages", "B4", "changed value 2")
print(res1)

#3
print("\n3. Значение ячейки ячейки B4 в таблице Oscar Ages: ")
print(libreoffice_calc.get_cell_by_table_and_position(filePath, "Oscar Ages", "B4"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_add_annotation

Добавление комментария

cell_add_annotation(string path, int row, int col, string annotation_author, string annotation_comment, string json_annotation_settings)
path Путь к файлу
row Номер строки
col Номер столбца
annotation_author Автор комментария
annotation_comment Текст комментария
json_annotation_settings Настройка комметариев (размер, расположение)

Строка в формате JSON

x string Расположение комментария относительно ячейки по оси X
y string Расположение комментария относительно ячейки по оси Y
width string Ширина области с комментарием
height string Высота области с комментарием
captionPointX string Расположение точки с комментарием по оси X
captionPointY string Расположение точки с комментарием по оси X

Размеры указываются в следующих допустимых единицах:

Пример добавленного комменатрия:

Описание возврата: Возвращает логическое значение true в случае успешного добавления комментария

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_add_annotation');

$filePath = $test->get_test_file_full_path('SampleData.ods');
$annotationSettings = '{"x": "2cm", "y": "4cm"}';

// 1
echo "1. Добавить комментарий к ячейке [4,4]: \n";
$res1 = $libreoffice_calc->cell_add_annotation($filePath, 4, 4, "Author", "Comment 1", $annotationSettings);
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_add_annotation')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = '{"x": "2cm", "y": "4cm"}'

// 1
echo("1. Добавить комментарий к ячейке [4,4]: \n")
res1 = libreoffice_calc.cell_add_annotation(filePath, 4, 4, "Author", "Comment 1", annotationSettings)
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_add_annotation')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = {"x": "2cm", "y": "4cm"}

# 1
print("1. Добавить комментарий к ячейке [4,4]: ")
res1 = libreoffice_calc.cell_add_annotation(filePath, 4, 4, "Author", "Comment 1", annotationSettings)
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_add_annotation_by_table

Добавление комментария с указанием таблицы

cell_add_annotation_by_table(string path, int row, int col, string table_name, string annotation_author, string annotation_comment, string json_annotation_settings)
path Путь к файлу
row Номер строки
col Номер столбца
table_name Название таблицы в документе
annotation_author Автор комментария
annotation_comment Текст комментария
json_annotation_settings Настройка комметариев (размер, расположение)

Строка в формате JSON

x string Расположение комментария относительно ячейки по оси X
y string Расположение комментария относительно ячейки по оси Y
width string Ширина области с комментарием
height string Высота области с комментарием
captionPointX string Расположение точки с комментарием по оси X
captionPointY string Расположение точки с комментарием по оси X

Размеры указываются в следующих допустимых единицах:

Пример добавленного комменатрия:

Описание возврата: Возвращает логическое значение true в случае успешного добавления комментария

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_add_annotation_by_table');

$filePath = $test->get_test_file_full_path('SampleData.ods');
$annotationSettings = '{"x": "2cm", "y": "4cm"}';

// 1
echo "1. Добавить комментарий к ячейке [2,3] в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->cell_add_annotation_by_table($filePath, 2, 3, "Oscar Ages", "Author", "Comment 1", $annotationSettings);
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_add_annotation_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = '{"x": "2cm", "y": "4cm"}'

// 1
echo("1. Добавить комментарий к ячейке [2,3] в таблице Oscar Ages: \n")
res1 = libreoffice_calc.cell_add_annotation_by_table(filePath, 2, 3, "Oscar Ages", "Author", "Comment 1", annotationSettings)
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_add_annotation_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = {"x": "2cm", "y": "4cm"}

# 1
print("1. Добавить комментарий к ячейке [2,3] в таблице Oscar Ages: ")
res1 = libreoffice_calc.cell_add_annotation_by_table(filePath, 2, 3, "Oscar Ages", "Author", "Comment 1", annotationSettings)
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_add_annotation_by_position

Добавление комментария используя название позиции ячейки

cell_add_annotation_by_position(string path, string cell_position, string annotation_author, string annotation_comment, string json_annotation_settings)
path Путь к файлу
cell_position Позиция ячейки (пример - A20)
annotation_author Автор комментария
annotation_comment Текст комментария
json_annotation_settings Настройка комметариев (размер, расположение)

Строка в формате JSON

x string Расположение комментария относительно ячейки по оси X
y string Расположение комментария относительно ячейки по оси Y
width string Ширина области с комментарием
height string Высота области с комментарием
captionPointX string Расположение точки с комментарием по оси X
captionPointY string Расположение точки с комментарием по оси X

Размеры указываются в следующих допустимых единицах:

Пример добавленного комменатрия:

Описание возврата: Возвращает логическое значение true в случае успешного добавления комментария

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_add_annotation_by_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');
$annotationSettings = '{"x": "2cm", "y": "4cm"}';

// 1
echo "1. Добавить комментарий к ячейке B6: \n";
$res1 = $libreoffice_calc->cell_add_annotation_by_position($filePath, "B6", "Author", "Comment 1", $annotationSettings);
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_add_annotation_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = '{"x": "2cm", "y": "4cm"}'

// 1
echo("1. Добавить комментарий к ячейке B6: \n")
res1 = libreoffice_calc.cell_add_annotation_by_position(filePath, "B6", "Author", "Comment 1", annotationSettings)
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_add_annotation_by_position')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = {"x": "2cm", "y": "4cm"}

# 1
print("1. Добавить комментарий к ячейке B6: ")
res1 = libreoffice_calc.cell_add_annotation_by_position(filePath, "B6", "Author", "Comment 1", annotationSettings)
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

cell_add_annotation_by_table_and_position

Добавление комментария используя позицию ячейки и название таблицы

cell_add_annotation_by_table_and_position(string path, string table_name, string cell_position, string annotation_author, string annotation_comment, string json_annotation_settings)
path Путь к файлу
table_name Название таблицы в документе
cell_position Позиция ячейки (пример - A20)
annotation_author Автор комментария
annotation_comment Текст комментария
json_annotation_settings Настройка комметариев (размер, расположение)

Строка в формате JSON

x string Расположение комментария относительно ячейки по оси X
y string Расположение комментария относительно ячейки по оси Y
width string Ширина области с комментарием
height string Высота области с комментарием
captionPointX string Расположение точки с комментарием по оси X
captionPointY string Расположение точки с комментарием по оси X

Размеры указываются в следующих допустимых единицах:

Пример добавленного комменатрия:

Описание возврата: Возвращает логическое значение true в случае успешного добавления комментария

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('cell_add_annotation_by_table_and_position');

$filePath = $test->get_test_file_full_path('SampleData.ods');
$annotationSettings = '{"x": "2cm", "y": "4cm"}';

// 1
echo "1. Добавить комментарий к ячейке B6 в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->cell_add_annotation_by_table_and_position($filePath, "Oscar Ages", "B6", "Author", "Comment 1", $annotationSettings);
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('cell_add_annotation_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = '{"x": "2cm", "y": "4cm"}'

// 1
echo("1. Добавить комментарий к ячейке B6 в таблице Oscar Ages: \n")
res1 = libreoffice_calc.cell_add_annotation_by_table_and_position(filePath, "Oscar Ages", "B6", "Author", "Comment 1", annotationSettings)
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('cell_add_annotation_by_table_and_position')

filePath = test.get_test_file_full_path('SampleData.ods')
annotationSettings = {"x": "2cm", "y": "4cm"}

# 1
print("1. Добавить комментарий к ячейке B6 в таблице Oscar Ages: ")
res1 = libreoffice_calc.cell_add_annotation_by_table_and_position(filePath, "Oscar Ages", "B6", "Author", "Comment 1", annotationSettings)
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

add_define_range_name

Добавление названия диапазона ячеек

add_define_range_name(string path, string range_name, string range)
path Путь к файлу
range_name Название диапазона ячеек
range Диапазон ячеек

В диапазоне обязательно указывается название таблицы и значения ячеек в формате по примеру - listName.A1:listName.C1

В приложении можно посмотреть диапазон ячеек через меню Данные -> Выбрать диапазон:

Описание возврата: Возвращает логическое значение true в случае успешного добавления диапазона

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('add_define_range_name');

$filePath = $test->get_test_file_full_path('SampleData.ods');

// 1
echo "1. Добавить имя диапазона A10:C10 таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->add_define_range_name($filePath, "RangeName", "Oscar Ages.A10:Oscar Ages.C10");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('add_define_range_name')

filePath = test.get_test_file_full_path('SampleData.ods')

// 1
echo("1. Добавить имя диапазона A10:C10 таблице Oscar Ages: \n")
res1 = libreoffice_calc.add_define_range_name(filePath, "RangeName", "Oscar Ages.A10:Oscar Ages.C10")
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('add_define_range_name')

filePath = test.get_test_file_full_path('SampleData.ods')

# 1
print("1. Добавить имя диапазона A10:C10 таблице Oscar Ages: ")
res1 = libreoffice_calc.add_define_range_name(filePath, "RangeName", "Oscar Ages.A10:Oscar Ages.C10")
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_rows_count

Получить кол-во строк в файле

get_rows_count(string path, string table_name)
path Путь к файлу
table_name Название таблицы в документе

Описание возврата: Возвращает кол-во строк в таблице

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_rows_count');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Получить кол-во строк: \n";
echo $libreoffice_calc->get_rows_count($filePath, "Oscar Ages")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_rows_count')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Получить кол-во строк: \n")
echo(`${libreoffice_calc.get_rows_count(filePath, "Oscar Ages")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_rows_count')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Получить кол-во строк: ")
print(libreoffice_calc.get_rows_count(filePath, "Oscar Ages"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_row_content

Поолучить значение строки по номеру

get_row_content(string path, int row)
path Путь к файлу
row Номер строки

Описание возврата: Возвращает значения ячеек строки, разделенных точкой с запятой

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_row_content');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Получить значение строки 6: \n";
echo $libreoffice_calc->get_row_content($filePath, 6)."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_row_content')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Получить значение строки 6: \n")
echo(`${libreoffice_calc.get_row_content(filePath, 6)}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_row_content')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Получить значение строки 6: ")
print(libreoffice_calc.get_row_content(filePath, 6))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_row_content_by_table

Поолучить значение строки по номеру с указанием таблицы

get_row_content_by_table(string path, int row, string table_name)
path Путь к файлу
row Номер строки
table_name Название таблицы в документе

Описание возврата: Возвращает значения ячеек строки, разделенных точкой с запятой

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_row_content_by_table');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Получить значение строки 6 в таблице Oscar Ages: \n";
echo $libreoffice_calc->get_row_content_by_table($filePath, 6, "Oscar Ages")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_row_content_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Получить значение строки 6 в таблице Oscar Ages: \n")
echo(`${libreoffice_calc.get_row_content_by_table(filePath, 6, "Oscar Ages")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_row_content_by_table')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Получить значение строки 6 в таблице Oscar Ages: ")
print(libreoffice_calc.get_row_content_by_table(filePath, 6, "Oscar Ages"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_row_height

Установить высоту строки

set_row_height(string path, int row, string height, string table_name)
path Путь к файлу
row Номер строки
height Высота

Высота указвается в следующих допустимых единицах:

table_name Название таблицы в документе

Описание возврата: Возвращает логическое значение true в случае успешного изменения высоты строки

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_row_height');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Увеличить высоту строки 8 до 0.6см в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->set_row_height($filePath, 8, "0.6cm", "Oscar Ages");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_row_height')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Увеличить высоту строки 8 до 0.6см в таблице Oscar Ages: \n")
res1 = libreoffice_calc.set_row_height(filePath, 8, "0.6cm", "Oscar Ages")
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_row_height')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Увеличить высоту строки 8 до 0.6см в таблице Oscar Ages: ")
res1 = libreoffice_calc.set_row_height(filePath, 8, "0.6cm", "Oscar Ages")
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

get_cols_count

Получить кол-во столбцов

get_cols_count(string path, string table_name)
path Путь к файлу
table_name Название таблицы в документе

Описание возврата: Возвращает кол-во столбцов в таблице

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('get_cols_count');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Получить кол-во столбцов: \n";
echo $libreoffice_calc->get_cols_count($filePath, "Oscar Ages")."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('get_cols_count')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Получить кол-во столбцов: \n")
echo(`${libreoffice_calc.get_cols_count(filePath, "Oscar Ages")}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('get_cols_count')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Получить кол-во столбцов: ")
print(libreoffice_calc.get_cols_count(filePath, "Oscar Ages"))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

set_col_width

Установить ширину столбца

set_col_width(string path, int col, string width, string table_name)
path Путь к файлу
col Номер столбца
width Ширина

Ширина указвается в следующих допустимых единицах:

table_name Название таблицы в документе

Описание возврата: Возвращает логическое значение true в случае успешного изменения ширины столбца

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('set_col_width');

$filePath = $test->get_test_file_full_path('SampleData.ods');

//1
echo "1. Увеличить ширину столбца 1 до 5см в таблице Oscar Ages: \n";
$res1 = $libreoffice_calc->set_col_width($filePath, 1, "5cm", "Oscar Ages");
$res1 = $res1 ? 'true' : 'false';
echo $res1."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('set_col_width')

filePath = test.get_test_file_full_path('SampleData.ods')

//1
echo("1. Увеличить ширину столбца 1 до 5см в таблице Oscar Ages: \n")
res1 = libreoffice_calc.set_col_width(filePath, 1, "5cm", "Oscar Ages")
echo(`${res1}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('set_col_width')

filePath = test.get_test_file_full_path('SampleData.ods')

#1
print("1. Увеличить ширину столбца 1 до 5см в таблице Oscar Ages: ")
res1 = libreoffice_calc.set_col_width(filePath, 1, "5cm", "Oscar Ages")
print(res1)

# конец теста
print('\n<hr><br>')

# выход
app.quit()

convert

Экспорт файла в другие расширения

convert(string path, string output_path, string swriter_path)
path Путь к файлу
output_path Путь к готовому сконвернтированному файлу XLSX
swriter_path Расположение файла swriter.exe (по умолчанию C:\Program Files\LibreOffice\program\)

Описание возврата: Возвращает логическое значение true в случае успешной конвертации

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $libreoffice_calc);

// начало теста
$test->echo_header('convert');

$filePath = $test->get_test_file_full_path('SampleData.ods');
$outputPath = $test->get_test_file_full_path('SampleData.xlsx');

//1
echo "1. Сконвертировать в xlsx-файл: \n";
$res = $libreoffice_calc->convert($filePath, $outputPath, "");
$res = $res ? 'true' : 'false';
echo $res."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, libreoffice_calc)

// начало теста
test.echo_header('convert')

filePath = test.get_test_file_full_path('SampleData.ods')
outputPath = test.get_test_file_full_path('SampleData.xlsx')

//1
echo("1. Сконвертировать в xlsx-файл: \n")
res = libreoffice_calc.convert(filePath, outputPath, "")
echo(`${res}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, libreoffice_calc)

# начало теста
test.echo_header('convert')

filePath = test.get_test_file_full_path('SampleData.ods')
outputPath = test.get_test_file_full_path('SampleData.xlsx')

#1
print("1. Сконвертировать в xlsx-файл: ")
res = libreoffice_calc.convert(filePath, outputPath, "")
print(res)

# конец теста
print('\n<hr><br>')

# выход
app.quit()