Utilize o nó SAPRequest para enviar pedidos para um aplicativo SAP.
Este tópico contém as seguintes seções:
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:
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.
mqsisetdbparms broker name -n adapter name -u user name -p PASSWORD
Por
Exemplo:mqsisetdbparms BRK1 -n
eis::SAPCustomerOutbound.outadapter -u sapuid -p ********
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.
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).
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. |
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 |
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. |
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.
Para obter informações adicionais sobre transacionalidade, consulte Confirmação da Transação SAP BAPI. |
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. |
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. |
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. |