Vue d'ensemble
Les principaux composants de SAINet sont présentés dans l’image ci-dessous:
Les différents composants peuvent être compilés et lancés sur le poste en local. Pour cela il sera nécessaire d’avoir au préalable:
- JDK
- Maven
- un accès a git
- Git Bash (Windows)
- NetBeans ou un autre IDE qui supporte Java et Maven
- (pour la documentation) Node.js (>=14)
@[success](Une série de tutoriels vidéos est disponible au bas de cette page. Pour les nouveaux, il est conseillé de :
- parcourir la présente page afin de se faire une idée d’ensemble de SAINet et de son fonctionnement, puis
- installer son espace de travail
- suivre les tutoriels.)
Le serveur ainsi que le jeu de donnée de test sont à récupérer dans son espace de travail local. Le serveur peut ensuite être compilé (en mode embedded) puis lancé en lui spécifiant un répertoire de travail temporaire ainsi qu’une base de données de référence à importer.
Il est préférable d’installer SAINet et ses différents composants dans un répertoire à la base de disque pour éviter les problèmes liés au nom de chemin trop long, surtout sous Windows (par exemple C:\Work
Les répertoires de travail du serveur SAINet et les bases de données de référence res_data doivent être clonées en local à partir du repository git.
Les projets du groupe res_data sont des jeux de données de référence qui permettent de lancer un serveur avec des données déjà préchargées. Elles sont aussi utilisées lors de l’execution des tests d’intégration.
Il existe plusieurs bases de données de référence qui correspondent à chaque métier (régie, creche, …).
Afin d’éviter d’avoir à installer un serveur de base de données sur la machine, SAINet utilise H2, qui est une base de données embarquées assez proche de MySQL/MariaDB.
Le serveur SAINet est une application Java EE qui peut être lancée en mode Embedded Server après compilation.
Pour le lancer, il est nécéssaire de spécifier le répertoire qui contient la base de donnée res_data à importer ainsi qu’un espace de travail temporaire (ici tmp-runtime).
La procédure d’installation du client riche permet de récupérer l’installeur via ce lien.
Une fois installé, le client riche se met à jour automatiquement au lancement.
- Récupération/préparation des sources:
- récupération res_data.
- récupération sainet.
- compilation sainet.
- Lancement du serveur en mode embedded.
- Lancement du client ou des outils.
Il est possible que certaines informations présentes dans ces vidéos aient évolué. Référez-vous à la documentation pour avoir des informations à jour.
-
Gitlab - débuter - 6’53 : Bonnes pratiques, merge requests et pipelines
-
Structure SAINet - 1h25’02
Timeline :
00’00 : Structure du logiciel
08’15 : Présentation du logiciel et principe d’installation et de mise à jour.
14’35 : Correspondance affichage-données, avec :
- dès 23’08 : définition des données structure TablesAndDataFields_—.xml
- dès 28’19 : définition du visuel : TasksAndFields_—.xml
- dès 41’15 : les combos (enums)
- dès 44’00 : Les Dashboards
- dès 45’03 : Les Grilles (Grids) et les formateurs (47’21)
- dès 52’03 : LSV (Le Saviez-Vous), Notifications et PopupMenus (1h00’36)
1h06’45 : Messages et labels custom & messages d’erreur business
1h09’48 : intro sur la partie JAVA.
-
Outils : AdminClient et ConfigurationWatch - 13’23
00’18 : AdminClient
02’13 : ConfigurationWatch
-
Création d’une page - 32’03
00’00 : Page simple
19’29 : merge request pour la page créée
22’23 : Page avec couples et combos
-
PageHandler - 4’06 : classe java gérant les comportements au sein d’une page.
-
CallOnValidate - 5’35 : attribut de champ (xml) et comportement (
onFieldChange
) java. -
onGetPageData - 3’06 : à l’ouverture / chargement d’une page.
-
API de dossier - 6’18 : éviter les queries sql - gérer les données dossier par java
-
Utilitaires business (
---Utils_---.java
) - 2’56 : Fonctions business utilisées à plusieurs endroit du code. -
Code business - hot reload - 7’15
-
Créer des tests en local - 5’21
-
Les Grilles (Grids) - 13’55
-
Les Dashboards - partie 1 - 6’50
-
Les Dashboards - partie 2 - 5’23