SAP Cloud SDK versión 3

¡Se lanza SAP Cloud SDK para JavaScript versión 3! 🎉

Esta es una versión importante que trae nuevas funciones y mejora considerablemente las API.

Obtenga la nueva versión en npmjs.com.

Descubra todo sobre las mejoras en la nueva versión en esta publicación de blog y descubra quién hace más compromisos con el repositorio SAP Cloud SDK for JavaScript.

¿Qué hay de nuevo?

Middlewares

Los middlewares son un concepto poderoso y flexible que permite agregar una lógica personalizada antes de que se envíen las solicitudes HTTP, similar a los marcos web conocidos como Express o NestJS. Por ejemplo, le permiten agregar encabezados personalizados a las solicitudes HTTP o realizar cambios en el cuerpo de la solicitud.
También puede usarlo para crear las funciones de resiliencia tal como las necesita para su aplicación, en caso de que los valores predeterminados no funcionen para usted.

Para obtener más información sobre cómo puede usar middlewares, consulte la documentación de software intermedio.

Resiliencia

La resiliencia es la capacidad de su aplicación para reaccionar ante fallas y seguir siendo funcional. El objetivo no es evitar fallas a toda costa, sino manejarlas con gracia y aun así brindar una buena experiencia a los usuarios.
El SDK de SAP Cloud para JavaScript tiene una configuración predeterminada para funciones de resiliencia, como disyuntores, reintentos y tiempos de espera integrados, solo necesita habilitarlo.
Si necesita crear características más complejas, lo tenemos configurado con los middlewares: simplemente cree el suyo propio.

Para obtener más información sobre la resiliencia y cómo puede crear su propia configuración, consulte la entrada del blog sobre Resiliencia y el documentación de resiliencia.

También puede unirse a nosotros en nuestro SAP Community Call sobre resiliencia el 2 de marzo de 2023 a la 1:00 p. m. (CET) para obtener algunas impresiones prácticas.

Mandando correos electrónicos

El envío de correos electrónicos a través de SAP Business Technology Platform ya era posible en la versión 2, pero la API aún era «experimental». En la versión 3, la función es totalmente compatible y tiene la misma estabilidad que otras funciones de SAP Cloud SDK for JavaScript.

Para obtener más información sobre cómo enviar correos electrónicos, consulte la documentación en el cliente de correo.

¿Qué ha cambiado?

Generadores OData y OpenAPI mejorados y optimizados

Los generadores de SAP Cloud SDK para clientes tipificados para API de OData y OpenAPI se han mejorado y simplificado. Con el tiempo las opciones de ambas generaciones habían divergido. En la versión 3, las opciones están mejor alineadas para que la misma opción en ambos generadores tenga el mismo nombre y comportamiento.
Para hacer esto, se requirieron algunos cambios importantes y se debe adaptar el uso al actualizar SAP Cloud SDK para JavaScript de la versión 2 a la versión 3.

Clientes pregenerados descontinuados

Nos dimos cuenta de que muchos usuarios preferían usar clientes generados a medida en lugar de los pregenerados. Por lo tanto, decidimos dejar de publicar clientes generados previamente para los servicios de SAP en NPM. A partir de ahora, utilice los generadores de clientes mejorados para OData y OpenAPI para generar los suyos propios.
Puede encontrar todas las especificaciones para los servicios de SAP en el Centro de negocios API de SAP. Siga la pestaña SAP Cloud SDK en las páginas de detalles de la API para obtener instrucciones.

Requisitos de tiempo de ejecución de Node.js

Dado que las versiones anteriores de Node.js alcanzarán fin de la vida en 2023, SAP Cloud SDK para JavaScript requerirá Node.js 18 (la versión LTS actual) como tiempo de ejecución a partir de la versión 3.
Node.js 18 está disponible en SAP Business Technology Platform, Cloud Foundry Environment. Ver el esta página en el portal de ayuda de SAP para obtener detalles sobre cómo usarlo.

¿Cómo actualizar?

Aparte de los cambios y anteriores, también eliminamos algunas funciones obsoletas y simplificamos algunos tipos en SAP Cloud SDK. Dado que las mejoras y simplificaciones de la API requirieron algunos cambios importantes, la actualización a la versión 3 puede requerir algunos cambios en su aplicación.

Ver el completo guía de actualización y Haznos saber si tiene problemas durante la actualización o si algo no está cubierto en la guía.

Tus comentarios importan

Además de todo el trabajo en el código y la documentación de SAP Cloud SDK, también hemos mejorado la forma en que realizamos la investigación de usuarios en el último año.

Queremos entender mejor a nuestros usuarios

Tuvimos una primera ronda de entrevistas de usuarios con colegas de SAP, pero también planeamos expandir esto a nuestra comunidad global. Todavía no tenemos los detalles resueltos, pero si desea voluntario para una entrevista de una hora más adelante este año, siéntase libre de comunicarse en los comentarios o en la discusión de GitHub.

Hilo de comentarios de la versión 3

Háganos saber lo que piensa acerca de la versión 3 en este Discusión de GitHub.
Tenemos curiosidad acerca de su experiencia de actualización, sus deseos de nuevas versiones y sugerencias sobre cómo podemos ayudarlo a ser más productivo mientras crea excelentes aplicaciones en SAP Business Technology Platform.

Llamada comunitaria

Si está interesado en la resiliencia y las actualizaciones generales sobre SAP Cloud SDK para JavaScript, puede unirse a nuestra llamada comunitaria el 2 de marzo de 2023 a la 1:00 p. m. (CET).

Regístrese para la llamada comunitaria “Acepte el fracaso: cree aplicaciones resilientes con SAP Cloud SDK para JavaScript” en la página de la comunidad SAP.

Hechos graciosos

• La versión 2 se lanzó el 3 de febrero de 2022, lo que significa que casi logramos desarrollar la versión 3 en un año.
• El colaborador con más compromisos con el SDK de Cloud es… dependebot. Por un amplio margen. Gracias por mantener nuestras dependencias actualizadas 🙂