Сервер обмена

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

Путь к папке обмена: - место хранения файлов обмена (основной путь)

Путь к папке запроса: - запросы внешнего сервера, заполняется при различии папок запросов и ответов (будет добавлено к папке обмена), если пустой то используется папка обмена

Путь к папке ответа: - ответы сервера h2o, заполняется при различии папок запросов и ответов (будет добавлено к папке обмена), если пустой то используется папка обмена

• если в начале стоит символ "/" - то берется путь от корня www-сервера
• если в начале стоит "ftp://" - то используется ftp-протокол обмена и адрес задается в виде ftp://имя_сервера

Стартовый час выгрузки - час суток после которого осуществляется выгрузка суточного баланса

Имена файлов обмена - имена файлов обмена строятся из полей, разделенных точкой:

sig.YYYYMMDD.command.txt - ежедневный отчет

sig.YYYYMM.command.txt - отчет за месяц

sig.YYYY.command.txt - отчет за год

• sig - Сигнатура файла (по умолчанию h2o)
• YYYYMMDD - Дата файла в формате ГОД[МЕСЯЦ][ДЕНЬ](8 знаков - за день, 6 - знаков за месяц, 4 знака - за год)
• command - команда обмена:
  • input - входящий файл от внешней системы
  • output - исходящий файл от сервера H2O
  • query - файл запроса от внешней системы
  • answer - исходящий файл от сервера H2O ответа на запрос
• txt - признак типа данных (по умолчанию txt - текстовые файлы)

Формат файлов обмена - файлы обмена текстового типа состоят из текстовых строк с полями через разделители

Формат загрузки - порядок полей в файле загрузке
  Строки начинающиеся со знака коментария игнорируются
  Строки начинающиеся со знака разделителей полей в формате загрузки переопределяют порядок по умолчанию для этого файла загрузки

Разделитель данных - разделителитель полей данных в текстовых файлах

Символ комментария - символ в начале строки в текстовых файлах, который вызывает пропуск обработки данных

Признак юридического лица - идентификатор для обозначения клиента - юридическое лицо в номере счета

Формат даты обмена - формат даты в текстовых файлах обмена (SQL нотация переменной DATE_FORMAT)

Код услуги "Водопотребление" - код услуги для обозначения водопотребления, переменная WATER_COD, поле WATER_CODE

Переменные - переменные для заполнения файлов обмена

• WATER_COD - Код услуги "Водопотребление"
• DATE_FORMAT - формат даты в текстовых файлах обмена
  • %d - день месяца: 00
  • %f - секунды с милисекундами: SS.SSS
  • %H - часы: 00-24
  • %j - день года: 001-366
  • %J - юлианский номер дня
  • %m - месяц: 01-12
  • %M - минуты: 00-59
  • %s - секунды от 01.01.1970 (UNIX время)
  • %S - секунды: 00-59
  • %w - день недели 0-6 начиная с Воскресенья
  • %W - номер недели в году: 00-53
  • %Y - год: 0000-9999
• DATE_START - начальная дата формирования отчета
• DATE_END - конечная дата формирования отчета

Поля - поля данных для заполнения/чтения файлов обмена

• PIN - номер личного счета, основное поля для однозначной идентификации клиентов.
  Сравнение как строк, т.е. 00001 не равно 1
• FIO 123 - Фамилия Имя Отчество потребителя и порядок полей (L - фамилия, F - имя, M - отчество)
• LNAME - Фамилия
• FNAME - Имя
• MNAME - Отчество
• BALANS - баланс потребителя в рублях, дробные - копейки (пересчитывается в воду по текущему тарифу)
• PAY - оплата потребителя в рублях, дробные - копейки (пересчитывается в воду по текущему тарифу), не учитывается если есть BALANS
• TAX - текущий тариф отгрузки, если не указан, то применяется тарифы из системы
• WATER_CODE - Код услуги "Водопотребление"
• DT - дата
• DN - номер дня в году
• WATER_QUBE - потребление воды в т.=м³
• WATER_LITR - потребление воды в литрах
• WATER_COUNT - количество посещений
• ADDRESS - адрес потребителя
• SEX - пол
• WLIMIT - лимит разовой отгрузки
• PHONE - телефон
• EMAIL - электронная почта

Знак перед полем - для управления склейкой значений

• "+" - пробел
• "&" - запятая и пробел
• "-" - в одну строку без разделителей

Например если во внешней системе адрес записан в нескольких полях, то можно склеить входящие поля в одно поле
Допустим приходит 4 поля: город, улица, дом, квартира
А у нас одно поле ADDRESS, тогда в настройках входящих указываем их как
ADDRESS|&ADDRESS|&ADDRESS|&ADDRESS
и тогда в базу в поле ADDRESS будет добавлено "город, улица, дом, квартира"