Utilize o nó SAPInput para aceitar a entrada de um aplicativo SAP.
Este tópico contém as seguintes seções:
Utilize o nó SAPInput para aceitar a entrada de aplicativos SAP. Por exemplo, o nó SAPInput pode monitorar um sistema SAP para novas ordens de compra. Quando uma nova ordem de compra é criada, o nó SAPInput gera a árvore de mensagens que representa o objeto de negócios com os detalhes da nova ordem de compra. A árvore de mensagens é propagada para o terminal Out para que o restante do fluxo de mensagens possa utilizar os dados para atualizar outros sistemas ou aditar as alterações.
O nó SAPInput 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ó SAPInput 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 propagada do nó SAPInput 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ó.
O nó SAPInput preenche a lista de destino de rota para o rótulo com o nome da ligação do método. Se você incluir um nó RouteToLabel no fluxo de mensagens após o nó SAPInput, o nó RouteToLabel poderá utilizar o nome da ligação do método para rotear a mensagem para o caminho correto do fluxo de mensagens para processamento.
Você pode implementar apenas um nó de entrada que utiliza um componente adaptador específico para um grupo de execução, mas pode implementar muitos nós de entrada que utilizam diferentes componentes adaptadores para um grupo de execução.
mqsisetdbparms broker name -n adapter name -u user name -p password
Por
Exemplo:mqsisetdbparms BRK1 -n eis::SAPCustomerInbound.inadapter -u
sapuid -p ********
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.
Roteamento de IDoc Genérico
Usando o nó do SAPInput no modo de passagem, o WebSphere Message Broker pode receber qualquer IDoc e roteá-lo de acordo com o tipo de IDoc. Para obter informações adicionais, consulte Roteamento de IDoc Genérico. É possível usar um padrão para processar IDocs de vários tipos com um único ID do programa RFC sem precisar reimplementar ou redescobrir conjuntos de mensagens e adaptadores existentes, mesmo ao incluir novos tipos de IDoc. Para obter informações adicionais, consulte o padrão: Distribuição de Dados SAP para o WebSphere MQ: unidirecional (para IDoc). É possível visualizar padrões no centro de informações usando os links somente quando você usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit, ou quando usar o centro de informações on-line.
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.
Quando tiver colocado uma instância do nó SAPInput 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ó SAPInput, abrirá o assistente de Conexão do Adaptador. Todas as propriedades obrigatórias para as quais é necessário inserir um valor (as propriedades que não têm um valor-padrão definido) são marcadas com um asterisco.
Os terminais do nó SAPInput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Out | Os eventos do Objeto de Negócios do adaptador são enviados para o terminal Out. |
Falha | Se um erro ocorrer no nó SAPInput, 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. |
Catch | Os eventos do Objeto de Negócios são enviados para o terminal Catch se eles causarem uma exceção de não captura no fluxo de mensagens. Se o terminal Catch não estiver conectado, o processo de repetição será ativado para manipular o objeto de negócios. |
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 se você precisar 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ê inclui o fluxo de mensagens no arquivo BAR para implementá-lo).
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | O tipo de nó, SAPInput | O nome do nó. |
Descrição Breve | 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 | Sim | 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ó SAPInput recebe dados do sistema SAP, ele associa esses dados com um nome de método, dependendo do nome da operação de serviço que é designada para esse tipo de dados quando você executa o assistente Adapter Connection. O nó SAPInput tenta manipular os métodos que estão definidos no adaptador primário. Se o tipo de dados que é recebido não corresponder a nenhum dos métodos que estejam definidos no adaptador primário, o nó poderá manipular métodos que estejam definidos nos adaptadores secundários correspondentes que estejam implementados no mesmo grupo de execução. |
adapterComponent | |
Modo do adaptador secundário | Não | Sim | Nenhum | Especifica se o nó pode manipular métodos que estejam definidos nos adaptadores secundários. Se você definir a propriedade Modo do adaptador secundário como Nenhum, o nó manipula apenas métodos que estejam definidos no adaptador primário. Se o tipo de dados que é recebido não corresponder a nenhum dos métodos que estão definidos no adaptador primário, ocorrerá uma falha. Se você configurar essa propriedade como Todos os adaptadores no aplicativo, o nó poderá manipular métodos definidos nos adaptadores de entrada 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 entrada SAP que também esteja implementado como recurso independente. |
secondaryAdapterMode |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Tempo máximo de espera do cliente (s) | Não | Sim | 60 | O tempo (em segundos) para o sistema SAP aguardar o retorno de uma resposta por um nó
SAPReply. O valor-padrão
é 60 segundos. Se uma resposta for enviada para um nó SAPReply
após o tempo limite, o nó SAPReply emitirá uma exceção. Se o broker for interrompido enquanto o adaptador estiver aguardando um nó
SAPReply para fornecer uma resposta, será retornada uma falha do
sistema para o sistema SAP. Se você configurar esta propriedade como zero (0), o sistema SAP aguardará indefinidamente o retorno de uma resposta por um nó SAPReply. Esta propriedade é aplicável apenas no modo de retorno de chamada síncrono; ela não se aplica a BAPIs ou IDOCs assíncronos. Se você configurar esta propriedade para um nó SAPInput que esteja configurado com um adaptador que não seja para retorno de chamada síncrono, será emitido um aviso. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Configurar lista de destino | Não | Não | Selecionados | Especifica se deve incluir o nome de ligação do método para a lista de destino de rota para o rótulo. Se você selecionar esta caixa de opção, o nome da ligação do método será incluído para que seja possível utilizar um nó RouteToLabel no fluxo de mensagens após o nó SAPInput. |
Prefixo do rótulo | Não | Não | O prefixo a incluir no nome do método ao rotear para um rótulo. Inclua um prefixo do rótulo para evitar um conflito de nós do rótulo correspondentes quando incluir vários nós de entrada do WebSphere Adapters no mesmo fluxo de mensagens. Por padrão, não existe nenhum prefixo de rótulo, portanto, o nome do método e o nome do rótulo são idênticos. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | DataObject | O domínio utilizado para analisar a mensagem que chega. Por padrão, a mensagem propagada do nó SAPInput 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 e, posteriormente, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. 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 que chega. 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 que chega. Você não pode configurar esta propriedade. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Modo de Transação | Não | Não | Sim | O modo de transação neste nó de entrada determina se o restante dos nós no fluxo de mensagens são executados no ponto de sincronização. |
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Conjunto de instâncias adicionais | Não | Sim | Utilizar Conjunto Associado ao Fluxo de Mensagens | O conjunto do qual as instâncias adicionais são obtidas.
|
componentLevel |
Instâncias Adicionais | Não | Sim | 0 | O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. | additionalInstances |
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Tentar mecanismo novamente | Não | Não | Failure | Especifica como o processamento de nova tentativa é manipulado quando uma falha
é recuperada para o nó SAPInput.
|
|
Tentar limite novamente | Não | Sim | 0 | O número máximo de vezes que o processamento de repetição é desempenhado para repetição rápida. | retryThreshold |
Intervalo de repetições curtas | Não | Sim | 0 | O intervalo entre tentativas de repetições rápidas. | shortRetryInterval |
Intervalo de repetições longas | Não | Sim | 0 | O intervalo entre tentativas de repetições longas. | longRetryInterval |
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. |