Comunicando com APIs
A SAP disponibiliza inúmeras APIs OData para isolar o core do ERP e com isso, facilitar as customizações realizadas no BTP.
Agora nossa plataforma possibilita que uma ação de sua aplicação efetue uma chamada direta à estas APIs
Atualmente a compatibilidade é feita apenas com APIs OData V2.
Configuração no Builder
Agora vamos aos passos necessários para esta implementação:
- Na subseção Ações, clique no ícone
localizado na linha referente à ação Ação; - Na seção Propriedades subistitua o texto Ação para Incluir via API;
- Na seção Propriedades SAP subistitua o texto NEWACTION0 para EMAIL_POST;
- Selecione a opção API da configuração Chamada;
- Acione o campo ao lado da configuração API;
- Na popup Configurar API selecione API OData Desejada. Neste exemplo utilizaremos a API_BUSINESS_PARTNER;
- Selecione a entidade que deseja manipular. Neste exemplo utilizaremos a A_AddressEmailAddress;
Observe que foram listadas todas as propriedades públicas para que você possa fazer o mapeamento entre os campos de seu formulário e a entrada de dados da API.
Vale destacar que neste mapeamento, os campos de preenchimento obrigatório estão destacados em negrito.
A partir deste momento você pode associar a cada atributo:
- Campos do formulário
- Valor fixo
- Variáveis de ambiente SAP
A partir deste momento é neceesário:
- Relacione os campos obrigatórios do seu formulário com os atributos da API;
- Neste exemplo fixamos o valor do IsDefaultEmailAddress como true;
- Relacione os campos demais campos que deseja;
- Acione o botão OK da configuração API;
- Confirme sua configuração acionando o botão OK da popup de ação;
- Conclua acionando o botão Construir.
Resultado no Application
Agora você receberá as mensagens oriundas da APLI e estas mensagens serão exibidas da mesma forma que são tratadas as mensagens oriundas no ABAP nas ações que chamam Includes.
Importante:
O Application pode executar includes ABAP antes e depois da execução da chamada a API.
Este recurso foi adicionado para que seja possível atualizar a tela com dados de a cordo com as regras de negócio necessárias para a chamada da API. Bem como a atualização de dados após o retorno da mesma.