Ao usar o package SAP BAPI, crie um bot que introduz uma estrutura para obter dados.

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 a BAPI_FLIGHT_GETLIST do aplicativo de demonstração SAP Flight Data. Quando executado, o bot chama a função BAPI inserindo uma identificação de companhia aérea e detalhes de destino, obtém uma lista de voos e escreve os dados de resposta em um arquivo CSV.

Você usará os seguintes parâmetros de importação para limitar sua busca:
  • AIRLINE: Use o parâmetro para passar a identificação da companhia aérea.
  • DESTINATION_FROM: Use o parâmetro para obter a estrutura e passar o nome da cidade e o ID do aeroporto.
O tutorial tem o objetivo de demonstrar como realizar as seguintes ações:
  • Obter a estrutura de um parâmetro de importação.
  • Definir os valores para os campos na estrutura recuperada.
  • Obter os dados de resposta em uma tabela com base nos dados de entrada.

Procedimento

  1. Crie um Task Bot chamado SAP-BAPI-FlightListReport.
    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-FlightListReport 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, insira getFlightListByAirline.
    2. Em Nome BAPI, insira BAPI_FLIGHT_GETLIST.
  4. Para filtrar os dados pelo nome de uma companhia aérea, acrescente a ação SAP BAPI > Definir valor de campo.
    1. Em Nome do alias da função, insira getFlightListByAirline.
    2. Clique na guia Função.
    3. Em Nome do campo, insira AIRLINE como o nome do parâmetro de entrada.
    4. Em Valor do campo, insira AZ.
  5. Para limitar a seleção pelo aeroporto e pela cidade de destino, obtenha primeiro a estrutura do parâmetro de importação DESTINATION_FROM e depois defina valores para os campos na estrutura recuperada. Para tanto, acrescente a ação SAP BAPI > Obter estrutura.
    1. Em Nome do alias da função, insira getFlightListByAirline.
    2. Em Nome da estrutura, insira DESTINATION_FROM .
    3. Para atribuir a estrutura recuperada a um alias, clique na guia Alias em Destino e insira destinationFrom em Criar alias de estrutura.
      Agora você pode usar o alias para definir valores para os campos na estrutura recuperada.
  6. Para definir um valor para o campo ID do AEROPORTO no parâmetro DESTINATION_FROM, adicione a ação SAP BAPI > Definir valor de campo.
    1. Em Nome do alias da função, insira getFlightListByAirline.
    2. Em Fonte, clique na guia Estrutura.
    3. Em Alias da estrutura, insira destinationFrom.
    4. Em Nome do campo, insira AIRPORTID.
    5. Em Valor do campo, insira FCO.
  7. Para estabelecer um valor para o campo CITY no parâmetro DESTINATION_FROM, adicione a ação SAP BAPI > Definir valor de campo.
    1. Em Nome do alias da função, insira getFlightListByAirline.
    2. Em Fonte, clique na guia Estrutura.
    3. Em Alias da estrutura, insira destinationFrom.
    4. Em Nome do campo, insira CITY.
    5. Em Valor do campo, insira ROME.
  8. Para executar BAPI_FLIGHT_GETLIST, adicione a ação SAP BAPI > Executar função.
    1. Em Nome do alias da função, insira getFlightListByAirline.
  9. Para obter os dados filtrados da tabela FLIGHT_LIST, adicione a ação SAP BAPI > Obter tabela.
    1. Em Nome do alias da função, insira getFlightListByAirline.
    2. Em Nome da tabela, click na guia FLIGHT_LIST .
    3. Em Destino, clique em Variável para armazenar os dados da tabela recuperados na memória.
    4. Em Salvar o resultado em uma variável, crie uma variável chamada tblFlightList clicando em (x).
  10. Para gravar os dados da tabela recuperada em um arquivo CSV, adicione a ação Tabela de dados > Gravar para arquivo.
    1. Em Tabela de dados selecione tblFlightList.
    2. Em Digitar o nome do arquivo, especifique o caminho para o arquivo CSV, para o qual você deseja escrever os dados.
    3. Selecione Criar pastas/arquivos, se não houver.
    4. Clique em Substituir arquivo existente.
  11. Salve e execute o bot.