Introdução

Com a evolução para o SAP S/4HANA, o ABAP RAP (RESTful ABAP Programming Model) tornou-se essencial para os desenvolvedores criarem aplicações modernas e integrações via serviços OData. Neste artigo, vamos mostrar como criar um serviço OData utilizando o ABAP RAP de forma simples e objetiva.

O que é o ABAP RAP?

O ABAP RAP (RESTful ABAP Programming Model) é um modelo de desenvolvimento que simplifica a criação de aplicações baseadas em APIs REST no ambiente SAP S/4HANA. Ele permite criar serviços OData para expor dados e operações de forma padronizada, segura e eficiente.

Os principais componentes do RAP são:

Modelo de Dados: Definição de Core Data Services (CDS).
Comportamento: Implementação de lógica de negócio usando Behavior Definitions.
Exposição: Criação de serviços OData com o uso do Service Binding.

Criando um Serviço OData com ABAP RAP

Aqui estão os passos para criar um serviço OData com o ABAP RAP:

1. Crie uma Visualização de Dados (CDS View)

O primeiro passo é criar uma CDS View para definir o modelo de dados.

Exemplo:

@AbapCatalog.sqlViewName: 'ZCDS_PRODUCTS'
@EndUserText.label: 'Visualização de Produtos'
@AccessControl.authorizationCheck: #NOT_REQUIRED
@OData.publish: true
define view ZCDS_Products
  as select from mara
{
    key matnr as ProductID,
    maktx as ProductDescription,
    meins as Unit,
    mtart as MaterialType
}

Dicas:

Use @OData.publish: true para exposição inicial.
Inclua apenas os campos necessários.

2. Defina o Comportamento com Behavior Definition

Agora você precisa criar um Behavior Definition (BDEF) para configurar as operações do serviço, como leitura, criação ou exclusão de registros.

Exemplo:

managed implementation in class ZCL_PRODUCTS_BEHAVIOR unique;
define behavior for ZCDS_Products
persistent table zproducts
{
  create;
  update;
  delete;
}

Dicas:

Use managed para que o RAP cuide da maior parte da implementação.
Especifique as operações suportadas, como create, update e delete.

3. Implemente a Lógica de Negócio na Classe Behavior

Crie uma classe para implementar a lógica de negócio personalizada, caso necessário.

4. Configure o Service Definition

O próximo passo é criar um Service Definition (SDEF) para definir o serviço que será exposto.

Exemplo:

@EndUserText.label: 'Service Definition para Produtos'
define service ZSRV_Products
{
  expose ZCDS_Products;
}

Dicas:

Use expose para definir quais CDS Views serão incluídas no serviço.

5. Crie o Service Binding

Por fim, crie um Service Binding (SBIND) para ativar o serviço OData.

Passos:

Clique com o botão direito no Service Definition e selecione "New Service Binding".
Escolha o tipo OData v4.
Ative o serviço.

Dicas:

Use a URL gerada para testar o serviço no SAP Gateway Client ou ferramentas como o Postman.

Testando o Serviço OData

Com o serviço ativado, você pode acessá-lo usando a URL do Service Binding. Use o SAP Gateway Client ou ferramentas de terceiros para realizar requisições GET, POST, PUT e DELETE conforme a configuração do Behavior Definition.

Conclusão

O ABAP RAP simplifica a criação de serviços OData modernos no SAP S/4HANA, integrando dados e lógica de negócio de forma eficiente. Seguindo os passos acima, você estará apto a criar e expor serviços que potencializam a experiência do usuário e a integração de sistemas.

Gostou do artigo? Compartilhe suas experiências com o ABAP RAP nos comentários abaixo!

Criar Serviços OData No SAP S/4HANA

Criar Serviços OData No SAP S/4HANA