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

Pré-requisitos

Download the SAP Java connector and dynamic library files (.dll file for Windows automation and .dylib file for macOS automation) from the SAP portal.

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. To connect the bot to your SAP system, from the Actions panel, find SAP BAPI > Connect action and add it to the Bot editor.
    1. In JCo: SAP Java Connector package, specify the path to the Java connector .jar file.
    2. In JCo DLL/DYLIB dependency, specify the path to the dynamic library file.
      .dll for Windows automation and .dylib for macOS automation.
    3. Choose Custom Application Server as Connection Type.
    4. In Application server host name, specify the host name of the SAP application server.
      Nota: As a best practice, use the Credential Vault to specify sensitive information such as host name, user name, and password.
    5. In System number, enter the instance number.
    6. In SAP instance system ID, enter the system ID.
    7. In Client number, enter the client number.
    8. In Logon language code, enter EN or the language specific to your system.
    9. In Router string, enter the SAP router string.
    10. In Username, enter your SAP username.
    11. In Password, enter your password.
    12. Run the bot to test the connection.
      If you specify the correct connection properties, the bot executes successfully.
  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 package 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.