Passer au contenu principal

Instructions d’utilisation pour les micro front-ends

Il existe quatre technologies différentes pour intégrer un module micro front-end. Chacune d'entre elles est plus adaptée à un scénario spécifique :

  • Microfrontend SDK Jutro
  • Composant MicroFrontend avec partage de contexte, appelé mode partagé (auparavant connu sous le nom de mode de fédération de modules)
  • Composant MicroFrontend avec isolement du contexte, connu sous le nom de mode isolé (auparavant connu sous le nom de mode iframe)
  • iframe standard
Note: Pour créer une nouvelle expérience numérique à partir de zéro à l'aide de JDP, nous vous recommandons d'utiliser notre solution de partage de contexte via le mode shared à la fois pour l'application shell et le module micro front-end. Cependant, notez que cette solution est basée sur le composant React MicroFrontend, ce qui peut limiter sa compatibilité avec certaines applications shell :

  • Pour les applications shell héritées de Jutro (par exemple, EnterpriseEngage), utilisez le composant MicroFrontend en mode partagé avec prudence. Vous pouvez également utiliser le composant MicroFrontend en mode isolé.

  • Pour les applications shell autres que Jutro (par exemple, portail personnalisé), qu'elles soient nouvelles ou héritées, l'utilisation de ce composant MicroFrontend n'est pas une option viable. Vous pouvez également utiliser le microfrontend SDK Jutro, qui autorise uniquement l'intégration iframe.

Pour des performances optimales, l'application shell gère l'authentification via Guidewire Hub. Dans les applications shell Jutro (nouvelles et héritées), cette configuration est la configuration par défaut, ce qui permet aux jetons d'authentification d'être transmis de manière transparente aux modules micro front-end. Toutefois, pour les applications shell autres que Jutro (nouvelles et héritées), si elles ne peuvent pas s'intégrer à Guidewire Hub pour obtenir des jetons d'authentification, vous devrez peut-être implémenter des solutions de contournement, ce qui pourrait conduire à des expériences utilisateur peu optimales.

Microfrontend SDK Jutro​

Le microfrontend SDK Jutro est basé sur l'iframe HTML standard. Dans les scénarios où l'isolement du contexte est requise entre les micro front-ends Jutro et les applications shell non Jutro, le microfrontend SDK offre une meilleure solution.

Le microfrontend SDK Jutro répond aux limites des iframes natifs. Il permet aux développeurs d'interagir avec le module micro front-end, de transmettre des propriétés et d'activer plusieurs intégrations à l'aide de l'API. Cette méthode offre un moyen plus sûr d'intégrer des applications conçues et développées indépendamment. En outre, il s'agit de la seule méthode, avec l'iframe standard, d'intégrer le module micro front-end Jutro dans des portails tiers lorsque les utilisateurs n'ont pas accès au package des modules micro front-end @jutro et à l'ensemble de l'écosystème Jutro.

Utilisez l'iframe du microfrontend SDK Jutro pour intégrer les applications Web nouvellement créées sur JDP dans les portails numériques existants. Cette approche garantit une intégration plus fiable et moins sujette aux erreurs entre les modules micro front-end Jutro et les applications shell. Cela s'applique à toutes les applications shell, qu'elles soient nouvelles ou héritées, où les développeurs ont accès au code de l'application shell. Notez toutefois que le manque de communication entre les modules et de partage de contexte peut avoir un impact négatif sur l'expérience utilisateur globale.

Composant micro front-end avec partage de contexte (mode partagé)​

L'utilisation du mode partagé avec le composant micro front-end permet au module micro front-end d'utiliser la technologie de fédération de modules, ce qui facilite le partage de contexte entre les modules micro front-end Jutro et les applications shell. Cette approche est adaptée aux scénarios dans lesquels l'expérience finale est conçue comme une unité cohérente dès le début, avant d'être décomposée en éléments plus petits et pouvant être déployés indépendamment. Elle s'appuie sur la fédération de modules pour le partage de code et de ressources, ce qui nécessite une collaboration et l'établissement de contrats entre des équipes de développement indépendantes pour garantir une intégration transparente sans interférence involontaire.

La fédération de modules est une technologie moderne et efficace qui permet de réduire les temps de chargement et d'améliorer les performances. Elle simplifie également la communication et le partage de données entre les différentes parties de l'application grâce à des interfaces partagées. Cette méthode est particulièrement adaptée aux nouvelles applications shell pour lesquelles les développeurs ont accès au code. La fédération de modules est un choix approprié pour les clients qui souhaitent créer une nouvelle expérience numérique à partir de zéro à l'aide de JDP, en particulier lorsqu'ils souhaitent garder des sections spécifiques de l'application Web indépendantes dès le départ.

Pour les applications shell héritées, bien que la fédération de modules reste une option, il est recommandé d'intégrer des applications Jutro héritées et non héritées en tant que modules micro front-end dans EnterpriseEngage à l'aide d'iframes. Les iframes offrent une méthode simple, efficace et sécurisée pour intégrer des applications conçues indépendamment les unes dans les autres, tout en maintenant des limites claires. Si des difficultés surviennent lors de l'implémentation de ce cas d'utilisation, envisagez d'utiliser le microfrontend SDK Jutro en guise d'alternative.

Composant micro front-end avec isolement du contexte (mode isolé)​

Le composant MicroFrontend en mode isolé est la technologie recommandée pour les environnements d'isolement du contexte. Ce composant fournit toutes les intégrations entre le module micro front-end intégré et l'application shell par défaut.

Cette méthode est recommandée pour les applications shell, aussi bien nouvelles et héritées, pour lesquelles les développeurs ont accès au code. Cette recommandation est limitée par la compatibilité croisée des versions de Jutro, car l'application shell et le module micro front-end intégré doivent être installés sur Jutro version 8.13.x ou ultérieure.

iframe standard​

Cette technologie n'est pas fournie par JDP, il n'existe donc aucune intégration spécifique entre les applications shell et les modules micro front-ends. Elle repose uniquement sur les fonctionnalités natives des iframes HTML. Cette option est recommandée lorsque l'intégration du code fourni par Jutro dans une application shell n'est pas possible.

Pour les applications shell nouvelles et héritées pour lesquelles les développeurs ne peuvent pas écrire de code JavaScript dans l'application shell (par exemple, solutions d'interface utilisateur packagées avec des extensions HTML), il est recommandé d'utiliser la balise HTML standard <iframe> avec la propriété src pointant vers l'URL du module micro front-end Jutro. En outre, pour les scénarios impliquant des modules micro front-end autres que Jutro, la balise HTML standard <iframe> avec la propriété src pointant vers l'URL du module micro front-end autre que Jutro est adaptée. Pour l'intégration de modules micro front-end autres que Jutro, la fédération de modules standard avec Webpack 5 intègre efficacement le module micro front-end non-Jutro dans les applications shell nouvelles et héritées, pour lesquelles les développeurs ont accès au code.

Voir également​