Инструменты пользователя

Инструменты сайта


кассир5:внешниемодули:externaldb

Это старая версия документа!


Внешние отложенные чеки

В «Штрих-М: Кассир 5» предусмотрен механизм работы с отложенными чеками, хранящимися во внешних базах данных. Это позволяет продолжить отложенный чек на другой кассе и для каких-либо других целей. В стандартной поставке имеется возможность хранения отложенных чеков в различных СУБД (dBase, MSSQL, MySQL), список которых можно дополнить пользовательскими без изменения конфигурации.

Функциональность

Данный класс модулей позволяет:

  • Подключаться к внешней СУБД.
  • Создать таблицу с предопределенной структурой, для хранения отложенных чеков.
  • Выполнять манипуляции с данными (запись, выборка, удаление).
  • Поиск данных и навигация по данным.

Интеграция

Для интеграции пользовательского модуля для работы с внешними отложенными чеками в систему необходимо выполнить ряд требований:

  • модуль должен быть внешней обработкой, код которой не приводит к ошибкам в контексте конфигурации «Штрих-М: Кассир 5»
  • синоним внешней обработки определяет имя в списке модулей для работы с внешними отложенными чеками в настройках программы Кассир 5.
  • внешняя обработка помещается в ExtFiles\ExternalDB каталога базы данных.
  • основная форма обработки реализует API внешних отложенных чеков.

API внешних отложенных чеков

Основная форма обработки экспортирует следующие функции:

Функция Инициализация(СтрокаНастроек) Экспорт
Функция Деинициализация() Экспорт
Функция Настройка(СтрокаНастроек) Экспорт
Функция ОткрытьФайл() Экспорт
Функция БДОткрыта() Экспорт
Функция ПолучитьКодПоследнейЗаписи() Экспорт
Функция ПолучитьСписокОтложенныхЧеков(Номер) Экспорт
Функция НайтиПоКоду(Код) Экспорт
Функция ЗакрытьФайл() Экспорт
Функция ВКонце() Экспорт
Функция ПометитьНаУдаление() Экспорт
Функция СледующаяЗапись() Экспорт
Функция УдалитьПомеченныеЗаписи() Экспорт

Функция Инициализация

Функция является обязательной к экспорту. Вызывается для инициализации объекта, реализующего взаимодействие с внешней СУБД, и подключения к СУБД.
Параметр СтрокаНастроек.
Тип – Строка. Строка содержащая настройки подключения к СУБД, которая была сохранена в базе данных при вызове функции Настройка().
Возвращаемое значение (булево) – При успешном подключении к СУБД возвращает Истину, иначе Ложь.

Функция Деинициализация

Процедура является обязательной к экспорту, выполняет закрытие открытых соединений с внешними БД.

Функция Настройка

Функция является обязательной к экспорту, вызов производится при настройке внешних отложенных чеков.
Параметры:
СтрокаНастроек (строка) – Строка содержащая настройки подключения к внешней БД. Обработка представляет свои настройки в виде строки, которая сохраняется кассовым ПО в базе данных после вызова процедуры. Параметром передаётся сохраненное ранее значение или пустая строка.

Функция ОткрытьФайл

Процедура является обязательной к экспорту, открывает (динамически) таблицу отложенных чеков.
Возвращаемое значение (булево) – При успешном открытии таблицы возвращает Истину, иначе Ложь.

кассир5/внешниемодули/externaldb.1392120522.txt.gz · Последнее изменение: 2014/02/11 12:08 — dzayonchkovskiy