Passer au contenu principal

Configuration de votre environnement de développement local

Cette section vous explique, en tant que développeur assureur, comment configurer votre environnement de développement local. Vous pourrez ainsi commencer à développer votre application et à proposer vos modifications.

Note: Vous devez disposer des informations de connexion de votre locataire Guidewire Home avant de configurer votre environnement de développement local. Pour en savoir plus, reportez-vous à Accès aux Jutro Web Apps.

Conditions préalables​

Vous devez installer les éléments suivants pour configurer votre environnement de développement.

  • Node : >=22.6.0 < 23
  • npm: >=10.8.2
  • Git
  • Un IDE

Suivez les instructions d'installation correspondant à votre système d'exploitation.

Comprendre les référentiels NPM​

Les packages NPM requis pour les applications Jutro sont stockés dans des instances de référentiel binaire Guidewire distinctes qui nécessitent une authentification.

Trois instances régionales sont disponibles :

Tous les packages NPM JDP de la configuration de base sont disponibles dans le référentiel jutro-npm-dev-local dans ces instances.

Notez que différents champs d'application NPM sont utilisés pour distribuer différents packages. Vous les verrez dans les préfixes des noms de package. Les principaux champs d'application sont les suivants :

  • @jutro
  • @digitalsdk

Packages spécifiques au client​

Lors de la création d'applications Jutro, outre les packages fournis par la plate-forme JDP, vous pouvez utiliser ceux créés en tant que packages spécifiques au client publiés sur un référentiel différent (jutro-{tenantId}-all-npm-remote).

Le référentiel virtuel​

Afin de faciliter la configuration et l'accès, Guidewire fournit un référentiel virtuel qui fait office de proxy de ces deux référentiels, de sorte que tous les packages NPM (JDP et spécifiques au client) sont disponibles via ce référentiel.

Le référentiel virtuel est jutro-{tenantId}-all-npm-virtual.

Note: L'URL complète du référentiel virtuel est https://{region}.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual

Utilisez ce référentiel lors de la configuration de votre environnement local.

Configuration du référentiel requis dans votre configuration NPM​

Comme expliqué précédemment, les packages NPM requis pour les applications Jutro sont stockés dans trois instances régionales de référentiel binaire Guidewire :

Par défaut, votre application Jutro exécutée sur JDP pointe déjà vers l'instance correspondant à l'environnement Guidewire Home dans lequel elle a été créée.

Au cours des étapes de configuration du développement local, il vous sera demandé d'obtenir un jeton d'accès pour l'instance sélectionnée.

Dans ces étapes, l’instance AMER est utilisée dans l’exemple :

  1. Connectez-vous à https://amer.binrepo.guidewire.net/ à l'aide de vos identifiants SAML SSO.

  2. Ouvrez votre terminal dans votre répertoire de base et suivez les étapes suivantes, en remplaçant la valeur pour {tenantId} :

  3. Pour configurer l'accès aux artefacts JDP sous le champ d'application @jutro, exécutez les commandes suivantes :

npm config set @jutro:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@jutro --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Pour configurer l'accès au champ d'application @digitalsdk, exécutez les commandes suivantes :
npm config set @digitalsdk:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@digitalsdk --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Pour configurer l'accès au champ d'application des packages partagés spécifiques au client, exécutez les commandes suivantes, en remplaçant non seulement le {tenantID} mais également le {startSystemId} :
npm config set @{tenantId}-{starSystemId}:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@{tenantId}-{starSystemId} --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual

Utilisation de packages partagés​

Pour en savoir plus sur l'utilisation des packages partagés, voir Utilisation de packages partagés.

Obtenir le code source de votre application​

Pour cloner le référentiel d'applications et obtenir le code, vous devez créer un jeton d'accès HTTP et l'utiliser comme mot de passe lorsque vous y êtes invité.

  1. Connectez-vous à Guidewire Home puis accédez à votre application dans Jutro Web Apps.

  2. Cliquez sur le lien Code source pour accéder au référentiel Bitbucket.

  3. Dans Bitbucket, cliquez sur votre avatar, puis sur Gérer le compte.

  4. Dans le menu de gauche, sélectionnez Jetons d'accès HTTP et cliquez sur Créer un jeton.

  5. Saisissez un nom pour le jeton et définissez les autorisations pour Admin.

  6. Cliquez sur Créer.

  7. Copiez et enregistrez le jeton dans la page suivante, car vous l'utiliserez comme mot de passe.

  8. Cliquez sur Continuer.

  9. À l'aide de la commande d'interface de ligne de commande git clone dans une instance de terminal, clonez le référentiel et fournissez le jeton que vous avez créé plus tôt lorsque vous avez été invité à définir un mot de passe.

  10. Une fois le référentiel cloné, accédez au nouveau répertoire d'application que vous avez créé et exécutez les commandes suivantes dans votre IDE :

    npm ci
    npm start

    Votre application est maintenant exécutée dans votre navigateur.

Résolution des problèmes​

En suivant les étapes de la section Configuration du référentiel requis dans votre configuration NPM, NPM insérera l'authentification et les configurations dans un fichier .npmrc de votre répertoire de base. Ce fichier contient les informations nécessaires pour s'authentifier et accéder aux référentiels requis.

Si vous rencontrez des problèmes de contrôle d'accès lorsque vous essayez d'installer des packages, vérifiez les points suivants :

  1. Votre utilisateur a accès à l'interface utilisateur de Guidewire BinRepo et peut accéder aux URL du référentiel directement dans un navigateur
  2. Votre fichier .npmrc contient des identifiants valides pour les référentiels et la région auxquels vous essayez d'accéder
  3. Vous exécutez la commande d'installation dans le répertoire approprié, où NPM peut effectuer le chargement. Trouvez le fichier correct .npmrc dans l'arborescence des répertoires : https://docs.npmjs.com/cli/v8/configuring-npm/npmrc#files
  4. Votre fichier package-lock.json ne contient aucune référence de package provenant d'autres référentiels dans d'autres régions avec lesquels vous n'êtes pas authentifié (par exemple, https://apac.binrepo.guidewire.net au lieu de https://amer.binrepo.guidewire.net)
  5. Vous avez essayé de purger node_modules et package-lock.json et de réinstaller avec une configuration de fichier correcte .npmrc après avoir suivi les étapes ci-dessus

Si aucune des étapes ci-dessus ne résout le problème, vous devrez ouvrir un ticket pour obtenir une assistance supplémentaire.