Документация по модулю Msgs и принадлежащим к нему страницам перенесена в Confluence
http://abills.net.ua:8090/display/AB/Msgs

Msgs

Модуль обратной связи. Позволяет отправлять уведомления пользователям и получать уведомления от пользователей. Есть возможность отправлять сообщения определённой группе пользователей или все пользователям вместе. При заходе в свой WEB акаунт пользователь сразу видит новые сообщения.

Возможности:

  • Разделы поддержки по темам.
  • Приоритет сообщений.
  • Флаг состояния сообщения (открыто, закрыто не решено, закрыто решено)
  • Флаг Ответа по телефону
  • Настраиваемые уровни компетенции службы поддержки (служба поддержки, администраторы, старший администратор)
  • Показывать сообщения в зависимости от компетенции.
  • Перенос сообщений по уровнях компетенции.
  • Возможность прикреплять контент к сообщению ( можно добавлять несколько файлов, прикреплённые изображения покажутся в сообщении )
  • Календарный план заданий: на повестке, решённые
  • Оповещение оповещений через E-mail
  • Форма заведения новых заявок на подключение.
  • Шаблоны быстрых ответов (в разработке)
  • Опросник

Установка

abills/libexec/config.pl

@MODULES = (
        'Msgs'
        );

Управление

config.pl

$conf{MSGS_REDIRECT_FILTER_ADD}='EXEC:/usr/local/bin/sudo /usr/abills/misc/msgs_filter.sh %ACTION% %UIDS%;RAD:mpd-table-static+=«100=%IP%»'; Принудительный редирект в клиентский кабинет для прочтения сообщения. Детальнее как настроить
$conf{MSGS_REDIRECT_FILTER_DEL}='EXEC:/usr/local/bin/sudo /usr/abills/misc/msgs_filter.sh %IP%'; Команда на удаление фильтра, после прочтения сообщения
$conf{MSGS_REG_REQUEST}=1; Включить веб форму получения заявок на подключение от пользователей.
После включения этой опции появляется форма заполнения заявки https://192.168.1.40:9443/registration.cgi
Для работы этой функции нужно включить режим регистрации Регистрация клиентов через веб интерфейс. При включении данной функции абоненты подают заявки на подключения без реальной регистрации в сети
$conf{MSGS_UNREAD_FORWARD}='GID:MESSAGE_CHAPTER:URL;GID:MESSAGE_CHAPTER:URL'; Перенаправлять пользователя на определённую страницу при оправке ему личного сообщения. Пользователь перенаправляется только при условии что он соответствует указанной группе и сообщение принадлежит указанному разделу сообщений. Можно указывать несколько правил разделённых точкой с запятой
До адреса перенаправления добавляются следующие параметры:
GID - Группа пользователя
MESSAGE_CHAPTER - Раздел сообщения

Например:
для всех групп абонентов и для раздела 2 перенаправлять на страницу
$conf{MSGS_UNREAD_FORWARD}='0:2:http://yoururl_com?GID=11&MESSAGE_CHAPTER=5';
$conf{MSGS_INNER_DEFAULT}=1; По умолчанию отмечать сообщение как внутренние
$conf{MSGS_TAGS_NON_PRIVILEGED}=1; Разрешить всем, у кого есть доступ к модулю Msgs, редактировать теги сообщения
$conf{MSGS_ATTACH2FILE} = 1; Сохранять прикрепления к сообщениям на диск в папку Abills/templates/attach/msgs. Работает вместе с $conf{ATTACH2FILE} = 1;
$conf{MSGS_USER_REPLY_SECONDS_LIMIT} = 0; Не позволять пользователю создавать сообщения чаще, чем указано ( в секундах )
$conf{MSGS_USER_DEFAULT_CHAPTER} = 0; Устанавливает раздел по умолчанию для заявок пользователей (выбранное значение в списке разделов)

Для выполнения команды поднятия и опускания фильтра с правами супер пользователя нужно её добавить в файл /usr/local/etc/sudoers

www   ALL = NOPASSWD:   /usr/abills/misc/msgs_filter.sh

Для выполнения на удалённых машинах следует использовать конструкцию:

/usr/bin/ssh -i /usr/abills/Certs/id_rsa.abills_admin -o StrictHostKeyChecking=no -q abills_admin@xxx.xxx.xxx.xxx  "/usr/local/bin/sudo /usr/abills/misc/msgs_filter.sh 78.154.174.196";

Настройка системы

Работа с системой

Шаблоны

msgs_dispatch_blank.tpl

ID Номер
DATE Дата выписки
COMMENTS коментарий
CREATED создана
PLAN_DATE дата планируемого выполнения
STATE соятояние
CLOSED_DATE дата завершения
AID ID администратора создавшего наряд
RESPOSIBLE_ID ID ответственного за наряд
ADMIN_FIO ФИО администратора создавшего наряд
RESPOSIBLE_FIO ФИО ответственного за наряд

Табличная часть

xx - номер по порядку

ORDER_NUM_xx Номер
ORDER_PERSONAL_INFO_FIO_xx Фамилия клиента
ORDER_PERSONAL_INFO_ADDRESS_xx Адрес
ORDER_PERSONAL_INFO_PHONE_xx Телефон
ORDER_PERSONAL_INFO_LOGIN_xx Логин
ORDER_PERSONAL_INFO_PASSWORD_xx Пароль
ORDER_PERSONAL_INFO_xx Информация о клиенте
ORDER_JOB_xx список работ
ORDER_SUBJECT_xx тема
ORDER_CHAPTER_xx раздел