IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Voir le flux RSS

Au Pied Levé - À Main Levée

I-2.4.1. Manuel utilisateur

Noter ce billet
par , 01/04/2020 à 11h35 (215 Affichages)
APL-AML est une monographie fragmentée en plusieurs billets pour des raisons de volume.
Un billet SYNOPSIS et un billet SOMMAIRE agrègent tous les billets du blog via des liens hypertextes.

■ ■ ■ SOMMAIRE DU BILLET ■ ■ ■

  • Formation utilisateurs
  • Communication développeur-utilisateur
  • Newsletters
  • Documentation gestionnaires
Formation utilisateurs

APL-AML ne prévoit ni manuel d’utilisation, ni formation particulière des gestionnaires. Il ne s’agit pas de former des gestionnaires à l’utilisation d’un logiciel mais à leur métier. Les gestionnaires initiés forment donc les gestionnaires novices à ce qui sera leur métier avec comme support pédagogique l’application elle-même. L’application propose néanmoins les outils permettant aux gestionnaires de constituer facilement leur propre manuel.

La seule formation dispensée concerne l’utilisation du poste de travail et de certaines touches ou combinaisons de touche facilitant la saisie (Ctrl/A, Ctrl/D, Ctrl/X, Ctrl/C, Ctrl/V), suivie d’une présentation sommaire de l’applicatif. En moins d’une heure, un nouvel utilisateur est autonome.

Il est attendu des gestionnaires novices qu’ils/elles apportent leur contribution à l’évolution de l’application grâce à leur découverte de l’outil qui peut révéler certaines difficultés d’utilisation ou certaines incompréhensions gommées par la connaissance du métier des gestionnaires expérimenté(e)s. L’applicatif n’est pas figé, les gestionnaires sont encouragé(e)s à le faire évoluer sans autocensure. Les apports éventuels sont immédiatement pris en compte et opérationnels.

Curieusement, cette absence de manuel crée une dynamique de communication entre les gestionnaires. Chaque nouvelle fonctionnalité développée est immédiatement repéré par un/une gestionnaire qui transmet l'information aux autres.

■ Communication développeur-utilisateur/gestionnaires

Mettre à disposition des gestionnaires, via un sous-menu de leur application, le maximum d’informations, notamment le Brainwriting et le Mémorandum.

■ Newsletters

Les newsletters ont pour objectifs d’informer les gestionnaires des dernières évolutions de l’application ou de rappeler, préciser, compléter une de ses fonctionnalités.

Elles évitent de perdre du temps à consulter les rubriques qui ne se sont pas enrichies récemment. On y trouve donc, entre-autre, les dates de mise à jour de toutes les rubriques et une indication sur le contenu de la mise à jour.

■ Documentation gestionnaires

La meilleure des documentations est une « documentation en ligne ». Une application qui n’évolue pas est une application « morte » qui n’a donc pas besoin d’être documentée. Une application « vivante », qui évolue donc, nécessite de faire évoluer parallèlement sa documentation, d'où un problème de synchronisation développements/documentation. Un logiciel dont l’ergonomie est bien conçue, intuitive, ne devrait pas nécessiter une documentation exhaustive, indigeste qu’en fin de compte, personne ne lit. Il y a une réalité dont il faut tenir compte, c'est que bien peu de gens prennent aujourd'hui le temps de lire, ne serait-ce que les notices d'installation des appareils ménagers.

Bien qu’une documentation en ligne sobre, digeste, pertinente, soit prévue, elle n’est pratiquement jamais consultée. La question se pose donc de l’utilité de consacrer du temps à la réalisation d’une documentation « exhaustive », genre « Manuel d’utilisation ». Sans parler du coût papier, de la diffusion, etc.

Lorsque les gestionnaires rencontrent des difficultés d’utilisation de leur logiciel, cela révèle un manque de pertinence dans les choix de conception. Ce n’est pas par une documentation que l’on apporte une réponse à leur incompréhension mais en revisitant les développements pour leur proposer une IHM conforme à leur réalité.

Curieusement, cette absence de documentation crée une dynamique de communication entre les gestionnaires. Chaque nouveau développement, immédiatement repéré par un/une gestionnaire est signalé aux autres. Développer dans ces conditions est un véritable bonheur pour tous, pour le développeur, les gestionnaires et les chefs de service.

Concrètement, les utilisateurs créent eux-mêmes leur propre documentation. Le logiciel leur permet de la constituer de façon plus satisfaisante qu’un simple « Imp. Écran ».

Leur documentation révèle leur perception du logiciel et la piller permet d’améliorer les développements.

L’application offre aux gestionnaires la possibilité d’imprimer le résultat d’une ou plusieurs requêtes écrans. Chaque gestionnaire alimente de cette façon sa propre documentation dans un classeur anneaux en « D » qu’il garde à portée de main. Un perforateur quatre trous Ø 0,8 mm facilite la manipulation des pages.

Cette documentation est une source d’inspiration pour le développeur qui y trouve la réponse à certaines questions pertinentes que se posent les gestionnaires.

Ce n’est pas par une documentation que l’on apporte une réponse à une incompréhension des gestionnaires mais en revisitant les développements pour proposer une dynamique conforme à leur réalité.

Programme qui crée la séquence d'échappement permettant d'imprimer le résultat d'une requête écran :

Code : Sélectionner tout - Visualiser dans une fenêtre à part
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
{=================================== requete ==================================}
{                                                                              }
{   ACE    :  requete.ace                                                      }
{                                                                              }
{   SHELL  :  ../shell/requete                                                 }
{                                                                              }
{   AUTEUR :  IFA2377                                                          }
{                                                                              }
{   Objet  :  Créer la séquence d'échappement pour imprimer le résultat d'une  }
{             requête écran.                                                   }
{                                                                              }
{   Date   :  12 Juin 2002                                                     }
{                                                                              }
{==============================================================================}

                           {========================}
{==========================} DATABASE concours  END {==========================}
                           {========================}

{================================}  DEFINE  {==================================}
{}                                                                            {}
{}    PARAM[1] p_logname      CHAR(8)                                         {}
{}                                                                            {}
{}    VARIABLE ESC            CHAR(1)                                         {}
{}                                                                            {}
{==================================}  END  {===================================}

{==================================  INPUT  ===================================}
{}                                                                            {}
{     PROMPT FOR v_dp USING " STAGE : "                                        }
{}                                                                            {}
{===================================  END  ====================================}

{================================}  OUTPUT  {==================================}
{}                                                                            {}
{     REPORT TO PRINTER                                                        }
{}    REPORT TO PIPE "cat > ${LOGNAME}.prt"                                   {}
{}    TOP    MARGIN 0                                                         {}
{}    BOTTOM MARGIN 0                                                         {}
{}    LEFT   MARGIN 0                                                         {}
{}    PAGE   LENGTH 67                                                        {}
{}    TOP OF PAGE   "^L"                                                      {}
{}                                                                            {}
{==================================}  END  {===================================}

{=================================}  SELECT  {=================================}

           ln.papier_blanc     ln_papier_blanc,
           ln.destination      ln_destination

FROM       ln

WHERE      ln.logname        = $p_logname

{==================================}  END  {===================================}

{=================================}  FORMAT  {=================================}

{-------------------------  BEFORE GROUP OF ???????   -------------------------}

{---------------------------}  FIRST PAGE  HEADER  {---------------------------}

LET ESC = ASCII 027

PRINT ESC, "&k0g4S", ESC, "&l26a6.5c2e67f0o1X",
      ESC, ln_papier_blanc, ESC, ln_destination,
      ESC, "&a7L", ESC, "(s3B", ESC, "(10U"

{------------------------------}  PAGE  HEADER  {------------------------------}

SKIP 1 LINE

{------------------------------}  ON EVERY ROW  {------------------------------}

PRINT FILE "../shell/requete.prt"

{--------------------------  TRAITEMENT FIN DE PAGE  --------------------------}

{------------------------  TRAITEMENT EN-TETE DE PAGE  ------------------------}

{------------------------  TRAITEMENT  LIGNE COURANTE  ------------------------}

{-------------------------------  ON LAST ROW  --------------------------------}

{-------------------------  AFTER GROUP OF ???????    -------------------------}

{===============================  PAGE  TRAILER  ==============================}


{===================================}  END  {==================================}

{==================================== SHELL ===================================}
{
# requete

#           Paramètres
# P_1     = Nom du fichier output

clear

if [ "$BDD" = "E" ]
then

echo "┌RÉSULTAT D'UNE REQUÊTE ÉCRAN───────────────────────────────────────────┐"
echo "│                                                                       │"
echo "├>Query         => Cherche les items répondant aux critères de sélection│"
echo "├>Output        => Entrez le nom du fichier de sortie                   │"
echo "│                  (perform.out par défaut):                            │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Append        => Le résultat de la requête est ajouté en rallongement │"
echo "│                  du fichier cité ci-dessus.                           │"
echo "│ Create        => Le résultat de la requête est ajouté en création     │"
echo "│                  du fichier cité ci-dessus.                           │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Current-liste => Tous les items trouvés sont considérés.              │"
echo "│ One-page      => Seul l'écran affiché est considéré                   │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Unload-format => Les informations sont séparées par des pipes         │"
echo "│                  (1 ligne par item)                                   │"
echo "│ Screen-format => Les informations sont telles qu'elles sont affichées │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "│NOM DU FICHIER =>                 [ <──┘ ]=perform.out                 │"
echo "└───────────────────────────────────────────────────────────────────────┘"
echo " "

else

echo "┌RÉSULTAT D'UNE REQUÊTE ÉCRAN───────────────────────────────────────────┐"
echo "│                                                                       │"
echo "├>Interroger    => Cherche les items répondant aux critères de sélection│"
echo "├>Rediriger     => Entrez le nom du fichier de sortie                   │"
echo "│                  (perform.out par défaut):                            │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Ajouter       => Le résultat de la requête est ajouté en rallongement │"
echo "│                  du fichier cité ci-dessus.                           │"
echo "│ Créer         => Le résultat de la requête est ajouté en création     │"
echo "│                  du fichier cité ci-dessus.                           │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Liste-courante=> Tous les items trouvés sont considérés.              │"
echo "│ Page-unique   => Seul l'écran affiché est considéré                   │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "├>Caractère     => Les informations sont séparées par des pipes         │"
echo "│                  (1 ligne par item)                                   │"
echo "│ Ecran         => Les informations sont telles qu'elles sont affichées │"
echo "├───────────────────────────────────────────────────────────────────────┤"
echo "│NOM DU FICHIER =>                 [ <──┘ ]=perform.out                 │"
echo "└───────────────────────────────────────────────────────────────────────┘"
echo " "

fi

cd ../shell

if test -f ${LOGNAME}.prt
   then rm ${LOGNAME}.prt
fi

SMSO=`tput smso`
RMSO=`tput rmso`

# NOM DU FICHIER
  tput cup 18 19
  echo $SMSO"               "$RMSO
  tput cup 18 19
  read P_1
  tput cup 18 19
  echo "               "
  if [ "$P_1" = "" ]
  then P_1=perform.out
  else tput cup 18 19
       echo $P_1
  fi

tput cup 20 0
echo " Traitement en cours... \c"

if [ "$LOGNAME" = "informix" ]
then cat ../isql/${P_1}      > requete.prt
else if [ "$BDD" = "A" ]
     then cat ../frm_A/${P_1} > requete.prt
     else cat ../frm_E/${P_1} > requete.prt
     fi
fi

sacego -q ../ace/requete $LOGNAME

cat ${LOGNAME}.prt | sed -f ../bull/isoTOpcl.sed > ../ftp/${LOGNAME}.pcl
../bull/pcl2pdf ../ftp/${LOGNAME}.pcl ../ftp/${LOGNAME}.pdf 2> /dev/null
# rm ../ftp/${LOGNAME}.pcl

cat ${LOGNAME}.prt | sed -f ../bull/ISOtoPC-8.sed > ${LOGNAME}.tmp
mv  ${LOGNAME}.tmp ${LOGNAME}.prt
lp  ${LOGNAME}.prt > /dev/null

echo "TERMINE ! "
}
{==============================================================================}

I-2.4. Documentation utilisateur

▲ I-2.4.1. Manuel utilisateur
► I-2.4.1. Manuel utilisateur
▼ I-3.1.1. Ex&Co Étude préalable

Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Viadeo Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Twitter Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Google Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Facebook Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Digg Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Delicious Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog MySpace Envoyer le billet « I-2.4.1. Manuel utilisateur » dans le blog Yahoo

Mis à jour 25/02/2024 à 14h01 par APL-AML

Catégories
■ APL-AML , I- L’ART , I-2. Règles de réalisation