...

В конфигурации сервера.

Каждый интегрируемый форум должен быть настроен отдельным типом сообщения. Сообщение считается входящего типа.

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

# форум
phpbb:linkParamId=<paramId>
phpbb:topicMark=<topicMark>
phpbb.forum.bitel.url=<url>
# дополнительные необязательные параметры
phpbb:userNameParamId=<userNameParamId>

Где:

• <paramId> - код текстового параметра процесса, содержащего ссылку на тему форума;
• <topicMark> - строка, помечающая тему форума как отслеживаемую в CRM;
• <url> - URL форума;
• <userNameParamId> - код текстового параметра пользователя, содержащего логин пользователя на форуме.

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

# параметры подключения к БД PHPBB
phpbb:forum.<forumId>.messageType.<id>.title=<title>
messageType.<id>.class=ru.bgcrm.plugin.phpbb.dao.MessageTypeForumPost
messageType.<id>.userNameParamId=<userParamId>
messageType.<id>.topicMark=<markText>
messageType.<id>.url=<forumUrl>
messageType.<id>.db.driver=com.mysql.jdbc.Driver
phpbb:forummessageType.<forumId><id>.db.url=<dbUrl><jdbcUrl>
phpbb:forummessageType.<forumId><id>.db.user=<dbUser><jdbcUser>
phpbb:forummessageType.<forumId><id>.db.pswd=<dbPswd>

...

<jdbcPswd>

Параметры, отличные от прочих типов сообщений:

• <forumId> - уникальный строковый идентификатор;
• <dbUrl> - код текстового параметра процесса, содержащего ссылку на тему форума;
• <topicMark> - строка, помечающая тему форума как отслеживаемую в CRM;
• <dbUrl> - URL для подключения к БД форума;
• <dbUser> - пользователь с правами на чтение для подключения к БД форума;
• <dbPswd> - пароль пользователя для подключения к БД форума<userParamId> - код параметра пользователя в BGCRM, в котором указан пользователь форума, необходим для определения, кого оповещать о новых сообщениях;
• <markText> - строка, добавляемая в конце наименований тем форума, для отметки их связи с BGCRM;
• <forumUrl> - URL форума, необходим для генерации корректной ссылки в сообщении, позволяющей быстро перейти в тему форума из интерфейса BGCRM;
• <jdbcUrl>, <jdbcUser>, <jdbcPswd> - параметры подключения к БД форума с правами SELECT, UPDATE.

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

phpbb:linkParamId=20
phpbb:messageType.7.title=Форум BiTel
messageType.7.class=ru.bgcrm.plugin.phpbb.dao.MessageTypeForumPost
messageType.7.userNameParamId=30
messageType.7.topicMark= (CRM)
phpbb:forummessageType.bitel7.url=http://forum.bitel.ru
phpbb:forummessageType.bitel7.db.driver=com.mysql.jdbc.Driver
phpbb:forummessageType.bitel7.db.url=jdbc:mysql://sql.bgbilling.ru:3306/forum
phpbb:forummessageType.bitel7.db.user=forumxxxx
phpbb:forummessageType.bitel7.db.pswd=******

В конфигурации текстового параметра имеет смысл установить опцию showAsLink=1.

...

xxxx

...

Синхронизация с форумом производится стандартной задачей обработки сообщений .

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

onProcessEvent.1.events=messageAdded
onProcessEvent.1.ifExpression=process.getStatusId() != 1
onProcessEvent.1.commands=setStatus:1
#
onProcessEvent.2.events=messageAdded
onProcessEvent.2.commands=emailNotifyExecutors:21:Новые сообщения в процессе

Интерфейс пользователя

В необходимых типах процессах параметр "Ссылка на форум" отображается как параметр, в который возможно внести URL темы форума.

Image Removed

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

Image RemovedПривязка к теме форума добавляется как обычное сообщение. В качестве параметра указывается код темы. Привязанная тема отмечается текстовым маркером (CRM), что позволяет быстро определить, что тема уже заведена в системе. Добавленное сообщение отображается с ссылкой быстрого перехода непосредственно в форум.

Image Added