...

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

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

Рекомендуется забирать сообщения во внешний сервис не напрямую из очереди Oracle, а с использованием брокеров сообщений, таких как ActiveMQ. Такой подход позволит:

...

        <route>
            <from uri="oracleTopic:topic:AIS_NET.HYDRA_MESSAGES?clientId=ActiveMQ&amp;durableSubscriptionName=HP"/>
            <to uri="activemq:queue:hydra_messages"/>
        </route>

До 

BEGIN
  DBMS_AQADM.GRANT_SYSTEM_PRIVILEGE(
    GRANTEE => 'AIS_PROVISIONING',
    PRIVILEGE => 'MANAGE_ANY'
  );

  DBMS_AQADM.grant_queue_privilege (
   privilege     =>     'DEQUEUE',
   queue_name    =>     'AIS_NET.HYDRA_MESSAGES',
   grantee       =>     'AIS_PROVISIONING',
   grant_option  =>      TRUE);
END;
/
GRANT EXECUTE ON DBMS_AQIN TO AIS_PROVISIONING;
/

После 

Отключение бизнес-хуков

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

Структура сообщений

Бизнес-хуки передаются в формате XML и состоят из элементов:

• message_type_id - идентификатор записи из базового справочника "Тип сообщения" (REF_TYPE_MessageType)
• message_type_code - код записи из базового справочника "Тип сообщения" (REF_TYPE_MessageType)
• version - (пустое значение, зарезервировано для будущих версий)
• created_at - время отправки сообщения в таймзоне БД

• payload - подробности события, состав зависит от типа сообщения:

  Код типа сообщения	Событие	Состав сообщения
  		Элемент	Описание
  MESSAGE_TYPE_Payment	Актуализация платёжного поручения или проведение платежа	document_id	Идентификатор платежного поручения
  		account_id	Идентификатор лицевого счета, на который зачислен платеж
  MESSAGE_TYPE_Charge	Информация о начислении	charge_log_id	Идентификатор акта начислений
  		charge_log_line_id	Идентификатор строки акта начислений
  		change_balance_type_id	Идентификатор значения из базового справочника "Тип изменения баланса" (REF_TYPE_ChangeBalanceType)
  MESSAGE_TYPE_CreditLimit	Изменение суммы кредитного лимита	document_id	Документ-основание
  		account_id	Идентификатор лицевого счета
  MESSAGE_TYPE_Correction	Проведение корректировок	account_id	Идентификатор лицевого счета
  		charge_log_id	Идентификатор акта начислений по корректировке
  MESSAGE_TYPE_StopSrvProv	Прекращение оказания услуг	charge_log_id	Идентификатор акта начислений
  MESSAGE_TYPE_ArchiveDoc	Архивирование документа	charge_log_id	Идентификатор акта начислений
  MESSAGE_TYPE_AutoTopUp	Подписка на автоплатеж	account_id	Идентификатор лицевого счета
  		auto_top_up_id	Идентификатор подписки
  		auto_top_up_state_id	Состояние автоплатежа
  MESSAGE_TYPE_SubjValue	Изменение значения дополнительного параметра субъекта	subject_id	Идентификатор субъекта
  		subject_type_id	Тип субъекта
  		additional_value_type_id	Тип доп. параметра
  		additional_value_id	Идентификатор доп. параметра
  		additional_value	Значение доп. параметра
  MESSAGE_TYPE_AutoTopUpPayment	Результат проведения автоплатежа. Добавлено в 6.2.0.28	account_id	Идентификатор лицевого счета
  		request_state_id	Статус проведения автоплатежа
  		refuse_reason_Id	Причина неуспешного проведения автоплатежа. Необязательное поле.
  MESSAGE_TYPE_ChangeDocState	Изменение состояния документа (6.2.0.39)	document_id	Идентификатор документа
  		document_type_id	Тип документа
  		new_state_id	Новое состояние документа
  		old_state_id	Старое состояние документа

  
  

  
  

Примеры сообщений

<message>
  <message_type_id>1208</message_type_id>
  <message_type_code>MESSAGE_TYPE_Payment</message_type_code>
  <version/>
  <created_at>2022-01-28T12:12:00</created_at>
  <payload>
    <payment>
      <document_id>12811629901</document_id>
      <account_id>178500901</account_id>
    </payment>
  </payload>
</message>

...

<message>
  <message_type_id>8208</message_type_id>
  <message_type_code>MESSAGE_TYPE_SubjValue</message_type_code>
  <version/>
  <created_at>2022-07-11T08:11:36</created_at>
  <payload>
    <subject_value>
      <subject_id>397259401</subject_id>
      <subject_type_id>18001</subject_type_id>
      <additional_value_type_id>18101</additional_value_type_id>
      <additional_value_id>397259501</additional_value_id>
      <additional_value/>
    </subject_value>
  </payload>
</message>

<message>
  <message_type_id>13208</message_type_id>
  <message_type_code>MESSAGE_TYPE_AutoTopUpPayment</message_type_code>
  <version/>
  <created_at>2022-04-22T13:23:21</created_at>
  <payload>
    <atu_payment>
      <account_id>188983101</account_id>
      <request_state_id>3197</request_state_id>
      <refuse_reason_id>51198</refuse_reason_id>
    </atu_payment>
  </payload>
</message>

<message>
  <message_type_id>14208</message_type_id>
  <message_type_code>MESSAGE_TYPE_ChangeDocState</message_type_code>
  <version/>
  <created_at>2024-04-26T15:19:31</created_at>
  <payload>
    <change_doc_state>
      <document_id>188983101</document_id>
      <document_type_id>7002</document_type_id>
      <new_state_id>4003</new_state_id>
	  <old_state_id>3003</old_state_id>
    </change_doc_state>
  </payload>
</message>