"<< Retour à l'index ":./index.html

h1. Aide de l'application DSN Valid

L'application _DSN Valid_ !../icons/dsn-val_logo16x16.png! permet de contrôler que des envois DSN sont conformes relativement à la version en cours de la norme d'échange utilisée dans le cadre de la DSN.   

h2. Sommaire

{toc:style=disc|minLevel=2|maxLevel=5}

h2. Pré-requis

Pour pouvoir lancer l'application en mode graphique il est nécessaire que la machine virtuelle Java utilisée par le système par défaut corresponde à l'architecture du package d'Autocontrole utilisée. Dans le cas contraire, un message d'erreur s'affichera au lancement indiquant qu'il manque une librairie.

* Si le package téléchargé utilise l'architecture x86, il faut que la machine virtuelle Java par défaut ai une architecture 32bit.
* Si le package téléchargé utilise l'architecture x86_64, il faut que la machine virtuelle Java par défaut ai une architecture 64bit.

Si vous avez installé plusieurs machines virtuelles Java avec différentes architectures, vous pouvez sélectionner celle à utiliser par défaut de la manière suivante :

Pour Windows 7 : 
* Aller dans le panneau de configuration puis sur système. 
* Cliquez sur "paramètres avancés". Cliquez sur variables d'environnement. 
* Créez une nouvelle variable système JAVA_HOME ou modifier la si elle existe déjà. 
* Et rentrer le chemin vers le répertoire ou est installé le Java à utiliser. Ex "C:\Program Files\Java\jre6".
* Modifier la varaible système "Path". Ajoutez au tout début "%JAVA_HOME%\bin;". Si l'ajout est fait à la fin, cela ne marchera pas. 
* Appliquer les changement et redérmarrer l'application.

Pour Linux : 
* Ouvrir le fichier caché ".bashrc" à la racine de votre répertoire utilisateur. 
* Ajoutez à la fin la variable JAVA_HOME qui pointe sur le chemin de la machine virtuelle Java à utiliser et exportez la variable. Ex : "JAVA_HOME=/usr/lib/jvm/java-6-oracle export JAVA_HOME"

h2. Organisation et fonctionnalités

L'application DSN Valid !../icons/dsn-val_logo16x16.png! possède une fenêtre principale contenant l'ensemble des contrôles permettant d'accéder aux fonctionnalités ainsi qu'à un ensemble de vues.
Voici la fenêtre principale :

	!{width:70%}images/FenetrePrincipale.png! 

A partir de celle-ci, différentes vues sont accessibles :
* la vue norme permettant de naviguer dans la norme : c'est une arborescence des rubriques,

	!{width:70%}images/VueNorme.png! 
	
* la vue salarié permettant de visualiser la partie du message contrôlé relative à un salarié,

	!{width:70%}images/VueSalarie.png! 
	
* la page d'aide qui permet de visualiser cette page.

h3. La disposition des vues

Les vues peuvent être disposées selon l'humeur de l'utilisateur, par exemple, soit les mettre côte à côte à l'intérieur de la fenêtre principale, par exemple, une à gauche,une à droite,

	!{width:70%}images/VuesCoteACoteGD.png! 

ou bien une en haut, une en bas,

	!{width:70%}images/VuesCoteACoteHB.png! 

soit il y a la possibilité de "sortir" une vue de la fenêtre principale.

	!{width:70%}images/VuesExterieur.png!

Pour faire ceci, il suffit de sélectionner une vue et la glisser/déposer à l'endroit voulu, une forme rectangulaire de pré-affichage se dessine aux endroits dans lesquels la vue peut se déplacer. Par exemple, dans la figure ci-dessous, voici le pré-affichage lorsque l'on a glissé la vue norme sur la partie droite.

	!{width:70%}images/VuesPreAffichage.png!

Bien sûr, il en est de même pour remettre les vues à leur positions initiales.

Il existe aussi la possibilité de minimiser et maximiser les vues soit à l'aide des actions sur le clic droit du menu contextuel soit avec les !../icons/min_view.gif! et !../icons/maximize.gif! en haut à gauche de la vue.

	!=images/OptionsVues.png!

h3. La fenêtre principale

La fenêtre principale se décompose en trois parties :
* un titre contenant les versions de la base de connaissances et de la brique de validation utilisées par DSN Valid !../icons/dsn-val_logo16x16.png!. Cette version intègre la base de connaissance P01V01 et la brique de validation 1.5.
* une barre d'outils contenant les actions disponibles sur DSN Valid !../icons/dsn-val_logo16x16.png!
* la vue principale permettant de naviguer dans les anomalies et de visualiser les informations synthétiques sur le bilan de validation

	!{width:70%}images/FenetrePrincipale2.png!  

h4. La barre d'outils et les actions

Voici la liste des actions disponibles à partir de la barre d'outils :

* !../icons/open32.png! **Ouvrir un fichier** : cette action ouvre une fenêtre de sélection permettant de sélectionner un fichier DSN. Cela peut être directement le fichier DSN ou bien un zip le contenant. L'outil ne fonctionne qu'avec un zip contenant un seul fichier.
Une fois la ressource sélectionnée, le contrôle est lancé et le résultat est affiché dans la vue principale.
Une barre de progression s'affiche durant toute la durée du contrôle.

* !../icons/run32.png! **Rejouer un fichier déjà contrôlé** : Cette action est disponible uniquement si un fichier est déjà contrôlé, dans le cas contraire il faut utiliser l'action "Ouvrir un fichier". Une barre de progression s'affiche durant toute la durée du contrôle.

* !../icons/norme32.png! **Ouvrir la vue norme** : ouvre la vue norme. Cette vue affiche l'arborescence des rubriques de la norme et disponible à tout moment.

* !../icons/export32.png! **Exporter le bilan de validation** : Le bilan de validation peut être enregistré sous les formats html et xml. Par défaut, l'enregistrement se fait à côté du fichier DSN d'entrée.

* !../icons/config32.png! **Modifier les préférences** : dans la page de préférences, on peut modifier le nombre maximum d'anomalies que l'on veut dans le bilan. Par défaut, ce nombre est à 200.

* !../icons/update32.png! **Mettre à jour l'outil** : cette action permet de vérifier si une mise à jour est disponible. Si c'est le cas, l'utilisateur peut alors décider de l'installer.

* !../icons/help32.png! **Ouvrir l'aide** : ouvre cette page.

* !../icons/exit32.png! **Quitter** : il est à noter que cette action est également disponible via le bouton dédié dans le bandeau de la fenêtre principale. 

h4. La vue principale

La vue principale permet de visualiser le résultat du contrôle et ainsi de naviguer dans les anomalies et de visualiser les informations synthétiques sur le bilan de validation.
Elle se décompose en trois parties :
* l'entête,
* la table des anomalies,
* la partie détail.

h4. L'entête

L'entête résume les informations du contrôle. On retrouve donc :
* le nombre d'erreurs détectées avec la proportion des anomalies bloquantes ou non,
* le fichier DSN prit en entrée,
* la taille du contrôle en octets, son nombre de lignes et de salariés,
* le nombre de déclarations totales, valides et non valides.

!{width:70%}images/VuePrincipaleEntete.png! 

h4. La table des anomalies

Elle contient la liste des anomalies du contrôle, dans les colonnes on retrouve pour chaque anomalie :
* son type : bloquant (croix rouge) ou non bloquant (triangle jaune),
* le rang de sa déclaration,
* son rang,
* le nombre d'anomalie,
* sa ligne,
* le code de la rubrique concernée, son libellé et sa valeur,
* son code et message.

!{width:70%}images/VuePrincipaleTable.png!

Toutes les colonnes sont retaillables et triables par ordre croissant et décroissant par rapport à leur contenu.

!{width:70%}images/VuePrincipaleTri.png!

Cette table contient aussi un champ de recherche qui permet de filtrer sur les éléments recherchés voulus. Il est à noter que, sur ce champ de recherche, les caractères joker comme "*" ne fonctionnent pas.
Voici ce que cela peut donner, par exemple, en filtrant sur "S21.G00.06"

!{width:70%}images/VuePrincipaleRecherche.png!

La table et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VuePrincipaleRetail.png!

Sur les éléments de la colonne "Rubrique", il est possible de faire afficher une info-bulle récapitulant les informations de la rubrique en laissant la souris dessus quelques instants.

!{width:70%}images/VuePrincipaleTooltip.png!

Il est à noter que des infos-bulles sont disponibles sur chaque cellule tronquée pour permettre d'avoir le contenu entier de la cellule.

h4. Les détails

Cette section récapitule la description et les valeurs de l'anomalie sélectionnée dans la table. 

!{width:70%}images/VuePrincipaleDetail.png!

Le contenu de cette section peut être copié/collé, soit avec le menu contextuel du clic droit soit avec les raccourcis clavier habituels.

!{width:70%}images/VuePrincipaleDetailCC.png!

La table et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VuePrincipaleRetail.png!


h4. Les actions

Depuis une anomalie de la table, le menu contextuel du clic droit permet deux actions :
* ouvrir la vue norme !../icons/norme.png!. Cette action est disponible sur tous les types d'anomalies et a le même comportement que l'action de la barre d'outils. La vue s'ouvre en sélectionnant la rubrique liée à l'anomalie.
* ouvrir la vue salarié !../icons/salarie.png!. Cette action est uniquement disponible sur des anomalies dont les rubriques sont liées à un salarié et ouvre la vue salarié. La vue s'ouvre en sélectionnant la rubrique liée à l'anomalie.

!{width:70%}images/VuePrincipaleAction.png!

h3. La vue norme

La vue norme permet de naviguer dans l'ensemble des rubriques de la norme : elle est représentée sous forme arborescente.

Elle se décompose en deux parties :
* l'arborescence des rubriques,
* la partie détail.

h4. L'arborescence des rubriques

Cette partie représente l’arborescence des groupes et rubriques de la norme.

Elle contient aussi un champ de recherche qui permet de filtrer sur les éléments recherchés voulus. Il est à noter que, sur ce champ de recherche, les caractères joker comme "*" fonctionnent.
Voici ce que cela peut donner, par exemple, en filtrant sur "siège"

!{width:70%}images/VueNormeRecherche.png!

Le champ de recherche bénéficie d'une "gomme" pour effacer tout le contenu de la recherche.

!{width:70%}images/VueNormeGomme.png!

L'arborescence et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VueNormeRetail.png!

h4. Les détails

Cette section récapitule la description et les valeurs des rubriques ou groupes sélectionnés dans la table. 

!{width:70%}images/VueNormeDetail.png!

Le contenu de cette section peut être copié/collé, soit avec le menu contextuel du clic droit soit avec les raccourcis clavier habituels.

!{width:70%}images/VueNormeDetailCC.png!

L'arborescence et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VueNormeRetail.png!

h3. La vue salarié

La vue salarié permet de visualiser la partie du message contrôlé relative à un salarié.

Elle se décompose en trois parties :
* l'entête
* la table des rubriques et valeurs,
* la partie détail.

h4. L'entête

L'entête résume les informations du salarié. On retrouve donc :
* son nom,
* son prénom,
* son nom d'usage,
* son NIR matricule.

!{width:70%}images/VueSalarieEntete.png! 

h4. La table des rubriques et des valeurs

Cette partie représente l’arborescence des groupes et rubriques de la norme avec les valeurs du salarié.

Elle contient aussi un champ de recherche qui permet de filtrer sur les éléments recherchés voulus. Il est à noter que, sur ce champ de recherche, les caractères joker comme "*" fonctionnent.
Voici ce que cela peut donner, par exemple, en filtrant sur "*nom"

!{width:70%}images/VueSalarieRecherche.png!

Le champ de recherche bénéficie d'une "gomme" pour effacer tout le contenu de la recherche.

!{width:70%}images/VueSalarieGomme.png!

La table et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VueSalarieRetail.png!

h4. Les détails

Cette section récapitule la description et les valeurs des rubriques ou groupes sélectionnés dans la table. 

!{width:70%}images/VueSalarieDetail.png!

Le contenu de cette section peut être copié/collé, soit avec le menu contextuel du clic droit soit avec les raccourcis clavier habituels.

!{width:70%}images/VueSalarieDetailCC.png!

L'arborescence et la section détail sont retaillables en hauteur, il suffit de glisser/déposer sur la "ligne" entre les deux parties (encadrée en rouge dans la figure ci-dessous).

!{width:70%}images/VueSalarieRetail.png!

h3. La synchronisation entre les vues

La vue maîtresse est la vue principale. Lorsqu'une anomalie est sélectionnée dans la table de la vue principale :
- si la vue norme est ouverte : la rubrique correspondant à l'anomalie est sélectionnée dans cette vue,
- si la vue salarié est ouverte et que l'anomalie est liée à un salarié : la rubrique correspondant à l'anomalie est sélectionnée dans cette vue.

!{width:70%}images/SynchroVues.png!

A partir de la vue salarié, la sélection d'une rubrique associée à une anomalie provoque :
- la sélection de l'anomalie dans la table de la vue principale,
- si la vue norme est ouverte : la rubrique correspondant à l'anomalie est sélectionnée dans cette vue.


h3. L'export du bilan de contrôle

Le bilan de validation peut être enregistré sous les formats html et xml. Lorsque l'on clique sur le bouton !../icons/export32.png! de la barre d'outils, une nouvelle fenêtre apparaît et permet de choisir :
* le chemin et le nom du fichier qui va être enregistré,
* le format du bilan qui va être enregistré.

!{width:30%}images/ExportFenetre.png!

Par défaut, l'enregistrement se fait à côté du fichier DSN d'entrée. Le nom de l'export est le même que le fichier DSN d'entrée et le format par défaut est le xml.

Pour changer le répertoire d'enregistrement, il suffit de cliquer sur le bouton "Parcourir" et la fenêtre de sélection de fichier apparaît.
!{width:30%}images/ExportParcourir.png!

Lors du changement de format avec la boite de choix, l'extension du fichier change automatiquement. Par exemple, si par défaut le fichier est "d:/monFichier.dsn.xml", si l'on change le format d'enregistrement en "html", le nom du fichier se transforme en "d:/monFichier.dsn.html"

!{width:30%}images/ExportFormat.png!

Voici un exemple de génération html. Il possède un entête récapitulant les informations générales du contrôle puis
* une liste des anomalies de type envoi
* pour chaque déclaration
** une liste des anomalies qui ne sont pas liées à un salarié
** pour chaque salarié en anomalie, une liste de ses anomalies

!{width:70%}images/ExportHtml.png!

Et un exemple de génération xml, ce format reflète la structure du bilan de contrôle.
!{width:70%}images/ExportXml.png!

h3. La modification des préférences

Les préférences sont accessibles depuis la barre d'outils !../icons/config32.png! et permettent de modifier le nombre maximal d'anomalies que le bilan peut prendre en compte, l'activation de la mutualisation des anomalies ainsi que la norme à utiliser dans DSN-Val.

!{width:30%}images/Parameters.png!

Par défaut, le nombre maximal d'anomalies est à 200. Il est modifiable soit textuellement, soit à l'aide des flèches "haut" et "bas".
Si ce paramètre est valorisé à -1 alors aucune limite ne sera appliquée sur le nombre d'anomalies réstituées lors de la validation.

Par défaut, la mutualisation est désactivée. L'effet de l'activation de ce paramètre provoque, sur les validations futures, 
l'affiche d'une seul anomalie équivanente (même code d'erreur et même rubrique) par déclaration et la valorisation 
de la colonne NbAno avec le nombre d'anomalie trouvé.

!{width:60%}images/VuePrincipaleMutualisation.png!

h3. La mise à jour de l'outil

La vérification des mises à jour de DSN-Valid !../icons/dsn-val_logo16x16.png! se fait grâce au bouton !../icons/update32.png! de la barre d'outils. 
Si aucune mise à jour n'est disponible, une fenêtre informe que l'outil est à jour.
!{width:30%}images/MAJDejaAJour.png!

Si une mise à jour est disponible, une fenêtre apparaît laissant le choix à l'utilisateur d'installer ou non cette mise à jour.
!{width:30%}images/MAJQuestion.png!

Si oui, la mise à jour est téléchargée. Une fois que cela est fini, un message informe l'utilisateur que l'outil va redémarrer pour prendre en compte les changements.

!{width:30%}images/MAJRedemarrage.png!

Si le site de mises à jour a besoin d'être modifié, cela est possible en modifiant le fichier "DSN-Validateur.ini" et en remplaçant le paramètre "fr.cnav.autocontrole.updatesite.loc" par sa nouvelle valeur.
Par exemple, -Dfr.cnav.autocontrole.updatesite.loc=http://dsnval.cnav.update

