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
thirdpartysapemhttps://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.zippara 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 pastaApp 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\System32no 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:
-
Selecione IDE > Data Servers.
-
Clique no botão + Server. A página Server é aberta. Defina valores para o seguinte:

-
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.
- Server Name: Nome identificável para a conexão do servidor. Por exemplo:
-
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.
-
-
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.
-
Clique no botão Salvar.
-
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:
-
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. -
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_Idprimária à coluna_ParentIddessa tabela. -
Se a ordem em que os registros são executados for importante, adicione uma coluna
_indexpara armazenar um valor de indexação que o App Builder possa referenciar durante a execução. -
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,_POHeaderIDpermite consultar dados de BAPI preparados para um registro de PO local, e_ExecutedOnrastreia o histórico de execução. -
Adicione as colunas de parâmetro de importação e exportação da própria BAPI, como
PURCHASEORDER,PO_ITEM,DELIVERY_DATEouQUANTITY, 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:
-
BAPI_OBJCL_CHANGE -
BAPI_OBJCL_CREATE -
BAPI_OBJCL_DELETE -
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:
-
Os pré-requisitos (o SAP NetWeaver RFC SDK e o Microsoft Visual C++ Redistributable) estão instalados no servidor executando o App Builder.
-
O nome do módulo de função é coberto pela propriedade avançada
StoredProcedureFilterda conexão do servidor de dados. Consulte Localizando módulos de função personalizados. -
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
ZouZZ) 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. -
O usuário SAP configurado na conexão do servidor de dados tem autorização
S_RFCpara o módulo de função. O objeto de autorizaçãoS_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 concederS_RFCcomRFC_TYPEdefinido comoFUGReRFC_NAMEdefinido 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. -
Ative o registro de dados para gerar arquivos de log e dados que você possa baixar e inspecionar.
-
Consulte a documentação do CData ADO.NET Provider for SAP ERP para informações detalhadas.