Zum Hauptinhalt springen

Jutro Digital Platform Innsbruck

Jutro Digital Platform (JDP) ist in Innsbruck allgemein verfügbar, nachdem ein erfolgreiches Early-Access-Programm in den vorangegangenen Releases durchlaufen wurde. Im Folgenden finden Sie Einzelheiten zu den Neuerungen in den einzelnen Bausteinen von JDP.

Was ist neu in Jutro-Patch 10.0.10?​

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.10 behoben:

ID
Beschreibung
JUT-21683Das Abmeldeverhalten für die Okta- und OIDC-Auth-Clients wurde verbessert.
JUT-22215Die Anmeldung wird im Okta-Auth-Client für Seiten, für die keine Authentifizierung erforderlich ist, nicht mehr automatisch ausgelöst.
JUT-21714Das Feld main in Paket @jutro/eslint-config verweist nun auf den richtigen Eintrag.
JUT-21946Die okta-auth-js-Bibliothek wurde auf Version 7.8.1 aktualisiert.
JUT-21934eslint-config verwendet kein altes esm-Paket mehr, das Probleme mit Node 22 verursachte.
JUT-21785Die Webpack-Abhängigkeit in @jutro/cli-app wurde auf Version 5.95.0 aktualisiert.

Was ist neu in Jutro-Patch 10.0.9?​

Okta-Authentifizierungs-Client​

Die Okta-Authentifizierung wird jetzt im @jutro/auth-Paket unterstützt.

Um Okta zu aktivieren, legen Sie JUTRO_AUTH_USE_NATIVE_OKTA_CLIENT=true in Ihrer Umgebung fest. Der Okta-Authentifizierungs-Client wird wie der generische Client verwendet, abgesehen von den folgenden Verhaltensänderungen:

  1. Vereinfachter Ablauf für automatische Anmeldung und Authentifizierungs-Popup.
    Er verwendet einen benutzerdefinierten Mechanismus (response-mode: okta_post_message), um aktualisierte Token von einem ausgeblendeten iframe/popup an das Hauptfenster zu übergeben. Daher werden keine Anwendungsrouten geladen. Das bedeutet, dass die Variablen JUTRO_AUTH_SILENT_LOGIN_PATH und JUTRO_AUTH_SILENT_REDIRECT_PATH veraltet sind.

  2. Arbeitsspeicher als Token-Speicher. Es gibt keine Service-Worker-Option. Arbeitsspeicher als Token-Speicher ist die sicherste Option, die im nativen Okta-Client verfügbar ist. Es gibt zwei Unterschiede im Verhalten der App:

    1. Bei jedem Öffnen oder Aktualisieren einer Seite wird ein vollständiger Anmeldeablauf initiiert, um Token zu erhalten. Der Benutzer sieht einen Loader und /auth/callback ändert sich für kurze Zeit in der Navigation seines Browsers.
    2. Es findet keine Synchronisierung statt, jede Registerkarte verwendet ihre eigenen Token.

  3. Keine zusätzlichen Parameter. Bei der Abmeldung mit dem nativen Okta-Client werden zusätzliche Parameter aus JUTRO_AUTH_LOGOUT_QUERY_EXTRAS ignoriert.

Weitere Informationen zur Verwendung des nativen Okta-Clients finden Sie auf der Authentifizierungsdokumente-Seite.

Wenn Sie das veraltete native Okta-Authentifizierungspaket aus Version 8.12 oder früher verwendet haben, finden Sie Einzelheiten zu den Unterschieden in den Schritten zur Migration des Auth-Clients.

Abkündigung von Node-Version 18​

Warning: Ab dem 30. April 2025 können Sie auf Node 18 keine neuen Apps mehr erstellen. Diese Version erreicht das Ende der Lebensdauer und erhält keine Sicherheitsupdates.

Das Ausführen veralteter Versionen kann Ihre Anwendung anfällig machen.

Sie können vorhandene Apps bis zum 30. September 2025 auf Node 22 migrieren. Aktualisieren Sie alle Anwendungen so bald wie möglich.

Die Wartung von Node 18 endet im April 2025 und wird nach diesem Datum nicht mehr unterstützt. Die Verwendung von Node 18 in Jutro wird abgekündigt und es wird empfohlen, auf Node 22.6.0 oder höher zu aktualisieren.

Führen Sie für die Migration die folgenden Schritte aus:

  • Aktualisieren Sie das Feld engines in package.json auf:
  "engines": {
    "node": ">=22.6.0 < 23",
    "npm": ">=10.8.2 "
  }
  • Wenn Sie NVM zum Verwalten von Node-Versionen verwenden, müssen Sie Ihre .nvmrc-Datei auf v22.6.0 aktualisieren.
  • Installieren Sie Node.js v22.6.0 (und entfernen Sie die alte Version, wenn Sie kein NVM-Benutzer sind).
  • Aktualisieren Sie alle Unit-Tests, die Intl verwenden (Node.js v22 wird entsprechend der neuesten Version von Intl aktualisiert).
  • Entfernen Sie node-sass aus package.json und fügen Sie es stattdessen in "sass": "1.81.0" ein.
    • Wenn Sie Probleme mit "sass": "1.81.0" haben, versuchen Sie es stattdessen mit "sass": "1.77.8" .

Um zu überprüfen, ob Ihre App noch mit einer neueren Version von Node.js funktioniert (z. B. in TeamCity-Pipelines), gehen Sie wie folgt vor:

  • Aktualisieren Sie das Feld engines in package.json auf:
  "engines": {
    "node": ">=22.6.0 < 23",
    "npm": ">=10.8.2 "
  }
  • Entfernen Sie node-sass aus package.json und fügen Sie es stattdessen in "sass": "1.81.0" ein.
    • Wenn Sie Probleme mit "sass": "1.81.0" haben, versuchen Sie es stattdessen mit "sass": "1.77.8" .
Warning: Bekanntes Problem

Eine Änderung im Übersetzungsprozess in Node 22 führt dazu, dass ein Leerzeichen durch ein schmales geschütztes Unicode-Leerzeichen ersetzt wird. Dies kann zu fehlgeschlagenen Unit-Tests führen, da dies nicht mit dem Regex-Muster \s übereinstimmt.

Note: Webpack 4 unterstützt Node 22 nicht, die Verwendung von Node 22 erfordert ein Update auf Webpack 5.
Note: Unterschiedliche Versionen von Node.js in lokalen und CI Umgebungen können zu einem inkonsistenten Verhalten von Unit-Tests für Komponenten führen, die Intl verwenden.

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.9 behoben:

ID
Beschreibung
JUT-21453Login-Weiterleitung entsprach nicht routerBasename.
JUT-21543Im generischen Auth-Client wurde die Sitzung nicht konsistent durch die Abmeldung beendet.
JUT-21448Die native Okta-Client-Übernahme in EnterpriseEngage wurde nicht unterstützt.
JUT-20881Nicht zugewiesenen Benutzern wurde der Zugriff verweigert und kein Fehler in iframe MFE angezeigt.
JUT-20972Aktivierung der Verwendung des Okta-Clients rückwirkend auf Release 10.0+.
JUT-21541Die Abmeldung des nativen Okta-Auth-Clients funktionierte nicht konsistent.
JUT-20929Die App wurde im Popup-Fenster anstatt in der Shell geöffnet.
JUT-20192Die Sitzung wurde nicht konsequent durch Abmeldung beendet.
JUT-21348okta-auth-js aktualisiert auf 7.7.1, wodurch ein Problem mit der Token-Erneuerung behoben wird.
JUT-20902@axa-fr/oidc-client auf die neueste Version für alle Releases seit 10.0.x aktualisiert.
JUT-21177DropdownSelectField und TypeaheadMultiSelectField-Dropdown in ModalNext eines Micro Frontends wurde hinter dem modalen Fenster gerendert.
JUTSDK-1560Ein Problem trat auf, wo BC und CM in initSDK manuell an die Backend-URL übergeben werden müssen.
JUT-20884Die Aktualisierung von Jutro von 8.13.2 auf 10.0.3 führte bei mehreren Komponenten zu einem Fehler bei Unit-Testfällen.
JUT-20970Die alte Validierung funktionierte nicht, wenn die Sichtbarkeit der Felder umgeschaltet wurde.
JUT-21226Die Loader-Komponente des Micro Frontends konnte nicht überschrieben werden.
JUT-19975Es bestand ein Problem, bei dem location.state bei der Übergabe von Variablen im Micro Frontend nicht definiert war.
JUT-21149Beim Ab- und Anmelden trat ein Authentifizierungsfehler auf, wenn der Benutzer 3 Registerkarten öffnete.
JUT-21272Es bestand ein Problem, bei dem das Micro Frontend im Unit-Test nach dem Wechsel zu Node 22 eine Weiterleitung durchführte.

Was ist neu in Jutro-Patch 10.0.8?​

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.8 behoben:

  • Es wurde ein Problem behoben, bei dem die JUTRO_AUTH_LOGIN_QUERY_EXTRAS-Parameter nicht hinzugefügt wurden, um von der automatischen Anmeldung ausgehende Aufrufe zu autorisieren. Dies führte dazu, dass ein inaktiver ProducerEngage-Benutzer zum Guidewire Hub-Anmeldefenster anstatt zu seinem IdP-Anmeldefenster geleitet wurde.
  • Es wurde ein Problem behoben, bei dem ein unabhängiger iframe auth nicht funktionierte, wenn der iframe Website-übergreifend war.
  • Es wurde ein Problem behoben, bei dem Tests fehlschlugen, weil kein Modal in der Barrierefreiheitsstruktur vorhanden war.

Was ist neu in Jutro-Patch 10.0.7?​

Verbesserungen und gelöste Probleme​

Das folgende Problem wurde in Patch 10.0.7 behoben:

  • Ein inaktiver ProducerEngage-Benutzer wurde zum Guidewire Hub-Anmeldefenster anstatt zum Anmeldefenster seines Identitätsanbieters weitergeleitet.

Was ist neu in Jutro-Patch 10.0.6?​

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.6 behoben:

  • devDependencies declarations wurde vor der Veröffentlichung aus package.json-Dateien entfernt, um die Generierung fälschlicherweise positiver Tickets zu verhindern.
  • Es wurde ein Problem behoben, bei dem die Sprache standardmäßig auf Englisch eingestellt wurde, wenn Globalization Store aktiviert war.
  • Es wurde ein Problem behoben, bei dem für jede Deklaration einer QuickView-Komponente ein QuickView-Wrapper erstellt wurde. Dadurch wurde das Rasterlayout in einem Grundriss unterbrochen, in dem mehr als zwei QuickViews vorhanden waren.
  • Es wurde ein Timeout-Problem behoben, bei dem GCH bei zu langer Inaktivität auf eine Okta-Seite mit der Meldung „429 Too Many Requests“ umleitete.
  • Es wurde ein Problem behoben, bei dem einige Seiten, die mit window.open() geöffnet wurden, nach der Anmeldung automatisch geschlossen wurden.
  • Es wurde ein Problem behoben, bei dem Jutro-Aktualisierungen aufgrund eines fehlenden core-js-Moduls fehlschlugen.
  • Ein Anzeigeproblem wurde behoben, bei dem die Kopfzeilen der Schnellansicht durch die obere Leiste/Kopfzeile in Guidewire Cloud Platform verdeckt wurden.

Was ist neu in Jutro-Patch 10.0.5?​

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.5 behoben:

  • Es wurde ein Problem mit der Barrierefreiheit behoben, bei dem bestimmte aria-Rollen bestimmte untergeordnete Elemente enthalten müssen.
  • Der Ordner mit den App-Symbolen wurde bereinigt und es wurde geändert, wie die -overrides-Eigenschaft in der per UI-Eject ausgelagerten Komponente und beim Bereinigen nach dem Eject übergeben wird.
  • Die Behandlung von null-Werten durch CurrencyInput wurde korrigiert, so dass statt eines Fehlers ein eindeutiger Wert zurückgegeben wird.
  • Ein Problem wurde behoben, bei dem die Verwendung von FileUploadField die Tests beschädigte, wenn es zusammen mit userEvent in Version 14 genutzt wurde.
  • Es wurde ein Micro Frontend-Timeout-Problem behoben, bei dem ein Fehler auftrat, selbst wenn iFrame korrekt geladen wurde.
  • Die Behandlung von Nullwerten durch multiple-combobox und multiple-select wurde korrigiert, so dass ein eindeutiger Wert anstelle eines Fehlers angezeigt wird.
  • Die Behandlung von Nullwerten durch NumberInput wurde geändert, um die API von NumberInput, Stepper und Amount sowie teilweise Currency zu vereinheitlichen.
  • Die Behandlung von Nullwerten durch phone-number-input wurde geändert, so dass ein eindeutiger Wert anstelle eines Fehlers angezeigt wird.
  • Es wurde ein Fehler im SDK behoben, indem ein Modifikator aus der Risikoerstellung entfernt wurde.
  • Es wurde ein Problem behoben, um die Beschreibung der SDK-Routing-Konfiguration klarzustellen.
  • Es wurde ein Problem mit visualisierten und installierten Produkten behoben, bei dem das Erzeugen von Schemas mit denselben Namen zu Problemen bei der Generierung führte.

Neue Funktionen in 10.0.5​

  • Für Micro Frontend-Apps gibt es jetzt CSS für benutzerdefinierte Modale.

Was ist neu in Jutro-Patch 10.0.3?​

Verbesserungen und gelöste Probleme​

Die folgenden Probleme wurden in Patch 10.0.3 behoben:

  • Schriftartbezogene Design-Token wurden nicht korrekt auf alle Dropdown-Komponenten angewendet. Eigenständige Dropdowns nahmen nicht die richtige Schriftart an.
  • Ein Problem, bei dem die Opazität auf einige Feldelemente doppelt angewendet wurde, wurde behoben.
  • Ein Szenario, in dem eine Funktion zur Validierung von Deckungsgruppen nicht die richtige Deckung validierte, wurde behoben.
  • Die PhoneInput-Komponente wurde anders gerendert als das Design in Figma. Daher konnte der Benutzer den Wert nicht aus dem Feld kopieren. Dies wurde behoben.
  • Ein Problem wurde behoben, bei dem zusätzliche Konfigurationseinstellungen innerhalb eines Micro Frontends mithilfe von setConfiguration vorgenommen wurden, die dann beim Laden des endgültigen Micro Frontends verloren gingen.
  • Probleme bei der Verwendung von QuickInfos mit Legacy-Komponenten oder der direkten Übergabe der ref-Eigenschaft wurden behoben.
  • Ein Problem, bei dem help-Komponenten aus componentMap entfernt und bei Verwendung in der Konfiguration des Grundrisses nicht gerendert wurden, wurde behoben.

Jutro Design System 10.0.3​

Jutro Design System 10.0.3 führt umstrukturierte Komponenten ein, die anders strukturiert sind als ihre Vorgänger. Diese Version enthält auch Abkündigungen. Weitere Informationen zu diesen Änderungen finden Sie unter Jutro Design System 10.0.

JDP UI -Bibliotheken 10.0.3​

Jutro Digital Platform bietet eine kuratierte Entwicklererfahrung mit vorgefertigten Konfigurationen und übergreifenden Funktionen. Diese Hilfsfunktionen sind als wiederverwendbare JavaScript-UI-Bibliotheken verfügbar, mit denen Sie schnell einzigartige Benutzeroberflächen für die Sach- und Unfallversicherungsbranche in Guidewire Cloud erstellen können. Dieses Release bietet einen neuen generischen Authentifizierungs-Client, Verbesserungen bei Micro Frontends und mehr. Weitere Informationen finden Sie im Abschnitt Entwickeln in der JDP-Dokumentation.

Jutro Web Apps​

Jutro Web Apps ist eine Verwaltungsanwendung, die Teil von JDP ist. Sie ermöglicht die Erstellung von Jutro-Apps aus Startvorlagen, das Löschen und die Verwaltung von Anwendungen und ist über eine neue, selbstbetitelte Kachel „Jutro Web Apps“ in Guidewire Cloud Home verfügbar.

Mit Jutro Web Apps können Entwickler schnell Webanwendungen für Schaden- und Unfallversicherer mit vielen Funktionen entwickeln, erstellen und testen. Sie können diese Apps auf der Guidewire Cloud Platform (GWCP) umfassend und selbständig bereitstellen. All dies ist mit minimaler Interaktion mit den Support-Teams von Guidewire möglich.

In den folgenden Abschnitten finden Sie Highlights einiger der Funktionen, die Jutro Web Apps bietet.

Einheitliche Ansicht für alle Apps in Ihrem Tenant​

  • Jutro Web Apps verfügt über eine Startseite, die eine filterbare Ansicht aller Apps zeigt, die innerhalb des Tenants erstellt wurden.
  • Es gibt auch eine Seite für die App-Einstellungen, auf der Sie die App-Konfigurationen verwalten können, z. B.:
    • IdP-definierte Benutzergruppen zur Steuerung des Zugriffs auf die App
    • Zugriff auf InsuranceSuite-Apps
    • Benutzerdefinierte Domänenregistrierung für Anwendungen in PreProd- und Prod-Umgebungen
    • Erstellen einer IP Allowlist zur Verwaltung des Zugriffs auf die App während des Testens
    • Vereinfachte InsuranceSuite-Auswahl im Bereitstellungsformular

Weitere Informationen finden Sie in der Dokumentation zu Jutro Web Apps.

Bereitstellungsfunktionen​

  • Automatische Build-Erstellung und Bereitstellung der App auf GWCP nach ihrer ersten Erstellung
  • Bitbucket-, TeamCity- und Anwendungsbereitstellungs-Links sind deaktiviert, wenn der Status der Anwendung ‚Fehlgeschlagen‘ oder ‚Wird gelöscht‘ lautet.
  • Eine QuickView, die den aktuellen Status der Limits für erstellte und hochgestufte Apps anzeigt
  • Übersetzbare Fehlermeldungen in der Bereitstellungs-Schnellansicht
  • Mehrere bereitgestellte Zweige können in der Bereitstellungstabelle angezeigt werden
  • Eine Auswahl zwischen stabiler und eindeutiger URL auf der Seite „Bereitstellungen“

Weitere Informationen finden Sie unter Veränderliche und unveränderliche Bereitstellungen.

Jutro Web App E2E-Tests (End-to-End):​

Als Entwickler eines Versicherers können Sie jetzt E2E-Tests für Ihre Jutro-App durchführen. Mit E2E-Tests können Sie validieren, dass Ihre Anwendung durchgängig funktioniert – von der Benutzeroberfläche bis hin zu den Integrationen mit InsuranceSuite. So stellen Sie sicher, dass Ihre App auch dann noch funktioniert, wenn Sie Änderungen vornehmen.

Weitere Informationen finden Sie unter E2E-Tests.

Jutro Platform CLI 10.0.3​

Die Jutro Platform Command Line Interface (Jutro Platform CLI) ist ein einheitliches, auf Plugins basierendes Tool zur Verwaltung Ihrer Jutro-Apps. Die Jutro Platform CLI bietet Befehle wie generate und validate, die Sie direkt von der CLI selbst oder von der eingebetteten Version, die in jeder Jutro-App installiert ist, ausführen können.

Weitere Informationen finden Sie in der Dokumentation zur Jutro CLI.

Änderungen am generate:i18n-Befehl​

Die standardmäßig erstellte Übersetzungsdatei ist nicht mehr die englische Übersetzung src/i18n/en.json. Es handelt sich jetzt um eine Vorlagen-Übersetzungsdatei src/i18n/lang.json, die als Basis für die Übersetzung Ihrer Anwendung in andere Sprachen dienen kann.

Jutro-App-Vorlagen 10.0.3​

JDP bietet verschiedene App-Vorlagen – gebrauchsfertige Jutro-Apps mit Boilerplate-Code. Dieser Code umfasst Komponenten, Beispielseiten, Layouts und Stile, die in einem Entwicklungs-Repository zusammen mit einer definierten CI/CD-Pipeline auf GWCP bereitgestellt werden, um die Entwicklung Ihrer Webanwendungen zu beschleunigen. Weitere Informationen finden Sie in der Vorlagendokumentation.

Es sind drei Typen von Vorlagen verfügbar:

  • Starter-Vorlagen: Diese sind React-Apps mit leerer Shell, die nur die Grundelemente wie Kopfzeile und Fußzeile enthalten. Sie dienen als Starthilfe für die Erstellung einer neuen App.
  • Schulungsvorlagen: Diese geben Entwicklern einen besseren Einblick in die Funktionsweise von Vorlagen.
  • Vorlagen, die eine bestimmte Geschäftsanforderung erfüllen. Dabei kann es sich um Micro Frontends oder eigenständige Jutro-Apps handeln, die Sie in Ihren eigenen Anwendungen oder anderen Guidewire-Anwendungen (einschließlich Digital-Anwendungen) nutzen können.

Weitere Informationen finden Sie in der Dokumentation zu den Vorlagentypen.

Digital SDK 10.0.3​

Das Digital SDK wurde speziell für die Verwendung von InsuranceSuite Cloud APIs entwickelt und erleichtert Ihnen die Interaktion mit diesen. Sie können Ihr maßgeschneidertes Digital SDK in Ihrer eigenen Anwendung basierend auf Ihrer Sparte (bzw. Ihren Sparten) generieren. Dazu verwenden Sie die Jutro CLI, basierend auf Ihren spezifischen Open-API-Definitionen von Cloud APIs und der Liste der in InsuranceSuite verfügbar gemachten Schemas.

Weitere Informationen finden Sie in den Versionshinweisen zu Digital SDK.

Was ist neu in Jutro-Patch 10.0.2?​

Verbesserungen und gelöste Probleme​

Jutro UI-Bibliotheken​

Sie können jetzt die Eigenschaft allow für iframe Micro Frontends konfigurieren. Dadurch ist es möglich, verschiedene Browserfunktionen wie geolocation, clipboard-write und camera zu aktivieren.

Die folgenden Probleme wurden in Patch 10.0.2 behoben:

  • Die Eigenschaften integrateJutro und integrateRouter funktionierten in iFrame Micro Frontends nicht korrekt.
  • Ein Grenzfall im Zusammenhang mit der in einem Micro Frontend verwendeten Breadcrumb-Komponente wurde behoben. Wenn ein Link im Breadcrumb eine Weiterleitung hatte, funktionierte diese Weiterleitung nicht wie erwartet, da sie in der falschen Reihenfolge zu window.history gepusht wurde.
  • Wenn ein Link in einem Micro Frontend auf einer neuen Registerkarte geöffnet wurde oder die Linkadresse von dort übernommen wurde, wurde der von einer Shell gesetzte Basisname des Micro Frontends nicht in den Link übernommen.
  • Verschachtelte Micro Frontend-Routen funktionierten nicht korrekt, wenn sie in eine Shell-App eingebettet waren.
  • Die gewählte Sprache bzw. das gewählte Gebietsschema wurde nicht aus dem Globalisierungsspeicher außerhalb von React extrahiert, sondern es wurde die Standardsprache bzw. das Standardgebietsschema (en_US) zurückgegeben.

Was ist neu in Jutro-Patch 10.0.1?​

Verbesserungen und gelöste Probleme​

Jutro CLI​

Der Befehl jutro validate:linters schlug fehl, wenn die Anwendung keine Metadatendateien enthielt.

Jutro Design System​

  • Die Position der Select-Komponente war beim Rendern nicht korrekt.
  • Ein zusätzlicher Rand unten an der DropdownSelectField-Optionsliste wurde entfernt.
  • Es wurden mehrere Probleme mit der CSS-Spezifität in Komponenten behoben.
  • Die folgenden Micro Frontend-Probleme wurden behoben:
    • Ein Problem mit der anfänglichen Standortauflösung für tief verschachtelte Micro Frontends.
    • Die Verwendung der Eingabeaufforderung innerhalb eines Micro Frontends funktionierte nicht.
    • Die QuickViewProvider-Komponente hatte unterschiedliche Positionen bei der Verwendung in einer eigenständigen App und einer Micro Frontend-App.
    • Die Seite blieb hängen, wenn das SDK mit aktivierter Authentifizierung verwendet wurde.
  • Es wurde ein Fehler bei der Aktualisierung des Authentifizierungstokens verhindert, wenn mehrere Registerkarten geöffnet waren.
  • Es wurde eine neue Fehlerbehandlung für den Fall definiert, dass der Benutzer nicht einer Anwendung zugewiesen ist.
  • Ein Problem mit der TableView-Filterung wurde behoben

Was ist neu in Jutro Digital Platform Innsbruck?​

Abkündigungen​

Dieses Release umfasst Abkündigungen. Eine Reihe von Paketen sind jetzt Legacy-Pakete. Weitere Informationen finden Sie auf unserer Seite über Abkündigungen.

Neues @jutro/legacy-Paket​

In diesem Release wurde ein neues @jutro/legacy-Paket eingeführt. Es enthält abgekündigte Komponenten, die immer noch verfügbar sind, für die Sie aber die Anweisung import aktualisieren müssen, um sie weiterhin verwenden zu können.

Weitere Informationen finden Sie im Abschnitt über Legacy-Pakete.

Verwendung von Legacy-Komponenten mit Metadaten​

Wenn Sie Metadaten anstelle von JSX verwenden, müssen Sie die neue configureLegacyComponentMap-Funktion nutzen, um weiterhin Komponenten aus dem @jutro/legacy-Paket zu verwenden.

Die Funktion configureLegacyComponentMap wurde durch einen Codemod zu der Datei hinzugefügt, in der die startApp-Funktion für alle Apps aufgerufen wird, die die @jutro/uiconfig-Abhängigkeit in package.json aufweisen. Diese Funktion registriert Legacy-Komponenten, die zur Verwendung von Metadaten in das @jutro/legacy-Paket verschoben wurden.

Warning: Wenn Sie Unit-Tests basierend auf Metadaten ausführen, müssen Sie vor den zugehörigen Testfällen configureLegacyComponentMap manuell hinzufügen. Wenn Sie dies nicht tun, werden wahrscheinlich It is missing correct "component" or "datatype" properties-Fehler in den Unit-Tests generiert.
beforeAll(configureLegacyComponentMap);

Zu jutro/legacy {#moved-legacy-packages} verschobene Pakete​

Die folgenden Pakete sind jetzt Legacy-Pakete und wurden abgekündigt. Ihre Importpfade wurden entsprechend der Änderung aktualisiert:

Import des ursprünglichen PaketsImport des Legacy-Pakets
@jutro/address@jutro/legacy/address
@jutro/contract@jutro/legacy/contract
@jutro/dataview@jutro/legacy/dataview
@jutro/datatable@jutro/legacy/datatable
@jutro/lab-preview-dataview@jutro/legacy/lab-preview-dataview
@jutro/quick-view@jutro/legacy/quick-view
@jutro/services@jutro/legacy/services
@jutro/uiconfig@jutro/legacy/uiconfig
@jutro/uimetadata@jutro/legacy/uimetadata

Weitere Informationen über die Abkündigung von @jutro/datatable- und @jutro/lab-preview-dataview-Paketen finden Sie in den Abschnitten Abkündigung des DataTable-Pakets bzw. Abkündigung des DataView-Pakets.

Legacy-Komponenten​

Die folgenden Komponenten sind nun Legacy-Komponenten und als abgekündigt gekennzeichnet. Sie wurden in das @jutro/legacy-Paket verschoben, sodass ihre Importpfade entsprechend der Änderung aktualisiert werden müssen.

Legacy-Komponenten von @jutro/components​

Import des ursprünglichen PaketsImport des Legacy-PaketsListe der Komponenten im Paket
import {'component'} from '@jutro/components'import {'component'} from '@jutro/legacy/components'Accordion
BreakpointTracker
Collapse
Container
CurrencyField
CheckboxField
DropdownSelectField

FileUploadField

(einschließlich useFileUpload- und useMultipleFileUpload-Hooks)

Footer
FooterCopyright
FooterNavBar
FooterNavLink
FooterText
FooterContext
StickyFooter
HeaderActions
HelpElement
HelpLink
HelpParagraph
HelpPopover
IntlPhoneNumberField
LogoTitle
PhoneNumberField
TextAreaField
TextField
TypeaheadMultiSelectField
Abgekündigte Hilfe-Komponenten​

Wie bereits erwähnt, wurden mehrere hilfebezogene Komponenten abgekündigt: HelpHeading, HelpLink, HelpParagraph, HelpPopover und HelpElement. Sie können diese durch eigene benutzerdefinierte Hilfekomponenten ersetzen. Wenn Sie die alten Komponenten weiterhin verwenden möchten, können Sie sie aus @jutro/legacy/components importieren und in Ihre Komponentenzuordnung für den Grundriss importieren.

import { HelpHeading, HelpParagraph, HelpLink } from '@jutro/legacy/components';
import { AppFloorPlan } from '@jutro/legacy/floorplan';
// ...
export const componentMap = {
  HelpHeading,
  HelpParagraph,
  HelpLink,
};
// ...
<AppFloorPlan
  componentMap={componentMap}
  // ...
/>;

Legacy-Komponenten von @jutro/router​

Import des ursprünglichen PaketsImport des Legacy-PaketsListe der Komponenten im Paket
import {'component'} from '@jutro/router'import {'component'} from '@jutro/legacy/router'ApplicationHeader
RouteTracker
SubApplicationHeader

Legacy-Komponenten von @jutro/wizard-next​

Import des ursprünglichen PaketsImport des Legacy-PaketsListe der Komponenten im Paket
import {'component'} from '@jutro/wizard-next'import {'component'} from '@jutro/legacy/wizard-next'ScrollToError

Legacy-Komponenten von @jutro/floorplan​

Import des ursprünglichen PaketsImport des Legacy-PaketsListe der Komponenten im Paket
import {'component'} from '@jutro/floorplan'import {'component'} from '@jutro/legacy/floorplan'AppFloorPlan
Note: Die abgekündigte Komponente wird durch eine neue AppFloorPlan-Komponente ersetzt. Weitere Informationen finden Sie unter Auswahl der neuen Grundriss-API.

Neue Komponenten​

Einige Komponenten wurden abgekündigt und ersetzt. Die neuen Komponenten sind zum Teil anders strukturiert als ihre Vorgänger. Möglicherweise müssen Sie die Eigenschaften an der Stelle anpassen, an der die Komponente aufgerufen wird. Nachfolgend sind die Komponenten und ihre Ersetzungen aufgeführt:

Abgekündigte KomponenteNeue Komponente
AccordionAccordion
CheckboxFieldCheckbox
CheckboxGroupFieldCheckboxGroup
CurrencyFieldCurrencyInput
InputFieldTextInput
IntlPhoneNumberFieldPhoneNumberInput
PhoneNumberFieldPhoneNumberInput
TextAreaFieldTextArea
DropdownSelectSelect oder MultipleSelect
TypeaheadMultiSelectCombobox oder MultiCombobox

Die abgekündigten Komponenten werden aus @jutro/legacy/components importiert. Die neuen Komponenten sind alle über @jutro/components verfügbar.

Entfernte Komponenten und Funktionen​

  • @jutro/platform/getMessageService und @jutro/platform/MessageInterface. Verwenden Sie TranslatorProvider und useTranslator aus @jutro/locale als Alternative
  • AnimationGroup
  • ColorSwatch
  • FieldSkeleton
  • Footer
  • FormSkeleton
  • GlobalizationProvider
  • HeaderActions
  • HelpElement
  • HelpPopover
  • JsonForm
  • LiveRegion
  • LinkSkeleton
  • LogoTitle
  • Main
  • MapTooltipContent
  • MenuSkeleton
  • PageHead
  • PageLayout. Verwenden Sie GridLayout, Grid und Flex als Alternativen
  • PanelLayout. Verwenden Sie GridLayout, Grid und Flex als Alternativen
  • PrivateRoute
  • ResponsiveElement
  • SchemaValidator
  • SkipNav
  • StickyFooter
  • TabbedContainer. Verwenden Sie TabSet als Alternative
  • TableSkeleton

Optionale Router-Abhängigkeit​

Die @jutro/router-Abhängigkeit und ihre Peer-Abhängigkeiten wie history und react-router-dom sind jetzt für Komponentenpakete optional. Bestimmte Komponenten erfordern jedoch, dass sie zu den Abhängigkeiten Ihrer App hinzugefügt werden, um verwendet werden zu können. Die folgende Liste zeigt die Komponenten, bei denen @jutro/router hinzugefügt werden muss:

KomponenteImportieren aus
DropdownMenuAvatarContent@jutro/components
InlineNotification@jutro/components
LanguageSelector@jutro/components
PopoverContainer@jutro/components
ToastProvider@jutro/components

Optionale Auth-Abhängigkeit​

Die Abhängigkeit @jutro/auth ist jetzt für Pakete @jutro/router und @jutro/components optional. Bestimmte Komponenten erfordern jedoch, dass sie zu den Abhängigkeiten Ihrer App hinzugefügt werden, um verwendet werden zu können. Die folgende Liste zeigt die Komponenten, bei denen @jutro/auth hinzugefügt werden muss:

KomponenteImportieren aus
ApplicationRoot@jutro/app
Avatar@jutro/components
DropdownMenuAvatar@jutro/components
DropdownMenuAvatarContent@jutro/components
AppFloorPlan@jutro/floorplan
MicroFrontend@jutro/micro-frontends
SecureRoute@jutro/router

Okta-Authentifizierungs-Client entfernt​

Der Okta-Authentifizierungs-Client, der in Version 8.13.2 abgekündigt wurde, wurde entfernt. Verwenden Sie stattdessen den neuen generischen Authentifizierungs-Client.

TreeView​

Die TreeView-Komponente befindet sich nicht mehr in der Laborvorschau. Weitere Informationen zu dieser Komponente finden Sie in der TreeView-Dokumentation.

Hot Loader-Pakete entfernt​

@hot-loader/react-dom und react-hot-loader werden automatisch aus App-Abhängigkeiten gelöscht.

Neue Grundriss-API​

Die AppFloorPlan-Komponente akzeptiert nicht mehr die Eigenschaften componentMap, callbackMap oder classNameMap. Die Eigenschaft floorPlans wird weiterhin unterstützt, aber der akzeptierte Wert wurde von JSON-Metadaten in ein JS-Objekt geändert.

  • Jeder className sollte ein CSS-Modulname sein.
  • Jeder Callback (render*, on*) sollte eine Funktion anstatt einer Zeichenfolge sein.
  • routes[].component sollte eine Komponente anstatt einer Zeichenfolge sein.
  • header.helpPopoverItems entfernt (akzeptiert Benutzeroberflächen-Metadaten).
  • render-Eigenschaft header.renderHelpPopoverItems hinzugefügt.
  • Eigenschaft footer entfernt (akzeptiert Benutzeroberflächen-Metadaten).
  • Eigenschaft renderFooter hinzugefügt.

Die alte Version von AppFloorPlan finden Sie in @jutro/legacy/floorplan, sie wurde jedoch abgekündigt, und Sie sollten die Aktualisierung auf die neue API manuell vornehmen.

PromptService entfernt​

Jutro enthält keinen PromptService mehr.

Zuvor konnten Sie eine Eingabeaufforderung unter Verwendung von PromptService an beliebiger Stelle in Ihrem Projekt einrichten:

PromptService.push('prompt-name', promptProps);

Später, nicht unbedingt in derselben Datei, konnten Sie Folgendes tun:

routeConfirmationModal('prompt-name', promptCallback, modalEmitter);

Entfernen Sie alle Verwendungen von PromptService, und übergeben Sie promptProps direkt an routeConfirmationModal, etwa so:

// PromptService is removed
routeConfirmationModal(promptProps, promptCallback, modalEmitter);

Drittes Argument der start-Funktion​

Das dritte Argument (scriptAttributes) für die Micro-Frontend-Funktion start wurde entfernt. Übergeben Sie stattdessen das Argument der startApp-Funktion als mfeData-Eigenschaft im zweiten Argument der start-Funktion.

Beispiel für Migration:

Vorher
src/startApp.js
import { start } from '@jutro/micro-frontends';
import messages from './app/App.messages';

export const startApp = (scriptAttributes) => {
  start(
    Jutro,
    {
      appName: messages.appName,
      appDescription: messages.appDescription,
    },
    scriptAttributes
  );
};
Nachher
src/startApp.js
import { start } from '@jutro/micro-frontends';
import messages from './app/App.messages';

export const startApp = (mfeData) => {
  start(Jutro, {
    appName: messages.appName,
    appDescription: messages.appDescription,
    mfeData: mfeData,
  });
};

@jutro/uiconfig-Funktionen entfernt​

Abgesehen davon, dass das Paket abgekündigt und in das Legacy-Paket verschoben wurde (@jutro/uiconfig ist jetzt verfügbar als @jutro/legacy/uiconfig), wurden die folgenden Funktionen aus @jutro/uiconfig entfernt:

  • generateUIFromSchema()
  • extractSubSchema()
  • useJsonSchema()

LocaleService​

Der Gebietsschema-Dienst, der in 8.13.2 abgekündigt wurde, ist entfernt worden. Verwenden Sie stattdessen die neue g11nStore-API.

Umgebungsvariable REACT_APP_JUTRO_AUTH_GENERIC_CLIENT​

Die REACT_APP_JUTRO_AUTH_GENERIC_CLIENT-Variable, die eingeführt wurde, als sowohl der alte als auch der neue Auth-Client verfügbar waren, wurde entfernt, da sie nicht mehr verwendet wird. Wenn sie noch in Ihrem Projekt enthalten ist, können Sie sie entfernen.

Verbessertes Laden von Stilen für Micro Frontends​

Vor diesem Release konnte CSS, das auf Micro Frontends angewendet wurde, unter Umständen das Styling der Shell-App oder anderer Micro Frontends verändern. Mit diesem Release wird eine neue Methode zum Laden von Stilen für Micro Frontends eingeführt, die dies verhindert.

Folgendes hat sich geändert:

  • CSS-Stile für Micro Frontends enthalten jetzt den Micro Frontend-Namen in Selektoren. Zum Beispiel .my-micro-frontend .my-class.
  • Die Shell-App umfasst das Micro Frontend mit einer Komponente, die den Namen des Micro Frontends als Klasse hinzufügt.

Andere außer Betrieb genommene Pakete​

Die folgenden Pakete wurden in Version 10.0 außer Betrieb genommen und sind in Jutro nicht mehr verfügbar:

  • @jutro/overrides
  • @jutro/lab-preview-html-metadata-loader
  • @jutro/lab-preview-metadata-converter
  • @jutro/storybook-preset
  • @jutro/e2e-tests – Das Paket heißt jetzt @jutro/lab-preview-test-e2e

Die folgenden Funktionen oder APIs wurden in Version 10.0 außer Betrieb genommen und sind in Jutro nicht mehr verfügbar:

  • Die textWasTranslated-Funktion aus dem @jutro/test-Paket.

Unterstützung für React 18​

Note: Ein Upgrade lohnt sich

Diese neue Funktion wird in der nächsten Hauptversion von Jutro zum Standard werden. Wir ermutigen Sie, die neue Funktion so schnell wie möglich zu nutzen.

Offizielle Unterstützung für React 18.2.0 hinzugefügt. Alle Apps, die mit React 17 ausgeführt werden, können auf die Verwendung mit React 18.2.0 aktualisiert werden.

Enzyme wird bei Verwendung von React 18 nicht mehr unterstützt. React 17 wird weiterhin von Jutro-Paketen unterstützt.

Alle Unit-Tests, die Enzyme verwenden, müssen auf die React Testing Library (RTL) migriert werden.

Alle neuen Apps, die mit jutro-app-template unter Verwendung der CLI erstellt werden, verwenden standardmäßig React 18.

Wichtiger Hinweis zu den Versionen:

  • Für TypeScript-Benutzer: @types/react sollte bei 17.0.24 verbleiben und nicht auf 18 aktualisiert werden.
Warning: Wenn Sie React 18 verwenden, müssen Sie Webpack 5 verwenden. Webpack 4 wird nicht unterstützt.

Tabellenkomponente​

Die Abkündigung der Table-Komponente wurde rückgängig gemacht.

Abgekündigte Komponenten​

Abgekündigte Komponenten sind jetzt auf der entsprechenden Komponentenseite der Dokumentations-Website deutlich als abgekündigt gekennzeichnet.

Micro Frontend-Aktualisierungen​

Die Micro Frontend-API wurde optimiert und überarbeitet. Weitere Informationen über die Micro Frontend-Funktionen finden Sie in der Micro Frontend-Dokumentation.

Fehlerbehebungen​

  • Es wurde ein Problem behoben, bei dem die Elemente DropdownSelectField und TypeaheadMultiSelectField hinter dem modalen Fenster in einem Micro Frontend angezeigt wurden
  • Validierungsmeldungen für nicht sichtbare Felder wurden entfernt
  • Es wurde ein Problem behoben, das verhinderte, dass der Standard-Loader des Micro Frontends überschrieben wurde, wenn das Micro Frontend eingebettet war
  • Es wurde ein Problem behoben, bei dem ein Authentifizierungsfehler auftrat, wenn sich Benutzer anmeldeten oder abmeldeten, wenn sie drei oder mehr Registerkarten derselben App geöffnet hatten
  • Es wurde ein Problem behoben, das die Übergabe des JUTRO_AUTH_LOGIN_QUERY_EXTRAS-Parameters während der automatischen Anmeldung verhinderte.
  • Es wurde ein Problem behoben, bei dem Modale in der Barrierefreiheitsstruktur nicht vorhanden waren.
  • Es wurde ein Problem behoben, das die Anwendung von Stilen auf QuickView-Komponenten verzögerte.
  • Es wurde ein Problem behoben, das dazu führte, dass Anmeldeversuche für die automatische Authentifizierung abgebrochen wurden.
  • Es wurde ein Problem behoben, das dazu führte, dass iframe Micro Frontends bei der Authentifizierung mehrere Popups öffneten.
  • Es wurde ein Problem behoben, bei dem location.state bei der Übergabe von Variablen innerhalb von Micro Frontends nicht definiert war.
  • Es wurde ein Problem behoben, das dazu führte, dass modale Stile nicht mehr funktionierten.
  • Es wurde ein Problem behoben, bei dem inaktive Vermittler-Benutzer zum falschen Anmeldefenster umgeleitet wurden.
  • Es wurde ein Problem mit Micro Frontends behoben, das dazu führte, dass QuickView-Kopfzeilen gelegentlich ausgeblendet wurden.
  • Es wurde ein Problem behoben, bei dem programmgesteuert geöffnete Fenster, die nicht durch die Logik der Authentifizierungsintegration ausgelöst wurden, automatisch geschlossen wurden.
  • Es wurde ein Problem behoben, bei dem der Authentifizierungs-Client beim Auftreten eines OIDC-Fehlers eine leere Seite statt einer Fehlerseite zurückgab.
  • Es wurde ein Problem behoben, bei dem mehr als zwei QuickView-Komponenten in einem Grundriss das Rasterlayout beeinträchtigten.
  • Es wurde ein Problem behoben, bei dem benutzerdefinierte CSS-Änderungen, die auf Elemente in einem Schnellansichtscontainer angewendet wurden, nicht angezeigt wurden.
  • Es wurde ein Problem behoben, bei dem Micro Frontends immer noch alte Daten anzeigten, wenn sich die Daten in der übergeordneten App geändert hatten.
  • Es wurde ein Problem behoben, bei dem benutzerdefinierte Modale in Micro Frontends keine CSS- oder Klassennamen hatten.
  • Es wurde ein Problem behoben, bei dem Links von einem Micro Frontend, die in einer separaten Browser-Registerkarte geöffnet wurden, nicht funktionierten.
  • Es wurde ein Problem behoben, bei dem zusätzliche Konfigurationseinstellungen, die mit setConfiguration erstellt wurden, zurückgesetzt wurden, wenn ein Micro Frontend vollständig geladen wurde.
  • Es wurde ein Problem behoben, bei dem die Micro Frontend-Globalisierungseinstellungen nicht aktualisiert wurden, wenn die Einstellungen der Shell-App aktualisiert wurden.
  • Es wurde ein Problem behoben, bei dem die Micro Frontend-router-Komponente history-Änderungen überwachte und die Breadcrumbs der Seite änderte.
  • Es wurde ein Problem behoben, bei dem Shell-Basisnamen nicht zu Links hinzugefügt wurden, die in einem Micro Frontend erstellt wurden.
  • Es wurde ein Problem behoben, bei dem Callbacks in iFrame Micro Frontends nicht korrekt übergeben wurden.
  • Es wurde ein Problem behoben, bei dem Micro Frontend-Stile nicht korrekt angewendet wurden, wenn in der Shell ein alter CSS-Anordnungsalgorithmus verwendet wurde.
  • Es wurde ein Problem behoben, bei dem Sie bei der Verwendung einer Shell-App mit React 18 und einem Micro Frontend mit React 17 die Fehlermeldung createRoot not found erhielten, auch wenn Sie useLegacyReact festgelegt haben.
  • Es wurde ein Problem behoben, bei dem das Micro Frontend das Auth-Token nicht erhielt, wenn die Shell-App den neuen Auth-Mechanismus verwendete und das Micro Frontend den alten Auth-Mechanismus nutzte.

Verbesserungen und gelöste Probleme​

ID
Beschreibung
JUT-21543Es wurde ein Problem mit der Abmeldung mehrerer Registerkarten für Micro Frontends behoben.
JUT-15669Es wurde ein Problem behoben, bei dem in der DatePicker-Komponente nicht das richtige Format angezeigt wurde.
JUT-21226Es wurde ein Problem behoben, bei dem eine loaderComponent nicht überschrieben werden konnte.
JUT-21543Fehlendes allowMultiTabLogin-Flag wurde in OidcTrustedDomains-Datei hinzugefügt.
JUT-20192isPending wird auf true festgelegt, wenn der Abmeldeablauf ausgeführt wird.
JUT-22156@types/loader-utils wurde zu devDeps in jutro-toolset-react-app hinzugefügt.
Nicht zutreffendemojis-list-Paket wurde hinzugefügt, das von loader-utils für Auflösungen verwendet wird.
JUT-22156postcss-scss zu Auflösungen und Postcss-Aktualisierung in jutro-app hinzugefügt.
JUT-21794Auflösung für braces 3.0.3 hinzugefügt.
JUT-21801Auflösung für rollup 2.79.2 hinzugefügt.
JUT-21783Auflösung für @babel/traverse 7.25.7 hinzugefügt.
JUT-21799Auflösung für axios 0.28.0 hinzugefügt.
JUT-22077Auflösung für cookie 0.7.1 hinzugefügt.
JUT-21788Auflösung für ejs 3.1.10 hinzugefügt.
JUT-21805Auflösung für express 4.20.0 hinzugefügt.
JUT-21793Auflösung für micromatch 4.0.8 hinzugefügt.
JUT-21796testcafe-Version wurde auf 1.18.6 aktualisiert.
JUT-22156loader-utils wurde aus Auflösungen in jutro-app entfernt.
JUT-21946Aktualisierung von @okta/okta-auth-js auf Version 7.8.1.
JUT-21177Aktualisierung von z-index für DropdownSelectField.
JUT-20970Validierungsmeldungen für nicht sichtbare Felder wurden entfernt.
JUT-21785Aktualisierung von Webpack auf 5.95.0 in @jutro/toolset-react-app.
JUT-21272Weiterleitung in Micro Frontend Unit-Test wurde behoben.

Bekannte Probleme​

ApplicationHeader-Stilüberschreibungen​

CSS-Überschreibungen von ApplicationHeader funktionieren aufgrund von Problemen mit der Selektorspezifität möglicherweise nicht mehr.

Um dieses Problem zu umgehen, erhöhen Sie die Spezifität Ihrer CSS-Selektoren.

Beispielsweise können Sie den Namen der Klasse duplizieren. Wenn Sie Stilmodule wie folgt in Ihre Komponenten importieren:

my-component.js
import styles from './my-styles.module.scss';

<ApplicationHeader className={styles.myClass} />;

und Ihre Stilüberschreibungen wie folgt aussehen:

my-styles.module.scss
.myClass {
  background-color: red;
}

Ändern Sie den Namen der Klasse in:

my-styles.module.scss
.myClass.myClass {
  background-color: red;
}

Zusätzliches erneutes Rendern​

Wenn Ihre App Micro Frontends verwendet, kann es in untergeordneten Apps zum zusätzlichen oder unerwarteten erneuten Rendern kommen. Dieses erneute Rendern kann zusätzliche useEffects und Aufrufe an das Backend auslösen.

Dies geschieht normalerweise, wenn der Benutzer:

  • die Fenstergröße ändert
  • die Seite scrollt
  • auf der Seite hereinzoomt oder herauszoomt

Dies ist kein kritisches Problem und wird in einem zukünftigen Release behoben werden.

Leider gibt es zur Zeit keine Workarounds.

Geänderte Stilüberschreibungen in Micro Frontends​

Wir haben die Art und Weise geändert, wie Micro Frontends CSS laden, um unerwartete von Micro Frontends gemeinsam genutzte Stile zu verhindern (mehr zu diesem Thema). Dies kann die Art und Weise ändern, wie Ihre benutzerdefinierten Stile angewendet werden, und das Erscheinungsbild Ihrer Anwendung verändern.

Um dies zu beheben, können Sie die folgende Erweiterungsvariable setzen:

REACT_APP_USE_LEGACY_MFE_CSS_ORDERING=true

Einträge in .gitignore, die mit src/i18n/lang.json verkettet werden​

Problem: Es kann zu Problemen kommen, bei denen neu hinzugefügte Einträge in .gitignore mit dem Eintrag für src/i18n/lang.json verkettet werden.

Workaround: Stellen Sie sicher, dass dem src/i18n/lang.json-Eintrag eine neue Zeile folgt, damit der nachfolgende Eintrag korrekt in eine neue Zeile eingefügt wird.

Änderungen im Metadatenschema führen zu Unit-Testfehlern für mehrere Komponenten (JUT-20884)​

Problem: Aufgrund von Änderungen am Metadatenschema zwischen den Jutro-Versionen 8.13.x und 10.x.x schlagen Unit-Tests für bestimmte Komponenten wie PhoneNumberField, GenericColumn und andere fehl. Das Problem tritt bei der Aktualisierung von Release 8.13.x auf Release 10.x.x auf.

Workaround: Guidewire ist dieses Problem bekannt.

Einbetten authentifizierter Micro Frontends in Jutro-fremde Shell-Apps​

Problem: Das Einbetten authentifizierter Micro Frontends in einige Jutro-fremde Shell-Apps unterliegt aufgrund der in Google Chrome v115+ eingeführten Änderungen neuen Einschränkungen. In Fällen, in denen das Micro Frontend mit iframe oder SDK eingebettet ist und über eine eigene Authentifizierung verfügt (z. B. wenn die Authentifizierungsintegration in der Shell-App deaktiviert ist, das Micro Frontend jedoch erfordert, dass der Benutzer authentifiziert wird), sollten beide Apps idealerweise unter derselben Site ausgeführt werden (z. B. localhost:3000 und localhost:3001). Weitere Informationen zu den Unterschieden zwischen „Same Site“ und „Same Origin“ finden Sie in diesem Artikel. Wenn die Shell-App und die Micro Frontend-App auf unterschiedlichen Websites gehostet werden, können Sicherheitsmechanismen von Browsern Probleme verursachen. Wenn die Shell-App und die Micro Frontend-App auf unterschiedlichen Websites gehostet werden, werden die Micro Frontend-App und ihr Klon im Popup mit vollständig isolierten Instanzen von Service Workern ausgeführt, die nicht miteinander kommunizieren können. Obwohl Service Worker in dieser Umgebung weiterhin funktionieren, kann die fehlende Kommunikation zwischen diesen isolierten Instanzen zu unerwartetem Verhalten im Micro Frontend führen.

Workaround: Es gibt keinen Workaround, aber es wird dringend empfohlen sicherzustellen, dass beide Anwendungen in Übereinstimmung mit den Empfehlungen der offiziellen Browseranbieter unter derselben Website ausgeführt werden. Wenn dies nicht möglich ist, ist für die Jutro-Versionen 10.0.8+, 10.3.4+, 10.7.1+ und 10.9.0+ ein weniger sicherer Workaround verfügbar.

In diesem Fall müssen Sie die Variable JUTRO_AUTH_ALLOW_SESSION_STORAGE_FOR_CROSS_SITE_IFRAMES auf true setzen. Durch diese Änderung kann der Sitzungsspeicher als Speicher für Authentifizierungstoken fungieren.

Gelegentlicher Timeout bei Authentifizierungstokens​

Problem: Aufgrund von Änderungen der Funktionsweise des OIDC-Authentifizierungsclients kann der Aktualisierungsablauf für das Authentifizierungstoken gelegentlich fehlschlagen, wenn das Timeoutlimit erreicht wird.

Workaround: Es wird empfohlen, den neuesten Patch zu verwenden, der das Problem behebt, sowie das Lade- und Sitzungsverlängerungsverhalten der authentifizierten App über langsamere Verbindungen, z. B. mobiles Internet, zu testen.

Globale window.onmessage-Listener können gelegentlich fehlerhaft ausgeführt werden​

Problem: Frühere Versionen von Jutro stützten sich auf eine OIDC-Funktionalität, die die Überschreibungen der globalen Methode window.onmessage nutzte, um Meldungs-Listener einzurichten. Bestimmte benutzerdefinierte Logiken können dies beeinträchtigen und Fehler in der Funktionalität verursachen.

Workaround: Es gibt zwei Workarounds:

  • Ändern Sie die benutzerdefinierte Überschreibung der Anwendung, um stattdessen window.addEventListener('message', listener) zu verwenden.
  • Verwenden Sie den neuesten Jutro-Patch, der das Problem behebt

Die Okta SDK API ist nicht mehr zuverlässig für den direkten Einsatz​

Problem: Aufgrund der in Jutro 10 eingeführten Änderung bei den Authentifizierungsclients kann die API des Jutro-Auth-Clients nicht mehr zuverlässig mit der Okta SDK API verwendet werden.

Workaround: Es wird empfohlen, dass Anwendungen nur die APIs des Jutro-Auth-Clients verwenden. Alle Einschränkungen, die der Authentifizierungsclient im Vergleich zum Okta-SDK aufweist, sollten mit dem Jutro-Team als Anfrage für die Auth-Client-Funktion besprochen werden.

Automatische Anmeldung muss konfiguriert werden und ist erforderlich​

Problem: Aufgrund von Unterschieden bei der Konfiguration des Okta-Auth-Clients und des generischen OIDC-Auth-Clients erfordert jede zum generischen Auth-Client migrierende Anwendung eine zusätzliche Konfiguration, um den Tokenaktualisierungsmechanismus zu aktivieren, der als „automatische Anmeldung“ bezeichnet wird.

Workaround: Informationen zur Konfiguration des Mechanismus finden Sie hier.

Aktualisierte Webpack-Version (JUT-21785)​

Problem: Beim Erstellen einer Jutro-App können Fehler auftreten, wenn sich Webpack in der Liste der Abhängigkeiten befindet.

Workaround: Die Fehler können mit Ihrer Webpack-Version zusammenhängen. Wenn Ihre Webpack-Version nicht 5.95.0 ist, versuchen Sie, auf diese Version zu aktualisieren, und erstellen Sie die App erneut.

Fehler in Cheerio-Bibliothek​

Beim Ausführen des Befehls npm install tritt ein Problem auf, das zu der folgenden Fehlermeldung führt:

npm ERR! notsup Not compatible with your version of node/npm: cheerio@1.0.0
npm ERR! notsup Required: {"node":">=18.17"}
npm ERR! notsup Actual:   {"npm":"9.5.0","node":"v18.14.2"}

Beheben dieses Fehlers:

  1. Fügen Sie Folgendes zu Ihrer package.json-Datei hinzu:
"overrides": {
  "cheerio": "1.0.0-rc.12"
}
  1. Führen Sie erneut npm install aus.
Note: Wenn beim Ausführen des Befehls npm install weitere Fehler auftreten, löschen Sie die package-lock.json-Datei und den Ordner node_modules, bevor Sie es erneut versuchen.

Unterstützte Browser​

  • Chrome und Chromium-basierte Browser (getestet mit Chrome v110)
  • Firefox (getestet mit v107)
  • Safari (getestet mit v15.6)
  • Tablet und Mobiltelefon (iOS Safari + Android Chrome, dieselben Versionen wie oben)

Abhängigkeiten von Drittanbietern​

  • Node-Version: 18.14.2 < 19 || >= 22.6.0 < 23
  • NPM version: >= 9.5.0
  • React-Version: 18.2.0
On this page