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

SAPRequest

Utilize o nó SAPRequest para enviar pedidos para um aplicativo SAP.

Este tópico contém as seguintes seções:

Propósito

Use o nó SAPRequest para enviar pedidos aos aplicativos SAP. Por exemplo, o nó SAPRequest pode solicitar informações de um EIS (Enterprise Information System) SAP. Um objeto de negócios do cliente é enviado ao SAP, fazendo o SAP 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ó SAPRequest podem ser utilizadas pelo restante do fluxo de mensagens. O nó SAPRequest pode enviar e receber dados de negócios.

O nó SAPRequest 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:

Ícone do nó SAPRequest

Utilizando o Nó SAPRequest em um Fluxo de Mensagens

O nó SAPRequest precisa de um componente adaptador para funcionar corretamente. Você configura o componente utilizando a propriedade do nó Componente Adaptador e as definições de objeto de negócios, que são armazenadas no conjunto de mensagens que você referencia a partir do nó. Por isso, é necessário fornecer um conjunto de mensagens. Por padrão, a mensagem que é propagada a partir do nó SAPRequest está no domínio DataObject, de forma que a propriedade Domínio de Mensagem é configurada como DataObject. Você não pode especificar um domínio diferente. O nó detecta automaticamente o tipo de mensagem.

Para maximizar o desempenho e evitar conversão de dados desnecessária, assegure-se de que as mensagens transmitidas para o nó SAPRequest contenham os tipos de dados corretos. O domínio DataObject é o domínio padrão ao analisar mensagens produzidas pelo nó SAPRequest. Entretanto, ao transmitir dados para o nó SAPRequest (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ó SAPRequest suporta transações locais usando o Gerenciador de Transações Locais do broker.

É possível implementar vários nós de pedido do WebSphere Adapters que utilizam o mesmo componente adaptador em um grupo de execução.

O nó SAPRequest pode usar uma identidade que esteja presente em uma mensagem de entrada e propagá-la para o SAP, usando a propriedade Propagar no perfil de segurança que está definido no nó. Para obter informações adicionais, consulte Propagando Credenciais de Segurança para um Pedido do SAP.

Para manter efetivamente o conjunto de conexões com o SAP, você pode configurar um valor de tempo limite de conexão em um serviço configurável. Por padrão, a propriedade connectionIdleTimeout é configurada para zero, indicando que não ocorre nenhum tempo limite. Entretanto, novas conexões com o SAP são abertas com diferentes IDs de usuário, portanto, não configure esta propriedade como zero se estiver usando propagação de identidade. Para obter informações adicionais, consulte Configurando Conexões EIS para Expirarem Após um Tempo Especificado.

É possível utilizar o comando mqsisetdbparms no seguinte formato para configurar um nome de conta com um nome de usuário e senha para o Adapter para SAP Software. O comando mqsisetdbparms armazena a senha no formulário de distinção entre maiúsculas e minúsculas. Entretanto, quando a GUI do SAP configura uma senha, ela automaticamente converte a senha em maiúsculas. Assim, especifique uma senha em maiúsculas para conectar-se ao sistema SAP.
mqsisetdbparms broker name -n adapter name -u user name -p PASSWORD
Por Exemplo:
mqsisetdbparms BRK1 -n
eis::SAPCustomerOutbound.outadapter -u sapuid -p ********
Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Utilizando serviços configuráveis para nós SAP

Os nós SAP podem conseguir detalhes da conexão SAP tanto do componente adaptador quanto de um serviço cofigurá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 o SAP, consulte Alterando os detalhes da conexão para adaptadores SAP.

Terminais e Propriedades

Quando tiver colocado uma instância do nó SAPRequest 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ê clicar duas vezes em um nó SAPRequest, 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ó SAPRequest 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 um erro ocorrer no nó SAPRequest, a mensagem será propagada para o terminal de Falha. 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ó. As colunas com cabeçalho M indicam se a propriedade é obrigatória (marcada com um asterisco no painel se você desejar inserir um valor quando nenhum padrão estiver definido); as colunas com cabeçalho C indicam se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Nome de nó Não Não O tipo de nó, SAPRequest 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.
As propriedades Básicas do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão 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ó SAPRequest recebe dados do sistema SAP, ele associa esses dados com um nome de método. O nó SAPRequest 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ó SAPRequest 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 nos adaptadores de saída SAP correspondentes que estejam implementados 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 SAP 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. Essa propriedade lista os métodos definidos pelo adaptador. Você pode substituir essa propriedade configurando o nome do método na subárvore LocalEnvironment.Adapter. Para obter informações adicionais, consulte Estrutura em árvore do ambiente local.

Os nomes do método correspondem aos nomes da Operação de Serviço, que são configurados pelo assistente Adapter Connection. Na maioria dos casos, os nomes são baseados no nome do serviço que está sendo descoberto (por exemplo, um BAPI).

defaultMethod
As propriedades Análise de Mensagem de Resposta do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão 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 propagada do nó SAPRequest 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.
As propriedades Transacionalidade do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Modo de Transação Não Não Automático Especifica como as atualizações são manipuladas.
  • Se selecionar Sim, o nó SAPRequest faz parte da transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
  • Se selecionar Não, o nó SAPRequest não faz parte da transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
  • Se selecionar Automático, o nó SAPRequest utiliza o valor configurado no nó de entrada que orienta o fluxo de mensagens. Por exemplo, se o fluxo de mensagens for conduzido por um nó SAPInput, o SAPRequest assumirá o Modo de Transação configurado no nó SAPInput.

Para obter informações adicionais sobre transacionalidade, consulte Confirmação da Transação SAP BAPI.

As propriedades Pedido do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão 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ó SAPRequest 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ó SAPRequest para o EIS.
As propriedades Resultado do nó SAPRequest são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Local de dados de saída Não Não $OutputRoot O local da árvore de mensagens para o qual o nó SAPRequest 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 esta caixa de opção, uma nova cópia do ambiente local será criada na árvore (em cada nó no fluxo de mensagens) e ela será preenchida com o conteúdo do ambiente local do nó precedente. Portanto, se um nó alterar o ambiente local, os nós anteriores no fluxo não verão essas alterações porque eles possuem 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 serão vistas pelos nós de envio de dados.

As propriedades Monitoramento do nó são descritas na tabela a seguir.
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.

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:28:37


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