Utilize o nó SiebelRequest para interagir com um aplicativo Siebel.
Este tópico contém as seguintes seções:
Utilize o nó SiebelRequest para interagir com aplicativos Siebel. Por exemplo, um nó SiebelRequest solicita informações de um EIS (Enterprise Information System) Siebel. Um objeto de negócios do cliente é enviado ao Siebel, fazendo o Siebel recuperar informações sobre um cliente, como detalhes de um endereço e de uma conta. As informações de resposta que são recuperadas pelo nó SiebelRequest podem ser utilizadas pelo restante do fluxo de mensagens. O nó SiebelRequest pode enviar e receber dados de negócios.
O nó SiebelRequest está contido no repositório WebSphere Adapters da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
Para funcionar corretamente, o nó SiebelRequest precisa de um componente adaptador, que você configura utilizando a propriedade do nó Componente Adaptador e definições do objeto de negócios, que estão armazenadas no conjunto de mensagens ao qual você faz referência a partir do nó. Por isso, é necessário fornecer um conjunto de mensagens. Por padrão, a mensagem propagada do nó SiebelRequest está no domínio DataObject, portanto, a propriedade Domínio de Mensagem está configurada como DataObject. Você não pode especificar um domínio diferente. O tipo de mensagem é detectado automaticamente pelo nó.
Para maximizar o desempenho e evitar conversão de dados desnecessária, assegure-se de que as mensagens transmitidas para o nó SiebelRequest contenham os tipos de dados corretos. O domínio DataObject é o domínio padrão ao analisar mensagens produzidas pelo nó SiebelRequest. Entretanto, ao transmitir dados para o nó SiebelRequest (por exemplo, usando um nó MQInput), o uso de um domínio diferente pode melhorar o desempenho. Por exemplo, use o analisador XMLNSC com o nó MQInput para analisar mensagens XML.
O nó SiebelRequest suporta transações locais usando o gerenciador de transação local para o broker e transações globais usando o coordenador de ponto de sincronização externo para o broker.
Para manter efetivamente o conjunto de conexões com o Siebel, você pode configurar um valor de tempo limite de conexão em um serviço configurável. Para obter informações adicionais, consulte Configurando Conexões EIS para Expirarem Após um Tempo Especificado.
É possível implementar vários nós de pedido do WebSphere Adapters que utilizam o mesmo componente adaptador em um grupo de execução.
mqsisetdbparms broker name -n adapter name -u user name -p password
Por
Exemplo:mqsisetdbparms BRK1 -n
eis::SiebelCustomerOutbound.outadapter -u siebeluid -p ********
Usando serviços configuráveis para nós Siebel
Os nós Siebel podem obter detalhes da conexão Siebel do componente adaptador ou de um serviço configurável. Usando um serviço configurável, é possível alterar os detalhes da conexão para um adaptador sem a necessidade de reimplementar o adaptador. Para obter detalhes adicionais sobre como criar, alterar, relatar e excluir os serviços configuráveis para Siebel, consulte Alterando Detalhes da Conexão para Adaptadores Siebel.
Também é possível se conectar a versões diferentes do Siebel criando um serviço configurável EISProviders customizado e configurando o local dos arquivos de biblioteca apropriados. Para informações adicionais, consulte Conectando-se a Versões Diferentes do Siebel.
Quando tiver colocado uma instância do nó SiebelRequest em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Se você der um clique duplo em um nó SiebelRequest, abrirá o assistente de Conexão do Adaptador. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
Os terminais do nó SiebelRequest são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita o objeto de negócios de pedido. |
Saída | O terminal de saída para o qual a respostaobjeto de negócios é enviada se representar a conclusão bem-sucedida do pedido e se for necessário processamento adicional neste fluxo de mensagens. |
Failure | Se ocorrer um erro no nó SiebelRequest, a mensagem é propagada para o terminal Failure. Informações sobre o erro e eventos do objeto de negócios também podem ser propagadas ao terminal de Falha. |
As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco no painel caso seja necessário inserir um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando incluir o fluxo de mensagens no arquivo BAR para implementá-lo).
As propriedades Descrição do nó SiebelRequest são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | O tipo de nó, por exemplo, SiebelRequest | O nome do nó. |
Short description | Não | Não | Uma breve descrição do nó. | |
Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Componente adaptador primário | Sim | Não | O nome do componente adaptador que contém propriedades de configuração
para o adaptador. Digite um nome de um arquivo do adaptador ou clique em Procurar
para selecionar um arquivo do adaptador da lista de arquivos que estão disponíveis nos projetos
do conjunto de mensagens referidos. Quando o nó SiebelRequest recebe dados do sistema Siebel, ele associa esses dados com um nome de método. O nó SiebelRequest tenta chamar métodos que são definidos no adaptador primário. Se o método não for definido no adaptador primário, o nó pode chamar métodos que sejam definidos nos adaptadores secundários correspondentes que são implementados no mesmo grupo de execução. |
||
Modo do adaptador secundário | Não | Sim | Nenhum | Especifica se o nó pode chamar métodos que sejam definidos nos adaptadores secundários. Se você configurar a propriedade Modo do adaptador secundário como Nenhum, o nó SiebelRequest chama apenas métodos que estão definidos no adaptador primário. Se o método não estiver definido no adaptador primário, ocorrerá um erro. Se você configurar essa propriedade como Todos os adaptadores no aplicativo, o nó poderá chamar métodos definidos em qualquer adaptador de saída Siebel que esteja implementado no mesmo aplicativo. Se o nó for implementado como recurso independente (ou seja, não está contido em um aplicativo), ele poderá chamar métodos definidos em qualquer adaptador de saída Siebel que também esteja implementado como recurso independente. |
secondaryAdapterMode |
Método padrão | Sim | Sim | A ligação de método padrão a ser utilizada. | defaultMethod |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | DataObject | O domínio que é utilizado para analisar a mensagem de resposta. Por padrão, a mensagem de resposta que é propagada a partir do nó SiebelRequest está no domínio DataObject. Você não pode especificar um domínio diferente. |
Conjunto de Mensagens | Sim | Não | Configurar automaticamente | O nome do conjunto de mensagens no qual a mensagem que chega
é definida. Este campo é configurado automaticamente na propriedade Componente do Adaptador. Se você configurar esta propriedade, então, subseqüentemente atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, um aviso será emitido. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto de conjunto de mensagens. |
Tipo de Mensagem | Não | Não | O nome da mensagem de resposta. O nó detecta o tipo de mensagem automaticamente. Você não pode configurar esta propriedade. | |
Formato de Mensagem | Não | Não | O nome do formato físico da mensagem de resposta. Você não pode configurar esta propriedade. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Modo de Transação | Não | Não | Não | Essa propriedade especifica que as atualizações são executadas de forma independente, não como parte de uma transação local. Não é possível alterar esta propriedade. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Local do Método | Sim | Não | $LocalEnvironment/Adapter/MethodName | O local do método de negócios (como createPurchaseOrder ou deletePurchaseOrder) que é usado para ativar o nó SiebelRequest para executar uma ação no sistema externo. |
Local dos Dados | Sim | Não | $Body | O local na árvore de mensagens que chega do qual os dados são recuperados para formar o pedido enviado do nó SiebelRequest para o EIS. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Local de dados de saída | Não | Não | $OutputRoot | O local da árvore de mensagens para o qual o nó SiebelRequest envia saída. |
Copiar ambiente local | Não | Não | Selecionado | Essa propriedade controla como o ambiente local
é copiado para a mensagem de saída. Se você selecionar a caixa de opção, em cada nó
no fluxo de mensagens, uma nova cópia do ambiente local é criada na árvore e preenchida com o conteúdo do ambiente local do nó precedente. Portanto, se um nó alterar o ambiente local,
os nós de envio de dados não vêem essas alterações, pois eles têm suas próprias cópias. Esse comportamento pode ser um problema
se você estiver utilizando um nó FlowOrder,
ou se você utilizar o comando propagate em um nó Compute. Se você desmarcar a caixa de opção, cada nó não gera sua própria cópia do ambiente local, mas utiliza o ambiente local que é transmitido a ele pelo nó anterior. Portanto, se um nó alterar o ambiente local, essas alterações são vistas pelos nós de envio de dados. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Eventos | Não | Não | Nenhum | Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar,
e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes. É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado. |