Atividade Chamar BAPI do SAP

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.

Nota: Para conectar-se ao Sistema SAP a partir do Studio, você deve fazer download e instalar os arquivos JAR do SAP e DLLs em sua máquina de desenvolvimento do Windows. Para obter informações adicionais, consulte Fazendo download e instalando os Arquivos Jar e os DLLs do SAP.

Incluindo uma Atividade Chamar BAPI do SAP na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta SAP.
  3. Arraste a atividade Chamar BAPI do SAP para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

Criando, Selecionando ou Editando um Terminal SAP

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e selecione uma das ações a seguir:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK. Acesse o procedimento Configurando a Atividade.
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um novo terminal: Selecione Novo. O painel Criar Terminal é exibido.
  2. Crie ou edite um terminal SAP.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. O painel Configurar é exibido.
  2. No campo Nome do Objeto, clique em Procurar.... A caixa de diálogo Lista de BAPIs é exibida.
  3. 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.
  4. Expanda o Objeto de Negócios para visualizar os métodos BAPI associados.
  5. Selecione um Objeto de Negócios e um Método e clique em OK.
  6. 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

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. O painel Tentar Novamente é exibido.
  2. 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

  1. 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.
  2. 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

  1. 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.
  2. 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.