Das Digital SDK und Digital SDK UI Extensions

Als Frontend-Entwickler, der Jutro-Apps in der Guidewire Cloud erstellt, müssen Sie über Cloud-APIs mit InsuranceSuite kommunizieren. Dieser Prozess umfasst häufig das Schreiben von sich wiederholendem Code, der sich mehr auf die technischen Aspekte der API-Interaktion als auf die Kerngeschäftslogik Ihrer Anwendung konzentriert.

Um Sie bei der Anpassung Ihres Codes an die Geschäftssemantik zu unterstützen, können Sie mit dem Digital SDK und den Digital SDK UI Extensions Code in einem stärker deklarativen Stil schreiben, wodurch die mit InsuranceSuite-bezogener Logik verknüpften Textbausteine reduziert werden und Sie sich auf die Geschäftslogik Ihrer Anwendung konzentrieren können.

Einführung in das Digital SDK

Das Digital SDK ist ein generierter Satz von Tools zur Erleichterung der Interaktion mit InsuranceSuite Cloud-APIs in JavaScript- und TypeScript-Anwendungen.

Im Gegensatz zu herkömmlichen Bibliotheken, die in einer Paketregistrierung veröffentlicht werden, wird das Digital SDK direkt in Ihrer Anwendung über eine Befehlszeilenschnittstelle (CLI) generiert. Diese CLI liest die OpenAPI-Definitionen und die Entitätsschemas aus InsuranceSuite und generiert ein eindeutiges, auf Ihr spezifisches Backend zugeschnittenes digitales SDK.

Sie können das Digital SDK entweder mit der Jutro CLI (bei Verwendung zusammen mit den Digital SDK UI Extensions) oder mit der Digital SDK CLI (zur eigenständigen Verwendung) generieren.

Zu den wichtigsten Funktionen des Digital SDK gehören:

• TypeScript-Typen für Ihre InsuranceSuite-Entitäten.
• API-Anforderungsfunktionen für die nahtlose Interaktion mit den Cloud APIs.
• Schema- und Validierungsfunktionen, die die in InsuranceSuite definierten Regeln replizieren.

Das Digital SDK funktioniert unabhängig vom Rest von Jutro. Weitere Informationen zum Digital SDK finden Sie in der Dokumentation zum Digital SDK.

Einführung in Digital SDK UI Extensions

Die Digital SDK UI Extensions sind eine Reihe generierter Abstraktionen, die das Digital SDK erweitern, um in React-basierten Anwendungen effektiver zu arbeiten, indem sie Primitive nutzen, die nur in React verfügbar sind.

Diese UI-Erweiterungen folgen demselben generativen Ansatz wie das Digital SDK. Nach der Verarbeitung der OpenAPI-Definitionen und der IS-Schemas aus InsuranceSuite generiert die Jutro CLI die Digital SDK in Ihrer Anwendung. Die Digital SDK UI Extensions werden in einem separaten JutroUtils-Verzeichnis generiert und verwenden das Digital SDK als Abhängigkeit.

Die wichtigsten Funktionen der Digital SDK UI Extensions erweitern die Funktionen des Digital SDK auf das React-Ökosystem:

• React-Statusverwaltung mithilfe der Entitätstypen des Digital SDK.
• React-Validierung zustandsorientierter Entitäten mithilfe der Schemafunktionen des Digital SDK.
• React-Komponenten, die Ihre IS-Entitäten mit den Jutro Design System-Komponenten verbinden.

Note: Die Vorlage „Digital SDK UI Extensions“ veranschaulicht verschiedene Anwendungsfälle der Digital SDK UI Extensions-Komponenten.

Weitere Informationen zu Jutro-Vorlagen finden Sie in der Dokumentation zur Jutro-App-Vorlage.

Identifizieren des richtigen Tools für Ihren Anwendungsfall

In der folgenden Tabelle werden die wichtigsten Unterschiede zwischen dem Digital SDK und den UI-Erweiterungen hervorgehoben. Mit diesen Informationen und basierend auf den Anforderungen Ihrer Anwendung sind hier die häufigsten Anwendungsfälle mit den empfohlenen Implementierungsansätzen aufgeführt:

Note: Die oben genannten Anwendungsfälle sind nicht exklusiv. Angesichts des vielschichtigen Charakters der Lösung ist zu erwarten, dass verschiedene Anwendungsfälle kombiniert werden können, sogar in derselben Anwendung.

React-Anwendungen mit dem Jutro Design System

Für Entwickler, die React-Anwendungen mit InsuranceSuite-Cloud-APIs und dem Jutro Design System erstellen, wird empfohlen, eine Kombination aus den generierten Entitätsfeldkomponenten und Entitäts-Hooks der Digital SDK UI Extensions zu verwenden.

Die Entitätsfeldkomponenten bieten vorgegebene Aussagen zur UI-Darstellung der Felder und automatisieren die Anwendung von Regeln und die Entitätsvalidierung mithilfe von InsuranceSuite-Schemas. Sie stellen die schnellste Alternative zum Erstellen einer voll funktionsfähigen Anwendung dar und ermöglichen es, einen wesentlichen Teil der Aussagen der Benutzeroberfläche zu überschreiben, wenn zusätzliche Anpassungen erforderlich sind.

Falls Ihre Anforderungen nicht mit den Überschreibungsoptionen in den Entitätsfeldkomponenten erfüllt werden können, können Sie die volle Kontrolle erlangen, indem Sie die Informationen aus den Entitäten-Hooks einer beliebigen Komponente von Jutro Design System zuordnen.

React-Anwendungen mit benutzerdefinierten UIs

Wenn Sie eine React-Anwendung mit einem anderen Designsystem entwickeln, ist die bevorzugte Alternative die Verwendung der Entitäts-Hooks aus den Digital SDK UI Extensions.

Dieser Ansatz ermöglicht es Ihnen, die React-Statusverwaltung auf Entitätenebene und die zustandsorientierte Anwendung von Regeln zu verwenden und gleichzeitig die Kontrolle über das Design der Benutzeroberfläche zu behalten. Durch die Verwendung der Hooks und Anbieter ist das Jutro Design System nicht in Ihrem Anwendungspaket enthalten.

Nur-JavaScript-/TypeScript-Anwendungen

Für Entwickler, die Nicht-React-Anwendungen in JavaScript oder TypeScript erstellen, ist die Verwendung des einfachen Digital SDK die beste Wahl.

Diese Option bietet unverzichtbare Funktionen wie TypeScript-Typen, REST-API-Anforderungsfunktionen und Schemafunktionen, die Regeln und Validierungen mithilfe von IS-Schemas implementieren. Sie sind unabhängig von der Benutzeroberflächenebene und sind daher nicht von React oder dem Jutro Design System abhängig.

Um ein Digital SDK ohne UI Extensions zu generieren, müssen Sie es mit der Digital SDK CLI erzeugen, da diese Option in der Jutro CLI nicht verfügbar ist.

Weitere Informationen zur Verwendung des Digital SDK ohne UI Extensions finden Sie in der Dokumentation zum Digital SDK