Aller au contenu principal

Outils de productivité

Lagoon fournit des outils de productivité pour accompagner le développement dans Visual Studio. Ils accélèrent les tâches répétitives, mais ils ne remplacent pas l'analyse et les choix du développeur.

À retenir

Ces outils sont des aides au développement. Le développeur reste responsable de vérifier le code généré, les conventions Lagoon, les traductions et le comportement fonctionnel.

Installation dans Visual Studio​

  1. Dans Visual Studio, ouvrir le menu Outils / Options....
  2. Dans la fenêtre d'options, ouvrir Environnement / Extensions.
  3. Cliquer sur Add.
  4. Renseigner la source d'extension :
    • Name : Outils de productivité
    • URL : https://vsix.desirade.fr/
  5. Valider avec OK.
  6. Ouvrir Extensions / Gérer les extensions.
  7. Sélectionner En ligne / Outils de productivité.
  8. Sélectionner Lagoon, puis cliquer sur Télécharger.
  9. Redémarrer Visual Studio pour finaliser l'installation.

Utilisation​

Après installation, Visual Studio affiche de nouvelles icônes dans la barre d'outils, sous le menu de l'extension Lagoon.

Le menu Lagoon centralise les actions de maintenance et de génération liées au framework :

ActionUsage
Création d'une nouvelle applicationInitialiser une application Lagoon.
Mise à jour de l'outil dotnet LGNMettre à jour l'outil de build Lagoon.
Mise à jour des packages LagoonAligner le projet ouvert avec les packages Lagoon attendus.
Génération d'une documentationProduire une documentation à partir du projet.
Nettoyage des répertoires bin et objSupprimer les sorties de build de tous les projets de la solution.

Le menu New accompagne la création d'éléments courants dans un site Lagoon :

  • création d'une nouvelle page ;
  • création d'un composant ;
  • création d'un contrôleur ;
  • création d'un service vide ;
  • création d'une page d'administration d'une table de données ;
  • création d'un ViewModel et du mapping Model / ViewModel ;
  • création d'un nouvel appel d'API.
ViewModels et mapping

La création et le mapping des ViewModels sont détaillés dans la page dédiée : ViewModel et mapping. Cette page ne redétaille pas ce sujet.

Points d'attention​

  • Pour une page d'administration de table, les modèles doivent être définis dans les dossiers Context ou Models du projet Model.
  • Après génération, relire systématiquement les fichiers produits pour vérifier les conventions Lagoon : séparation Razor / C#, composants Lg*, traductions #..., policies et gestion des exceptions.