aboutsummaryrefslogtreecommitdiffstats
path: root/app/views/help/validations.textile
blob: d4eb258809c6af60f4954cba2b4e1f2911973d71 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
---
layout: default
title: Validation
---

h3. Rôle

p. La validation permet d'effectuer un ensemble de contrôles syntaxiques, sématiques et structurels sur une offre de transport.
Elle se décompose en 3 phases (ou niveaux)

- Phase 1 := les données doivent respecter un format d'échange définissant une syntaxe et une sémantique précise (Actuellement seul le format Neptune est implémenté)
- Phase 2 := les données doivent respecter le niveau de complétude et de cohérence du format d'échange (Actuellement seul le format Neptune est implémenté).
- Phase 3 := l'offre est analysée dans ses fonctionnalités et subit des contrôles de réalisme, cette phase est indépendante du format d'échange. 

Les tests de validation sont décrits sur le site "chouette.mobi":http://www.chouette.mobi/spip.php?rubrique24

h3. Formats disponibles 

- Neptune := format normalisé des échanges de données de transport en commun pour la France (cf "Normalisation":normalisation)
- Données internes Chouette := tests sur les objets déjà importés ou créés/modifiés en base (Phase 3 uniquement)

h3. Activation

La validation peut être activée sur un fichier lors de son import en précisant les paramètres nécessaires à la phase 3.

L'onglet validation permet de réaliser un contrôle 'Phase 3' sur tout ou partie des lignes stockées en base. 

h3. Paramètres communs

- Jeu de paramètres pour validation := paramètres définisant les seuils des tests de niveau 3

p(ddnext). - les jeux de paramètres sont créés via le lien ["Jeux de paramètres":parametersets] disponible sur les vues des listes d'imports et de validations

- Type de données incluses := critère de sélection des lignes à contrôler.

h3. Consultation des résultats

p. La validation est lancée en différé; son état d'avancement est affiché sous la forme d'une icône donc la couleur dépend de l'état:

- bleu : en cours
- vert : terminé correctement
- rouge : terminé en échec (la validation n'a pas pu aboutir, contacter l'administrateur système pour plus de détails)

p. Le résultat est conservé tant que la validation n'est pas supprimée.

p. La consultation du résultat de la validation donnera : 

p=. !validation.png!

* le lien 'Validation _n°_' permet de voir la liste des tests de validation effectués sur le jeu de données
* le lien 'Import' permet de voir le bilan d'import si la validation est faite sur fichiers 
* le lien 'Jeu de paramètres' permet de consulter les paramètres de seuils pour les tests de phase 3

h4. Résultats de validation

p=. !validation_result.png!

p. Le résultat de validation fournit 2 synthèses : 

# Synthèse des tests obligatoires
# Synthèse des tests optionnels

p. _1 - La synthèse des tests obligatoires affiche 3 secteurs_

p(border_image). !validation_mandatory_result.png!

* en vert les tests valides 
* en rouge les tests en échec
* en gris les tests non réalisables (contexte du test ne permettant pas de l'effectuer)

p(olnext). exemple : tests sur les accès avec aucun accès dans le jeu de données à valider

p. _2 - La synthèse des tests optionnels affiche 3 secteurs_

p(border_image). !validation_optionnal_result.png!

* en vert les tests valides 
* en jaune les tests en échec
* en gris les tests non réalisables (contexte du test ne permettant pas de l'effectuer)

p. Dans les 2 cas, la sélection d'un des secteurs affiche la liste des tests concernés avec le détail en cas d'erreur

p(border_image). !validation_mandatory_detail.png!

Une bulle d'information s'affiche en sélectionnant une icone bleue !notice.png! :

p(border_image). !validation_bulle.png!

En cas d'erreur, la localisation est fournie dans la colonne 'Détail': 

* pour les tests des phases 1 et 2, par l'emplacement (nom du fichier, ligne et colonne) de l'objet en erreur,
* pour les tests de la phase 3, par un lien vers la page de consultation de l'objet en erreur.

p(border_image). !validation_location.png!