Настройка внешнего вида чеков (динамический код)

Для формирования вида чеков используется динамический код. Чтобы использовать динамический код для формирования вида чека, в конфигурацию плагина прописывается следующий (или любой другой подходящий) класс:

# динамический класс для формирования вида чека
checkbuilder=ru.bitel.bgbilling.cashcheck.SimpleCheck

Пример класса идёт в комплекте с плагином. Подразумевается, что класс обязательно должен быть и должен сработать. О работе с динамическим кодом можно прочитать в соответствующем разделе справки. Внутри можно проверить любые условия и сформировать чек любой формы для каждой позиции/платежа, добавляемой в чек.

Методы динамического класса служат для настройки внешнего вида чеков.

  • Позиция - это несколько строк, представляющие одну позицию в чеке, добавляются в объект check с помощью addPayment/addString

  • Один раз должна присутствовать установка платежа addPayment( ), это будет "фискальная" строка, которая собственно представляет собой продажу, в этой строке может быть ещё одна строка, типа наименование продажи и отдел. Теоретически может не быть фискальной строки, в печать не выведется тогда платёж, но внимание - по всем остальным признакам платёж пометится напечатанным. Замечание касается работы с фискальным оборудованием. При печати на произвольном принтере (термопринтере или обычном) возможно формирование с помощью скриптов любых данных для вывода.

  • В остальных строках - по одному параметру String, которая выведется

  • Или: прямой текст указан, так и выведется

    • И**ли: просто ничего (пробел), это будет пустая строка, типа вертикальная табуляция (например, для красоты при отделении блоков текста друг от друга и т.д.)

Примеры кода:

  • Добавление позиции

public void addPayment( Payment payment, Check check, Printer printer ) throws BGException
{
// 1) строка сумма-контракт, плюс отдел (если надо, то вычисляется в этом же скрипте)
check.addPayment( payment.getSumma(), payment.getContractTitle(), 0 );
// 2) строка с каментом
check.addString( payment.getContractComment() );
// 3) пустая строка
check.addString( " " );
}

  • Завершение формирования

public void endCreate( Set<Integer> cids, Check check, Printer printer ) throws BGException
{
check.addString( "footer 1" );
check.addString( "footer 2" );
check.addString( "footer 3" );
}
Обратите особое внимание, что в каждом скрипте формирования внешнего вида чека (а именно происходит формирование каждой отдельной позиции чека) обязательно должна присутствовать ровно одна команда addPayment для всех устройств, являющихся ККМ. Дополнительно может быть любое количество addString. Для устройств, представляющих обычный принтер, для FOP-устройств (см. ниже) и т.п. команда addPayment не нужна, так как там не происходит добавление продажи во внутреннюю память. Но сумма платежа будет считаться только для позиций, добавленных через addPayment.

Далее приведём пример кода "добавление позиции" для формирования FO-документа, для FOP-драйвера. Эти строки соответствуют шаблону cashcheck_pko.xsl, находящемуся в стандартной поставке сервера печати.

import bitel.billing.common.*;
import bitel.billing.server.admin.bean.*;

//…
//Сумма платежа: "120,00р." (делаем одну строку addPayment, чтобы общая сумма посчиталась)
check.addPayment( payment.getSumma(), String.valueOf(payment.getSumma()) + "р.", 0 );
//Номер договора
check.addString( payment.getContractTitle() );
//Фамилия клиента: "ИВАНОВ И.И."
check.addString( payment.getContractComment() );
//Дата платежа: 20-04-2009
check.addString( TimeUtils.format( payment.getDate(), "dd-MM-yyyy" ) );
//Организация: ООО "ПРОВАЙДЕР"
check.addString( "ООО \"ПРОВАЙДЕР\"" );
//ФИО кассира (пользователя биллинга)
UserManager um = new UserManager( con );
User user = um.getUserByID( payment.getUserID() );
check.addString( user.getName() );
//Тип платежа: "СПД  №"
check.addString( "СПД  №" );
//Сумма прописью: "Сто двадцать рублей 00 коп"
check.addString( SummaToString.summaToString( String.valueOf(payment.getSumma()), true ) );
//…

В данном случае мы формируем 8 строк с произвольной информацией, которая передаётся в FOP-драйвер сервера печати, который из напрямую передаёт в FO-шаблон обычной линейной xml. Это позволяет формировать документ из любых строк, подготовленных в скрипте и из любого написанного шаблона.

Также в методы класса передаётся объект "printer" - объект "принтер", на который производится печать. Это может понадобиться, например, при наличии двух разных принтеров и желания печатать на них разного вида информацию и на разные принтеры использовать разные скрипты (например, для FOP и ККМ скрипты всегда разные будут). Например, можно получить ид принтера (такой, какой он в конфиге плагина):

int printerId = printer.getId();