Configuration de l'application

La première partie de ce document liste les parties du logiciel ProWhy qui peuvent être paramétrées à l'aide des fichiers de configuration Rails.
Certains paramétrages sont effectués à l'aide des fichiers de données (fixtures rails), d'autres nécessitent une modification de la structure des tables et sont réalisées à l'aide des fichiers de construction de la bdd (migrations rails).
Les procédures de réalisation de ces adaptations sont détaillées dans la partie 2 : Procédures de paramétrage.

Aperçu

Image de la société

Il est possible de mettre une image de la société en fond d'écran de la page de login.

La criticité

Les intitulés, textes et valeurs des critères sont paramétrables.
La formule de calcul de la valeur de criticité est également paramétrable.

Les périmètres

Par défaut, les périmètres sont :
  • interne
  • clients
  • fournisseurs
    Il est possible d'ajouter/supprimer des périmètres dans cette arborescence (par exemple ajouter des clients particuliers sous la branche « clients », ajouter différents services de l'entreprise, etc).

Page détails d'une résolution de problème

Les groupes (« Description » et « Programme ») : possibilité de changer les noms.
Si besoin, il est possible d'ajouter des groupes.
Tous les champs peuvent être modifiés, excepté « titre » et « description ».
Les types disponibles pour les champs sont :
• date
• texte libre
• valeur numérique
• texte à choisir dans une liste déroulante (les différents textes sont stockés dans un fichier de configuration)
  • Pour chaque type de résolution de problème (9Steps/8D/PDCA/ANOMALIE) il est possible de spécifier :
    • la visibilité des champs (par exemple, certains détails sont visibles dans les 8D et PDCA mais pas dans les anomalies)
    • les champs obligatoires (c'est-à-dire les champs qui doivent être renseignés pour permettre la sauvegarde).
    Une partie spécifique permet de choisir un composant lié au problème déclaré dans un arbre (3 niveaux). C'est la partie actuellement référencée dans Client / Programme.
    Les intitulés (« client », « programme »), ainsi que le contenu de l'arbre sont modifiables et doivent être adaptés à la structure de l'entreprise.

Page équipe

Excepté pour l'auteur, les différentes fonctions d'une équipe peuvent être modifiées. Il est également possible d'en ajouter et/ou supprimer.
Il est également possible de paramétrer les droits d'accès en lecture et en écriture aux différentes parties de la résolution de problème pour chaque fonction (par exemple le pilote a tous les droits, un responsable action n'a les droits de modifications que sur les pages actions).

Procédures de paramétrage

Image de la société

Afin de mettre une image de la société en fond d'écran de la page de login :
Dans le répertoire de l'application, remplacer l'image :
public/images/custom_trex/societe_custom.jpg
par l'image de la société.
L'image actuelle est au format 1280x463 afin de remplir tout le bas de la page.

Modification d'un fichier de configuration des données (fichiers fixtures rails)

Attention ! Si vous avez commencé à utiliser ProWhy, il est impératif de réaliser une sauvegarde de la base de données.

Les fichiers fixtures permettent d'initialiser les enregistrements d'une table de la base de données
Ils sont accessibles dans le répertoire : test/fixtures
et sont nommés : nom_de_la_table.yml
Ces fichiers ont le format suivant :

obj1:
  id: 1
  champ1: valeur
  champ2: valeur
  [...]
  champN: valeur
obj2 :             # identifiant unique dans le fichier de fixtures
  id : 2           # id de l'enregistrement (unique dans la table)
  champ1: valeur   # champs de la table et valeurs associées
  champ2: valeur
  [...]
  champN: valeur

Il n'est pas nécessaire de renseigner tous les champs. Les champs non renseignés prendront la valeur par défaut.
Le champ « id » doit être renseigné uniquement pour des tables référencées dans d'autres fichiers fixtures afin d'identifier la cible d'un lien (lien entre 2 tables). Dans les autres cas la ligne « id: ... » ne doit pas être présente.
Une fois le fichier de fixtures modifié, ce fichier doit être chargé dans la base de données.
Dans le répertoire de l'application, lancer la commande :
$ rake db:fixtures:load FIXTURES=nom_de_la_table

Exemple :
L'exemple suivant détaille la configuration des listes déroulantes.
Les textes des listes déroulantes sont enregistrés dans la table « combos » en base de données.
Les valeurs sont donc configurées dans le fichier :
test/fixtures/combos.yml
Nous prendrons ici l'exemple de la liste de sélection correspondant aux secteurs (dans l'application : page détails, bloc Description, champ secteur).
Le champ dont l'intitulé est « Secteur » dans le bloc « Description » a pour nom de champ « pb_secteur »
Une recherche dans le fichier « combos.yml » nous montre la version actuelle :
d_sect1:
  nom_champ: "pb_secteur"    # nom du champ dans la bdd
  valeur: 1                  # valeur associée au texte (et position dans la liste déroulante)
  fr: "­­ non renseigné ­­"      # texte en Français
  gb: "­­ not specified ­­"      # texte en Anglais
d_sect2: 
  nom_champ: "pb_secteur" 
  valeur: 2
  fr: "Secteur 1" 
  gb: "Secteur 1" 
d_sect3: 
  nom_champ: "pb_secteur" 
  valeur: 3 
  fr: "Secteur 2" 
  gb: "Secteur 2" 
d_sect4: 
  nom_champ: "pb_secteur" 
  valeur: 4 
  fr: "Secteur 3" 
  gb: "Secteur 3" 
d_sect5: 
  nom_champ: "pb_secteur" 
  valeur: 5 
  fr: "Secteur 4" 
  gb: "Secteur 4" 

La liste déroulante affichera ainsi 5 choix : « – non renseigné -- », « Secteur 1 », « Secteur 2 », « Secteur 3 », « Secteur 4 »
Nous souhaitons modifier cette liste, afin de proposer les choix suivants : « – non renseigné -- », « Transport ferroviaire », « Aéronautique », « Transport maritime »
Le enregistrement des secteurs 2, 3, et 4 sont modifiés (valeurs des textes en fr et gb) et le secteur 5 est supprimé. La section concernant les secteurs sera alors :

d_sect1: 
  nom_champ: "pb_secteur" 
  valeur: 1 
  fr: "­­ non renseigné ­­" 
  gb: "­­ not specified ­­" 
d_sect2: 
  nom_champ: "pb_secteur" 
  valeur: 2 
  fr: "Transport ferroviaire" 
  gb: "Secteur 1" 
d_sect3: 
  nom_champ: "pb_secteur" 
  valeur: 3 
  fr: "Aéronautique" 
  gb: "Secteur 2" 
d_sect4: 
  nom_champ: "pb_secteur" 
  valeur: 4 
  fr: "Transport maritime" 
  gb: "Secteur 3" 

Afin d'appliquer les modifications à la table en base de données, lancer la commande :

Attention ! Si vous avez commencé à utiliser ProWhy, il est impératif de réaliser une sauvegarde de la base de données AVANT de lancer la commande suivante.

$ rake db:fixtures:load FIXTURES=combos RAILS_ENV=production

ATTENTION :

Les éventuelles modifications effectuées directement dans la table combos de la base de données seront définitivement perdues. Cette commande réinitialise la table avec les enregistrements du fichier de fixtures.

ATTENTION : NE PAS OUBLIER « FIXTURES=... »

Si la commande est lancée sans nom de fixture en suivant, alors toutes les fixtures sont chargées, et
toutes les données préalablement enregistrées dans la base de données seront effacées.

La criticité

Les critères, valeurs et configurations sont paramétrables directement depuis l'interface d'administration. Cette solution peut-être utilisée dans le cas d'une base de données en cours d'utilisation.
L'utilisation des fichiers de configuration est préférable dans le cas d'une nouvelle base de données, afin que les modifications soient conservées à chaque nouvelle création de base de données.
Les critères sont configurés dans le fichier : criticite_criteres.yml
Les valeurs associées à chaque critère : criticite_eval_criteres.yml (le champ criticite_critere_id renvoie à l'identifiant du critère correspondant).
Les formules de calcul: criticite_configurations.yml

Les périmètres

De même que pour la criticité, ces modifications sont réalisables à l'aide des fichiers de configuration (fixtures), ainsi que dans l'interface d'administration.
Les périmètres sont définis dans le fichier perimetres.yml
Le champ « parent_id » représente l'identifiant (id) du parent dans la hiérarchie des périmètres.

Page détails d'une résolution de problème

en construction

Page équipe

en construction

Also available in: PDF HTML TXT