Brazilian Portuguese Wsa 20091214 PSFT PDF

WebSphere
Guia do Usurio do Adapter para PeopleSoft Enterprise
ii
IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise
ndice
Captulo 1. Viso Geral do WebSphere Adapter para PeopleSoft Enterprise . . . 1
O Que H de Novo Neste Release . . . Requisitos de Hardware e Software . . . Viso Geral Tcnica . . . . . . . . Processamento de Sada . . . . . Processamento de Entrada . . . . . Objetos de Negcios . . . . . . . Ligaes de Dados Java. . . . . . O Assistente Bean J2C . . . . . . Conformidade das Normas . . . . Suporte para o Log and Trace Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 . 2 . 3 . 3 . 4 . 8 . 9 . 10 . 10 . 11 Configurando Propriedades de Especificao de Ativao para Adaptadores Incorporados . . . Alterando Propriedades de Configurao para Adaptadores Independentes . . . . . . . . . Configurando Propriedades do Adaptador de Recursos para Adaptadores Independentes . . . Configurando Propriedades do Connection Factory (J2C) Gerenciado para Adaptadores Independentes . . . . . . . . . . . . Configurando Propriedades do Adaptador de Recursos para Adaptadores Independentes . . . Incluindo bibliotecas de dependncias ao adaptador de recursos implementado . . . . . . . . . Implementao Independente . . . . . . . Implementao de EAR . . . . . . . . . 35 36 36
37 39 40 40 40
Captulo 2. Planejando a Implementao do Adaptador . . . . . 13

Antes de comear . . . . . . . . . . . Segurana . . . . . . . . . . . . . . Suporte para Proteger Dados do Usurio Sigilosos nos Arquivos de Log e Rastreio. . . . . . . Autenticao de Usurio . . . . . . . . . Opes de Implementao . . . . . . . . WebSphere Adapters em Ambientes em Clusters . . 13 . 13 . . . . 13 14 15 17
Captulo 5. Resoluo de Problemas e Suporte . . . . . . . . . . . . . . 43

Configurando a Criao de Log e Rastreio . . . . Configurando Propriedades de Criao de Log Alterando os Nomes do Arquivo de Log e Rastreio . . . . . . . . . . . . . . Suporte a First-Failure Data Capture (FFDC) . . . Suporte para Cdigos dos Idiomas No-Ingls Durante o Processamento de Entrada . . . . . . Suporte para Configurar Valores com o PeopleTools 8.22 . . . . . . . . . . . . . . . . . Recursos de Auto-atendimento . . . . . . . . 43 43 45 46 46 47 48
Captulo 3. Configurando o Mdulo para Implementao . . . . . . . . . 19

Criando um Projeto de Evento Customizado no PeopleTools . . . . . . . . . . . . . Ativando o assistente do J2C Bean. . . . . . Configurando as dependncias do conector. . . Configurando Propriedades de Conexo do Assistente Bean J2C. . . . . . . . . . . Configurando o Mdulo para Processamento de Sada . . . . . . . . . . . . . . . Selecionando Objetos de Negcios e Servios . Configurando os Objetos Selecionados . . . Configurando Propriedades de Implementao e Gerando Artefatos . . . . . . . . . . Gerando o Projeto EJB ou JSP . . . . . . Configurando o Mdulo para Processamento de Entrada. . . . . . . . . . . . . . . Selecionando Objetos de Negcios e Servios . Configurando os Objetos Selecionados . . . Configurando Propriedades de Implementao e Gerando Artefatos . . . . . . . . . . . 19 . 20 . 21 . 22 . 24 . 24 . 25 . 26 . 28 . 30 . 30 . 31 . 32
Captulo 6. Informaes de Referncia

Informaes sobre o Objeto de Negcios. . . . . Informaes Especficas do Aplicativo . . . . Operaes Suportadas . . . . . . . . . . PeopleCode para um projeto de eventos customizado . . . . . . . . . . . . . . Propriedades de Configurao de Sada . . . . . Propriedades de Conexo do Assistente Bean J2C Propriedades do Adaptador de Recursos . . . Propriedades Managed Connection Factory. . . Propriedades de Especificao de Interao . . . Propriedades de Configurao de Entrada . . . . Propriedades de Conexo do Assistente Bean J2C Propriedades do Adaptador de Recursos . . . Propriedades de Especificao de Ativao . . . Globalization . . . . . . . . . . . . . . Globalizao e Transformao de Dados Bidirecional . . . . . . . . . . . . . Propriedades Ativadas para Transformao de Dados Bidirecional . . . . . . . . . . .
49
49 49 50 51 56 57 60 65 72 73 74 77 82 92 93 94
Captulo 4. Configurando o aplicativo no WebSphere Application Server . . . 33

Alterando Propriedades de Configurao para Adaptadores Incorporados . . . . . . . . Configurando Propriedades do Adaptador de Recursos para Adaptadores Incorporados . . Configurando propriedades do Connection Factory (J2C) gerenciado para adaptadores incorporados . . . . . . . . . . . . . 33 . 33
ndice Remissivo . . . . . . . . . . 97
. 34
iii
iv
Captulo 1. Viso Geral do WebSphere Adapter para PeopleSoft Enterprise

Com o adaptador para PeopleSoft Enterprise, possvel criar processos integrados que trocam informaes com o PeopleSoft Enterprise atravs de uma interface padro. Essa interface protege o aplicativo cliente da anlise de detalhes de nvel inferior sobre implementao do aplicativo ou das estruturas de dados usadas no servidor PeopleSoft Enterprise. Com o adaptador, um aplicativo cliente pode enviar e receber pedidos de um servidor PeopleSoft Enterprise. Por exemplo, o aplicativo pode enviar um pedido para consultar o registro de um funcionrio em uma tabela do RH ou pode receber eventos tais como uma notificao do servidor sobre um registro atualizado de funcionrio. Para tornar possvel a comunicao de uma forma padro, o WebSphere Adapter para PeopleSoft Enterprise compatvel com a Java 2 Platform, Enterprise Edition (J2EE) Connector Architecture (JCA). A JCA padroniza a forma como componentes do aplicativo, servidores de aplicativos e sistemas de informaes corporativo, como um servidor PeopleSoft Enterprise, interage uns com os outros. O WebSphere Adapter para PeopleSoft Enterprise ativa servidores de aplicativos JCA-compliant para conectar e interagir com o servidor PeopleSoft Enterprise. Os clientes executados nos servidores JCA-compliant podem ento se comunicar com o servidor PeopleSoft Enterprise em um modo padro usando Java Beans. Por exemplo, considere que voc esteja configurando um adaptador utilizando a ferramenta Rational Application Developer para WebSphere Software, no WebSphere Application Server, e sua empresa utiliza o PeopleSoft Enterprise para coordenar a maioria de suas operaes de negcios. O PeopleSoft Enterprise inclui uma funo de negcios que retorna uma lista de funcionrios em resposta a uma variedade de cdigos de habilidades. Um aplicativo cliente pode estar preparado para utilizar essa funo como parte de um processo de negcios geral. Por exemplo, o departamento de suporte tcnico dentro da empresa envia funcionrios aos sites de clientes para resolver problemas e reparar equipamentos e, como parte desse processo, deve obter uma lista de funcionrios com determinadas habilidades dentro de uma regio geogrfica definida. Entretanto, para utilizar esta funo, o aplicativo cliente que o departamento de suporte tcnico utiliza deve compreender os detalhes de implementao de nvel inferior e as estruturas de dados da funo PeopleSoft. Recursos de tecnologia da informao e tempo devem vincular o aplicativo cliente e a funo PeopleSoft. Com o WebSphere Adapter para PeopleSoft Enterprise possvel gerar automaticamente uma interface com a funo do PeopleSoft para ocultar os detalhes de nvel inferior da funo. Dependendo de seus planos para utilizao do adaptador, voc pode incorpor-lo ao aplicativo implementado ou instal-lo como um componente independente utilizado por mais de um aplicativo. O adaptador incorporado faz parte de um aplicativo implementado no WebSphere Application Server. O componente de aplicativo interage com o adaptador em vez de interagir com a funo do PeopleSoft.
O componente gerado com o Assistente Bean J2C do Rational Application Developer para WebSphere Software usa uma interface padro e objetos de negcios padro, pegando o objeto de negcios enviado pelo aplicativo cliente e chamando a funo do PeopleSoft. Ele ento retorna um objeto de negcios ao aplicativo cliente. O aplicativo cliente no trabalha diretamente com a funo do PeopleSoft. Em vez disso, o componente chama a funo e retorna os resultados. No exemplo, o aplicativo cliente que precisava da lista de funcionrios envia um objeto de negcios com o intervalo de cdigos de qualificaes ao componente adaptador do PeopleSoft. O aplicativo cliente por sua vez, recebe os resultados (a lista de funcionrios) na forma de um objeto de negcios padro. O aplicativo cliente no precisa de informaes sobre a forma como a funo trabalhou ou a estrutura dos dados. O componente adaptador executa todas as interaes com a funo do PeopleSoft. De forma semelhante, o aplicativo cliente pode ser alertado sobre uma alterao nos dados no servidor PeopleSoft Enterprise (por exemplo, uma alterao no conjunto de habilidades de um funcionrio especfico). possvel gerar um componente adaptador que procura por tais eventos no servidor do PeopleSoft Enterprise e notifica os aplicativos clientes com as atualizaes.
O Que H de Novo Neste Release

Esta verso inclui vrios recursos novos para aprimorar a flexibilidade dos negcios, a experincia do usurio e a capacidade de reutilizao. Estas informaes tambm esto disponveis no Web site de suporte do produto WebSphere Adapters http://www.ibm.com/software/integration/wbiadapters/ support/, que atualizado periodicamente com as informaes mais recentes. O WebSphere Adapter para PeopleSoft Enterprise, verso 7.0, inclui os seguintes recursos: v Suporte para objetos de negcios de falhas genricas para conter mensagem de erro e cdigo de erro para a falha de chamada da API
Requisitos de Hardware e Software

Os requisitos de hardware e software para o WebSphere Adapters so fornecido no Web site do IBM Support. Para visualizar os requisitos de hardware e software para o WebSphere Adapters, consulte http://www.ibm.com/support/docview.wss?uid=swg27006249
Informaes Adicionais
Os links a seguir fornecem informaes adicionais que podem ser necessrias para configurar e implementar seu adaptador: v A matriz de compatibilidade para o WebSphere Business Integration Adapters e o WebSphere Adapters identifica as verses suportadas de software necessrio para seu adaptador. Para visualizar este documento, v para a pgina de suporte do WebSphere Adapters e clique em Matriz de Compatibilidade atrs do ttulo Relacionado na seo Links de suporte adicionais: http://www.ibm.com/ software/integration/wbiadapters/support/.
v Notas tcnicas para WebSphere Adapters fornecem soluo alternativa e informaes adicionais que no esto includas na documentao do produto. Para visualizar as notas tcnicas para seu adaptador, v para a seguinte pgina da Web, selecione o nome do adaptador da lista Categoria de Produtos e clique no cone de procura: http://www.ibm.com/support/search.wss?tc=SSMKUK &rs=695&rank=8&dc=DB520+D800+D900+DA900+DA800+DB560&dtm.
Viso Geral Tcnica

O adaptador suporta a troca de dados de negcios entre o servidor PeopleSoft Enterprise e o WebSphere Application Server conectando as duas camadas das classes da interface de programao de aplicativos do PeopleTools que revelam os dados de negcios subjacentes para integrao. O adaptador estabelece conectividade bidirecional com o servidor PeopleSoft Enterprise conectando-se a duas interfaces de programao de aplicativos do PeopleTools: 1. O adaptador acessa a camada de API primria para criar uma instncia de sesso e para se conectar ao servidor de aplicativos atravs da porta Jolt. 2. O adaptador ento acessa a API da Interface do Componente do PeopleSoft, que mostra os objeto de negcios subjacentes, lgica e funcionalidade. No PeopleSoft, um componente um conjunto de pginas agrupadas para uma finalidade de negcios (como o perfil de um funcionrio) e a interface do componente uma API que fornece acesso a um componente a partir de um aplicativo externo. Aps o adaptador estabelecer conexo com a interface do componente, as entidades a seguir so expostas ao adaptador e disponibilizadas para integrao: v Todos os objetos de negcios na definio da interface do componente v Os mtodos PeopleCode associados aos componentes bsicos v Registros, exceto procuras e opes de processamento de menu especfico
Processamento de Sada
O adaptador suporta processamentos de pedidos de sada sncronos, para que quando o aplicativo cliente enviar um pedido na forma de objeto de negcios ao adaptador, o adaptador processe o pedido e retorne ao aplicativo cliente um objeto de negcios que represente o resultado da operao. Quando o adaptador recebe uma hierarquia de objetos de negcios do WebSphere, ele a processa da seguinte forma: 1. O adaptador extrai metadados que identificam a interface do componente PeopleSoft apropriada a ser acessada. 2. O adaptador extrai a operao de sada a ser desempenhada. 3. Aps acessar a interface do componente, o adaptador configura as chaves dos valores especificados nos objetos de negcios. Se os valores de chaves no forem gerados, por exemplo, com uma operao Create, o aplicativo PeopleSoft gera campos-chave. 4. Aps recuperar os objetos do PeopleSoft, o adaptador instancia uma interface de componente existente para excluir, recuperar, atualizar ou criar uma interface de componente. 5. Se operaes de atualizao (Create, Update) sero desempenhadas, o adaptador preencher a interface do componente com dados da hierarquia de objetos de negcios do WebSphere. Se operaes Delete forem necessrias, o
adaptador preencher a interface do componente apenas com StatusColumnName e informao de valor. Nota: Apenas para operaes Create e Update, o adaptador processa atributos na ordem definida no objeto de negcios. Por exemplo, se um atributo complexo estiver entre dois atributos simples, o adaptador processa o atributo simples na primeira posio, em seguida, o atributo complexo e, ento, o atributo simples. Depois que as alteraes forem feitas, a interface do componente ser salva para confirmao dos dados no banco de dados PeopleSoft.
Operaes de Sada Suportadas

O WebSphere Adapter para PeopleSoft Enterprise suporta as seguintes operaes de sada: v Create v Delete v Exists v Retrieve v Retrieve All v Update A tabela a seguir descreve cada uma destas operaes.
Tabela 1. Operaes de Sada Suportadas Operao Create Delete Descrio Cria o objeto de negcios. Exclui o objeto de negcios e seus filhos. Como o adaptador suporta apenas excluses lgicas, os objetos so marcados como excludos mas no removidos. Verifica a existncia de objetos de negcios que chegam. Recupera o componente do PeopleSoft e mapeia dados do componente para o objeto de negcios. Recupera vrias instncias do componente do PeopleSoft e mapeia dados do componente para o objeto de negcios. Atualiza o componente do PeopleSoft correspondente com o objeto de negcios de entrada.
Exists Retrieve RetrieveAll
Update
Processamento de Entrada
O adaptador suporta processamentos de entrada assncronos. Isso significa que o adaptador sonda o servidor PeopleSoft Enterprise em intervalos especificados para eventos. Quando o adaptador detecta um evento, ele converte os dados do evento em um objeto de negcios e os envia para o aplicativo cliente.
Armazenamento de Eventos
O armazenamento de eventos uma tabela que contm eventos que representam alteraes de dados at que o adaptador de sondagem possa process-los. O adaptador utiliza o armazenamento de eventos para acompanhar entidades de evento. Para utilizar o processamento de entrada, voc deve utilizar o PeopleTools Application Designer para criar um projeto customizado para a notificao de
eventos. O projeto customizado utiliza duas funes do PeopleCode que determinam a maneira que futuros eventos so processados e o projeto customizado cria o armazenamento de eventos de que o adaptador precisa para processamento de entrada. Sempre que um objeto de negcios for criado, atualizado ou excludo, a funo PeopleCode utilizada no projeto e includa na interface do componente inserir um novo registro no armazenamento de eventos, com o nome do objeto, chaves e valor de status apropriados. Durando o processamento de entrada, o adaptador sonda os eventos do armazenamento de eventos nos intervalos de sondagem configurados. Em cada chamada de poll, so processados vrios eventos configurados pelo adaptador. A ordem do processamento de eventos baseada na ordem crescente de prioridade e na ordem crescente do registro de data e hora do evento. Os eventos com o status Pronto para Sondagem (0) so selecionados para sondagem em cada ciclo de sondagem. O adaptador utiliza o nome do objeto e a chave do objeto para recuperar o objeto de negcios correspondente. Para assegurar que um evento seja entregue somente uma vez para o aplicativo de destino, configure a propriedade de especificao de ativao AssuredOnceDelivery como true. Ao configur-la como true, um valor XID (ID da transao) configurado para cada evento no armazenamento de eventos. Quando um evento for obtido para processamento, o valor XID para esse evento ser atualizado no armazenamento de eventos. O evento , ento, entregue sua exportao correspondente, e seu status atualizado para mostrar que a entrega do evento foi concluda. Se o aplicativo for parado antes que o evento pudesse ser entregue para a exportao ou se a entrega falhar, o evento talvez no seja completamente processado. Neste caso, o valor XID representa o status em andamento e a coluna XID assegura que o evento seja reprocessado e enviado para a exportao. Aps a conexo com o banco de dados ser restabelecida ou o adaptador ser novamente iniciado, o adaptador procura por eventos na tabela de eventos que possuem um valor de Pronto para Sondagem (0) na coluna XID. O adaptador processa esses eventos primeiro e depois sonda os outros eventos durante ciclos de sondagem. O adaptador utiliza manipulao especial para eventos que possuem o cdigo de status (99) para indicar que esses eventos ocorrero no futuro. Durante um ciclo de sondagem, quando o adaptador recupera eventos com um status futuro, ele compara a hora do sistema com o registro de data e hora em cada evento. Se o registro de data e hora no evento for anterior ou igual hora do sistema, o adaptador processar o evento e alterar o status do evento para Pronto para Sondagem (0). Nota: Se desejar que o adaptador processe eventos com um status futuro no tempo presente, use a funo IBM_PUBLISH_EVENT ao invs de IBM_FUTURE_PUBLISH_EVENT. Fazer isso significa que o evento identificado como Pronto para Poll (0) em vez de Futuro (99). Conforme os eventos so recuperados do armazenamento de eventos e processados, o status do evento alterado para refletir este estado, conforme mostrado na tabela a seguir.
Tabela 2. Valores de Status do Evento Nome Abreviado do Status Evento de Processamento de Erro Descrio Um erro ocorreu durante o processamento do evento. Valor da Tabela de Eventos -1
Tabela 2. Valores de Status do Evento (continuao) Nome Abreviado do Status Pronto para Poll Sucesso Excluda Descrio O evento est pronto para ser selecionado. O evento foi enviado para o gerenciador de eventos. Valor da Tabela de Eventos 0 1
O evento foi processado com 4 xito e foi removido do armazenamento de eventos. Estes eventos devem ser processados em uma data futura. 99
Eventos Futuros
Monitorando Eventos de Entrada

O adaptador suporta o monitoramento de eventos de entrada do servidor PeopleSoft Enterprise, alm de outros eventos que esto sendo monitorados usando WebSphere Business Monitor ou WebSphere Business Events. Monitorando Eventos de Entrada Usando o WebSphere Business Monitor: possvel usar o Rational Application Developer para WebSphere Software e o Adapter para PeopleSoft Enterprise para enviar eventos de entrada ao WebSphere Application Server Common Event Infrastructure (CEI), onde eles so acessveis ao WebSphere Business Monitor. Ao selecionar a opo de monitorar os eventos de entrada no Rational Application Developer para WebSphere Software Assistente Bean J2C, os artefatos necessrios so gerados para monitorar os eventos de entrada. Esses artefatos incluem o J2C Bean acionado por mensagens, assim como a interface, ligaes de dados Java, classe de interceptor, classe auxiliar e os esquemas de eventos que so necessrios para a criao de um modelo de monitor. possvel ento, implementar o aplicativo de monitoramento de eventos de entrada do adaptador resultante que contm o bean acionado por mensagens (o aplicativo do adaptador) em um servidor, tanto um servidor WebSphere Business Monitor, quanto um servidor remoto. O bean acionado por mensagens invoca o bean de sesso stateless que torna os eventos acessveis ao cliente. Mais importante, tambm escuta eventos vindo do servidor PeopleSoft Enterprise (eventos de entrada) e usa o interceptor para configurar os eventos de entrada interceptados como os Common Base Events (CBE). Ele ento posta esses Common Base Events em um destino designado do Sistema de Mensagens Java (JMS) - fila do Common Event Infrastructure, onde eles ficam acessveis ao WebSphere Business Monitor para processamentos adicionais. Importante: O monitoramento de eventos de entrada est disponvel ao seu aplicativo somente se tiver o WebSphere Business Monitor instalado em seu ambiente. Para informaes sobre a instalao do WebSphere Business Monitor, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/ com.ibm.btools.help.monitor.install.doc/install/intro.html. O WebSphere Business Monitor funciona com o WebSphere Application Server verso 6.1; no suportado no WebSphere Application Server verso 7.0. Para mais informaes sobre configurao e requisitos de software, consulte http://publib.boulder.ibm.com/ infocenter/dmndhelp/v6r2mx/index.jsp?topic=/ com.ibm.btools.help.monitor.install.doc/scenarios/eis.html.
Para a ativao da funo de monitoramento de eventos de entrada, execute as seguintes tarefas: 1. Crie um projeto de eventos do cliente em PeopleTools (consulte Criando um Projeto de Evento Customizado no PeopleTools na pgina 19) 2. Inicie o Assistente Bean J2C (consulte Ativando o assistente do J2C Bean na pgina 20) 3. Configure as dependncias do conector (consulte Configurando as dependncias do conector na pgina 21) 4. Configure as propriedades de conexo em Assistente Bean J2C (consulte Configurando Propriedades de Conexo do Assistente Bean J2C na pgina 22) 5. Configurando o mdulo para processamento de entrada (consulte Configurando o Mdulo para Processamento de Entrada na pgina 30) Referncias Relacionadas Para uma amostra sobre ativao de monitoramento de evento de entrada do WebSphere Business Monitor, consulte http://publib.boulder.ibm.com/infocenter/ radhelp/v7r5/index.jsp?topic=/com.ibm.etools.j2c.doc/topics/ tcreatinginboundapps.html. Para informaes sobre como desativar a funo do monitor de eventos, consulte http://publib.boulder.ibm.com/infocenter/radhelp/v7r5/topic/ com.ibm.etools.j2c.doc/topics/tdisablingwbe.html. Para um cenrio de ponta a ponta de amostra sobre publicao de eventos no WebSphere Business Monitor, consulte http://publib.boulder.ibm.com/infocenter/ dmndhelp/v6r2mx/index.jsp?topic=/com.ibm.btools.help.monitor.install.doc/ scenarios/eis.html. Monitorando Eventos de Entrada Usando o WebSphere Business Events: possvel usar o Rational Application Developer para WebSphere Software e o Adapter para PeopleSoft Enterprise para enviar eventos de entrada ao tpico WebSphere Application Server JMS, onde so acessveis ao WebSphere Business Events. Nota: No possvel criar uma conexo JMS com o servidor remoto quando o mesmo nome do connection factory est duplicado. Para maiores informaes, consulte http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/ index.jsp?topic=/com.ibm.websphere.pmc.doc/tasks/tjn0033_.html Ao selecionar a opo de monitorar os eventos de entrada no Rational Application Developer para WebSphere Software Assistente Bean J2C, os artefatos necessrios so gerados para monitorar os eventos de entrada. Esses artefatos incluem o J2C Bean acionado por mensagens, assim como a interface, ligaes de dados Java, classe de interceptor, classe auxiliar e os esquemas de eventos que so necessrios para a criao de um modelo de monitor. possvel ento, implementar o aplicativo de monitoramento de eventos de entrada do adaptador resultante que contm o bean acionado por mensagens (o aplicativo do adaptador) em um servidor. O bean acionado por mensagens invoca o bean de sesso stateless que torna os eventos acessveis ao cliente. Mais importante, tambm escuta eventos vindo do servidor PeopleSoft Enterprise (eventos de entrada) e usa o interceptor para configurar os eventos de entrada interceptados como os Common Base Events (CBE). Ele ento posta esses Common Base Events em um destino designado do
Sistema de Mensagens Java (JMS) - tpico JMS, onde eles ficam acessveis ao WebSphere Business Events para processamentos adicionais. Importante: O monitoramento de eventos de entrada est disponvel ao seu aplicativo somente se tiver o WebSphere Business Events instalado em seu ambiente. Para informaes sobre a instalao do WebSphere Business Events, consulte http://publib.boulder.ibm.com/infocenter/wbevents/v6r2m1/ index.jsp?topic=/com.ibm.wbe.install.doc/doc/install.html. O WebSphere Business Events funciona com o WebSphere Application Server verso 6.1; no suportado no WebSphere Application Server verso 7.0. Para mais informaes sobre configurao e requisitos de software, consulte http://www.ibm.com/software/ integration/wbe/requirements/. Para a ativao da funo de monitoramento de eventos de entrada, execute as seguintes tarefas: 1. Crie um projeto de eventos do cliente em PeopleTools (consulte Criando um Projeto de Evento Customizado no PeopleTools na pgina 19) 2. Inicie o Assistente Bean J2C (consulte Ativando o assistente do J2C Bean na pgina 20) 3. Configure as dependncias do conector (consulte Configurando as dependncias do conector na pgina 21) 4. Configure as propriedades de conexo em Assistente Bean J2C (consulte Configurando Propriedades de Conexo do Assistente Bean J2C na pgina 22) 5. Configurando o mdulo para processamento de entrada (consulte Configurando o Mdulo para Processamento de Entrada na pgina 30) 6. Gere os arquivos eventBOTypeMapping.xml e eventBOTypeMapping.xsd a partir do bean de sesso de entrada gerado. O arquivo eventMapping fornece o mapeamento entre o evento e o esquema do objeto de negcios que o WebSphere Business Event requer para o monitoramento do evento. Para gerar os arquivos eventBOTypeMapping.xml e eventBOTypeMapping.xsd: a. Clique com o boto direito do mouse no bean de sesso. b. Selecione Origem > Gerar Mapeamento de Evento. Os arquivos EventMapping so gerados na mesma pasta que os arquivos de esquema do objeto de negcios. Referncia Relacionada Para a integrao do WebSphere Business Events com o WebSphere Application Adapters, consulte http://publib.boulder.ibm.com/infocenter/wbevents/v6r2m1/ com.ibm.wbe.integrating.doc/doc/integratingusingwebsphereadapters.html.
Objetos de Negcios
Para enviar dados ou obter dados do PeopleSoft Enterprise, o adaptador utiliza objetos de negcios. Um objeto de negcios uma estrutura que consiste em dados, na ao a ser executada nos dados e em instrues adicionais, se houver alguma, para processar os dados. Os dados podem representar uma entidade de negcios, como uma fatura ou um registro de funcionrio, ou um texto no estruturado.
Como Objetos de Negcios So Criados

Utilize o Assistente Bean J2C, que ativado a partir do Rational Application Developer para WebSphere Software, para criar objetos de negcios. O assistente se conecta com o aplicativo, descobre estruturas de dados no aplicativo e gera objetos de negcios para represent-las. Ele tambm gera outros artefatos necessrios pelo adaptador.
Estrutura do Objeto de Negcios

O adaptador suporta objetos de negcios que so estruturados hierarquicamente. O objeto de negcios de nvel superior deve ter uma correspondncia um-para-um com a interface do componente PeopleSoft, e as coletas que ocorrem dentro do objeto de nvel superior so seus filhos. As informaes que o adaptador utiliza para processar o objeto de negcios esto armazenadas no ASI (informaes especficas do aplicativo) para o objeto e em cada um de seus atributos. A tabela a seguir descreve os atributos que compem um objeto de negcios.
Propriedade de Atributos Nome Tipo Descrio Nome do atributo do objeto de negcios. Tipo do atributo do objeto de negcios. O adaptador utiliza o mapeamento de caracteres entre os tipos de propriedade de componente PeopleSoft e os tipos gerados de atributo de objeto de negcios. Os tipos de propriedade de componente PeopleSoft so mapeados para os tipos de atributo gerados, da seguinte forma: v CHAR mapeia para o tipo de atributo String. v NUMBER mapeia para o tipo de atributo Integer. v SIGNED NUMBER mapeia para o tipo de atributo Integer. v DATE mapeia para o tipo de atributo String. v TIME mapeia para o tipo de atributo String. v DTTM mapeia para o tipo de atributo String. Chave As informaes especficas do aplicativo para a chave primria. Os objetos de negcios filho tambm herdam chaves de seu objeto de negcios pai. Cardinalidade nica para atributos simples; cardinalidade mltipla para atributos de continer.
Cardinalidade
Ligaes de Dados Java

Os dados de negcios trocados entre o aplicativo cliente e o adaptador de recursos so representados como Ligaes de Dados Java. Os metadados que descrevem os dados de negcios so definidos como objetos de negcios e representados como esquemas XSD. As Ligaes de Dados Java so geradas desses XSDs e so a realizao dos objetos de negcios. Uma ligao de dados Java uma estrutura que consiste em dados e, em alguns casos, metadados com instrues adicionais para processamento de dados. Ela uma interface Java gerada hierrquica e objetos implementando um Registro. Os dados podem representar uma entidade de negcios tal como uma fatura ou o registro de um funcionrio.
Voc cria ligaes de dados Java utilizando Assistente Bean J2C, ativado a partir das ferramentas do conector Rational Application Developer. O assistente se conecta ao dos sistemas PeopleSoft, descobre estruturas de dados no EIS e gera ligaes de dados para represent-los. O adaptador suporta registros que so hierarquicamente estruturados. Informaes sobre o objeto processado so armazenadas nas informaes especficas do aplicativo para o objeto e cada um de seus atributos.
O Assistente Bean J2C

O Assistente Bean J2C uma ferramenta usada para configurar o adaptador antes de implement-lo no WebSphere Application Server. O Assistente Bean J2C estabelece uma conexo com o servidor do PeopleSoft Enterprise, descobre servios e objetos de negcios (baseado no critrio de procura fornecido) e gera objetos de negcios baseados nos servios descobertos. Utilizando o Rational Application Developer para WebSphere Software, voc estabelece conexo com o servidor PeopleSoft Enterprise para procurar o repositrio de metadados no servidor PeopleSoft Enterprise. No assistente, voc seleciona os objetos de negcios que necessita. O assistente gera automaticamente os esquemas de XSD que representam os objetos de negcios e as ligaes de dados Java correspondentes. O resultado da execuo do Assistente Bean J2C um mdulo que contm os objetos de negcios e servios junto com adaptador. Implemente este mdulo no WebSphere Application Server.
Conformidade das Normas

Este produto compatvel com vrias normas do governo e de mercado, incluindo normas de acessibilidade e de Protocolo da Internet.
Acessibilidade
Administrao O console administrativo de tempo de execuo a interface principal para a implementao e a administrao de aplicativos corporativos. Esses consoles so exibidos em um navegador da Web padro. Utilizando um navegador da Web acessvel, 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 Use o software de reconhecimento de voz como o IBM via Voice, para inserir dados e para navegar na interface do usurio v Operar os recursos utilizando o teclado em vez do mouse possvel configurar e utilizar recursos do produto atravs de editores de texto padro e interfaces de scripts ou de linha de comandos ao invs das interfaces grficas fornecidas. Quando apropriado, a documentao para recursos especficos do produto contm informaes adicionais sobre a acessibilidade dos recursos. assistente J2C Bean O Assistente Bean J2C o componente principal usado para a criao de sistemas EIS de acesso ao aplicativo. Este assistente implementado como um plug-in do Eclipse que est disponvel atravs do Rational Application Developer para WebSphere Software totalmente acessvel.
10
Navegao pelo Teclado Este produto usa as teclas de navegao padro do Microsoft Windows. IBM e acessibilidade Consulte o Web site do Centro de Acesibilidade da IBMhttp:// www.ibm.com/able/ para mais informaes sobre o comprometimento da IBM com a acessibilidade.
Internet Protocol, Verso 6 (IPv6)

O IBM WebSphere Application Server, verso 6.1.0 e posterior e seu componente JavaMail suportam o Internet Protocol Version 6.0 (IPv6) dual-stack. Para mais informaes sobre esta compatibilidade no WebSphere Application Server, consulte o suporte a IPv6 no centro de informaes do WebSphere Application Server. Para obter informaes adicionais sobre IPv6, consulte http://www.ipv6.org.
Suporte para o Log and Trace Analyzer

O adaptador cria arquivos de log e rastreio que podem ser visualizados com o Log and Trace Analyzer. O Log and Trace Analyzer pode filtrar arquivos de log e rastreio para isolar as mensagens e informaes de rastreio para o adaptador. Ele tambm pode ressaltar as mensagens e informaes de rastreio do adaptador no visualizador de log. O ID de componente do adaptador para filtragem e realce uma cadeia composta dos caracteres PSFTRA mais o valor da propriedade do ID de adaptador. Por exemplo, se a propriedade do ID do adaptador estiver configurada como 001, o ID de componente PSFTRA001. Se voc executar vrias instncias do mesmo adaptador, certifique-se de que os primeiros sete caracteres da propriedade de ID do adaptador sejam exclusivos para cada instncia, de modo que voc possa correlacionar as informaes de log e rastreio com uma instncia do adaptador especfica. Ao tornar os sete primeiros caracteres de uma propriedade de ID do adaptador exclusivos, o ID do componente para vrias instncias desse adaptador tambm exclusivo, permitindo que voc correlacione as informaes de log e rastreio com uma determinada instncia de um adaptador. Por exemplo, quando voc configura a propriedade de ID do adaptador de duas instncias do WebSphere Adapter para PeopleSoft Enterprise como 001 e 002. Os IDs de componentes para essas instncias, PSFTRA001 e PSFTRA002, so curtos o suficiente para permanecer exclusivos, permitindo distingui-los como instncias separadas do adaptador. No entanto, instncias com propriedades do ID do adaptador mais longas no podem ser distinguidas umas das outras. Se configurar as propriedades de ID do adaptador de duas instncias como Instance01 e Instance02, voc no poder examinar as informaes de log e rastreio para cada instncia do adaptador porque o ID do componente para ambas as instncias fica truncado para PSFTRAInstanc. Para processamento de sada, a propriedade do ID do adaptador localizada nos grupos de propriedades do adaptador de recursos e do connection factory gerenciado. Se voc atualizar a propriedade de ID do adaptador aps o uso do Assistente Bean J2C para configurar o adaptador para processamento de sada, certifique-se de configurar as propriedades do adaptador de recursos e connection factory gerenciado de forma consistente. Isso evita a marcao inconsistente das entradas de log e rastreio. Para processamento de entrada, a propriedade do ID do adaptador est localizada somente nas propriedades do adaptador de recursos; portanto, essa considerao no se aplica.
11
Para obter informaes adicionais sobre a propriedade do ID de adaptador, consulte ID do Adaptador (ID do Adaptador) na pgina 61.
12
Captulo 2. Planejando a Implementao do Adaptador

Para implementar o IBM WebSphere Adapter para PeopleSoft Enterprise, voc deve planejar o processamento de entrada e sada e considerar os requisitos de segurana e desempenho.
Antes de comear
Antes de comear a configurar e utilizar o adaptador, voc deve ter um claro entendimento de conceitos de integrao de negcios, dos recursos e requisitos das ferramentas de desenvolvimento de integrao e do ambiente de tempo de execuo que sero utilizados e do ambiente do PeopleSoft Enterprise no qual a soluo ser construda e utilizada. Para configurar e implementar o WebSphere Adapter para PeopleSoft Enterprise, voc deve entender e ter experincia com os seguintes conceitos, ferramentas e tarefas: v Os requisitos de negcios para a soluo que voc est construindo. v Os recursos fornecidos pelas ferramentas de desenvolvimento que voc utiliza para construir a soluo. Voc deve saber como utilizar essas ferramentas para criar mdulos, testar componentes e concluir outras tarefas de integrao. v Os recursos e requisitos do ambiente de tempo de execuo utilizados para a soluo de integrao. Voc deve saber como configurar e administrar o servidor host e como utilizar o console administrativo para configurar e modificar definies de propriedade, configurar conexes e gerenciar eventos. v Arquitetura de integrao do PeopleSoft, incluindo o relacionamento entre interfaces do componente e componentes subjacentes. v A verso do PeopleTools que suporta seus aplicativos. Voc deve ser capaz de utilizar o PeopleSoft Application Designer para acessar as definies de objetos que formam um aplicativo de negcios e para criar e incluir projetos em componentes. v O ambiente de programao necessrio para o PeopleSoft (PeopleCode). Voc deve entender a funo do PeopleCode nos componentes e saber como incluir o PeopleCode em projetos criados no Application Designer.
Segurana
O adaptador utiliza a entrada de dados de autenticao J2C, ou alias de autenticao, recurso da segurana Java 2 para fornecer autenticao segura de nome de usurio e senha. Para obter informaes adicionais sobre recursos de segurana, consulte a documentao para o WebSphere Application Server.
Suporte para Proteger Dados do Usurio Sigilosos nos Arquivos de Log e Rastreio
O adaptador fornece a capacidade de evitar que dados sigilosos ou confidenciais nos arquivos de log e rastreio sejam aqueles sem autorizao. Os arquivos de log e rastreio podem conter dados de seu servidor PeopleSoft Enterprise, que podem conter informaes sigilosas ou confidenciais. s vezes esses arquivos podem ser vistos por indivduos que no tm autorizao para
13
visualizar dados sensveis. Por exemplo, um especialista de suporte deve utilizar os arquivos de log e rastreio para solucionar um problema. Para proteger os dados em tais situaes, o adaptador lhe permite especificar se deseja evitar que dados confidenciais do usurio sejam exibidos nos arquivos de log do adaptador e de rastreio. possvel selecionar essa opo no Assistente Bean J2C ou alterar a propriedade HideConfidentialTrace. Quando essa propriedade estiver ativada, o adaptador substituir os dados sensitivos pelos dados do XXX. Consulte Propriedades Managed Connection Factory na pgina 65 , para obter informaes sobre essa propriedade opcional. Os seguintes tipos de informaes so considerados potencialmente dados sensitivos e so disfarados: v O contedo de um objeto de negcios v O contedo de uma chave de objeto do registro de eventos v Nome do usurio e senha v A URL utilizada para conectar-se ao servidor PeopleSoft Enterprise Os seguintes tipos de informaes no so considerados dados do usurio e no so ocultados: v O contedo do registro de eventos que no faz parte da chave do objeto de registro de eventos, por exemplo, o XID, ID de evento, nome do objeto de negcios e o status do evento. v Esquemas de objeto de negcios v IDs da Transao v Seqncias de Chamadas
Autenticao de Usurio
O adaptador suporta vrios mtodos para fornecer o nome do usurio e a senha que so necessrios para conexo com o servidor PeopleSoft Enterprise. Entenda os recursos e as limitaes de cada mtodo para selecionar um mtodo que fornea o nvel apropriado de segurana e convenincia para seu aplicativo. Para integrar um adaptador em seu aplicativo, voc precisar de um nome de usurio e de uma senha nos seguintes momentos: v Quando o Assistente Bean J2C se conectar com o servidor PeopleSoft Enterprise para extrair ou descobrir informaes sobre os objetos e servios que voc pode acessar com o adaptador. v No tempo de execuo doWebSphere Application Server, quando o adaptador se conectar com o servidor PeopleSoft Enterprise para processar pedidos de sada e eventos de entrada.
Autenticao no Assistente
O Assistente Bean J2C solicita informaes de conexo para o processo de descoberta e, em seguida, as reutiliza como os valores padro das propriedades do adaptador que especifica as informaes de conexo utilizadas no tempo de execuo. Enquanto executa o assistente, voc pode utilizar um nome de usurio e uma senha diferentes dos que utiliza quando o aplicativo implementado no servidor. Voc pode at conectar-se a um servidor PeopleSoft Enterprise diferente, embora o nome do esquema deva ser igual nos dois bancos de dados. Por
14
exemplo, ao desenvolver e integrar um aplicativo que utiliza o Adapter para PeopleSoft Enterprise, voc pode no utilizar o banco de dados de produo; utilizando um banco de dados de teste com o mesmo formato de dados mas menor, os registros simulados permitem que voc desenvolva e integre o aplicativo sem causar impacto no desempenho de um banco de dados de produo e sem encontrar restries causadas pelos requisitos de privacidade para dados do cliente. O assistente utiliza o nome do usurio e a senha especificados para o processo de descoberta apenas durante o processo de descoberta; eles no ficam acessveis aps o assistente ser concludo.
Autenticao no Tempo de Execuo

No tempo de execuo, o adaptador precisa fornecer o nome do usurio e a senha para se conectar com o servidor PeopleSoft Enterprise. Para se conectar sem interveno do usurio, o adaptador deve acessar uma cpia salva das informaes do usurio. Em um ambiente do servidor, existem vrios mtodos para salvar informaes do usurio. O Assistente Bean J2C permite configurar o adaptador para obter informaes do usurio utilizando qualquer um dos seguintes mtodos: v Propriedades do adaptador v Alias de autenticao do J2C Salvar o nome do usurio e a senha nas propriedades do adaptador uma forma direta de fornecer essas informaes no tempo de execuo. Voc fornece esse nome de usurio e senha ao utilizar o Assistente Bean J2C para configurar seu mdulo. Embora a especificao direta do nome do usurio e da senha parea o mtodo mais certo, ele tem importantes limitaes. As propriedades do adaptador no so criptografadas; a senha armazenada como um texto claro nos campos que ficam acessveis para os outros no servidor. Alm disso, quando a senha alterada, voc deve atualiz-la em todas as instncias do adaptador que acessam esse servidor PeopleSoft Enterprise. Isso inclui os adaptadores embutidos em arquivos EAR do aplicativo, assim como os adaptadores que so instalados separadamente no servidor. Utilizar uma entrada de dados de autenticao do J2C ou um alias de autenticao, criado com o recurso do Java Authentication and Authorization Service (JAAS) da segurana do Java 2 uma forma robusta e segura de implementar aplicativos. Um administrador cria o alias de autenticao que utilizado por um ou mais aplicativos que precisam acessar um sistema. O nome do usurio e a senha podem ser conhecidos apenas por esse administrador, que pode alterar a senha em um nico lugar quando a alterao for necessria.
Opes de Implementao
H duas formas para implementar o adaptador. possvel integr-lo como parte do aplicativo implementado, ou implement-lo como um arquivo RAR independente. Os requisitos do seu ambiente afetam o tipo de opo de implementao que voc escolhe. As opes de implementao so descritas abaixo: v Quando voc implementa o adaptador como um componente incorporado, o adaptador includo em um arquivo enterprise application archive (EAR) e est disponvel apenas para o aplicativo no arquivo EAR. v Quando voc implementa o adaptador como um componente independente, o adaptador representado por um arquivo resource adapter archive (RAR)
15
independente. Quando ele implementado, fica disponvel para todos os aplicativos implementados na instncia do servidor. Um adaptador incorporado est includo em um pacote configurvel com um arquivo EAR (Enterprise Archive) e est disponvel apenas para o aplicativo com o qual empacotado e implementado. Ao criar o projeto para seu aplicativo utilizando o Rational Application Developer para WebSphere Software, voc pode escolher como empacotar o adaptador [includo no pacote configurvel com o arquivo (EAR) ou como um arquivo (RAR) independente]. Sua escolha afeta em como o adaptador usado no ambiente de tempo de execuo e tambm em como as propriedades do adaptador so exibidas no console administrativo. A escolha de incorporar um adaptador com seu aplicativo ou implementar o adaptador como um mdulo independente depende de como voc deseja administrar o adaptador. Se desejar uma nica cpia do adaptador e no se preocupar com a interrupo de vrios aplicativos quando atualizar o adaptador, ser recomendvel implementar o adaptador como um mdulo independente. Se pretende executar vrias verses e estiver preocupado com uma possvel interrupo ao atualizar seu adaptador, voc deve embutir o adaptador com o aplicativo. Embutir o adaptador com o aplicativo permite associar uma verso do adaptador com uma verso do aplicativo e administr-la como um nico mdulo. Para implementar o arquivo RAR no servidor de aplicativos, voc deve obter e instalar o Adapter para PeopleSoft Enterprise (nmero do produto 5724-T76). Isso fornece o arquivo RAR que voc instala seguindo as instrues fornecidas com o WebSphere Application Server.
Consideraes para Embutir um Adaptador no Aplicativo

Considere os itens a seguir se planeja embutir o adaptador em seu aplicativo: v Um adaptador embutido possui isolamento de carregador de classes. Um carregador de classes afeta o pacote dos aplicativos e o comportamento dos aplicativos empacotados implementados em ambientes de tempo de execuo. O Isolamento do carregador de classes significa que o adaptador no pode carregar classes de um outro aplicativo ou mdulo. O isolamento do carregador de classes impede que duas classes com o mesmo nome em diferentes aplicativos interfiram uma com a outra. v Cada aplicativo em que o adaptador embutido deve ser administrado separadamente.
Consideraes para Utilizar um Adaptador Independente

Considere os itens a seguir se planeja usar um adaptador independente: v Adaptadores independentes no tm isolamento de carregador de classes. Como os adaptadores independentes no possuem isolamento do carregador de classes, apenas uma verso de qualquer artefato Java especificado executada e a seqncia desse artefato indeterminada. Por exemplo, ao utilizar um adaptador independente, h apenas uma verso do adaptador de recursos, uma verso do AFC (Adapter Foundation Class) ou uma verso de JAR de terceiros. Todos os adaptadores implementados como adaptadores independentes compartilham uma nica verso de AFC e todas as instncias de um
16
determinado adaptador compartilham a mesma verso de cdigo. Todas as instncias do adaptador utilizando uma determinada biblioteca de terceiros devem compartilhar essa biblioteca. v Se voc atualizar qualquer um desses artefatos compartilhados, todos os aplicativos utilizando os artefatos sero afetados. Por exemplo, se voc tiver um adaptador que esteja funcionando com o servidor verso X, e atualizar a verso do aplicativo cliente para a verso Y, seu aplicativo original poder parar de funcionar. v Adapter Foundation Classes (AFC) so compatveis com verses anteriores, mas a verso de AFC mais recente deve estar em cada arquivo RAR que for implementado de maneira independente. Se mais de uma cpia de qualquer arquivo JAR estiver no caminho de classe em um adaptador independente, a utilizao ser aleatria; portanto, todas devem estar na verso mais recente.
WebSphere Adapters em Ambientes em Clusters

possvel aprimorar o desempenho e a disponibilidade implementando o mdulo em um ambiente do servidor em cluster. O mdulo replicado atravs de todos os servidores em um cluster, independentemente de voc implementar o mdulo utilizando um adaptador independente ou embutido. O WebSphere Application Server, WebSphere Application Server Network Deployment e o WebSphere Extended Deployment suportam ambientes em cluster. Clusters so grupos de servidores que so gerenciados juntos para equilibrar cargas de trabalho e para fornecer alta disponibilidade e escalabilidade. Quando configura um cluster de servidores, voc cria um perfil do Deployment Manager. O HAManager, um subcomponente do Deployment Manager, notifica o continer da Java 2 Platform, Enterprise Edition (J2EE) Connector Architecture (JCA) para ativar a instncia do adaptador. O continer do JCA fornece um ambiente de tempo de execuo para instncias do adaptador. Utilizando o WebSphere Extended Deployment, opcionalmente, voc pode aprimorar o desempenho de instncias do adaptador em seu ambiente em cluster. O WebSphere Extended Deployment estende os recursos do WebSphere Application Server Network Deployment utilizando um gerenciador de carga de trabalho dinmica em vez de um gerenciador de carga de trabalho esttica, que utilizado pelo WebSphere Application Server Network Deployment. O gerenciador de carga de trabalho dinmica pode otimizar o desempenho de instncias do adaptador no cluster equilibrando dinamicamente o carregamento dos pedidos. Isso significa que as instncias do servidor de aplicativos podem ser paradas e iniciadas automaticamente com base nas variaes de carregamento, permitindo que mquinas com capacidades e configuraes diferentes manipulem igualmente as variaes de carregamento. Em ambientes em cluster, instncias do adaptador podem manipular processos de entrada e sada.
Alta Disponibilidade para Processos de Entrada

Processos de entrada so baseados em eventos acionados como um resultado de atualizaes em dados no servidor PeopleSoft Enterprise. O O WebSphere Adapter para PeopleSoft Enterprise est configurado para detectar atualizaes efetuando poll de uma tabela de eventos. O adaptador ento publica o evento em seu terminal.
17
Quando voc implementa um mdulo em um cluster, o continer do Java 2 Platform, Enterprise Edition (J2EE) Connector Architecture (JCA) verifica a propriedade do adaptador de recursos enableHASupport. Se o valor da propriedade enableHASupport for true, que a configurao padro, todas as instncias do adaptador sero registradas com o HAManager com uma poltica 1 de N. Essa poltica significa que somente uma instncia do adaptador inicia a sondagem de eventos. Embora outras instncias do adaptador no cluster estejam iniciadas, elas permanecem inativas em relao ao evento ativo, at que a instncia do adaptador ativa conclua o processamento do evento. Se o servidor no qual o encadeamento de polling foi iniciado for encerrado por alguma razo, uma instncia do adaptador que est em execuo em um dos servidores de backup ser ativada. Importante: No altere a configurao da propriedade enableHASupport.
Alta Disponibilidade para Processos de Sada

Em ambientes em cluster, vrias instncias do adaptador esto disponveis para desempenhar pedidos de processo de sada. Portanto, se seu ambiente tiver vrios aplicativos que interagem com o WebSphere Adapter para PeopleSoft Enterprise para pedidos de sada, voc poder aprimorar o desempenho implementando o mdulo em um ambiente em cluster. Em um ambiente em cluster, vrios pedidos de sada podem ser processados simultaneamente, contanto que no estejam tentando processar o mesmo registro. Se vrios pedidos de sada estiverem tentando processar o mesmo registro, como um Endereo do cliente, o recurso de gerenciamento de carga de trabalho no WebSphere Application Server Network Deployment distribuir os pedidos entre as instncias do adaptador disponveis na seqncia em que foram recebidos. Como resultado, esses tipos de pedidos de sada em um ambiente em cluster so processados da mesma maneira que aqueles em um ambiente de servidor nico: uma instncia do adaptador processa somente um pedido de sada por vez.
18
Captulo 3. Configurando o Mdulo para Implementao

Para configurar o adaptador para que ele possa ser implementado no WebSphere Application Server, utilize o Rational Application Developer para WebSphere Software para criar um mdulo, que exportado como um arquivo EAR durante a implementao do adaptador. Especifique os objetos de negcios que deseja descobrir e o sistema no qual deseja descobri-los.
Criando um Projeto de Evento Customizado no PeopleTools

Para desempenhar o processamento de eventos de entrada assncrono, o adaptador necessita de um projeto de eventos no PeopleSoft. Utilize o PeopleTools para criar o projeto de evento customizado.
Por Que e Quando Desempenhar Esta Tarefa

Se o seu ambiente exige suporte para evento de entrada, ser necessrio utilizar um projeto de evento customizado no PeopleSoft. Um projeto de evento de amostra, IBM_EVENT_V600, fornecido com o adaptador. Voc pode modificar e utilizar o projeto de amostra ou pode criar seu prprio projeto utilizando o PeopleTools. Se voc criar seu prprio projeto, utilize as seguintes etapas: 1. Utilize o PeopleTools Application Designer para criar e nomear um novo projeto. 2. Crie os campos para o novo projeto conforme descrito na tabela a seguir:
Nome do campo IBM_EVENT_ID Descrio de campo Valor numrico que recuperado do registro IBM_FETCH_ID. Este valor um ID exclusivo para o evento. Nome do grfico de negcios correspondente. Para obter os nomes de propriedade de chave na Interface do Componente seguidos pelos valores de chave nos pares nome-valor. Este valor utilizado para recuperar o componente do enterprise information system (EIS). Status do evento. O status ser 0 se o evento estiver pronto para ser sondado. A funo IBMPublishEvent chamada. Verbo que configurado no grfico de objeto de negcios que contm o objeto de negcios recuperado. Data de criao do evento. Para um evento com data futura, este valor a data efetiva. Campo que possui o ID de evento mais recente no registro IBM_FETCH_ID. O valor incrementado para cada evento que includo na tabela IBM_EVENT_TBL. O campo IBM_EVENT_ID preenchido dentro dessa tabela.
IBM_OBJECT_NAME IBM_OBJECT_KEYS
IBM_EVENT_STATUS
IBM_OBJECT_VERB
IBM_EVENT_DTTM IBM_NEXT_EVENT_ID
19
Nome do campo IBM_XID
Descrio de campo O ID da transao que assegura o fornecimento da garantia de entrega de evento. O identificador exclusivo para a instncia do adaptador que receber um evento especfico.
IBM_CONNECTOR_ID
3. Crie um registro denominado IBM_EVENT_TBL e inclua nele todos os campos recm-criados, exceto IBM_NEXT_EVENT_ID. 4. Crie um registro denominado IBM_FETCH_ID e inclua nele somente o campo IBM_NEXT_EVENT_ID. 5. Abra o registro IBM_FETCH_ID, selecione o campo IBM_NEXT_EVENT_ID, visualize o PeopleCode e selecione fieldformula. 6. Copie o PeopleCode do projeto de evento customizado, encontrado na seo Referncia desta documentao, para o projeto que voc est criando. 7. Crie uma pgina em seu projeto que contenha os campos do registro IBM_EVENT_TBL no nvel 0. A pgina pode ter qualquer nome. 8. Crie um componente em seu projeto que contenha a pgina que voc acabou de criar. O componente pode ter qualquer nome. 9. Crie uma Interface de Componente nesse componente e d a ela qualquer nome. Certifique-se de que tenha usado as propriedades baseadas na definio de componente subjacente. 10. Construa o projeto inteiro, selecionando todas as opes de criao. 11. Teste e confirme se a Interface do Componente funciona, utilizando o testador de interface de componente. 12. Gere as APIs Java para a Interface do Componente e, em seguida, inclua as classes geradas no caminho da classe do adaptador. Para obter informaes adicionais sobre a construo de um projeto PeopleTools e testar a Interface do Componente do PeopleSoft, consulte a documentao do PeopleSoft.
Ativando o assistente do J2C Bean

Para iniciar o processo de criao e implementao de um mdulo, inicie o Assistente Bean J2C no Rational Application Developer para WebSphere Software. O assistente cria um projeto de conector, o qual utilizado para organizar os arquivos associados ao mdulo.
Antes de Iniciar
Certifique-se de ter reunido as informaes necessrias para estabelecer uma conexo com o servidor PeopleSoft Enterprise. Por exemplo, voc precisa do nome ou endereo IP do servidor PeopleSoft Enterprise e do ID de usurio e da senha necessrios para acess-lo.

Se voc possui um projeto, poder utiliz-lo em vez de criar um novo projeto. Selecione-o antes de iniciar o assistente. 1. Para iniciar o Assistente Bean J2C, v para o Enterprise Explorer do Rational Application Developer para WebSphere Software e clique em Arquivo Novo Outro J2C Bean J2C.
20
2. Clique em Avanar. 3. Na janela Seleo de Adaptador de Recurso, expanda a pasta PeopleSoft e selecione IBM WebSphere Adapter para PeopleSoft Enterprise (IBM : version), em que version a verso do adaptador que voc quer utilizar. 4. Clique em Avanar. 5. Na janela, aceite o nome do projeto padro no campo Projeto do Conector ou digite um nome diferente. 6. No campo Servidor de destino, selecione o tipo de servidor onde implementar o mdulo. O assistente cria os artefatos que so apropriados para esse servidor. 7. Clique em Avanar. A janela Configuraes do Conector exibida.
Resultados
Um novo projeto de conector criado, o qual contm o arquivo RAR do adaptador. O projeto listado na perspectiva visualizao do Enterprise Explorer da perspectiva Java EE.
O que Fazer Depois

Continue trabalhando no Assistente Bean J2C. A prxima etapa incluir arquivos especficos de banco de dados no projeto.
Configurando as dependncias do conector

O Assistente Bean J2C precisa de dois arquivos copiados ou gerados a partir do PeopleSoft Enterprise para poder se comunicar com ele. Utilize o Assistente Bean J2C para especificar o local dos arquivos JAR. Para incluir os arquivos JAR necessrios para o seu projeto, certifique-se de que os arquivos estejam na mquina local e, em seguida, utilize o Rational Application Developer para WebSphere Software para especificar o local dos arquivos.
Antes de Iniciar
Voc deve estar executando o Assistente Bean J2C no Rational Application Developer para WebSphere Software para executar esta tarefa.

Para incluir os dois arquivos de dependncia necessrios do PeopleSoft, o PeopleSoft psjoa.jar e o arquivo jar da interface do componente, use a janela Configuraes do Conector do Assistente Bean J2C para especificar o local dos arquivos. 1. Obtenha os dois arquivos especficos do driver PeopleSoft do administrador do PeopleSoft Enterprise. 2. Na janela Configuraes do Conector, especifique o local dos arquivos especficos do driver do PeopleSoft. 3. Clique em Avanar.
Resultados
O assistente possui os arquivos necessrios para se comunicar com o servidor PeopleSoft.
21
Configurando Propriedades de Conexo do Assistente Bean J2C

Para configurar as propriedades de conexo do Assistente Bean J2C para que ele possa acessar o servidor PeopleSoft Enterprise, especifique informaes como o nome de usurio e senha que usou para acessar o servidor e o nome ou o endereo de IP do servidor.
Antes de Iniciar
Certifique-se de ter includo com sucesso os arquivos de dependncia externa (o psjoa.jar e os arquivos associados).

Especifique as propriedades de conexo que o Assistente Bean J2C precisa para estabelecer uma conexo com o servidor PeopleSoft Enterprise e descobrir funes ou dados. Para especificar as propriedades da conexo, utilize o procedimento a seguir. 1. Na janela Estilo do Adaptador, selecione Entrada (se for enviar dados do servidor PeopleSoft Enterprise) ou Sada (se for enviar dados para o servidor PeopleSoft Enterprise) e clique em Avanar. A janela Configurao de Descoberta exibida. 2. Opcional: O monitoramento de eventos s estar disponvel em seu aplicativo se voc tiver WebSphere Business Monitor ou WebSphere Business Events instalados em seu ambiente. v Use o seguinte procedimento, para gerar e monitorar eventos de base comuns e gerenciar esses eventos com os servios Common Event Infrastructure (CEI) usando o WebSphere Business Monitor: a. Selecione a caixa de opo Ativar o Inbound Event Monitor e clique em Avanar. A janela de Configurao de JMS e de Evento exibida. b. No campo Tipo de Evento, selecione WebSphere Business Monitor. c. No campo Nome da JNDI connectionFactory de Fila, aceite o valor padro jms/cei/EventQueueConnectionFactory. d. No campo Nome da JNDI de Consulta, aceite o valor padro, jms/cei/EventQueue. e. Clique em Avanado para incluir propriedades avanadas. f. Na seo de configurao do provedor JNDI remoto, especifique os valores nome da porta e nome do host da URL do provedor de nomenclatura nos campos Host da URL do Provedor de Nomenclatura e Porta da URL do Provedor de Nomenclatura para se conectar ao WebSphere Application Server remoto a partir do assistente. g. Na seo de configurao de autenticao de conexo, digite o nome do usurio no campo Nome do Usurio para se conectar ao servidor a partir do assistente. h. Na seo de configurao de autenticao de conexo, digite a senha no campo Senha para se conectar ao servidor a partir do assistente. i. Clique em Avanar. A janela Configurao de Descoberta exibida. v Utilize o seguinte procedimento para gerar e monitorar eventos base comuns e gerenciar esses eventos utilizando WebSphere Business Events: a. Selecione a caixa de opo Ativar o Inbound Event Monitor e clique em Avanar. A janela de Configurao de JMS e de Evento exibida.
22
b. No campo Tipo de Evento, selecione WebSphere Business Events. c. No campo Nome da JNDI connectionFactory de Tpico, aceite o valor padro, jms/WbeTopicConnectionfactory. d. No campo Nome da JNDI de tpico, aceite o valor padro, jms/WBE/CbeListener. e. Clique em Avanado para incluir propriedades avanadas. f. O campo Configurao de Provedor JNDI Remoto usado para configurar os tpicos remotos. Se o barramento na clula local tiver o mesmo nome do barramento na clula remota, o aplicativo sempre se conecta clula local. Ele no utiliza nenhum dos terminais de provedor especificados no connection factory, portanto, as informaes de Configurao de Tpico Remoto que voc inserir sero ignoradas. Para obter mais informaes sobre a Configurao de Tpico Remoto, consulte http://publib.boulder.ibm.com/infocenter/ wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.pmc.doc/tasks/ tjn0033_.html . g. No campo Host da URL do Provedor de Nomenclatura, especifique o nome do host da URL do provedor de nomenclatura para se conectar ao WebSphere Application Server remoto a partir do assistente. h. No campo Porta da URL do Provedor de Nomenclatura, especifique o nome da porta da URL do provedor de nomenclatura para se conectar ao WebSphere Application Server remoto a partir do assistente. i. Na seo de configurao de autenticao de conexo, digite o nome do usurio no campo Nome do Usurio para se conectar ao servidor a partir do assistente. j. Na seo de configurao de autenticao de conexo, digite a senha no campo Senha para se conectar ao servidor a partir do assistente. k. Clique em Avanar. A janela Configurao de Descoberta exibida. 3. Na janela Configurao de Descoberta, especifique as propriedades de configurao: a. No campo Nome do Host, digite o nome (ou endereo IP) do servidor PeopleSoft Enterprise. b. No campo Nmero da Porta, digite o nmero da porta que o adaptador utiliza para acessar o servidor PeopleSoft Enterprise c. Digite o nome e a senha que voc utiliza para acessar o servidor PeopleSoft Enterprise. A senha faz distino entre maisculas e minsculas. d. Clique em Procurar e selecione o Arquivo JAR da Interface do Componente includo no projeto como um arquivo de dependncia. file. e. Opcionalmente, digite um prefixo para incluir no incio de todos os objetos associados com este mdulo. Um prefixo permite que voc faa a distino entre objetos gerados na mesma interface do componente do PeopleSoft. f. Como opo, selecione a caixa de opo Solicitar definies de configuraes adicionais ao incluir o objeto de negcios se deseja configurar metadados adicionais ao gerar objetos. Utilize esta opo se planejar utilizar operaes Delete e RetrieveAll e se tiver os campos de data efetiva e as chaves geradas utilizadas na operao. 4. Opcional: Para configurar propriedades avanadas adicionais, clique em Avanado.
23
5. Opcional: Para ativar o suporte bidirecional para o adaptador no tempo de execuo: a. Na lista Propriedades Bidi, selecione Transformao de Bibi. b. Configure as propriedades de esquema de ordenao, direo do texto, troca simtrica, formato dos caracteres e formato numrico para controlar como a transformao bidirecional ser executada. 6. Opcional: Para alterar o local dos arquivos de log para o assistente ou a quantidade de informaes includa nos logs, clique em Alterar propriedades de criao de log para assistente, e ento fornea as seguintes informaes: a. Em Local de Sada do Arquivo de Log, especifique o local do arquivo de log para o assistente. b. Em Nvel de Criao de Log, especifique a gravidade dos erros que deseja registrar. Nota: Essas informaes de log servem apenas para o assistente; no tempo de execuo, o adaptador grava mensagens e informaes de rastreio no log padro e arquivos de rastreio para o servidor. 7. Clique em Avanar.
Resultados
O Assistente Bean J2C entra em contato com o servidor PeopleSoft Enterprise utilizando as informaes que voc forneceu (como nome de usurio e senha) para efetuar login. A janela Descoberta e Seleo de Objeto exibida.
O que Fazer Depois

Especifique critrios de procura que o Assistente Bean J2C utiliza para descobrir funes ou dados no servidor PeopleSoft Enterprise.
Configurando o Mdulo para Processamento de Sada

Para configurar um mdulo para utilizar o adaptador para processamento de sada, utilize o Assistente Bean J2C no Rational Application Developer para WebSphere Software para localizar e selecionar objetos de negcios e servios do servidor PeopleSoft Enterprise e para gerar definies de objetos de negcios e artefatos relacionados.
Selecionando Objetos de Negcios e Servios

Para especificar os objetos que deseja importar, utilize o Assistente Bean J2C.
Antes de Iniciar
Certifique-se de ter configurado as propriedades de conexo do Assistente Bean J2C.

Para localizar e selecionar um ou mais objetos, utilize o procedimento a seguir. 1. Na janela Descoberta e Seleo de Objeto, clique no objeto com o qual deseja trabalhar e clique na seta para mov-la para o conjunto selecionado. Para ver filhos de um objeto, clique no sinal de mais.
24
2. Na janela Parmetros de Configurao, especifique as propriedades de configurao do objeto. (Essa janela estar disponvel apenas se voc selecionar a caixa de opo Prompt para Definies de Configurao Adicionais ao Incluir um Objeto de Negcios na janela Configurao de Descoberta). a. Selecione o nome do campo a ser utilizado para desempenhar excluses lgicas. b. No campo Valor utilizado para indicar um objeto excludo, digite o valor de status utilizado para indicar que um objeto no est mais ativo. c. Opcional: Se desejar utilizar teclas alternativas durante operaes RetrieveAll, clique em Incluir e selecione os campos-chave que deseja utilizar. 3. Opcional: Para configurar parmetros adicionais, clique em Avanado. a. Na caixa Preservar objetos na operao de atualizao pai, clique em Incluir e selecione os objetos-filhos aos quais isto se aplica. b. Na caixa Campo que representa chaves geradas no PeopleSoft, clique em Incluir e selecione os campos aos quais isto se aplica. c. Clique na seo Configurao de Data Efetiva e selecione a partir das seguintes opes de data efetiva: v Recuperar apenas o item de data efetiva atual : A ASI correspondente GetCurrentItem. v Inserir na posio de data efetiva mais antiga: A ASI correspondente InsAtOldestEffDtPos. v Inserir na posio de data efetiva atual: A ASI correspondente InsAtCurrentEffDtPos. v Ignorar nmero de seqncia efetiva: A ASI correspondente IgnoreEffectiveSequence. v Campo que representa o valor da data efetiva: A ASI correspondente EffectiveDate. v Campo que representa seqncia da data efetiva: A ASI correspondente EffectiveSequence. Para obter informaes adicionais sobre as opes de data efetiva, consulte Informaes Especficas do Aplicativo na pgina 49 (ASI). 4. Clique em OK para incluir o objeto lista de objetos a serem importados. 5. Quando tiver selecionado todos os objetos, clique em Avanar.
Resultados
Voc selecionou um ou mais objetos para trabalhar.
O que Fazer Depois

Na janela Configurar Propriedades Compostas, inclua ou remova as operaes associadas.
Configurando os Objetos Selecionados

Para configurar o objeto de negcios, voc especifica informaes sobre o objeto (como a operao associada com o objeto).
Antes de Iniciar
Certifique-se de ter selecionado e importado o objeto.
25

Para configurar o objeto de negcios, utilize o procedimento a seguir. 1. Na janela Configurar Propriedades Compostas, insira as seguintes informaes. a. Inclua ou remova operaes para o objeto que ser includo na interface de servio. b. Em Nmero Mximo de Registros para Operaes RetrieveAll, especifique o nmero mximo de registros para recuperar durante o processamento. O valor padro 100. c. Se no desejar especificar um valor de espao de nomes, deixe o valor padro para o campo Espao de Nomes do Objeto de Negcios. d. Opcional: Para indicar onde os objetos de negcios gerados devero ser armazenados, digite o caminho relativo para a pasta no campo Pasta. Nota: Se estiver criando vrios artefatos do adaptador dentro de um mdulo, certifique-se de especificar pastas de objetos de negcios diferentes para cada adaptador dentro do mdulo. Por exemplo, se estiver criando artefatos para Oracle, JDBC, SAP e JDE dentro de um mdulo, voc precisar criar pastas relativas diferentes para cada um desses adaptadores. Se voc no especificar pastas relativas diferentes, os artefatos existentes sero sobrescritos quando voc gerar novos artefatos. 2. Clique em Avanar.
Resultados
A janela Criao e Configurao da Implementao do Bean J2C exibida.
O que Fazer Depois

Gere um mdulo que inclua o adaptador e os objetos de negcios.
Configurando Propriedades de Implementao e Gerando Artefatos

Aps selecionar e configurar os objetos de negcios para o seu modelo, utilize o Assistente Bean J2C para configurar as propriedades que o adaptador utiliza para conexo a um banco de dados especfico. O assistente cria um novo projeto Java onde todos os artefatos e valores de propriedade so salvos.

Esta tarefa executada atravs da Criao do J2C Bean e da janela Configurao de Implementao do assistente J2C Bean. 1. No campo Nome do projeto, selecione ou crie um novo projeto no qual o J2C Bean ser gerado. v Para selecionar um projeto existente, clique em Navegar. Se o nome do projeto desejado aparece na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um novo projeto: a. Clique em Novo. b. Na janela Criao de Projeto de Origem Nova, selecione projeto Java. c. Na janela Criar um projeto novo, digite o nome do projeto. Por exemplo, MyApdapterOutbound. d. Aceite os valores-padro para os outros campos.
26
e. Clique em Concluir. 2. No campo Nome do pacote, selecione ou crie um novo pacote no qual o J2C Bean ser gerado. v Para selecionar um pacote existente, clique em Navegar. Se o nome do pacote desejado aparece na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um novo pacote: a. Clique em Novo. b. Na janela Pacote Java, clique em Projeto Java. c. Na janela Criar um projeto novo, digite um nome para o pacote. Por exemplo, myadapteroutboundpkg. d. Aceite os valores-padro para os outros campos. e. Clique em Concluir. 3. No campo Nome da interface, especifique o nome da interface que deseja usar nos seus objetos de negcios. Por exemplo, MyAdapterOutboundInterface. O nome da implementao gerado automaticamente colocando o sufixo Impl no nome da interface e o nome exibido no campo Nome da implementao. Por exemplo, MyAdapterOutboundInterfaceImpl. 4. Opcional: Selecione a caixa de opo Ativar gerao de Bean de Comando para gerar um bean de comando para cada operao selecionada. Se for criado um bean de comando, ser necessrio especificar o nome do bean de comando e tambm os nomes de entrada e sada. 5. Na rea de propriedades de Conexo, especifique como deseja que o adaptador se conecte com o banco de dados. v Para obter a conexo atravs de JNDI, selecione a caixa de opo Conexo Gerenciada (recomendado). Este tipo de conexo gerenciado pelo servidor de aplicativos. v Para obter a conexo diretamente do adaptador de recursos, selecione a caixa de opo Conexo No Gerenciada. 6. Se a caixa de opo Conexo Gerenciada (recomendado),for selecionada especifique como deseja que adaptador especifique as propriedades de conexo. v Para selecionar um nome existente, clique em Navegar. v Caso contrrio, crie um novo nome. a. Clique em Novo. b. Na janela de seleo do Servidor, especifique o servidor no qual implementar o adaptador e clique em Avanar. c. Na janela Novo J2C Connection Factory, especifique o nome no campo Nome de JNDI. Por exemplo,com/eis/AdapterCF. d. Clique em Concluir. 7. Se a caixa de opo Conexo No Gerenciada for selecionada, a rea de informaes de conexo de sistema de banco de dados ser expandida para mostrar as informaes de conexo. Revise as informaes de conexo e altere os valores se necessrio. Voc pode alterar os valores para especificar um nome de usurio e uma senha diferentes no tempo de execuo. possvel tambm se conectar com um banco de dados alternativo, embora os nomes de esquemas devam ser os mesmos nos dois bancos de dados. O formato das propriedades de conexo especfico ao banco de dados. 8. Opcional: Especifique propriedades avanadas clicando em Avanado. Expanda cada uma das sees avanadas para revisar as propriedades. 9. Quando terminar de configurar as propriedades, clique em Concluir.
27
Resultados
O novo projeto includo na perspectiva do Enterprise Explorer. O mdulo criado no projeto e artefatos so gerados. Os artefatos gerados lhe permitem construir um aplicativo corporativo que acessa o EIS. possvel usar as ligaes de dados do J2C Bean e do Java diretamente, no modo no gerenciado ou gerar um JSP ou EJB que use o J2C Bean. O Rational Application Developer fornece ferramentas para automatizar esta gerao. possvel acessar essas ferramentas no menu Novo>Outros, para obter suas descries consulte a documentao do Rational Application Developer.
Gerando o Projeto EJB ou JSP

Depois de criar o projeto Java, use a pgina da Web, o servio da Web ou o EJB do assistente Java J2C para criar o projeto EJB ou JSP.

1. Para iniciar o Assistente Bean J2C, v at o Enterprise Explorer do Rational Application Developer para WebSphere Software e clique em Novo>Outro>J2C> Pgina da Web, Servio da Web ou EJB do J2C Java Bean. 2. Clique em Avanar. 3. Na janela de seleo do J2C Java bean, clique em Navegar. 4. Na janela Localizar o J2C Bean, digite a primeira letra do nome da implementao gerada anteriormente ou digite o nome inteiro e pressione Enter. 5. Selecione o nome da implementao na lista e clique em OK. 6. Clique em Avanar. 7. Na janela Informaes de Implementao, selecione o tipoJava EE Resource Type como EJB ou JSP de amostra e clique em Avanar. Nota: Na janela de Informaes de Implementao, a caixa de opo Configurar a Implementao do Adaptador de Recursos fica disponvel para seleo somente se a caixa de opo Conexo No Gerenciada tiver sido selecionada ao especificar as configuraes de implementao. 8. Se voc selecionar EJB, o assistente EJB Creation ser exibido. O assistente cria o projeto Java como um projeto EJB. v Para selecionar um projeto existente, clique em Navegar. Se o nome do projeto necessrio aparecer na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um projeto. a. Clique em Novo. b. Na janela Projeto EJB, digite um nome de projeto EJB. Por exemplo, MyAdapterOutboundEJB. c. Na rea Associao do EAR, clique em Novo para criar um nome de projeto EAR. d. Na janela Projeto de Aplicativo EAR, digite um nome de projeto EAR. Por exemplo, MyAdapterOutboundEJBEAR. e. Clique em Avanar. f. Na janela Aplicativo Corporativo, selecione a dependncia RAR do adaptador do PeopleSoft tal como CWYES_PeopleSoft. g. Selecione a caixa de opo Gerar Descritor de Implementao.
28
h. Clique em Concluir para retornar janela do Projeto EJB. i. Clique em Concluir para retornar janela do EJB Creation. j. Clique em Avanar. Nota: Na janela Criao de EJB, o boto Prximo estar disponvel para seleo somente se voc tiver selecionado a caixa de opo Configurar a Implementao do Adaptador de Recursos ao especificar as informaes de implementao. Depois de criar o projeto EJB e EAR e retornar janela EJB Creation, voc pode clicar diretamente em Concluir para completar o processo. O adaptador implementado como independente por padro. k. Na janela de Implementao do Adaptador de Recursos, selecione Implementar dentro do EAR e selecione o projeto EAR do EJB que voc criou. l. Clique em Concluir. 9. Se voc selecionar JSP de Amostra, o assistente Criao de JSP Simples exibido. v Para selecionar um projeto existente, clique em Navegar. Se o nome do projeto necessrio aparecer na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um projeto. a. Clique em Novo. b. Na janela Projeto da Web Dinmico, digite o nome do projeto. Por exemplo, MyAdapterOutboundWEB. c. Na rea Associao do EAR, clique em Novo para criar um nome de projeto EAR. d. Na janela Projeto do Aplicativo EAR, digite um nome de projeto EAR. Por exemplo, MyAdapterOutboundWEBEAR. e. Clique em Avanar. f. Na rea de dependncias do Mdulo JavaEE da janela Aplicativo Corporativo, selecione a dependncia RAR do adaptador do PeopleSoft tal como CWYES_PeopleSoft. g. h. i. j. Selecione a caixa de opo Gerar Descritor de Implementao. Clique em Concluir para retornar janela Projeto da Web Dinmico. Clique em Concluir para retornar janela Criao de JSP Simples. Clique em Avanar.
Nota: Na janela Criao de EJB, o boto Prximo estar disponvel para seleo somente se voc tiver selecionado a caixa de opo Configurar a Implementao do Adaptador de Recursos ao especificar as informaes de implementao. Depois de criar o projeto WEB e EAR e retornar janela Criao de JSP Simples, voc pode clicar diretamente em Concluir para completar o processo. O adaptador implementado como independente por padro. k. Na janela de Implementao do Adaptador de Recursos, selecione Implementar dentro do EAR e selecione o projeto EAR da Web que voc criou. l. Clique em Concluir. 10. Exportar o projeto como um arquivo EAR para implementao.
29
Configurando o Mdulo para Processamento de Entrada

Para configurar um mdulo para utilizar o adaptador para processamento de entrada, utilize o Assistente Bean J2C no Rational Application Developer para WebSphere Software para localizar e selecionar objetos de negcios e servios do servidor PeopleSoft Enterprise e para gerar definies de objetos de negcios e artefatos relacionados.
Selecionando Objetos de Negcios e Servios

Para especificar quais objetos voc deseja processar, utilize o Assistente Bean J2C.
Antes de Iniciar
Certifique-se de ter configurado as propriedades de conexo do Assistente Bean J2C.

Para localizar e selecionar um ou mais objetos, utilize o procedimento a seguir. 1. Na janela Descoberta e Seleo de Objeto, clique ou expanda o objeto com o qual deseja trabalhar. 2. Na janela Parmetros de Configurao, especifique as propriedades de configurao do objeto. (Essa janela estar disponvel apenas se voc selecionar a caixa de opo Prompt para Definies de Configurao Adicionais ao Incluir um Objeto de Negcios na janela Configurao de Descoberta). a. Selecione o nome do campo a ser utilizado para desempenhar excluses lgicas. b. No campo Valor utilizado para indicar um objeto excludo, digite o valor de status utilizado para indicar que um objeto no est mais ativo. c. Opcional: Se desejar utilizar teclas alternativas durante operaes RetrieveAll, clique em Incluir e selecione os campos-chave que deseja utilizar. 3. Opcional: Para configurar parmetros adicionais, clique em Avanado. a. Na caixa Preservar objetos na operao de atualizao pai, clique em Incluir e selecione os objetos-filhos aos quais isto se aplica. b. Na caixa Campos que representam chaves geradas no PeopleSoft, clique em Incluir e selecione os campos aos quais isto se aplica. c. Clique na seo Configurao de Data Efetiva e selecione a partir das seguintes opes de data efetiva: v Recuperar apenas o item de data efetiva atual : A ASI correspondente GetCurrentItem. v Inserir na posio de data efetiva mais antiga: A ASI correspondente InsAtOldestEffDtPos. v Inserir na posio de data efetiva atual: A ASI correspondente InsAtCurrentEffDtPos. v Ignorar nmero de seqncia efetiva: A ASI correspondente IgnoreEffectiveSequence. v Campo que representa o valor da data efetiva: A ASI correspondente EffectiveDate. v Campo que representa seqncia da data efetiva: A ASI correspondente EffectiveSequence.
30
Para obter informaes adicionais sobre as opes de data efetiva, consulte Informaes Especficas do Aplicativo na pgina 49 (ASI). 4. Clique em OK. 5. Clique em Avanar.
Resultados
Voc selecionou um ou mais objetos para trabalhar.
O que Fazer Depois

Na janela Configurar Propriedades Compostas, inclua ou remova as operaes associadas.
Configurando os Objetos Selecionados

Para configurar o objeto de negcios, voc especifica informaes sobre o objeto (como a operao associada com o objeto).
Antes de Iniciar
Certifique-se de ter selecionado e importado o objeto.

Para configurar o objeto de negcios, utilize o procedimento a seguir. 1. Na janela Configurar Propriedades Compostas, insira as seguintes informaes. a. Inclua ou remova operaes para o objeto que ser includo na interface de servio. b. Se no desejar especificar um valor de espao de nomes, deixe o valor padro para o campo Espao de Nomes do Objeto de Negcios. c. Digite um local de diretrio para armazenar os objetos de negcios gerados. d. Opcional: Para indicar onde os objetos de negcios gerados devero ser armazenados, digite o caminho relativo para a pasta no campo Pasta. Nota: Se estiver criando vrios artefatos do adaptador dentro de um mdulo, certifique-se de especificar pastas de objetos de negcios diferentes para cada adaptador dentro do mdulo. Por exemplo, se estiver criando artefatos para Oracle, JDBC, SAP e JDE dentro de um mdulo, voc precisar criar pastas relativas diferentes para cada um desses adaptadores. Se voc no especificar pastas relativas diferentes, os artefatos existentes sero sobrescritos quando voc gerar novos artefatos. 2. Clique em Avanar.
Resultados
A janela Criao e Configurao da Implementao do Bean J2C exibida.
O que Fazer Depois

Gere um mdulo que inclua o adaptador e os objetos de negcios.
31
Configurando Propriedades de Implementao e Gerando Artefatos

Aps selecionar e configurar os objetos de negcios para o seu modelo, utilize o Assistente Bean J2C para configurar as propriedades que o adaptador utiliza para conexo a um banco de dados especfico. O assistente cria um novo projeto EJB no qual todos os artefatos e valores de propriedades so salvos.

Esta tarefa executada atravs da Criao do J2C Bean e da janela Configurao de Implementao do assistente J2C Bean. 1. No campo Nome do projeto EJB, selecione ou crie um novo projeto EJB. v Para selecionar um projeto existente, clique em Navegar. Se o nome do projeto desejado aparece na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um novo projeto: a. Clique em Novo. b. Na janela Projeto EJB, digite um nome de projeto. Por exemplo, MyAdapterInboundEJB. c. Na rea de Associao EAR, clique em Novo para criar um novo projeto ear. d. Na janela Projeto do Aplicativo EAR, digite um nome de projeto EAR. Por exemplo, MyAdapterInboundEJBEAR e. Clique em Concluir para retornar janela do Projeto EJB. f. Clique em Concluir. 2. No campo Nome do pacote, selecione ou crie um novo pacote no qual o J2C Bean ser gerado. v Para selecionar um pacote existente, clique em Navegar. Se o nome do pacote desejado aparece na lista Seleo de Projeto, selecione seu nome. v Caso contrrio, crie um novo pacote: a. Clique em Novo. b. Na janela Novo Pacote Java, digite um nome para o pacote. Por exemplo, myadapterinboundejbpkg. c. Clique em Concluir. 3. No campo Nome da interface de negcios locais do EJB de Sesso Stateless, especifique o nome da interface que deseja usar nos seus objetos de negcios. Por exemplo, MyAdapterInboundInterface. O nome da interface leva um sufixo MDB e exibido automaticamente no campo Nome do EJB acionado por mensagens. Por exemplo, MyAdapterInboundInterfaceMDB. Semelhantemente, o nome da interface leva o sufixo SB e exibido automaticamente no campo Nome do EJB de Sesso Stateless. Por exemplo, MyAdapterInboundInterfaceSB. 4. Na rea de configurao de Conexo de Entrada, especifique o nome da JNDI de uma especificao de ativao existente em servidor WAS ou crie o JNDI mais tarde. Por exemplo, com/eis/AdapterAS. 5. Clique em Concluir.
32
Captulo 4. Configurando o aplicativo no WebSphere Application Server

Quando estiver executando o adaptador em uma implementao independente, utilize o console administrativo do servidor para iniciar, parar, monitorar e resolver problemas do mdulo do adaptador. Em um aplicativo que utiliza um adaptador embutido, o mdulo do adaptador inicia ou pra quando o aplicativo iniciado ou parado.
Alterando Propriedades de Configurao para Adaptadores Incorporados

Para alterar as propriedades de configurao depois de implementar o adaptador como parte de um mdulo, utilize o console administrativo do ambiente de tempo de execuo. possvel atualizar as propriedades do adaptador de recursos (utilizadas para operao geral do adaptador), as propriedades do Connection Factory Gerenciado (utilizadas para processamento de sada) e propriedades da especificao de ativao (utilizadas para processamento de entrada).
Configurando Propriedades do Adaptador de Recursos para Adaptadores Incorporados

Para configurar propriedades do adaptador de recursos para seu adaptador aps sua implementao como parte de um mdulo, utilize o console administrativo. Selecione o nome da propriedade que deseja configurar e, em seguida, altere ou configure o valor.
Antes de Iniciar
Seu mdulo do adaptador deve ser implementado no WebSphere Application Server.

Propriedades customizadas so propriedades de configurao padro compartilhadas por todos os WebSphere Adapters. Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo. 3. Efetue logon no console administrativo. 4. Selecione Aplicativos Tipos de Aplicativo Aplicativos Corporativos WebSphere. 5. Na lista Aplicativos Corporativos, clique no nome do mdulo do adaptador cujas propriedades deseja alterar. A pgina Configurao exibida. 6. Em Mdulos, clique em Gerenciar Mdulos. 7. Clique em IBM WebSphere Adapter para PeopleSoft Enterprise.
33
8. Na lista Propriedades Adicionais, clique em Adaptador de Recursos. 9. Na pgina seguinte, na lista Propriedades Adicionais, clique em Propriedades Customizadas. 10. Para cada propriedade que voc deseja alterar, desempenhe as seguintes etapas. Nota: Consulte Propriedades do Adaptador de Recursos na pgina 60 para obter informaes adicionais sobre estas propriedades. a. Clique no nome da propriedade. A pgina Configurao para a propriedade selecionada exibida. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. 11. Na rea Mensagens, clique em Salvar.
Resultados
As propriedades do adaptador de recursos associadas a seu mdulo do adaptador so alteradas.
Configurando propriedades do Connection Factory (J2C) gerenciado para adaptadores incorporados

Para configurar propriedades do managed connection factory para seu adaptador depois de implement-lo como parte de um mdulo, utilize o console administrativo. Selecione o nome da propriedade que deseja configurar e, em seguida, altere ou configure o valor.
Antes de Iniciar

Voc utiliza as propriedades do connection factory gerenciado para configurar a instncia do servidor PeopleSoft Enterprise de destino. Nota: No console administrativo, as propriedades so referidas como propriedades do connection factory J2C. Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo. 3. Efetue logon no console administrativo. 4. Selecione Aplicativos Tipos de Aplicativo Aplicativos Corporativos WebSphere. 5. Na lista Aplicativos Corporativos, clique no nome do mdulo do adaptador cujas propriedades deseja alterar.
34
Em Mdulos, clique em Gerenciar Mdulos. Clique em IBM WebSphere Adapter para PeopleSoft Enterprise. Na lista Propriedades Adicionais, clique em Adaptador de Recursos. Na pgina seguinte, na lista Propriedades Adicionais, clique em Connection Factories J2C. 10. Clique no nome do connection factory associado a seu mdulo do adaptador. 11. Na lista Propriedades Adicionais, clique em Propriedades Customizadas. Propriedades customizadas so aquelas propriedades do connection factory J2C que so exclusivas do Adapter para PeopleSoft Enterprise. As propriedades do conjunto de conexes e do connection factory avanadas so propriedades que voc configura se estiver desenvolvendo seu prprio adaptador. 12. Para cada propriedade que voc deseja alterar, desempenhe as seguintes etapas. 6. 7. 8. 9. Nota: Consulte Propriedades Managed Connection Factory na pgina 65 para obter informaes adicionais sobre estas propriedades. a. Clique no nome da propriedade. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. 13. Na rea Mensagens, clique em Salvar.
Resultados
As propriedades do managed connection factory associadas a seu mdulo do adaptador so alteradas.
Configurando Propriedades de Especificao de Ativao para Adaptadores Incorporados

Para configurar propriedades de especificao de ativao para seu adaptador depois de implement-lo como parte de um mdulo, utilize o console administrativo. Voc seleciona o nome da propriedade do terminal de mensagens que deseja configurar e, em seguida, altera ou configura o valor.
Antes de Iniciar

Utilize as propriedades de especificao de ativao para configurar o terminal para processamento de entrada. Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo.
35
3. Efetue logon no console administrativo. 4. Selecione Aplicativos Tipos de Aplicativo Aplicativos Corporativos WebSphere. 5. Na lista Aplicativos Corporativos, clique no nome do mdulo do adaptador cujas propriedades deseja alterar. 6. Em Mdulos, clique em Gerenciar Mdulos. 7. Clique em IBM WebSphere Adapter para PeopleSoft Enterprise. 8. Na lista Propriedades Adicionais, clique em Adaptador de Recursos. 9. Na pgina seguinte, na lista Propriedades Adicionais, clique em Especificaes de Ativao J2C. 10. Clique no nome da especificao de ativao associada ao mdulo do adaptador. 11. Na lista Propriedades Adicionais, clique em Propriedades Customizadas de Especificao de Ativao J2C. 12. Para cada propriedade que voc deseja alterar, desempenhe as seguintes etapas. Nota: Consulte Propriedades de Especificao de Ativao na pgina 82 para obter informaes adicionais sobre estas propriedades. a. Clique no nome da propriedade. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. 13. Na rea Mensagens, clique em Salvar.
Resultados
As propriedades de especificao de ativao associadas a seu mdulo do adaptador so alteradas.
Alterando Propriedades de Configurao para Adaptadores Independentes

Para configurar propriedades de configurao depois de instalar um adaptador independente, utilize o console administrativo do ambiente de tempo de execuo. Voc fornece informaes gerais sobre o adaptador e, em seguida, configura as propriedades do adaptador de recursos (que so utilizadas para operao geral do adaptador). Se o adaptador for usado para operaes de sada, voc criar um connection factory e configurar propriedades para ele. Se o adaptador for usado para operaes de entrada, voc criar uma especificao de ativao e configurar propriedades para ela.
Configurando Propriedades do Adaptador de Recursos para Adaptadores Independentes

Para configurar as propriedades do adaptador de recursos para seu adaptador independente depois de ser instalado no WebSphere Application Server, utilize o console administrativo. Selecione o nome da propriedade que deseja configurar e, em seguida, altere ou configure o valor.
36
Antes de Iniciar
Seu adaptador deve ser instalado no WebSphere Application Server.

Propriedades customizadas so propriedades de configurao padro compartilhadas por todos os WebSphere Adapters. Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo. 3. Efetue logon no console administrativo. 4. Clique em Recursos Adaptadores de Recursos Adaptadores de Recursos. 5. Na pgina Adaptadores de Recursos, clique em IBM WebSphere Adapter para PeopleSoft Enterprise. 6. Na lista Propriedades Adicionais, clique em Propriedades Customizadas. 7. Para cada propriedade que voc deseja alterar, desempenhe as seguintes etapas. a. Clique no nome da propriedade. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. 8. Na rea Mensagens, clique em Salvar.
Resultados
As propriedades do adaptador de recursos associadas a seu adaptador so alteradas.
Configurando Propriedades do Connection Factory (J2C) Gerenciado para Adaptadores Independentes

Para configurar as propriedades gerenciadas do connection factory para seu adaptador independente depois de ser instalado no WebSphere Application Server, utilize o console administrativo. Selecione o nome da propriedade que deseja configurar e, em seguida, altere ou configure o valor.
Antes de Iniciar

Voc utiliza as propriedades do connection factory gerenciado para configurar a instncia do servidor PeopleSoft Enterprise de destino. Nota: No console administrativo, as propriedades so referidas como propriedades do connection factory J2C.
37
Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo. 3. Efetue logon no console administrativo. 4. Clique em Recursos Adaptadores de Recursos Adaptadores de Recursos. 5. Na pgina Adaptadores de Recursos, clique em IBM WebSphere Adapter para PeopleSoft Enterprise. 6. Na lista Propriedades Adicionais, clique em Connection Factories do J2C. 7. Se voc for utilizar um connection factory existente, prossiga at Selecionar na lista de connection factories existentes. Nota: Se voc selecionou Utilizar Propriedades da Conexo Predefinidas quando utilizou o Assistente Bean J2C para configurar o mdulo do adaptador, no precisar criar um connection factory. Se estiver criando um connection factory, desempenhe as seguintes etapas: a. Clique em Novo. b. Na seo Propriedades Gerais da guia Configurao, digite um nome para o connection factory. Por exemplo, voc pode digitar AdapterCF. c. Digite um valor para Nome JNDI. Por exemplo, voc pode digitar com/eis/AdapterCF. d. Opcional: Selecione um alias de autenticao da lista Alias de Autenticao Gerenciado por Componente. e. Clique em OK. f. Na rea Mensagens, clique em Salvar. O connection factory recm-criado exibido. 8. Na lista de connection factories, clique no que deseja utilizar. 9. Na lista Propriedades Adicionais, clique em Propriedades Customizadas. Propriedades customizadas so aquelas propriedades do connection factory J2C que so exclusivas do Adapter para PeopleSoft Enterprise. As propriedades do conjunto de conexes e do connection factory avanadas so propriedades que voc configura se estiver desenvolvendo seu prprio adaptador. 10. Para cada propriedade que voc deseja alterar, desempenhe as seguintes etapas. Nota: Consulte Propriedades Managed Connection Factory na pgina 65 para obter informaes adicionais sobre estas propriedades. a. Clique no nome da propriedade. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. 11. Quando concluir a configurao das propriedades, clique em Aplicar. 12. Na rea Mensagens, clique em Salvar.
38
Resultados
As propriedades do connection factory gerenciado associadas a seu adaptador so configuradas.
Configurando Propriedades do Adaptador de Recursos para Adaptadores Independentes

Para configurar as propriedades de especificao de ativao para seu adaptador independente depois de ser instalado no WebSphere Application Server, utilize o console administrativo. Voc seleciona o nome da propriedade do terminal de mensagens que deseja configurar e, em seguida, altera ou configura o valor.
Antes de Iniciar

Utilize as propriedades de especificao de ativao para configurar o terminal para processamento de entrada. Para configurar as propriedades utilizando o console administrativo, utilize o procedimento a seguir. 1. Se o servidor no estiver em execuo, clique com o boto direito do mouse no servidor na visualizao Servidores e selecione Iniciar. 2. Quando o status do servidor mudar para Iniciado, clique com o boto direito do mouse no servidor e selecione Administrao Executar Console Administrativo. 3. Efetue logon no console administrativo. 4. Clique em Recursos Adaptadores de Recursos Adaptadores de Recursos. 5. Na pgina Adaptadores de Recursos, clique em IBM WebSphere Adapter para PeopleSoft Enterprise. 6. Na lista Propriedades Adicionais, clique em Especificaes de Ativao J2C. 7. Se voc for utilizar uma especificao de ativao existente, prossiga at Selecionar em uma lista existente de especificaes de ativao. Nota: Se voc selecionou Utilizar propriedades da conexo predefinidas quando utilizou o Assistente Bean J2C para configurar o mdulo do adaptador, no precisar criar uma especificao de ativao. Se estiver criando uma especificao de ativao, desempenhe as seguintes etapas: a. Clique em Novo. b. Na seo Propriedades Gerais da guia Configurao, digite um nome para a especificao de ativao. Por exemplo, voc pode digitar AdapterAS. c. Digite um valor para Nome JNDI. Por exemplo, voc pode digitar com/eis/AdapterAS. d. Opcional: Selecione um alias de autenticao da lista Alias de Autenticao. e. Selecione um tipo de listener de mensagens. f. Clique em OK.
39
8. 9. 10.
11.
g. Clique em Salvar na caixa Mensagens na parte superior da pgina. A especificao de ativao recm-criada exibida. Na lista de especificaes de ativao, clique naquele que deseja utilizar. Na lista Propriedades Adicionais, clique em Propriedades Customizadas de Especificao de Ativao J2C. Para cada propriedade que deseja configurar, desempenhe as seguintes etapas. a. Clique no nome da propriedade. b. Altere o contedo do campo Valor ou digite um valor, se o campo estiver vazio. c. Clique em OK. Quando concluir a configurao das propriedades, clique em Aplicar.
12. Na rea Mensagens, clique em Salvar.
Resultados
As propriedades de especificao de ativao associadas a seu adaptador so configuradas.
Incluindo bibliotecas de dependncias ao adaptador de recursos implementado

O adaptador de recursos implementado em execuo no WebSphere Application Server requer as mesmas bibliotecas de dependncias que requer no Rational Application Developer para WebSphere Software para processar pedidos. O mtodo para incluir esses arquivos de bibliotecas depende do modo de implementao do adaptador de recursos: independente ou integrado no arquivo EAR.
Implementao Independente
As bibliotecas de dependncias podem ser includas ao adaptador de recursos implementado independentemente durante a implementao inicial do arquivo RAR ou atravs da configurao das propriedades do Adaptador de Recursos depois da implementao. Para configurar os valores durante a implementao inicial do arquivo RAR, especifique os locais dos caminhos da classe e dos caminhos nativos. O caminho da classe usado para apontar os arquivos JAR e o caminho Nativo usado para apontar as bibliotecas nativas como *.dll, *.so. Para configurar os arquivos do caminho da biblioteca de dependncias depois que o adaptador foi instalado no WebSphere Application Server, use o console administrativo para modificar os valores do Adaptador de Recursos.
Implementao de EAR
Para o raro caso em que o conector necessita estar integrado no arquivo EAR, as bibliotecas dependentes so includas como bibliotecas compartilhadas. Defina a biblioteca compartilhada apropriada que contm as dependncias externas e associe-as com o arquivo EAR.

H dois mtodos para executar essa tarefa: v Usando o editor de EAR otimizado no Rational Application Developer para WebSphere Software v Usando o console administrativo do WebSphere Application Server
40
Usando o Editor EAR Melhorado

possvel usar o editor de EAR em Rational Application Developer para WebSphere Software para incluir as bibliotecas de dependncias.

Para criar as bibliotecas compartilhadas usando o editor de EAR, use o procedimento a seguir. 1. Abra o editor de EAR otimizado. 2. Clique na guia Implementao. 3. Expanda a seo Biblioteca Compartilhada. 4. Clique em Incluir para incluir nova biblioteca compartilhada. 5. Especifique os parmetros da biblioteca compartilhada e clique em OK. 6. Implemente o EAR no servidor.
Resultados
As bibliotecas dependentes so includas como bibliotecas compartilhadas.
Usando o Console Administrativo do WebSphere Application Server

Utilize o console administrativo do WebSphere Application Server para incluir as bibliotecas de dependncias.
Antes de Iniciar
Certifique-se de que os arquivos dependentes esto disponveis na mquina servidor na pasta separada. Se necessrio, copie arquivos dependentes na mquina servidor. 1. Defina as variveis do WebSphere para que apontem s pastas apropriadas. 2. Defina a biblioteca compartilhada atravs do console administrativo do servidor; possvel especific-las usando as variveis do WebSphere definidas na etapa 1 acima. 3. Implemente o EAR no servidor. 4. Configure o EAR para referenciar bibliotecas compartilhadas definidas.
Resultados
As bibliotecas dependentes so includas como bibliotecas compartilhadas.
41
42
Captulo 5. Resoluo de Problemas e Suporte

As tcnicas comuns de resoluo de problemas e informaes de auto-atendimento ajudam a identificar e resolver problemas rapidamente.
Configurando a Criao de Log e Rastreio

Configure a criao de log e rastreio para atender aos seus requisitos. Ative a criao de log para o adaptador para controlar o status do processamento de eventos. Altere os nomes do arquivo de log e de rastreio do adaptador para separ-los de outros arquivos de log e de rastreio.
Configurando Propriedades de Criao de Log

Utilize o console administrativo para ativar a criao de log e para configurar propriedades de sada para um log, incluindo o local, nvel de detalhe e formato de sada do log.

Antes dos adaptadores registrarem eventos monitorados, voc deve especificar os pontos de eventos do componente de servio que deseja monitorar, o nvel de detalhe necessrio para cada evento e o formato da sada utilizado para estabelecer os eventos nos logs. Utilize o console administrativo para desempenhar as seguintes tarefas: v Ativar ou desativar um log de eventos especfico v Especificar o nvel de detalhe em um log v Especificar onde os arquivos de log esto armazenados e quantos arquivos de log so mantidos v Especificar o formato da sada do log Se voc configurar a sada para o formato do analisador de log, pode abrir a sada de rastreio utilizando a ferramenta Analisador de Log, que um aplicativo includo em seu servidor de aplicativos. Isto til se voc estiver tentando correlacionar rastreios de dois diferentes servidores de processo, porque permite utilizar o recurso de mesclagem do Log Analyzer. Para obter informaes adicionais sobre como monitorar em um servidor de aplicativos, incluindo componentes de servio e pontos de eventos, consulte a documentao de seu servidor de aplicativos. Voc pode alterar a configurao do log de maneira esttica ou dinmica. A configurao esttica entra em vigor quando voc inicia ou reinicia o servidor de aplicativos. Dinmicas ou de tempo de execuo, as mudanas na configurao so aplicadas imediatamente. Quando um log criado, o nvel de detalhe desse log configurado a partir dos dados de configurao. Se nenhum dos dados de configurao estiver disponvel para um nome de log especfico, o nvel desse log ser obtido do pai do log. Se nenhum dado de configurao existir para o log pai, o pai do log estar selecionado e assim por diante, rvore acima, at que um log com um valor de nvel diferente de zero seja encontrado. Quando voc alterar o nvel de um log, a
43
alterao ser propagada para os filhos do log que, recursivamente, propagam a alterao para seus filhos, conforme necessrio. Para ativar a criao de log e configurar as propriedades de sada para um log, utilize o seguinte procedimento. 1. Na rea de janela de navegao do console administrativo, clique em Servidores WebSphere application servers. 2. Clique no nome do servidor com o qual deseja trabalhar. 3. Sob Resoluo de problemas, clique em Criando logs e rastreando. 4. Clique em Alterar Nveis de Detalhe do Log. 5. Especifique quando deseja que a alterao entre em vigor: v Para uma alterao esttica na configurao, clique na guia Configurao. v Para uma alterao dinmica na configurao, clique na guia Tempo de Execuo. 6. Clique nos nomes dos pacotes cujo nvel de criao de log deseja modificar. Os nomes de pacotes para WebSphere Adapters comeam com com.ibm.j2ca.*: v Para o componente de base do adaptador, selecione com.ibm.j2ca.base.*. v Para o componente de base do adaptador e todos os adaptadores implementados, selecione com.ibm.j2ca.*. v Apenas para o Adapter para PeopleSoft Enterprise, selecione o pacote com.ibm.j2ca.peoplesoft.*. 7. Selecione o nvel de criao de log.
Nvel de Criao de Log Fatal provvel que ocorra Descrio A tarefa no pode continuar ou o componente no pode funcionar. A tarefa no pode continuar, mas o componente ainda pode funcionar. O nvel de criao de log tambm inclui condies que indicam um erro fatal iminente, ou seja, as situaes que sugerem intensamente que os recursos esto prestes a serem esgotados. Ocorreu um erro potencial ou um erro grave iminente. Este nvel de criao de log tambm inclui condies que indicam uma falha progressiva, por exemplo, a possvel fuga de recursos. Ocorreu um evento significativo que afeta o estado ou recursos do servidor. A tarefa est em execuo. Este nvel de criao de log inclui informaes gerais que descrevem o progresso geral de uma tarefa. O status de uma configurao relatado ou ocorreu uma alterao na configurao. A subtarefa est em execuo. Este nvel de criao de log inclui informaes gerais que detalham o progresso de uma subtarefa.
Aviso
Auditoria Informaes
Configurao Detalhe
8. Clique em Aplicar. 9. Clique em OK. 10. Para que alteraes na configurao esttica entrem em vigor, pare e, em seguida, reinicie o servidor de aplicativos.
44
Resultados
Entradas de log desse ponto em diante contm o nvel especificado de informaes para os componentes adaptadores selecionados.
Alterando os Nomes do Arquivo de Log e Rastreio

Para manter as informaes de log e de rastreio do adaptador separadas de outros processos, utilize o console administrativo para alterar os nomes de arquivos. Por padro, as informaes de log e rastreio para todos os processos e aplicativos em um servidor de aplicativos so gravadas nos arquivos SystemOut.log e trace.log.
Antes de Iniciar
Voc pode alterar os nomes de arquivos de log e de rastreio a qualquer momento, aps a implementao do mdulo do adaptador em um servidor de aplicativos.

Voc pode alterar os nomes de arquivos de log e rastreio estaticamente ou dinamicamente. As alteraes estticas entram em vigor quando voc inicia ou reinicia o servidor de aplicativos. Alteraes dinmicas ou de tempo de execuo aplicam-se imediatamente. Os arquivos de log e de rastreio esto na pasta install_root/profiles/ profile_name/logs/server_name. Para configurar ou alterar os nomes de arquivos de log e de rastreio, utilize o procedimento a seguir. 1. Na rea de janela de navegao do console administrativo, selecione Aplicativos > Tipos de Aplicativos > Servidores de Aplicativos do WebSphere. 2. Na lista Aplicativos Corporativos, clique no nome do aplicativo do adaptador. Esse o nome do arquivo EAR para o adaptador, mas sem a extenso de arquivo ear. Por exemplo, se o arquivo EAR for denominado Accounting_OutboundApp.ear, clique em Accounting_OutboundApp. 3. Na guia Configurao, na lista Mdulos, clique em Gerenciar Mdulos. 4. Na lista de mdulos, clique em IBM WebSphere Adapter para PeopleSoft Enterprise. 5. Na guia Configurao, em Propriedades Adicionais, clique em Adaptador de Recursos. 6. Na guia Configurao, em Propriedades Adicionais, clique em Propriedades Customizadas. 7. Na tabela Propriedades Customizadas, altere os nomes de arquivos. a. Clique em logFilename para alterar o nome do arquivo de log ou em traceFilename para alterar o nome do arquivo de rastreio. b. Na guia Configurao, digite o novo nome no campo Valor. Por padro, o arquivo de log chamado de SystemOut.log e o arquivo de rastreio chamado de trace.log. c. Clique em Aplicar ou em OK. Suas alteraes so salvas em sua mquina local. d. Para salvar suas alteraes na configurao master no servidor, utilize um dos seguintes procedimentos:
45
v Alterao esttica: Pare e reinicie o servidor. Esse mtodo permite fazer alteraes, mas essas alteraes no entram em vigor at voc parar e iniciar o servidor. v Alterao dinmica: Clique no link Salvar na caixa Mensagens acima da tabela Propriedades Customizadas. Clique em Salvar novamente quando for solicitado.
Suporte a First-Failure Data Capture (FFDC)

O adaptador suporta o First-Failure Data Capture (FFDC), que fornece registros persistentes de falhas e incidentes de software significativos que ocorrem durante o tempo de execuo no WebSphere Application Server. O recurso FFDC executado em segundo plano e coleta eventos e erros que ocorrem no tempo de execuo. O recurso fornece um meio de associar umas falhas a outras, permitindo que o software vincule os efeitos de uma falha s suas causas e, portanto, facilita a rpida localizao da causa raiz de uma falha. Os dados capturados podem ser utilizados para identificar o processamento de excees ocorrido durante o tempo de execuo do adaptador. Quando ocorre um problema, o adaptador grava mensagens de exceo e dados de contexto em um arquivo de log, que est localizado no diretrio install_root/profiles/profile/logs/ffdc. Para obter mais informaes sobre o FFDC, consulte a documentao do WebSphere Application Server.
Suporte para Cdigos dos Idiomas No-Ingls Durante o Processamento de Entrada

O WebSphere Adapter para PeopleSoft Enterprise no pode processar uma operao de entrada quando o cdigo do idioma do sistema no-ingls (como chins e hebraico). Problema: Embora o cdigo do idioma do sistema das estaes de trabalho nas quais o servidor PeopleSoft e o Adapter para PeopleSoft executam no seja o ingls (como chins e hebraico), o valor retornado est no formato do cdigo do idioma ingls, em vez do formato do cdigo do idioma correspondente. Isto impede que o adaptador analise o registro de data e hora do evento. Sintoma: O adaptador falha ao tentar analisar o registro de data e hora do evento durante uma operao de entrada. Uma mensagem de exceo semelhante seguinte pode ser localizada nos arquivos de log ffdc.
Stack Dump = java.text.ParseException: Unparseable date: "08/31/2007 10:58AM PDT" em com.ibm.icu.text.DateFormat.parse(DateFormat.java:488) em com.ibm.j2ca.peoplesoft.PeopleSoftEvent.(PeopleSoftEvent.java:80) em com.ibm.j2ca.peoplesoft.PeopleSoftEventStoreWithXid.getEvents (PeopleSoftEventStoreWithXid.java:370) em com.ibm.j2ca.extension.eventmanagement.internal.EventManager.getEvents (EventManager.java:348) em com.ibm.j2ca.extension.eventmanagement. internal.EventManager.pollForEvents(EventManager.java:261) em com.ibm.j2ca.base.internal.PollEventManagerWorker.run
46
(PollEventManagerWorker.java:100) em com.ibm.ejs.j2c.work.WorkProxy. run(WorkProxy.java:418) em com.ibm.ejs.j2c.work.AsyncWorkProxy.run (AsyncWorkProxy.java:136) em com.ibm.ws.asynchbeans.J2EEContext.run (J2EEContext.java:759) em com.ibm.ws.asynchbeans.ExecutionContextImpl.go (ExecutionContextImpl.java:85) em com.ibm.ejs.j2c.work.AsyncWorkProxy.run (AsyncWorkProxy.java:90) em com.ibm.ws.util.ThreadPool$Worker.run (ThreadPool.java:1469)
Soluo: Para superar essa exceo, altere a propriedade DateFormat no ActivationSpec para MM/dd/aaaa HH:mm.
Suporte para Configurar Valores com o PeopleTools 8.22

O WebSphere Adapter para PeopleSoft Enterprise no configura alguns valores com o PeopleTools 8.22. Problema O WebSphere Adapter para PeopleSoft Enterprise falha ao tentar configurar valores para as propriedades EditHistoryItems e GetDummyRows. Sintoma O adaptador falha ao tentar configurar valores para as propriedades EditHistoryItems e GetDummyRows. Uma mensagem de exceo semelhante seguinte pode ser exibida no arquivo de rastreio:
Provocada por: com.ibm.j2ca.peoplesoft.exceptions.EISOperationFailedException: Ocorreu um erro ao configurar as propriedades do sistema no objeto EIS. em com.ibm.j2ca.peoplesoft.PeopleSoftUtility.setSystemPropertiesOnEisObject (PeopleSoftUtility.java:672) em com.ibm.j2ca.peoplesoft.commands.PeopleSoftRetrieveCommand.doRetrieve (PeopleSoftRetrieveCommand.java:96) ... 56 mais Provocada por: com.ibm.j2ca.peoplesoft.exceptions.EISOperationFailedException: A chamada para o mtodo falhou e o valor no pde ser configurado. em com.ibm.j2ca.peoplesoft.PeopleSoftUtility.set(PeopleSoftUtility.java:99) emcom.ibm.j2ca.peoplesoft.PeopleSoftUtility.setSystemPropertiesOnEisObject (PeopleSoftUtility.java:662) ... 57 mais Provocada por: java.lang.NoSuchMethodException: PeopleSoft.Generated.CompIntfc.WbiUserCompCi.setEditHistoryItems(boolean) em java.lang.Class.throwNoSuchMethodException(Class.java:274) em java.lang.Class.getMethod(Class.java:799) em com.ibm.j2ca.peoplesoft.PeopleSoftUtility.set(PeopleSoftUtility.java:74)
Causa O PeopleTools 8.22 no suporta as propriedades EditHistoryItems e GetDummyRows. Soluo Para superar essa exceo, no use o PeopleTools 8.22 para as propriedades EditHistoryItems ou GetDummyRows.
47
Recursos de Auto-atendimento
Utilize os recursos do suporte ao software IBM para obter as informaes mais recentes sobre suporte, obter a documentao tcnica, fazer download de ferramentas de suporte e de correes e evitar problemas com o WebSphere Adapters. Os recursos de auto-atendimento tambm ajudam a diagnosticar problemas com o adaptador e fornecem informaes sobre como entrar em contato com o suporte ao software IBM.
Web Site de Suporte

O Web site de suporte do software WebSphere Adapters no endereo http://www.ibm.com/software/integration/wbiadapters/support/ fornece links de vrios recursos para inform-lo sobre uso e resoluo de problemas do WebSphere Adapters, incluindo: v Flashes (alertas sobre o produto) v Informaes tcnicas, incluindo o centro de informaes do produto, manuais, IBM Redbooks e whitepapers v Ofertas educativas v Notas tcnicas
Correes Recomendadas
Uma lista de correes recomendadas que so necessrias est disponvel no seguinte local: http://www.ibm.com/support/docview.wss?fdoc=aimadp&rs=695 &uid=swg27010397
Notas tcnicas
Notas Tcnicas fornecem a documentao mais recente do Adapter para PeopleSoft Enterprise, incluindo os seguintes tpicos: v Problemas e suas solues atualmente disponveis v Respostas para as perguntas mais freqentes v Como obter informaes sobre instalao, configurao, uso e resoluo de problemas do adaptador v IBM Software Support Handbook Para obter uma lista de notas tcnicas para o WebSphere Adapters, visite este endereo: http://www.ibm.com/support/search.wss?tc=SSMKUK&rs=695&rank=8 &dc=DB520+D800+D900+DA900+DA800+DB560&dtm
Plug-in para o IBM Support Assistant

O Adapter para PeopleSoft Enterprise fornece um plug-in para o IBM Support Assistant, que um ambiente de trabalho de capacidade de manuteno de software livre, local. O plug-in suporta o recurso de rastreio dinmico. Para obter informaes sobre como instalar ou utilizar o IBM Support Assistant, visite este endereo: http://www.ibm.com/software/support/isa/
48
Captulo 6. Informaes de Referncia

Para lhe oferecer suporte em suas tarefas, as informaes de referncia incluem detalhes sobre objetos de negcios que so gerados pelo Assistente Bean J2C e informaes sobre propriedades do adaptador, incluindo aquelas que suportam transformao para bidi. Elas tambm incluem ponteiros para mensagens do adaptador e informaes relacionadas ao produto.
Informaes sobre o Objeto de Negcios

Um objeto de negcios uma estrutura que contm informaes especficas do aplicativo sobre como o adaptador deve processar o objeto de negcios, bem como a operao a ser desempenhada no objeto de negcios. O nome do objeto de negcios gerado pelo Assistente Bean J2C de acordo com a conveno de nomenclatura para o adaptador.
Informaes Especficas do Aplicativo

ASI (informaes especficas do aplicativo) so os metadados que especificam como processar objetos de negcios para o adaptador para PeopleSoft Enterprise. Quando o Assistente Bean J2C gera um objeto de negcios, ele gera automaticamente uma definio de objeto de negcios, que salva como um arquivo XSD (XML Schema Definition). A definio de objeto de negcios contm as informaes especficas do aplicativo para esse objeto de negcios. O adaptador para PeopleSoft Enterprise utiliza as ASI para criar consultas para operaes Create, Retrieve, Update e Delete.
Metadados no Nvel de Objetos de Negcios

Os metadados no nvel de objetos de negcios definem o wrapper de nvel superior do objeto de negcios. A tabela a seguir descreve os elementos dos metadados de objetos de negcios.
Tabela 3. Metadados para Objetos de Negcios Elemento de Metadados ObjectName Descrio O objeto correspondente no aplicativo PeopleSoft; em outras palavras, o nome da interface do componente conforme definido no PeopleTools. Configure-o apenas para o objeto de negcios de nvel superior. Quando configurado como true, apenas itens com data efetiva so recuperados durante uma operao. Quando configurado como true, o nmero de sequncia efetivo ignorado e o registro inserido no ndice mnimo, que possui a data efetiva atual ou no ndice mais alto, que possui a data efetiva mais antiga. Se voc configurar este parmetro, tambm dever configurar InsAtCurrentEffDtPos ou InsAtOldestEffDtPos. Este parmetro utilizado apenas para itens com data efetiva. Quando configurado como true e um ndice incorreto (nmero negativo) retornado pela API do PeopleTools, getEffectiveItemNum(), o adaptador insere a linha no ndice mais alto, o qual possui a data efetiva mais antiga. Se voc configurar esse parmetro, no configure InsAtCurrentEffDtPos.
GetCurrentItem IgnoreEffectiveSequence
InsAtOldestEffDtPos
49
Tabela 3. Metadados para Objetos de Negcios (continuao) Elemento de Metadados InsAtCurrentEffDtPos Descrio Quando configurado como true e um ndice incorreto (nmero negativo) for retornado pela API do PeopleTools, getEffectiveItemNum(), o adaptador insere a linha no ndice inferior (zero), que tem a data efetiva atual. Se voc configurar esse parmetro, no configure InsAtOldestEffDtPos. Uma propriedade utilizada para desempenhar excluses. Configure-o apenas para o objeto de negcios de nvel superior. Identifica um objeto de negcios que est inativo ou foi excludo. Configure-o apenas para o objeto de negcios de nvel superior.
StatusColumnName StatusValue
Metadados no Nvel de Propriedades

O metadado no nvel de propriedades define a propriedade de um objeto de negcios. A propriedade pode ser um tipo de cadeia simples ou pode ser um tipo de propriedade complexa que representa objetos-filhos ou uma matriz de objetos-filhos. A tabela a seguir descreve os elementos de metadados de uma propriedade complexa (um filho) ou uma estrutura ou propriedade de tabela (uma matriz de objetos-filhos).
Tabela 4. Metadados para Propriedade Elemento de Metadados PrimaryKey FindKey EffectiveDate EffectiveSequence KeepRelations Descrio Atributo GetKey/CreateKey na interface do componente ou uma chave na coleta filha. Atributo FindKey na interface do componente. Atributo EffectiveDate na interface do componente. Atributo EffectiveSequence na interface do componente. Afeta o processamento de objetos-filho quando o adaptador desempenha uma operao de atualizao. Se este parmetro estiver ativado e o adaptador localizar um objeto-filho ausente de um pai durante a operao, o objeto-filho no ser excludo e o relacionamento entre os objetos preservado. Determina se o adaptador configurar valores para atributos-chave dentro do objeto de negcios ou no. Quando configurado como true, o adaptador no configura valores para estas chaves, mas permite que o PeopleCode gere automaticamente os valores para as chaves. O nome do mtodo get utilizado para ler valores para a propriedade. O nome do mtodo set utilizado para configurar valores para a propriedade.
UID
Getter Setter
Operaes Suportadas
Uma operao a ao que um adaptador pode executar no servidor PeopleSoft Enterprise durante o processamento de sada. O nome da operao normalmente indica o tipo de ao que o adaptador executa, como criar ou atualizar. A tabela a seguir define as operaes que o adaptador suporta.
50
Tabela 5. Operaes Suportadas de Objetos de Negcios Operao Create Definio O adaptador acessa o componente do PeopleSoft e recupera valores dos atributos que tm informaes especficas do aplicativo da chave primria configuradas. Ele ento instancia a interface do componente correspondente (utilizando o valor fornecido nas informaes especficas do aplicativo ObjectName). Ele define os valores de atributo na operao Criar Chaves correspondente, na interface do componente. criada uma Interface de Componente vazia, e o adaptador mapeia todos os dados de objeto de negcios para a interface de componente criada. Ao mapear os dados, o adaptador envia todos os dados de atributos simples na hierarquia e cria itens que correspondem a cada objeto-filho na hierarquia tambm, incluindo registros filhos de seqncia e data efetivas. O adaptador acessa o componente do PeopleSoft e recupera valores dos atributos que tm informaes especficas do aplicativo da chave primria configuradas. Ele ento instancia a interface do componente correspondente utilizando o valor fornecido nas informaes especficas do aplicativo ObjectName. Ele define os valores de atributo na operao Obter Chaves correspondente, na interface do componente. O adaptador ento mapeia os dados do componente na hierarquia de objetos de negcios. Objetos-filhos so includos no mapeamento de dados. Isto funciona como a operao Retrieve, exceto que ele permite a recuperao de vrias instncias do mesmo componente PeopleSoft. O adaptador recupera um objeto do PeopleSoft e o compara com o objeto de negcios de destino. Ele processa os objetos da seguinte forma: Quando a comparao revela objetos-filhos extra no PeopleSoft, os filhos so excludos. Quando a comparao revela filhos ausentes no PeopleSoft, os filhos so criados. Quando a comparao revela objetos-filhos que foram atualizados no PeopleSoft, eles so atualizados. O adaptador processa uma operao exist da mesma forma que processa uma operao retrieve, exceto que no preenche o objeto de negcios com os dados recuperados. Ele apenas verifica a existncia de um objeto no PeopleSoft. Com base nos valores configurados para os elementos de metadados especficos do aplicativo, StatusColumnName e StatusValue, o adaptador atualiza um objeto de negcios como inativo. Uma operao de excluso pode ser desempenhada apenas em um objeto de nvel superior. O PeopleSoft no permite que um objeto seja excludo fisicamente, portanto, o objeto inativo permanece no banco de dados do PeopleSoft.
Retrieve
RetrieveAll Update
Exists
Delete
PeopleCode para um projeto de eventos customizado

Duas funes do PeopleCode so necessrias para suportar o processamento de entrada. Se voc criar um projeto de eventos customizado no PeopleTools para o suporte de entrada, inclua as funes do PeopleCode no projeto. O seguinte PeopleCode contm as funes IBMPublishEvent e IBMPublishFutureDatedEvent que so utilizadas para publicar eventos na tabela de eventos. As chamadas para essas funes so feitas a partir da funo SavePostChange PeopleCode no componente do PeopleSoft do seu interesse.
/* Notificao de evento da IBM */ Component string &KEYSTRING; Component string &KEYNAME; Component array of string &KEYARRAY; Component string &KEYDELIM; Component string &IBMVERB; Local Record &IBMREC; Function IBMPublishFutureDatedEvent(&BO, &KEYS, &EFFDATE) ; /* == create a new record object for cw_event_tbl == */ &IBMREC = CreateRecord(Record.IBM_EVENT_TBL); /* =============== KEYS ================ */ /* composing keys and values in name value format */ &KEYSTRING = ""; &KEYDELIM = ":"; &KEYARRAY = Split(&KEYS, &KEYDELIM); &LEN = &KEYARRAY.Len;
Captulo 6. Referncia
51
For &I = 1 To &LEN; /* get keys and values */ /* get rid of record name */ &POS1 = Find(".", &KEYARRAY [&I]); &L1 = Len(&KEYARRAY [&I]); &POS2 = &L1 - &POS1; &KEYNAME = Right(&KEYARRAY [&I], &POS2); /****The code below will remove special characters and****/ /****adjust the characters' case to ensure it is same as the****/ /****attribute name in the business object definition***/ /****Start****/ &lLen = Len(&KEYNAME); &sOrigString = &KEYNAME; &sNewString = ""; &lCtr2 = 1; &isSpecialChar = "true"; For &lCtr = 1 To &lLen; &sChar = Substring(&sOrigString, &lCtr, 1); If (&sChar = "A" Or &sChar = "a" Or &sChar = "B" Or &sChar = "b" Or &sChar = "C" Or &sChar = "c" Or &sChar = "D" Or &sChar = "d" Or &sChar = "E" Or &sChar = "e" Or &sChar = "F" Or &sChar = "f" Or &sChar = "G" Or &sChar = "g" Or &sChar = "H" Or &sChar = "h" Or &sChar = "I" Or &sChar = "i" Or &sChar = "J" Or &sChar = "j" Or &sChar = "K" Or &sChar = "k" Or &sChar = "L" Or &sChar = "l" Or &sChar = "M" Or &sChar = "m" Or &sChar = "N" Or &sChar = "n" Or &sChar = "O" Or &sChar = "o" Or &sChar = "P" Or &sChar = "p" Or &sChar = "Q" Or &sChar = "q" Or &sChar = "R" Or &sChar = "r" Or &sChar = "S" Or &sChar = "s" Or &sChar = "T" Or &sChar = "t" Or &sChar = "U" Or &sChar = "u" Or &sChar = "V" Or &sChar = "v" Or &sChar = "W" Or &sChar = "w" Or &sChar = "X" Or &sChar = "x" Or &sChar = "Y" Or &sChar = "y" Or &sChar = "Z" Or &sChar = "z" Or &sChar = "1" Or &sChar = "2" Or &sChar = "3" Or &sChar = "4" Or &sChar = "5" Or &sChar = "6" Or &sChar = "7" Or &sChar = "8" Or &sChar = "9" Or &sChar = "0") Then If (&isSpecialChar = "true") Then &sNewString = &sNewString | Upper(&sChar); &isSpecialChar = "false"; Else &sNewString = &sNewString | Lower(&sChar); End-If; Else &isSpecialChar = "true"; End-If; End-For; &KEYNAME = &sNewString;
52
/*********End*********/ &KEYSTRING = &KEYSTRING | &KEYNAME | "=" | @&KEYARRAY [&I] | &KEYDELIM End-For; &KEYSTRING = RTrim(&KEYSTRING, ":"); &IBMREC.IBM_OBJECT_KEYS.Value = &KEYSTRING; /*============== VERB =========================*/ /* verb determination uses variable &IBMVERB */ Evaluate %Mode When = "A" &IBMVERB = "Create"; Break; When = "U" &IBMVERB = "Update"; Break; When = "L" &IBMVERB = "Update"; Break; When = "C" &IBMVERB = "Update"; Break; When-Other &IBMVERB = "Retrieve"; End-Evaluate; &IBMREC.IBM_OBJECT_VERB.Value = &IBMVERB; /* ====================== EVENT_ID GEN ==================================== */ /* create event_id */ &NEWNUM = GetNextNumber(IBM_FETCH_ID.IBM_NEXT_EVENT_ID, 99999); /* only use newnum if no error generating next number */ If &NEWNUM > 0 Then &IBMREC.IBM_EVENT_ID.Value = &NEWNUM; Else &IBMREC.IBM_EVENT_ID.Value = %Datetime; End-If; /*Support for Future Effective Date - The adapter will poll such events when the date arrives*/ If &EFFDATE > %Datetime Then &IBMREC.IBM_EVENT_DTTM.Value = &EFFDATE; &IBMREC.IBM_EVENT_STATUS.Value = "99"; Else &IBMREC.IBM_EVENT_DTTM.Value = %Datetime; &IBMREC.IBM_EVENT_STATUS.Value = "0"; End-If; /*================ INSERT EVENT INTO IBM_EVENT_TBL ============*/ /* insert row into table using record object*/ &IBMREC.IBM_OBJECT_NAME.Value = &BO; &IBMREC.Insert(); End-Function;
Function IBMPublishEvent(&BO, &KEYS); /* == create a new record object for cw_event_tbl == */ &IBMREC = CreateRecord(Record.IBM_EVENT_TBL); /* =============== KEYS ================ */ /* composing keys and values in name value format */ &KEYSTRING = ""; &KEYDELIM = ":"; &KEYARRAY = Split(&KEYS, &KEYDELIM); &LEN = &KEYARRAY.Len; For &I = 1 To &LEN; /* get keys and values */ /* get rid of record name */ &POS1 = Find(".", &KEYARRAY [&I]); &L1 = Len(&KEYARRAY [&I]); &POS2 = &L1 - &POS1; &KEYNAME = Right(&KEYARRAY [&I], &POS2); /****The code below will remove special characters and /****adjust the characters' case to ensure it is same as the /****attribute name in the business object definition***/ /****Start****/ &lLen = Len(&KEYNAME); &sOrigString = &KEYNAME; &sNewString = ""; &lCtr2 = 1; &isSpecialChar = "true"; For &lCtr = 1 To &lLen; &sChar = Substring(&sOrigString, &lCtr, 1); If (&sChar = "A" Or &sChar = "a" Or
53
&sChar = "B" Or &sChar = "b" Or &sChar = "C" Or &sChar = "c" Or &sChar = "D" Or &sChar = "d" Or &sChar = "E" Or &sChar = "e" Or &sChar = "F" Or &sChar = "f" Or &sChar = "G" Or &sChar = "g" Or &sChar = "H" Or &sChar = "h" Or &sChar = "I" Or &sChar = "i" Or &sChar = "J" Or &sChar = "j" Or &sChar = "K" Or &sChar = "k" Or &sChar = "L" Or &sChar = "l" Or &sChar = "M" Or &sChar = "m" Or &sChar = "N" Or &sChar = "n" Or &sChar = "O" Or &sChar = "o" Or &sChar = "P" Or &sChar = "p" Or &sChar = "Q" Or &sChar = "q" Or &sChar = "R" Or &sChar = "r" Or &sChar = "S" Or &sChar = "s" Or &sChar = "T" Or &sChar = "t" Or &sChar = "U" Or &sChar = "u" Or &sChar = "V" Or &sChar = "v" Or &sChar = "W" Or &sChar = "w" Or &sChar = "X" Or &sChar = "x" Or &sChar = "Y" Or &sChar = "y" Or &sChar = "Z" Or &sChar = "z" Or &sChar = "1" Or &sChar = "2" Or &sChar = "3" Or &sChar = "4" Or &sChar = "5" Or &sChar = "6" Or &sChar = "7" Or &sChar = "8" Or &sChar = "9" Or &sChar = "0") Then If (&isSpecialChar = "true") Then &sNewString = &sNewString | Upper(&sChar); &isSpecialChar = "false"; Else
54
&sNewString = &sNewString | Lower(&sChar); End-If; Else &isSpecialChar = "true"; End-If; End-For; &KEYNAME = &sNewString; /*********End*********/ &KEYSTRING = &KEYSTRING | &KEYNAME | "=" | @&KEYARRAY [&I] | &KEYDELIM End-For; &KEYSTRING = RTrim(&KEYSTRING, ":"); &IBMREC.IBM_OBJECT_KEYS.Value = &KEYSTRING; /*============== VERB =========================*/ /* verb determination uses variable &IBMVERB */ Evaluate %Mode When = "A" &IBMVERB = "Create"; Break; When = "U" &IBMVERB = "Update"; Break; When = "L" &IBMVERB = "Update"; Break; When = "C" &IBMVERB = "Update"; Break; When-Other &IBMVERB = "Retrieve"; End-Evaluate; &IBMREC.IBM_OBJECT_VERB.Value = &IBMVERB; /* /* ====================== create event_id */ EVENT_ID GEN ============================= */
&NEWNUM = GetNextNumber(IBM_FETCH_ID.IBM_NEXT_EVENT_ID, 99999); /* only use newnum if no error generating next number */
If &NEWNUM > 0 Then &IBMREC.IBM_EVENT_ID.Value = &NEWNUM; Else &IBMREC.IBM_EVENT_ID.Value = %Datetime; End-If; &IBMREC.IBM_EVENT_DTTM.Value = %Datetime; /* ============== EVENT_STATUS =================*/ /* Validate and set event status &IBMSTATUS - list values if date is ok*/ &IBMREC.IBM_EVENT_STATUS.Value = "0"; /*================ INSERT EVENT INTO IBM_EVENT_TBL ============*/ /* insert row into table using record object*/ &IBMREC.IBM_OBJECT_NAME.Value = &BO; &IBMREC.Insert(); End-Function;
55
Propriedades de Configurao de Sada

O WebSphere Adapter para PeopleSoft Enterprise possui vrias categorias de propriedades de configurao de conexo de sada, que voc configura com o Assistente Bean J2C enquanto gera ou cria objetos e servios. possvel alterar as propriedades do adaptador de recursos e do connection factory gerenciado depois de implementar o mdulo no WebSphere Application Server usando o Rational Application Developer para WebSphere Software ou o console administrativo, mas as propriedades da conexo do Assistente Bean J2C no podero ser alteradas depois da implementao.
Guia para Informaes sobre Propriedades

As propriedades utilizadas para configurar o WebSphere Adapter para PeopleSoft Enterprise so descritas detalhadamente em tabelas includas em cada um dos tpicos de propriedades de configurao, como propriedades do Adaptador de recursos, propriedades de Managed connection factory e outras. Para ajudar a utilizar estas tabelas, as informaes sobre cada linha que pode ser vista so explicadas aqui. A tabela a seguir explica o significado de cada linha que pode ser exibida na tabela para uma propriedade de configurao.
Linha Necessrio Explicao Um campo necessrio (propriedade) deve ter um valor para que o adaptador funcione. s vezes o Assistente Bean J2C fornece um valor padro para as propriedades necessrias. A remoo de um valor padro de um campo necessrio no Assistente Bean J2C no alterar esse valor padro. Quando um campo obrigatrio no contm nenhum valor, o Assistente Bean J2C processa o campo usando o valor padro designado e esse valor padro exibido no console administrativo. Os possveis valores so Sim e No. s vezes uma propriedade necessria somente quando outra propriedade tem um valor especfico. Nesse caso, a tabela anotar essa dependncia. Por exemplo, v Sim, quando a propriedade EventQueryType configurada como Dinmica v Sim, para bancos de dados Oracle Valores Possveis Padro Lista e descreve os possveis valores que voc pode selecionar para a propriedade. O valor predefinido que configurado pelo Assistente Bean J2C. Quando a propriedade for necessria, voc dever aceitar o valor padro ou especificar um. Se uma propriedade no tiver valor padro, a tabela informar Nenhum valor padro. A palavra Nenhum um valor padro aceitvel e no significa que no existe um valor padro. Unidade de medida Especifica como a propriedade medida, por exemplo, em kilobytes ou segundos.
56
Linha Tipo de Propriedade
Explicao Descreve o tipo de propriedade. Tipos de propriedades vlidas incluem: v Booleana v Cadeia v Nmero Inteiro
Uso
Descreve as condies e restries que podem se aplicar propriedade. Por exemplo, a seguir est um exemplo de como uma restrio seria documentada: Para o Rational Application Developer para WebSphere Software verso 6.40 ou anterior, a senha: v Deve estar em letras maisculas v Deve ter 8 caracteres de comprimento Para verses do Rational Application Developer para WebSphere Software posteriores 6.40, a senha: v No faz distino entre maisculas e minsculas v Pode conter at 40 caracteres de comprimento. Esta seo lista outras propriedades que afetam essa propriedade ou as propriedades que so afetadas por ela e descreve a natureza do relacionamento condicional.
Exemplo:
Fornece valores da propriedade de amostra, por exemplo: Se Idioma estiver configurado como JA (Japons), o nmero da Pgina de Cdigos ser configurado como 8000.
Globalizado
Se uma propriedade for globalizada, ela ter suporte ao idioma nacional, o que significa que voc pode configurar o valor em seu idioma nacional. Os valores vlidos so Sim e No.
Suporte para Bidirecional
Indica se a propriedade suportada em processamento bidirecional (bidi). O processamento bidirecional pertence tarefa de processamento de dados que contm contedo semntico da direita para a esquerda (hebraico e rabe, por exemplo) e da esquerda para a direita (uma URL ou caminho, por exemplo) dentro do mesmo arquivo. Os valores vlidos so Sim e No.
Propriedades de Conexo do Assistente Bean J2C

As propriedades de conexo do Assistente Bean J2C so usadas para estabelecer uma conexo entre o Assistente Bean J2C e o aplicativo a partir do qual o assistente obter metadados. Essas propriedades especificam coisas como configurao de conexo, propriedades bidirecionais (bidi) e opes de criao de log. Nota: Se voc configurar qualquer uma das propriedades de conexo utilizando script bidirecional, ser necessrio configurar valores que identifiquem o formato do script bidirecional fornecido para essa propriedade. As propriedades de conexo e propsitos do J2C Java Bean so descritos na tabela a seguir. Uma descrio completa de cada propriedade fornecida nas sees que seguem a tabela.
57
Tabela 6. Propriedades de conexo do J2C Java Bean Nome da Propriedade Arquivo JAR da Interface do Componente Nome do Host Senha na pgina 59 Nmero da Porta na pgina 59 Prefixo para Nomes de Objetos de Negcios na pgina 59 Nome do usurio na pgina 60 Descrio Especifica a interface do componente do PeopleSoft Enterprise utilizada pelo adaptador para estabelecer conexo com os componentes do PeopleSoft que so os destinos das transaes de integrao. Especifica o nome ou endereo do servidor que hospeda o PeopleSoft Enterprise. Especifica a senha da conta do usurio do adaptador no servidor PeopleSoft Enterprise. O nmero da porta na qual o PeopleSoft Enterprise est configurado para atender pedidos do cliente. Especifica um prefixo para ser includo nos objetos de negcios gerados. O nome da conta do usurio que o adaptador utiliza no servidor PeopleSoft Enterprise.
Arquivo JAR da Interface do Componente

Essa propriedade especifica a interface do componente do PeopleSoft Enterprise que o adaptador utiliza para estabelecer uma conexo com os componentes do PeopleSoft que so destinos das transaes de integrao.
Tabela 7. Detalhes de Arquivo JAR da Interface do Componente Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim No padro Cadeia O nome do arquivo JAR que o adaptador utiliza para se conectar aos componentes do PeopleSoft Enterprise do seu interesse. CWYES_PeopleSoft\connectorModule\WbiEvent.jar No No
Nome do Host
Essa propriedade especifica o nome ou endereo do servidor que hospeda o PeopleSoft Enterprise.
Tabela 8. Detalhes do Nome do Host Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia Identifica o servidor, por nome ou endereo IP, que hospeda o PeopleSoft Enterprise. 9.26.248.202 No No
58
Senha
Essa propriedade especifica a senha da conta do usurio do adaptador no servidor PeopleSoft Enterprise.
Tabela 9. Detalhes da Senha Necessrio Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. Sim Sim
Nmero da Porta
O nmero da porta na qual o PeopleSoft Enterprise est configurado para atender pedidos do cliente.
Tabela 10. Detalhes do Nmero da Porta Necessrio Padro Tipo de Propriedade Exemplo: Globalizado Suporte para Bidirecional Sim O nmero da porta digitado quando voc executa o Assistente Bean J2C. Nmero Inteiro 9000 No No
Prefixo para Nomes de Objetos de Negcios

Essa propriedade especifica um prefixo para ser includo nos objetos de negcios gerados.
Tabela 11. Detalhes do Prefixo Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional No No padro Cadeia Essa propriedade permite que voc faa a distino entre objetos de negcios diferentes gerados em relao mesma interface do componente PeopleSoft. Se voc utilizou IB como um prefixo, todos os objetos de negcios gerados por esse servio sero nomeados utilizando esse prefixo. Sim No
59
Nome do usurio
Essa propriedade especifica o nome da conta do usurio que o adaptador utiliza no servidor PeopleSoft Enterprise.
Tabela 12. Detalhes do Nome do Usurio Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. DV1 Sim Sim
Propriedades do Adaptador de Recursos

As propriedades do adaptador de recursos controlam a operao geral do adaptador. Voc configura as propriedades do adaptador de recursos utilizando o Assistente Bean J2C ao configurar o adaptador. Aps implementar o adaptador, utilize o console administrativo para alterar essas propriedades. As seguintes propriedades para criao de log e rastreio esto reprovadas: v LogFileMaxSize v LogFileName v LogNumberOfFiles v TraceFileMaxSize v TraceFileName v TraceNumberOfFiles A tabela a seguir lista as propriedades do adaptador de recursos e suas finalidades. Uma descrio completa de cada propriedade fornecida nas sees que seguem a tabela.
Tabela 13. Propriedades do Adaptador de Recursos para o Adapter para PeopleSoft Enterprise Nome No assistente ID do Adaptador No console administrativo ID do Adaptador Descrio Identifica a instncia do adaptador para eventos de PMI e para criao de log e rastreio Especifica se voc deve disfarar informaes potencialmente confidenciais gravando cadeias X em vez de dados do usurio nos arquivos de log e rastreio. No altere esta propriedade. Reprovado Reprovado
Disfarar dados do usurio HideConfidentialTrace como XXX nos arquivos de log e de rastreio (No disponvel) (No disponvel) (No disponvel) enableHASupport LogFileMaxSize Nome do Arquivo de Registro
60
Tabela 13. Propriedades do Adaptador de Recursos para o Adapter para PeopleSoft Enterprise (continuao) Nome No assistente (No disponvel) (No disponvel) (No disponvel) (No disponvel) No console administrativo LogNumberOfFiles TraceFileMaxSize TraceFileName TraceNumberOfFiles Descrio Reprovado Reprovado Reprovado Reprovado
ID do Adaptador (ID do Adaptador)

Essa propriedade identifica uma instncia ou implementao especfica do adaptador.
Tabela 14. Detalhes do ID do Adaptador Requerido Padro Tipo de Propriedade Sim 001 Cadeia
61
Tabela 14. Detalhes do ID do Adaptador (continuao) Uso Essa propriedade identifica a instncia do adaptador nos arquivos de log e rastreio, alm de ajudar a identificar a instncia do adaptador enquanto monitora adaptadores. O ID do adaptador utilizado com um identificador especfico do adaptador, PSFTRA, para formar o nome do componente utilizado pela ferramenta Log and Trace Analyzer. Por exemplo, se a propriedade do ID do adaptador estiver configurada como 001, o ID de componente PSFTRA001. Se voc executar vrias instncias do mesmo adaptador, certifique-se de que os primeiros sete caracteres da propriedade de ID do adaptador sejam exclusivos para cada instncia, de modo que voc possa correlacionar as informaes de log e rastreio com uma instncia do adaptador especfica. Ao tornar os sete primeiros caracteres de uma propriedade de ID do adaptador exclusivos, o ID do componente para vrias instncias desse adaptador tambm exclusivo, permitindo que voc correlacione as informaes de log e rastreio com uma determinada instncia de um adaptador. Por exemplo, quando voc configura a propriedade de ID do adaptador de duas instncias do WebSphere Adapter para PeopleSoft Enterprise como 001 e 002. Os IDs de componentes para essas instncias, PSFTRA001 e PSFTRA002, so curtos o suficiente para permanecer exclusivos, permitindo distingui-los como instncias separadas do adaptador. No entanto, instncias com propriedades do ID do adaptador mais longas no podem ser distinguidas umas das outras. Se configurar as propriedades de ID do adaptador de duas instncias como Instance01 e Instance02, voc no poder examinar as informaes de log e rastreio para cada instncia do adaptador porque o ID do componente para ambas as instncias fica truncado para PSFTRAInstanc. Para processamento de entrada, o valor dessa propriedade configurado no nvel do adaptador de recursos. Para processamento de sada, o valor pode ser configurado no nvel do adaptador de recursos e no nvel de connection factory gerenciado. Aps utilizar o Assistente Bean J2C para configurar o adaptador para processamento de sada, voc pode configurar as propriedades de adaptador de recursos e connection factory gerenciado de forma independente. Globalizado Suporte para Bidirecional Sim No
Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio (HideConfidentialTrace)

Essa propriedade especifica se sero substitudos dados do usurio em arquivos de log e rastreio por uma cadeia de Xs para evitar divulgao desautorizada de dados potencialmente sensitivos.
Tabela 15. Detalhes de Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio Requerido No
62
Tabela 15. Detalhes de Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio (continuao) Valores Possveis Padro Tipo de Propriedade Uso True False False Booleana Se voc configurar essa propriedade como True, o adaptador substitui os dados do usurio por uma cadeia de Xs ao gravar nos arquivos de log e rastreio. Para processamento de entrada, o valor dessa propriedade configurado no nvel do adaptador de recursos. Para processamento de sada, o valor pode ser configurado no nvel do adaptador de recursos e no nvel de connection factory gerenciado. Aps utilizar o Assistente Bean J2C para configurar o adaptador para processamento de sada, voc pode configurar as propriedades de adaptador de recursos e connection factory gerenciado de forma independente. Globalizado Suporte para Bidirecional No No
Ativar Suporte Alta Disponibilidade (enableHASupport)

No altere esta propriedade. Ela deve ser configurada como true.
Tamanho Mximo do Arquivo de Log (LogFileMaxSize)

Essa propriedade especifica o tamanho dos arquivos de log em kilobytes.
Tabela 16. Detalhes do Tamanho Mximo do Arquivo de Log Requerido Padro Tipo de Propriedade Uso No 0 Nmero Inteiro Quando o arquivo de log atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de log. Se o tamanho do arquivo for especificado como 0 ou nenhum tamanho mximo for especificado, o arquivo no ter um tamanho mximo. Sim No
Globalizado Suporte para Bidirecional
Nome do Arquivo de Log (LogFilename)

Essa propriedade especifica o nome do caminho completo do arquivo de log.
Tabela 17. Detalhes do Nome do Arquivo de Log Requerido Padro Tipo de Propriedade Uso No Nenhum valor padro Cadeia Esta propriedade reprovada.
63
Tabela 17. Detalhes do Nome do Arquivo de Log (continuao) Globalizado Suporte para Bidirecional Sim Sim
Nmero de Arquivos de Log (LogNumberOfFiles)

Essa propriedade especifica o nmero de arquivos de log.
Tabela 18. Detalhes do Nmero de Arquivos de Log Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 1 Nmero Inteiro Quando um arquivo de log atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de log. Se nenhum valor for especificado, o adaptador cria um nico arquivo de log. Sim No
Tamanho Mximo do Arquivo de Rastreio (TraceFileMaxSize)

Essa propriedade especifica o tamanho dos arquivos de rastreio em kilobytes.
Tabela 19. Detalhes do Tamanho Mximo do Arquivo de Rastreio Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 0 Nmero Inteiro Se nenhum valor for especificado, o arquivo de rastreio no ter valor mximo. Sim No
Nome do Arquivo de Rastreio (TraceFilename)

Essa propriedade especifica o caminho completo do arquivo de rastreio.
Tabela 20. Detalhes do Nome do Arquivo de Rastreio Requerido Padro Unidade de medida Tipo de Propriedade Uso Globalizado No Nenhum valor padro Kilobytes Cadeia Esta propriedade reprovada. Sim
64
Tabela 20. Detalhes do Nome do Arquivo de Rastreio (continuao) Suporte para Bidirecional Sim
Nmero de Arquivos de Rastreio (TraceNumberOfFiles)

Essa propriedade especifica o nmero de arquivos de rastreio a serem utilizados. Quando um arquivo de rastreio atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de rastreio.
Tabela 21. Detalhes do Nmero de Arquivos de Rastreio Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 1 Nmero Inteiro Se nenhum valor for especificado, o adaptador utilizar um nico arquivo de rastreio Sim No
Propriedades Managed Connection Factory

As propriedades do connection factory gerenciado so utilizadas pelo adaptador no tempo de execuo para criar uma conexo de sada com o servidor PeopleSoft Enterprise. A tabela a seguir lista e descreve as propriedades do connection factory gerenciado para comunicao de sada. Voc configura as propriedades do connection factory gerenciado utilizando o Assistente Bean J2C ou o console administrativo (aps a implementao). Uma descrio mais detalhada de cada propriedade fornecida aps a tabela. Para obter informaes sobre como ler as tabelas de detalhes das propriedades nas sees a seguir, consulte Guia para Informaes sobre Propriedades na pgina 56. Nota: O Assistente Bean J2C se refere a estas propriedades como propriedades do connection factory gerenciado e o console administrativo se refere a elas como propriedades do connection factory (J2C).
Tabela 22. Propriedades Managed Connection Factory No assistente ID do Adaptador No console administrativo Descrio ID do Adaptador Identifica a instncia do adaptador para eventos de PMI e para criao de log e rastreio Especifica a interface do componente que o adaptador utiliza para validar uma conexo com o servidor PeopleSoft Enterprise.
Interface do Componente para Testar Conexo com Falha
PingCompInterface
65
Tabela 22. Propriedades Managed Connection Factory (continuao) Disfarar dados do usurio como XXX nos arquivos de log e de rastreio HideConfidentialTrace Especifica se voc deve disfarar informaes potencialmente confidenciais gravando cadeias X em vez de dados do usurio nos arquivos de log e rastreio. Especifica o nome ou endereo do servidor que hospeda o PeopleSoft Enterprise. Especifica o cdigo do idioma que o adaptador utiliza para efetuar logon no servidor PeopleSoft Enterprise. Especifica o nmero mximo de vezes que o adaptador tenta reestabelecer uma conexo de sada com o EIS. Especifica a senha da conta do usurio do adaptador no servidor PeopleSoft Enterprise. O nmero da porta que o adaptador utiliza para acessar o servidor PeopleSoft Enterprise. Especifica o intervalo de tempo entre as tentativas de reconexo com o servidor PeopleSoft Enterprise, se a conexo falhar. O nome da conta do usurio que o adaptador utiliza no servidor PeopleSoft Enterprise. Especifica se para gerar o objeto de negcios de falha de pedido invlido
Nome do Host
HostName
Idioma (Language) na pgina 69
Language
Mximo de tentativas em caso de falha da conexo do sistema (connectionRetryLimit) na pgina 69
connectionRetryLimit
Senha (Password) na pgina 70
Senha
Nmero da Porta (Port) na pgina 70
Porta
Tentar o intervalo novamente caso a conexo diminua (em milissegundos) (connectionRetryInterval) na pgina 71
connectionRetryInterval
Nome do Usurio (UserName) na pgina 71
UserName
Usar Falha de Pedido Invlido (useInvalidRequestFault) na pgina 72
useInvalidRequestFault

66
Interface do Componente para Testar Conexo com Falha (PingCompInterface)

Essa propriedade especifica o nome da interface do componente do PeopleSoft Enterprise que o adaptador utiliza para validar uma conexo com o servidor PeopleSoft Enterprise.
Tabela 24. Detalhes de Interface do Componente para Testar Conexo com Falha Necessrio Padro Sim O nome da primeira interface do componente na lista.
67
Tabela 24. Detalhes de Interface do Componente para Testar Conexo com Falha (continuao) Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Cadeia Especifique um nome da interface do componente que j existe nos aplicativos PeopleSoft Enterprise. WBI_CUSTOMER_CI No No

Tabela 25. Detalhes de Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio Requerido Valores Possveis Padro Tipo de Propriedade Uso No True False False Booleana Se voc configurar essa propriedade como True, o adaptador substitui os dados do usurio por uma cadeia de Xs ao gravar nos arquivos de log e rastreio. Para processamento de entrada, o valor dessa propriedade configurado no nvel do adaptador de recursos. Para processamento de sada, o valor pode ser configurado no nvel do adaptador de recursos e no nvel de connection factory gerenciado. Aps utilizar o Assistente Bean J2C para configurar o adaptador para processamento de sada, voc pode configurar as propriedades de adaptador de recursos e connection factory gerenciado de forma independente. Globalizado Suporte para Bidirecional No No
Nome do Host (HostName)

Tabela 26. Detalhes do Nome do Host Necessrio Padro Tipo de Propriedade Uso Sim Nenhum valor padro Cadeia Identifica, por nome ou endereo IP, o servidor que hospeda o PeopleSoft Enterprise.
68
Tabela 26. Detalhes do Nome do Host (continuao) Exemplo: Globalizado Suporte para Bidirecional 9.26.248.202 No No
Idioma (Language)
Essa propriedade especifica o cdigo do idioma que o adaptador utiliza para efetuar logon no servidor PeopleSoft Enterprise.
Tabela 27. Detalhes de Idioma Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim O valor padro para a propriedade Idioma baseado no cdigo de idioma do sistema. Cadeia Cada um dos idiomas suportados precedido por um cdigo de idioma de trs caracteres. O idioma em si exibido entre parnteses. Se o cdigo de idioma do sistema for ingls, o valor para essa propriedade ser ENG (ingls). No No
Mximo de tentativas em caso de falha da conexo do sistema (connectionRetryLimit)

Esta propriedade especifica o nmero de vezes que o adaptador tentar restabelecer uma conexo com o servidor do PeopleSoft Enterprise, quando encontrar um erro relacionado conexo de sada.
Tabela 28. Detalhes sobre o mximo de tentativas em caso de falha na conexo do sistema Necessrio Valores Possveis Padro Tipo de Propriedade No Nmeros inteiros iguais e maiores que zero 0 Nmero Inteiro
69
Tabela 28. Detalhes sobre o mximo de tentativas em caso de falha na conexo do sistema (continuao) Uso Quando esta propriedade est configurada para: 0 v O adaptador no tenta se reconectar com o servidor do PeopleSoft Enterprise caso um erro ocorra durante a inicializao ou o estabelecimento da conexo. v O adaptador no verifica se a conexo com o servidor PeopleSoft Enterprise vlida quando h um pedido de sada durante o tempo de execuo. >0 v O adaptador tenta se reconectar com o servidor do PeopleSoft Enterprise por um nmero especificado de vezes, caso um erro ocorra durante a inicializao ou o estabelecimento da conexo. v O adaptador verifica se a conexo com o servidor do PeopleSoft Enterprise vlida quando h um pedido de sada durante o tempo de execuo. Se a conexo no for vlida, ser terminada e uma nova conexo ser criada para processar o pedido. Se o adaptador falhar em estabelecer uma conexo depois de tentar o nmero especificado de vezes, um erro de conexo ser gerado. Se o adaptador restabelecer a conexo com xito, a operao de sada ser concluda.
Globalizado Bidirecional Suportado
No No
Senha (Password)
Tabela 29. Detalhes da Senha Necessrio Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. No No
Nmero da Porta (Port)

Essa propriedade especifica o nmero da porta que o adaptador utiliza para acessar o servidor PeopleSoft Enterprise.
Tabela 30. Detalhes do Nmero da Porta Necessrio Padro Sim O nmero da porta digitado quando voc utiliza o Assistente Bean J2C para descobrir objetos e servios.
70
Tabela 30. Detalhes do Nmero da Porta (continuao) Tipo de Propriedade Exemplo: Globalizado Suporte para Bidirecional Nmero Inteiro 9000 No No
| | | | | | | | | | | | | | | | | | | |
Globalizado Bidirecional Suportado
Tentar o intervalo novamente caso a conexo diminua (em milissegundos) (connectionRetryInterval)

Esta propriedade especifica o intervalo de tempo entre as tentativas de reconexo com o servidor do PeopleSoft Enterprise caso a conexo falhe.
Tabela 31. Detalhes sobre o intervalo de tentativas em caso de falha na conexo Necessrio Valores Possveis Padro Unidade de medida Tipo de Propriedade Uso No Nmeros inteiros iguais e maiores que 0 60000 Milissegundos Nmero Inteiro Esta propriedade aplicvel somente se o valor da propriedade Mximo de tentativas em caso de falha da conexo do sistema (connectionRetryLimit) na pgina 69 estiver configurado para maior que 0. Quando o adaptador encontra um erro ao estabelecer uma conexo com o servidor do PeopleSoft Enterprise, esta propriedade especifica o intervalo de tempo que o adaptador espera entre as tentativas de restabelecer a conexo. No No
Nome do Usurio (UserName)

Tabela 32. Detalhes do Nome do Usurio Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. DV1 No No
71
Usar Falha de Pedido Invlido (useInvalidRequestFault)

Esta propriedade especifica se para gerar o objeto de negcios de falha de pedido invlido.
Tabela 33. Detalhes do Nome do Usurio Necessrio Padro Tipo de Propriedade Uso No Falso Booleana Se esta propriedade for configurada como Verdadeira, o adaptador retornar um objeto de negcios InvalidRequestFault, caso ocorra qualquer erro no lado do servidor do sistema do PeopleSoft Enterprise durante o processamento de sada de tempo de execuo. Os cdigos de erros e as mensagens de erros esto contidas neste objeto de negcios. No No
Propriedades de Especificao de Interao

As propriedades de especificao de interao controlam a interao para uma operao. O Assistente Bean J2C configura as propriedades de especificao de interao quando voc configura o adaptador. Normalmente, no necessrio alterar essas propriedades. No entanto, algumas propriedades para operaes de sada podem ser alteradas pelo usurio. Por exemplo, voc pode aumentar o valor da propriedade de especificao de interao que especifica o nmero mximo de registros a serem retornados por uma operao RetrieveAll se suas operaes RetrieveAll no retornarem informaes completas. Para alterar essas propriedades aps o aplicativo ser implementado, utilize o editor de montagem no Rational Application Developer para WebSphere Software. As propriedades residem na ligao de mtodo da importao. Tabela 34A lista e descreve a propriedade de especificao de interao configurada por voc. Para obter informaes sobre como ler as tabelas de detalhes das propriedades nas sees a seguir, consulte Guia para Informaes sobre Propriedades na pgina 56.
Tabela 34. Propriedade de Especificao de Interao para o Adapter para PeopleSoft Enterprise Nome da Propriedade No assistente Nmero Mximo de Registros para Operao RetrieveAll No editor de montagem MaxRecords Descrio Nmero mximo de registros a ser retornado durante uma operao RetrieveAll.
Nmero Mximo de Registros para Operao RetrieveAll (MaxRecords)

Essa propriedade especifica o nmero mximo de registros a serem retornados durante uma operao RetrieveAll.
Tabela 35. Detalhes de Nmero Mximo de Registros para Operao RetrieveAll Necessrio Sim
72
Tabela 35. Detalhes de Nmero Mximo de Registros para Operao RetrieveAll (continuao) Padro Uso 105 Se o nmero de ocorrncias no PeopleSoft Enterprise exceder o valor do Nmero mximo de registros para a propriedade da operao RetrieveAll, o adaptador retorna um erro. O adaptador utiliza essa propriedade para ajudar a evitar problemas de falta de memria. Nmero Inteiro No No
Tipo de Propriedade Globalizado Suporte para Bidirecional
Propriedades de Configurao de Entrada

O WebSphere Adapter para PeopleSoft Enterprise possui vrias categorias de propriedade de configurao de conexo de entrada, que voc configura com o Assistente Bean J2C enquanto gera ou cria objetos de servios. possvel alterar as propriedades do adaptador de recursos e de especificao de ativao depois de implementar o mdulo utilizando o Rational Application Developer para WebSphere Software ou o console administrativo, mas as propriedades da conexo para o Assistente Bean J2C no podero ser alteradas aps a implementao.
Guia para Informaes sobre Propriedades

As propriedades utilizadas para configurar o WebSphere Adapter para PeopleSoft Enterprise so descritas detalhadamente em tabelas includas em cada um dos tpicos de propriedades de configurao, como propriedades do Adaptador de recursos, propriedades de Managed connection factory e outras. Para ajudar a utilizar estas tabelas, as informaes sobre cada linha que pode ser vista so explicadas aqui. A tabela a seguir explica o significado de cada linha que pode ser exibida na tabela para uma propriedade de configurao.
Linha Necessrio Explicao Um campo necessrio (propriedade) deve ter um valor para que o adaptador funcione. s vezes o Assistente Bean J2C fornece um valor padro para as propriedades necessrias. A remoo de um valor padro de um campo necessrio no Assistente Bean J2C no alterar esse valor padro. Quando um campo obrigatrio no contm nenhum valor, o Assistente Bean J2C processa o campo usando o valor padro designado e esse valor padro exibido no console administrativo. Os possveis valores so Sim e No. s vezes uma propriedade necessria somente quando outra propriedade tem um valor especfico. Nesse caso, a tabela anotar essa dependncia. Por exemplo, v Sim, quando a propriedade EventQueryType configurada como Dinmica v Sim, para bancos de dados Oracle Valores Possveis Lista e descreve os possveis valores que voc pode selecionar para a propriedade.
73
Linha Padro
Explicao O valor predefinido que configurado pelo Assistente Bean J2C. Quando a propriedade for necessria, voc dever aceitar o valor padro ou especificar um. Se uma propriedade no tiver valor padro, a tabela informar Nenhum valor padro. A palavra Nenhum um valor padro aceitvel e no significa que no existe um valor padro.
Unidade de medida Tipo de Propriedade
Especifica como a propriedade medida, por exemplo, em kilobytes ou segundos. Descreve o tipo de propriedade. Tipos de propriedades vlidas incluem: v Booleana v Cadeia v Nmero Inteiro
Uso
Descreve as condies e restries que podem se aplicar propriedade. Por exemplo, a seguir est um exemplo de como uma restrio seria documentada: Para o Rational Application Developer para WebSphere Software verso 6.40 ou anterior, a senha: v Deve estar em letras maisculas v Deve ter 8 caracteres de comprimento Para verses do Rational Application Developer para WebSphere Software posteriores 6.40, a senha: v No faz distino entre maisculas e minsculas v Pode conter at 40 caracteres de comprimento. Esta seo lista outras propriedades que afetam essa propriedade ou as propriedades que so afetadas por ela e descreve a natureza do relacionamento condicional.
Exemplo:
Fornece valores da propriedade de amostra, por exemplo: Se Idioma estiver configurado como JA (Japons), o nmero da Pgina de Cdigos ser configurado como 8000.
Globalizado
Se uma propriedade for globalizada, ela ter suporte ao idioma nacional, o que significa que voc pode configurar o valor em seu idioma nacional. Os valores vlidos so Sim e No.
Suporte para Bidirecional
Indica se a propriedade suportada em processamento bidirecional (bidi). O processamento bidirecional pertence tarefa de processamento de dados que contm contedo semntico da direita para a esquerda (hebraico e rabe, por exemplo) e da esquerda para a direita (uma URL ou caminho, por exemplo) dentro do mesmo arquivo. Os valores vlidos so Sim e No.

As propriedades de conexo do Assistente Bean J2C so usadas para estabelecer uma conexo entre o Assistente Bean J2C e o aplicativo a partir do qual o
74
assistente obter metadados. Essas propriedades especificam coisas como configurao de conexo, propriedades bidirecionais (bidi) e opes de criao de log. Nota: Se voc configurar qualquer uma das propriedades de conexo utilizando script bidirecional, ser necessrio configurar valores que identifiquem o formato do script bidirecional fornecido para essa propriedade. As propriedades de conexo e propsitos do J2C Java Bean so descritos na tabela a seguir. Uma descrio completa de cada propriedade fornecida nas sees que seguem a tabela.
Tabela 36. Propriedades de conexo do J2C Java Bean Nome da Propriedade Arquivo JAR da Interface do Componente Nome do Host Senha na pgina 76 Nmero da Porta na pgina 76 Prefixo para Nomes de Objetos de Negcios na pgina 76 Nome do usurio na pgina 77 Descrio Especifica a interface do componente do PeopleSoft Enterprise utilizada pelo adaptador para estabelecer conexo com os componentes do PeopleSoft que so os destinos das transaes de integrao. Especifica o nome ou endereo do servidor que hospeda o PeopleSoft Enterprise. Especifica a senha da conta do usurio do adaptador no servidor PeopleSoft Enterprise. O nmero da porta na qual o PeopleSoft Enterprise est configurado para atender pedidos do cliente. Especifica um prefixo para ser includo nos objetos de negcios gerados. O nome da conta do usurio que o adaptador utiliza no servidor PeopleSoft Enterprise.
Arquivo JAR da Interface do Componente

Essa propriedade especifica a interface do componente do PeopleSoft Enterprise que o adaptador utiliza para estabelecer uma conexo com os componentes do PeopleSoft que so destinos das transaes de integrao.
Tabela 37. Detalhes de Arquivo JAR da Interface do Componente Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim No padro Cadeia O nome do arquivo JAR que o adaptador utiliza para se conectar aos componentes do PeopleSoft Enterprise do seu interesse. CWYES_PeopleSoft\connectorModule\WbiEvent.jar No No
Nome do Host
75
Tabela 38. Detalhes do Nome do Host Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia Identifica o servidor, por nome ou endereo IP, que hospeda o PeopleSoft Enterprise. 9.26.248.202 No No
Senha
Tabela 39. Detalhes da Senha Necessrio Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. Sim Sim
Nmero da Porta
O nmero da porta na qual o PeopleSoft Enterprise est configurado para atender pedidos do cliente.
Tabela 40. Detalhes do Nmero da Porta Necessrio Padro Tipo de Propriedade Exemplo: Globalizado Suporte para Bidirecional Sim O nmero da porta digitado quando voc executa o Assistente Bean J2C. Nmero Inteiro 9000 No No
Prefixo para Nomes de Objetos de Negcios

Essa propriedade especifica um prefixo para ser includo nos objetos de negcios gerados.
76
Tabela 41. Detalhes do Prefixo Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional No No padro Cadeia Essa propriedade permite que voc faa a distino entre objetos de negcios diferentes gerados em relao mesma interface do componente PeopleSoft. Se voc utilizou IB como um prefixo, todos os objetos de negcios gerados por esse servio sero nomeados utilizando esse prefixo. Sim No
Nome do usurio
Tabela 42. Detalhes do Nome do Usurio Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Sim Nenhum valor padro Cadeia As restries (letras maiscula ou minsculas, comprimento e caractere) so determinadas pela verso do PeopleSoft Enterprise. DV1 Sim Sim

As propriedades do adaptador de recursos controlam a operao geral do adaptador. Voc configura as propriedades do adaptador de recursos utilizando o Assistente Bean J2C ao configurar o adaptador. Aps implementar o adaptador, utilize o console administrativo para alterar essas propriedades. As seguintes propriedades para criao de log e rastreio esto reprovadas: v v v v v v LogFileMaxSize LogFileName LogNumberOfFiles TraceFileMaxSize TraceFileName TraceNumberOfFiles
A tabela a seguir lista as propriedades do adaptador de recursos e suas finalidades. Uma descrio completa de cada propriedade fornecida nas sees que seguem a tabela.
77
Tabela 43. Propriedades do Adaptador de Recursos para o Adapter para PeopleSoft Enterprise Nome No assistente ID do Adaptador No console administrativo ID do Adaptador Descrio Identifica a instncia do adaptador para eventos de PMI e para criao de log e rastreio Especifica se voc deve disfarar informaes potencialmente confidenciais gravando cadeias X em vez de dados do usurio nos arquivos de log e rastreio. No altere esta propriedade. Reprovado Reprovado Reprovado Reprovado Reprovado Reprovado
Disfarar dados do usurio HideConfidentialTrace como XXX nos arquivos de log e de rastreio (No disponvel) (No disponvel) (No disponvel) (No disponvel) (No disponvel) (No disponvel) (No disponvel) enableHASupport LogFileMaxSize Nome do Arquivo de Registro LogNumberOfFiles TraceFileMaxSize TraceFileName TraceNumberOfFiles

78

Tabela 45. Detalhes de Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio Requerido No
79
Tabela 45. Detalhes de Disfarar Dados do Usurio como XXX em Arquivos de Log e de Rastreio (continuao) Valores Possveis Padro Tipo de Propriedade Uso True False False Booleana Se voc configurar essa propriedade como True, o adaptador substitui os dados do usurio por uma cadeia de Xs ao gravar nos arquivos de log e rastreio. Para processamento de entrada, o valor dessa propriedade configurado no nvel do adaptador de recursos. Para processamento de sada, o valor pode ser configurado no nvel do adaptador de recursos e no nvel de connection factory gerenciado. Aps utilizar o Assistente Bean J2C para configurar o adaptador para processamento de sada, voc pode configurar as propriedades de adaptador de recursos e connection factory gerenciado de forma independente. Globalizado Suporte para Bidirecional No No
Ativar Suporte Alta Disponibilidade (enableHASupport)

No altere esta propriedade. Ela deve ser configurada como true.
Tamanho Mximo do Arquivo de Log (LogFileMaxSize)

Essa propriedade especifica o tamanho dos arquivos de log em kilobytes.
Tabela 46. Detalhes do Tamanho Mximo do Arquivo de Log Requerido Padro Tipo de Propriedade Uso No 0 Nmero Inteiro Quando o arquivo de log atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de log. Se o tamanho do arquivo for especificado como 0 ou nenhum tamanho mximo for especificado, o arquivo no ter um tamanho mximo. Sim No
Nome do Arquivo de Log (LogFilename)

Essa propriedade especifica o nome do caminho completo do arquivo de log.
Tabela 47. Detalhes do Nome do Arquivo de Log Requerido Padro Tipo de Propriedade Uso No Nenhum valor padro Cadeia Esta propriedade reprovada.
80
Tabela 47. Detalhes do Nome do Arquivo de Log (continuao) Globalizado Suporte para Bidirecional Sim Sim
Nmero de Arquivos de Log (LogNumberOfFiles)

Essa propriedade especifica o nmero de arquivos de log.
Tabela 48. Detalhes do Nmero de Arquivos de Log Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 1 Nmero Inteiro Quando um arquivo de log atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de log. Se nenhum valor for especificado, o adaptador cria um nico arquivo de log. Sim No
Tamanho Mximo do Arquivo de Rastreio (TraceFileMaxSize)

Essa propriedade especifica o tamanho dos arquivos de rastreio em kilobytes.
Tabela 49. Detalhes do Tamanho Mximo do Arquivo de Rastreio Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 0 Nmero Inteiro Se nenhum valor for especificado, o arquivo de rastreio no ter valor mximo. Sim No
Nome do Arquivo de Rastreio (TraceFilename)

Essa propriedade especifica o caminho completo do arquivo de rastreio.
Tabela 50. Detalhes do Nome do Arquivo de Rastreio Requerido Padro Unidade de medida Tipo de Propriedade Uso Globalizado No Nenhum valor padro Kilobytes Cadeia Esta propriedade reprovada. Sim
81
Tabela 50. Detalhes do Nome do Arquivo de Rastreio (continuao) Suporte para Bidirecional Sim
Nmero de Arquivos de Rastreio (TraceNumberOfFiles)

Essa propriedade especifica o nmero de arquivos de rastreio a serem utilizados. Quando um arquivo de rastreio atinge seu tamanho mximo, o adaptador comea a utilizar outro arquivo de rastreio.
Tabela 51. Detalhes do Nmero de Arquivos de Rastreio Requerido Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional No 1 Nmero Inteiro Se nenhum valor for especificado, o adaptador utilizar um nico arquivo de rastreio Sim No
Propriedades de Especificao de Ativao

As propriedades de especificao de ativao contm as informaes de configurao do processamento de eventos de entrada para uma exportao. Voc configura as propriedades de especificao de ativao atravs do Assistente Bean J2C ou do console administrativo. A tabela a seguir lista as propriedades de especificao de ativao para a comunicao de entrada. Uma descrio mais detalhada de cada propriedade fornecida aps a tabela. Para obter informaes sobre como ler as tabelas de detalhes das propriedades nas sees a seguir, consulte Guia para Informaes sobre Propriedades na pgina 56.
Tabela 52. Propriedades de Especificao de Ativao Nome descritivo Instncia do adaptador para filtragem de evento Garantir Entrega nica de Evento No Processe Eventos com Registro de Data e Hora no Futuro Nome da Propriedade AdapterInstanceEventFilter Propsito Identificador que determina se essa instncia do adaptador processa eventos especficos no armazenamento de eventos Especifica se o adaptador fornece entrega nica garantida de eventos Especifica se o adaptador filtra eventos futuros comparando o registro de data e hora em cada evento com a hora do sistema Especifica a interface do componente que o adaptador utiliza para validar uma conexo com o servidor PeopleSoft Enterprise Especifica a interface do componente que o adaptador utiliza para a notificao de eventos Determina a ordem em que os eventos so entregues pelo adaptador para a exportao
AssuredOnceDelivery FilterFutureEvents
Interface do Componente para Testar Conexo com Falha Nome da Interface do Componente para Notificao de Eventos Tipo de Entrega
PingCompIntfc
EventCIName
DeliveryType
82
Tabela 52. Propriedades de Especificao de Ativao (continuao) Delimitador para chaves no armazenamento de eventos Tipos de Evento a Serem Processados EventKeyDelimiter EventTypeFilter Especifica o nome e o valor de uma chave do objeto na tabela de eventos Uma lista delimitada de tipos de eventos que indica para o adaptador quais eventos ele deve entregar Especifica o formato utilizado para criar o registro de data e hora do evento O nmero mximo de conexes que o adaptador pode utilizar para a entrega de evento de entrada O nmero mnimo de conexes que o adaptador pode utilizar para a entrega de evento de entrada O nmero de vezes que o adaptador tenta reestabelecer uma conexo de entrada aps um erro A quantidade de tempo que o adaptador aguarda entre perodos de sondagem O nmero de eventos que o adaptador entrega para a exportao durante cada perodo de sondagem Controla se o adaptador tenta a conexo novamente com o servidor PeopleSoft Enterprise se ele no puder conectar-se na inicializao A quantidade de tempo que o adaptador aguarda entre tentativas para estabelecer uma nova conexo aps um erro durante operaes de entrada Especifica se o adaptador pra a sondagem de eventos quando encontra um erro durante a sondagem
Formato de data Java para registro de data e hora do evento Mximo de Conexes
DateFormat MaximumConnections
Mnimo de Conexes
MinimumConnections
Nmero Mximo de Novas Tentativas em Caso de Falha de Conexo do Sistema Intervalo entre Perodos de Sondagem Quantidade de Sondagens
RetryLimit
PollPeriod PollQuantity
Tentar novamente conexo do EIS na inicializao
RetryConnectionOnStartup
Tempo entre novas tentativas em caso de RetryInterval falha de conexo do sistema (milissegundos) Parar o Adaptador Quando For Encontrado um Erro Durante a Sondagem StopPollingOnError
Instncia do adaptador para filtragem de evento (AdapterInstanceEventFilter)

Essa propriedade controla se essa instncia do adaptador processa eventos especficos no armazenamento de eventos.
Tabela 53. Detalhes do Instncia do adaptador para filtragem de evento Requerido Padro Tipo de Propriedade No nulo Cadeia
83
Tabela 53. Detalhes do Instncia do adaptador para filtragem de evento (continuao) Uso Essa propriedade ajuda a migrar do WebSphere Business Integration Adapter para PeopleSoft para o WebSphere Adapter para PeopleSoft Enterprise. O WebSphere Business Integration Adapter para PeopleSoft permite desempenhar balanceamento de carga em tipos de eventos de alto volume permitindo que vrias instncias do adaptador processem eventos do mesmo tipo. Quando o balanceamento de carga no necessrio, uma nica instncia do adaptador processa todos os eventos de um determinado tipo. Essa propriedade para ativar migrao total para clientes do WBIA para a JCA os quais esto no momento tirando vantagem da filtragem do connectorID. O WebSphere Adapter para PeopleSoft Enterprise normalmente no requer balanceamento de carga desse modo, mas o suporta para que voc possa migrar sem modificar os acionadores do banco de dados ou outros mecanismos que gravam eventos no armazenamento de eventos. A propriedade AdapterInstanceEventFilter corresponde propriedade do ConnectorID do WebSphere Business Integration Adapter para PeopleSoft. Para utilizar esse recurso, o PeopleCode que cria eventos no armazenamento de eventos deve atribuir o valor apropriado coluna IBM_CONNECTOR_ID. O Tabela 54 mostra a interao entre a propriedade AdapterInstanceEventFilter e o valor na coluna IBM_CONNECTOR_ID no armazenamento de eventos. Se as propriedades do EventTypeFilter e do AdapterInstanceEventFilter estiverem ambas configuradas, o adaptador processa somente eventos que atenderem aos dois critrios. Isto , ele processa somente os eventos cujo tipo estiver especificado na propriedade EventTypeFilter e cuja coluna IBM_CONNECTOR_ID corresponde propriedade do AdapterInstanceEventFilter. Exemplo: Globalizado Suporte para Bidirecional Consulte o Tabela 54. Sim Sim
Tabela 54. Interao da Propriedade AdapterInstanceEventFilter com a Coluna IBM_CONNECTOR_ID no Armazenamento de Eventos Propriedade AdapterInstanceEventFilter nulo nulo Instance1 Instance1 Instance1 Coluna IBM_CONNECTOR_ID de um evento Resultado nulo Instance1 Instance1 Instance2 nulo O adaptador processa o evento O adaptador processa o evento, porque a coluna IBM_CONNECTOR_ID no est marcada O adaptador processa o evento O adaptador no processa o evento, porque os IDs de instncia no correspondem O adaptador no processa o evento, porque os IDs de instncia no correspondem
84
Garantir Entrega nica de Evento (AssuredOnceDelivery)

Essa propriedade especifica se voc deve fazer entrega nica de evento para eventos de entrada.
Tabela 55. Detalhes de Garantir Entrega nica de Evento Requerido Valores Possveis Padro Tipo de Propriedade Uso Sim True False True Booleana Quando essa propriedade est configurada como True, o adaptador fornece garantia de entrega nica de evento. Isso significa que cada evento ser entregue uma vez e somente uma vez. Um valor False no fornece entrega nica de evento, mas fornece melhor desempenho. Quando essa propriedade est configurada como True, o adaptador tenta armazenar informaes de transao (XID) no armazenamento de eventos. Se ela estiver configurada como False, o adaptador no tenta armazenar as informaes. Esta propriedade utilizada apenas se o componente de exportao for transacional. Se no for, nenhuma transao poder ser utilizada, independentemente do valor dessa propriedade. Globalizado Suporte para Bidirecional No No
Interface do Componente para Testar Conexo com Falha (PingCompInterface)

Essa propriedade especifica o nome da interface do componente do PeopleSoft Enterprise que o adaptador utiliza para validar uma conexo com o servidor PeopleSoft Enterprise.
Tabela 56. Detalhes de Interface do Componente para Testar Conexo com Falha Linha Necessrio Padro Tipo de Propriedade Uso Explicao Sim O nome da primeira interface do componente na lista Cadeia O nome da interface do componente que o adaptador utiliza para testar a conectividade com o servidor PeopleSoft Enterprise. Especifique um nome da interface do componente que j existe nos aplicativos PeopleSoft Enterprise. No No
85
Nome da Interface do Componente para Notificao de Eventos (EventCIName)

Essa propriedade especifica o nome da interface do componente do PeopleSoft Enterprise que o adaptador utiliza para processamento de entrada.
Tabela 57. Detalhes de Nome da Interface do Componente para Notificao de Eventos Linha Necessrio Padro Tipo de Propriedade Uso Explicao Sim IBM_EVENT_CI Cadeia O nome da interface do componente que o adaptador utiliza para processamento de entrada. Para utilizar o processamento de entrada, voc deve criar uma interface do componente especificamente para a notificao de eventos no PeopleSoft Enterprise. No No
Tipo de Entrega (DeliveryType)

Essa propriedade especifica a ordem em que os eventos so entregues pelo adaptador para a exportao.
Tabela 58. Detalhes do Tipo de Entrega Requerido Valores Possveis Padro Tipo de Propriedade Uso No ORDERED UNORDERED ORDERED Cadeia Os valores a seguir so suportados: v ORDERED: O adaptador entrega eventos para a exportao de uma vez. v UNORDERED: O adaptador entrega todos os eventos para a exportao de uma s vez.. Nota: Se o valor de DeliveryType for UNORDERED, ento as propriedades Mnimo de Conexes (MinimumConnections) e Mximo de Conexes (MaximumConnections) devero ser maiores que 1. Caso contrrio, a entrega de evento no funcionar corretamente. Como um exemplo, voc pode configurar Conexes mnimas como 2 e Conexes mximas como 4. Globalizado Suporte para Bidirecional No No
Delimitador para Chaves no Armazenamento de Eventos (EventKeyDelimiter)

Essa propriedade especifica o delimitador para o par nome-valor da chave do objeto na tabela de eventos.
86
Tabela 59. Detalhes do Delimitador para Chaves no Armazenamento de Eventos Linha Necessrio Padro Tipo de Propriedade Uso Exemplo: Globalizado Suporte para Bidirecional Explicao No =: Cadeia Essa propriedade permite que voc especifica um nome e um valor do objeto para serem utilizados como uma chave do objeto no armazenamento de eventos. CustomerID=2001 No No
No Processe Eventos com Registro de Data e Hora no Futuro (FilterFutureEvents)

Essa propriedade especifica se o adaptador filtra eventos futuros comparando o registro de data e hora em cada evento com a hora do sistema.
Tabela 60. Detalhes de No Processe Eventos com Registro de Data e Hora no Futuro Requerido Valores Possveis Padro Tipo de Propriedade Uso Sim True False False Booleana Se configurado como True, o adaptador compara a hora de cada evento com a hora do sistema. Se a hora do evento for posterior hora do sistema, o evento no ser entregue. Se configurado como False, o adaptador entrega todos os eventos. Globalizado Suporte para Bidirecional No No
Tipos de Evento a Serem Processados (EventTypeFilter)

Essa propriedade contm uma lista delimitada de tipos de eventos que indica para o adaptador quais eventos ele deve entregar.
Tabela 61. Detalhes do Tipos de Evento a Serem Processados Requerido Valores Possveis Padro Tipo de Propriedade No Uma lista delimitada por vrgulas (,) de tipos de objetos de negcios nulo Cadeia
87
Tabela 61. Detalhes do Tipos de Evento a Serem Processados (continuao) Uso Eventos so filtrados por tipo de objeto de negcios. Se a propriedade estiver configurada, o adaptador entrega somente aqueles eventos que esto na lista. Um valor de null indica que nenhum filtro ser aplicado e que todos os eventos sero entregues para a exportao. Para receber somente os eventos relacionados aos objetos de negcios Cliente e Pedido, especifique esse valor: Customer,Order Se as propriedades do EventTypeFilter e do AdapterInstanceEventFilter estiverem ambas configuradas, o adaptador processa somente eventos que atenderem aos dois critrios. Isto , ele processa somente os eventos cujo tipo estiver especificado na propriedade EventTypeFilter e cuja coluna IBM_CONNECTOR_ID corresponde propriedade do AdapterInstanceEventFilter. Globalizado Suporte para Bidirecional No No
Exemplo:
Limite de Novas Tentativas para Eventos com Falha (FailedEventRetryLimit)

Essa propriedade especifica o nmero de vezes que o adaptador tenta entregar um evento novamente antes de marcar o evento como com falha.
Tabela 62. Limite de Novas Tentativas para Detalhes de Eventos com Falha Requerido Valores Possveis Padro Tipo de Propriedade Uso No Inteiros 5 Nmero Inteiro Utilize essa propriedade para controlar o nmero de vezes que o adaptador tenta enviar um evento antes de marc-lo como com falha. Ela aceita os seguintes valores: Padro Se essa propriedade no estiver configurada, o adaptador tenta cinco vezes mais antes de marcar o evento como com falha. 0 O adaptador tenta entregar o evento um nmero infinito de vezes. Quando a propriedade estiver configurada como 0, o evento permanece no armazenamento de eventos e o evento nunca marcado como com falha. Para inteiros maiores que zero, o adaptador tenta novamente o nmero de vezes especificado antes de marcar o evento como com falha. Para inteiros negativos, o adaptador no tenta novamente eventos com falha.
>0
<0 Globalizado Suporte para Bidirecional No No
88
Formato de Data Java para Registro de Data e Hora do Evento (DateFormat)

Essa propriedade especifica o formato que utilizado para o registro de data e hora do evento.
Tabela 63. Formato de Data Java para Detalhes de Registro de Data e Hora do Evento Linha Necessrio Padro Tipo de Propriedade Uso Globalizado Suporte para Bidirecional Explicao Sim MM/dd/yy Cadeia Essa propriedade utilizada para formatar os valores de data obtidos do servidor PeopleSoft Enterprise. No No
Mximo de Conexes (MaximumConnections)

Essa propriedade especifica o nmero mximo de conexes que o adaptador pode utilizar para a entrega de evento de entrada.
Tabela 64. Detalhes de Mximo de Conexes Requerido Padro Tipo de Propriedade Uso No 1 Nmero Inteiro Apenas valores positivos so vlidos. O adaptador considera qualquer entrada positiva menor que 1 como sendo igual a 1. Digitar um valor negativo para esta propriedade pode resultar em erros de tempo de execuo. No No
Mnimo de Conexes (MinimumConnections)

Essa propriedade especifica o nmero mnimo de conexes que o adaptador pode utilizar para a entrega de evento de entrada.
Tabela 65. Detalhes de Mnimo de Conexes Requerido Padro Tipo de Propriedade Uso No 1 Nmero Inteiro Apenas valores positivos so vlidos. Qualquer valor menor que 1 tratado como 1 pelo adaptador. Digitar um valor negativo ou 1 para esta propriedade pode resultar em erros de tempo de execuo. No No
89
Intervalo entre Perodos de Sondagem (PollPeriod)

Essa propriedade especifica a quantidade de tempo que o adaptador aguarda entre perodos de sondagem.
Tabela 66. Detalhes do Intervalo entre Perodos de Sondagem Requerido Valores Possveis Padro Unidade de medida Tipo de Propriedade Uso Sim Inteiros maiores ou iguais a 0. 2000 Milissegundos Nmero Inteiro O perodo de poll estabelecido como uma taxa fixa, o que significa que se a execuo do ciclo de poll estiver atrasado por alguma razo (por exemplo, se um ciclo de poll anterior demorar mais do que o esperado para concluir), o prximo ciclo de poll ocorrer imediatamente para compensar o tempo perdido causado pelo atraso. No No
Mximo de Eventos no Perodo de Sondagem (PollQuantity)

Essa propriedade especifica o nmero de eventos que o adaptador entrega para a exportao durante cada perodo de sondagem.
Tabela 67. Detalhes do Mximo de Eventos no Perodo de Sondagem Requerido Padro Tipo de Propriedade Uso Sim 10 Nmero Inteiro O valor deve ser maior que 0. Se esse valor aumentar, mais eventos sero processados por perodo de polling e o adaptador pode passar a funcionar com menos eficincia. Se esse valor for diminudo, menos eventos sero processados por perodo de sondagem e o desempenho do adaptador pode melhorar um pouco. No No
Nmero de Vezes para Tentar Novamente a Conexo do Sistema (RetryLimit)

Essa propriedade especifica o nmero de vezes que o adaptador tenta reestabelecer uma conexo de entrada.
Tabela 68. Detalhes de Nmero de Vezes para Tentar Novamente a Conexo do Sistema Requerido Valores Possveis Padro Tipo de Propriedade No 0 e nmeros inteiros positivos 0 Nmero Inteiro
90
Tabela 68. Detalhes de Nmero de Vezes para Tentar Novamente a Conexo do Sistema (continuao) Uso Essa propriedade controla a quantidade de vezes que o adaptador tenta novamente a conexo se ele no puder conectar-se ao servidor PeopleSoft Enterprise para desempenhar o processamento de entrada. Um valor 0 indica um nmero infinito de novas tentativas. Para controlar se o adaptador tenta novamente se no puder conectar-se ao servidor PeopleSoft Enterprise quando ele iniciado pela primeira vez, utilize a propriedade RetryConnectionOnStartup. Globalizado Suporte para Bidirecional Sim No
Tentar novamente conexo do EIS na inicializao (RetryConnectionOnStartup)

Essa propriedade controla se o adaptador tenta conectar-se novamente ao servidor PeopleSoft Enterprise se ele no puder conectar-se na inicializao.
Tabela 69. Detalhes do Tentar novamente conexo do EIS na inicializao Requerido Valores Possveis Padro Tipo de Propriedade Uso No True False False Booleana Essa propriedade indica se o adaptador deve tentar novamente a conexo com o servidor PeopleSoft Enterprise se a conexo no puder ser feita quando o adaptador for iniciado: v Configure a propriedade como False quando desejar feedback imediato sobre se o adaptador pode estabelecer uma conexo com o servidor PeopleSoft Enterprise, por exemplo, quando voc estiver construindo e testando o aplicativo que recebe eventos do adaptador. Se o adaptador no puder conectar-se, ele grava informaes de log e rastreio e para. O console administrativo mostra o status do aplicativo como Parado. Aps resolver o problema de conexo, inicie o adaptador manualmente. v Configure a propriedade como True se no precisa de feedback imediato sobre a conexo. Se o adaptador no puder conectar-se durante a inicializao, ele grava informaes de log e rastreio e, em seguida, tenta reconectar, utilizando a propriedade RetryInterval para determinar o nmero de vezes para tentar novamente at que aquele valor seja atingido. O console administrativo mostra o status do aplicativo como Iniciado. Globalizado Suporte para Bidirecional No No
91
Intervalo de Novas Tentativas em Caso de Falha na Conexo (RetryInterval)

Quando o adaptador encontra um erro relacionado conexo de entrada, esta propriedade especifica o perodo de tempo que o adaptador aguarda antes de tentar estabelecer uma nova conexo.
Tabela 70. Detalhes de Intervalo de Novas Tentativas Requerido Padro Unidade de medida Tipo de Propriedade Uso Sim 2000 Milissegundos Nmero Inteiro Apenas valores positivos so vlidos. Quando o adaptador encontra um erro relacionado conexo de entrada, esta propriedade especifica o perodo de tempo que o adaptador aguarda antes de tentar estabelecer uma nova conexo. Sim No
Parar o Adaptador Quando For Encontrado um Erro Durante a Sondagem (StopPollingOnError)

Essa propriedade especifica se o adaptador pra a sondagem de eventos quando encontra um erro durante a sondagem.
Tabela 71. Detalhes de Parar o Adaptador Quando For Encontrado um Erro Durante a Sondagem Requerido Valores Possveis Padro Tipo de Propriedade Uso No True False False Booleana Se essa propriedade estiver configurada como True, o adaptador pra a sondagem quando encontra um erro. Se essa propriedade estiver configurada como False, o adaptador registra uma exceo quando encontra um erro durante a sondagem e continua a sondagem. Globalizado Suporte para Bidirecional No No
Globalization
O WebSphere Adapter para PeopleSoft Enterprise um aplicativo globalizado que pode ser utilizado em vrios ambientes lingsticos e culturais. Baseado no suporte ao conjunto de caracteres e no cdigo do idioma do servidor host, o adaptador entrega o texto da mensagem no idioma apropriado. O adaptador suporta transformao de dados de script bidirecional entre componentes de integrao.
92
Globalizao e Transformao de Dados Bidirecional

O adaptador globalizado para suportar conjuntos de caracteres de byte nico e de bytes mltiplos e apresentar o texto de mensagem no idioma especificado. O adaptador tambm desempenha transformao de dados de script bidirecional, que se refere tarefa de processar dados que contm o contedo semntico da direita para a esquerda (hebraico ou rabe, por exemplo) e da esquerda para a direita (uma URL ou caminho de arquivo, por exemplo) no mesmo arquivo.
Globalization
Aplicativos de software globalizados so projetados e desenvolvidos para uso em vrios ambientes lingsticos e culturais em vez de em ambientes simples. O WebSphere Adapters, Rational Application Developer para WebSphere Software e WebSphere Application Server so escritos em Java. O Java Runtime Environment na JVM (Java Virtual Machine) representa dados no conjunto de cdigos de caracteres Unicode. O Unicode contm codificaes para caracteres na maioria dos conjuntos de cdigos de caracteres conhecidos (de byte nico e multibyte). Portanto, quando os dados so transferidos entre esses componentes do sistema de integrao, no necessria a converso de caracteres. Para registrar mensagens de erro e informativas no idioma apropriado e para o pas ou regio apropriada, o adaptador utiliza o cdigo do idioma do sistema no qual ele est em execuo.
Transformao de Dados de Script Bidirecional

Idiomas, tais como, rabe e hebraico, so gravados da direita para a esquerda, pois contm segmentos de texto incorporados que so gravados da esquerda para a direita, resultando em script bidirecional. Quando aplicativos de software suportam dados de script bidirecionais, so utilizados padres para exibi-los e process-los. A transformao de dados de script bidirecional aplica-se apenas aos dados de tipo de cadeia. O WebSphere Application Server usam o formato padro do Windows, mas os aplicativos ou sistemas de arquivos que trocam dados com o servidor podem usar um formato diferente. O adaptador transforma dados de script bidirecionais transmitidos entre os dois sistemas para que eles sejam processados e exibidos com exatido nos dois lados de uma transao. Ele transforma os dados de script utilizando um conjunto de propriedades que define o formato dos dados de script, assim como propriedades que identificam contedo ou metadados aos quais a transformao se aplica. Formatos de Dados de Script Bidirecionais O WebSphere Application Server usam o formato bidirecional ILYNN (implcito, esquerda para direita, ligado, desligado, nominal). Este o formato utilizado pelo Windows. Se um sistema de informaes corporativo utilizar um formato diferente, o adaptador converte o formato antes de introduzir os dados no WebSphere Application Server. Cinco atributos formam o formato bidirecional. Ao configurar propriedades bidirecionais, voc designa valores para cada um destes atributos. Os atributos e configuraes esto listados na tabela a seguir.
93
Tabela 72. Atributos de Formato Bidirecional Posio da Letra 1 Propsito Esquema de Ordem Direo Valores I V L E l D 3 Troca Simtrica Y N 4 Forma do Texto C N I M L B 5 Modelagem Numrica H l N Descrio Implcito (Lgico) Visual Esquerda para a Direita Direita para a Esquerda Esquerda para a Direita Contextual Direita para a Esquerda Contextual Troca simtrica est ligada Troca simtrica est desligada Texto modelado O texto no est modelado (Nominal) Modelagem inicial Modelagem intermediria Modelagem final Shape isolado Nacional (Hindi) Modelagem Contextual Os nmeros no esto modelados (Nominal) N N Y L Configurao Padro I
Propriedades Bidirecionais que Identificam Dados para Transformao Para identificar dados de negcios sujeitos transformao, configure a propriedade BiDiContextEIS. Faa isto, especificando valores para cada um dos cinco atributos de formato bidirecional (listados na tabela anterior) para a propriedade. A propriedade BiDiContextEIS pode ser configurada para o connection factory gerenciado e a especificao de ativao.
Propriedades Ativadas para Transformao de Dados Bidirecional

As propriedades de transformao de dados bidirecional foram o formato correto dos dados de script bidirecional trocados entre um aplicativo e ferramentas de integrao e ambientes de tempo de execuo. Quando essas propriedades so configuradas, os dados de script bidirecionais so processados e exibidos corretamente no Rational Application Developer para WebSphere Software e no WebSphere Application Server.

As seguintes propriedades de conexo gerenciadas controlam a transformao de dados de script bidirecional. v Senha
94
v Nome do Usurio

As seguintes propriedades de especificao de ativao so ativadas para transformao de dados de script bidirecional: v Nome do arquivo de log v Nome do arquivo de rastreio
95
96
ndice Remissivo A
adaptador projeto, criar 20 adaptador incorporado consideraes para utilizar 16 descrio 15 propriedades de especificao de ativao, configurando 35 propriedades do adaptador de recursos, configurando 33 propriedades do managed connection factory, configurando 34 adaptador independente consideraes para utilizar 16 descrio 15 propriedades de especificao de ativao, configurando 39 propriedades do adaptador de recursos, configurando 37 propriedades do managed connection factory, configurando 37 Adapter para PeopleSoft Enterprise administrando 33 alias de autenticao 15 ambiente de alta disponibilidade descrio 17 implementando em 17 processos de entrada 17 processos de sada 18 ambiente de tempo de execuo autenticao em 15 ambiente em cluster descrio 17 implementando em 17 processos de entrada 17 processos de sada 18 Analisador de Log 43 armazenamento de eventos 4 arquitetura do adaptador 3 arquivo JAR, incluindo externas 21 arquivo SystemOut.log 45 arquivo trace.log 45 arquivos arquivo de log SystemOut.log 45 arquivo de rastreio trace.log 45 arquivos de log alterando o nome do arquivo 45 ativando 43 desativando 43 local 45 nvel de detalhe 43 arquivos de log e rastreio 11 arquivos de rastreio alterando o nome do arquivo 45 ativando 43 desativando 43 local 45 nvel de detalhe 43 arquivos do pacote para adaptadores 44 Assistente Bean J2C autenticao em 14 autenticao Assistente Bean J2C 14 descrio 14 tempo de execuo 15
N
notas tcnicas 2, 48
C
conexo mltipla configurando log 43 rastreio 43 86
O
objetos de negcios 9 operaes de dados suportadas 50 operaes de dados 50 operaes de dados suportadas 50
D
dados confidenciais, disfarando 13 dados sensitivos, disfarando 13 dependncias do software, incluindo externas 21 dependncias externas, incluindo 21 depurando recursos de auto-atendimento 48 determinao de problemas recursos de auto-atendimento 48
P
projeto de conector 20 propriedade de configurao de sada 56 propriedade de especificao de interao 72 propriedade enableHASupport 18 propriedades adaptador de recursos 33, 37 configurao de entrada 73 configurao de sada 56 especificao de ativao 35, 39 lista de 82 managed (J2C) connection factory 34, 37 propriedades de configurao entrada 73 sada 56 propriedades customizadas adaptador de recursos 33, 37 especificao de ativao 35, 39 managed connection factory 34, 37 Propriedades de Conexo do Servio Externo 57, 75 propriedades de configurao de entrada 73 propriedades de especificao de ativao configurando no console administrativo 35, 39 lista de 82 propriedades do adaptador de recursos configurando no console administrativo 33, 37 detalhes 60, 77 propriedades do managed (J2C) connection factory configurando no console administrativo 34, 37
E
entrega de evento 86
F
FFDC (first-failure data capture) 46
I
implementao opes 15 Implementao do adaptador 13 importando no projeto 21 informaes do objeto de negcios 49 informaes especficas do aplicativo 49
L
log configurando propriedades com o console administrativo 43 Log and Trace Analyzer, suporte para 11
M
matriz, compatibilidade 2 matriz de compatibilidade 2 metadados 49 nvel de propriedade 50 nvel do objeto de negcios 49 metadados de nvel de propriedade metadados de nvel do objeto de negcios 49
R
rastreio configurando propriedades com o console administrativo 43 rastreio confidencial 13 recursos de auto-atendimento 48 requisitos, hardware e software 2 requisitos de hardware 2
50
97
requisitos de hardware e software 2 requisitos de software 2 resoluo de problemas recursos de auto-atendimento 48 viso geral do NIS 43
sondagem 4 suporte recursos de auto-atendimento viso geral do NIS 43
V
48 Viso Geral Tcnica 3
S
segurana disfarando dados sensitivos Segurana 13 segurana, Java 2 15 segurana Java 2 15 13
T
Tentar novamente propriedade limite 90
W
WebSphere Extended Deployment 17
U
UNORDERED 86
98

Brazilian Portuguese Wsa 20091214 PSFT PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Brazilian Portuguese Wsa 20091214 PSFT PDF

Uploaded by

Copyright:

Available Formats

WebSphere

Guia do Usurio do Adapter para PeopleSoft Enterprise

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 2. Planejando a Implementao do Adaptador . . . . . 13

Captulo 5. Resoluo de Problemas e Suporte . . . . . . . . . . . . . . 43

Captulo 3. Configurando o Mdulo para Implementao . . . . . . . . . 19

Captulo 6. Informaes de Referncia

Captulo 4. Configurando o aplicativo no WebSphere Application Server . . . 33

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 1. Viso Geral do WebSphere Adapter para PeopleSoft Enterprise

O Que H de Novo Neste Release

Requisitos de Hardware e Software

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Viso Geral Tcnica

Operaes de Sada Suportadas

Exists Retrieve RetrieveAll

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 1. Viso Geral do WebSphere Adapter para PeopleSoft Enterprise

Monitorando Eventos de Entrada

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Como Objetos de Negcios So Criados

Estrutura do Objeto de Negcios

Ligaes de Dados Java

Captulo 1. Viso Geral do WebSphere Adapter para PeopleSoft Enterprise

O Assistente Bean J2C

Conformidade das Normas

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Internet Protocol, Verso 6 (IPv6)

Suporte para o Log and Trace Analyzer

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 2. Planejando a Implementao do Adaptador

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Autenticao no Tempo de Execuo

Consideraes para Embutir um Adaptador no Aplicativo

Consideraes para Utilizar um Adaptador Independente

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

WebSphere Adapters em Ambientes em Clusters

Alta Disponibilidade para Processos de Entrada

Alta Disponibilidade para Processos de Sada

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 3. Configurando o Mdulo para Implementao

Criando um Projeto de Evento Customizado no PeopleTools

Por Que e Quando Desempenhar Esta Tarefa

Nome do campo IBM_XID

Ativando o assistente do J2C Bean

Por Que e Quando Desempenhar Esta Tarefa

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

O que Fazer Depois

Configurando as dependncias do conector

Por Que e Quando Desempenhar Esta Tarefa

Captulo 3. Configurando o Mdulo para Implementao

Configurando Propriedades de Conexo do Assistente Bean J2C

Por Que e Quando Desempenhar Esta Tarefa

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

Captulo 3. Configurando o Mdulo para Implementao

O que Fazer Depois

Configurando o Mdulo para Processamento de Sada

Selecionando Objetos de Negcios e Servios

Por Que e Quando Desempenhar Esta Tarefa

IBM WebSphere Guia do Usurio do Adapter para PeopleSoft Enterprise

O que Fazer Depois

Configurando os Objetos Selecionados