Synchroniser les modifications du fichier de spécification avec le code source généré

Vous pouvez utiliser la fonction de synchronisation pour apporter de nouvelles modifications du fichier de spécification aux fichiers source du code chaîne (modèle et contrôleur). La fonction fonctionne avec les projets TypeScript et Go.

Remarques :
  • La synchronisation est unidirectionnelle : vous pouvez apporter des modifications à partir de votre fichier de spécification dans votre projet de code chaîne, mais pas l'inverse. Les modifications apportées à votre projet de code chaîne restent telles quelles après le processus de synchronisation.
  • La commande ne fonctionne que si le projet de code chaîne a été échafaudé à l'aide d'un fichier de spécification. Ne supprimez pas, ne renommez pas ou ne déplacez pas le fichier de spécification si vous prévoyez de synchroniser les modifications du fichier de spécification vers le code source ultérieurement.
  • Lors de la synchronisation, les fichiers de code chaîne du dossier lib sont automatiquement mis à niveau. Si vous apportez des modifications à ces fichiers de bibliothèque, sauvegardez les fichiers modifiés ou suivez les modifications que vous apportez avant d'utiliser la fonction de synchronisation, afin de pouvoir appliquer à nouveau ces modifications après la synchronisation.
Pour synchroniser vos fichiers de spécification et de code chaîne, procédez comme suit :
  1. Dans le panneau Spécifications, sélectionnez le fichier de spécification que vous avez mis à jour pour ouvrir son panneau Détails de spécification. En haut du panneau, cliquez sur Codes chaîne pour ouvrir le panneau indiquant les codes chaîne générés à partir du fichier de spécification.
  2. Cochez la case Synchroniser en regard de chaque code chaîne à mettre à jour avec les nouvelles modifications. Vous pouvez synchroniser plusieurs codes chaîne générés à partir d'un fichier de spécification à la fois. Cliquez sur Synchroniser.
Les projets de code chaîne contiennent désormais des fichiers mis à jour.

Résolution de conflits

Etant donné que vous pouvez modifier à la fois les fichiers de synchronisation et les fichiers de code chaîne, il est possible de rencontrer des conflits dans lesquels le fichier de spécification mis à jour pourrait remplacer une modification apportée au fichier de code chaîne. Dans ce cas, lorsque vous tentez de synchroniser une erreur s'affiche indiquant qu'il y a un conflit. Vous pouvez utiliser le panneau Conflits pour résoudre ces erreurs.

  1. Dans le panneau Conflits, cliquez sur le nom du fichier de code chaîne dans lequel les conflits existent. Le fichier s'ouvre dans un éditeur avec les conflits mis en évidence.
    Conflit de synchronisation affiché dans l'éditeur

    Dans l'exemple présenté, Marble124 figure dans le fichier de spécification et Marble123 dans le fichier de modèle de code chaîne.

  2. Au-dessus du conflit se trouve une liste d'options. Cliquez sur Accepter la modification en cours pour remplacer le fichier de spécification et utiliser ce qui se trouve actuellement dans le fichier de code chaîne. Cliquez sur Accepter la modification entrante pour remplacer le fichier de code chaîne et utiliser ce qui se trouve actuellement dans le fichier de spécification.
  3. Revenez au panneau Conflits. Cochez la case Synchroniser en regard du nom du conflit, puis cliquez sur Confirmer les modifications. Si vous avez plusieurs conflits, résolvez-les tous avant de cliquer sur Confirmer les modifications.