WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Propriedades do Adaptador de Entrada para PeopleSoft

As propriedades do adaptador de entrada mantém as informações de configuração para o processamento de eventos de entrada de um componente de exportação. Essas propriedades também controlam a operação geral do adaptador, como especificar o namespace para objetos de negócios. Use o assistente Conexão do Adaptador para configurar essas propriedades.

A tabela a seguir lista as propriedades para o processamento de entrada configurado usando o assistente Conexão do Adaptador. Uma descrição mais detalhada de cada propriedade é fornecida nas seções que acompanham a tabela.
Tabela 1. Propriedades do Adaptador de Entrada
Nome da Propriedade Propósito
O ID do adaptador a ser utilizado para criação de log e rastreio (AdapterID) O nome da instância do adaptador nos arquivos de log e de rastreio.
Instância do adaptador para o evento filtragem (AdapterInstanceEventFilter) Identificador que determina se essa instância do adaptador processa eventos específicos no armazenamento de eventos.

Assegurar uma Única Entrega de Evento (AssuredOnceDelivery)

Especifica se o adaptador fornece a entrega única garantida de eventos.

Interface do componente para testar conexões com falha (PingCompIntfc) A interface do componente que o adaptador utiliza para validar uma conexão com o servidor PeopleSoft Enterprise
Nome da Interface do Componente para Notificação de Eventos (EventCIName) A interface do componente que o adaptador utiliza para notificação de eventos

Tipo de Entrega (DeliveryType)

Determina a ordem na qual os eventos são entregues pelo adaptador para o componente de exportação.

Delimitador para Chaves no Armazenamento de Eventos (EventKeyDelimiter) O nome e valor para uma chave de objeto na tabela de eventos
Não processar eventos que têm um registro de data e hora no futuro (FilterFutreEvents)

Especifica se o adaptador filtra os eventos futuros, comparando o registro de data e hora em cada evento com a hora do sistema

Tipos de eventos para processamento (EventTypeFilter)

Uma lista delimitada de tipos de eventos que indica ao adaptador quais eventos devem ser entregues

Formato de Data Java™ para Registro de Data e Hora de Evento (DateFormat) O formato que é utilizado para criar o registro de data e hora do evento

Conexões Máximas (MaximumConnections)

O número máximo de conexões que o adaptador pode usar para a entrega de evento de entrada.

Mínimo de Conexões (MinimumConnections)

O número mínimo de conexões que o adaptador pode usar para a entrega de evento de entrada.

Tempo entre pesquisa para eventos (PollPeriod)

O período de tempo que o adaptador aguarda entre os períodos de sondagem.

Número máximo de eventos coletados durante cada pesquisa (PollQuantity)

O número de eventos que o adaptador entrega ao componente de exportação durante cada período de sondagem.

Pare o adaptador quando um erro é encontrado durante a sondagem (StopPollingOnError)

Especifica se o adaptador pára a sondagem de eventos quando encontrar um erro durante a sondagem.

Tempo entre novas tentativas em caso de falha de conexão do sistema (RetryInterval)

O período de tempo que o adaptador aguarda entre as tentativas de estabelecer uma nova conexão depois que um erro ocorre durante as operações de entrada.

O ID do adaptador a ser utilizado para criação de log e rastreio (AdapterID)

Requerido SIM
Padrão 001
Tipo de Propriedade Seqüência de caracteres
Utilização Essa propriedade identifica a instância do adaptador nos arquivos de log e de rastreio e também ajuda a identificar a instância do adaptador enquanto monitora adaptadores. O ID do adaptador é usado com um identificador específico do adaptador, PSOFTRA, para formar o nome do componente usado pela ferramenta Log and Trace Analyzer. Por exemplo, se a propriedade do ID do adaptador for configurada como 001, o ID do componente será PSOFTRA001.

Se você executar várias instâncias do mesmo adaptador, certifique-se de que os oito primeiros caracteres da propriedade do ID do adaptador sejam exclusivos para cada instância para que seja possível correlacionar as informações de log e rastreio com uma instância particular do adaptador. Ao tornar exclusivos os sete primeiros caracteres de uma propriedade do ID do adaptador, o ID do componente para várias instâncias desse adaptador também é exclusivo, permitindo que você correlacione as informações de log e rastreio com uma instância particular de um adaptador.

Por exemplo, quando você configura a propriedade do ID do adaptador de duas instâncias do WebSphere Adapter para PeopleSoft Enterprise como 001 e 002. Os IDs do componente para essas instâncias, PSOFTRA001 e PSOFTRA002, são curtos o suficiente para permanecerem exclusivos, permitindo distingui-los como instâncias separadas do adaptador. Entretanto, as instâncias com propriedades do ID do adaptador mais longas não podem ser distinguidas umas das outras. Se configurar as propriedades do ID do adaptador de duas instâncias como Instance01 e Instance02, você não conseguirá examinar as informações de log e rastreio para cada instância do adaptador porque o ID do componente para ambas as instâncias está truncado como PSOFTRAInstance.

Para processamento de entrada, esta propriedade é recuperada das propriedades do adaptador de recursos. Para processamento de saída, ela é recuperada das propriedades do connection factory gerenciado.

Globalizado SIM
Bidi suportado Não

Instância do Adaptador para Filtragem de Eventos (AdapterInstanceEventFilter) (AdapterInstanceEventFilter)

Esta propriedade controla se a instância do adaptador processa eventos específicos no armazenamento de eventos.

Tabela 2. Detalhes do Instância do Adaptador para Filtragem de Eventos (AdapterInstanceEventFilter)
Exigido Não
Default null
Tipo de Propriedade Sequência
Utilização Essa propriedade ajuda você a migrar do WebSphere Business Integration Adapter for PeopleSoft para o WebSphere Adapter para PeopleSoft Enterprise. WebSphere Business Integration Adapter for PeopleSoft permite que você execute o balanceamento de carga em tipos de eventos de volume alto permitindo que várias instâncias do adaptador processem eventos do mesmo tipo. Quando o balanceamento de carga não é necessário, uma única instância do adaptador processa todos os eventos de um determinado tipo. Essa propriedade é para ativar migração contínua para clientes do WBIA para JCA, os quais estão no momento tirando vantagem da filtragem do connectorID.

O WebSphere Adapter para PeopleSoft Enterprise geralmente não requer balanceamento de carga dessa maneira, 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 ConnectorID do WebSphere Business Integration Adapter for PeopleSoft.

Para usar este recurso, os acionadores do banco de dados ou outros mecanismos que criam eventos no armazenamento de eventos devem designar o valor apropriado à coluna ID do Conector.

Para usar este recurso, o PeopleCode que cria eventos no armazenamento de eventos deve designar o valor apropriado à coluna ID do Conector.

O exemplo na tabela a seguir nostra a interação entre a propriedade AdapterInstanceEventFilter e o valor na coluna ID do Conector no armazenamento de eventos.

Se as propriedades EventTypeFilter e AdapterInstanceEventFilter forem ambas configuradas, o adaptador processará apenas os eventos que atendem a ambos os critérios. Ou seja, ele processa apenas os eventos cujo tipo é especificado na propriedade EventTypeFilter e cuja coluna ID do Conector corresponde à propriedade AdapterInstanceEventFilter.

Exemplo: Consulte o exemplo na tabela a seguir.
Globalizado Sim
Bidirecional suportado Sim
Tabela 3. Interação da Propriedade AdapterInstanceEventFilter com a Coluna ID do Conector no Armazenamento de Eventos
Propriedade AdapterInstanceEventFilter Coluna ID do Conector de um evento Resultado
null null O adaptador processa o evento.
null Instance1 O adaptador processa o evento, pois a coluna ID do Conector não está marcada.
Instance1 Instance1 O adaptador processa o evento.
Instance1 Instance2 O adaptador não processa o evento, pois os IDs da instância não são correspondentes.
Instance1 null O adaptador não processa o evento, pois os IDs da instância não são correspondentes.

Assegurar uma Única Entrega de Evento (AssuredOnceDelivery)

Esta propriedade especifica se é necessário fornecer entrega única garantida para eventos de entrada.

Tabela 4. Detalhes Sobre Assegurar uma Única Entrega de Evento
Exigido Sim
Valores possíveis

True
False

Default True
Tipo de Propriedade Booleana
Uso Quando esta propriedade é configurada como True, o adaptador fornece a entrega de evento único garantida, para que cada evento seja entregue apenas uma vez. Um valor de False não fornece entrega de evento única garantida, mas fornece melhor desempenho.

Quando esta propriedade for configurada como True, o adaptador tentará armazenar as informações de transação (XID) no armazenamento de eventos. Se estiver configurada como False, o adaptador não tentará armazenar as informações.

Esta propriedade será utilizada apenas se o componente de exportação for transacional. Se não for, nenhuma transação poderá ser utilizada, independentemente do valor desta propriedade.

Globalizado Não
Bidirecional suportado Não

Falha na conexão da interface de componente para teste (PingCompInterface)

Esta propriedade especifica o nome da interface do componente PeopleSoft Enterprise que o adaptador utiliza para validar uma conexão ao servidor PeopleSoft Enterprise.

Tabela 5. Falha na Conexão da Interface de Componente para Teste
Linha Explicação
Requerido SIM
Padrão O nome da primeira interface do componente na lista
Tipo de Propriedade Seqüência de caracteres
Utilização O nome da interface do componente que o adaptador utiliza para testar a conectividade para o servidor PeopleSoft Enterprise. Especifique um nome da interface do componente que já existe em seus aplicativos PeopleSoft Enterprise.
Globalizado Não
Bidirecional suportado Não

Nome da Interface do Componente para Notificação de Eventos (EventCIName)

Esta propriedade especifica o nome da interface do componente PeopleSoft Enterprise que o adaptador utiliza para processamento de entrada.

Tabela 6. Nome da Interface do Componente para Detalhes de Notificação de Eventos
Linha Explicação
Requerido SIM
Padrão IBM_EVENT_CI
Tipo de Propriedade Seqüência de caracteres
Utilização Um nome da interface do componente que o adaptador utiliza para processamento de entrada. Para utilizar o processamento de entrada, crie uma interface do componente especificamente para a notificação de eventos no PeopleSoft Enterprise.
Globalizado Não
Bidirecional suportado Não

Tipo de Entrega (DeliveryType)

Esta propriedade especifica a ordem na qual os eventos são entregues pelo adaptador para o componente da exportação.

Tabela 7. Detalhes do Tipo de Entrega
Exigido Não
Valores possíveis

ORDERED
UNORDERED

Default ORDERED
Tipo de Propriedade Sequência
Uso Os seguintes valores são suportados:
  • ORDERED: O adaptador entrega os eventos para o componente da exportação um por vez.
  • UNORDERED: O adaptador entrega todos os eventos para o componente da exportação de uma vez.

Se você configurar esta propriedade como UNORDERED, as propriedades Mínimo de conexões e Máximo de conexões deverão ser maiores que 1.

Globalizado Não
Bidirecional suportado Não

Delimitador para Chaves no Armazenamento de Eventos (EventKeyDelimiter)

Esta propriedade especifica o delimitador para o par nome-valor de chave do objeto na tabela de eventos.

Tabela 8. Delimitador para Chaves nos Detalhes de Armazenamento de Eventos
Linha Explicação
Requerido Não
Padrão =:
Tipo de Propriedade Seqüência de caracteres
Utilização Utilize esta propriedade para especificar um nome e valor de objeto a ser utilizado como uma chave de objeto no armazenamento de eventos.
Exemplo: CustomerID=2001
Globalizado Não
Bidirecional suportado Não

Não processar eventos que tenham um registro de data e hora no futuro (FilterFutureEvents)

Esta propriedade especifica se o adaptador filtrará futuros eventos, comparando o registro de data e hora em cada evento com a hora do sistema.

Tabela 9. Detalhes Sobre Não Processar Eventos que Tenham um Registro de Data e Hora no Futuro
Exigido Sim
Valores possíveis

True
False

Default False
Tipo de Propriedade Booleana
Uso

Se configurado como True, o adaptador comparará a hora de cada evento com a hora do sistema. Se o horário do evento for posterior ao horário do sistema, o evento não é entregue.

Se configurado como False, o adaptador entregará todos os eventos.

Globalizado Não
Bidirecional suportado Não

Tipos de eventos para processamento (EventTypeFilter)

Esta propriedade contém uma lista delimitada de tipos de eventos que indicam ao adaptador quais eventos devem ser entregues.

Tabela 10. Detalhes de Tipos de Eventos para Processamento
Exigido Não
Valores possíveis Uma lista delimitada por vírgulas (,) de tipos de objetos de negócios e operações
Default null
Tipo de Propriedade Sequência
Uso Os eventos são filtrados pelo tipo de objeto de negócios e operações. Se a propriedade estiver configurada, o adaptador entregará apenas os eventos que estiverem na lista. Um valor de null ou * indica que nenhum filtro será aplicado e que todos os eventos serão entregues ao componente de exportação.

Quando o conjunto de operações padrão (Criar/Atualizar/Excluir) não é preferencial, o adaptador fornece um recurso de pesquisa de eventos baseado em operação.

Por exemplo, se você selecionar a operação Criar|Atualizar, o adaptador pesquisará apenas os eventos com a operação Criar ou Atualizar para todos os objetos de negócios. A sequência padrão gerada para eventTypeFilter é *: Create|Update.

Sintaxe: BOName:Operation1|Operation2, BOName:Operation1|Operation2|Operation3
  • "," é usado para separar os objetos de negócios. Os objetos que não estão nessa lista são ignorados.
  • ":" é usado para separar o nome do objeto de negócios e o nome da operação.
  • "|" é usdo para separar as operações suportadas, como Criar, Excluir e Atualizar.
Exemplo:
  • Para receber eventos relacionados aos objetos de negócios Cliente e Pedido independentemente das operações, especifique esse valor: Customer,Order ou especifique esse valor para todas as operações suportadas: Customer:Create|Update|Delete,Order:Create|Update|Delete.
  • Para receber todos os eventos do objeto de negócios Cliente e os eventos Criar e Excluir do objeto de negócios Pedido, especifique esse valor: Customer,Order:Create|Delete
  • Para receber os eventos Criar e Excluir de todos os objetos de negócios, especifique esse valor: *:Create|Delete.
Nota: Nesta propriedade, é possível usar apenas as operações que são escolhidas ao selecionar objetos de negócios e serviços.

Se as propriedades EventTypeFilter e AdapterInstanceEventFilter forem ambas configuradas, o adaptador processará apenas os eventos que atendem a ambos os critérios. Ou seja, ele processa apenas os eventos cujo tipo é especificado na propriedade EventTypeFilter e cuja coluna ID do Conector corresponde à propriedade AdapterInstanceEventFilter.

Globalizado Não
Bidirecional suportado Não

Formato de Data Java para Registro de Data e Hora de Evento (DateFormat)

Esta propriedade especifica o formato utilizado para o registro de data e hora do evento.

Tabela 11. Formato de Data Java para Detalhes do Registro de Data e Hora do Evento
Linha Explicação
Requerido SIM
Padrão MM/dd/yy
Tipo de Propriedade Seqüência de caracteres
Utilização Esta propriedade é utilizada para formatar os valores de data do servidor PeopleSoft Enterprise.
Globalizado Não
Bidirecional suportado Não

Conexões Máximas (MaximumConnections)

Esta propriedade especifica o número máximo de conexões que o adaptador pode utilizar para entrega de evento de entrada.

Tabela 12. Detalhes das Conexões Máximas
Exigido Não
Default 1
Tipo de Propriedade Número Inteiro
Uso Apenas valores positivos são válidos. O adaptador considera que qualquer entrada positiva menor que 1 é igual a 1. Digitar um valor negativo ou 0 para esta propriedade pode resultar em erros no tempo de execução.
Globalizado Não
Bidirecional suportado Não

Mínimo de Conexões (MinimumConnections)

Esta propriedade especifica o número mínimo de conexões que o adaptador pode utilizar para entrega de evento de entrada.

Tabela 13. Detalhes do Mínimo de Conexões
Exigido Não
Default 1
Tipo de Propriedade Número Inteiro
Uso Apenas valores positivos são válidos. Qualquer valor menor que 1 é tratado como 1 pelo adaptador. Digitar um valor negativo ou 0 para esta propriedade pode resultar em erros de tempo de execução.
Globalizado Não
Bidirecional suportado Não

Intervalo entre períodos de sondagem (PollPeriod)

Esta propriedade especifica o período de tempo que o adaptador espera entre períodos de polling.

Tabela 14. Detalhes Sobre Intervalo Entre os Períodos de Sondagem
Exigido Sim
Valores possíveis Números inteiros maior que ou igual a 0.
Default 2000
Unidade de medida Milissegundos
Tipo de Propriedade Número Inteiro
Uso O período de sondagem é estabelecido na taxa fixa, o que significa que se a execução do ciclo de sondagem for atrasada por qualquer motivo (por exemplo, se um ciclo de sondagem anterior demorar mais do que o esperado para ser concluído), o próximo ciclo de sondagem ocorrerá imediatamente para constituir o tempo perdido causado pelo atraso.
Globalizado Não
Bidirecional suportado Não

Máximo de eventos em período de sondagem (PollQuantity)

Esta propriedade especifica o número de eventos que o adaptador entrega ao componente de exportação durante cada período de sondagem.

Tabela 15. Detalhes Sobre Máximo de Eventos em Período de Sondagem
Exigido Sim
Default 10
Tipo de Propriedade Número Inteiro
Uso O valor deve ser maior do que 0. Se este valor for aumentado, mais eventos são processados por período de sondagem, e o adaptador pode ser executado com eficiência menor. Se este valor for diminuído, menos eventos serão processados por período de sondagem e o desempenho do adaptador pode melhorar um pouco.
Globalizado Não
Bidirecional suportado Não

Número de vezes para se tentar a conexão com o sistema (RetryLimit)

Esta propriedade especifica o número de vezes que o adaptador tenta restabelecer uma conexão de entrada.

Tabela 16. Detalhes Sobre o Número de Vezes para Tentar Conexão com o Sistema
Exigido Não
Valores possíveis Número Inteiro Positivo
Default 0
Tipo de Propriedade Número Inteiro
Uso Apenas valores positivos são válidos.

Quando o adaptador encontra um erro que está relacionada à conexão de entrada, esta propriedade especifica o número de vezes que o adaptador tenta reiniciar a conexão. O valor 0 indica um número infinito de novas tentativas.

Globalizado Sim
Bidirecional suportado Não

Pare o adaptador quando um erro é encontrado durante a sondagem (StopPollingOnError)

Esta propriedade especifica se o adaptador pára a sondagem para eventos quando encontra um erro durante a sondagem.

Tabela 17. Detalhes Sobre a Parada do Adaptador Quando um Erro é Encontrado Durante a Sondagem
Exigido Não
Valores possíveis

True
False

Default False
Tipo de Propriedade Booleana
Uso

Se esta propriedade estiver configurada como True, o adaptador parará a sondagem quando encontrar um erro.

Se esta propriedade estiver configurada como False, o adaptador registrará em log uma exceção quando encontrar um erro durante a sondagem e continuar a sondagem.

Globalizado Não
Bidirecional suportado Não

Tempo entre novas tentativas em caso de falha de conexão do sistema (RetryInterval)

Quando o adaptador encontra um erro relacionado à conexão de entrada, esta propriedade especifica o período de tempo que o adaptador espera antes de tentar estabelecer uma nova conexão.

Tabela 18. Detalhes do Intervalo de Nova Tentativa
Exigido Sim
Default

60000 (1 minuto)

Unidade de medida Milissegundos
Tipo de Propriedade Número Inteiro
Uso Apenas valores positivos são válidos. Quando o adaptador encontra um erro relacionado à conexão de entrada, esta propriedade especifica o período de tempo que o adaptador espera antes de tentar estabelecer uma nova conexão.
Globalizado Não
Bidirecional suportado Não
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:59


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | rbp_peo_inbound_props_WMB