CS_AN_AZ_employee_manager
1.0.0
Un système de gestion utilisant Angular version 8 pour l'interface utilisateur frontale et Asp.Net Core pour une API Web back-end.
Il s'agit d'un projet visant à démontrer l'extension de concepts à des projets plus vastes. Il s'agit d'un système de gestion des employés avec validation de formulaire utilisant Angular et ASP.Net Core. Le concept consiste à familiariser et à combiner un framework JavaScript populaire avec C#/ASP.Net Core, tout en fournissant une gestion des versions de l'API, des tests de point final du contrôleur et des tests d'intégration de configuration pour les futures implémentations de fonctionnalités.
L'utilisation d'objets de transfert de données (Dtos) à l'aide d'Auto Mapper protège et mappe les classes d'entités d'origine trouvées dans le répertoire DataEntities de l'API vers des classes pour des tâches spécifiques, c'est-à-dire récupérer, créer et modifier.
L'application a été construite à l'aide des outils et frameworks suivants :
C#/ASP.Net Core 2.2
Version angulaire 8.3
Amorçage 4
Base de données SQL Server ou PostgreSQL (facilement configuré dans la classe DbContext)
Le projet contient des tests de points de terminaison API intégrés à l'aide de Swagger. Cela a été configuré dans la classe Startup.cs dans les services Configure et IConfiguration pour être utilisé au démarrage. Après avoir lancé le projet dans un environnement local, accédez à https://localhost:5001/swagger pour afficher la page d'index de test.
Afin de tester/utiliser cette application, vous aurez besoin des éléments suivants :
SDK Asp.Net Core 2.0, de préférence 2.2.1
Node.js version 8 ou supérieure
La CLI angulaire
Microsoft SQL Server ou pgAdmin pour PostgreSQL
Récupérez le référentiel en téléchargeant le fichier zip ou en clonant le projet.
Après avoir cloné ou décompressé les fichiers, accédez au répertoire contenant le fichier de solution :
~$ cd src/EmployeeManager/
Dans l’un ou l’autre ordre, accédez aux fichiers côté client ou api/serveur et installez leurs dépendances. Encore une fois, vous aurez besoin d'installer Node.js et npm avec le SDK .Net Core 2.2.
Pour les dépendances côté client :
~$ cd src/EmployeeManager/client~$ npm install
Assurez-vous que @angularcli est également installé :
# pour Angular~$ npm install -g @angular/cli @angular/core
Pour le code côté serveur, créez et restaurez les dépendances et les packages NuGet :
~$ cd src/EmployeeManager/server/~$ restauration dotnet
Pour exécuter un environnement local côté client : utilisez les commandes de script npm dans une boîte de terminal/commande dans le répertoire ../client :
# pour le client angulaire ~$ ng build -options
Cela génère un fichier JavaScript minifié dans le répertoire wwwroot de l'API via les scripts angular.json .
Pour exécuter un environnement local côté serveur : utilisez l'outil dotnet pour l'exécuter dans un terminal ou utilisez Visual Studio pour l'exécuter avec CTL + F5
Accédez à localhost:5001 (ou à ) dans un navigateur pour voir la version actuelle en cours d'exécution.
Ajoutez une autorisation et une connexion.
Activez la recherche par nom d'employé.
L'action Update dans la classe de point de terminaison du contrôleur sous ApiVersion 2 (c'est-à-dire api/v2/endpoint) a un problème avec l'envoi de requêtes réussies au serveur car AutoMapper n'est pas en mesure de lier EmployeeDto à EmployeeUpdateDto , il utilise donc la classe de contexte à la place. sur la version 1 sous la route /v1/... (le problème a été résolu)
