Плагин ABilling

Плагин предназначен для интеграции ERP с биллинговой системой ABilling(BGBilling).

Функционал плагина:

  • поиск договоров по базе биллингов;

  • создание и модификация параметров договоров;

  • привязка договоров к контрагентам;

  • копирование параметров контрагентов в договора;

  • создание базы контрагентов по базе договоров.

Методика использования

Интеграция с ABilling не является необходимой для ERP. ERP не сохраняет данные биллинга, но предоставляет интерфейс доступа к ним и позволяет привязывать объекты биллинга к процессам. В ERP может производится учёт процессов обслуживания, подключения, отключения абонентов. В момент создания процессов параметры договоров, такие как адрес, описание и т.п. копируются в процесс и используются в работе. В отдельные параметры имеет смысл копировать информацию, которая используется для поиска либо требуется отдельно. Например, адрес. Всё остальное предпочтительно собрать в текстовый блок описания процесса. Это упрощает работу и оптимизирует хранение данных.

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

На заключительном шаге интеграции договора в биллинге могут быть полностью лишены параметров, сохраняя в себе лишь данные необходимые для функционирования биллинга. Печатные формы в этом случае генерируются также в ERP и сохраняют информацию о реквизитах на момент подписания.

Система ERP может быть интегрирована с несколькими биллингами, представляя центральное хранилище всех протекающих процессов. Адресный справочник ERP и всех биллингов должен быть синхронизирован. При нескольких биллингах центральным местом ведения адресов выступает ERP. Если биллинг один и на первом этапе интеграции возможна настройка обратной синхронизации, когда адреса переносятся из биллинга в ERP.

Конфигурация плагина ABilling

Общие переменные конфигурации

Возможность поиска договоров по логину/алиасу DialUp модуля.

bgbilling:search.contract.<id>.type=dialUpLogin
bgbilling:search.contract.<id>.title=<title>
bgbilling:search.contract.<id>.billingId=<billingId>
bgbilling:search.contract.<id>.moduleId=<moduleId>

Где:

  • <id> - уникальный идентификатор режима поиска договора;

  • <billingId> - идентификатор биллинга;

  • <moduleId> - код экземпляра модуля DialUp.

Пример:

bgbilling:search.contract.1.type=dialUpLogin
bgbilling:search.contract.1.title=Логин VPN
bgbilling:search.contract.1.billingId=bg
bgbilling:search.contract.1.moduleId=1

Предложение к процессу задач плагина CRM привязанных договоров.

bgbilling:offerTasksForLink=1

Серверы биллинга

Для добавления биллингов в конфигурации сервера добавляют конструкции вида:

bgbilling:server.<n>.id=<id>
bgbilling:server.<n>.title=<title>
bgbilling:server.<n>.url=<url>
bgbilling:server.<n>.version=<version>
# необязательные параметры
bgbilling:server.<n>.customerIdParam=<paramId>
bgbilling:server.<n>.timezone=<timezone>
bgbilling:server.<n>.requestTimeOut=<timeout>

Где:

  • <n> - уникальный порядковый номер биллинга в конфигурации;

  • <id> - строковый идентификатор биллинга, короткая строка, именно на него ссылаются все остальные записи в конфигурации;

  • <title> - отображаемое наименование;

  • <url> - URL для подключения к сервлету executer биллинга;

  • <version> - версия, поддерживаются 5.1 - 7.0;

  • <param_id> - код текстового параметра договора в биллинге, в котором сохраняется код контрагента, к которому привязан данный договор;

  • <timezone> - временная зона сервера, например Europe/Moscow;

  • <timeout> - таймаут ожидания ответа сервера биллинга в мс.

Например:

bgbilling:server.1.id=avantys
bgbilling:server.1.title=Avantys
bgbilling:server.1.url=http://http:a-billing.com/executer
bgbilling:server.1.version=7.0
bgbilling:server.1.customerIdParam=100

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

bgbilling:server.<n>.markerRequestParam=<markerParam>:<markerValue>
bgbilling:server.<n>.contract_pattern.<pat_num>.title_pattern=<pattern>
bgbilling:server.<n>.crm.problem.status.list=<status_list>
bgbilling:server.<n>.copyParamMapping=<mapping>

Где:

  • <markerParam>:<markerValue> - наименование и значение дополнительного "маркерного" параметра HTTP запроса к данному биллингу, для возможности простого разделения запросов в логах;

  • <pat_num> - код шаблона договора из биллинга;

  • <pattern> - шаблон нумерации договоров по этому шаблону при создании их из ERP;

  • <status_list> - перечень статусов проблем в ERP плагине ABilling, по-умолчанию "0:открыта;1:принята;2: закрыта".

  • <mapping> - правила копирования параметров контрагента в договор, см. далее.

В параметре <mapping> могут быть определены разделённые точкой с запятой значения вида <cust_id>:<billing_id>.

Где:

  • <cust_id> - числовой код параметра контрагента либо customerTitle - наименование контрагента; для списковых параметров указывается код параметра и коды значениий в квадратных скобках после кода;

  • <billing_id> - числовой код параметра договора биллинга; для списковых параметров указывается код параметра и коды значениий в квадратных скобках после кода.

Например:

bgbilling:server.11.copyParamMapping=15:9;72:46;73:5;74:51;75:68;76:69;77:56;78:7;1
4:8;12:6;109:48;110:50;114:12;115[1,2]:25[4,3];customerTitle:1

Обращение к биллингу осуществляется с использованием логина и пароля пользователя ERP. Возможна установка отличного логина и пароля в конфигурации пользователя:

bgbilling:login=<login>
bgbilling:password=<pswd>

Либо настройка логина и пароля для конкретного биллинга. Возможно также переопределение только логина либо только пароля.

bgbilling:login.<billingId>=<login>
bgbilling:password.<billingId>=<pswd>

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

Единый договор

Единый договор - это привязанный к адресу номер-префикс, с которым создаются договора услуг на данном адресе. Договора услуг могут быть созданы в различных биллиингах. Номер договора услуги начинается с номера единого договора и заканчивается кодом услуги. Номер единого договора начинается с префикса области, далее следует порядковый номер.

Для включения функционала единого договора в конфигурации сервера необходимо добавить:

# Флаг для включения использования типа объекта "Единый договор"
bgbilling:commonContract.enabled=true

# код параметра контрагента с адресами услуг, параметр должен поддерживать
множественное значение
bgbilling:commonContract.customerAddressParamId=<customerParamId>
# код параметра "Адрес" единого договора, параметр необходимо создать в редакторе параметров
bgbilling:commonContract.addressParamId=<commonContractParamId>
# соотношение областей городам
bgbilling:commonContract.cityAreaIds=<city_areas>
# формат номера единого договора, состоит из кода области и порядкового номера в области
bgbilling:commonContract.titleFormat=(${area:00})(${number:000000})
# формат номера сервисного договора в биллинге, разрешено изменять только длину
кода типа (:00)
bgbilling:commonContract.serviceContractTitleFormat=(${common})(${type:00})

# политика паролей для ЕД
bgbilling:commonContract.password.length.min=5
bgbilling:commonContract.password.length.max=10
bgbilling:commonContract.password.length.auto=10
# Используется при выключенном флаге isSecurePass=false для генерации простого пароля
bgbilling:commonContract.password.chars=0123456789
# Используется при включенном флаге isSecurePass=true для генерации безопасного пароля
bgbilling:commonContract.password.extendedChars="1234567890qwertyuiopasdfghjklzxcvbnmQWERTYUIOPASDFGHJKLZXCVBNM@$!*?&"
# Флаг для включения генерации сложного безопасного пароля,
# с валидацией по regex ^(?=.*[0-9])(?=.*[@$!*?&])(?=.*[a-z])(?=.*[A-Z])[0-9a-zA-Z@$!*?&]{length.min,length.max}$
bgbilling:commonContract.password.isSecurePass=true

Где:

  • <city_areas>- соотношение кодов городов из адресного справочника кодам областей, в каждом из кодов областей осуществляется последовательная нумерация единого договора.

Пример:

bgbilling:commonContract.customerAddressParamId=12
bgbilling:commonContract.addressParamId=93
bgbilling:commonContract.titleFormat=(${area:00})(${number:000000})
bgbilling:commonContract.serviceContractTitleFormat=(${common})(${type:00})
bgbilling:commonContract.cityAreaIds=37:51;1:72

Единые договора создаются в карточке контрагента.

Типы договоров

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

bgbilling:contractType.<n>.title=<title>
bgbilling:contractType.<n>.billing=<billing_id>
bgbilling:contractType.<n>.patternId=<pattern_id>
bgbilling:contractType.<n>.tariffList=<tariff_list>
# необязательно, если не указано, то считается равным -1
bgbilling:contractType.<n>.tariffPosition=<tariff_pos>
# указывается только при использовании единых договоров
# необязательно - код области ЕД, договор данного типа можно создавать только для ЕД в данной области
bgbilling:contractType.<n>.commonContractAreaCode=<area_code>
bgbilling:contractType.<n>.serviceCode=<service_code>

Где:

  • <n> - уникальный порядковый номер типа в конфигурации;

  • <title> - наименование типа договора;

  • <billing_id> - строковый идентификатор биллинга;

  • <pattern_id> - код шаблона договора в биллинге;

  • <tariff_list> - перечень разделённых через точку с запятой записей вида <id>:<title>, где <id> -код тарифа в биллинге, <title> - обозначение тарифа;

  • <area_code> - код области ЕД;

  • <service_code> - код услуги договора, используется только в связке с единым договором, иначе параметр можно пропустить;

  • <tariff_pos> - позиция, с которой будет добавлен тариф (если выбран): -1 - заменить тарифом первый текущий тариф, либо добавить с позицией 0, если тарифа нет; >= 0 - тариф будет добавлен к существующем в договоре с данной позицией.

Синхронизация адресных справочников

Необходима в случае совместного использования адресных параметров в ERP и биллингах. Например: создания процессов с адресами из договоров, импорта контрагентов и т.п.

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

Импорт контрагентов из договоров

Использование контрагентов не является обязательным при интеграции ERP с ABilling. Возможна работа с договорами посредством Web-интерфейса в ERP, к договорам могут быть привязаны процессы. Контрагент позволяет выделить параметры специфичные для непосредственно клиента либо организации в отдельную сущность. Например, актуальные контакты, паспортные данные, банковские реквизиты. Такжа контрагент позволяет сгруппировать договора организации/клиента. Наиболее оптимально импортировать контрагентов вторым этапом интеграции.

Общее описание алгоритма импорта:

  1. Из базы биллинга выбирается следующий договор с текстовым полем Код контрагента = 0 (код поля настраивается, само поле нужно создать в биллинге).

  2. Наименование контрагента извлекается из комментария договора биллинга.

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

  4. Если в шаге 2 контрагент не найден, то контрегент ищется по ключевым параметрам, после чего для найденных контрагентов определяется степень несовпадения наименования с наименованием контрагента договора. Если расстояние Левенштейна между двумя наименованиями не превышает указанного в конфигурации значения, то контрагент считается установленным. К наименованию контрагента в ERP добавляется новый вариант написания через символ пайпа (|). В дальнейшем правильный вариант написания предстоит установить оператору.

  5. Если контрагент не найден при прямом и обратном поиске - создаётся новый контрагент.

  6. К созданному контрагенту привязывается договор, в него импортируются параметры договора.

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

bgbilling:creator.confirmParameters=<confirm_params>
bgbilling:creator.searchParameters=<search_params>
bgbilling:creator.titleDistance=<title_dist>
bgbilling:creator.importParameters=<import_params>
bgbilling:creator.importBillingIds=<billing_ids>

Где:

  • <confirm_params> - подтверждающие параметры контрагента, коды через запятую;

  • <search_params> - ключевые параметры контрагента, коды через запятую;

  • <title_dist> - максимальное расстояние Левенштейна;

  • <import_params> - импортируемые из договора параметры контрагента;

  • <billing_ids> - идентификаторы биллингов, из которых запускается импорт, если не указано - каждый запуск в планировщике инициирует импорт для всех биллингов.

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

# необязательный параметр, если шаблона нет - то группа выставляется всем
контрагентам
bgbilling:creator.parameterGroupRule.<id>.contractTitlePattern=<title_pattern>
#
bgbilling:creator.parameterGroupRule.<id>.paramGroupId=<param_group>
bgbilling:creator.parameterGroupRule.<id>.titlePatternId=<title_pattern_id>

Где:

  • <id> - уникальный числовой идентификатор правила, правила просматриваются в порядке их идентификаторов;

  • <param_group> - группа параметров контрагента;

  • <title_pattern> - REGEXP выражение, с которым сравнивается номер договора;

  • <title_pattern_id> - код шаблона имени контрагента.

И для каждого из серверов биллинга записи:

#
bgbilling:creator.server.<id>.billingId=<billing_id>
bgbilling:creator.server.<id>.user=<user>
bgbilling:creator.server.<id>.pswd=<pswd>
bgbilling:creator.server.<id>.paramMapping=<mapping>
bgbilling:creator.server.<id>.pageSize=<page_size>
#

Где:

  • <id> - уникальный числовой идентификатор;

  • billing_id> - строковый идентификатор биллинга;

  • <user>, <pswd> - логин и пароль пользователя биллинга, под которым осуществляется импорт;

  • <page_size> - количество договоров для импорта, выбираемых за один раз;

  • <mapping> - соотношение договоров контрагента и биллинга, разделённые точкой с запятой пары <код параметра контрагента>:<код параметра договора> для простых параметров и <код параметра контрагента>[<коды значений спискового параметра через запятую>]:<код параметра договора>[<коды значений спискового параметра через запятую>] - для спискового типа; если маппинг не задан, то код значения спискового параметра будет импортирован "как есть" из биллинга.

Дополнительные необязательные параметры:

#
bgbilling:creator.server.<id>.minCustomerTitleLength=<minTitleLength>
#

Где:

  • <minTitleLength> - мнимально допустимая длина наименования контрагента (комментария договора) с которым будет предпринята попытка импорта, если параметр не указан, то значение по-умолчанию равно 10.

При импорте поддерживаются параметры договоров и, соответственно, контрагентов типа: "дата", "текст", "адрес", "телефон", "список". Параметры дата и текст перетирают значение параметра в договора, адрес, телефон и список - дополняют.

Параметр контрагента типа email может быть импортирован из аналогичного либо текстового параметра биллинга.

Пример конфигурации импорта контрагентов:

# загрузчик контрагентов
# дата рожд, адреса услуг, сот. телефон(ы), паспорт с.-н.
bgbilling:creator.confirmParameters=73,12,14,74
# поиск по с.-н. паспорта, адресам услуг, сот. телефонам
bgbilling:creator.searchParameters=74,12,14
# расстояние по Левинштейну
bgbilling:creator.titleDistance=2
# кодовая фр., дата рожд., с.-н. пасп., д.в. пасп., кем выд. пасп, адрес проп.,
тел. гор, тел. сот, адрес(а) усл.
bgbilling:creator.importParameters=72,73,74,75,76,77,78,14,12
#
# группа параметров контрагента
bgbilling:creator.parameterGroupRule.1.paramGroupId=3
#
bgbilling:creator.server.1.billingId=ds
bgbilling:creator.server.1.user=bgcrm
bgbilling:creator.server.1.pswd=bgcrmv2
bgbilling:creator.server.1.paramMapping=72:456;73:386;74:457;75:458;76:459;77:460;78:401;14:399;12:42;46:378;115[1,2]:421[14575,14576]
bgbilling:creator.server.1.pageSize=10
#
bgbilling:creator.server.2.billingId=tks
bgbilling:creator.server.2.user=bgcrm
bgbilling:creator.server.2.pswd=bgcrmv2
bgbilling:creator.server.2.paramMapping=72:95;73:51;74:96;75:97;76:98;77:99;78:59;14:60;12:9,80,83
bgbilling:creator.server.2.pageSize=10

Импорт контрагента можно инициировать вручную в карточке договора, либо настроить в планировщике.

Настройка импорта в планировщике

Для настройки импорта контрагента по таймеру добавьте в конфигурацию планировщика класс ru.bgcrm.plugin.bgbilling.creator.CustomerCreator, например:

scheduler.task.1.class=ru.bgcrm.plugin.bgbilling.creator.CustomerCreator
scheduler.task.1.minutes=2,12,22,32,42,52

Мониторить выполнение задачи можно по логам.

Конфигурация типа процесса

В конфигурацию типа процесса возможна установка следующих параметров.

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

bgbilling:processLinkedContract.<n>.groupIds=<groupIds>
bgbilling:processLinkedContract.<n>.titleRegexp=<titleRegexp>
bgbilling:processLinkedContract.<n>.billingIds=<billingIds>

Где:

  • <n>- порядковый номер правила;

  • <titleRegexp> - REGEXP номера договора;

  • <billingIds> - строковые идентификаторы биллингов через запятую, к которым может относится договор

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

Для отключения привязки контрагента к процессу при привязке относящегося к нему договора:

bgbilling:linkCustomerOnContractLink=0

Отображение на вкладках в карточке процесса процессов привязанных договоров:

bgbilling:processShowLinkContractProcess=1

Выглядит так, для каждогов привязанного договора добавляется дополнительная вкладка:

bgbilling 1

Создание процесса с привязанными объектами

Переменная в конфигурации типа процесса:

create.in.objectTypes=<типы объектов через запятую>

Типы объектов плагина: contract:<billingId> - договор в биллинге с идентификатором <billingId>.

Интеграция с плагином Document

Для вкладки документов карточки единого договора в конфигурации типов документов указывать scope=bgbilling-commonContract, для документов карточки договора scope=bgbilling-contract.

Расширения пространства имён

bgbilling-contractCard( <billingId>, <loginAndPswd>, <contractId> ) - получение из биллинга со строковым идентификатором billingId> XML документа карточки договора с кодом <contractId>, запрос осуществляется под пользователем и паролем <loginAndPswd> - две строки разделены двоеточием;

bgbilling-commonContract( <commonContractId> ) - получение XML документа с параметрами единого договора с кодом <commonContractId>

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

bgbilling 2

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

Карточка "Контрагент"

Вкладка "Договоры"

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

bgbilling 3

Единый договор можно удалить а также перейти на его карточку нажав по номеру-ссылке. Единый договор связан с договором услуги посредством номера.

Во вкладке единого договора отображаются привязанные к единому договору договоры услуги. Можно создавать сконфигурированные типы договоров нажав на кнопку Создать договор

bgbilling 4

Карточка "Процесс"

В карточке процесса возможно отображение привязанных к процессу проблем из CRM плагина ABilling. Данный функционал полезен в переходный этап миграции на ERP, когда часть служб работает в плагине CRM биллинга.

bgbilling 5

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

bgbilling:processShowLinkedProblems=1
# описание создаваемых проблем подставлять описание процесса, опционально
#bgbilling:processLinkProblemSetProcessDescription=1
# требование по статусам привязанных проблем - запрет перехода процесса в определённый статус, пока привязанные проблемы не будут в нужных статусах
#bgbilling:processToStatus.<processStatusCode>.
needLinkedProblemsStatus=<billingId>:<statusCode>;<billingId1>:<statusCode1>..

Где:

  • <processStatusCode> - статус, в который переходит процесс;

  • <billingId> - идентификатор биллинга;

  • <statusCode> - код статуса проблемы, который должен стоять при переходе процесса.

bgbilling:processShowCommonContract=1

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

bgbilling:processShowLinkedContractsInfo=memo
bgbilling 6

[#card_single_contract == Карточка "Единый договор"

Карточки единых договоров открываются в буфере Единые договоры.

bgbilling 7
bgbilling 8

По нажанию на кнопку (*) доступно изменение номера единого договора, его периода и пароля.

Карточка "Договор"

Карточка договора открывается в буферы Договоры и отображает основные параметры договора в биллинге.

bgbilling 9

Кнопка изменения контрагента (*) позволяет убрать привязку контрагента к договору либо привязать договор к одному из открытых в буфере Контрагенты контрагентов. Кнопка Импорт вызывает импорт параметров из договора в выбранного контрагента, либо создаёт контрагента в соответствии с правилами импорта контрагентов и привязывает его к договору.

Кнопка Открыть в биллинге - позволяет быстро открыть вкладку договора клиенте ABillingClient. Для этого клиент биллинга должен быть подключен к серверу под тем же пользователем, что и текущий пользователь в ERP. Для открытия договора - нажать кнопку и перейти в клиент биллинга. Быстрый переход предназначен для операций с договором, не реализованных через интерфейс ERP.

Создание договоров в биллинге

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

Для создания договора выбрать биллинг, шаблон. В конфигурации сервера биллинга для шаблонов договоров может быть указан шаблон нумерации. Выбираемые контрагенты должны быть открытыми в буферы Контрагенты.

Интеграция с плагином HelpDesk биллинга

Возможности

Настройка связки ERP с плагином HelpDesk ABilling-а позволяет:

  • получать отображение тем HelpDesk одного или нескольких биллингов в виде процессов ERP, автоматически привязываемых к договору и (если есть) к контрагенту;

  • вести переписку в темах с помощью стандартного механизма сообщений;

  • устанавливать статусы тем, стоимость, менять исполнителей из карточки процесса в ERP; учитывать дополнительные параметры, привязанные к процессам HelpDesk.

Настройка

Для сопоставления пользователя ERP пользователю биллинга в конфигурации пользователей должно быть установлено:

bgbilling:userId.<billingId>=<billingUserId>

Где:

  • <billingId> - идентификатор сервара биллинга в конфигурации;

  • <billingUserId> - код пользователя в биллинге, получить можно нажатием Ctrl+i в таблице с пользователями ABilling.

Пример:

bgbilling:userId.bg=3

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

messageType.<id>.title=<title>
messageType.<id>.billingId=<billingId>
messageType.<id>.class=ru.bgcrm.plugin.bgbilling.dao.MessageTypeHelpDesk
messageType.<id>.user=<user>
messageType.<id>.pswd=<pswd>
messageType.<id>.processTypeId=<processTypeId>
messageType.<id>.openStatusId=<openStatusId>
messageType.<id>.closeStatusId=<closeStatusId>
messageType.<id>.costParamId=<costParamId>
messageType.<id>.statusParamId=<statusParamId>
messageType.<id>.autoCloseParamId=<autoCloseParamId>
messageType.<id>.pageSize=<pageSize>
messageType.<id>.newMessageEvent=<event>
# необязательные
messageType.<id>.markMessagesReadStatusIds=<readStatusIds>
# добавлять первое сообщение в описание процесса
messageType.<id>.addFirstMessageInDescription=1

Где:

  • <id> - код типа сообщения;

  • <billingId> - строковый идентификатор сервера биллинга;

  • <user> - пользователь биллинга, под которым ERP будет производить периодическое сканирование тем для синхронизации;

  • <pswd> - пароль пользователя биллинга <user>;

  • <processTypeId> - тип создаваемого процесса;

  • <openStatusId> - код статуса, в который процесс переводится при открытии темы не из ERP;

  • <closeStatusId> - код статуса, в который процесс переводится при закрытии темы не из ERP;

  • <costParamId> - код текстового параметра процесса со стоимостью обращения;

  • <statusParamId> - код спискового параметра процесса со статусом темы, значения должны соответствовать занесённым в справочник ABilling;

  • <autoCloseParamId> - код спискового параметра с флагом автозакрытия темы, должно быть одно значение 1=Да;

  • <pageSize> - количество отслеживаемых тем HelpDesk, можно выставить в 10000;

  • <event> - 1, если необходимо генерировать событие при поступлении нового сообщения в тему, при первичном импорте лучше установить в 0 - не генерировать;

  • <readStatusIds> - коды статусов процессов, при переводе в которые все сообщения помечаются прочитанными (необязательно).

Тип процесса должен существовать, у него должны присутствовать указанные выше параметры и статусы, переходы в которые должны быть разрешены.

Пример настройки.

#
messageType.2.title=HD
messageType.2.billingId=bg
messageType.2.class=ru.bgcrm.plugin.bgbilling.dao.MessageTypeHelpDesk
messageType.2.user=bgcrm
messageType.2.pswd=bgcrm
messageType.2.processTypeId=3
messageType.2.costParamId=23
messageType.2.statusParamId=25
messageType.2.autoCloseParamId=24
messageType.2.openStatusId=1
messageType.2.closeStatusId=4
messageType.2.pageSize=100000
messageType.2.newMessageEvent=1
messageType.2.markMessagesReadStatusIds=2,3,4,5
#

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

Процесс, связанный с темой HelpDesk выглядит примерно следующим образом. Работа производится через стандартную вкладку с сообщениями процесса. Там же могут присутствовать сообщения других типов: EMail переписка, заметки.