WebAPI com .NET Consumindo ServiceLayer SAPB1

Wladimir — Sat, 04 May 2024 14:08:32 +0000

A ideia desse post é mostrar uma API desenvolvida em .NET Core consumindo a Service Layer do SAP. No cenário descrito, é utilizado o SAP B1.
Service Layer é um serviço do SAP onde é possível consumir as funcionalidades do SAP, como visualizar/cadastrar usuários, pedidos de vendas/compras, itens, etc. Os endpoints disponíveis podem ser visualizados nesse link:
https://help.sap.com/doc/056f69366b5345a386bb8149f1700c19/10.0/en-US/Service%20Layer%20API%20Reference.html

É um serviço muito interessante mas ele tem algumas peculiaridades tais como a necessidade de realizar um login prévio para que os endpoints possam ser consumidos e também a resposta para requisições GET possuírem no máximo 20 registros. Segundo a documentação, esse é o valor padrão para não afetar a performance pois dependendo da empresa, alguns serviços podem ter vários registros.
Mas isso pode ser um problema para certas ferramentas que não trabalham bem com requisições que necessitem de login e também para sistemas que precisam de todos os registros cadastrados. Por isso uma solução seria desenvolver uma API para consumir os serviços. Assim é possível manipular esse cenário.
Para resolver essa situação, o cenário desenvolvido seria como mostrado na imagem.

O funcionamento do cenário então se dá no seguinte: a aplicação chama a API, que fica responsável pelo login, manipulação da quantidade de registros e envio do token que será utilizado nas requisições. A API terá a responsabilidade de consumir os endpoints do SAP. Este retorna o resultado para a API desenvolvida e esta retorna o resultado para a aplicação. Com a API desenvolvida é possível manipular a quantidade de registros já que é uma informação que é necessária ser enviada no header.

Com a API rodando, ela está documentada com o Swagger conforme mostrado abaixo.

Na API desenvolvida, foi utilizada apenas o cenário de busca de itens. Mas é possível adaptar para qualquer outro cenário utilizando um dos endpoints oferecidos pelo SAP conforme link acima. Basta apenas criar suas rotas específicas com suas respectivas classes.
Abaixo segue a API rodando buscando todos os itens.

O repositório da API pode ser consultado no link: https://github.com/WraSouza/sap_api

Qualquer contribuição sempre será bem-vinda.

Obrigado pela leitura.

Docker Volume

Wladimir — Sun, 15 Oct 2023 13:55:30 +0000

Hoje vamos falar sobre Docker Volume, uma funcionalidade que pode salvar sua vida.
Ao utilizarmos o docker para criar nossos containers, em muitos cenários nós inserimos os arquivos dentro do container. Como o exemplo abaixo.

FROM nginx
COPY arquivo.txt /usr/share/nginx/html/
EXPOSE 80

Nesse exemplo, pegamos o arquivo "arquivo.txt" e colocamos ele dentro do container criado. O usuário irá interagir com o arquivo, inserindo, modificando ou apagando informações. Mas como esse arquivo está localizado dentro do container, então temos um problema.Caso o container seja eliminado - independente do motivo - esse arquivo, assim como todas suas modificações também será perdido.Esse cenário inclui também uma base de dados.Pode ser que você tenha utilizado uma imagem de um MySQL, MariaDB, etc.E é nesse cenário que o docker volume surge para eliminar esse problema. Ao utilizar essa abordagem, o arquivo não é colocado dentro do container. Ao invés disso, é criado um mapeamento do container para o arquivo.

Como mostrado na imagem acima, o arquivo não estará dentro do container, mas apenas mapeado.Toda interação realizada no arquivo ou base de dados, será realizado no container mas salvo em um diretório da sua máquina.E mesmo que o container seja deletado, o arquivo, ou a base de dados não será perdido. Muito legal, não é!? Mas essa abordagem é perfeita!? Bom, nem tudo são flores. Como tudo fica salvo em um diretório da máquina, você terá que garantir que ninguém terá como apagar esse diretório, caso contrário você terá tudo perdido. Mas é uma abordagem bem interessante para garantir que os dados não sejam perdidos.

Curtiu essa dica? Escreve aqui o que achou, dando sugestões, dicas, melhorias.

Este está sendo minha postagem nesse blog e conto com vocês da comunidade para melhorias.

Valeu.

DEV Community: Wladimir

WebAPI com .NET Consumindo ServiceLayer SAPB1

Docker Volume