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.
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. |
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 |
Esta propriedade controla se a instância do adaptador processa eventos específicos no armazenamento de eventos.
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 |
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. |
Esta propriedade especifica se é necessário fornecer entrega única garantida para eventos de entrada.
Exigido | Sim |
---|---|
Valores possíveis | True |
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 |
Esta propriedade especifica o nome da interface do componente PeopleSoft Enterprise que o adaptador utiliza para validar uma conexão ao servidor PeopleSoft Enterprise.
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 |
Esta propriedade especifica o nome da interface do componente PeopleSoft Enterprise que o adaptador utiliza para processamento de entrada.
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 |
Esta propriedade especifica a ordem na qual os eventos são entregues pelo adaptador para o componente da exportação.
Exigido | Não |
---|---|
Valores possíveis | ORDERED |
Default | ORDERED |
Tipo de Propriedade | Sequência |
Uso | Os seguintes valores são suportados:
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 |
Esta propriedade especifica o delimitador para o par nome-valor de chave do objeto na tabela 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 |
Esta propriedade especifica se o adaptador filtrará futuros eventos, comparando o registro de data e hora em cada evento com a hora do sistema.
Exigido | Sim |
---|---|
Valores possíveis | True |
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 |
Esta propriedade contém uma lista delimitada de tipos de eventos que indicam ao adaptador quais eventos devem ser entregues.
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
|
Exemplo: |
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 |
Esta propriedade especifica o formato utilizado para o 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 |
Esta propriedade especifica o número máximo de conexões que o adaptador pode utilizar para entrega de evento de entrada.
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 |
Esta propriedade especifica o número mínimo de conexões que o adaptador pode utilizar para entrega de evento de entrada.
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 |
Esta propriedade especifica o período de tempo que o adaptador espera entre períodos de polling.
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 |
Esta propriedade especifica o número de eventos que o adaptador entrega ao componente de exportação durante cada 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 |
Esta propriedade especifica o número de vezes que o adaptador tenta restabelecer uma conexão de entrada.
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 |
Esta propriedade especifica se o adaptador pára a sondagem para eventos quando encontra um erro durante a sondagem.
Exigido | Não |
---|---|
Valores possíveis | True |
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 |
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.
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 |