El SDK de Digital y las extensiones de la interfaz de usuario del SDK de Digital
Al ser desarrollador de frontend que crea aplicaciones de Jutro en Guidewire Cloud, deberá interactuar con InsuranceSuite mediante las Cloud API. Este proceso a menudo implica escribir código repetitivo que se centra más en los aspectos técnicos de la interacción con la API que en la lógica del negocio principal de la aplicación.
Para ayudarlo a ajustar su código a la semántica comercial, el **SDK de Digital ** y las extensiones de la interfaz de usuario del SDK de Digital le permiten escribir código en un estilo más declarativo, lo que reduce la repetición asociada con la lógica de InsuranceSuite y le permite centrarse en la lógica de negocio de su aplicación.
Introducción al SDK de Digital
El SDK de Digital es un conjunto generado de herramientas diseñadas para facilitar la interacción con las Cloud API de InsuranceSuite en aplicaciones de JavaScript y TypeScript.
A diferencia de las bibliotecas tradicionales que se publican en un registro de paquetes, el SDK de Digital se genera directamente en su aplicación mediante una interfaz de línea de comandos (CLI). Esta CLI lee las definiciones de OpenAPI y los esquemas de entidad de InsuranceSuite, y genera un SDK de Digital único adaptado a su backend específico.
Puede generar el SDK de Digital mediante Jutro CLI (cuando se utiliza junto con las extensiones de la interfaz de usuario del SDK de Digital) o la CLI del SDK de Digital (para uso independiente).
Algunas de las características clave del SDK de Digital:
- Tipos de TypeScript para sus entidades de InsuranceSuite.
- Funciones de solicitud de API para una interacción fluida con las Cloud API.
- Funciones de esquema y de validación que replican las reglas definidas en InsuranceSuite.
El SDK de Digital funciona independientemente del resto de Jutro. Para obtener más información sobre el SDK de Digital, consulte la documentación del SDK de Digital.
Introducción a las extensiones de la interfaz de usuario del SDK de Digital
Las extensiones de la interfaz de usuario del SDK de Digital son un conjunto de abstracciones generadas que amplían el SDK de Digital para que funcione de manera más eficaz en aplicaciones basadas en React, aprovechando primitivos que solo están disponibles en React.
Estas extensiones de la interfaz de usuario siguen el mismo enfoque generativo que el SDK de Digital. Después de procesar las definiciones de OpenAPI y los esquemas de IS de InsuranceSuite, Jutro CLI genera el SDK de Digital dentro de su aplicación. Las extensiones de la interfaz de usuario del SDK de Digital se generan en un directorio JutroUtils independiente y utilizan el SDK de Digital como una dependencia.
Las características clave de las extensiones de interfaz de usuario del SDK de Digital amplían la funcionalidad del SDK de Digital en el ecosistema de React:
- Administración del estado de React mediante los tipos de entidades del SDK de Digital.
- Validación de entidades con estado de React mediante las funciones de esquema del SDK de Digital.
- Componentes de React que conectan sus entidades IS con los componentes de Jutro Design System.
Para obtener más información sobre las plantillas de Jutro, consulte la documentación sobre plantillas de la aplicación de Jutro.
Cómo identificar la herramienta adecuada para su caso
En la siguiente tabla, se destacan las diferencias clave entre el SDK de Digital y las extensiones de la interfaz de usuario. Con esta información y en función de los requisitos de su aplicación, estos son los casos de uso más comunes con los métodos de implementación recomendados:
Aplicaciones de React que utilizan Jutro Design System
Para los desarrolladores que crean aplicaciones de React con Cloud API de InsuranceSuite y Jutro Design System, el método recomendado es el uso de una combinación de los componentes de campo de entidad y los ganchos de entidad generados de las extensiones de la interfaz de usuario del SDK de Digital.
Los componentes de campo de entidad proporcionan opiniones prescritas sobre la representación de los campos en la interfaz de usuario y automatizan la aplicación de reglas y la validación de entidades mediante esquemas de InsuranceSuite. Son la alternativa más rápida para crear una aplicación completamente funcional y permiten invalidar una parte importante de las opiniones de la interfaz de usuario cuando se necesita personalización adicional.
En caso de que sus requisitos no se puedan cumplir con las opciones de invalidación disponibles en los componentes de campo de entidad, puede obtener el control total asignando la información de los ganchos de entidad a cualquier componente de Jutro Design System.
Aplicaciones de React con interfaces de usuario personalizadas
Si está desarrollando una aplicación de React con un sistema de diseño diferente, la alternativa preferida es el uso de los ganchos de entidad desde las extensiones de la interfaz de usuario del SDK de Digital.
Este método le permite utilizar la administración del estado de React al nivel de la entidad y la aplicación con estado de las reglas, mientras mantiene el control sobre el diseño de la interfaz de usuario. El uso de ganchos y proveedores no incluirá Jutro Design System en su conjunto de aplicaciones.
Aplicaciones solo de JavaScript o TypeScript
Para los desarrolladores que crean aplicaciones que no sean de React en JavaScript o TypeScript, usar el SDK base de Digital es la mejor opción.
Esta opción proporciona funciones esenciales como tipos de TypeScript, funciones de solicitud de API REST y funciones de esquema que implementan reglas y validación utilizando esquemas de IS. Son independientes de la capa de interfaz de usuario, por ello, no tienen dependencias en React ni en Jutro Design System.
Para generar un SDK de Digital sin extensiones de la interfaz de usuario, deberá hacerlo con la CLI de la SDK de Digital, ya que esta opción no está disponible en Jutro CLI.
Para obtener más información sobre el uso del SDK de Digital sin las extensiones de la interfaz de usuario, consulte la documentación del SDK de Digital