Datecs CashLoader Руководство по эксплуатации Утилита импорта/экспорта данных для ЭККА семейства

Datecs CashLoader
Утилита импорта/экспорта данных для
ЭККА семейства MP-50/50EU/500T/5000
Руководство по эксплуатации
2006.
Датекс Украина
Содержание.
1.
2.
3.
4.
5.
6.
7.
7.1.
7.2.
7.3.
7.4.
7.5.
7.6.
8.
9.
9.1.
9.2.
9.3.
9.4.
9.5.
9.6.
9.7.
9.8.
10.
Введение. ...............................................................................................................................3
Установка и удаление. ........................................................................................................3
Формат данных (импорт). ..................................................................................................3
Формат данных (экспорт) ..................................................................................................6
Импорт. ..................................................................................................................................6
Экспорт. .................................................................................................................................8
Режим “подкачки”...............................................................................................................9
Подготовка файлов данных...........................................................................................9
Внешние источники данных. ........................................................................................9
Настройка сервера подкачки. .......................................................................................9
Запуск сервера подкачки .............................................................................................10
Останов сервера подкачки ..........................................................................................10
Отчет сервера подкачки ...............................................................................................10
HTTP сервер. ......................................................................................................................12
Почтовый сервер. ..............................................................................................................12
Настройка параметров электронной почты. ...........................................................12
Настройка клиентского приложения. .......................................................................14
Команды. .........................................................................................................................14
Хранимые процедуры. ..................................................................................................16
Регистрация хранимой процедуры. ...........................................................................16
Библиотека хранимых процедур DCL32.DLL. ........................................................17
Вызов хранимой процедуры. .......................................................................................19
Datecs CashLoader API. .................................................................................................19
Лицензионное соглашение. ..........................................................................................19
2
Датекс Украина
1. Введение.
Утилита Datecs CashLoader (DCL) предназначена для автоматизации процесса
программирования таблицы артикулов, кассовых аппаратов (ЭККА) производства
компании Датекс Украина. DCL версии 3.0.1.7 поддерживает следующий перечень
ЭККА:
1.1. MP-50/50EU;
1.2. MP-500T (версия 01.01* [1], 01.02);
1.3. MP-5000 (версия 01.01* [2], 01.02).
*Замечание 1. При работе с ЭККА Datecs MP-500 (версия 01.01) необходимо
установить скорость обмена между кассовым аппаратом и персональным
компьютером равную 9600 бит/c.
*Замечание 2. При работе с ЭККА Datecs MP-5000 (версия 01.01) необходимо
установить скорость обмена между кассовым аппаратом и персональным
компьютером равную 9600 бит/c.
Утилита DCL также поддерживает сеанс работы IN-Line в режиме подкачки
артикулов в энергонезависимую память одного или группы ЭККА. В данном режиме
(см. настройки конкретной модели ЭККА) кассовый аппарат, после ввода оператором
кода артикула, запрашивает данные у компьютера, которые впоследствии заносятся в
память ЭККА. Таким образом, появляется возможность организовать динамическую
продажу товаров, а также избежать длительного по времени процесса предварительной
записи артикулов в память кассового аппарата* [1].
*Замечание 1. Для версии 1.0.0.7 Datecs CashLoader режим подкачки доступен
только для ЭККА семейства MP-50/50EU/500T/5000(01.02).
2. Установка и удаление.
В программном обеспечении DCL отсутствует процедура установки, поэтому
инсталляция продукта производится конечным потребителем. Для установки
необходимо создать произвольную папку на диске и перенести в последнюю
исполняемый модуль CashLoader.exe и все сопутствующие файлы: динамические
библиотеки, файлы примеров, документацию.
Деинсталляция программного продукта заключается в физическом удалении
исполняемого модуля и сопутствующих файлов штатными средствами операционной
системы.
3. Формат данных (импорт).
Утилита DCL версии 3.0.1.7 поддерживает два формата данных – текстовый файл
с разделителями и файлы dBASE IV (далее dbf). Поэтому для записи данных в память
ЭККА (импорт) необходимо заранее подготовить тестовый или dbf файл в кодировке
cp1251 (Windows 1251) с необходимым набором полей. В качестве разделителя полей
используется символ “;”. Входной формат данных полностью соответствует таблице
артикулов определенного ЭККА (см. руководство по эксплуатации для конкретного
типа кассового аппарата). Ниже приведены примеры текстовых файлов данных для
ЭККА семейства MP-50/50EU/500T/5000.
3
Датекс Украина
Пример 1. Фрагмент файла данных для ЭККА MP-50/50EU.
1000;1000;Артикул №1;10.50;9999.999;1;7;1;0;0;11111;12345678;
1001;1001;Артикул №2;20.00;9999.999;1;8;2;0;0;22222;12345678;
1002;1002;Артикул №3;11.20;9999.999;1;9;3;0;0;33333;12345678;
1. поле – <1001> - номер ряда в фискальной памяти ЭККА (служебное) 1-99999
2. поле – <1001> - код товара 1-99999.*Для ЭККА MP-50/50EU значения полей [номер
ряда] и [код товара] должны совпадать.
3. поле - <Артикул №2> - наименование артикула. До 22 символов.
4. поле - <20.00> - цена 000000.00 – 999999.99
5. поле - <9999.99> - количество 00000.000 – 99999.999
6. поле - <1> - номер отдела 1-9
7. поле - <8> - номер группы товаров 1 – 99
8. поле - <2> - номер группы налогов. Перечень допустимых значений для различных
налоговых групп:
a) “A” – “1”
b) “Б” – “2”
c) “В” – “3”
d) “Г” – “4”
e) “*” – “5”
9. поле – <0> - признак группы товара. Перечень допустимых значений:
a) “0” – товар продается только по запрограммированной цене
b) “1” – группа товаров (продажа по свободной цене)
c) “4” – группа товаров. Товар связан с товаром, код которого
программируется в поле [восемь младших разрядов штрих-кода]. Таким
образом, при продаже первого товара из группы, автоматически продается
связанный с ним товар.
d) “5” – признак последнего товара в чеке. При продаже этого товара, чек
автоматически закрывается.
10. поле - <0> - признак запрета продажи при нулевом количестве товара. “0” –
продажа осуществляется постоянно, “1” – запрет продажи при нулевом количестве.
11. поле – <22222> - пять цифр старшего разряда штрих-кода. При использовании 8-ми
разрядного штрих-кода значение поля – 0.
12. поле - <12345678> - восемь младших разрядов штрих-кода
Пример 2. Фрагмент файла данных для ЭККА MP-500T/5000.
1000;1;Артикул №1;10.50;9999.999;1;7;1;0;0;111111;12345678;
1001;1;Артикул №2;20.00;9999.999;1;8;2;0;0;222222;12345678;
1002;1;Артикул №3;11.20;9999.999;1;9;3;0;0;333333;12345678;
1. поле – <1001> - номер ряда в фискальной памяти ЭККА (служебное) 1-99999
2. поле – <1> - признак использования товара. “1” – товар продается, “2” – запрет
продажи товара.
3. поле - <Артикул №2> - наименование артикула. До 18 символов.
4. поле - <20.00> - цена 0000000.00 – 9999999.99
5. поле - <9999.99> - количество 00000.000 – 99999.999
6. поле - <1> - номер отдела 1-10
7. поле - <8> - номер группы товаров 1 – 99
4
Датекс Украина
8. поле - <2> - номер группы налогов. Перечень допустимых значений для различных
налоговых групп:
a. “A” – “1”
b. “Б” – “2”
c. “В” – “3”
d. “Г” – “4”
e. “*” – “5”
f. “H1” – “6”
g. “H2” – “7”
h. “H3” – “8”
9. поле – <0> - признак группы товара. Перечень допустимых значений:
a. “0” – товар продается только по запрограммированной цене
b. “1” – группа товаров (продажа по свободной цене)
c. “2” – товар последний в чеке. При продаже этого товара, чек автоматически
закрывается.
d. “3” – группа последняя в чеке. При продаже группы, чек автоматически
закрывается.
e. “4” – группа товаров. Товар связан с товаром, код которого
программируется в поле [восемь младших разрядов штрих-кода]. Таким
образом, при продаже первого товара из группы, автоматически продается
связанный с ним товар.
f. “5” – группа с возможностью продажи по нулевой цене.
g. “6” - группа с возможностью продажи по нулевой цене, последняя в чеке.
10. поле - <0> - признак запрета продажи при нулевом количестве товара. “0” –
продажа осуществляется постоянно, “1” – запрет продажи при нулевом количестве.
11. поле – <222222> - шесть цифр старшего разряда штрих-кода. При использовании 8ми разрядного штрих-кода значение поля – 0.
12. поле - <12345678> - восемь младших разрядов штрих-кода
Пример 3. Формирование файла данных при помощи MS Excel.
При необходимости импорта данных из dbf файла, последний может быть
сформирован программно или вручную. Основное правило для файлов формата
dBASE – количество и очередность полей с данными должно соответствовать
количеству полей в таблице артикулов конкретного ЭККА (см. руководство
пользователя для конкретного типа ЭККА). Ниже приведен пример формирования
файла импорта при помощи программы MS Excel.
После того, как список артикулов сформирован, необходимо установить кареткумаркер на крайнюю левую значимую позицию (уровень заголовка списка) и в меню
приложения выбрать пункт “Сохранить как”.
5
Датекс Украина
В диалоговом окне сохранения файла выбрать формат DBF 4 (dBASE IV)(*.dbf)
4. Формат данных (экспорт)
Формат экспортированных данных из памяти ЭККА полностью совпадает с форматом
импорта (см п.3 “Формат данных (импорт)”), за исключением двух дополнительных
полей, которые добавляются в конец строки данных. Первое поле – количество
проданного товара, следующее – оборот ([оборот]=[количество проданного
товара]*[цена товара]).
Пример фрагмента файла экспорта для ЭККА MP-500T:
0;1;1;ТОВАР 1;10.00;97.999;1;1;1;;;100000;12345678;2.000;20.00;
0;2;1;ТОВАР 2;10.01;97.999;1;1;1;;;100001;12345678;2.000;20.02;
0;3;1;ТОВАР 3;10.02;97.999;1;1;1;;;100002;12345678;2.000;20.04;
0;4;1;ТОВАР 4;10.03;97.999;1;1;1;;;100003;12345678;2.000;20.06;
Дополнительно есть возможность экспортировать данные из памяти ЭККА в файл
формата dbf (dBASE IV).
Перечень полей DBF файла полностью совпадает с перечнем полей текстового файла
за исключением первого поля ( в dbf файле оно отсутствует).
5. Импорт.
Импорт – процедура записи данных
энергонезависимую память кассового аппарата.
из
пользовательского
файла
в
Перед выполнением процедуры импорта, необходимо подготовить текстовый
файл с данными (в кодировке Windows 1251), которые будут записаны в память ЭККА.
Формат файла для конкретных типов кассовых аппаратов детально расписан в п. 3.
руководства. После того, как данные готовы, необходимо запустить исполняемый
модуль утилиты Datecs CashLoader (CashLoader.exe). При успешном запуске модуля
появится основное диалоговое окно утилиты. В противном случае, если возникнет
сообщение об ошибке запуска программы, сообщите о характере ошибки
разработчику.
6
Датекс Украина
Далее необходимо, при помощи коммуникационного кабеля, подсоединить кассовый
аппарат к свободному последовательному порту компьютера, на котором эксплуатируется
утилита DCL. Перевести кассовый аппарат в режим работы с ПК (см. руководство по
эксплуатации конкретного ЭККА). Настроить параметры соединения в утилите в
соответствии с параметрами, установленными в кассовом аппарате. Выбрать при помощи
кнопки
утилиты файл с данными, которые необходимо записать в память ЭККА.
Активировать кнопку
. После проделанных действий, активируется процедура
программирования таблицы артикулов кассового аппарата. Во время программирования
таблицы артикулов запрещается пользоваться любыми кнопками утилиты – любое
некорректное действия пользователя может повлечь за собой неверную работу
программного обеспечение, что приведет к искажению данных в памяти кассового
аппарата. После завершения процедуры записи появится диалоговое окно с сообщением
о завершении процесса программирования таблицы артикулов ЭККА.
В процессе программирования выводится диагностическая информация о ходе
выполнения процедуры записи в память кассового аппарата.
Поле «Прочитано» – содержит количество строк с данными, которые прочитаны из
пользовательского файла.
7
Датекс Украина
Поле «Записано» - содержит количество строк успешно запрограммированных в
энергонезависимую память ЭККА.
Поле «Ошибки» - содержит количество строк, которые по той или иной причине не
записались в память кассового аппарата.
*Замечание. Одна из причин возникновения ошибки записи – попытка
перезаписать характеристики товара, который продавался в течение текущей
смены. Для корректной записи артикулов, перед программированием необходимо
сделать отчет с обнулением (Z-Отчет).
Внимание! Все ошибочные строки из файла данных переносятся в файл протокола
загрузки с идентификатором Import_DDMMYYYY_HHMMSS_log.txt. Файл протокола
находится в рабочем каталоге утилиты DCL. В последствии этот файл можно
откорректировать (в случае, если причина возникновения ошибок записи – некорректные
значения полей данных) и выполнить процедуру записи повторно, используя файл
протокола, как входной файл данных.
6. Экспорт.
Экспорт – процедура выгрузки данных из таблицы артикулов кассового аппарата в
текстовый файл пользователя.
Экспорт данных осуществляется в текстовый файл в кодировке Windows 1251 в
соответствии с форматом, описанным в п.4 руководства.
Для выполнения экспорта данных из кассового аппарата необходимо выполнить все
шаги по подключению ЭККА к персональному компьютеру пользователя (см. п.5
руководства). Выбрать файл данных, процедура аналогичная выбору файла для импорта,
за исключением, того, что пользователь может ввести идентификатор несуществующего
файла, который создастся автоматически.
Процедура активируется нажатием кнопки
. После активации этой кнопки,
появится диалоговое окно с параметрами экспорта, которые пользователь задает
самостоятельно в соответствии с типом используемого ЭККА.
Поле «Начальный ряд» - значение начального ряда в таблице артикулов кассового
аппарата. Допустимый диапазон 1 – 10000* . Максимальная величина ряда зависит от
типа ЭККА.
Поле «Конечный ряд» - значение конечного ряда в таблице артикулов кассового
аппарата. Допустимый диапазон 1 – 10000* . Максимальная величина ряда зависит от
типа ЭККА.
8
Датекс Украина
7. Режим “подкачки”.
Режим подкачки предназначен для продажи товаров коды, которых не
запрограммированы в таблице артикулов кассового аппарата. В этом режиме ЭККА
запрашивает по коду артикула информацию у компьютера. Если соответствующая
информация найдена и кассовый аппарат получил данные, то осуществляется продажа
артикула. Перед запуском процедуры подкачки товара необходимо подготовить файлы с
данными, которые будут использоваться как базы данных артикулов для продажи в
текущую смену.
Текущая версия программного обеспечения поддерживает одновременную работу с
несколькими ЭККА различных типов.
7.1. Подготовка файлов данных
Файлы данных для сервера подкачки готовятся по аналогии с процедурой подготовки
данных для импорта (см. п.3). Исключение составляют файлы описывающие внешние
источники данных (расширение DSN).
7.2. Внешние источники данных.
Под термином “Внешние источники данных” подразумеваются массивы данных
определенные в операционной системе как источники ODBC. При использовании
внешнего источника данных как массива для подкачки, необходимо зарегистрировать
ODBC источник и описать его в текстовом файле с расширением DSN. Формат файла
DSN показан ниже:
[Data source]
dsn="Datecs" – идентификатор зарегистрированного источника данных
query="SELECT …" – запрос на выборку данных.
Пример:
Datecs – внешний источник данных. Зарегистрированный как база данных MS
Access. Query=”select … from…” – запрос на выборку данных.
7.3. Настройка сервера подкачки.
Для настройки сервера подкачки необходимо активировать кнопку
основного
окна приложения. После этого появится диалоговое окно параметров сервера
подкачки.
9
Датекс Украина
Далее при помощи манипулятора “мышь” необходимо выбрать скорость обмена для
конкретного коммуникационного порта, тип кассового аппарата, номер ЭККА и файл с
данными.
7.4. Запуск сервера подкачки
Запуск сервера подкачки выполняется нажатием на кнопку диалогового окна
“Применить”.
7.5. Останов сервера подкачки
Останов сервера подкачки выполняется нажатием на кнопку диалогового окна “Стоп”.
7.6. Отчет сервера подкачки
Сервер подкачки формирует в текущем каталоге базу данных проданных товаров. База
данных состоит из трех таблиц (файлов формата dBASE IV) dcl0001, dcl0002 и dcl0003
(файлы dcl0001.dbf, dcl0002.dbf, dcl0003.dbf):



dcl0001 – таблица чеков за смену;
dcl0002 – таблица товаров проданных за смену;
dcl0003 – таблица скидок/надбавок на подсумму в чеке за смену.
10
Датекс Украина
Описание полей “таблиц отчета” сервера подкачки.
Таблица “чеки” (dcl0001)
№ поля
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Наименование
pumpid
rcptsn
rcptdo
rcptto
rcptdc
rcpttc
ptype
noper
ncntr
ntable
ndept
nrcpt
nzrep
psumm
asumm
bsumm
csumm
dsumm
esumm
h1summ
h2summ
h3summ
cmoney
Тип данных
integer
integer
integer
integer
integer
integer
char(1)
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
integer
Описание
Служебный идентификатор сервера подкачки
Служебный идентификатор чека
Дата открытия чека
Время открытия чека
Дата закрытия чека
Время закрытия чека
Тип платежа
Номер оператора
Номер счета
Номер стола
Номер отдела
Номер чека
Номер Z – отчета к которому относится чек
Сумма долга
Сумма по налоговой группе “А”
Сумма по налоговой группе “Б”
Сумма по налоговой группе “В”
Сумма по налоговой группе “Г”
Сумма по налоговой группе “Д*”
Сумма по налоговой группе “Н1”
Сумма по налоговой группе “Н2”
Сумма по налоговой группе “Н3”
Сумма полученная от клиента
Тип данных
integer
integer
intetger
integer
char(1)
integer
varchar(32)
integer
integer
integer
integer
char(2)
char(2)
char(2)
char(6)
char(8)
integer
Описание
Служебный идентификатор сервера подкачки
Служебный идентификатор чека
Дата продажи
Время продажи
Служебное поле
Код товара
Наименование товара
Цена товара (по товарной базе)
Цена товара (запрошенная от ЭККА)
Количество товара (по товарной базе)
Количество товара (запрошенное от ЭККА)
Группа товара
Отдел
Налоговая группа
Старшие разряды штрих-кода
Младшие разряды штрих-кода
Процент/абсолютное значение
Таблица “товары” (dcl0002)
№ поля
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Наименование
pumpid
rcptsn
rcptdo
rcptto
cstate
ccode
cname
cnprc
crprc
cnqnt
crqnt
cgrp
cdept
ctgrp
cschi
csclo
cdscnt
11
Датекс Украина
18
cdscntf char(1)
скидки/надбавки
Флаг


0 – скидка/надбавка процентная,
1 - скидка/надбавка абсолютная
Таблица “скидки/надбавки” (dcl0003)
№ поля
1
2
3
4
5
Наименование
pumpid
rcptsn
subsum
dscnt
dscntf
Тип данных
integer
integer
integer
integer
char(1)
Описание
Служебный идентификатор сервера подкачки
Служебный идентификатор чека
Подсумма
Скидка/надбавка
Флаг


0 – скидка/надбавка процентная,
1 - скидка/надбавка абсолютная
Таблицы связаны между собой логически, т.е. для таблицы dcl0001 пара pumpid, rcptsn
является первичным (уникальным) ключом, а для dcl0002, dcl0003 вторичным
(подчиненным) ключом.
8. HTTP сервер.
Программный продукт Datecs CashLoader, начиная в версии 3.0.1.7, имеет
встроенный HTTP сервер, благодаря которому можно с удаленного рабочего места
получить необходимую статистическую информацию о продажах. По умолчанию сервер
использует порт 50000, т.е. доступен по URL http://<имя хоста>:50000.
9. Почтовый сервер.
В состав программного комплекса Datecs CashLoader входит сервер обмена
электронными сообщениями (SMPT/POP3). Данное усовершенствование позволяет
конечному потребителю программного продукта удаленно контролировать работу
сервера подкачки, а также вносить изменения в базу данных артикулов.
9.1. Настройка параметров электронной почты.
К параметрам электронной почты относятся – порты SMTP и POP3 сервера, а также
база данных учетных записей. Для доступа к настройкам почтового сервера
необходимо активировать пункт основного меню – Datecs CashNET->Настройки.
После этого появится диалоговое окно с параметрами доступных сетевых серверов
приложения.
12
Датекс Украина
По умолчанию SMTP сервер настроен на прослушивание 25 порта, а POP3 - 110.
Пользователь может изменить номера прослушиваемых портов на любые доступные.
Допустимый диапазон значений от 1 – до 65535. В поле с идентификатором “Каталог
для хранения сообщений” необходимо ввести полный путь к директории, в которой
будут храниться файлы электронной почты.
Группа параметров “Учетная запись электронной почты” зарезервирована для
будущего использования.
Для добавления учетных записей пользователя необходимо активировать пункт
главного меню Datecs CashNET->Безопасность.
13
Датекс Украина
Диалоговое окно “Учетные записи электронной почты” позволяет добавлять и
удалять профили пользователей программы CashLoader. Для добавления новой
учетной записи необходимо заполнить группу параметров “Параметры учетной
записи” и нажать кнопку “Добавить”.
9.2. Настройка клиентского приложения.
В качестве клиентского приложения рекомендуется использовать программу MS
Outlook Express. Данная программа входит в состав операционной системы MS
WinNT/2000/XP. Порядок настройки приложения ничем не отличается от настройки
доступа к любому почтовому серверу. Обязательным условие является только формат
электронного сообщения – обычный текст в кодировке WINDOWS-1251.
9.3. Команды.
Почтовый сервер программы CashLoader имеет встроенный интерпретатор команд
и при успешном выполнении команды отвечает пользователю электронным
сообщением с результатами выполнения команды. Все команды передаются в теле
электронного письма и разделяются между собой символом <;>. В одном запросе
14
Датекс Украина
допускается отправка группы команд, в таком случае команды из группы
обрабатываются последовательно и результат отправляется пользователю в виде
единого электронного письма. Все запросы должны адресоваться на ящик
электронной почты – CashLoader@DatecsCash.Net.
GET VERSION; - запрос версии программного обеспечения.
Пример ответа на команду:
GET TOTAL; - запрос оборотов денежных средств по всем налоговым группам.
Пример
ответа
на
команду:
15
Датекс Украина
CALL <идентификатор хранимой процедуры>; - вызов хранимой процедуры
Более детально команда описана в разделе “Хранимые процедуры”.
9.4. Хранимые процедуры.
Программа DatecsCash Loader является приложением с расширяемой
функциональностью. В качестве модулей расширения выступают хранимые
процедуры, которые могут входить в состав одной или нескольких динамически
загружаемых библиотек (DLL). Из хранимой процедуры пользователю доступны все
объекты базы данных программы, иными словами у пользователя появляется
возможность произвольно оперировать данными программы (добавление/удаление
артикулов, изменение атрибутов товара, добавление нового артикула, составление
произвольных отчетов о продажах и т.д.).
В контексте CashLoader под “хранимой процедурой”, понимается функция из DLL,
удовлетворяющая требованиям интерфейса вызова процедуры. Т.е. функция с
определенным набором входных параметров, стандарт вызова которой – соответствует
STDCALL (см. WINAPI Platform SDK).
Ниже приведен шаблон функции C/C++:
DWORD WINAPI UserProcedure(LPCTSTR* lpszIntArgs
,DWORD dwIntArgc
,CHAR** lpszArgs
,DWORD dwArgc);
lpszIntArgs – указатель на массив служебных переменных.;
dwIntArgc – количество элементов в массиве служебных переменных.;
lpszArgs – указатель на массив переменах пользователя (аргументы процедуры);
dwArgc – количество элементов в массиве переменных пользователя.
*Внимание! В текущей версии ПО Datecs CashLoader все переменные – аргументы
хранимой процедуры передаются в виде нуль терминированных строк (стандарт
C/C++).
Указатель на массив служебных переменных (lpszIntArgs) содержит следующие
элементы:
1) путь к базе данных подкачки (оперативный источник данных);
2) путь к базе данных фиксации продаж (оперативный протокол продаж);
3) путь к каталогу (почтовому ящику) хранения файлов электронных сообщений
пользователя;
4) почтовый адрес пользователя отправившего запрос на исполнение процедуры;
5) поле <Subject> электронного письма-запроса пользователя;
6) содержимое электронного письма-запроса пользователя.
Указатель на массив переменных пользователя (lpszArgs) содержит аргументы
процедуры, переданные пользователем, первый аргумент – синоним выполняемой
функции. Т.е. при вызове процедуры без аргументов, автоматически в функцию DLL
будет передан один аргумент – синоним процедуры.
9.5. Регистрация хранимой процедуры.
Регистрация хранимой процедуры (SP) выполняется средствами диалогового окна
управления внешними модулями. Основное меню->Datecs CashNET->Хранимые
процедуры.
16
Датекс Украина
Ниже показано диалоговое окно для регистрации/удаления/изменения хранимых
процедур ПО Datecs CashLoader.
Пояснения к элементам диалога.
1)
2)
3)
Синоним – альтернативное имя хранимой процедуры. Является
обязательным параметром т.к. вызов процедуры выполняется с
использование этого идентификатора.
Идентификатор – полное имя экспортируемой функции из динамически
загружаемой библиотеки (см. таблицу экспорта DLL).
Путь – полный путь к файлу загружаемой библиотеки, которая содержит
функции пользователя (хранимые процедуры).
9.6. Библиотека хранимых процедур DCL32.DLL.
В стандартный пакет поставки программного обеспечения Datecs CashLoader входит
библиотека хранимых процедур DCL32.DLL. Библиотека содержит следующий перечень
функций:
GetTotalByPeriod
InsertCommodity
Получение общей суммы (оборот) за период.
Вызов: Call <синоним>(<начальная дата>, <конечная дата>);
Формат даты YYYYMMDD.
Результат возвращается в виде электронного письма с отчетом.
Добавить артикул в оперативный источник данных (база
данных подкачки).
Вызов: Call <синоним>(<идентификатор сервера подкачки>,
<код>, <номер ряда>, <наименование>, <цена>, <штрих-код>);
Результат возвращается в виде электронного письма, где
указывается код возврата из процедуры:
17
Датекс Украина
1 - ошибка входных параметров;
2 – ошибка выполнения операции добавления записи в
оперативный источник даны.
UpdateCommodityPrice
100 – запись добавлена успешно.
Изменить цену артикула.
Вызов: Call <синоним>(<идентификатор сервера подкачки>,
<код>, <цена>);
Результат возвращается в виде электронного письма, где
указывается код возврата из процедуры:
1 - ошибка входных параметров;
2 – ошибка выполнения операции добавления записи в
оперативный источник даны.
MassCorrectPriceUp
100 – цена изменена успешно.
Массовая коррекция цен артикулов в оперативном источнике
данных.
Call <синоним> (<приращение цены>);
приращение цены – абсолютное значение в формате DDDD.NN
Результат возвращается в виде электронного письма, где
указывается код возврата из процедуры:
1 - ошибка входных параметров;
2 – ошибка выполнения операции добавления записи в
оперативный источник даны.
MassCorrectPriceDown
100 – массовая коррекция выполнена успешно.
Массовая коррекция цен артикулов в оперативном источнике
данных.
Call <синоним> (<уменьшение цены>);
уменьшение
DDDD.NN
цены
–
абсолютное
значение
в
формате
Результат возвращается в виде электронного письма, где
указывается код возврата из процедуры:
1 - ошибка входных параметров;
2 – ошибка выполнения операции добавления записи в
оперативный источник даны.
18
Датекс Украина
100 – массовая коррекция выполнена успешно.
Для подключения функций данной библиотеки в программу, необходимо
выполнить регистрацию хранимых процедур. (см. пп. 9.5)
9.7. Вызов хранимой процедуры.
Формат вызова хранимой процедуры:
CALL <синоним> ([параметр 1],[параметр 2],…,[параметр N]);
При вызове хранимой процедуры все текстовые значения аргументов передаются
без обрамляющих кавычек. В качестве разделителя для чисел с плавающей заптой
используется символ “.”.
Пример вызова:
call TotalByDate(20070101,20070431);
После вызова (успешного или безуспешного), пользователю отправляется
электронное письмо с диагностической информацией.
9.8. Datecs CashLoader API.
10. Лицензионное соглашение.
Программный продукт Datecs CashLoader (версия 3.0.1.7) является коммерческим
(платным) продуктом. Компания “Датекс Украина” распространяет данное программное
обеспечение в соответствии с заявкой потребителя. Компания оставляет за собой право
изменять стоимость программного продукта в соответствии с развитием
функциональности последнего.
Продукт Datecs CashLoader лицензируется компанией только для использования с
определенным кассовым аппаратом или группой ЭККА. Кодом для регистрации является
заводской номер и тип кассового аппарата.
1. Все авторские права на программный продукт Datecs CashLoader принадлежать
только компании АОЗТ “Датекс Украина”.
2. Организации и частные лица не имеют право использовать данную версию
продукта Datecs CashLoader в некоммерческих целях бесплатно.
3. Сервисные центры и компании партнеры АОЗТ “Датекс Украина” имеют право
использовать программный продукт данной и последующих версий в
коммерческих целях.
4. Программный продукт Datecs CashLoader (версия 3.0.1.7) требует регистрации и
распространяется по запросам частных лиц и организаций.
Компания “Датекс Украина” оставляет за собой право отказа в выполнении
запроса о предоставлении данного программного продукта.
5. АОЗТ “Датекс Украина” оставляет за собой право отменить действие данной
лицензии и правил распространения для любой из следующих версий Datecs
CashLoader.
19
Датекс Украина
6. Ни одно частное лицо или организация не может брать плату за распространение
продукта Datecs CashLoader без письменного уведомления АОЗТ “Датекс
Украина”.
7. Вы не можете использовать, копировать, эмулировать, создавать новые версии,
сдавать в наем или аренду, продавать, изменять, декомпилировать,
дизассемблировать, изучать код программы другими способами, передавать
зарегистрированную программу или любые из ее составляющих, иначе, чем
определено настоящим лицензионным соглашением. Любое такое нелегальное
использование означает автоматическое и немедленное прекращение действия
настоящего соглашения и может преследоваться по закону.
Все права, не предоставленные здесь, явно сохраняются за АОЗТ “Датекс
Украина” и разработчиком программы.
8. Если почему-либо вы не согласны с этим лицензионным соглашением, вам
необходимо удалить все файлы дистрибутива Datecs CashLoader с ваших
устройств хранения информации и прекратить использование продукта Datecs
CashLoader.
9. АОЗТ “Datecs Україна” и автор программного продукта не несет никакой
ответственности за возможные ошибки и сбои в программе Datecs CashLoader.
* Внимание.
Программный продукт Datecs CashLoader (версия 3.0.1.7) не является
окончательным вариантом сервисного комплекса для обслуживания кассовых аппаратов
производства АОЗТ “Датекс Украина” и в данный момент находится в разработке.
Компания оставляет за собой право на внесение изменений в состав программного
продукта без уведомления пользователей. На текущий момент доступна исключительно та
функциональность, которая описана в данном документе. Использование дополнительных
возможностей программы может повлечь за собой не устойчивую работу программы либо
привести к краху системы.
20