Включение отслеживания входящих событий для WebSphere Business Events

С помощью WebSphere Business Events можно включить мониторинг во входящих приложениях J2C.

Прежде чем начать

Важное замечание: Не устанавливайте несколько адаптеров ресурсов как автономные на одном сервере, особенно если они предназначены для одного и того же типа EIS (например CICS ECI 8.0.0.0 и CICS ECI 8.0.0.1). Это связано с тем, что все автономные адаптеры ресурсов используют один и тот же загрузчик классов.
Важное замечание: WebSphere Business Events V7 работает совместно с WebSphere Application Server V7.x. На сервере WebSphere Application Server v8.0 продукт WebSphere Business Events не поддерживается. Дополнительная информация о продукте WebSphere Business Events приведена на следующей веб-странице: Информация о продукте WebSphere Business Events. Инструкции по установке WebSphere Business Events приведены на следующей веб-странице: Руководство по установке продукта WebSphere Business Events и работе с ним. WebSphere Business Events работает совместно с WebSphere Application Server v7.0. Дополнительная информация о выключении функции мониторинга событий приведена в разделе Выключение монитора событий.

Процедура

  1. Выберите Файл > Создать > Другое > J2C.
  2. Выберите Объект J2C и нажмите кнопку Далее.
  3. На странице Выбор адаптеров ресурсов выберите нужный тип адаптера ресурса.

    Доступные адаптеры ресурсов с поддержкой WebSphere Business Events:

    • JD Edwards v. 6.2.0.2 и v. 7.0.0.0.
    • Oracle v. 6.2.0.2 и v. 7.0.0.0.
    • PeopleSoft v. 6.2.0.1.
    • SAP v. 6.2.0.2 и v. 7.0.0.0.
    • Siebel v. 6.2.0.2 и v. 7.0.0.0.
    Выбор адаптера ресурса
  4. Выберите соответствующий адаптер ресурса и нажмите кнопку Далее.
  5. На странице Импорт коннектора в поле Проект коннектора примите имя по умолчанию или введите другое имя проекта. В поле Целевой сервер выберите WebSphere Application Server V7 и нажмите кнопку Далее.
    Страница Импорт коннектора
  6. На странице Параметры коннектора нажмите кнопку Обзор и выберите все файлы системы SAP:
    • sapjco3.jar
    • sapjco3.dll
  7. На странице Стиль адаптера выберите Inbound, затем выберите Включить мониторинг входящих событий и нажмите кнопку Далее.
    Страница Стиль адаптера
  8. На странице Конфигурация событий и JMS можно указать провайдера JMS для функции мониторинга событий.
    Страница Конфигурация событий
    1. В поле Тип события выберите WebSphere Business Events.
    2. В поле Имя JNDI фабрики соединений раздела примите значение по умолчанию jms/wbeTopicConnectionFactory или введите другое имя JNDI фабрики соединений раздела.
    3. В поле Имя JNDI раздела примите значение по умолчанию jms/WBE/CbeListener или введите другое имя JNDI раздела.
    4. Выберите Дополнительно для настройки дополнительных свойств:
      1. Конфигурация удаленного модуля JNDI: Конфигурация удаленного провайдера JNDI позволяет настроить remoteTopic (удаленная очередь для поддержки WebSphere Business Monitor).
        Прим.: Если имя шины в локальной ячейке совпадает с именем шины в удаленной ячейке, то приложение всегда подключается к локальной ячейке. Поскольку конечные точки провайдера, указанные для фабрики соединений, не используются, информация о конфигурации удаленного раздела игнорируется. Дополнительная информация о конфигурации удаленного раздела приведена на следующей веб-странице: Настройка соединения с сервером начальной загрузки не по умолчанию
        1. В поле Хост URL модуля именования введите URL удаленного сервера.
        2. В поле Порт URL модуля именования введите номер порта удаленного сервера.
      2. В поле Конфигурация идентификации соединения - Имя пользователя введите имя пользователя.
      3. В поле Конфигурация идентификации соединения - Пароль введите пароль.
  9. Нажмите кнопку Далее.
  10. На странице Конфигурация поиска укажите информацию о соединении с сервером SAP:
    1. Имя хоста (обязательное): Имя хоста сервера SAP.
    2. Номер системы (обязательное): Номер системы сервера SAP.
    3. Имя сервера: Имя сервера SAP.
    4. Номер порта: Номер порта сервера SAP.
    5. Имя пользователя (обязательное): Имя пользователя для подключения к серверу SAP.
    6. Пароль (обязательное): Пароль для подключения к серверу SAP.

      Для настройки дополнительных свойств SAP выберите Показать дополнительные параметры.

  11. На странице Поиск и выбор объектов выберите Поиск IDoc в системе и нажмите кнопку Фильтр:
    Страница Поиск объекта
  12. На странице Свойства фильтра для поиска IDoc в системе введите ORDER* в поле Поиск объектов по данному шаблону и нажмите кнопку OK:
  13. Выберите ORDERS05 и нажмите кнопку Добавить:
    Добавить объект
  14. На странице Параметры конфигурации ORDERS05 примите значения по умолчанию и нажмите кнопку OK, затем нажмите кнопку Далее:
    Страница Свойства конфигурации
  15. На странице Настройка составных свойств рядом с полем Операции служб для выбранного IDoc нажмите кнопку Добавить и выберите действия, которые вы хотите выполнить над объектами:
    Настройка составных свойств
  16. На странице Настройка общих свойств рядом с полем Значения IDoc для идентификации выбранных операций выберите нужное значение и нажмите кнопку OK.
  17. На странице Настройка составных свойств в поле Папка введите имя целевой папки для сохранения созданного бизнес-объекта и нажмите кнопку Далее.
    Прим.: Сохраните созданные файлы схемы в отдельной папке для облегчения экспорта этих файлов в целью создания модели монитора. Файлы создаются в подпапке eventMonitor указанной папки. Если папка не указана, то файлы схемы создаются в корневом каталоге проекта.
  18. На странице Создание объекта J2C и настройка развертывания введите имя проекта EJB (WBMSAPProject) и нажмите кнопку Создать для создания нового проекта EJB. На странице проекта EJB выполните следующие действия:
    1. Убедитесь, что в поле Имя проекта показано значение SapInboundWBE .
    2. В поле Целевая среда выполнения выберите WebSphere Application Server v7
    3. Выберите Добавить в файл EAR и введите WBMSAPProjectEAR в поле Имя проекта EAR
    4. Примите другие значения по умолчанию и нажмите Готово.
      Страница проекта EJB
  19. На странице Конфигурация развертывания и создания J2C можно создать локальный интерфейс EJB, вспомогательный класс, объект сеанса и объект, управляемый сообщениями, содержащий входящие процессы. Заметьте, что объект EJB, объект сеанса и объект, управляемый сообщениями, создаются автоматически. Во входящей модели управляемые сообщениями объекты спроектированы для получения внешних сообщений EIS. Все адаптеры ресурсов должны реализовать javax.resource.spi.ResourceAdapter, который имеет пять методов. Сервер приложений получает доступ к этим методам для управления жизненным циклом адаптера ресурсов и предоставления уведомлений при развертывании конечной точки сообщения. Для того чтобы получить определенное сообщение EIS, получатель (объект, управляемый сообщениями) должен проявить интерес к загрузке этого сообщения, реализовав получатель сообщения. Класс ActivationSpec представляет конфигурацию, требуемую адаптером ресурсов для установки соединения между EIS и объектом, управляемым сообщениями. Адаптеры ресурсов используют ActivationSpec развернутого объекта, управляемого сообщениями, для создания и управления взаимосвязью между EIS и MDB через адаптер ресурсов. Для настройки ActivationSpec нажмите кнопку Создать рядом с полем Имя JNDI.
    Создание объекта JavaBean J2C
  20. На странице Создать спецификацию активации J2C введите информацию о подключении к системе SAP и нажмите кнопку Готово. Затем вернитесь на страницу Создание объекта J2C и настройка развертывания и нажмите кнопку Готово.
    Страница Спецификация активации J2C
  21. Выберите проект EJB, затем выберите Проект > Очистить для создания и повторной компиляции файлов.
  22. Файл eventMapping описывает преобразование между событием и схемой бизнес-объекта, которое требуется продукту WebSphere Business Event для мониторинга событий. (Это явное действие, которое не создается вместе с другими артефактами). Для создания EventBOTypeMapping.xml и EventBOTypeMapping.xsd выполните следующие действия:
    1. Щелкните правой кнопкой мыши на сеансовом объекте.
    2. Выберите Исходный код > Создать преобразование событий:
      Создать преобразование событий
      Файлы EventMapping создаются в той же папке, в которой расположены файлы схемы бизнес-объектов. В данном примере файлы создаются в папке BOFolder. После изменения или рефакторинга бизнес-объектов или методов требуется повторное создание файла eventMapping.
  23. Следующие артефакты создаются в ходе создания этого приложения:
    • Файлы определения схемы XML (.xsd), используемые для определения событий из папки eventMonitor.
    • Записи данных расположены в папке ejbModule. Внутри каждого класса данных можно найти соответствующее определение схемы.
    • Классы Java™
      Файлы Java
      Табл. 1.
      SAPInboundEJB.java Класс интерфейса
      SAPInboundEJBMSB.java JavaBean сеанса
      SAPInboundEJBMDB.java Объект EJB, управляемый сообщениями
      SAPInboundEJBMDBEventInterceptor.java Класс перехватчика событий
      SAPInboundEJBMDBHelper.java Класс MDBHelper
      EventBOTypeMapping.xml Преобразование eventBOType
      EventBOTypeMapping.xsd Схема eventBOType
      JavaBean J2C прослушивает входящие события и с помощью перехватчика событий перехватывает их и направляет на сервер через очередь JMS.
  24. Разверните приложение адаптера, содержащего объект, управляемый сообщениями, на сервере WebSphere Business Events, который может прослушивать события, поступающие из информационной системы предприятия (EIS), и публиковать их в инфраструктуре общих событий (CEI). На сервере WebSphere Business Event необходимо выполнить дополнительные действия по настройке мониторинга конкретных событий. Объект J2C прослушивает входящие события и с помощью перехватчика событий перехватывает их и направляет на сервер через очередь JMS. Дополнительная информация о публикации событий на сервере WebSphere Business Events приведена на следующей веб-странице Мониторинг событий EIS на сервере WebSphere Business Events.

Комментарии