✒️SAP BTPFIORI / La creación de un servicio OData del lado del backend Por Roberto Santucho

1. LA CREACION DE UN SERVICIO ODATA

SEGW (service builder) y crear un nuevo proyecto.

• Proyecto: es el nombre, no mas de 30 caractes.
• Descripcion: 60 carctermes max
• Tipo de proyecto:
  • Servicio con anotaciones SAP (predeterminado):
  • Servicio con anotaciones basadas en vocabulario:
  • Modelo de anotacion para servicio referenciado: PARA ANOTAR UN SERVICIO EXISTENTE. Las anotaciones no se muestran con los metadatos (ver via /IWFND/CatalogService;v=2) . dichas anotaciones deben ser leidas por el consumidor del servicio.
• Estrategia de generacion: Standard solo disponible por el momento
• Paquete y persona responsable: igual a entorno ECC

TRANSPORTE: Entrada al repositorio para transporte es R3TR IWPR znuevonombreservico

2. LA CREACION DE UN MODELO DE DATOS DECLARATIVO

Se crea manualmente.

2.1 LA CRECION DE LA ENTIDAD

• Objeto del mundo real
• es un grupo de propiedades relacionadas, una o mas seran marcadas como clave.
• En nuestro ejemplo, boton derecho sobre Data Model, Import > RFC/BOR Interface y abre create Entity Type from Data Source

Seleccionamos que campos queremos

como no elegimos clave, nos indica que seleccionemos una

NOTA: Las opciones Creatable, Updatable, Sortable, Nullable son meramente informativa que SE VERAN EN LA SECCION METADADA DEL SERVICIO. Es decir, podria llegar a ser capaz de crearse cuando usemos el servicio

2.2 LA CREACION DE UN SET DE ENTIDADES

Es necesario porque el consumo del servicio SE REALIZA EN BASE AL SET DE ENTIDADES.

Carpeta Entity Sets > Crear y nos pide un nombre

En mi caso ya me lo habia creado (nunca vi el checbox de creacion automatica)

3. LA GENERACION DE OBJETOS EN TIEMPO DE EJECUCION

Darle el boton Generate Runtime Objects

Se generaran las SIGUIENTES CLASES ABAP

• Clases ABAP con nomenclatura ZCL_ nombre proyecto
• Clase de extension y clase: se generan 2 clase MPC y DPC:
  • Model Provider Class (MPC): clase ABAP que proporciona la representacion en tiempo de ejecucion de la definicin de su modelo (debemos regenerar el MPC cada vez que cambie la definicion del modelo en nuestro proyecto). La definicion del modelo se genera en dos clases:
    • La clase base (subjito _MPC): deeriba de la superclase /IWBEP/CL_MGW_PUSH_ABS_MODEL
    • la clase de extension (subfijo _MPC_EXT): tiene la clase base como su superclase.
  • Data Provider Class (DPC): son responsables de la representacion en tiempo de ejecucion de la implementacion del servicio. CUANDO SE INSTANCIA UNA CLASE, LOS DPC EJECUTAN LOS METODOS CREATE, READ, UPDATE, DELETE, QUERY Y MUCHAS MAS OPERACIONES. las clases _DPC_EXT y _DPC heredan de la superclase /IWBEP/CL_MGW_PUSH_ABS_DATA.

Generacion exitosa (todos iconos verdes)

4. LA DEFINICION DE SERVICIO DE _SRV

El siguiente paso es el registro y activacion del servicio OData en el SAP Gateway o fase de mantenimiento del servicio.

/IWFND/MAINT_SERVICE o directamente desde la SEGW, en el arbol, carpeta Service Maintenance. Luego boton Register y luego de ingresar el paquete, el semaforo debe estar en verde.

5. LOS METADATOS DEL SERVICIO ODATA

• Necesitamos una URI para acceder al servicio y para los metadatos, agregar $metadata
• son informacion sobre el servicio OData que describe los artefactos que los contienen
• OData nos permite definir 2 tipos de documentos de metadatos
  • Documento de servicio (suele estar disponible en la raiz del servicio OData) enmera todos los artefactos de alto nivel.
  • Documento de metadatos de servicio: describe la lista completa del modelo de datos de c/u de los artefactos OData involucrados desde propiedads hasta operaciones de servicio.