Use a atividade Chamar BAPI do SAP para
chamar um Business Object Method (BAPI), que é ativado remotamente no
Terminal SAP especificado, durante o tempo de execução.
Incluindo uma Atividade Chamar BAPI do SAP na Orquestração
- Crie ou
abra uma orquestração. Uma representação gráfica
da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta SAP.
- Arraste a atividade Chamar BAPI do SAP para
a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal SAP
- Clique na tarefa Selecionar Terminal na
Lista de Verificação e selecione uma das ações a
seguir:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
Acesse o procedimento Configurando a Atividade.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. A área de janela Editar
Terminal é exibida.
- Crie um novo terminal: Selecione Novo. O
painel Criar Terminal é exibido.
- Crie ou edite um terminal SAP.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação.
O painel Configurar é exibido.
- No campo Nome do Objeto, clique em Procurar....
A caixa de diálogo Lista de BAPIs é exibida.
- Procure um Objeto de Negócios. Clique em um Objeto de Negócios na
lista e insira os caracteres iniciais do nome do Objeto de Negócios.
- Expanda o Objeto de Negócios para visualizar os métodos BAPI associados.
- Selecione um Objeto de Negócios e um Método e clique em OK.
- Selecione das seguintes Opções de Transação:
- Fazer Nada (Transação tratada pelo BAPI
diretamente) - Durante o tempo de execução, o Integration
Appliance que chama o BAPI não executa o processamento de transações. Se uma transação estiver associada à
BAPI, a BAPI deverá tratar completamente a transação
- Confirmar transação após conclusão - Durante o
tempo de execução, o Integration Appliance chama o BAPI e aguarda uma
mensagem de retorno do Sistema SAP. O código de retorno da mensagem
retornada do Sistema SAP determina se o Integration Appliance
envia uma outra mensagem solicitando que o Sistema SAP confirme ou
retroceda a transação:
- Se o código de retorno transmitido de volta da BAPI indicar sucesso,
o Integration Appliance enviará uma outra mensagem solicitando que o
Sistema SAP confirme a transação e iniciará imediatamente o processamento
da próxima atividade na orquestração.
- Se o código de retorno transmitido de volta da BAPI indicar falha,
o Integration Appliance enviará um pedido de retrocesso para o Sistema SAP
e iniciará imediatamente o processamento da próxima atividade na orquestração.
- Confirmar transação e aguardar após conclusão - Durante
o tempo de execução, o Integration Appliance chama a BAPI e aguarda
uma mensagem de retorno do Sistema SAP. O código de retorno da mensagem
retornada do Sistema SAP determina se o Integration Appliance
envia uma outra mensagem solicitando que o Sistema SAP confirme ou
retroceda a transação:
- Se o código de retorno transmitido de volta da BAPI indicar sucesso,
o Integration Appliance enviará uma outra mensagem solicitando que o
Sistema SAP confirme a transação. A orquestração aguardará até que o
Sistema SAP envie uma segunda mensagem indicando que a transação
foi confirmada, antes de processar a próxima atividade na orquestração.
- Se o código de retorno transmitido de volta da BAPI indicar falha,
o Integration Appliance enviará um pedido de retrocesso para o Sistema.
A orquestração aguardará até que o Sistema SAP envie uma segunda mensagem
indicando que o retrocesso da transação ocorreu, antes de
processar a próxima atividade na orquestração.
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação.
O painel Tentar Novamente é exibido.
- Configure as opções de nova tentativa para se conectar a um Sistema SAP. A
tabela a seguir descreve as opções de nova tentativa para se conectar a um Sistema
SAP:
Opções de Nova Tentativa |
Descrição |
1) Aguardar ___ segundos entre cada nova tentativa. |
Especifica o número de segundos que o Integration Appliance
aguarda antes de tentar estabelecer uma conexão com o Sistema SAP. |
2) Tentar se conectar ___ vezes antes de falhar. |
Especifica o número máximo de vezes que o Integration Appliance
tenta estabelecer uma conexão com o Sistema SAP antes de emitir um erro e
parar o processamento da tarefa de orquestração atual. Se você implementar
uma orquestração que contém uma atividade Chamar BAPI do
SAP e o Integration Appliance não puder se conectar ao Sistema
SAP especificado, o Integration Appliance registrará os erros de conexão
como avisos nos logs do sistema e de orquestração até o valor de contagem
de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance
registra um erro nos logs do sistema e da orquestração e para o processamento
da tarefa de orquestração atual. Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo
e terceiro erros de conexão aparecem no log do sistema como avisos.
O
Integration Appliance registra o quarto erro de conexão como um erro e
para o processamento da tarefa de orquestração atual. |
Mapeando as Entradas da Atividade
- Selecione a tarefa Mapear Entradas na Lista de Verificação.
Os Esquemas XML gerados a partir dos parâmetros de entrada do BAPI são
exibidos como nós sob o parâmetro de entrada
request no painel Para
Atividade. Além disso, se o BAPI contiver tabelas, os Esquemas
XML que representam as tabelas do BAPI serão exibidos como nós sob o
parâmetro de entrada request no painel
Para Atividade.
- Crie um mapa entre as variáveis de orquestração e os parâmetros e
tabelas de entrada de BAPI. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.
Os valores devem ser fornecidos no tempo de execução para quaisquer
elementos obrigatórios dos parâmetros de entrada ou tabelas de BAPI.
Um valor pode ser fornecido, especificando um valor-padrão
para o elemento ou vinculando o elemento ao nó de entrada. Durante o tempo
de execução, se nenhum valor for fornecido para um elemento obrigatório, a
atividade lançará uma exceção durante o tempo de execução que será
relatada pelo Web Management Console (WMC).
Se um valor não for fornecido no tempo de execução para um elemento
opcional dos parâmetros de entrada ou tabelas de BAPI, nenhuma exceção
será lançada durante o tempo de execução.
Mapeando as Saídas da Atividade
- Selecione a tarefa Mapear Saídas na Lista de Verificação.
O Esquema XML gerado a partir dos tipos de retorno do BAPI é exibido como
nós sob o parâmetro de saída response no painel
Da Atividade. Além disso, se o BAPI contiver
tabelas, os Esquemas XML que representam as tabelas serão exibidos como
nós sob o nó response em Da
Atividade.
- Crie um mapa entre os parâmetros de saída e as tabelas de BAPI e as
variáveis de orquestração. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.
Nota Sobre Como Implementar uma Orquestração de SAP
Antes
de poder implementar uma orquestração com atividades SAP usando o WMC,
o Integration Appliance deve primeiro estar apto a estabelecer uma conexão
com o Sistema SAP. Se o Integration Appliance não puder estabelecer
a conexão com o Sistema SAP, a orquestração não será implementada.