Sincronizando Atividades de Solicitação de Serviço usando o WebSphere Adapter for Siebel Business Applications

Este tutorial descreve um caso de negócio no qual uma organização precisa sincronizar solicitações de serviço de um sistema Siebel em um aplicativo cliente. Ele mostra como criar um módulo usando o WebSphere Adapter for Siebel Business Applications para sincronizar os dados da solicitação de serviço.

Matu Agarwal, Software Engineer, WebSphere Adapters team, IBM

Matu Agarwal é um engenheiro de software na equipe do WebSphere Adapter no Laboratório de software da IBM em Bangalore, Índia, onde ele trabalha em desenvolvimento e suporte ao cliente. Ele é Bacharel em Tecnologia em Ciência da Computação e Engenharia pelo Harcourt Butler Technological Institute em Kanpur e tem quatro anos de experiência trabalhando com várias tecnologias Java incluindo JCA. É possível entrar em contato com Matu em matu.agarwal@in.ibm.com.



01/Out/2012

Antes de Iniciar

IBM® Servidores WebSphere® Os adaptadores aceleram os projetos de integração com um conjunto abrangente de recursos baseados em plataforma e compatíveis com JCA para ativar os serviços de seus ativos no Enterprise Information Systems. Este tutorial descreve um caso de negócio no qual o WebSphere Adapter for Siebel Business Applications (daqui em diante chamado de WebSphere Siebel Adapter) é usado para ativar os serviços do Siebel Business Applications e criar pontos da interface do aplicativo reutilizáveis e padrão.

Sobre este tutorial

Este tutorial descreve um caso de negócio no qual uma organização precisa sincronizar solicitações de serviço de um sistema Siebel em um aplicativo cliente. O tutorial irá ajudá-lo a criar um módulo usando o WebSphere Siebel Adapter para sincronizar os dados da Solicitação de serviço. A Solicitação de serviço é um objeto de negócios no sistema Siebel que controla consultas e interações do cliente.

Objetivos

Este tutorial mostra como concluir as seguintes tarefas::

  • Criar e configurar um módulo Siebel SCA
  • Configurar um servidor Siebel
  • Implementar e testar o módulo
  • Obter um melhor entendimento geral do Siebel Adapter por meio de uma lista de Perguntas mais frequentes.

Pré-requisitos

Para se beneficiar deste tutorial, você deve ter alguma familiaridade com os conceitos do servidor Siebel e com o IBM Integration Designer ou IBM Business Process Manager.

Requisitos do Sistema

Os seguintes produtos e ativos são necessários para configurar e implementar o módulo:

  • IBM Integration Designer V7.5 ou IBM Business Process Manager V7.5 Advanced Edition
  • IBM Process Server V7.5
  • WebSphere Adapter for Siebel Business Applications V7.5
  • Acesso a um sistema Siebel com permissão para criar objetos
  • Arquivos de biblioteca Siebel Siebel.jar e SiebelJI_enu.jar.

Duração

Três horas


Caso de negócio

Uma empresa chamada ABC Pharmaceutical está usando o Siebel Sales para gerenciar suas interações com clientes existentes e potenciais. Eles implementaram o Sales Force Automation (SFA) para aperfeiçoar todas as fases do processo de vendas e minimizar o tempo que os representantes de vendas precisam gastar em cada fase. Para um requisito específico, eles estão usando o objeto Account fornecido pelo Siebel para controlar uma conta de cliente. Ele fornece um objeto de negócios Solicitação de serviço para gerenciar todas as solicitações de serviço geradas por esse cliente. Cada interação de cliente em uma Solicitação de serviço é registrada com uma nova atividade, que é implementada internamente usando o componente de negócios Ação do plano de atividade.

Figura 1. Caso de negócio
Caso de negócio

A ABC Pharmaceutical tem como necessidade de negócios receber notificação em seu aplicativo cliente de qualquer atualização em uma Solicitação de serviço -- por exemplo, se uma atividade for criada, atualizada ou excluída. O aplicativo cliente precisa sincronizar esses dados de atividade do Siebel em um banco de dados principal legado, que armazena a cópia principal dos dados residentes em um sistema Siebel diferente. Essa sincronização de diferentes sistemas Siebel para o sistema CRM principal acontece uma vez ao dia. Esse requisito tem duas partes -- recuperar os dados da Solicitação de serviço do sistema Siebel e, em seguida, passá-los adiante para o sistema CRM principal. Este tutorial mostra como desenvolver o aplicativo cliente para a primeira parte, em que é necessário integrar todas as atualizações feitas no objeto Solicitação de serviço do Siebel no aplicativo cliente.


Solução usando o WebSphere Siebel Adapter e o IBM Business Process Manager

Por que usamos o WebSphere Siebel Adapter?

O WebSphere Siebel Adapter o ajuda a ativar o serviço dos aplicativos de negócios Siebel com sua ferramenta de descoberta e navegação gráfica, para que os aplicativos cliente possam acessar diretamente os dados em um sistema Siebel, melhorando enormemente a integridade de dados.

O WebSphere Siebel Adapter permite que os aplicativos corporativos interajam com os aplicativos de negócios Siebel e executem funções de negócios sem código customizado. Para implementar esse caso de negócio, use o cenário de entrada do WebSphere Siebel Adapter.

No servidor Siebel, quando uma atividade em uma Solicitação de serviço é criada, modificada ou excluída, um evento correspondente é acionado. Esse evento contém a chave primária dessa atividade e é armazenado como uma nova entrada no Componente de negócios customizado Siebel com o nome IBM Event. É necessário incluir este código acionador e Componente de negócios customizado no sistema Siebel, conforme descrito abaixo em Pré-requisitos de configuração. O WebSphere Siebel Adapter pesquisa essa tabela de eventos e recupera o objeto atualizado (nesse caso, Ação do plano de atividade) do sistema Siebel usando a chave primária.

Para solicitações de entrada do sistema Siebel, beans acionados por mensagens que implementam a interface InboundListener são registrados no WebSphere Siebel Adapter pelo WebSphere Process Server, permitindo que eles recebam qualquer evento de entrada apropriado do sistema Siebel por meio do Adapter. O Adapter também suporta um cenário de integração usando a interface de serviço de negócios para operações de entrada e saída, com o Adapter conectando-se ao Siebel usando um arquivo JAR da API do bean de dados Siebel.

Figura 2. Integração do Siebel usando o WebSphere Siebel Adapter
Integração do Siebel usando o WebSphere Siebel Adapter

Como funciona

O Adapter pesquisa os eventos olhando o Componente de negócios de eventos Siebel que foi criado para armazenar o evento. Quando um objeto é criado, atualizado ou excluído, um novo evento é acionado e armazenado na tabela, que é pesquisada pelo Adapter com base no status do evento. Quando o Adapter localiza um evento para um Componente de negócios de eventos Siebel, o Adapter processa o evento como a seguir:

  1. Recupera as informações do evento do Componente de negócios de eventos Siebel.
  2. Recupera a hierarquia de instâncias do Componente de negócios de eventos.
  3. Preenche o objeto de negócios WebSphere associado ou gráfico de negócios (se foi gerado) com os valores recuperados do Componente de negócios de eventos.
  4. Envia uma notificação para cada aplicativo registrado.

Pré-requisitos de configuração

As operações de entrada são baseadas em um evento bring acionado quando qualquer registro no aplicativo de negócios Siebel é criado, atualizado ou excluído. Para executar a operação de entrada com o WebSphere Siebel Adapter, é necessário executar a seguinte configuração no servidor Siebel:

Criando Componente de negócios Siebel customizado (tabela de eventos)

É necessário criar um Componente de negócios Siebel customizado para armazenar os eventos acionados como resultado das atualizações nos registros Siebel. O esquema para o Componente de negócios Siebel customizado não pode ser alterado. Criar a tabela de eventos é uma atividade de uma única vez. Um Componente de negócios Siebel customizado chamado IBM_EVENT_V8.sif é fornecido junto com o adaptador, que pode ser importado diretamente para o servidor Siebel. Também é possível criar manualmente esse Componente de negócios Siebel. Para obter mais informações, consulte Centro de informações do WebSphere Adapters ou WebSphere Adapter for Siebel Business Applications -- Cenários de iniciação rápida.

Inserindo scripts de acionador em objetos de negócios Siebel

Acionadores devem ser inseridos nos objetos de negócios Siebel que são observados para eventos. O Siebel suporta Visual Basic e Siebel e-Scripts integrados aos manipuladores de eventos do Componente de negócios Siebel para preencher a tabela de eventos. Para este tutorial, insira o script acionador no componente de negócios Ação do plano de atividade. O código de script de exemplo BOAccount.js para alguns componentes de negócios como Account e Contact é fornecido junto com o Adapter, e é possível implementar o código de script de maneira similar para outros componentes de negócios.


Configurando o WebSphere Siebel Adapter

Criando o módulo SCA baseado em Siebel

  1. No kit de ferramentas IBM Integration Designer, selecione File => New => External Service e, a seguir, clique em Next:
  2. Selecione WebSphere Adapter for Siebel Business Applications e, a seguir, clique em Next:
  3. Especifique o local dos arquivos JAR da API do bean de dados Siebel e clique em Next:
  4. Selecione Inbound scenario e, a seguir, clique em Next:
  5. Especifique os detalhes da conexão Siebel e clique em Next:
  6. Consulte Service Request Business Object, selecione Activity Plan Action Business Componente, a seguir, clique em Next:
  7. Especifique a operação que precisa ser incluída na interface de serviço e clique em Next. Se for necessário gerar o gráfico de negócios do wrapper, selecione a caixa de seleção:
  8. Abra o grupo de propriedades da Configuração da entrega de evento e configure o valor do Tipo de evento para processar a propriedade, como mostrado abaixo. Essa propriedade age como um filtro se quiser que o Adapter pesquise eventos específicos da tabela de eventos:
  9. Abra o grupo de propriedades de configuração do evento e configure o nome do objeto de negócios do armazenamento de eventos:
  10. Clique em Next e crie um módulo. Os arquivos XSD e WSDL são gerados depois que o assistente é executado:

Implementando e testando o módulo

  1. Inclua o componente Java Component1 do palete e conecte-o a SiebelInboundInterface. Clique com o botão direito do mouse no componente Java e clique em Generate implementation:
  2. Todos os métodos definidos no arquivo WSDL da SiebelInboundInterface serão gerados. Este teste verifica se a configuração está correta e se o WebSphere Siebel Adapter é capaz de pesquisar qualquer modificação feita no componente de negócios Ação do plano de atividade Siebel. Apenas é impresso o objeto recebido no terminal, mas é possível implementar um código para processar adicionalmente o objeto e integrá-lo com um sistema legado. Aqui está o código para imprimir o objeto de uma das operações:
    public void emitCreateAfterImageBOServiceRequestBCActivityPlanAction(
        DataObject emitCreateAfterImageBOServiceRequestBCActivityPlanActionInput)
            throws Exception {
            System.out.println(AdapterBOUtil.serializeDataObject(
                emitCreateAfterImageBOServiceRequestBCActivityPlanActionInput));
                    }
  3. Inclua o IBM Process Server V7.5 na visualização Servidores, clique com o botão direito do mouse e selecione Add and Remove para implementar o módulo:
  4. Crie, atualize ou exclua uma atividade na guia Activities, conforme mostrado abaixo. O evento correspondente é acionado, o objeto recuperado pelo WebSphere Siebel Adapter e enviado para o terminal. Para verificar, use o console Servidor de processos para imprimir o objeto recebido:
    Figure 15

Perguntas mais frequentes sobre o WebSphere Siebel Adapter

  1. Você precisa incluir a tabela de eventos e o código do script acionador no lado do servidor Siebel para todos os cenários do Siebel Adapter? Há alguma solução alternativa que permita evitar alterações no lado do Siebel?

    Sim, é necessário configurar a tabela de eventos e o script acionador dentro do servidor Siebel para executar o cenário de entrada do Adapter e não há solução alternativa. Para executar o cenário de saída do Adapter, não é necessário fazer qualquer alteração no lado do servidor Siebel.

  2. Quem desenvolve e é o proprietário do código acionador? E se eu encontrar problemas nele?

    O script Siebel do acionador precisa ser desenvolvido e mantido pelo desenvolvedor Siebel. Você recebe scripts de amostra para alguns componentes de negócios junto com o Adapter e o desenvolvedor Siebel pode escrever similares para outros componentes de negócios.

  3. Meu objeto de negócios Siebel contém numerosos campos e o objeto de negócios gerado é muito grande. Como preciso usar apenas alguns campos, há uma maneira de gerar um objeto usando campos selecionados?

    Sim -- ao executar o assistente de serviço externo, o WebSphere Siebel Adapter fornece uma opção na primeira tela de conexão chamada Prompt for additional configuration settings when adding a business object. Selecione essa caixa de seleção para importar apenas os atributos específicos que deseja gerar:

  4. Como é usada a propriedade de filtro de eventos? Posso filtrar eventos com base no nome da operação?

    Os eventos são filtrados por operação e tipo do objeto de negócios. Se a propriedade está configurada, o Adapter pesquisa e entrega apenas os eventos na lista. Um valor em branco indica que nenhum filtro será aplicado e que todos os eventos serão entregues para o terminal. Use a seguinte sintaxe:

    BOName1:Operation1|Operation2, BOName2:Operation1|Operation2|Operation3

    Por exemplo, se desejar apenas criar e atualizar eventos do objeto Account, use:

    BOAccountBCAccount:Create|Update

    São esses os delimitadores:

    • , separa os objetos de negócios. Os objetos que não estão nessa lista são ignorados.
    • : separa o nome do objeto de negócios do nome da operação.
    • | separa as operações suportadas, como Criar, Atualizar e Excluir.
  5. Posso conectar o Siebel Adapter a um servidor Siebel em cluster?

    Sim. Use estas etapas:

    • Inclua VirtualServer na cadeia de caracteres de conexões configurada no adaptador. Para a URL de conexão, use siebel://VirtualServer/siebel_server/application_name.
    • Coloque o arquivo siebel.properties no caminho de classe do Adapter e inclua VirtualServer nele, junto com os endereços IP em cluster do servidor Siebel:
      siebel.conmgr.virtualhosts=VirtualServer=1:10.20.30.170:2321,2:10.20.30.171:2321
  6. O Siebel Adapter suporta um cenário de alta disponibilidade?

    Sim, o Siebel Adapter suporta um cenário ativo-passivo de alta disponibilidade, em que uma instância em um momento está ativa, e o outro nó do adaptador está em execução, mas está em estado dormente. A partir da versão V7.5 ele não suporta um cenário ativo-ativo.

  7. Como são gerenciados os tempos limite, o número de conexões e outras propriedades de conexão no Siebel?

    É possível configurar esses parâmetros incluindo um arquivo siebel.properties no caminho de classe do Adapter.
    Mais informações sobre os parâmetros suportados que podem ser configurados nesse arquivo.

  8. Como você ativa a reutilização de conexão pelo Siebel Adapter, para que aproveite o conjunto de conexões Siebel e não crie uma nova conexão a cada vez?

    Para ativar a reutilização de conexão, o Siebel Adapter fornece uma propriedade no assistente de serviço externo. Selecione Advanced properties => Other properties => Use Resonate for load balancing on Siebel server:

  9. Que devo fazer se os eventos estão sendo gerados corretamente na tabela de eventos quando o registro é modificado no servidor Siebel, mas o Adapter não consegue pesquisá-los?
    1. Verifique nos rastreios se o Adapter está em execução.
    2. Verifique se o nome do Componente de negócios customizado (tabela de eventos) está configurado corretamente no Adapter.
    3. Verifique se foi configurado um valor para Event types to process . Se foi, assegure-se de que sua sintaxe esteja correta -- o nome do objeto de negócios deve ser o mesmo do gerado pelo código do acionador de evento, e o Adapter deve conter uma definição desse objeto de negócios (um arquivo XSD com o mesmo nome deve ser gerado pelo Adapter).

Recursos

Comentários

developerWorks: Conecte-se

Los campos obligatorios están marcados con un asterisco (*).


Precisa de um ID IBM?
Esqueceu seu ID IBM?


Esqueceu sua senha?
Alterar sua senha

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


A primeira vez que você entrar no developerWorks, um perfil é criado para você. Informações no seu perfil (seu nome, país / região, e nome da empresa) é apresentado ao público e vai acompanhar qualquer conteúdo que você postar, a menos que você opte por esconder o nome da empresa. Você pode atualizar sua conta IBM a qualquer momento.

Todas as informações enviadas são seguras.

Elija su nombre para mostrar



Ao se conectar ao developerWorks pela primeira vez, é criado um perfil para você e é necessário selecionar um nome de exibição. O nome de exibição acompanhará o conteúdo que você postar no developerWorks.

Escolha um nome de exibição de 3 - 31 caracteres. Seu nome de exibição deve ser exclusivo na comunidade do developerWorks e não deve ser o seu endereço de email por motivo de privacidade.

Los campos obligatorios están marcados con un asterisco (*).

(Escolha um nome de exibição de 3 - 31 caracteres.)

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


Todas as informações enviadas são seguras.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=WebSphere
ArticleID=838506
ArticleTitle=Sincronizando Atividades de Solicitação de Serviço usando o WebSphere Adapter for Siebel Business Applications
publish-date=10012012