Ativando o Monitoramento de Evento de Entrada para o WebSphere Business Events

É possível ativar o monitoramento usando o WebSphere Business Events em seus aplicativos de entrada J2C.

Antes de Iniciar

Importante: Não instale vários adaptadores de recursos como independentes no mesmo servidor de runtime, principalmente se eles forem para o mesmo tipo de EIS (por exemplo, CICS ECI 8.0.0.0 e CICS ECI 8.0.0.1). Todos os adaptadores de recursos independentes compartilham o mesmo carregador de classes e, portanto, ambos não podem ser instalados.
Importante: O recurso WebSphere Business Events V7 funciona com o WebSphere Application Server V7.x O WebSphere Business Events não é suportado no WebSphere Application Server v8.0. Para obter informações sobre o WebSphere Business Events, consulte: Informações do WebSphere Business Events. Para obter informações sobre como instalar o WebSphere Business Events, consulte: Guia de Operações e Instalação do WebSphere Business Events. O WebSphere Business Events é suportado no WebSphere Application Server v7.0. Para obter informações sobre como desativar a função de monitor de eventos, consulte Desativando o Monitor de Eventos.

Procedimento

  1. Selecione Arquivo > Novo > Outro > J2C.
  2. Selecione Bean J2C e clique em Avançar.
  3. Na página Seleção de Adaptadores de Recursos, selecione o tipo de adaptador de recursos que deseja usar.

    Adaptadores de recursos disponíveis que suportam WebSphere Business Events:

    • JD Edwards v. 6.2.0.2 e v. 7.0.0.0.
    • Oracle v. 6.2.0.2 e v. 7.0.0.0.
    • PeopleSoft v. 6.2.0.1.
    • SAP v. 6.2.0.2 e v. 7.0.0.0.
    • Siebel v. 6.2.0.2 e v. 7.0.0.0.
    Seleção de adaptador de recursos
  4. Após você ter selecionado o adaptador de recursos apropriado, clique em Avançar.
  5. Na página Importação do Conector, no campo Projeto de Conector, aceite o nome padrão ou digite um nome diferente para seu projeto. No campo Servidor de Destino, selecione WebSphere Application Server V7 e clique em Avançar.
    Página Importação do Conector
  6. Na página Configurações do Conector, clique em Navegar para selecionar todos os arquivos do sistema SAP:
    • sapjco3.jar
    • sapjco3.dll
  7. Na página Estilo do Adaptador, selecione Entrada e clique em Ativar Monitoramento de Evento de Entrada e clique em Avançar.
    Página Estilo de Adaptador
  8. Na página Configuração de Evento e JMS, é possível configurar a função de monitor de eventos do provedor JMS.
    Página Configuração de Evento
    1. No campo Tipo de Evento, selecione WebSphere Business Events.
    2. No campo Nome JNDI do Tópico connectionFactory, aceite o valor padrão de jms/wbeTopicConnectionFactory ou digite o valor do nome JNDI do tópico connectionFactory.
    3. No campo Nome JNDI do Tópico, aceite o valor padrão de jms/WBE/CbeListener ou digite o valor do nome JNDI do tópico.
    4. Clique em Avançado para configurar propriedades avançadas:
      1. Configuração do provedor de JNDI remoto: A configuração do provedor de JNDI remoto permite configurar remoteTopic (ou fila remota para o suporte do WebSphere Business Monitor).
        Nota: Se o barramento na célula local tiver o mesmo nome do barramento na célula remota, o aplicativo sempre se conectará à célula local. Ele não usa nenhum dos terminais de provedor especificados no connection factory, portanto, as informações de Configuração de Tópico Remoto inseridas serão ignoradas. Para obter mais informações sobre a Configuração de Tópico Remoto, consulte Configurando uma Conexão com um Servidor de Autoinicialização Não Padrão
        1. No campo Nomeando o Host da URL do Provedor, digite a URL do host de servidor remoto.
        2. No campo Nomeando a Porta da URL do Provedor, digite o número da porta do servidor remoto.
      2. No campo Nome de usuário de configuração de autenticação de conexão, forneça o nome de usuário.
      3. No campo Senha de configuração de autenticação de conexão, forneça sua senha.
  9. Clique em Avançar.
  10. Na página Configuração de Descoberta, forneça as informações de conexão do servidor SAP:
    1. Nome do host (obrigatório): nome do host do servidor SAP.
    2. Número do sistema (obrigatório): número do sistema do servidor SAP.
    3. Nome do servidor: nome do servidor SAP.
    4. Número da porta: o número da porta do servidor SAP.
    5. Nome de usuário (obrigatório): o nome de usuário para a conexão com o servidor SAP.
    6. Senha (obrigatório): a senha para a conexão com o servidor SAP.

      Para configurar as propriedades SAP avançadas, clique em Mostrar Avançado.

  11. Na página Descoberta e Seleção de Objeto, selecione Descobrir IDoc do Sistema e clique em Filtrar:
    Página Descoberta de Objeto
  12. Em Propriedades do Filtro da página Descobrir IDoc do Sistema, digite ORDER* no campo Localizar objetos com este padrão e clique em OK:
  13. Selecione ORDERS05 e clique em ADD:
    Incluir objeto
  14. Na página Parâmetros de Configuração para ORDERS05, aceite os padrões e clique em OK e em Avançar:
    Página Propriedades de Configuração
  15. Na página Configurar Propriedades Compostas, ao lado do campo Operações de serviço para IDoc selecionado, selecione as ações que deseja executar nos objetos e clique em Incluir:
    Configurar Propriedades Compostas
  16. Na página Configurar Propriedades Compostas, ao lado do campo Valores IDoc para identificar operações selecionadas, clique em Selecionar para selecionar o valor que deseja usar e clique em OK.
  17. Na página Configurar Propriedades Compostas, no campo Pasta, digite o nome de uma pasta para armazenar o objeto de negócios gerado e clique em Avançar.
    Nota: Crie um pasta para conter os arquivos de esquema que são gerados para facilitar a exportação desses arquivos para você criar um modelo de monitor. Os arquivos são gerados em uma subpasta eventMonitor dentro da pasta especificada. Se você não especificar um nome de pasta, os arquivos de esquema serão gerados na raiz do projeto, sem nenhuma pasta de contenção.
  18. Na página Criação e Configuração de Implementação do Bean J2C, digite um nome para para seu projeto EJB (WBMSAPProject) e clique em Novo para criar um projeto EJB. Na página Projeto EJB:
    1. Assegure-se de que SapInboundWBE apareça no campo Nome do Projeto.
    2. No campo Tempo de Execução de Destino, selecione WebSphere Application Server v7.
    3. Selecione o campo Associação de EAR e digite WBMSAPProjectEAR no Nome do Projeto EAR
    4. Aceite os outros padrões e clique em Concluir.
      Página do projeto EJB
  19. Na página Criação e Configuração de Implementação do Bean J2C, é possível criar uma interface local EJB, uma classe auxiliar, um bean de sessão e um bean acionado por mensagens para conterem seus processos de entrada. Observe que um EJB, um bean de sessão e um bean acionado por mensagens são todos criados automaticamente. Em um modelo de entrada, os beans acionados por mensagens são projetados para receber mensagens EIS externas. Todos os adaptadores de recursos devem implementar javax.resource.spi.ResourceAdapter, que tem cinco métodos. O servidor de aplicativos acessa esses métodos para gerenciar o ciclo de vida do adaptador de recursos e fornecer notificações quando um terminal de mensagem for implementado ou desimplementado. Para receber uma mensagem EIS específica, o destinatário (bean acionado por mensagens) deve mostrar interesse no consumo dessa mensagem implementando um listener de mensagem. A classe ActivationSpec representa a configuração requerida pelo adaptador de recursos para estabelecer a conexão entre o EIS e um bean acionado por mensagens. Os adaptadores de recursos usam a ActivationSpec do bean acionado por mensagens implementado para criar e gerenciar um relacionamento entre o EIS e o MDB usando o adaptador de recursos. Para configurar a ActivationSpec, ao lado do campo Nome JNDI, clique em Novo.
    Criação de Bean J2C
  20. Na página Nova Especificação de Ativação J2C, insira as informações para se conectar ao sistema SAP, clique em Concluir e, de volta à página Criação do Bean J2C e Configuração de Implementação, clique em Concluir.
    Página Especificação de Ativação J2C
  21. Selecione seu projeto EJB e selecione Projeto > Limpar para gerar e recompilar os arquivos.
  22. O arquivo eventMapping fornece o mapeamento entre o evento e o esquema de objeto de negócios que o WebSphere Business Event requer para monitorar o evento. (Essa é uma ação explícita e não é gerada junto com os outros artefatos). Para gerar EventBOTypeMapping.xml e EventBOTypeMapping.xsd:
    1. Clique com o botão direito do mouse no bean de sessão.
    2. Selecione Origem > Gerar Mapeamento de Evento:
      Gerar Mapeamento de Evento
      Os arquivos EventMapping são gerados na mesma pasta que os arquivos de esquema de objeto de negócios. Nesse exemplo, os arquivos são gerados na BOFolder. Se você modificar ou refatorar algum dos objetos de negócios ou métodos, será necessário gerar novamente o arquivo eventMapping.
  23. Os artefatos a seguir são criados durante a criação desse aplicativo:
    • Arquivos XML schema definition (.xsd) a serem usados para definições de evento localizadas na pasta eventMonitor.
    • Os registros de dados estão localizados sob a pasta ejbModule. Dentro de cada classe de registro de dados, é possível localizar a definição de esquema correspondente.
    • Classes Java™
      Arquivos Java
      Tabela 1.
      SAPInboundEJB.java Classe de interface
      SAPInboundEJBMSB.java Bean de Sessão
      SAPInboundEJBMDB.java Bean controlado por mensagem
      SAPInboundEJBMDBEventInterceptor.java Classe interceptora de evento
      SAPInboundEJBMDBHelper.java Classe MDBHelper
      EventBOTypeMapping.xml Mapeamento eventBOType
      EventBOTypeMapping.xsd Esquema eventBOType
      O bean J2C recebe os eventos de entrada e usa o interceptor de eventos para interceptar os eventos e encaminhá-los por meio de uma fila JMS para o servidor.
  24. Implemente o aplicativo adaptador contendo o bean acionado por mensagens em um servidor WebSphere Business Events ou servidor remoto para que ele possa receber eventos vindos do Enterprise Information System (EIS) e publicá-los na Common Event Infrastructure (CEI). É necessário executar etapas adicionais no servidor do WebSphere Business Event para poder monitorar os eventos específicos. O bean J2C recebe os eventos de entrada e usa o interceptor de evento para interceptar os eventos e encaminhá-los por meio de um Tópico JMS para o servidor. Para obter informações sobre como publicar eventos no WebSphere Business Events, consulte Monitorando os Eventos do EIS com Servidor WebSphere Business Events.

Feedback