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 Atividade de Destino. Além disso, se a BAPI contiver tabelas, os Esquemas XML representando as tabelas da BAPI serão exibidos como nós sob o parâmetro de entrada request no painel Atividade de Destino.

    O conector SAP também suporta uma conexão de terminal dinâmico com um sistema SAP diferente. Durante o tempo de execução, inclua parâmetros opcionais em sapConnectionProperties das entradas de mapa se quiser se conectar dinamicamente a um sistema SAP diferente do configurado no painel do terminal, se quiser se conectar ao mesmo sistema SAP com um nome de usuário e senha diferentes dos campos usados no painel do terminal ou se quiser um token de SSO diferente do incluído no painel do terminal. Os parâmetros de sapConnectionProperties estão descritos na seguinte tabela:
    Tabela 1. Propriedades da Conexão
    Parâmetro opcional Descrição
    Parâmetros sapConnectionProperties
    hostName Especifica o Endereço IP do nome da máquina que contém o sistema SAP.
    systemNumber Especifica o número que identifica a instância específica do sistema SAP ao qual o Studio deve se conectar. Seu administrador SAP deve fornecer estas informações.
    cliente Especifica um número que identifica o Studio e o Integration Appliance como um cliente para o sistema SAP. Seu administrador SAP deve fornecer estas informações.
    idioma Especifica a opção de idioma da mensagem para o SAP. Por exemplo, EN é o código ISO para inglês.
    Parâmetros basicAuthentication
    username Especifica o nome de usuário a ser usado ao se conectar com o sistema SAP.
    password Especifica a senha para o nome de usuário ao se conectar com o sistema SAP.
    Parâmetros ssoAuthentication
    ssotoken Especifica o token de conexão única (SSO).
    Parâmetros sncAuthentication
    sncmode Especifica se o modo Conexão de Rede Segura (SNC) está ativado.
    sncname Especifica o nome distinto da conexão SNC.
    parceiro Especifica o nome distinto do parceiro SNC.
    qop Especifica o nível de segurança do SNC.
    Certificado X509 Especifica o certificado X509 a ser usado como chamado de logon. Esse campo só será opcional se Autenticação baseada em nome de usuário/senha for usado com SNC.
    Parâmetros connectionPool
    maximumConnections Especifica as conexões SAP adicionais, até a quantidade especificada, que o Integration Appliance abre com base no carregamento de mensagem.
    maxIdleTime Especifica o número de minutos que uma conexão SAP pode ficar aberta e inativa antes de ser encerrada pelo Integration Appliance.
  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 Atividade de Partida. 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 Atividade de Partida.
  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.