Специальные команды

Спецкоманды предназначены для максимально гибкого управления ПО.

При написании наименования команд регистр символов имеет значение.

Команды можно (а иногда желательно) прописывать одновременно, каждая с новой строки. Если команда длинная, то возможно текстовое поле автоматически сделает перенос символов на новую строку, однако такой перенос не функциональный и не создаст новую команду. Новая команда создается только реальным переносом строки (клавиша Enter). Например:

INIQuery=[2]OnLine=1
ExitWindows=3
DeleteFile=c:\log.bak

ExitWindows=N

Команда позволяет единоразово выключить компьютер, перезагрузить компьютер или перезапустить только платежное ПО.

ВНИМАНИЕ! Данные команды не предназначены для работы с комбинированными INI-файлами, такими как: providers.ini, providers_user.ini, myproviders.ini.

ВНИМАНИЕ! Изменения в config.ini и config_comission.ini вступают в силу только после перезагрузки ПО. Вышеописанные команды не производят автоматическую перезагрузку ПО. Перезагрузку ПО можно назначать одновременно с этими командами (перезагрузка ПО всегда выполняется только после обработки всех команд + 3 секунды). Команду на перезапуск ПО можно дать с помощью команды ExitWindows или в настройках терминала на первой вкладке «Команды терминалу».

Дополнительная комиссия на монеты, прибавляется к общей. Команда поддерживается с версии 4.1.0.1b

coin_commission=[список провайдеров и групп]Комиссия на монеты

элемент1, элемент2, …
элемент - список диапазонов провайдеров, групп, исключений
типы элементов:
число - одиночный провайдер
число от - число до - диапазон
g - группа
! - исключение

процент%
или
номинал1:процент1%;номинал2:процент1%

Примеры.

комиссия 10% на все монеты для всех провайдеров:
coin_commission=[1-800]10%

убрать комиссию:
coin_commission=[1-800]

сложная комиссия:
coin_commission=[1-32,!5,!7,!8,98,G1-20,!G2]1:10%;2:9.9%;5:5%

Команда поддерживается с определенной версии ПО. 3.3.14b

INIQuery=Знак Условие*Имя_файла[Секция]Параметр=Значение

Знак, Условие и Имя_файла - необязательные параметры и могут быть пропущены.

Нагляднее рассмотреть работу команды на примере:

INIQuery=<>16*img\keyboards\ProvidersForm.ini[key-1]Left=21

Нужно в файле img\keyboards\ProvidersForm.ini установить в секции [key-1] значение параметра Left равным 21. Условие <>16 означает, что команда должна быть выполнена только в том случае, если предыдущее значение изменяемого параметра удовлетворяет условию. В данном примере команда будет выполнена только если Left отличен от 16. Если значение Left равно 16, то команда выполнена не будет.

Т.к. Знак, Условие и Имя_файла необязательные параметры, то команду можно сокращать. Рассмотрим сокращенные примеры:

INIQuery=16*img\keyboards\ProvidersForm.ini[key-1]Left=21

Тоже самое. Отличие в том, что отсутствие знака означает, что команда должна быть выполнена только если Left равен 16 (отсутствие знака перед условием равносильно к знаку «равно»). Если значение Left отлично от пустого значения, то команда выполнена не будет.

INIQuery=img\keyboards\ProvidersForm.ini[key-1]Left=21

Тоже самое. Отличие в том, что отсутствие знака и условия означает, что команда должна быть выполнена в любом случае, независимо от предыдущего значения Left.

Команда поддерживается с версии 2.8.

INIQuery=[Секция]Параметр=Значение

Сокращая и далее предыдущий пример, мы и придем к сокращенному виду. Таким образом сокращенный вид - это всего лишь частный случай использования команды (на практике наиболее распространенный). Команда будет применена к файла config.ini или config_comission.ini. Если [Секция] представляет собой число, то команда будет выполнена к файлу config_comission.ini (все имена секций в этом файле числовые и соответствуют номерам провайдеров). Во всех остальных случаях - config.ini (в этом файле нет ни одной цифровой секции).

Продолжая рассматривать уже знакомый пример:

INIQuery=[key-1]Left=21

В данном случае команда будет применена к файла config.ini (название секции key-1 не может быть интерпретировано как число). Пример абстрактный, т.к. в файле config.ini не предусмотрено секции [key-1] (после выполнения данной команды она будет создана с указанным параметром, однако ПО будет игнорировать эту секцию как незнакомую).

Примеры.

INIQuery=[EPort]Enabled=0

Выключить использование системы Е-Порт.

INIQuery=[Common]DisableComPort=4,10,11,12

Отключить сканирование COM-портов номер 4, 10, 11, 12. Данные ком-порты не будут сканироваться конфигуратором при поиске оборудования. Это нужно для того, если какое-либо устройство при сканировании приводит к зависанию компьютера или некорректной работе устройства. Также полезно, для отключения Bluetooth-устройств, которые сканируются крайне медленно (каждое около минуты).

INIQuery=[Common]AutoScan=0

Полностью отключить функцию сканирования COM-портов Конфигуратором для поиска устройств во время запуска. Это ускоряет загрузку Конфигуратора, однако настройку портов нужно будет выполнить самостоятельно. Либо после того, как Конфигуратор нашел устройства - можно выключить их автосканирование, чтобы при следующих запусках поиск уже не осуществлялся.

INIQuery=[Common]Skin=winter

Переключить скин на Winter (зимний).

INIQuery=[ScreenShot]Interval=10

Делать снимки экрана каждые 10 минут.

INIQuery=[39]Protocol=3

Для новых платежей на провайдера 39 (НТК) использовать протокол ПС 3 (КиберПлат). Все новые платежи по НТК будут проводится через КиберПлат. Старые платежи останутся в той ПС, в какой они были до получения команды. Для того, чтобы и старые, и новые платежи перешли на новую ПС пользуйтесь специальной удобной формой в Диспетчерской в настройках терминала на вкладке «Процессинг» (на ней можно легко перевести сразу несколько провайдеров на другую ПС, например, во время задержек платежей или если закончились средства в какой-либо ПС).

INIQuery=[23]Action2=1

Разрешить провайдеру 23 (Мегафон Сибирь) участвовать в акции 2. Бонусы по акции 2 будут выпадать для этого провайдера, если акция 2 будет включена (после включения акции должны быть определены провайдеры, которые в ней участвую, как правило выбирают только местных провайдеров для привлечения только постоянных клиентов). Про использование акций читайте в соответствующей статье.

INIDeleteSection=Секция

Удалить секцию из файла config.ini. Секция удаляется со всеми содержащимися в ней параметрами (ключами).

Пример.

INIDeleteSection=EPort

Удалить секцию Eport в файле config.ini.

INIDeleteKey=Секция*Параметр

Удаление параметра в секции. После удаления параметра (ключа) программа будет использовать значение по умолчанию для данного параметра.

Пример.

INIDeleteKey=common*TestMode

Удалить из секции common параметр TestMode

База данных терминала - это файл base.mdb. База данных представляет собой стандартный файл формата MS Access (совместима с версиями 97-2002, возможно и более новыми). Данный формат выбран по причине того, что легко открывается и редактируется при помощи программы MS Access (из комплекта программ Microsoft Office professional), либо других бесплатных утилит, например, ViewODBC.zip.

Если запрос был составлен некорректно (с технической точки зрения), то сбоя программы не произойдет, запрос просто не будет выполнен, а в Диспетчерской отобразится соответствующее сообщение. При корректном запросе в Диспетчерской отобразится сообщение об «Успешно выполненном системном SQL-запросе».

SQLQuery=Запрос

SQL-запрос к базе данных base.mdb. После выполнения команды ПО будет автоматически перезапущено!

Примеры.

SQLQuery=UPDATE PAY SET trycount=0 WHERE (timeout>=#12/30/2010#)and(status=2)

Назначить перепроведение отклоненных платежей еще раз начиная с указанной даты. Формат даты: ММ/ДД/ГГГГ. Наиболее предпочтительная команда для перепроведения отклоненных платежей, если они не старше 2-х суток.

SQLQuery=UPDATE PAY SET trycount=0, status=10 WHERE (timeout>=#12/30/2015#)and(status=2)

Назначить перепроведение отклоненных платежей еще раз начиная с указанной даты. Формат даты: ММ/ДД/ГГГГ. Эту команду следует применять, если требуется перепроведение отклоненных платежей старше двух дней. Если менее 2-х дней, то предпочтительнее использовать предыдущую команду. Как побочный эффект - платежи могут отклониться один раз.

SQLQuery=UPDATE PAY SET trycount=0, status=10, timeout=NOW() WHERE (timeout>=#12/30/2015#)and(status=2)

Назначить перепроведение отклоненных платежей еще раз начиная с указанной даты и изменить дату создания платежа на текущую. Формат даты: ММ/ДД/ГГГГ. Эту команду следует применять в крайних случаях, если требует перепроведение отклоненных платежей старше двух дней и платежная система не принимает платежи с просроченной датой создания (например, Е-Порт). Если менее 2-х дней, то предпочтительнее использовать первую команду. Как побочный эффект - платежи могут отклониться один раз.

SQLQuery=UPDATE PAY SET status=1, informtype=0 WHERE (status>=10)

Все неотправленные и действующие платежи отметить как успешно прошедшие и больше не проводить. Формат даты: ММ/ДД/ГГГГ.

SQLQuery=UPDATE PAY SET status=1, informtype=0 WHERE (status>=10)AND(timeout<=(NOW()-2))

Все неотправленные и действующие платежи старше 2-х дней отметить за успешные (для случаев переполнения буферов базы).

SQLQuery=UPDATE PAY SET status=1, informtype=0 WHERE (account="9132701024")and(timeout>=#12/30/2015#)

Все платежи с номером 9132701024 начиная с указанной даты как успешно прошедшие и больше не проводить. Формат даты: ММ/ДД/ГГГГ.

SQLQuery=UPDATE PAY SET SessionPP="1"+RIGHT(SessionPP,14), status=10, informtype=0 WHERE (status=2)and(protocol=5)and(timeout>=#03/26/2015#)and(timeout<=#03/28/2015#)

Задать принудительное перепроведение платежей PinPay совершенных с 26 по 27 марта. Перепроведение будет под видом новых платежей, даже если функция перепроведения отключена. Формат даты: ММ/ДД/ГГГГ.

SQLQuery=DELETE * from STATSERVER WHERE Status=0

Удалить все неотправленные сообщения для сервера PayPRO.

• Примечание 1. При указании даты, вместо строгой точной даты #ММ/ДД/ГГГГ# можно задавать дату относительно текущей NOW(). Например, NOW()-2 будет означать текущую дату минус 2 дня, т.е. 2 дня назад. NOW()-7 будет означать текущую дату минус 7 дней, т.е. 7 дней назад

• Примечание 2. Значения параметра status смотрите в статье Внутренние коды ПО.

• Примечание 3. Значения параметра informtype:
  0 информация о платеже не синхронизирована с сервером мониторинга PayPRO (т.е. следует обновить информацию о платеже на сервере PayPRO);
  1 информация о платеже уже передана на сервер PayPRO и ее не следует передавать повторно.
  Параметр не является важным и его можно опускать. Влияет только на отображении информации о платеже в поиске на сервере PayPRO.

SQLResultToLog=Запрос

Сохранить в лог (error.log) результат выполнения SQL-запроса. После этой команды удобно сразу же прописывать команду выгрузки лога в Диспетчерскую для анализа.

Пример.

SQLResultToLog=SELECT * FROM PAY WHERE (timeout>=(NOW()-2))

Сохранить в лог всё содержимое базы данных начиная с 2-х дней назад и по текущую дату.

CompactDataBase=1

Сжатие и восстановление базы данных (не удаляя данные). Из базы окончательно удаляются только данные, ранее помеченные на удаление (при удалении данных в базе base.mdb они не удаляются, а только помечаются к удалению и становятся невидимыми пользователю).

OptimizationDataBase=1

Оптимизировать базу данных и каталогов (удаляя и архивируя старые данные).

UpLoadDataBaseSQL=N

Выгрузить на сервер копию базы данных за последние N дней.
Возможно использовать вместе с командой UpLoad_LinkToSupport=1.

Пример.

UpLoadDataBaseSQL=2.5

Сделать дамп базы за последние 2.5 дня и выгрузить его на сервер.

AutoUpdate=Путь/Имя_Файла

Загрузить обновление на терминал из файла с сервера [www.paypro.ru/T3/]Путь/Имя_Файла.zip (только архив ZIP).

Пример.

AutoUpdate=PayPRO_3216b+_321709b.zip

Обновить ПО из файла www.paypro.ru/T3/PayPRO_3216b+_321709b.zip.

UpLoad=Имя_Файла1[,Имя_Файла2,Имя_ФайлаN]

Загрузить указанные файлы с терминала на сервер.

Пример.

UpLoad=logs\error_31_12_2015.zip,providers.ini,providers_user.ini,VIP\9122121111.ini

Загрузить файлы с терминала: лог за 31.12.2015, файлы providers.ini и providers_user.ini, а также файл VIP\9122121111.ini (настройки комиссии VIP-клиента с номером телефона 9122121111).

UpLoad_LinkToSupport=1

Автоматически передать загружаемый файл разработчикам.
Команда может использоваться только совместно с командами выгрузки файлов UpLoad и UpLoadDataBaseSQL. Необходимо прописать единожды после любой команды выгрузки.

DeleteFile=Имя_Файла

Удалить файл. При удалении файла из вложенных папок, имя файла может быть задано с путём до файла (абсолютным или относительным).

С версии 3.3.20 добавлена поддержка масок файлов: Например, стало можно писать так DeleteFile=VIP\*.ini и так DeleteFile=d?f*.b??e.

Примеры.

DeleteFile=vip\9132701024.ini

Удалить файл с настройками VIP-клиента (равносильно удалению VIP-клиента).

DeleteFile=c:\log.bak

Удалить файл c:\log.bak.

CopyFile=Имя_Файла1*Имя_Файла2

Копировать файл. Если файл цели (Имя_Файла2) существует то сначала нужно его удалить командой DeleteFile.

Пример.

CopyFile=Updates\PayPRO_26_2648b.zip*Updates\CurrentUpdate.zip

Скопировать в папке с загруженными обновлениями файл PayPRO_26_2648b.zip под другим именем CurrentUpdate.zip. Это приведет к тому, что после перезагрузки ПО, оно будет обновлено из этого файла. Таким образом можно вернуть версию ПО к старой версии.

MoveFile=Имя_Файла1*Имя_Файла2

Переместить файл. Если файл цели (Имя_Файла2) существует то сначала нужно его удалить командой DeleteFile.

RenameFile=Имя_Файла1*Имя_Файла2

Переименовать файл. Если файл цели (Имя_Файла2) существует то сначала нужно его удалить командой DeleteFile.

CreateDir=Имя_Каталога

Создать каталог.

DeleteDir=Имя_Каталога

Удалить каталог.

Error_log_EX=1[,N]

Включить расширенный режим протоколирования в error.log на N дней.
Если N не указывать, то до конца текущего дня.
Максимальное количество дней допустимое для указания 7.

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

Примеры.

Error_log_EX=1

Включает расширенную запись в лог до окончания текущего дня.

Error_log_EX=1,5

Включает расширенную запись в лог на 5 дней. После истечении этого срока запись в лог будет производиться в обычном режиме. Такой большой интервал нужен для поиска ошибок, которые редко проявляются.

Error_log_EX=0

Преждевременно выключает расширенный режим записи в лог.

Error_log_ver3=1[,N]

Включить режим протоколирования обработки собственных форм ввода информации в error.log на N дней.
Если N не указывать, то до конца текущего дня.
Максимальное количество дней допустимое для указания 7.

В данном режиме будет логироваться больше событий, связанных с нажатием на кнопки, описанные в ini-файлах собственных настраиваемых форм. Данный режим работы требуется в основном только разработчикам.

TestMode=N

Включить режим отладки ПО.

Отличия от основного режима:

• ввод суммы платежа с помощью кнопок (имитация купюр);
• отображение данных от ПС;
• отображение данных от устройств.

При работе с файлами все имена файлов могут быть заданы вместе с путями до них. Пути могут быть заданы как относительные от папки с ПО, так и абсолютные с названием диска.
Применительно к файлам на терминале регистр символов не имеет значения (особенность ОС Windows использующейся на терминале).
Применительно к файлам на сервере регистр символов имеет значения (особенность ОС Linux использующейся на сервере).

GetDirTree=Путь

Построить дерево каталогов с размером файлов и записать его в файл error.log. Построение папок с количеством файлов больше 1000 может занять несколько минут!

Примеры.

GetDirTree=c:\windows\temp

Построить дерево временной папки Windows.

GetDirTree=updates

Построить дерево папки Updates находящейся в папке с ПО. В этой папке хранятся ранее загруженные обновление предыдущих версий.

GetDirTree=

Построить дерево папки с ПО.
Внимание! Это может занять несколько минут в течение которых терминал не будет отвечать на нажатия кнопок.

GetSystemInfo

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

Команда поддерживается с версии 3.3.1b.

Замена блоков текста в файлах по маске. Возможность производить несколько замен в каждом файле одновременно.

FileReplace=[маска_файла_1,..,маска_файла_N]|текст_старый|текст_новый...|текст_старый_N|текст_новый_N

Символ разделителя масок , фиксирован.
Символ разделителя текста | фиксирован.

Пример.

FileReplace=info*.txt|ООО "Платеж"|ИП Платежкин П.С.

Замена текста ООО «Платеж» на ИП Платежкин П.С. в файлах info*.txt корневой папки.

Команда поддерживается с версии 3.3.1b.

Расширенная версия от FileReplace.
Синонимичное название - FileReplEX. Замена производится с параметрами:

FileReplEX=[параметры][разделитель]files=[маска_файла_1,..,маска_файла_N][разделитель]текст_старый[разделитель]текст_новый[разделитель]текст_старый2[разделитель]текст_новый2

где [параметры] в любом порядке, через запятую параметр=значение:

виды Escape-последовательностей:

Пример.

FileReplaceEX=delim=;,esc=1;providers\*.txt,def_user.base;12278;4565;\n\n;\n

Замена текста 12278 на 4565, два переноса строк на один перенос. Разделитель ;
Замену произвести во всех текстовых файлах в папке providers, а также в файле def_user.base.
Включен режим Esc-последовательностей, в котором \n распознается как перенос строки.

CreateScreenShot=Имя_Файла

Создать снимок экрана. Поддерживается только формат JPG (качество 75%). Чтобы загрузить скриншот на сервер воспользуйтесь командой UpLoad=Имя_Файла.

Пример.

Пошлем обе команды в одном запросе (пропишем их каждую с новой строки):

CreateScreenShot=1.jpg
UpLoad=1.jpg

Первая команда создаст снимок экрана, сохранив его в папке с ПО под именем 1.jpg.
Вторая команда выгрузит этот файл на сервер (в Диспетчерскую, файл будет доступен в разделе Файлы → Файлы переданные с терминалов).

Encashment=<печать> <дата ISO> <время>

Примеры:

Encashment=1

Произвести инкассацию с печатью чека

Encashment=0

Произвести инкассацию без печати чека

Encashment=0 2015-11-17 18:08:59

Произвести инкассацию без печати чека, на дату 2015-11-17 18:08:59

MuxaConfigToLog 

Сохраняет в лог настройки профиля Muxa

Prebalans=Текст или символ
Postbalans=Текст или символ

Эти 2 команды служат для настройки вывода баланса с SIM-карты.

Пример.
При запросе баланса выводиться следующий текст : Viygray 5 putevok na more, summa na schete:100rub
Значит команды должны выглядеть следующим образом :

Prebalans=summa na schete:
Postbalans=rub

Разделение платежа по разным секциям

KKM_DivideToSections=N

Где N число (от 1 до 30) указывающие в какую секцию будет записан платеж
Если N=0 то функция выключена

Команда поддерживается с версии 3.4.*

Примеры: Перезагрузка модема

modem_command=AT+CFUN=1,1

Собственный номер мегафона

AT+CUSD=1,"*205#",15

Собственный номер мегафона для Huawei модемов

AT+CUSD=1,"2A19AC3602",15

Результат команды можно узнать в логе (error.log)

Добавляет нового пользователя для админ меню

Пример:

NewAMUser=login:9999999999,name:Alex,group:admin,password:1234

параметр group может принимать следующие значения:

admin - Полный доступ ко всем функциям меню
collector - Доступны только функции для инкассации
engineer - Доступны только функции для тестирования терминала

Изменяет существующего пользователя админ меню

Пример:

EditAMUser=login:9999999999,group:engineer

Удаляет пользователя админ меню

Пример:

DelAMUser=login:9999999999

Командой crypt (отправленной через диспетчерскую на терминал) можно зашифровать файлы providers_user.ini, myproviders.ini, providers.ini терминальным паролем. Т.е. указанные файлы уже должны находится на терминале.

формат:

crypt=<Файл1>

или

crypt=<Файл1>,<Файл2> 

Шифрует Файл1 терминальным паролем и сохраняет как Файл2. Если Файл2 не задан то сохраняется под тем же именем.

При необходимости «безопасно» передать свои файлы providers_user.ini, myproviders.ini, providers.ini на терминал, их можно предварительно зашифровать с помощью утилиты cryptbf.7z своим собственным паролем или паролем по умолчанию (если при шифровании поле с паролем оставить пустым). Таким образом, если гипотетический злоумышленник перехватит файл с сервера или при отправки на терминал - расшифровать его он уже не сможет.

1. Если файл зашифрован собственным паролем, то этот пароль необходимо «сообщить» терминалу. Для этого необходимо на терминале запустить утилиту и нажать «сохранить пароль». Неудобство этого способа в топ что для выполнения этой операции нужно находится у терминала, но пароль можно задать единожды и в дальнейшем (используя один и тот-же пароль) нет необходимости выезжать к терминалу.
2. Если файл зашифрован паролем по умолчанию (его знают лишь пару разработчиков в нашей компании), то выезжать к терминалу нет необходимости (терминальное ПО с версии v.4.1.5 этот пароль уже «знает»). И в этом случаи зашифрованный файл относительно безопасно можно удаленно передать на терминал.

Не зависимо от того каким из двух способов будет зашифрован файл, отправив его на терминал, нужно зашифровать его терминальным паролем (формат команды описан выше). Если Файл1 зашифрован пользовательским паролем он будет сначала расшифрован, а после автоматически зашифрован с помощью терминального пароля.