Zum Hauptinhalt springen

FAQ für Entwickler

Onboarding und Zugriff​

Wie erhalte ich Zugriff auf Jutro Web Apps in Guidewire Cloud Home?​

Für den Zugriff auf Jutro Web Apps benötigen Sie bestimmte Gruppenzuweisungen. Weitere Informationen dazu, welchen Gruppen Sie zugewiesen werden müssen, finden Sie unter Zugriff auf Jutro Web Apps.

Ich kann nicht auf das Guidewire Binary Repository zugreifen. Wie kann ich das Problem beheben?​

Zum Installieren von Anwendungsabhängigkeiten benötigen Sie Zugriff auf das Guidewire Binary Repository. Sie können den Zugang über ein Cloud-Ticket beantragen. Weitere Informationen finden Sie unter Zugriff auf Jutro Web Apps .

Builds, Bereitstellungen und Aktualisierungen​

Wenn ich auf meine bereitgestellte Anwendung zugreifen möchte, wird eine Fehlermeldung angezeigt. Warum?​

Sie müssen die IP-Adressen konfigurieren, die auf Ihre Anwendung zugreifen können. Weitere Informationen finden Sie unter Einrichten einer IP-Allowlist für Ihre Anwendung.

Mein App-Build schlägt fehl. Wie kann ich das Problem beheben?​

Dies kann unterschiedliche Gründe haben. Im TeamCity-Build-Protokoll finden Sie weitere Details.

Bleiben Bereitstellungsvariablen aus früheren Bereitstellungen dauerhaft erhalten?​

Dies hängt davon ab, ob Sie Ihre Anwendung erneut bereitstellen oder eine neue Bereitstellung auslösen. Bei einer erneuten Bereitstellung werden dieselben Variablen wiederverwendet, bei einer neuen Bereitstellung jedoch nicht. Siehe auch Bereitstellungsvariablen.

Ich sehe eine Pull-Anforderung zur Aktualisierung. Wer erstellt diese Anforderungen, und wer muss sie zusammenführen?​

Dabei handelt es sich um einen automatisierten Guidewire-Prozess, der eine Pull-Anforderung (Pull Request, PR) erstellt, um den Standard-Branch Ihrer Anwendung auf die neueste Version der Jutro-Bibliotheken zu aktualisieren. Sie müssen die Pull-Anforderung überprüfen und zusammenführen.

Digital SDK​

Unterstützt das Digital SDK alle Cloud-APIs?​

Nein, das Digital SDK unterstützt nur einen Teil der Cloud-APIs. Weitere Informationen finden Sie in der Liste der generierten APIs in der Dokumentation zum Digital SDK.

Beim Aufrufen der Cloud-APIs wird ein CORS-Fehler ausgegeben. Wie kann ich den Fehler beheben?​

CORS-Fehler werden durch Sicherheitsfunktionen des Browsers verursacht, die Anforderungen an verdächtige URLs blockieren sollen. Hier ein paar Vorschläge, was Sie bei der Behebung dieses Problems überprüfen können:

  • Vergewissern Sie sich, dass Sie eine API-URL und keine UI-URL verwenden, z. B. als entsprechenden Wert JUTRO_X_CLOUD_API_URL in den Dateien .env oder config.json Ihrer Anwendung.
Note: InsuranceSuite UI-URL: Wie von Guidewire Cloud Platform UI vorgegeben
<appType>-<environment>-<project>.<tenant>.<clusterBaseDomain>
Beispiel: cc-qa1-iscs.acme.mdev.guidewire.net

API-URL: Derzeit in Guidewire Cloud Platform UI nicht sichtbar
<appType>-<environment>-<tenant>-<project>.api.<clusterBaseDomain>
Beispiel: cc-qa1-acme-iscs.api.mdev.guidewire.net`

  • Stellen Sie sicher, dass Ihre cors_policies-1.0.swagger.yaml-Datei im Backend für Ihre neue API richtig festgelegt wurde. Weitere Informationen finden Sie unter „The Swagger X-GW-CORS-policy“ (Die Richtlinie für Swagger X-GW-CORS) im Framewok der REST API.

Wenn diese Korrekturen nicht funktionieren, kann dies auf ein allgemeineres Verbindungsproblem hindeuten, z. B. strenge VPN-Anforderungen oder zusätzliche serverseitige Sicherheitseinschränkungen. Die Dokumentation von Mozilla zu CORS und die Dokumentation von Facebook zum Erlernen von React können hilfreiche Ressourcen für die weitere Fehlerbehebung sein.

Lassen sich Jutro-Anwendungen auch in andere Backend-Systeme als das von Guidewire integrieren?​

Ja. Wenn für diese Systeme mehrere Authentifizierungsmechanismen erforderlich sind, empfiehlt sich die Verwendung von Guidewire Integration Gateway. Klären Sie die Besonderheiten Ihres Anwendungsfalls mit dem zuständigen Guidewire-Mitarbeiter.

Wie kann ich eigene Designsystemkomponenten für Produktschemafelder rendern?​

Sie müssen einen eigenen Schema-Adapter schreiben, der der React-Komponente JutroSchemaAdapter entspricht.

Wie kann ich mehrere Instanzen für das Digital SDK (PolicyCenter SDK, ClaimCenter SDK) mit der richtigen Authentifizierung in meiner Anwendung initialisieren und konfigurieren?​

Sie müssen sich nur einmal mit Guidwire Hub authentifizieren, um Zugriff auf alle in Guidewire Cloud verfügbaren Dienste zu erhalten.

Warum geben die Validierungsfunktionen keinen Fehler zurück, wenn Minimal- und Maximalwerte für Deckungsbedingungen vom Typ Zahl verwendet werden?​

Dieses Symptom wird durch ein Problem mit den Cloud-APIs verursacht. Sie müssen die Minimal- und Maximallogik im Frontend replizieren.

Ich habe eine Sparte in PolicyCenter installiert und das SDK generiert, aber die Regeln werden nicht mehr ausgeführt. Woran liegt das?​

Dies ist auf ein Problem mit den Cloud-APIs und den installierten Sparten zurückzuführen. Sie können die Entwurfszeit-APIs in PolicyCenter beim Generieren des Digital-SDK erneut aktivieren.

Die Funktionen des AccountContact-Schemas und die Validierungsfunktionen geben ungültige Einschränkungen und Meldungen zurück​

Die Rückgabe von ungültigen Einschränkungen und Meldungen, z. B. dass Felder gleichzeitig erforderlich und nicht zulässig sind, ist auf ein Problem mit den Cloud-APIs zurückzuführen. Verwenden Sie die getAccountContactSchema-Funktionen nicht, bis das Problem behoben ist.

Jutro Design System​

Warum Jutro Design System?​

Designsysteme, die Jutro ähneln, sind in den letzten fünf Jahren für größere Softwareanbieter zur neuen Normalität geworden: Salesforce Lightning, IBM Carbon und SAP Fiori, um nur einige zu nennen, gehen alle die gleichen Probleme an:

  • Schaffung einer einheitlichen, kohärenten Erfahrung für Benutzer, die nicht nur benutzbar ist, sondern auch dazu beiträgt, dass Menschen bei ihrer Arbeit über sich hinauswachsen.
  • Befähigung von Designern, sich auf das Nutzungserlebnis ihrer Lösung zu konzentrieren, anstatt die gleichen UI-Muster (z. B. eine Schaltfläche oder eine Tabelle) immer wieder neu gestalten zu müssen.
  • Beschleunigung der Entwicklung der Anwendungen mit wiederverwendbaren, oftmals reaktionsfähigen UI-Komponenten.
  • Visuelle Attraktivität durch Flexibilität, Styling und Themes.

Warum profitieren unsere Kunden von Jutro Design System?​

  • Geringere Kosten für die Schulung der Benutzer
  • Weniger Supportfälle
  • Verbesserte Entwicklungseffizienz und -effektivität
  • Einfachere Upgrades
  • Schnellere UX-Iterationen
  • Höheres Engagement der Benutzer

Beim Übergang von Guidewire in die Cloud sind ein Designsystem und ein UI-Framework für unseren Erfolg unerlässlich. Jutro Design System wurde 2019 entwickelt, um die Entwicklung von Guidewire-Cloud-Anwendungen zu beschleunigen.

Was ist Jutro Design System?​

Jutro Design System ist ein Kernelement von Jutro Digital Platform (JDP) und die empfohlene Methode zur Erstellung der Benutzeroberfläche von JDP-Anwendungen. Es umfasst Folgendes:

  • Designrichtlinien und -muster: Jutro Design System wurde für Designer konzipiert und umfasst eine Reihe von UI-Assets, die auf Grundlage bewährter Lösungen für wiederkehrende Designanforderungen (Abläufe, Verhalten und Interaktionen) entwickelt wurden.
  • Komponentenbibliothek: Jutro bietet Entwicklern eine Bibliothek mit vorgefertigten Komponenten, die als Standardimplementierung der Richtlinien und Muster des Design System dienen. Diese Komponenten beschleunigen das Design und fördern gleichzeitig die übergreifende Einheitlichkeit von Verbraucheranwendungen. Entwickler können diese Komponenten zur schnelleren Erstellung ihrer Anwendungen verwenden, indem sie Funktionen auf Komponentenebene, wie Lokalisierung, Designanpassung und Barrierefreiheit, nutzen. Sie können jede dieser Komponenten über ihre Eigenschaften konfigurieren.

Welche Browser und Versionen werden in Jutro Design System unterstützt?​

In den Versionshinweisen erfahren Sie, welche Browser in den einzelnen Versionen unterstützt werden.

Müssen wir Jutro Design System separat lizenzieren?​

Nein. Jutro Design System wird als Teil von Jutro Digital Platform und der Guidewire-Anwendungen geliefert, die es nutzen. Es ist jedoch nicht als eigenständiges Produkt erhältlich und kann nicht gekauft werden.

Sind bei der Aktualisierung von Jutro Design System Breaking Changes zu erwarten?​

In unserem Abschnitt zur API-Oberfläche finden Sie Informationen darüber, wie Breaking Changes gehandhabt werden. Einzelheiten zum Umgang mit Updates finden Sie in der Dokumentation zur Jutro-Plattform.

Was ist „Storybook“? Ist es ein UI-Editor?​

Storybook ist kein Produkt von Guidewire. Es handelt sich um ein Tool eines Drittanbieters, das als Explorer für Komponenten von Jutro Design System verwendet wird, in dem Sie deren Eigenschaften überprüfen und mit der Komponentenkonfiguration spielen können. Es ist eine hilfreiche Ressource für Entwicklungsteams bei der Implementierung von Jutro-Anwendungen, und es ist auch eine gute Ressource für Designer, um zu verstehen, was in Jutro Design System verfügbar ist.

Der Jutro UI-Komponenten-Explorer enthält nur Jutro Design System-Komponenten, die in der Basiskonfiguration enthalten sind. Er enthält keine benutzerdefinierten Komponenten, die von Kunden erstellt wurden.

Sind alle Jutro-Komponenten barrierefrei?​

Alle Jutro-Komponenten sind seit dem Version vom Mai 2020 barrierefrei (WAG 2.0 AA). Das eine Komponente barrierefrei ist, bedeutet jedoch nicht unbedingt, dass auch die Anwendung barrierefrei ist. Kunden, die Jutro-basierte Anwendungen modifizieren, müssen diese Anwendungen auf Barrierefreiheit prüfen. Produktteams, die neue Anwendungen auf Jutro erstellen, müssen Barrierefreiheitsprüfungen durchführen. Weitere Informationen finden Sie unter Barrierefreiheit.

Können Partner und Kunden ihre eigenen Komponenten erstellen und verwenden?​

Ja. Jutro-Apps sind React-basierte Standard-Webanwendungen. Das Hinzufügen eigener UI-Komponenten wird durch verschiedene Mechanismen unterstützt. Guidewire wird diese Komponenten jedoch nicht unterstützen oder warten und auch keine Garantie für ihre Aktualisierungsfähigkeit übernehmen.

Können Kunden die Verwendung von Jutro-Komponenten mit der Verwendung von reinem React-Code kombinieren (Mix und Match)?​

Benutzerdefinierte Komponenten können aus React- oder JavaScript-Komponenten von Drittanbietern bestehen und in Anwendungen zusammen mit den in der Basiskonfiguration enthaltenen Jutro Design System-Komponenten verwendet werden.

Beispiel: Eine benutzerdefinierte Komponente kann die D3JS-Bibliothek zur Erstellung einer Datenvisualisierungskomponente nutzen. Kunden können diese benutzerdefinierte Komponente dann auf einer Seite verwenden, die aus anderen Komponenten besteht, entweder Jutro-Standardkomponenten oder anderen benutzerdefinierten Komponenten. Guidewire unterstützt oder wartet diese Komponenten nicht und übernimmt auch keine Garantie für ihre Ausbaufähigkeit.

Wird es eine Plattform geben, auf der Kunden neue Jutro-Komponenten zu einer „Community“ beitragen können? (Dass also Kunden aktiv neue Komponenten von ihren globalen Kollegen per Crowdsourcing beziehen)?​

Wir entwickeln unsere Pläne rund um ein Jutro-Beitragsmodell.

Micro Frontends​

Inwiefern ist ein Micro Frontend anders oder besser als ein iframe?​

Ein iframe ist eine Implementierungsmethode für Micro Frontends. Jutro Digital Platform unterstützt zwei Arten der Einbettung von Jutro-Anwendungen als Micro Frontends:

  • Einbetten eines Micro-Frontend in einer Shell-Anwendung mit Module Federation
  • Einbetten eines Micro-Frontend als iframe-Link

Es gibt noch andere Methoden, z. B. Webkomponenten oder Integration zur Buildzeit, die jedoch nicht in der Basiskonfiguration von Jutro Digital Platform enthalten sind.

Limits für die Erstellung und Bereitstellung von Jutro-Anwendungen​

Wie kann ich die Standard-Limits für die Erstellung und Bereitstellung ändern?​

Die Limits für die Erstellung und Bereitstellung von Jutro-Anwendungen sind konfigurierbar. Sie müssen ein Ticket bei Guidewire Cloud Engineering einreichen, um eine Limitänderung (Erhöhung oder Verringerung) anzufordern.

Erstellen neuer Felder​

Wie kann ich sicherstellen, dass eine ID für ein neues Feld eindeutig ist?​

Sie müssen für ein neues Feld keine ID mit der Eigenschaft id erstellen. Neue Felder generieren intern eine eindeutige ID. Wenn Sie manuell eine ID erstellen und sicherstellen möchten, dass sie eindeutig ist, können Sie den Hook useId aus @jutro/platform verwenden. Weitere Informationen zum Hook useId finden Sie auf der Seite Hooks.

On this page