Prefácio – Este post faz parte do Tutorial SAP ABAP OData série.
Conteúdo
Introdução
Em nosso artigo anterior, já discutimos o que é um OData. Neste artigo vamos passar pelo processo passo a passo para criar um SAP Serviço OData. Mais tarde, vamos registrar nosso serviço e também testar se está funcionando bem. Neste artigo, não escreveremos nenhum código relacionado a CRU (criar, escrever, atualizar e excluir). Para aprender CRUD em OData, clique aqui.
Processo passo a passo para criar o serviço SAP OData
Nesta seção, seguiremos várias etapas predefinidas para criar um OData, são elas:
- Usaremos o SAP Service Gateway Builder (SEGW) para criar um novo projeto
- Importaremos DDIC/CDS ou outra estrutura para criar um modelo OData
- Vamos gerar nosso OData
- Vamos registrar e testar nosso serviço
Criar um novo projeto do Service Builder
Para criar um novo projeto, siga os passos indicados:
- Vá para o código de transação SEGW, ele iniciará o Gateway Service Builder.
- Clique no botão Criar Projeto, conforme mostrado abaixo:
- Insira as informações fornecidas
| Campo | Descrição | Exemplo |
| Projeto | É o nome do seu SAP OData Service. Vai começar com Z or Y | ZPROJECT_NAME |
| Descrição | Insira uma descrição para seu OData | Projeto OData de demonstração |
| Tipo de Projeto | A SAP fornece quatro opções de projeto: 1. Serviço com Anotações SAP 2. Serviço com anotações baseadas em vocabulário 3. Modelo de Anotação para Serviço Referenciado 4. Serviço OData 4.0 Vamos aprender sobre eles em detalhes, mais tarde. | Serviço com anotações SAP
|
| Estratégia de geração | Será pré-carregado como Standard o que significa que tem todas as configurações padrão. | Standard |
| Pacote | Digite seu pacote de projeto ou pacote temporário, ou seja $ TMP | $ TMP |
| Pessoa responsável | Ele será pré-carregado com seu ID de usuário/Nome de usuário | Barry Allen |
- Pressione Continuar e Salvar.
Importar uma estrutura DDIC
Para usar um Serviço OData, ele deve ser projetado de forma que leia/atualize uma ou mais tabelas. Portanto, precisamos importar qualquer tabela, estrutura ou visualização. Estes fazem parte da estrutura DDIC. Também podemos importar o modelo de dados do arquivo, interface RFC/BOR ou uma ajuda de pesquisa. Mas nesta seção, aprenderemos como importar uma estrutura DDIC:
- Clique no modelo de dados no projeto que criamos recentemente para expandi-lo.
- Clique com o botão direito em Modelo de dados e clique importação e clique em Estrutura DDIC
- Agora, um assistente será aberto. Digite os seguintes detalhes, lá:
| Campo | Descrição | Exemplo |
| Nome | Insira um nome de Modelo. Deve ser explicativo. | Dados do cliente |
| Tipo | Temos duas opções aqui: 1. Tipo de Entidade: Isso significa que uma estrutura/tabela/exibição DDIC simples será importada 2. Tipo complexo: Isso significa que uma estrutura/tabela/visualização DDIC complexa será importada | Escolha o tipo de entidade |
| Estrutura ABAP | Escolha o nome da tabela ou estrutura necessária. Basta copiar e colar o nome da sua tabela/estrutura/visualização DDIC | dados_do_cliente |
| Criar conjunto de entidades padrão | Ele criará um Tipo de Entidade com os mesmos campos de Entidade. Além disso, o nome permanecerá o mesmo. Recomendamos que você deixe marcado. | Deixe marcado |
Os detalhes acima são mostrados abaixo:
- Na próxima etapa, o assistente mostrará todos os campos da tabela importada. Basta selecionar todos eles e clicar em Avançar, conforme mostrado abaixo:
- Na próxima etapa, o assistente mostrará todos os campos marcados. Aqui você precisa verificar as chaves primárias e finalizar, conforme mostrado abaixo:
Gerar serviço OData
Agora, criamos um objeto OData com um modelo. Agora, para usar este objeto, precisamos gerar todas as classes necessárias. Para gerar, pressione o botão Gerar objetos de tempo de execução 
botão, como mostrado abaixo:
Nota: O botão Generate Runtime Objects salva automaticamente o projeto antes de gerar classes.
Pressionando o botão acima, abrirá uma caixa de diálogo como mostrado abaixo:
Basta pressionar Continuar, como mostrado acima. O processo acima irá gerar as seguintes classes:
| Nome da classe | Descrição |
| Classe MPC | MPC significa Classe de Provedor de Modelo. Isso é gerado e atualizado toda vez que geramos uma classe. Não é recomendado estender esta classe para Model Annotations, pois todos os métodos são deletados sempre que o OData é gerado. |
| Classe EXT MPC | Esta é a classe Extended MPC, e todos os métodos são conservados até mesmo o OData é gerado. |
| Classe DPC | DPC significa Data Provider Class. Isso é gerado e atualizado toda vez que geramos uma classe. Não é recomendado estender esta classe para operação CRUD, pois todos os métodos são deletados sempre que o OData é gerado. |
| Classe EXT DPC | Esta é a classe Extended DPC, e todos os métodos são conservados até mesmo o OData é gerado. |
| Classe MDL | A é a classe modelo. |
| Classe SRV | Esta é a classe de serviço. |
Basta clicar em Lock Object para gerar as classes, conforme mostrado abaixo:
Registre o SAP OData usando o cliente Gateway
Uma vez que o OData é gerado, agora é a hora de registrar o serviço. Uma vez que o serviço é registrado, só então ele pode ser usado em qualquer lugar.
Para gerar um OData, siga as etapas fornecidas:
- Clique duas vezes no nó Serviço de manutenção
- Selecione qualquer sistema e clique Inscrições como mostrado abaixo:
- Insira um Alias, se solicitado, conforme mostrado abaixo:
- Agora, na próxima tela, você obtém as seguintes opções:
| Campo | Descrição |
| Nome do serviço técnico | Este é o nome do serviço gerado automaticamente |
| Versão do serviço | É a versão de serviço gerada automaticamente |
| Descrição | É a descrição do OData que você mencionou anteriormente |
| Nome do serviço externo | É igual ao nome do serviço gerado automaticamente |
| Namespace | É por banco padrão |
| ID de mapeamento externo | É por padrão Vazio |
| Tipo de fonte de dados externa | É por padrão definido para o tipo de origem C |
| Nome técnico do modelo | É o nome do modelo gerado automaticamente |
| Versão do modelo | É a versão do modelo gerada automaticamente |
| Atribuição de Pacote | Atribua o nome do seu pacote aqui, ou apenas escolha Objeto Local no botão abaixo. Será então $TMP |
| Nó ICF | É por padrão “Modo Padrão” |
| o Habilitação de autenticação | Ele fornece a opção de adicionar autenticação extra, caso você precise de habilitação oAuth2, escolha-o, caso contrário, deixe-o em branco |
No nosso caso, basta escolher o pacote e clicar em confirmar, conforme mostrado abaixo:
Assim que o serviço for registrado, o Cadastro ficará verde, conforme mostrado abaixo:
Testar o serviço OData
- Para testar o serviço OData, clique no botão Cliente SAP Gateway botão, como mostrado abaixo:
- Abrirá uma nova tela, clique aqui Adicionar opção de URI como mostrado abaixo:
- Escolha $ metadata, Aqui:
- Clique Execute como mostrado abaixo:
Se o status for 200, como mostrado acima, significa que seu OData está funcionando bem.
Nos próximos artigos, aprenderemos como realizar a operação CRUD usando OData.
0 Comentários