Operaciones de API para objetos comerciales personalizados en S/4HANA Cloud

En SAP S/4HANA Cloud, hay tres posibilidades fundamentales disponibles para la extensibilidad de la funcionalidad estándar que está disponible lista para usar. Estas posibilidades son:

• Ampliación en la aplicación/usuario clave
• Extensibilidad lado a lado
• Extensibilidad del desarrollador/Steampunk integrado

Para una comprensión de alto nivel de estas diferentes opciones, consulte el siguiente Blog que ofrece una gran visión general sobre este tema.

En esta publicación de blog, veremos un escenario de extensibilidad específico disponible con la extensibilidad de usuario clave/en la aplicación, a saber, el uso de los llamados Objetos comerciales personalizados (CBO). Con CBO, es posible crear variaciones personalizadas de objetos comerciales estándar (por ejemplo, órdenes de venta u órdenes de compra) y mejorar estos objetos con lógica personalizada para satisfacer las necesidades de un requisito específico del cliente. Teniendo en cuenta estos antecedentes, me gustaría demostrar en este blog cómo puede crear una CBO y ejecutar las operaciones API estándar (GET, POST, DELETE) en esta CBO. También puede mejorar los CBO con campos personalizados y lógica personalizada utilizando ABAP BADI, sin embargo, en este blog, solo cubriré la ejecución de operaciones API.

Crear la nueva CBO

El primer paso en el proceso es crear un nuevo objeto comercial personalizado, en el que podamos probar las llamadas a la API. Para ello, utilice la aplicación Fiori «Objetos comerciales personalizados» y cree una nueva CBO.

Crear CBO

Agregar nodos y campos

Una vez dentro de la CBO, active la casilla de verificación «Interfaz de usuario» en la pestaña Información general. Esto generará automáticamente una interfaz de usuario y un servicio de back-end asociado con su CBO.

Generar interfaz de usuario para CBO

A continuación, en la pestaña Campos, agregue algunos campos que desee utilizar en su CBO y defina al menos uno de ellos como campo clave. En esta demostración, usaré un escenario ficticio en el que quiero que mi CBO muestre una lista de pedidos de venta seleccionados arbitrariamente junto con sus respectivas fechas de entrega.

Agregar campos a la CBO

Una vez hecho esto, haga clic en Publicar. Después de publicar, vuelva a la pestaña «Información general» y haga clic en el Ir a la interfaz de usuario generada enlace, que ya habrá sido activado. Cree una entrada de prueba en la interfaz de usuario, de modo que tengamos algunos datos de prueba para nuestra solicitud GET más adelante.

Interfaz de usuario de CBO con entrada de prueba

Cree una comunicación personalizada. Escenario y arreglo de comunicación para la CBO

Una vez que se ha creado y publicado la CBO, el siguiente paso es crear un acuerdo de comunicación para ella. Para ello, utilice la aplicación Fiori “Escenarios de comunicación personalizados”. Después de crear una nueva comunicación personalizada. escenario, haga clic en Agregar en la pestaña «Servicios entrantes». Aquí, busque el identificador del CBO creado en el primer paso y agréguelo como un servicio de entrada. Podemos ignorar los servicios de salida por ahora, ya que no son pertinentes para probar las operaciones de la API en nuestra CBO. Guarde y publique la comunicación personalizada. Guión.

comunicación personalizada escenario con servicio entrante

El último paso es crear ahora un arreglo de comunicación para nuestra comunicación personalizada. Guión. Vaya a la aplicación «Arreglos de comunicación» y cree un nuevo arreglo seleccionando la ID del escenario creado en el paso anterior. Seleccione una comunicación apropiada. Sistema y usuario para la comunicación entrante y guardar el arreglo.

Crear com. acuerdo

Con esto, toda la configuración para ejecutar operaciones API en nuestro CBO está completa. Pasemos ahora al hacer real. Usaremos Postman como una herramienta para probar las llamadas a la API.

OBTENER datos de nuestra CBO

• Copie la URL del servicio de entrada del archivo comm. Arregle y use esto como URL de solicitud en Postman.
• En la pestaña Autorización, seleccione «Autenticación básica» e ingrese el nombre de usuario y la contraseña de su usuario de comunicación.
• Ejecute la solicitud y debería ver el siguiente resultado

Obtener solicitud para el nodo raíz de CBO

• En la respuesta, vemos que la Vista CDS del acuerdo de comunicación muestra nuestra CBO como una entidad existente. Agregue este valor a la URL de solicitud y ejecute el resultado para ver los resultados reales de los datos de nuestro CBO, que se verá así:

CBO obtener todos los datos

• Vemos que la entrada de prueba que agregamos en la interfaz de usuario se recupera a través de la llamada API al servicio de entrada de la CBO. En el caso de que haya múltiples registros de datos en la CBO, también podemos ejecutar una solicitud para obtener los datos de una sola Orden de Venta. Esto es un poco más complicado, ya que usar el parámetro de filtro habitual que se usa para los puntos finales de la API estándar no produce el resultado deseado. Como puede ver en la captura de pantalla a continuación, la solicitud GET devuelve todos los registros de datos a pesar de filtrar solo para un pedido de venta en particular.
  
• La solución para esto es usar el GUID del registro de datos, como se destaca en el cuadro verde. Agregue este GUID a la URL de solicitud de la siguiente manera para producir el resultado deseado.
  

POST datos en CBO

Ahora veamos cómo publicar datos en nuestra CBO desde una fuente externa.

• Para solicitudes POST, requerimos un token CSRF para validar nuestra solicitud. Puede obtener un token configurando un encabezado con la clave «x-csrf-token» y el valor «Fetch» (el método de solicitud es GET).
  
• Ahora cambie el método de solicitud a POST y reemplace el valor del encabezado «Obtener» con el valor del token de la respuesta. En la pestaña del cuerpo, puede establecer la estructura de los datos que desea publicar en formato JSON y enviar la solicitud.
  
• Puede ver el resultado final de la operación en la interfaz de usuario de CBO.
  

Para operaciones POST como solicitudes por lotes (creación de múltiples Entregas en una sola solicitud), consulte el Blog por Marty McCormick, que ofrece un tutorial paso a paso para esto.

ELIMINAR datos de nuestro CBO

Finalmente, veamos cómo eliminar una entrada en nuestro CBO a través de una llamada API

• Similar a la solicitud para obtener una sola entrada, necesitamos usar el GUID del registro de datos para eliminarlo. Aquí también, debemos proporcionar un token x-csrf válido en el encabezado de la solicitud.
• Con el mismo GUID de la solicitud de obtención anterior (que identifica el pedido de venta 342179), establecemos el método de solicitud en ELIMINAR y ejecutamos la solicitud.
  
  No hay una respuesta visible en Postman después de la solicitud, pero puede ver el cambio reflejado en la interfaz de usuario, y el pedido de ventas 324179 ya no se muestra.
  

Para eliminar varias entradas, consulte la Blog por Eileen Koehler, que ofrece un tutorial paso a paso para esto.

Conclusión

El uso de CBO como parte de la extensibilidad de usuario clave que se ofrece dentro de S/4HANA Cloud es una solución liviana para adaptar y mejorar los objetos comerciales estándar con lógica personalizada para satisfacer las necesidades específicas de los clientes. Es posible configurar servicios de entrada y salida para su CBO y ejecutar las operaciones API estándar en la CBO utilizando el servicio de entrada. Con suerte, esta publicación de blog arrojará algo de luz sobre cómo configurar una CBO y manejar las operaciones API fundamentales asociadas con ella. Dado que esta publicación cubrió los casos de uso del servicio entrante para la CBO, consulte el entrada en el blog por Taranam Dhindsa para explorar cómo configurar servicios de salida con objetos comerciales personalizados.