Exemplo de uso do comando Obter estrutura do pacote SAP BAPI

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

Pré-requisitos

Faça o download do conector SAP Java e da DLL no site da SAP.

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. 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 da JCo DLL, especifique o caminho para o arquivo DLL.
    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 as propriedades de conexão especificadas estiverem 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 getFlightListByAirline.
    2. Em Nome de BAPI, digite 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, digite 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, digite getFlightListByAirline.
    2. Em Nome da estrutura, digite 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, digite getFlightListByAirline.
    2. Em Fonte, clique na guia Estrutura.
    3. Em Alias da estrutura, digite destinationFrom.
    4. Em Nome do campo, digite 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, digite getFlightListByAirline.
    2. Em Fonte, clique na guia Estrutura.
    3. Em Alias da estrutura, digite destinationFrom.
    4. Em Nome do campo, digite 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, digite 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, digite 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.