WebSphere Adapters. Versão Guia do Usuário do Adapter for Siebel Business Applications

Transcrição

1 WebSphere Adapters Versão Guia do Usuário do Adapter for Siebel Business Applications

2 Nota Antes de utilizar estas informações, leia as informações gerais em Avisos na página de dezembro de 2006 Esta edição se aplica à versão 6, release 0, modificação 2 do WebSphere Adapter for Siebel Business Applications (número do produto 5724-L80) e a todos os releases e modificações subseqüentes, até que seja indicado de outra maneira em novas edições. Para enviar seus comentários sobre este documento, envie um para doc-comments@us.ibm.com. Esperamos receber os seus comentários. Quando o Cliente envia seus comentários, concede direitos não-exclusivos à IBM para usá-los ou distribuí-los da maneira que achar conveniente, sem que isso implique em qualquer compromisso ou obrigação para com o Cliente. Direitos Autorais International Business Machines Corporation 2005, Todos os direitos reservados.

3 Índice Capítulo 1. Sobre estas Informações Capítulo 2. O que Há de Novo Novo Neste Release Notas sobre o Release Capítulo 3. Introdução ao WebSphere Adapters Capítulo 4. Introdução ao WebSphere Adapter for Siebel Business Applications Requisitos de Hardware e Software Conformidade com Padrões Acessibilidade Internet Protocol Versão Visão Geral Técnica do Adapter for Siebel Business Applications Objetos de Negócios Enterprise Service Discovery Processamento de Saída Processamento de Entrada Globalização e Transformação para Bidi Capítulo 5. Planejando a Implementação do Adaptador Segurança WebSphere Adapters Em Ambientes em Cluster Roteiro para Instalação, Configuração e Implementação do Adaptador Capítulo 6. Instalando o Adaptador Pré-requisitos de Instalação Realizando a Instalação Migrando para a Versão Retrocompatibilidade Realizando a Migração Desinstalando o Adaptador Capítulo 7. Configurando o Adaptador para Implementação Pré-requisitos de Configuração Criando o Alias de Autenticação Criando um Componente de Evento no Aplicativo Siebel Criando o Projeto do Adaptador no WebSphere Integration Developer Incluindo Dependências de Software Externas Configurando o Adaptador para Processamento de Saída Gerando Artefatos Utilizando o Assistente Enterprise Service Discovery Configurando o Adaptador para Processamento de Entrada Gerando Artefatos Utilizando o Assistente Enterprise Service Discovery Gerando Ligações de Referência (Apenas para o Ambiente de Teste) Capítulo 8. Implementando o Módulo Exportando o Projeto como um Arquivo EAR Instalando o Módulo Configurando ou Alterando as Propriedades de Configuração do Adaptador Configurando as Propriedades do Adaptador de Recursos Configurando Propriedades do Connection Factory (J2C) Gerenciado Configurando Propriedades de Especificação de Ativação para o EIS Direitos Autorais IBM Corp. 2005, 2006 iii

4 Capítulo 9. Configurando as Ferramentas de Resolução de Problemas Ativando o Rastreio com a CEI (Common Event Infrastructure) Configurando as Propriedades de Criação de Log Alterando os Nome do Arquivo de Log e Rastreio Instalando ou Fazendo Upgrade do IBM Support Assistant Capítulo 10. Administrando o Adaptador Iniciando o Adaptador Parando o Adaptador Resolução de Problemas e Suporte Exceção: XAResourceNotAvailableException Problema ao Conectar-se ao Siebel Recursos de Auto-atendimento Entrando em Contato com o Suporte de Software IBM Capítulo 11. Tutoriais de Início Rápido Introdução Acessando os Arquivos do Tutorial Objetos de Negócios Utilizados no Tutorial Tutorial: Pré-requisitos de Pré-configuração Criando o Alias de Autenticação Criando um Componente de Evento no Aplicativo Siebel Criando o Projeto do Adaptador no WebSphere Integration Developer Incluindo Dependências de Software Externas Tutorial 1: Processamento de Saída para Siebel Business Services Configurando o Adaptador Implementando o Módulo para Testes Testando o Módulo Resolução de Problemas do Tutorial Apagando o Conteúdo do Tutorial Tutorial 2: Processamento de Saída para Objetos de Negócios Siebel Configurando o Adaptador Implementando o Módulo para Testes Testando o Módulo Resolução de Problemas do Tutorial Apagando o Conteúdo do Tutorial Tutorial 3: Processamento de Entrada para Serviços de Negócios Siebel Configurando o Adaptador Gerando Ligações de Referência (Apenas para o Ambiente de Teste) Implementando o Módulo para Testes Testando o Aplicativo do Adaptador Montado Resolução de Problemas do Tutorial Tutorial 4: Processamento de Entrada para Objetos de Negócios Siebel Configurando o Adaptador Gerando Ligações de Referência (Apenas para o Ambiente de Teste) Implementando o Módulo para Testes Testando o Aplicativo do Adaptador Montado Resolução de Problemas do Tutorial Capítulo 12. Informações de Referência Propriedades de Conexão do Enterprise Service Discovery Propriedades de Configuração do Adaptador Propriedades do Adaptador de Recursos Propriedades da Connection Factory (J2C) Gerenciada Propriedades de Especificação de Ativação Configurações para Controle de Transformação para Bidi Incluindo Arquivos jar no WebSphere Integration Developer Versões e Anteriores Mensagens Informações Relacionadas ao Produto iv IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

5 Avisos Informações sobre a Interface de Programação Marcas Registradas e Marcas de Serviço Índice Remissivo Índice v

6 vi IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

7 Capítulo 1. Sobre estas Informações Este documento destina-se a desenvolvedores de integração que implementam, configuram e implantam o WebSphere Adapter for Siebel Business Applications. Para utilizá-lo, você deve entender os conceitos de integração de negócios e possuir determinadas habilidades técnicas. Os desenvolvedores de integração projetam, montam, testam e implementam soluções de integração de negócios. Estas informações destinam-se aos que implementam o WebSphere Adapter for Siebel Business Applications em uma solução que requer a troca de dados entre EIS (Enterprise Information Systems) e aplicativos J2EE. Para utilizá-lo, você deve entender e ter experiência com os seguintes conceitos, padrões e ferramentas: v A solução e o ambiente corporativo. v É necessário conhecimento em Siebel Business Applications, como gravar scripts do servidor em componentes de negócios e administração do servidor limitada. v Mecanismos de integração de negócios, incluindo o modelo de programação SCA (Service Component Architecture) e o modelo de dados SDO (Service Data Objects). v O padrão J2EE e aplicativos J2EE. v As capacidades e os requisitos do WebSphere Process Server ou do WebSphere Enterprise Service Bus, dependendo do host utilizado no ambiente. Você deve saber como configurar e administrar o servidor host e como utilizar o console administrativo. v As ferramentas e as capacidades fornecidas pelo WebSphere Integration Developer. Você deve saber como utilizar essas ferramentas para conectar componentes e concluir outras tarefas de integração. Para concluir a implementação, você deve saber como desempenhar as seguintes tarefas: v Criar scripts, ferramentas e modelos necessários para teste e implementação v Resolver interdependências entre entidades, tais como, enterprise beans, fluxos de trabalho e páginas da Web v Construir modelos de dados para ferramentas de acesso a dados externos v Implementar medidas de segurança IBM Corporation

8 2 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

9 Capítulo 2. O que Há de Novo Novo Neste Release Notas sobre o Release O WebSphere Adapter for Siebel Business Applications, versão fornece aprimoramentos para a versão 6.0 do adaptador. O WebSphere Adapter for Siebel Business Applications, versão 6.0.2, tem recursos novos e atualizados. Novidades na Versão 6.0.2: v Suporte a Siebel Business Objects e a Siebel Business Components v Suporte de alta disponibilidade para processamento de entrada. Para obter informações adicionais, consulte WebSphere Adapters em Ambientes em Cluster WebSphere Adapters Em Ambientes em Cluster na página 37. Atualizações da versão 6.0.2: v Tutoriais de iniciação rápida para processamento de entrada e de saída v Suporte ao texto em idioma bidirecional As notas sobre o release do WebSphere Adapter for Siebel Business Applications, versão resumem novos recursos e funções neste release e documentam soluções alternativas conhecidas. Você pode consultar as notas sobre o release do WebSphere Adapter for Siebel Business Applications no seguinte link: Notas sobre o Release do Adapter for Siebel Business Applications Direitos Autorais IBM Corp. 2005,

11 Capítulo 3. Introdução ao WebSphere Adapters O IBM WebSphere Adapters permite que componentes J2EE (Java 2 Platform, Enterprise Edition), tais como, novos aplicativos de e-business, se comuniquem com recursos em um EIS (Enterprise Information System). Um EIS é a infra-estrutura de informações para uma empresa (por exemplo, um sistema ERP [Enterprise Resource Planning]). Um WebSphere Adapter age como um intermediário entre o componente J2EE e o EIS, para que o componente J2EE não precise entender a API de nível inferior ou estruturas de dados do EIS. O WebSphere Adapters pode ter um de dois tipos: aplicativo ou tecnologia. v Os Adaptadores do aplicativo conectam-se a aplicativos empacotados existentes (como SAP Software, Siebel, PeopleSoft Enterprise e JD Edwards EnterpriseOne) par que seja possível utilizar dados e serviços específicos dos aplicativos. v Os Adaptadores de tecnologia fornecem conectividade com dados por meio de tais tecnologias e protocolos como bancos de dados relacionais, arquivos simples, mensagens de e FTP. Como parte da família de produtos WebSphere, o WebSphere Adapters funciona com o WebSphere Integration Developer e o WebSphere Process Server ou o WebSphere Enterprise Service Bus. v O WebSphere Integration Developer é o ambiente de ferramentas para o WebSphere Adapters. Você utiliza o WebSphere Integration Developer para montar um módulo implementado no WebSphere Process Server ou no WebSphere Enterprise Service Bus. A partir do WebSphere Integration Developer, você importa o adaptador (que é empacotado como um arquivo RAR [Adaptador de Recursos] e conecta-o ao EIS. O assistente Enterprise Service Discovery do WebSphere Integration Developer procura dados e serviços no EIS e cria as informações da interface necessárias para obter acesso aos dados e serviços. Por último, o WebSphere Integration Developer gera um módulo que inclui informações do adaptador e da interface. v O WebSphere Process Server ou o WebSphere Enterprise Service Bus é o ambiente de tempo de execução para o WebSphere Adapters. Você implementa o módulo gerado pelo WebSphere Integration Developer em um dos servidores. A geração e implementação do módulo são ilustradas na figura a seguir. Figura 1. Como um Módulo É Gerado e Implementado IBM Corporation

13 Arquivo RAR do Adaptador WebSphere Integration Developer Assistente Enterprise Service Discovery Informações da interface Dados ou serviço Enterprise Information System Arquivo RAR do Adaptador Informações da interface Módulo Servidor Capítulo 4. Introdução ao WebSphere Adapter for Siebel Business Applications O IBM WebSphere Adapter for Siebel Business Applications conecta componentes J2EE (Java 2 Platform, Enterprise Edition) em execução no WebSphere Process Server ou no WebSphere Enterprise Service Bus a sistemas de arquivos remotos em execução em um EIS (Enterprise Information System). O adaptador fornece um meio para interação entre o componente J2EE e o sistema de arquivos remoto. Por exemplo, o aplicativo J2EE pode ser configurado para atualizar um registro de conta no sistema Siebel. Requisitos de Hardware e Software Antes de instalar o Adapter for NOME DO SEU ADAPTADOR, é preciso verificar se seu ambiente atende os requisitos necessários. Estes requisitos estão em duas categorias: plataformas suportadas para execução do instalador do adaptador e requisitos de hardware e de software para configuração, implementação e execução do adaptador. Direitos Autorais IBM Corp. 2005,

14 Conformidade com Padrões Plataformas Suportadas para Execução do Instalador do Adaptador As plataformas suportadas para execução do instalador do adaptador estão localizadas na seção Instalando do Instalando IBM WebSphere Adapters. Requisitos de Hardware e de Software para Configuração, Implementação e Execução do Adaptador Os requisitos de hardware e de software para configuração, implementação e execução do adaptador estão localizados no seguinte Web site: IBM WebSphere Adapters and IBM WebSphere Business Integration Adapters: software requirements. Na lista IBM WebSphere Adapters, selecione o link para o Adapter for NOME DO SEU ADAPTADOR, Versão Este produto é compatível com vários padrões do governo e de mercado, incluindo padrões de acessibilidade e padrões de Protocolo da Internet. Acessibilidade A IBM se esforça para oferecer produtos que permitam acesso a todos, independentemente de idade ou habilidade. O software WebSphere Adapters é totalmente acessível e em conformidade com a seção 508. Os recursos de acessibilidade permitem que usuários com deficiências físicas, como movimentos restritos ou visão limitada, operem os produtos de software com sucesso. Estes recursos estão integrados nos recursos de instalação e administração do WebSphere Adapters. Tarefas de Instalação Você pode instalar o WebSphere Adapters por meio de uma interface gráfica com o usuário ou silenciosamente por meio de um script. O método de instalação silenciosa é recomendado para usuários com necessidades de acessibilidade. Administração O console administrativo do WebSphere Process Server ou do WebSphere Enterprise Service Bus é a interface primária para implementação e administração dos aplicativos corporativos. Estes consoles são exibidos em um navegador da Web padrão. Utilizando um navegador da Web acessível, tal como, Microsoft Internet Explorer ou Navegador Netscape, você pode: v Utilizar software de leitura de tela e um sintetizador de fala digital para ouvir o que é exibido na tela v Utilize software de reconhecimento de voz, tal como, IBM ViaVoice, para digitar dados e para navegar pela interface com o usuário. v Operar os recursos utilizando o teclado em vez do mouse É possível configurar e utilizar recursos do produto através de editores de texto padrão e interfaces de scripts ou de linha de comandos ao invés das interfaces gráficas fornecidas. Quando apropriado, a documentação para recursos específicos do produto contém informações adicionais sobre a acessibilidade dos recursos. 8 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

15 Assistente Enterprise Service Discovery O assistente Enterprise Service Discovery é o componente primário utilizado para criar aplicativos corporativos com os adaptadores. Este assistente é implementado como um plug-in do Eclipse que está disponível por meio do WebSphere Integration Developer e é totalmente acessível. Navegação pelo Teclado Este produto utiliza as teclas de navegação padrão do Microsoft Windows. IBM e Acessibilidade Consulte o IBM Accessibility Center para obter informações adicionais sobre o compromisso que a IBM tem com a acessibilidade. Internet Protocol Versão 6.0 O IBM WebSphere Process Server depende da compatibilidade do WebSphere Application Server para Protocolo da Internet Versão 6.0. O IBM WebSphere Application Server Versão 6.0 e seu componente JavaMail suportam IPv6 (Protocolo da Internet Versão 6.0) de pilha dupla. Para obter informações adicionais sobre esta compatibilidade no WebSphere Application Server, consulte Suporte ao IPv6 no Centro de Informações do WebSphere Application Server. Para obter informações adicionais sobre o IPv6, consulte Visão Geral Técnica do Adapter for Siebel Business Applications O IBM WebSphere Adapter for Siebel Business Applications fornece suporte para Siebel Business Objects, Siebel Business Components e Siebel Business Services. O adaptador suporta operações de entrada e de saída. Siebel Business Applications permitem a troca de dados e a execução de processos de negócios utilizando serviços de negócios, componentes e objetos de negócios. Essas entidades oferecem fluxo de trabalho de negócios e execução de processos para ajudar as empresas a gerenciar suas relações com clientes. O sistema Siebel suporta a integração de seus serviços de negócios e objetos de negócios utilizando o Siebel Java Data Bean. O Siebel Java Data Bean interage com os seguintes tipos de objetos de aplicativo: v Siebel Business Objects e Siebel Business Components v Siebel Business Services com Siebel Integration Objects e Siebel Integration Components Siebel Business Services, Siebel Business Components e Siebel Business Objects fazem parte da camada de objetos de negócios na arquitetura do aplicativo Siebel. O Siebel Java Data Bean expõe os Siebel Business Objects, Siebel Business Components e os Siebel Business Services. O adaptador utiliza as interfaces de programa aplicativo Java fornecidas pelo Siebel Java Data Bean para comunicar-se com o Siebel Object Manager para troca de dados. Capítulo 4. Introdução ao Adapter for Siebel Business Applications 9

16 A figura a seguir mostra a arquitetura do adaptador, incluindo setas que representam o fluxo de processamento para operações de entrada e de saída. Servidor de Aplicativos Contêiner JCA Usuários e negócios externos Bean acionado por mensagens Componente do Cliente Interface do listener de entrada pedidos eventos Interfaces CCI JCCA Classes- Base Interfaces SPI JCCA WebSphere adapter for Siebel Business applications API do Cliente Siebel Data Bean EIS Aplicativo J2EE Adaptador de Recursos fornecido por JCA fornecido por EMD fornecido por classes-base fornecido pelo adaptador fornecido por EIS fornecido pelo usuário Figura 2. Diagrama da Arquitetura do Adaptador Objetos de Negócios O Adapter for Siebel Business Applications suporta dois tipos de objetos de negócios: Siebel Business Services com Siebel Integration Objects e Siebel Business Objects e Siebel Business Components. Siebel Business Objects e Siebel Business Components Siebel Business Objects e Siebel Business Components são blocos de construção de aplicativos Siebel orientados a objetos e podem ser customizados. Como o Adaptador Processa Siebel Business Objects e Siebel Business Components Os Siebel Business Objects e Siebel Business Components são objetos que geralmente estão ligados a dados e tabelas específicos no modelo de dados Siebel. Por outro lado, os serviços de negócios Siebel não são anexados a objetos específicos, mas funcionam em objetos para atingir um objetivo específico. Siebel Business Objects são blocos de construção de aplicativos Siebel orientados a objetos e podem ser customizados. Os objetos de negócios definem os relacionamentos entre objetos do componente de negócios (BusComps) e contêm informações semânticas sobre vendas, marketing e entidades relacionadas a serviços. Um Siebel Business Object agrupa um ou mais componentes de negócios em uma unidade lógica de informações. Alguns exemplos de Siebel Business Objects incluem: Oportunidade, Cotação, Campanha e Previsão. Um objeto de negócios de oportunidade pode consistir em componentes de negócios de oportunidade, contato e produto. O componente de negócios de oportunidade dita as informações dos outros componentes de negócios em um relacionamento pai-filho. Um componente de negócios define a estrutura, o comportamento e as informações exibidas por um assunto específico, como um produto, contato ou conta. Siebel Business Components são abstrações lógicas de uma ou mais tabelas de banco de dados. As informações armazenadas em um componente de negócios geralmente 10 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

17 são específicas de um determinado assunto e, geralmente, não dependem de outros componentes de negócios. Os componentes de negócios podem ser utilizados em um ou mais objetos de negócios. O Adapter for Siebel Business Applications é orientado a metadados. O adaptador suporta objetos de negócios hierárquicos. As informações sobre o objeto processado são armazenadas nas informações específicas do aplicativo para o objeto e cada um de seus atributos. O adaptador suporta as seguintes operações: v ApplyChanges Atualiza o componente de negócios com base nas informações delta. v Create Cria o objeto de negócios. v Delete Exclui o objeto de negócios e seus filhos do Siebel (uma exclusão física). Por padrão a exclusão é realizada em cascata no Siebel. v Exists Verifica a existência dos objetos de negócios de entrada no Siebel. O objeto de negócios de saída, ExistsResult, é retornado com o valor Booleano preenchido. v Retrieve Mostra os valores do objeto de negócios. v RetrieveAll Recupera várias instâncias do mesmo objeto de negócios e ocupa-o como o BG (Gráfico de Negócios) do contêiner e retorna-o. v Update Atualiza o aplicativo Siebel com o objeto de entrada. Convenção de Nomenclatura do Objeto de Negócios para Objetos de Negócios que Representam Siebel Business Objects: A convenção de nomenclatura para os objetos de negócios que representam Siebel Business Objects inclui a concatenação de várias palavras. A convenção de nomenclatura para os objetos de negócios que representam Siebel Business Objects é igual para processamento de entrada e de saída, conforme visto no exemplo a seguir: <Prefixo><BO><Nome do Objeto de Negócios> + <BC><Nome do Componente de Negócios> Tabela 1. Formatos e Descrições de Nomenclatura do Objeto de Negócios Formato de nomenclatura do objeto de negócios Descrição Prefixo Um prefixo opcional, que é colocado no início do nome do objeto de negócios. Nome do Objeto de Negócios O nome do Siebel Business Object sob o qual os componentes de negócios estão agrupados. Nome do Componente de Negócios O nome do Siebel Business Component. Nota: Os nomes de Siebel Business Objects e Siebel Business Components não contêm todos os caracteres não alfanuméricos antes de serem incluídos no nome do objeto de negócios do WebSphere Business Integration. Se os nomes resultantes tiverem problemas de exclusividade, um contador será sufixado aos nomes. Por exemplo, se dois objetos de negócios do WebSphere Business Integration tiverem o nome SiebelBOAccountBCBusinessAddress, os nomes serão sufixados com o contador para obter valores exclusivos, por exemplo, SiebelBOAccountBCAddress1, SiebelBOAccountBCAddress2. O objeto de negócios de nível superior também terá um gráfico de negócios gerado. O nome do gráfico de negócios possui o seguinte formato: Capítulo 4. Introdução ao Adapter for Siebel Business Applications 11

18 <Prefixo><BO>+<Nome do Objeto denegócios>+<bc>+<nome do Componente de Negócios>+BG Também existe um objeto de negócios do contêiner gerado para suportar a operação RetrieveAll. O tipo complexo no objeto do contêiner é o gráfico de negócios de nível superior. O objeto de negócios do contêiner possui o seguinte formato: <Prefixo><BO>+<Nome do Objeto de Negócios>+<BC>+<Nome do Componente de Negócios>+Contêiner O objeto de negócios gerado para a operação Exists apresenta o seguinte formato: Objeto de Negócios: <Prefixo><ExistsResult> O objeto de negócios conterá um atributo, Status, do tipo Booleano, que mostra o status de retorno. Nota: Um gráfico de negócios não é gerado para o objeto de negócios ExistsResult correspondente porque não é necessário. Propriedades do Atributo do Objeto de Negócios: Os atributos do objeto de negócios armazenam importantes informações de Nome, Tipo e Chave sobre o objeto de negócios. Eles são configurados durante a descoberta do serviço corporativo e podem ser reconfigurados no console administrativo do WebSphere Process Server. A tabela de propriedades de atributos do objeto de negócios mostrada abaixo descreve os atributos utilizados pelo adaptador. Tabela 2. Propriedades do Objeto de Negócios Propriedade Descrição Cardinalidade Para atributos simples, é utilizado 1. Para propriedades do contêiner, dependendo dos requisitos do método, é utilizado n. Chave e chave estrangeira Para componentes de negócios, o ID é a chave primária. Para serviços de negócios e objetos de integração, esses atributos não são utilizados. Nome Contém o nome do atributo. Requerido Este atributo não é utilizado pelo adaptador. Especial Nenhum. Tipo Serviços de negócios, objetos de integração e componentes de negócios são suportados por vários tipos de propriedades, por exemplo, int, double, string ou tipos complexos que representam um objeto de integração. Os tipos complexos podem ser um componente de integração ou um Siebel Business Component. Metadados do Objeto de Negócios: Os metadados do objeto de negócios fornecem ao adaptador instruções dependentes do aplicativo sobre como processar objetos de negócios. 12 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

19 Tabela 3. Metadados do Componente do Objeto de Negócios Parâmetro Descrição ComponentName O nome do Siebel Business Component que corresponde ao objeto de negócios do adaptador do WebSphere Business Integration. ObjectName O nome do Siebel Business Object que corresponde ao objeto de negócios do adaptador do WebSphere Business Integration. Tabela 4. Metadados de Propriedade Parâmetro Descrição Globalizado FieldName O nome do campo do campo no Siebel Business Component que corresponde a este atributo. PickListKey Se for especificado um atributo simples como um PickList, um PickListKey. Restrict=<attrname name>, <attr name>, <attr name> Restrict são critérios de procura adicionais que um usuário pode configurar para limitar os registros recuperados. Sim Sim Não Tabela 5. Texto do Aplicativo em Nível de Atributo do Contêiner Parâmetro Descrição Globalizado FieldName Nome do Campo que representa o valor múltiplo Não utilizado com links simples. MultiValueLink MVL configurado como Ativo especifica um relacionamento de um para muitos. A configuração dele como Inativo indica que há um relacionamento de multi value link inativo entre o objeto-pai e o filho (ou seja, não existe nenhum campo de valor múltiplo no objeto-pai). PickList Configurar como true indica um relacionamento de muitos para um. Association Configurar como true especifica que o relacionamento é um relacionamento de muitos para muitos por meio de uma tabela de intersecção. Sim Não Não Não Capítulo 4. Introdução ao Adapter for Siebel Business Applications 13

20 Tabela 5. Texto do Aplicativo em Nível de Atributo do Contêiner (continuação) Parâmetro Descrição Globalizado From=...,;To=... Instruções de pré-processamento para o adaptador para configurar o atributo To para o valor do atributo From. O atributo From deve estar preenchido. O atributo To é configurado apenas se for nulo. Os objetos contendo os atributos devem ter um relacionamento de um-para-um. Ele é utilizado em uma operação Retrieve e é utilizado para especificar qual registro filho precisa ser buscado. SourceField=...;Destination Field... É utilizado com links simples. O SF (Campo de Origem) corresponde ao atributo-chave (Id) no objeto de negócios pai do adaptador do WebSphere Business Integration. O DF (Campo de Destino) é o campo de chave estrangeira no Siebel Business Component filho. Isto corresponde ao atributo filho com o nome do campo configurado como o campo de chave estrangeira no Siebel Business Component. Se SourceField e DestinationField forem nulos no repositório Siebel, o EMD (Enterprise Metadata Discovery) ignorará o atributo correspondente para finalidades de link simples, por exemplo, ele não o gerará como um atributo de link simples. Neste caso, há uma tabela de intersecção e o atributo correspondente se torna uma associação, por exemplo, coberta por ASI (Informações Específicas do Aplicativo) do Tipo de Associação. Além disso, se SourceField for nulo (mas não o DestinationField), SourceField será configurado como Id. Não Não 14 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

21 Tabela 5. Texto do Aplicativo em Nível de Atributo do Contêiner (continuação) Parâmetro Descrição Globalizado KeepRelations Este é um ASI (Informações Específicas do Aplicativo) Booleano. Estas informações decidem se um objeto-filho específico precisa ser excluído ou não do Enterprise Information System. Isto é utilizado apenas para Siebel BOs (Business Objects) e BC (Business Components), por exemplo, não para serviços de negócios e IO (inputoutput). Não Verbos Suportados: Os verbos são utilizados nas interações de suporte de entrada. Os verbos suportados por saída para Siebel Business Objects incluem o seguinte: v v v v Criar Excluir Atualizar UpdateWithDelete Nota: Para interações de saída, os verbos são ignorados. Para interações de entrada, os seguintes verbos são suportados: v v v v Criar Excluir Atualizar Siebel Business Services Um Siebel Business Service é uma entidade no Siebel que encapsula e simplifica a utilização de alguns conjuntos de funcionalidades, tais como, mover e converter formatos de dados entre o aplicativo Siebel e aplicativos externos. Como o Adaptador Processa Siebel Business Services Um Siebel Business Service é uma entidade no Siebel que encapsula e simplifica a utilização de alguns conjuntos de funcionalidades, tais como, sincronizar entre o aplicativo Siebel e aplicativos externos. Com Siebel Business Services, os desenvolvedores podem encapsular a lógica de negócios em um local central, abstraindo a lógica dos dados na qual ele pode agir. Um serviço de negócios é semelhante a um objeto em uma linguagem de programação orientada a objetos, tem propriedades e métodos e mantém um estado. Os métodos utilizam argumentos que podem ser transmitidos para o objeto através de programação ou de forma declarada por meio de fluxos de trabalho. Capítulo 4. Introdução ao Adapter for Siebel Business Applications 15

22 Um módulo SCA (Service Component Architecture), como um cliente do adaptador, executa um pedido utilizando a especificação de conexão do adaptador. O adaptador utiliza o gráfico de negócios de entrada para determinar qual método do Siebel Business Service chamar. O adaptador cria uma cópia do gráfico de negócios de entrada, que é ocupado com resultados como o gráfico de negócios de saída. O adaptador constrói o conjunto de propriedades Siebel necessárias com base no gráfico de negócios de entrada e chama o método do serviço de negócios. A saída do conjunto de propriedades Siebel é, então, preenchida no gráfico de negócios de saída. O gráfico de negócios de saída é convertido em uma implementação de registro Common Client Interface, que é retornada ao cliente de chamada. O adaptador suporta métodos nos serviços de negócios genéricos, nos serviços de negócios customizados e em interfaces de serviços de aplicativos. O adaptador também suporta o adaptador Siebel EAI (Enterprise Application Integration) e as interfaces integradas de serviços do aplicativo Siebel. O adaptador suporta apenas serviços de negócios que são do tipo de classe CSSEAIDataSyncService e CSSEAIDTEScriptService e CSSEAISiebelAdapter e CSSService. O adaptador suporta EAI Siebel Adapter, um Siebel Business Service integrado é um serviço de negócios de finalidade geral que permite a sincronização de dados, Siebel Application Services e quaisquer serviços de negócios customizados baseados nos tipos de classes suportados. Convenção de Nomenclatura do Objeto de Negócios para Objetos de Negócios que Representam Siebel Business Services: A convenção de nomenclatura para objetos de negócios que representam Siebel Business Services é igual para processamento de entrada e de saída. A convenção de nomenclatura para os objetos de negócios inclui a concatenação de várias palavras, conforme visto na tabela a seguir: Tabela 6. Formatos e Descrições de Nomenclatura do Objeto de Negócios Formato de nomenclatura do objeto de negócios Descrição Prefixo O valor da propriedade Prefixo é prefixado aos nomes dos objetos de negócios do WebSphere gerados no seguinte: v Siebel Business Objects e Siebel Business Components, para processamento de entrada e de saída. v Apenas Siebel Business Services, processamento de saída. Nome do Objeto de Negócios O serviço de negócios para o objeto de negócios. Objeto de Integração O objeto de integração subjacente para o objeto de negócios do contêiner de mensagens Siebel. Componente de Integração O componente de Integração subjacente para o objeto de negócios do contêiner de Mensagens Siebel. 16 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

23 Saída O objeto de integração, objeto de negócios de nível superior, tem a seguinte convenção de nomenclatura: <Prefixo><Nome do Serviço de Negócios><Nome do Método><Nomes de todos os objetos de integração selecionados para os argumentos Input e InputOutput> Se não houver argumentos de Entrada ou de Entrada/Saída, os nomes de todos os argumentos de saída utilizados na concatenação terão o seguinte formato: <Prefixo><Nome do Serviço de Negócios><Nome do Método><Nomes de todos os objetos de integração selecionados para os argumentos de saída> Se não houver argumentos complexos no método, a convenção de nomenclatura terá o seguinte formato: <Prefixo><Nome do Serviço de Negócios><Nome do Método> Os nomes de gráficos de negócios, para os objetos de negócios de primeiro nível gerados com os métodos de serviço de negócios, têm o seguinte formato: <Nome do Objeto de Negócios de Primeiro Nível> + BG. Exemplos Ao utilizar o prefixo IBM, você gera um objeto de negócios para o Siebel EAI Adapter e o método de inserção e, em seguida, escolhe os objetos de integração Account Interface e Business Address Interface em um argumento do método Input e InputOutput. O objeto de negócios correspondente gerado é: IBMEAISiebelAdapterInsertAccountInterfaceBusinessAddressInterface É criado para as opções mencionadas acima. O nome do gráfico de negócios é: IBMEAISiebelAdapterInsertAccountInterfaceBusinessAddressInterfaceBG O nível do componente de integração para os objetos de saída gerados em componentes de integração tem a seguinte convenção de nomenclatura: IO + <Nome do Objeto de Integração> + IC + <Nome do componente de integração> Como exemplo, o objeto de integração Account Interface com o componente de integração Account tem o nome do objeto de negócios, IOAccountInterfaceICAccount. Entrada Como os objetos são gerados apenas para componentes de integração, a convenção de nomenclatura para objetos de entrada segue a utilizada para objetos de saída gerados com os componentes de integração. No entanto, também é gerado um gráfico de negócios. O gráfico de negócios tem o sufixo, BG, incluído no nome do objeto de negócios, por exemplo, IOAccountInterfaceICAccountBG. Capítulo 4. Introdução ao Adapter for Siebel Business Applications 17

24 Nota: O valor da propriedade Prefixo nunca é utilizado para o tipo de serviço de entrada. Estrutura do Objetos de Negócios: As seguintes estruturas do objeto de negócios mostram um método com o mesmo objeto de integração que a entrada e saída, um objeto de negócios de evento de entrada baseado no objeto de integração Account Interface e um método com um objeto de integração diferente da entrada e saída. Um Método com o Mesmo Objeto de Integração que o de Entrada e Saída As seguintes convenções de nomenclatura aplicam-se aos diagramas mostrando métodos, entradas e saídas. v <Prefixo> - Prefixo declarado no EMD (Enterprise Metadata Discovery) v <BSN> - O nome do serviço de negócios para o objeto de negócios v <Método> - O método com o qual o objeto de negócios foi gerado v <IO> - O objeto de integração subjacente é escolhido para ser utilizado no método O diagrama a seguir representa um método com o mesmo objeto de integração sendo utilizado como entrada e saída. Um método com o mesmo objeto de integração que a entrada e a saída <Prefixo><BSN><Método><IO>BG <Prefixo><BSN><Método><IO> SiebelMessage Instância do objeto de integração SearchSpec Outros parâmetros de entrada de tipo simples, se houver algum. Metadados especificam a entrada e a saída Figura 3. Um Método com o Mesmo Objeto de Integração que o de Entrada e Saída Um Objeto de Negócios de Entrada Baseado no Objeto de Integração Account Interface O objeto de nível superior da estrutura de negócios contém informações de metadados que indicam o serviço de negócios ao qual o objeto de negócios corresponde. O gráfico de negócios contém verbos de primeiro nível que são utilizados durante a notificação de eventos como um evento de emissão baseado no verbo. No momento, os verbos suportados são Create, Update e Delete. 18 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

25 O diagrama a seguir representa um objeto de negócios de um evento de entrada.os dados de nível superior representam argumentos de entrada e saída com a mensagem Siebel como um contêiner. Esse mesmo objeto de negócios pode ser utilizado para pedido e resposta e no adaptador para interagir com o EIS (Enterprise Information System) Siebel subjacente. Isso significa que o mesmo tipo de objeto de negócios enviado como um pedido é retornado como o resultado da execução. A mensagem Siebel é um wrapper semelhante ao wrapper utilizado pelo Siebel EIS para agrupar IOs (Objetos de Integração) e seus respectivos campos e componentes nos serviços de negócios, conforme mostrado abaixo. Um objeto de negócios do evento baseado no IO da interface da conta IOAccountInterfaceICAcountBG Verbo está especificado no BG IOAccountInterfaceICAaccount Instância do objeto de integração AccountId Local Outros tipos simples e valores complexos para o objeto de integração Metadados especificam o nome do serviço de negócios e o método do evento Figura 4. Um objeto de negócios do evento baseado no IO da interface da conta Um método com um objeto de integração diferente como entrada e saída O diagrama a seguir corresponde a um serviço de negócios customizado com um objeto de integração diferente como entrada e saída do método. Capítulo 4. Introdução ao Adapter for Siebel Business Applications 19

26 Método com o mesmo Objeto de Integração que a entrada e a saída <Prefixo><BSN><Método><inputIO>BG <Prefixo><BSN><Método><inputIO> Mensagem do Siebel 1 Instância do objeto de integração Mensagem do Siebel 2 SearchSpec Outros parâmetros de entrada ou saída de tipo simples Metadados especificam o que é entrada/saída Figura 5. Um Método com o Mesmo Objeto de Integração que o de Entrada e Saída Propriedades do Atributo do Objeto de Negócios: Os atributos do objeto de negócios armazenam importantes informações de Nome, Tipo e Chave sobre o objeto de negócios. Eles são configurados durante a descoberta do serviço corporativo e podem ser reconfigurados no console administrativo do WebSphere Process Server. A tabela de propriedades de atributos do objeto de negócios mostrada abaixo descreve os atributos utilizados pelo adaptador. Tabela 7. Propriedades do Objeto de Negócios Propriedade Descrição Cardinalidade Para atributos simples, é utilizado 1. Para propriedades do contêiner, dependendo dos requisitos do método, é utilizado n. Chave e chave estrangeira Para componentes de negócios, o ID é a chave primária. Para serviços de negócios e objetos de integração, esses atributos não são utilizados. Nome Contém o nome do atributo. Requerido Este atributo não é utilizado pelo adaptador. Especial Nenhum. Tipo Serviços de negócios, objetos de integração e componentes de negócios são suportados por vários tipos de propriedades, por exemplo, int, double, string ou tipos complexos que representam um objeto de integração. Os tipos complexos podem ser um componente de integração ou um Siebel Business Component. Metadados do Objeto de Negócios: 20 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

27 Os metadados do objeto de negócios fornecem ao adaptador instruções dependentes do aplicativo sobre como processar objetos de negócios. Tabela 8. Texto Específico do Aplicativo do Objeto de Negócios Parâmetro Descrição BSN O nome do serviço de negócios utilizado pelo objeto de negócios. EventMethod Identifica o método do evento a ser utilizado quando recuperar dados do evento para operações de entrada, em vez do método de Consulta padrão. IC O nome do componente de integração Siebel correspondente ao objeto de negócios. IO O nome do objeto de integração Siebel correspondente ao nome do serviço de negócios do objeto de negócios. Tabela 9. Metadados de Propriedade Parâmetro Descrição FN O nome do campo no método do componente de integração ou de serviço de negócios que a propriedade representa. ParamType Identifica se a propriedade é uma entrada, uma saída, ou ambos. Os valores incluem Input, Output e InOut. Nota: Não há metadados de verbo. Esquema de Metadados do Objeto de Negócios <schema targetnamespace="urn:app:sieb:asi" xmlns:sasi="urn:app:sieb:asi "xmlns:xs=" "xmlns:botm=" elementformdefault="qualified "xmlns=" <complextype name="siebelbusinessobjecttypemetadata"> <sequence minoccurs="1" maxoccurs="1">  <element name="bsn" type="string" />  <element name="io" type="string" />  <element name="ic" type="string" />  <element name="eventmethod" type="string" minoccurs="0" /> </sequence> </complextype> <complextype name="siebelattributetypemetadata"> <sequence>  <element name="fn" type="string" />  <element name="paramtype" type="sasi:paramtypes" /> </sequence> </complextype> Capítulo 4. Introdução ao Adapter for Siebel Business Applications 21

28 <simpletype name="paramtypes"> <restriction base="string"> <enumeration value="input" /> <enumeration value="output" /> <enumeration value="inout" /> </restriction> </simpletype> </schema> Verbos Suportados: Os verbos de saída e de entrada são suportados pelo adaptador. Os verbos suportados por saída para Siebel Business Objects incluem o seguinte: v v v v Criar Excluir Atualizar UpdateWithDelete Para interações de entrada, os seguintes verbos são suportados nos Siebel Business Objects do objeto de integração. v Criar v v Excluir Atualizar Enterprise Service Discovery O assistente Enterprise Service Discovery consiste em dois componentes, a implementação do Enterprise Metadata Discovery na ferramenta EAI (Enterprise Application Integration) e o adaptador. Quando o adaptador é importado para o ambiente de ferramentas EAI, como o WebSphere Integration Developer, você pode executar o assistente Enterprise Service Discovery e gerar automaticamente os artefatos do componente de serviço e objetos de negócios necessários para uma solução de integração executada no WebSphere Process Server. Selecionando entidades Enterprise Information System dos nós da estrutura em árvore de metadados, você pode gerar objetos de negócios para entidades Enterprise Information System ou de banco de dados. Você pode procurar as informações de metadados de um Enterprise Information System ou banco de dados, selecionar as entidades de interesse e gerar objetos de serviços e descrições implementáveis. Os metadados são transformados em objetos de dados de serviço que consistem em gráficos de negócios e objetos de negócios. Nota: Os artefatos do componente de serviço são uma parte física de informações utilizadas ou produzidas por um processo de desenvolvimento de software. Exemplos de artefatos incluem modelos, arquivos de origem, scripts e arquivos executáveis binários. O assistente Enterprise Service Discovery permite que você execute as seguintes ações: v Gerar objetos de negócios v Configurar informações específicas do aplicativo em objetos de negócios do Websphere v Configurar informações específicas do aplicativo nas propriedades do objeto de negócios do Websphere 22 IBM WebSphere Adapters: Guia do Usuário do Adapter for Siebel Business Applications

29 v Fornecer descrições de conexões para os eventos de entrada e saída v Fornecer Descrições de Serviço para Eventos de Entrada e de Saída Nota: A descrição de um serviço da Web pode ser definidas em qualquer formato, como por exemplo, WSDL, UDDI ou HTML. Processamento de Saída Para processamento de pedidos de saída, um cliente J2EE externo chama o adaptador por meio da SCA (Service Component Architecture). O cliente então solicita uma execução que, por sua vez, é transmitida do adaptador para o EIS (Enterprise Information System). Com o processamento de saída, o cliente pode fazer chamadas para o adaptador para desempenhar operações específicas no sistema de arquivos EIS. O Adapter for Siebel Business Applications é orientado a metadados para processamento de saída para objetos de negócios e componentes de negócios. O adaptador suporta objetos de negócios hierárquicos. As informações sobre o objeto prestes a ser processado estão armazenadas nas informações específicas do aplicativo para o objeto e cada um de seus atributos. Processando Objetos de Negócios Modelados em Siebel Business Objects O adaptador suporta as operações Create, Update, Delete, RetrieveAll, Retrieve, Exists e ApplyChanges. A operação Delete é uma exclusão física. O adaptador utiliza a operação Retrieve para operações de entrada para recuperar os objetos do aplicativo Siebel. O padrão de comando de classes de base do adaptador é utilizado para desempenhar as operações. O nome da ordem de execução é AFTER_PARENT. Processando Objetos de Negócios Modelados em Siebel Business Services: O adaptador modela as chamadas de método de serviço de negócios Siebel como objetos de negócios. O processamento de eventos de saída consiste nas seguintes etapas: 1. Um objeto de negócios que representa a chamada de método Siebel é transmitido do aplicativo cliente JCA para o adaptador utilizando o registro CCI (Common Client Interface). O registro CCI é uma instância da implementação CCI que permite a interação entre o aplicativo J2EE e o adaptador, e depois para o sistema backend Siebel. Este registro gera e configura o objeto de negócios. 2. O adaptador extrai os elementos do objeto de negócios e, utilizando as informações de metadados do objeto de negócios, reconhece a interface Siebel a ser utilizada. 3. O adaptador converte os dados do objeto de negócios na chamada de método Siebel apropriada. 4. O adaptador executa o método no serviço de negócios Siebel designado. Para processamento de entrada, o adaptador modela os objetos de integração como objetos de negócios. Selecione o nome do serviço de negócios que processa o objeto de integração necessário. Por exemplo, selecione o EAI Siebel Adapter se você planeja utilizar um objeto de integração baseado em um objeto de negócios Siebel Capítulo 4. Introdução ao Adapter for Siebel Business Applications 23

Exibir mais