Referências técnicas

Esta seção inclui informações úteis que você pode precisar ao trabalhar com a SAP BAPI.

Como criar entradas de array para tipos de entrada de tabela

Na atividade Execute BAPI , os tipos de entrada de tabela para BAPIs são representados como entradas de array. Isso requer que você crie manualmente os objetos. Estamos trabalhando ativamente em uma solução para simplificar os mapeamentos de array e melhorar a experiência geral.

Esta seção explica como criar entradas de array equivalentes para uma tabela do tipo nativa na SAP BAPI, com exemplos no Studio Desktop versão 2023.10 e no Studio Web.

Vamos explicar esse tópico com o exemplo de um objeto BAPI_PO_CREATE .

Studio Desktop (Linguagem C#)

1. Na atividade Execute BAPI , selecione o objeto BAPI_PO_CREATE .
2. Após selecionar o objeto, o restante dos campos são recuperados automaticamente.
3. Para uma tabela de PO_ITEMS, por exemplo, você deseja construir uma matriz equivalente de objetos. Selecione o menu do botão Mais + ao lado do campo PO_ITEMS para abrir o Editor de expressão.
4. Na janela Expression Editor , digite UiPath.IntegrationService.Activities.SWEntities. Isso carrega uma lista de itens. Você pode usar o IntelliSense para ajudar com o deslocamento.
5. Na lista, escolha o item que corresponda ao seu InArgument (neste caso, bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE). Este item é sempre exclusivo em uma tabela.
   
   

   

   
   
6. Em seguida, digite um ponto (.) e escolha Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create na lista disponível. Adicione dois pares de colchetes no final: []{}.
7. Nesse ponto, a matriz é instanciada, e você está pronto para construir o objeto dentro dela.
   
   

   

   
   
   Observação: o ID CEBA75DCD15 é um identificador exclusivo gerado em nosso lado, específico para sua conexão SAP BAPI para cada objeto. O ID é exclusivo para cada objeto.
8. Copie a linha da etapa anterior e adicione parênteses () no final. Agora, você está pronto para mapear as propriedades dentro do objeto.
   
   

   

   
   
9. Insira um período (.) para pesquisar todas as propriedades dentro do objeto.
   
   

   

   
   
10. Mapeie as propriedades conforme a necessidade e selecione Salvar.
    
    

    

    
    

Exemplo:

new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create[] {
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00001,
        PUR_MAT = "TG12",
        PLANT = "1710"
    },
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00002,
        PUR_MAT = "TG12",
        PLANT = "1710"
    }
}

Studio Web (Linguagem VB)

Vamos tomar o mesmo exemplo e ver como podemos alcançar o resultado no Studio Web.

1. Na atividade Execute BAPI , selecione o objeto BAPI_PO_CREATE .
2. Após selecionar o objeto, o restante dos campos são recuperados automaticamente.
3. Para uma tabela de PO_ITEMS, por exemplo, você deseja construir uma matriz equivalente de objetos. Selecione a opção Ver mais menu do botão para abrir o editor de Expressão.
   
   

   

   
   
4. Digite New, seguido de um espaço e, depois, bapis. Isso faz com que o IntelliSense exiba uma lista de itens. Na lista, selecione o item que corresponde a seu InArgument, neste caso bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE. Este item é sempre exclusivo em uma tabela.
   
   

   

   
   
   
   

   

   
   
5. Em seguida, adicione um par de chaves {}. Dentro dos colchetes, digite um ponto .. Em seguida, você poderá ver as propriedades disponíveis dentro do objeto.
   
   

   

   
   
6. Mapeie as propriedades conforme a necessidade e selecione Salvar.
   
   

   

   
   

Exemplo:

{ 
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00001,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    },
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00002,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    }
}

Perguntas frequentes

O pacote de atividades SAP BAPI é compatível com projetos Windows e multiplataforma?

Sim, o pacote de atividades SAP BAPI é compatível com o Windows e os tipos de projeto multiplataforma no Studio Desktop.

Por que não consigo ver todas as propriedades necessárias de uma BAPI na tela da atividade?

Quando uma propriedade de uma BAPI específica é do tipo estrutura, a entrada (estrutura) em si não é exibida na tela da atividade Execute BAPI , mas suas propriedades subjacentes são mostradas. Mesmo que certas propriedades dentro da estrutura sejam exigidas pela BAPI, elas ainda são exibidas como opcionais na tela principal, muitas vezes levando a uma interface de atividade desordenada. O SAP não indica quais campos são necessários dentro da estrutura e apenas fornece informações sobre a estrutura obrigatória. Portanto, você deve identificar manualmente e mapear os campos necessários de acordo. Você pode ler mais sobre essa limitação neste tópico da comunidade SAP: Campos obrigatórios de BAPI.

Por que não consigo ver os tipos de entrada de tabela para as BAPIs?

Na atividade Execute BAPI , os tipos de entrada de tabela para BAPIs são representados como entradas de array. Isso requer que você crie manualmente os objetos. Consulte os exemplos fornecidos em Criar entradas de array para tipos de entrada de tabela.

Estamos trabalhando ativamente em uma solução para simplificar os mapeamentos de array.

Por que não consigo ver todas as minhas entradas na tela?

Por padrão, apenas os campos necessários são mostrados na tela da atividade principal. Você pode acessar e configurar campos opcionais no painel Gerenciar propriedades . Selecione as entradas adicionais de que precisa e use a opção Atualizar campos para trazê-las para a tela principal.

A invocação de RFC é compatível?

Atualmente, a invocação de RFC não é compatível com o pacote de atividades SAP BAPI.

Existe algum pré-requisito de instalação para usar as atividades SAP BAPI?

Nenhuma instalação é necessária para usar as novas atividades SAP BAPI do Integration Service. Você precisa do UiPath Studio versão 2023.10 ou superior, ou pode começar a criar suas automações diretamente no Studio Web.

Como posso determinar se a atividade Execute BAPI foi bem-sucedida?

Todas as BAPIs incluem um array _RETURN dentro da seção Tabelas de saída. Isso fornece saídas como LOG_NO, CODE, MESSAGE, etc. Verifique esses valores para avaliar o sucesso ou falha da execução da BAPI.

Posso usar um endereço IP em vez de um nome DNS para o Hostname?

Usar um endereço IP oferece uma vantagem significativa: exclusividade. Quando você usa um nome de DNS como mycompany.com/sap/bapi, você depende da tradução do DNS, roteamento e outros componentes da rede. Isso pode levar a possíveis problemas e problemas de rede. Portanto, recomendamos que você use endereços IP para garantir uma experiência de criação de conexão mais confiável.

Posso usar a atividade SAP BAPI do Integration Service se meu aplicativo SAP estiver hospedado no local ou em uma nuvem dedicada?

Sim. Se seu sistema SAP S/4HANA estiver hospedado em uma plataforma de nuvem como o Azure, você deve ter um endereço IP público, que seja suficiente para acesso. Se seu sistema SAP for local, você precisa permitir o acesso a partir de endereços IP externos específicos, o que envolve definir as configurações do seu firewall.

O sistema lida com confirmações para BAPIs automaticamente?

Sim. Como usamos o SAP Java Connector, o sistema detecta automaticamente se uma BAPI requer uma confirmação e aciona BAPI_TRANSACTION_COMMIT para garantir que a transação seja salva. Isso elimina a necessidade de intervenção manual.