Usando o pacote SAP BAPI, crie um bot que escreve dados para o banco de dados SAP.

Pré-requisitos

Baixe o conector SAP Java e os arquivos de biblioteca dinâmica (arquivo .dll para automação no Windows e arquivo .dylib para automação no macOS) no portal SAP.

Neste tutorial, você irá construir um bot que invoca o BAPI_FLCUST_CREATEFROMDATA do aplicativo de demonstração SAP Flight Data. Você usará o parâmetro de importação CUSTOMER_DATA para passar os dados do cliente para o BAPI. Quando executado, o bot cria um novo registro de cliente no banco de dados SAP e exibe o número de cliente devolvido pelo BAPI.

O tutorial demonstra como realizar as seguintes ações:
  • Use o comando Obter estrutura para definir valores para os parâmetros de importação.
  • Crie um novo registro em uma tabela SAP.
  • Receba uma resposta de um BAPI.

Procedimento

  1. Crie um bot chamado SAP-BAPI-CreateNewFlightCustomer.
    1. Faça login na Control Room.
    2. No painel da esquerda, clique em Automation (Automação).
    3. Clique no ícone Criar um bot.
    4. No campo Nome , insira SAP-BAPI-CreateNewFlightCustomer, e clique em Criar e editar.
  2. Para conectar o bot ao seu sistema SAP, a partir do painel Ações, encontre a ação SAP BAPI > Conecte e o adicione ao Editor de bot.
    1. Em JCo: Pacote SAP Java Connector, especifique o caminho para o arquivo .jar do conector Java.
    2. Em Dependência de JCo DLL/DYLIB, especifique o caminho para o arquivo da biblioteca dinâmica.
      .dll para automação no Windows e .dylib para automação no macOS.
    3. Escolha Servidor de aplicação personalizada como Tipo de conexão.
    4. Em Nome do servidor de aplicação, especifique o nome do host do servidor de aplicações SAP.
      Nota: Como melhor prática, use o Credential Vault para especificar informações sensíveis tais como nome do host, nome de usuário e senha.
    5. Em Número do sistema, digite o número da instância.
    6. Em ID do sistema de instância SAP, entre com o ID do sistema.
    7. Em Número do cliente, digite o número do cliente.
    8. Em Código do idioma de acesso, insira PT ou o idioma específico de seu sistema.
    9. Em String de roteador, insira a SAP do string do roteador.
    10. Em Nome de usuário, digite seu nome de usuário SAP.
    11. Em Senha, digite sua senha.
    12. Execute o bot para testar a conexão.
      Se você especificar as propriedades de conexão corretas, o bot será executado com sucesso.
  3. Para criar uma função, acrescente a ação SAP BAPI > Criar função.
    1. Em Nome do alias da função, digite createNewFlightCustomer.
    2. Em Nome de BAPI, digite BAPI_FLCUST_CREATEFROMDATA.
  4. Como o parâmetro CUSTOMER_DATA é do tipo estrutura, obtenha a estrutura do parâmetro de importação e atribua-o a um alias. Para tanto, acrescente a ação SAP BAPI > Obter estrutura.
    1. Em Nome do alias da função, digite createNewFlightCustomer.
    2. Em Nome da estrutura, digite CUSTOMER_DATA.
    3. Para armazenar a estrutura recuperada como um alias, clique na guia Alias em Destino.
    4. Em Criar alias de estrutura, digite CustomerData.
      Você usará o alias para definir valores para os campos de importação dentro da estrutura recuperada.
  5. Para definir o valor para o campo CUSTNAME, acrescente a ação SAP BAPI > Definir valor de campo.
    1. Em Nome do alias da função, digite createNewFlightCustomer.
    2. Em Fonte, clique na guia Estrutura.
    3. Em Alias da estrutura, digite CustomerData.
    4. Em Nome do campo, digite CUSTNAME.
    5. Em Valor do campo, insira John Doe.
  6. Repita a Etapa 5 para adicionar e configurar a ação Definir valor de campo para cada um dos seguintes campos:
    Nome do campo Valor do campo
    STREET testStreet
    POSTCODE 101001
    CITY testCity
    COUNTR US
    COUNTR 00000000
    EMAIL test@example.com
    CUSTTYPE P
  7. Para executar BAPI_FLCUST_CREATEFROMDATA, adicione a ação SAP BAPI > Executar função.
    1. Em Nome do alias da função, digite createNewFlightCustomer.
    Nota: Se você quiser BAPI_FLCUST_CREATEFROMDATA para gravar os dados no banco de dados SAP, selecione as opções Sequência final e Comprometer transação. Se você selecionar a opção Sequência final, certifique-se de selecionar a opção Iniciar a sequência na ação Criar função.

    O bot de amostra criado com a ajuda deste tutorial destina-se a demonstrar como os BAPIs Create() funcionam quando o pacote BAPI SAP é utilizado. Não se destina a modificar o banco de dados.

    O BAPI atribui e retorna um número de cliente depois que um novo registro de cliente é criado.
  8. Para obter o número em uma variável, acrescente a ação SAP BAPI > Obter valor de campo.
    1. Em Nome do alias da função, digite createNewFlightCustomer.
    2. Em Fonte, clique na guia Função.
    3. Em Nome do campo, digite CUSTOMERNUMBER
    4. Em Salvar o resultado para uma variável, crie uma variável chamada strCustomerNumber clicando em (x) e selecione a variável.
  9. Para exibir o número do cliente, acrescente a ação Caixa de mensagens.
    1. Em Digite a mensagem a ser exibidaselecione o strCustomerNumber variável.
  10. Salve e execute o bot.