Skip to content
Евгений edited this page Nov 20, 2016 · 20 revisions

Библиотека полезных функций для кассового ПО Frontol 5

функция GetPathDBFrontol5(cPathVariant) - получить путь к БД Frontol5

параметры: cPathVariant - строковой литерал со значением:

  • "OnlyPath" - по умолчанию - функция возвращает только путь к БД (пример - E:\BASE\POSBASE\FT_5_TRADE)
  • "HostAndPath" - функция возвращает хост и путь к БД (пример - localhost:E:\BASE\POSBASE\FT_5_TRADE)

возвращает строку, содержащую путь к БД Frontol или пустую строку, в случае ошибки

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

  • по умолчанию: cPath = GetPathDBFrontol5(); // возвращает: E:\BASE\POSBASE\FT_5_TRADE\
  • с аргументом "OnlyPath": cPath = GetPathDBFrontol5("OnlyPath"); // возвращает: E:\BASE\POSBASE\FT_5_TRADE\
  • с аргументом "HostAndPath": cPath = GetPathDBFrontol5("HostAndPath"); // возвращает: localhost:E:\BASE\POSBASE\FT_5_TRADE\

функция getEAN13(anyCode, cPrefix) - получить код EAN-13 с контрольным символом

параметры:

  • anyCode- число или строка длиной 10 символов. Код товара (без префикса)
  • cPrefix- строка. Префикс кода EAN13. Значение по умолчанию "25"

возвращает строку, содержащую код EAN13 с корректно сформированным контрольным символом

Пример использования cEAN13 = getEAN13("0000000001","20"); // возвращает "2000000000015"

функция getRandomInt(nMinValue, nMaxValue) - получить случайное целое число в заданном диапазоне

параметры:

  • nMinValue - целое число. Начало диапазона для формирования случайного числа.
  • nMaxValue - целое число. Конец диапазона для формирования случайного числа.

возвращает целое случайное число в заданном диапазоне

Пример использования nRnd = getRandomInt(1,10); // возвращает 7

расширение строковых функций объекта String

за основу библиотеки взят код функций с сайта "Гараж программиста" http://garazh.biz/javascript/trim/

для инициализации расширения строковых функций, в методе init() скрипта Frontol 5 вызовите функцию initStringLib()

function init() {
    // подключение обработчиков событий:
    frontol.addEventListener("addPosition", "afterAddPosition", false);

    //подключение расширения строковых функций
    initStringLib();
}

функции входящие в расширение:

  • padr(cPadChar,nCount) - дополнить строку заданными символами cPadChar справа в количестве nCount
  • padl(cPadChar,nCount) - дополнить строку заданными символами cPadChar слева в количестве nCount
  • trimRight() - убрать все пробелы в конце строки (справа)
  • trimLeft() - убрать все пробелы в начале строки (слева)
  • trimAll() - убрать все пробелы в начале и конце строки

функция getBoldString(cString) - получить строку, которую ККМ выведет жирным (bold) шрифтом

параметры:

  • cString - строка. Строка текста, которую необходимо преобразовать в в строку, которую ККМ выведет жирным шрифтом

возвращает строку размеченную специальным образом, так что бы ККМ напечатал её жирным шрифтом

Пример использования: cBoldString = getBoldString("ПРОДАЖА"); // возвращается строка преобразованная в шрифт bold "\tП\tР\tО\tД\tА\tЖ\tА"

функция FileExists(cPath) - проверить существование файла на диске

параметры:

  • cPath - строка. Полный путь к проверяемому файлу.

возвращает булево true - файл по указанному пути существует; false - файл по указанному пути не существует

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

var cPath = "c:\file.txt";
var bExists = FileExists(cPath); // вернёт false, если файл не существует

класс propertyBMPfile - доступ к различным свойствам BMP файла

параметры конструктора класса:

  • cFullPathFile - строка. Полный путь к файлу картинки. свойства класса:
  • fullPathFile - строка. Полный путь к картинке.
  • nDepthColor - целое число. Глубина цвета в картинке (для монохромных nDepthColor=1).
  • nWidth - целое число. Ширина картинки в пикселях.
  • nHeigth - целое число. Высота картинки в пикселях.

методы класса: отсутствуют

класс служит для доступа к различным свойствам BMP файла, например, глубина цвета, ширина и высота картинки

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

var myPicture = new propertyBMPfile("d:\\picture\\0.bmp"); 
frontol.actions.ShowMessage("глубина цвета " + myPicture .nDepthColor+"\n" +
                            "ширина растра " + myPicture.nWidth+"\n" +
                            "высота растра " + myPicture.nHeigth);

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

функции входящие в набор:

  • userValueRemove(cValueName) - удалить переменную пользователя, где cValueName - строка, имя удаляемой переменной
  • userValueSet(cValueName, anyValue) - установить значение пользовательской переменной, где cValueName - строка, имя переменной, значение которой будет установлено и anyValue - строка, число, булево, значение, которое будет установлено переменной пользователя. Если переменной пользователя с таким именем ещё нет, она будет создана.
  • userValueAsString(cValueName) - получить значение пользовательской переменной преобразованное в строку, где cValueName - строка, имя переменной, значение которой нужно получить. Возвращается значение переменной пользователя в виде строки.
  • userValueAsNumber(cValueName) - получить значение пользовательской переменной преобразованное в число, где cValueName - строка, имя переменной, значение которой нужно получить. Возвращается значение переменной пользователя в виде числа или NaN если преобразование в число невозможно.
  • userValueAsBoolean(cValueName) - получить значение пользовательской переменной преобразованное в булево, где cValueName - строка, имя переменной, значение которой нужно получить. Возвращается значение переменной пользователя в виде булевого типа.

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

    userValueRemove("nGroupCode");
    var nGroupCode = 2;
    userValueSet("nGroupCode",nGroupCode);
    var nCode = userValueAsNumber("nGroupCode");