Documentation

AFCO

Back-end
 PLAN

1. Pré requis du projet

2. Installation des outils
2.1 Installation Visual Studio
2.2 Installation SQL Server
2.3 Installation .Net SDK
2.4 Installation VScode
2.5 Installation Github Descktop
3. Récupération du code
4. Configurations
4.1 Configuration du PC
4.2 Configuration de SQL Server
• Backup de la base de données
• Création d’un utilisateur
4.3 Configuration du projet cloné
5. Exécution du projet
 DOCUMENTATION AFCO 3

Documentation back-end

1. Pré requis du projet

 Processeur : i7
 RAM : 32 Go
 Espace disque : 930 Go
 Windows 10 professionnel

2. Installation des outils

2.1 Installation Visual Studio

Version : 2019
Lien de téléchargement :
https://my.visualstudio.com/Downloads?q=visual%20studio%202019&wt.mc_id=o~msft~vscom~older
-downloads
Etapes de téléchargement et d’installation :
1. Télécharger la version Community 16.11

2. Lancer l’exécutable (Visual Studio installer) téléchargé en double cliquant dessus

3. Accepter et continuer
4. Les outils à cochet pour installer sont :
 DOCUMENTATION AFCO 4

Documentation back-end

5. Cliquer sur installer en bas à droit et attendre la fin des téléchargements et installations
6. Après l’installation, on peut lancer Visual Studio à partir de l’installer ou directement.
 DOCUMENTATION AFCO 5

Documentation back-end

2.2 Installation SQL Server

Version : 2019
Lien de téléchargement : https://www.microsoft.com/en-us/sql-server/sql-server-downloads
Etapes de téléchargement et d’installation :
1. Télécharger la version développeur

2. Lancer l’exécutable téléchargé en double cliquant dessus

3. Sélectionner un type d’installation de base, accepter les conditions puis installer
4. Une fois l’installation terminée cliquer sur « Installer SSMS » qui permet la redirection vers la
page d’installation de SQL Server Management Studio.
5. Naviguer vers la section « Télécharger SSMS » puis cliquer sur le lien de téléchargement

6. Une fois téléchargement terminé il suffit de l’installer en double cliquant dessus et suivre
l’assistant d’installation.
7. Après l’installation, on peut lancer SSMS
 DOCUMENTATION AFCO 6

Documentation back-end

2.3 Installation .Net SDK

Les outils à installer sont disponibles ici.
Il suffit de les exécuter.

2.4 Installation VScode

Version : la dernière version
Lien de téléchargement : https://code.visualstudio.com/
Il suffit de le télécharger et suivre l’assistant d’installation.

2.5 Installation Github Descktop

Version : la dernière version
 DOCUMENTATION AFCO 7

Documentation back-end

Lien de téléchargement : https://desktop.github.com/

Une fois téléchargé, il suffit de l’exécuter pour l’installer.

3. Récupération du code
1. Se connecter sur Github avec le compte :
 Login : adnen@weebuild.tech
 Mot de passe : Afco2022!
2. Naviguer vers le dossier backend, cliquer sur le bouton « code » et copier l’URL HTTPS

3. Lancer Github Desktop et cliquer sur « clone repository from internet »

 DOCUMENTATION AFCO 8

Documentation back-end

4. Dans l’onglet URL, coller l’URL copié dans le champ « Repository URL » et spécifier
l’emplacement où ce repository sera stocké sur le PC dans « local path »

5. Cliquer sur clone

Une fois le clonage terminé, vous aller avoir le projet du backend sur votre PC à
l’emplacement spécifié.
 DOCUMENTATION AFCO 9

Documentation back-end

4. Configurations

4.1 Configuration du PC
Création d’une variable d’environnement système :
• Nom : ASPNETCORE_URLS
• Valeur : http://localhost:44301

4.2 Configuration de SQL Server

• Backup de la base de données

 DOCUMENTATION AFCO 10

Documentation back-end

1. Télécharger le fichier de backup disponible ici.

2. Lancer SSMS, faire un click droit sur « Databases » > cliquer sur « Restore Database »

3. Cliquer « Device » > choisir « File » comme device > naviguer vers l’emplacement du fichier
de backup récupéré.
 DOCUMENTATION AFCO 11

Documentation back-end

4. Cliquer OK dans toutes les fenêtres et attendre la fin de backup, un message de succès sera
affiché à la fin.
 DOCUMENTATION AFCO 12

Documentation back-end

• Création d’un utilisateur

1. Dans SSMS, aller sous « Security » > « Logins » > « new Login »

2. Remplir le formulaire comme suit puis cliquer sur OK

Login name : afco
Password : 123
 DOCUMENTATION AFCO 13

Documentation back-end

Et on coche « SQL Server Authentification »

3. Fermer SSMS et on redémarre le service SQL Server

4. Ouvrir SSMS et se connecter avec le login créé

 DOCUMENTATION AFCO 14

Documentation back-end

4.3 Configuration du projet cloné

1. Ajout du fichier « Integral.AFCO.WebAPI.sln » dans le projet cloné (Backend), le fichier est

disponible ici.
2. Dans le projet du backend sous « src\Integral.AFCO.Web.Host », remplacer les fichiers
« appsettings.json » et « appsettings.Production.json » par les versions disponibles ici et ici.
3. Dans les deux nouveaux fichiers « appsettings.json » et « appsettings.Production.json », on
configure la chaine de connexion comme suit :

Avec Server est le nom de serveur :

Database est le nom base, User Id est le nom de login créé.

4. Sous « src\Integral.AFCO.AngularUI\projects\order\src\environments », remplacer les
fichiers « environments.prod.ts » et « environment.ts » par les versions disponibles ici et ici.
5. Sous « src\Integral.AFCO.AngularUI\src\assets », remplacer le fichier « appconfig.json » par
le fichier disponible ici.
 DOCUMENTATION AFCO 15

Documentation back-end

5. Exécution du projet
Pour exécuter le projet, il faut :
1. Naviguer vers le dossier du projet Backend et lancer le projet en double cliquant sur
« Integral.AFCO.WebAPI.sln »

2. La solution sera ouverte dans Visual Studio

 DOCUMENTATION AFCO 16

Documentation back-end

3. Vérifier que la branche utilisée est « Development »

4. Dans l’explorateur de solutions, faire un click droit sur la solution « Integral.AFCO.WebAPI » et

choisir « Regénérer la solution »

Si tout vas bien on obtient :

 DOCUMENTATION AFCO 17

Documentation back-end

5. Aller dans « src\Integral.AFCO.Web.Host » et taper « cmd. » dans la barre de l’explorateur de

fichiers et valider par la touche Entrée.

6. Taper « dotnet run » dans l’invite de commande qui s’ouvre et attendre la fin de l’exécution
du projet.

Le message ci-dessus marque le succès de l’exécution de projet.

7. Dans VSCode, ouvrir le projet « \src\Integral.AFCO.AngularUI »

8. La première fois il faut taper « npm i » pour installer les packages npm utilisés dans le projet
Angular.
9. Pour lancer le projet, il faut taper « npm start »

Le message ci-dessus marque le succès de l’exécution de projet, il suffit d’ouvrir ce lien dans
le navigateur
 DOCUMENTATION AFCO 18

Documentation back-end

Remarque :
Si lors de la génération de solution vous obtenez des erreurs liés aux package NuGet, il faut
aller dans « outils » > « Gestionnaire de package NuGet » > « Paramètres de Gestionnaire de
Package »

Et vérifier que la configuration des Sources de packages est la suivante

DOCUMENTATION AFCO 19

Documentation back-end