Le SDK Digital et les extensions d'interface utilisateur du SDK Digital
En tant que développeur front-end créant des applications Jutro sur Guidewire Cloud, vous devez établir une interface avec InsuranceSuite à l'aide de Cloud API. Ce processus implique souvent l'écriture d'un code répétitif davantage axé sur les aspects techniques de l'interaction avec les API que sur la logique métier de base de votre application.
Pour vous aider à aligner votre code sur la sémantique métier, le SDK Digital et les extensions de l'interface utilisateur du SDK Digital vous permettent d'écrire du code dans un style plus déclaratif, ce qui réduit le volume standard associé à la logique liée à InsuranceSuite et vous permet de vous concentrer sur la logique métier de votre application.
Présentation du SDK Digital
Le SDK Digital est un ensemble d'outils conçus pour faciliter l'interaction avec InsuranceSuite Cloud API dans les applications JavaScript et TypeScript.
Contrairement aux bibliothèques traditionnelles publiées dans un registre de package, le SDK Digital est généré directement dans votre application à l'aide d'une interface de ligne de commande (CLI). Cette CLI lit les définitions OpenAPI et les schémas d'entité à partir de InsuranceSuite et génère un SDK Digital unique adapté à votre back-end spécifique.
Vous pouvez générer le SDK Digital à l'aide de la CLI Jutro (lorsqu'il est utilisé avec les extensions de l'interface utilisateur du SDK Digital) ou de la **CLI du SDK Digital ** (pour une utilisation autonome).
Les principales fonctionnalités du SDK Digital sont les suivantes :
- Types TypeScript pour vos entités InsuranceSuite.
- Fonctions de requête d'API pour une interaction transparente avec Cloud API.
- Fonctions de schéma et de validation qui répliquent les règles définies dans InsuranceSuite.
Le SDK Digital fonctionne indépendamment du reste de Jutro. Pour en savoir plus sur le SDK Digital, voir la documentation sur le SDK Digital.
Présentation des extensions de l'interface utilisateur du SDK Digital
Les extensions d'interface utilisateur du SDK Digital sont un ensemble d'abstractions générées qui étendent le SDK Digital pour qu'il fonctionne plus efficacement dans les applications basées sur React en tirant parti des primitives disponibles uniquement dans React.
Ces extensions d'interface utilisateur suivent la même approche générative que le SDK Digital. Après avoir traité les définitions OpenAPI et les schémas IS à partir de InsuranceSuite, la CLI Jutro génère le SDK Digital au sein de votre application. Les extensions d'interface utilisateur du SDK Digital sont générées dans un répertoire séparé JutroUtils et utilisent le SDK Digital comme dépendance.
Les principales fonctionnalités des extensions d'interface utilisateur du SDK Digital étendent les fonctionnalités du SDK Digital à l'écosystème React :
- Gestion de l'état React à l'aide des types d'entité du SDK Digital.
- Validation d'entité avec état React à l'aide des fonctions de schéma du SDK Digital.
- Composants React qui connectent vos entités IS aux composants Jutro Design System.
Pour en savoir plus sur les modèles Jutro, reportez-vous à la documentation sur les modèles d’application Jutro.
Identifier l'outil adapté à votre cas d'utilisation
Le tableau ci-dessous souligne les principales différences entre le SDK Digital et les extensions d'interface utilisateur. À l'aide de ces informations et en fonction des exigences de votre application, voici les cas d'utilisation les plus courants avec les approches d'implémentation recommandées :
Applications React avec Jutro Design System
Pour les développeurs qui créent des applications React avec InsuranceSuite Cloud API et Jutro Design System, l'approche recommandée consiste à utiliser une combinaison des composants de champ d'entité et des crochets d'entité générés des extensions d'interface utilisateur du SDK Digital.
Les composants de champ d'entité fournissent des avis prescrits sur la représentation des champs dans l'interface utilisateur et automatisent l'application de règles et la validation d'entités à l'aide de schémas InsuranceSuite. Ils constituent l'alternative la plus rapide pour créer une application entièrement fonctionnelle et permettent de remplacer une partie importante des avis sur l'interface utilisateur lorsqu'une personnalisation supplémentaire est nécessaire.
Si vos exigences ne peuvent pas être satisfaites à l'aide des options de remplacement disponibles dans les composants de champs d'entité, vous pouvez obtenir un contrôle total en mappant les informations à partir des crochets d'entité à n'importe quel composant Jutro Design System.
Applications React avec interfaces utilisateur personnalisées
Si vous développez une application React avec un système de conception différent, il est préférable d'utiliser les crochets d'entité des extensions d'interface utilisateur du SDK Digital.
Cette approche vous permet d'utiliser la gestion de l'état React au niveau de l'entité et l'application dynamique des règles, tout en gardant le contrôle sur la conception de l'interface utilisateur. L'utilisation de crochets et de fournisseurs n'inclura pas Jutro Design System dans votre bundle d'applications.
Applications JavaScript/TypeScript uniquement
Pour les développeurs qui créent des applications non React en JavaScript ou TypeScript, l'utilisation du SDK Digital de base est la meilleure solution.
Cette option fournit des fonctionnalités essentielles telles que les types TypeScript, les fonctions de demande d'API REST et les fonctions de schéma qui implémentent des règles et la validation à l'aide de schémas IS. Elles sont indépendantes de la couche d'interface utilisateur, de sorte qu'elles n'ont aucune dépendance vis-à-vis de React ou de Jutro Design System.
Pour générer un SDK Digital sans extensions d'interface utilisateur, vous devez le générer à l'aide de la CLI du SDK Digital, car cette option n'est pas disponible dans la CLI Jutro.
Pour en savoir plus sur l'utilisation du SDK Digital sans les extensions d'interface utilisateur, reportez-vous à la documentation sur le SDK Digital