✒️SAP BTPFIORI / La relación entre SAP Gateway y los servicios OData Por Roberto Santucho

LA RELACION ENTRE SAP GATEWAY Y LOS SERVICIOS ODATA

1. La arquitectura cliente/servidor

2. los servicios de datos

• en la arquitectura www, interfaces abstractas (conectores) para la comunicacion de los componentes de software
• un cliente y un servidor utilizan c/u un componente conector
• existe un contrato enter ambos conectores que define el protocolo de aplicacion : Define los documentos, su formato y el comportamiento. EL PROTOCOLO DE DATOS ABIERTO ODATA define dicho contrato especificando un protocolo uniforme.

un conector enchufado a un sistema backend de SAP se traduce entre las API ABAP y las entidades OData utilizando el CONECTOR SAP GATEWAY.

un conector de cliente se traduce entre las entidades de OData y las API de la plataforma del consumidor.

cualquier plataforma cliente con bibliotecas que admitan el formato OData puede comunicars con cualquier servidor que adminta el mismo contrato.

2.1 QUE FUNCIONES TIENE ODATA?

• se ha convertido en el estandar para el intercambio de datos en la WEB
• compatible con la funcionalidad CRUDQ completa (create, read, update, delete and query), por lo que se lo conoce como EL CONECTOR DE BASE DE DATOS ABIERTO ODBC PARA LA WEB.
• OData se usa ampliatmene como un protocolo ABIERTO. SAP lo eligio para SAP Gateway porque
  • es ampliamente usado
  • conocido
  • facil de aprender.
• SAP lo utliza para la comunicacion entre FES y el BES.
• Desarrollado originalmente por Microsoft, el comite tecnico encargado de su desarrollo son empresas tales como : IBM, SAP y Microsoft
• basado en el modelo de datos de entidad que se usa para representar los objetos y sus relaciones entre si. estos datos se representan en los formatos JAVA SCRIPT OBJECT NOTATION Y ATOM/XML para el mundo exterior.

Caracteristicas

1. Permite a SAP complementar los tipos de datos utilizados por OData con informacion adicional del diccionario de datos ABAP (SAP Annotations)
2. OData define el estandar para trasnferir datos utilizando tecnologia ya establecidas. Tambien se denomina "ODBC para la web"
3. JSON DEFINE EL FROMATO DE DATOS PARA LOS DATOS TRANSFERIDOS. Se basa en los estandares ATOM PUBLISHING Y ATOM SYNDICATION, que a su vez, se basanEN XML Y HTTP(S).
4. HTTP(S) el es PROTOCOLO DE RED para la comunicacion.

2.2 QUE FUNCIONES TIENE SAP GATEWAY?

• objetivo: solucion que unifica el acceso a los sitemas back-end
• proporciona una interfaz abierta basada en REST (Representational State Transfer) que implementa un acceso simple a los sistemas SAP a traves del protocolo OData.
• al instalar SAP Gateway, obtenemos una infraestructura para desarrolloar y generar servicios.
• los servicios se pueden crear sin programacion (RFC, BAPI, HANA CDS)
• Con SAP Gateway, los datos de los sistemas Back-end SAP basados en ABAP se pueden publicar en el mundo exteriro. Los consumidores tipicos de estos datos son webistes, aplicaciones mobile nativas y web apps. Ademas los clientes son aplicaciones Javascript, SAP Fiori y SAPUI5, asi como aplicaciones de platarforma en la nube.
• proporciona acceso simple, seguro y controlado a los datos de SAP, a traves de un estandar abierto abstrayendo los detalles de SAP Businesss Suite.
• SG proporciona un unico punot de entrada para acceder a los datos comerciales de sistemas basados en ABAP como SAP Business Suite o SAP S/4HANA.
• El Gateway es el responsable de CREAR, GENERAR Y EXPONER la informacion mediante servicios OData.

3. QUE ES REST?

• REPRESENTATIONAL STATE TRANSFER o Transferencia de Estado Representacional es una tecnica de aqruitectura de software para sistemas hipermedia distribuidos como la Web.
• se usa para describir cualquier interfaz web simple que utiliza XML o JSON y HTML, sin las abstracciones adicionales de los protocolos en patrones de intercambio de mensajes como el protocolo de servicios web SOAP.
• un concepto clave en REST es la existencia de recursos (elementos de informacion), que se acceden a traves de un URI (uniform resource id). Para manipular estos recursos, los componentes de la red (clietes y servidores) se comunican a traves de una interfaz estandar (HTML) e intercambian representaciones de estos recursos.
• la aplicacion, sin embargo, debe comprenser el formato de la info devuelta(LA REPRESENTACION), que generamente es un doc HTML o XML o una imagen u otro contenido.
• REST es un estandar de como es el dialogo entre el cliente y el servidor, LO QUE SE DENOMINA ARQUITECTURA DE SERVICIO.
• Un servicio REST proporciona una API que sigue un determinado conjunto de reglas. solicitud de provedores y productos tiene la forma dominio.com/proveedores o dominio/producto, y para un producto dominio/productos/1, LO CUAL SE DENOMINA END-POINT, los cuales se ASOCIAN A LOS METODOS HTTP.
• hace mas facil la comunicacion de maquina a maquina, por un servidor de aplicaciones puede confirar que los datos estan presentes a traves de un un conjunto estable de URL.
• CADA URL DE UN SERVICIO REST TIENE TODA LA INFORMACION QUE EL SERVICIO NECESITA PARA RESPONDER A LA SOLICIUTD. COMO RESULTADO UN SERVICO RESTful es SIN ESTADO, lo que significa que no hay informacion de sesion en el servidor. PARA CADA SOLICITUD , TODA LA INFORMACION DEBE PASARSE NUEVAMENTE AL SERVIDOR.
• los sistemas que siguen los principios REST se denominan a menudo RESTful. Principios fundamentales:
  • una sintaxis universal para identificar los recursos (URI)
  • un protocolo cliente/servidor sin estado(stateless): cada mensaje HTTP contiene toda la infor necesaria para comprenser la peticion. NI CLIENTE NI SERVIDOR NECESITAN RECORDAR NINGUN ESTADO DE LAS COMUNICACIONES ENTRE MENSAJES.
  • operaciones bien definidas aplicables a todos los recurso de informacion: HTTP define un conjunto de operaciones, las mas importantes POST, GET, PUT y DELETE.
  • actualmente se JSON para estructurar datos, que necesita menos metainformacion que reduce cantidad de datos transferidos.

4. EL PROTOCOLO ODATA

• estandar abierto, desarrollado por MS y ahora administradop por Oasis, basado en los estandares XML y JSON que posteriormente ha sido adoptado como estandar abierto. Las ideas en Atom formaron la base de OData.
• los servicios OData suministran los datos comerciales
• es un punto de integracion clave entre capa ui y la capa bakend
• SAP eligo ODAta para SAP Gateway pore es amplicamente usado, bien conocido y facil de aprender.
• OData espera peticiones a traves de URI, debido a que es mas ESPECIFICO QUE REST, los formatos de mensajes son fijos y EL FORMATO XML CON EL QUE TRABAJA ES ATOM.
• su objetivo es proporcionar un proveedor neutroa, API, basada en la web que cumpla totalmente con los principios de diseno REST.

Generalmente se crea un serivico OData por cada aplicacion que vayamos a construir. El servicio puede estar compuesto por:

• una o varias Entity
• EntitySet: "tabla" que nos devovlera la info
• Un documento de servicio: so obtiene llamando a la URL del servicio.
• el codumento metadata (EDMX)
• un conjunto basico de obpearcoines: conocidas gralemnte como CRUD Q.

4.1. documento de servicio OData

https://services.odata.org/V3/Northwind/Northwind.svc/

4.2 la metadata del servicio OData

https://services.odata.org/V3/Northwind/Northwind.svc/$metadata

se ven distintos tipos de propuedades:

• propiedades clave: Ej ProductID <Property
• propiedades de navegacion: ejemplo Category <NavigationProperty

Los conjunto de entidades EntitySet tienen sus propias definiciones dentro del elemento EntityContainer

Para aceer directamenta un conjunto de entidades

https://services.odata.org/V3/Northwind/Northwind.svc/Products

Mas legible agrego al final ?$format=json

4.3 POR QUE ODATA

• permite exponer y acceder a info de una gran variedad de fuente: DB relaciones, sistemas de archivos, sistema de gestion de contenidos y webisites tradicionales
• amplia aceptacion de renombrados fabricantes de software
• interfaz para dearrollar en la plataforma SAP para proframadorese (.net, html y java) sin conocimeintos solidos en sap

BENEFICIOS DE USAR ODATA:

• Facil acceso similar a la bd de los datos back-end a traves d HTTP
• OData es un estandar de la industria, actual OData V4
• apoyado por las pricipales plataformas
• desplegar datos coo servicios REST con un formato interoperable, din dificultades para desarrollarlos.
• virtualiza datos corporativos en las herramientas de gestion de APIs
• promueve una forma estandar para implementar las API REST. permite funcionalidades de consulta similara a las de SQ, utilizando estas APIs RESTful. OData es como SQL para entornos webs, desarrollados con protocolos esntandar de nivel superiro, HTTP, JSON y ATOM, al mismo tiempo que se aprovecha el estilo de la arquitectura REST.

5 LOS BENEFICIOS DE SAP GATEWAY

• es una infraestructura que permite al usuario crear o desarrollar sus propios servicios OData
• forma sencilla de conectar dispoisitivos, entonrnos y plataformas al software SAP basada en los estandares del mercado
• el Gateway es el responsable de crear, generar y exponer la informacion mediante servicios OData
• Catalogo de servicios disponibles en un SAP Gateway url/sap/opu/odata/iwfnd/CATALOGSERVICE

Algunos de los beneficios de SAP Gateway

• Interfaz de usuario intuitiva y atractiva: el desarrollador front-end se centra en la app a desarrollar y dedicar max atencion a la UX
• Innovacion: la implementacion de los nuevos procesos se vuelve mas flexible, facil y reduce costos. Ej si ya existe una app para reservar viajes en iphone, no es necesario tocar el back-end, solo adaptar el front-end

• Orientacion empresarial: integra equipos, procesos y datos logrando con esto reduci la complejidad de desarrrollos ..
• dispoiniblididad: brinda conectividad a apps SAP desde cualquier tipo de lenguaje, program o modulo sin grandes conocimeintos de sap
• Aguilidad: ciclos de desarrrollo se pueden acortar con SG, en consecuencia, aumenta la agilidad.
• Integracion: primero en el back-end (essencialmente ahora es una unidad en lugar de varias). Luego en la interfaz, que se beneficia del uso de estandares
• Mantenimiento y seguridad: seguridad de datos permanece con los adm del back-end, y lo mismo para los sistemas back-end. mantenimiento front end depende depende del canal utilizado
• Costos: acorta ciclo de desarrollo. ademas la implementacion de SG es relativamente barata y facil.

TX ERP para SAP Gateway

mantenimiento del servicio de puerta de enlace /IWFND/MAINT_SERVICE

cliente de puerta de enlace /IWFND/GW_CLIENT entorno de prueba de servicio de puertna de enlace en la interfac

generador de servicios de pueta de enlace SEGW : entorno de desarrollo de Central Gateway en el back-end

SE80

ODATA SERVICIES

https://services.odata.org/V3/Northwind/Northwind.svc/Products?$filter=ProductName eq 'Chai'