Configuration site
Cette configuration se trouve dans le fichier FudaaCrue_Site.xml. Ce fichier est présent dans le dossier d'installation de Fudaa-Crue soit <INSTALL_DIR>.
Par exemple, ce dossier pourra être P:\FudaaCrue\v1.0 ou C:\Program Files\FudaaCrue\v1.0
Ce fichier n'est pas éditable depuis l'interface est il sera uniquement modifié manuellement par les installateurs. si absent, un fichier par défaut sera proposé par Fudaa-Crue et créé automatiquement.
La configuration du répertoire utilisateur ( voir prochain paragraphe) ne sera pas effectué dans ce fichier mais dans un fichier propre à Netbeans soit <INSTALL_DIR>/conf/netbeans.conf (Note: documentation à compléter ici)
Le fichier FudaaCrue_Site.xml sera constitué de la façon suivante:
<Configuration> <Site> <!--contient les informations non modifiables par l'utilisateur--> <Coeurs> <!--voir le paragraphe sur l'élément coeurs pour le détail--> </Coeurs>
<SiteAide Type="Relative">
<Commentaire>Aide Flare</Commentaire>
<SyDocActivation>False</SyDocActivation>
<!-- Chemin défini en relatif (car Type="Relative") -->
<CheminBase>aide/%1$s/SyDoC_HTML/Default.htm#cshid=</CheminBase>
<!-- Chemin défini en absolu (si Type="Absolu") -->
<!--
<CheminBase>//serveur/documentation/aide/%1$s/SyDoC_HTML/Default.htm#cshid=</CheminBase>
-->
</SiteAide> <SiteOptions> <SiteOption Nom="ExeCrue9" UserVisible="true"> <Commentaire> Chemin vers l'executable crue 9. Cette option est visible en lecture seule par l'utilisateur car le paramètre UserVisible est a true. </Commentaire> <Valeur>C:\exe\crue9</Valeur> </SiteOption> </SiteOptions> </Site> <User> <!--contient les informations modifiables par l'utilisateur--> <UserOptions> <UserOption Nom="CheminEditeurTexte"> <Commentaire>Chemin vers un editeur texte</Commentaire> <Valeur>Notepad</Valeur> </UserOption> </UserOptions> </User> </Configuration>
Cette organisation permet à l'installateur de déterminer ce qui sera éditable par l'utilisateur. Dans l'exemple ci-dessus CheminEditeurTexte est éditable alors que
ExeCrue9 ne l'est pas. Si l'installateur déplace l'entrée ExeCrue9 dans l'élément User, cette option deviendra éditable par l'utilisateur.
Configuration utilisateur
Dans la version actuelle de Netbeans RCP, ce dossier se trouvera dans le répertoire Home\FudaaCrue\<version>
Il est prévu dans la version 7.1 de Netbeans de modifier cette configuration pour placer ce dossier dans le répertoire "correct" de Windows soit
%APPDATA%\FudaaCrue. Voir http://wiki.netbeans.org/UserdirAndCachedirFoldersInSystemSpecificPaths
Netbeans 7.1 est prévu pour le 14 décembre 2012 et sera intégré aussitôt dans Fudaa-Crue.
Le fichier FudaaCrue_User.xml est placé dans Home\FudaaCrue\<version> ( ce dossier est configurable).
Il permet de redéfinir les options utilisateur soient celles qui sont placées dans le tag <User> du fichier FudaaCrue_Site.xml. C'est le seul fichier modifié par l'interface.
Ce fichier est automatiquement créé par Fudaa-Crue s'il est absent.
<Configuration> <User> <!--contient les informations modifiables par l'utilisateur--> <UserOptions> <UserOption Nom="CheminEditeurTexte"> <Commentaire>Chemin vers un editeur texte</Commentaire> <Valeur>Notepad2</Valeur> </UserOption> </UserOptions> </User> </Configuration>
l'élément <coeurs>
Cet élément fichier contient la liste des coeurs utilisables dans l'application. Un coeur est défini par :
- un identifiant ( chaine de caractère) qui doit être unique.
- un chemin vers le dossier du coeur
- une version de grammaire
- une propriété indiquant si c'est le coeur par défaut pour la grammaire en question.
Si un seul coeur est défini pour une grammaire donnée, il devra avoir la propriété par défaut initiée à true.
<Coeurs> <Coeur id="coeur1"> <Commentaire>Utile?<Commentaire> <VersionGrammaire>1.2<VersionGrammaire> <CoeurParDefaut>true</CoeurParDefaut> <DossierCoeur>C:\DossierCoeur<DossierCoeur> <!-- Chemin absolu--> <Coeur> </Coeurs>
Validation d'un élément Coeur
A l'ouverture les validations suivantes seront effectuées:
- respect de la grammaire coeurs.xsd. Cette grammaire permettra de s'assurer de l'unicité des identifiant de coeur
- pour une version de grammaire donné , un seul coeur doit être défini comme coeur par défaut.
- chaque dossier doit être valide et unique
Structure type d'un dossier Coeur
|- CrueConfigMetier.xml ( fichier de configuration des propriétés, epsilon, plage de validité,...) |- exe |-crue10.exe |- fichiers_vierges ( dossier contenant les fichiers vierges Crue 10 ) |- |- xsd ( dossier contenant les xsd pour Crue 10) |-*.xsd
Un dossier coeur sera valide si:
- il a la structure décrite ci-dessus.
- Les fichiers vierges ( dossier fichiers_vierges) sont décrit dans la même version que celle définie dans le fichier coeur.xml
- Le dossier xsd est complet ( xsd par type de fichier) et dans une version cohérente avec celle du coeur.
- Le fichier CrueConfigMetier.xml est valide
- Les dossiers des exécutables contiennent les exécutables nécessaires ( ?)
Chargement et validation de la configurations des coeurs
Le paramétrage des coeurs sera rechargé et validé :
- à chaque ouverture d'étude en mode interactif,
- à chaque ouverture de campagne dans la fonctionnalité OTFA.
Si une étude est ouverte, les modifications des fichiers de configurations ne seront pas rechargés. Seuls les fichiers de scénarios vierge sont relus à chaque usage ( conversion, chargement scénario Crue 9).