Ir para o conteúdo

Guia de execução de BAPI do SAP para Jitterbit App Builder

Visão geral

Uma BAPI (Business Application Programming Interface) é a interface principal do SAP para ler e atualizar dados em um sistema SAP, podendo ser chamada tanto de dentro do SAP quanto externamente, por meio do protocolo RFC ou da tecnologia ALE/IDoc. As BAPIs são definidas no Business Object Repository (BOR) do SAP como métodos de tipos de objetos comerciais do SAP que realizam funções comerciais específicas, e são implementadas como módulos de função habilitados para RFC criados no Function Builder do ABAP Workbench. Para mais informações de contexto, consulte a introdução a BAPIs do SAP.

Este guia descreve como executar módulos de função BAPI do SAP a partir do App Builder: conectar um servidor de dados ao sistema SAP, criar tabelas de staging locais que refletem a estrutura da BAPI, preenchê-las com os dados a enviar e depois disparar a execução da BAPI por RFC.

Pré-requisitos

Antes de executar BAPIs a partir do App Builder, você precisa de:

  • Uma compilação de versão do App Builder que inclua componentes SAP adicionais. Cada versão compilada lançada tem seu próprio download thirdpartysap em https://download.jitterbit.com/vinyl/<version>/vinyl-<version>-thirdpartysap-win.zip (por exemplo, https://download.jitterbit.com/vinyl/4.66.0.39333/vinyl-4.66.0.39333-thirdpartysap-win.zip para a versão 4.66.0+39333). Este pacote coloca as DLLs do SAP (Dynamic Link Libraries) que o App Builder precisa para se conectar ao SAP na pasta App Builder/Bin.

  • Uma conexão de servidor de dados com o sistema SAP no qual você deseja chamar BAPIs, com Type definido como SAP ABAP over RFC. Esta conexão usa o CData ADO.NET Provider para SAP ERP, que por sua vez requer os próximos dois pré-requisitos. Consulte Conexão do servidor de dados do SAP se você ainda não tiver configurado uma.

  • SAP NetWeaver RFC SDK: Coloque as DLLs do SDK em C:\Windows\System32 no servidor que executa o App Builder. Para mais informações sobre o SDK e onde baixá-lo, consulte a documentação do NetWeaver RFC SDK do SAP.

  • Microsoft Visual C++ 2015-2022 Redistributable (x64): Instale este pacote de arquivo de sistema da Microsoft no servidor que executa o App Builder. Baixe o pacote.

Para mais informações sobre essas dependências, consulte a documentação do CData sobre configuração de dependências do provedor ADO.NET.

Conexão do servidor de dados do SAP

Para conectar o App Builder ao sistema SAP no qual você deseja chamar BAPIs, configure uma conexão de servidor de dados:

  1. Selecione IDE > Data Servers.

  2. Clique no botão + Server. A página Server é aberta. Defina valores para o seguinte:

    Diálogo Server

    • Na seção Server Settings:

      • Server Name: Nome identificável para a conexão do servidor. Por exemplo: SAP ABAP over RFC (BAPI).
      • Type: SAP ABAP over RFC.
      • Host Name: O nome de host do servidor de aplicação SAP. Por exemplo: example.jitterbit.com.
      • (Opcional) Messaging Server: O nome de host do servidor de mensagens SAP, usado junto com Group para uma conexão com balanceamento de carga em vez de conectar a um único servidor de aplicação.
      • (Opcional) Group: O grupo de logon do SAP para o qual se conectar, ao usar Messaging Server para uma conexão com balanceamento de carga.
      • System Id or R3 Name: O ID do Sistema (SID) de três caracteres do sistema SAP. Por exemplo: EH8.
      • System No: O número da instância do sistema SAP. Por exemplo: 0.
    • Na seção Security Settings:

      • Client: O número do cliente (mandante) do SAP para fazer logon.
      • User Name: O nome de usuário que o App Builder usa para autenticar com o sistema SAP.
      • Password: A senha desse usuário.
  3. Na seção Staging: - (Opcional) Fonte de Dados: A fonte de dados local onde as suas tabelas de staging BAPI residem.

    • (Opcional) Descrição: Digite uma descrição para essa conexão.
  4. Clique no botão Salvar.

  5. Expanda Testes, depois clique no botão Testar Conexão para verificar a conexão.

Localizando módulos de função personalizados

Por padrão, o Padrão de Importação da fonte de dados SAP expõe apenas procedimentos armazenados que correspondem a BAPI*. Para encontrar e importar um módulo de função personalizado, como um com prefixo Z, adicione uma propriedade avançada StoredProcedureFilter à conexão. Por exemplo, StoredProcedureFilter=Z* expõe adicionalmente procedimentos que começam com Z.

Nota

Se um módulo de função não for retornado pelo Padrão de Importação, ou sua execução falhar com um erro Procedure not found, confirme que seu nome está coberto pelo valor StoredProcedureFilter configurado na conexão.

Tabelas de staging BAPI

Para passar dados para o SAP, o App Builder os compila em tabelas de staging locais antes de executar uma BAPI. Cada componente do módulo de função BAPI (seus parâmetros de importação, parâmetros de exportação e qualquer estrutura pai ou filha) tem sua própria tabela de staging, com colunas que armazenam os valores que o módulo espera.

Além dessas colunas de parâmetro BAPI, cada tabela de staging também precisa de um pequeno conjunto de colunas específicas do App Builder, com prefixo _, que vinculam as tabelas de staging durante a execução. O App Builder não envia essas colunas para o SAP; as usa apenas para preparar a execução. Depois que os dados estão preparados e prontos, uma ação RFC executa a BAPI, usando a coluna _id para determinar qual conjunto de registros passar.

Nota

O App Builder registra cada conexão e execução do SAP, juntamente com dados de parâmetros específicos da BAPI, nos Logs do Banco de Dados.

Criar tabelas BAPI de staging local

Crie uma tabela de staging local para cada componente da BAPI que deseja executar, manualmente ou importando a estrutura usando o campo Padrão de Importação na fonte de dados SAP (veja Localizando módulos de função personalizados se o módulo de função necessário não aparecer).

Os parâmetros de importação de uma BAPI (dados enviados do App Builder para o SAP) e parâmetros de exportação (dados retornados do SAP) frequentemente abrangem mais de uma estrutura: um componente pai que contém os dados de nível mais alto e um ou mais componentes filhos que contêm dados de nível mais baixo, normalmente incluindo um componente filho /RETURN que retorna mensagens de sucesso ou erro. Se criar as tabelas de staging manualmente, precisa ter uma compreensão clara dessa estrutura e dos próprios parâmetros da BAPI, pois o App Builder depende dela para executar a BAPI corretamente.

Nomeie cada tabela de staging filha após seu pai; por exemplo, uma tabela pai denominada BAPI_PO_CREATE1 e uma tabela filha denominada BAPI_PO_CREATE1/POHEADER. Em seguida, adicione as seguintes colunas a cada tabela de staging:

  1. Adicione uma coluna _id, definida para o tipo de dados UUID e selecione Chave Primária e Gerada Automaticamente, para que o App Builder possa identificar exclusivamente cada registro preparado.

  2. Se a tabela for um componente filho, adicione uma coluna _ParentId, também definida como UUID, e defina uma relação muitos-para-um com a tabela pai, vinculando sua coluna _Id primária à coluna _ParentId dessa tabela.

  3. Se a ordem em que os registros são executados for importante, adicione uma coluna _index para armazenar um valor de indexação que o App Builder possa referenciar durante a execução.

  4. Adicione qualquer outra coluna de chave estrangeira local ou auditoria necessária, com prefixo _, para vincular registros BAPI ao seu próprio modelo de dados. Por exemplo, _POHeaderID permite consultar dados de BAPI preparados para um registro de PO local, e _ExecutedOn rastreia o histórico de execução.

  5. Adicione as colunas de parâmetro de importação e exportação da própria BAPI, como PURCHASEORDER, PO_ITEM, DELIVERY_DATE ou QUANTITY, refletindo a estrutura do módulo de função.

Executar uma BAPI

Depois que as tabelas de staging forem preenchidas com dados, dispare a execução da BAPI sobre RFC registrando uma ação RFC no evento de um objeto comercial ou tabela, a partir de App Workbench > Rules. No campo RFC da ação, selecione o módulo de função SAP a chamar. O App Builder fornece quatro opções integradas:

  1. BAPI_OBJCL_CHANGE

  2. BAPI_OBJCL_CREATE

  3. BAPI_OBJCL_DELETE

  4. BAPI_TRANSACTION_COMMIT

BAPI_TRANSACTION_COMMIT aparece por último porque confirma qualquer uma das outras três ações que já foram executadas.

Exemplos de módulo de função BAPI

A seguir estão alguns dos muitos módulos de função BAPI que você pode executar no App Builder. A coluna Componentes filhos lista os componentes filhos do módulo de função pai, quando aplicável.

Módulo de função Descrição Componentes filhos
BAPI_PO_CREATE1 Usado para criar uma nova PO. /POHEADER, /POHEADERX, /POITEM, /POITEMX, /POSCHEDULE, /POSCHEDULEX, /POCOND, /POCONDX, /POEXPIMPITEM, /POEXPIMPITEMX, /POTEXTHEADER, /EXTENSIONIN
BAPI_PO_CHANGE Usado para atualizar valores em uma PO existente. /POHEADER, /POHEADERX, /POITEM, /POITEMX, /POSCHEDULE, /POSCHEDULEX, /POCOND, /POCONDX, /POEXPIMPITEM, /POEXPIMPITEMX, /POTEXTHEADER, /EXTENSIONIN, /POPARTNER
BAPI_PO_RELEASE Usado para liberar uma PO após manipulá-la. —
BAPI_PO_GETDETAIL Usado para recuperar os valores de Notas de Cabeçalho e Texto na PO. _PO_GETDETAIL/RETURN, PO_HEADER_TEXTS
BAPI_SALESORDER_CREATEFROMDAT2 Usado para criar Pedidos de Venda. /ORDER_HEADER_IN, /ORDER_PARTNERS, /ORDER_ITEMS_IN, /ORDER_SCHEDULES_IN, /RETURN
BAPI_CONTRACT_CREATEFROMDATA Usado para criar Contratos. /CONTRACT_HEADER_IN, /CONTRACT_PARTNERS, /CONTRACT_PARTNERS, /CONTRACT_ITEMS_IN
BAPI_EXCHANGERATE_GETDETAIL Usado para recuperar taxas de câmbio de moeda. —
Z_ADAPT_DATA_EXTRACT Uma função personalizada usada para extrair informações do plano de investimento. —

Resolução de problemas

Se um módulo de função BAPI ou personalizado falhar na execução com um erro Procedure not found, confirme o seguinte:

  1. Os pré-requisitos (o SAP NetWeaver RFC SDK e o Microsoft Visual C++ Redistributable) estão instalados no servidor executando o App Builder.

  2. O nome do módulo de função é coberto pela propriedade avançada StoredProcedureFilter da conexão do servidor de dados. Consulte Localizando módulos de função personalizados.

  3. O módulo de função personalizado existe e está ativo no sistema SAP de destino. Um módulo de função personalizado (por exemplo, um com prefixo Z ou ZZ) só fica disponível em um determinado sistema SAP após a importação do transporte que o contém. Verifique com o administrador SAP ou inspecione o módulo de função diretamente usando o Function Builder (SE37) ou o Object Navigator (SE80), para confirmar que está presente e ativo. Se não estiver, o transporte SAP correspondente deve ser importado nesse ambiente antes que possa ser chamado.

  4. O usuário SAP configurado na conexão do servidor de dados tem autorização S_RFC para o módulo de função. O objeto de autorização S_RFC é verificado pelo grupo de funções e não pelo nome do módulo de função individual, então a função SAP do usuário deve conceder S_RFC com RFC_TYPE definido como FUGR e RFC_NAME definido como o grupo de funções que contém o módulo de função personalizado, não um curinga no nome do módulo em si.

  5. Ative o registro de dados para gerar arquivos de log e dados que você possa baixar e inspecionar.

  6. Consulte a documentação do CData ADO.NET Provider for SAP ERP para informações detalhadas.