Utilisation du logiciel N4DS CSV
- Cliquer sur l’une des icônes créées durant l’installation, pour démarrer le logiciel.
- Le logiciel démarre, on obtient l’écran suivant :
Description des parties du logiciel
Menu
- Cette partie contient 2 menus « Fichier » et « Aide ».
- La partie « Aide », contient une rapide description du logiciel
- La partie « Fichier » permet de quitter le logiciel, charger le fichier de configuration du logiciel ou encore d’enregistrer la configuration actuellement du logiciel.
Onglets
L’onglet conversion correspond à l’interface, permettant de configurer cette conversion et de la lancer. Cette fenêtre est composée de plusieurs parties.
La partie « Configuration » permet de paramétrer cette conversion.
- Fichier Param.cfg : Par défaut un fichier de configuration rassemble l’ensemble de ces éléments, il s’agit du fichier Param.cfg. Il est affiché ici et ne doit pas être modifié normalement.
- Fichier Norme DADS-U : Le fichier suivant contient la norme DADS-U sur laquelle le logiciel va s’appuyer pour effectuer la conversion. Ce fichier est affiché dans la seconde partie sous forme de tableau. Ce fichier n’est pas à mettre à jour directement sauf cas très particulier, il faut préférer passer par l’interface du logiciel et le tableau, en sélectionnant ou pas les rubriques de la norme DADS-U.
- Fichier de Structure de la Norme DADS-U : Le fichier de structure de la norme DADS-U, permet au logiciel de hiérarchiser les groupes de structures entre elles et de décrire divers éléments techniques, permettant de convertir correctement les données DADS-U.
- Le nom du fichier DADS-U à convertir : Il s’agit du fichier DADS-U qui doit être converti. Ce fichier doit être validé par le logiciel de contrôle DADS-U, toute anomalie, pourra entrainer une conversion fausse et des erreurs avec ce logiciel. Vous pouvez très facilement changer le nom du fichier affiché, en double cliquant sur la zone contenant le nom de ce fichier, une pop-up d’aide apparaîtra et vous permettra de rechercher, puis sélectionner facilement le fichier DADS-U à convertir.
- Le répertoire du résultat : Il s’agit du répertoire qui va être utilisé pour stocker les divers fichiers résultants et résultat de la conversion. Vous pouvez très facilement changer le nom du répertoire affiché, en double cliquant sur la zone contenant le nom du répertoire, une pop-up d’aide apparaîtra et vous permettra de rechercher, puis sélectionner facilement le répertoire. Il vous est aussi possible de saisir directement le nom du répertoire, mais aucun contrôle n’est prévu sur la validité du répertoire saisi, cela reste de la responsabilité de l’utilisateur.
- Le nom du fichier Résultat : Ce nom correspond au préfixe qui sera utilisé sur l’ensemble des fichiers résultants et résultat de la conversion. Vous pouvez ainsi changer de nom de fichier, entre 2 conversions, pour ne pas écraser vos précédents résultats.
- Les options de conversion : La conversion du fichier DADS-U ne peut pas s’effectuer d’un seul bloc à cause de la norme DADS-U elle-même. Cette norme impose un découpage par groupe de structures, sinon les résultats affichés ne seront pas exploitables et/ou faux. Ainsi ce menu déroulant permet de sélectionner l’option de conversion choisie, c’est-à-dire, convertir l’ensemble des groupes de structures, réparti par groupe de structures ou sélectionner le groupe de structures spécifique que l’on souhaite convertir. Afficher les lignes sans la structure recherchée : Cette option, permet de faire apparaître la clé présente dans le fichier DADS-U, même si le groupe de structures n’est pas alimenté. Cela peut être très utile pour détecter les personnes présentes dans le fichier DADS-U, mais pour lesquelles il manque une structure.
- Sortie au format CSV : Il faut sélectionner cette option pour obtenir en sortie des fichiers au format CSV.
- Sortie au format Excel : Il faut sélectionner cette option pour obtenir en sortie un fichier au format Excel.
- Progress Bar : Il s’agit de la barre de progression, qui permet de visualiser l’avancement de la conversion. Dès que la barre est de nouveau vide, la conversion est terminée.
Le tableau
Il s’agit du fichier norme DADS-U, indiqué dans la partie « Fichier Norme DADS-U » qui est affiché sous forme de tableau.
- La première colonne « Rub. DADS-U » affiche le code de la rubrique DADS-U et permet de sélectionner ou non la rubrique du fichier DADS-U à partir de la norme DADS-U.
- La seconde colonne « Libellé » affiche le libellé de la rubrique DADS-U.
- La troisième colonne indique si cette rubrique DADS-U fait partie de la clé qui sera reportée sur chaque résultat. Il s’agit de reporter sur le résultat les structures parentes, lors du traitement d’une structure fille, par exemple Ajouter des indications sur les structures S20 et S30, lors du traitement de la structure S41.
- La colonne suivante « Regroupement » est utilisée pour le découpage des résultats sous plusieurs fichiers ou onglets.
- Les colonnes suivantes sont utilisées par le logiciel pour correctement convertir les données en fonction de la norme et ne doivent pas être modifiées.
Barre inférieure
Elle permet de :
- Lancer la conversion du fichier DADS-U selon les divers éléments paramétrés au dessus.
- Le bouton « Recharger la norme XML » permet de recharger le fichier contenant la norme et les sélections de structures, pour le cas particulier ou un utilisateur aurait directement mis à jour le fichier XML, contenant cette norme.
- La barre d’état, permet de suivre les étapes de la conversion.
- Le bouton « Quitter » permet de quitter le logiciel.
Fonctionnement général du logiciel
Cette partie décrit le fonctionnement général du logiciel.
Objectif du logiciel
L’objectif de ce logiciel est de convertir le fichier en entrée sous un format exploitable par un tableur dans un ou plusieurs fichiers de sortie, ici au format CSV ou Excel.
Fichier en entrée
Le fichier en entrée du système a la forme suivante.
- S10.G01.00.001.001,’S10.G01.00.001.001′
- S10.G01.00.001.002,’S10.G01.00.001.002′
- S10.G01.00.002,’S10.G01.00.002′
- S10.G01.00.003.001,’S10.G01.00.003.001′
- S10.G01.00.003.003,’S10.G01.00.003.003′
- S10.G01.00.003.006,’S10.G01.00.003.006′
- S10.G01.00.003.007,’S10.G01.00.003.007′
- S10.G01.00.003.009,’S10.G01.00.003.009′
- S10.G01.00.003.010,’S10.G01.00.003.010′
- S10.G01.00.003.012,’S10.G01.00.003.012′
- S10.G01.00.004,’S10.G01.00.004′
- S10.G01.00.005,’S10.G01.00.005′
- S10.G01.00.006,’S10.G01.00.006′
- S10.G01.00.009,’S10.G01.00.009′
- S10.G01.00.010,’S10.G01.00.010′
- S10.G01.00.011,’S10.G01.00.011′
- S10.G01.00.012,’S10.G01.00.012′
- S10.G01.00.013.001,’S10.G01.00.013.001′
- S10.G01.00.013.002,’S10.G01.00.013.002′
- S10.G01.00.015.001,’S10.G01.00.015.001′
- S10.G01.01.001.001,’S10.G01.01.001.001′
- S10.G01.01.001.002,’S10.G01.01.001.002′
- S10.G01.01.002,’S10.G01.01.002′
- S10.G01.01.005,’S10.G01.01.005′
- S10.G01.01.006,’S10.G01.01.006′
- S20.G01.00.001,’S20.G01.00.001′
- S20.G01.00.002,’S20.G01.00.002′
- S20.G01.00.003.001,’S20.G01.00.003.001′
- S20.G01.00.003.002,’S20.G01.00.003.002′
- S20.G01.00.004.001,’S20.G01.00.004.001′
- S20.G01.00.004.002,’S20.G01.00.004.002′
- S20.G01.00.005,’S20.G01.00.005′
- S20.G01.00.007,’S20.G01.00.007′
- S20.G01.00.008,’S20.G01.00.008′
- S20.G01.00.009.006,’S20.G01.00.009.006′
- S20.G01.00.009.007,’S20.G01.00.009.007′
- S20.G01.00.009.009,’S20.G01.00.009.009′
- S20.G01.00.009.010,’S20.G01.00.009.010′
- S20.G01.00.009.012,’S20.G01.00.009.012′
- S20.G01.00.018,’S20.G01.00.018′
- S30.G01.00.001,’S30.G01.00.001_U’
- S30.G01.00.002,’S30.G01.00.002′
- S30.G01.00.003,’S30.G01.00.003′
- S30.G01.00.004,’S30.G01.00.004′
- S30.G01.00.005,’S30.G01.00.005′
- S30.G01.00.007,’S30.G01.00.007′
- S30.G01.00.008.003,’S30.G01.00.008.003′
- S30.G01.00.008.006,’S30.G01.00.008.006′
- S30.G01.00.008.010,’S30.G01.00.008.010′
- S30.G01.00.008.012,’S30.G01.00.008.012′
- S30.G01.00.009,’S30.G01.00.009′
- S30.G01.00.010,’S30.G01.00.010′
- S30.G01.00.011,’S30.G01.00.011′
Fichier en sortie
Le fichier en sortie du système doit avoir la forme suivante :
Algorithme
Ce logiciel, va charger les options de configuration indiquées sur le page principale, ouvrir et lire le fichier DADS-U en entrée. Pour chaque ligne, il va vérifier si il doit garder ou pas son contenu, par rapport à la première colonne du fichier norme DADS-U. Si la colonne est cochée, elle sera gardée, sinon, on passe à la ligne suivante. Dans le cas ou la ligne est gardée, le système va ensuite vérifier si il s’agit d’une partie de la clé ou pas. Si cette ligne fait partie de la clé elle va être gardée en mémoire. Si la ligne ne fait pas partie de la clé, le système va vérifier si le groupe auquel appartient cette clé est en cours de traitement. S’il s’agit du même groupe, la valeur est sauvegardée, sinon on passe à la ligne suivante. A la fin du fichier, on enregistre le résultat au format CSV et/ou Excel. Si d’autres groupes doivent être traités, on effectue un nouveau passage de l’algorithme, sinon on termine le programme.
Résultat
Au format CSV, le système ne peut enregistrer qu’un seul fichier, dont les valeurs sont séparées (ici par une virgule). Etant donné qu’il est nécessaire d’effectuer une rupture si les données ne font pas partie du même groupe, le système va donc créer, plusieurs fichiers en sortie, un par groupe. Le nom de ces fichiers est définie par : « Le nom du fichier Résultat » + « _ » + le groupe + «.csv ».
Au format Excel, le système peut enregistrer plusieurs résultats différents dans un même fichier, mais sous des onglets différents. Il s’agit du même résultat que celui proposé au format CSV, mais directement exploitable par le logiciel Excel.
La liste des colonnes présentent dans les fichiers résultats correspond à une partie clé et une partie donnée du groupe.
La partie entourée en bleu correspond à la clé et la partie en vert correspond aux données sélectionnées du groupe. Toutes ces données peuvent être identifiées au niveau du fichier de paramétrage norme DADS-U.
Aspects techniques
Le fichier Param.cfg
Ce fichier se situe à la racine du répertoire d’installation du logiciel, par défaut : C:\Program Files\DADSU_CSV_V01X09.
Il contient les éléments suivants :
- [NORMEXML]=.\box\normeV01X09.xml
- [STRUCXML]=.\box\structureV01X09.xml
- [FICDADSU]=H:\001 – SIRH\E BOCQUET\Intervention\DADS-U\testDADS-U_V01X09.txt
- [FICRESUL]=Resultat_V01X07
- [REPRESUL]=C:\Documents and Settings\EBO\Bureau
Il s’agit d’une partie des données présentes à l’écran, dans la partie configuration du logiciel. Il est possible de modifier directement ce fichier, mais cela reste assez dangereux et il faudra recharger ce fichier ou redémarrer le logiciel pour que les nouvelles valeurs soient correctement prises en compte.
Le fichier Norme DADS-U.xml
Ce fichier se situe dans le répertoire « box » du répertoire d’installation du logiciel, par défaut : C:\Program Files\DADSU_CSV_V01X07\box.
Il contient les éléments suivants :
Il s’agit d’un fichier XML, dont la racine correspond à la balise « norme ». Puis à l’intérieur de cette balise, on va décrire l’ensemble de la norme DADS-U en cours d’utilisation. Chaque ligne correspond à une balise « rubrique ». Chaque balise « rubrique » contient d’autres balises.
- La balise « key » représente la partie clé, si la valeur est à « true », cette rubrique sera considérée par le système comme faisant partie de la clé, sinon non.
- La balise « value » représente le code rubrique DADS-U (S**.G**.**).
- La balise « selection » représente la coche dans le tableau qui est affiché par le logiciel. Si la valeur est à « true », cette rubrique sera sélectionnée pour être convertie, sinon non.
- La balise « libelle » contient le libellé de la rubrique DADS-U (pour cette norme).
- La balise « condition » contient le groupe de structure ou la colonne « regroupement » du tableau. C’est à partir de cette colonne que l’on regroupe les rubriques au sein d’un même fichier (sauf cas particulier des clés).
- La balise « longueur » contient une valeur permettant d’indiquer au système comment gérer l’extraction de cette rubrique. « C » pour court (Ex : S20.G01.00.001) et « L » pour long (Ex : S20.G01.00.003.001).
- La balise « type » contient une valeur permettant d’indiquer au système comment gérer les données de cette rubrique. « C » par défaut et pour les codes, « M » pour un montant et « S » pour le signe.
Le fichier Structure DADS-U.xml
Ce fichier se situe dans le répertoire « box » du répertoire d’installation du logiciel, par défaut : C:\Program Files\DADSU_CSV_V01X09\box.
Il contient les éléments suivants :
Il s’agit d’un fichier XML, dont la racine correspond à la balise « structures ». Puis à l’intérieure de cette balise, on va décrire l’ensemble des groupes de structure de la norme DADS-U en cours d’utilisation. Chaque ligne correspond à une balise « structure ». Chaque balise « structure » contient d’autres balises. Il s’agit surtout d’indiquer la hiérarchie entre les différents groupes de structure.