| 
LES AIDES D'APPLICATION DANS LES FICHIERS ECRAN Il est possible sur AS/400 d'associer des aides à des fichier-écran. Ces aides peuvent être - contenus dans un DOCUMENT OFFICE (traitement HLPDOC de texte) - des formats du fichier écran d'un autre fichier écran HLPRCD - des panneaux d'aide contenus dans un *PNLGRP (définis à l'aide du langage UIM) HLPPNLGRP HLPDOC et HLPRCD sont compatibles dans un même fichier écran. HLPPNLGRP est incompatible avec les deux autres. |
|
LES AIDES D'APPLICATION DANS LES FICHIERS ECRAN Il est possible de définir une aide - niveau fichier (valide pour tout le fichier) - niveau format (valide quand ce format est affiché) - niveau partie d'un format en définissant une fenetre logique (le système tenant compte de la position curseur) Ces aides seront automatiquement affichés quand l'utilisateur utilisera la touche "AIDE".(Vous pouvez essayer sur ce fichier écran.) |
|
Voici la définition d'une aide niveau fichier -------------------
précédé du mot clé HELP qui autorise l'utilisation !
de la touche "AIDE". !
REF(REPERTP1) !
A HELP !
A HLPRCD(AIDEGEN) <-------!
A R NOMFMT TEXT('Format de dspf')
|
|
Voici la définition d'une aide niveau format -------------------
composée de deux lignes que nous allons détailler !
!
REF(REPERTP1) !
A HELP !
A HLPRCD(AIDEGEN) !
A R NOMFMT TEXT('Format de dspf') !
A H HLPRCD(FMTAIDE) <-------!
HLPARA(04 025 07 075) ###
H en colonne 17 définition d'une aide (niveau format
avant la 1ere zone)
HLPRCD nom du format a afficher
cette ecriture suppose le format dans le même
fichier écran
si le format se trouve dans un autre DSPF il faut
écrire HLPRCD(nomfmt NOMDSPF)
|
|
Voici la définition d'une aide niveau format -------------------
composée de deux lignes que nous allons détailler !
!
REF(REPERTP1) !
A HELP !
A HLPRCD(AIDEGEN) !
A R NOMFMT TEXT('Format de dspf') !
A H HLPRCD(FMTAIDE) ####### !
HLPARA(04 025 07 075) <--
HLPARA permet de définir une fenetre logique à laquelle
associer le format d'aide.Le format n'étant affiché
que si le curseur se trouve dans cette fenetre quand
l'utilisateur appuie sur "AIDE"
la syntaxe est la suivante:
HLPARA(W X Y Z) W = ligne angle sup gauche
X = colonne " " "
Y = ligne angle inf droit
Z = colonne " " "
|
|
Voici la définition d'une aide niveau format -------------------
composée de deux lignes que nous allons détailler !
!
REF(REPERTP1) !
A HELP !
A HLPRCD(AIDEGEN) !
A R NOMFMT TEXT('Format de dspf') !
A H HLPRCD(FMTAIDE) ####### !
HLPARA(04 025 07 075) <--
HLPARA permet de définir une fenetre logique a laquelle
associer le format d'aide.Le format n'étant affiché
que si le curseur se trouve dans cette fenetre quand
l'utilisateur appuie sur "AIDE"
la syntaxe est la suivante:
OU HLPARA(*RCD) la totalitée du format est considérée
HLPARA(*NONE) aucune fenetre n'est définie
cette aide ne sera affichée qu'en tant
qu'aide complémentaire (avec ROLLUP/ROLLDOWN)
|
|
ENCHAINEMENT DES AIDES AVEC HLPRCD Si le curseur se trouve dans une fenetre définie c'est l'aide associé à cette fenetre qui est affiché. Sinon, celui du format s'il existe HLPARA(*RCD) Sinon celui niveau fichier. Sinon le système informe l'utilisateur qu'il n'existe pas d'aide pour l'endroit ou se trouve le curseur. Un format d'aide est actif quand le format auquel il est associé est à l'écran. Quand un format est affiché, les aides des formats qui restent à l'écran sont encores actifs. Le système mémorise les aides dans l'ordre LIFO (l'aide du dernier format écrit est affiché en premier, etc..) |
|
Pour empecher cette mémorisation il faut employer le mot clé HLPCLR Le système ne connait plus que les aides définis sur le dernier format écrit (celui qui contenait HLPCLR) Quand un format d'aide est affiché le système prévoi d'afficher le format d'aide suivant par ROLLUP le format d'aide précédent par ROLLDOWN Par défaut le format d'aide suivant est la prochaine specif H dans l'ordre d'écriture, le précédent la prédédente specif H. Quand le système affiche le premier format d'aide, le précédent sera la derniere specif H et inversement. Le système "boucle" sur tous les formats d'aide actifs. (vous pouvez essayer en appuyant sur AIDE puis ROLLUP) |
|
Il est possible d'empecher ce bouclage en indiquant le mot clé
HLPBDY (boundary) sur une specif H.
Ce mot clé fait de cet aide le dernier affichable
et de l'aide suivant le premier affichable.
Exemple:
A R NOMFMT TEXT('format de dspf')
A H HLPRCD(FMTA1)
A HLPARA(01 010 04 080)
A H HLPRCD(FMTA2)
A HLPBDY
A HLPARA(05 001 08 080)
A H HLPRCD(FMTB1)
A HLPARA(10 010 10 040)
A H HLPRCD(FMTB2)
A HLPBDY
A HLPARA(11 001 24 080)
SI FMTA1 est affiché le système fera FMTA2-FMTA1-FMTA2-FMTA1 avec ROLLUP
SI FMTB2 est affiché le système fera FMTB1-FMTB2-FMTB1-FMTB2 avec ROLLUP
|
|
Il est possible de déterminer quels sont les format suivants et précédents à afficher en défilement avec le mot clé HLPSEQ sur le format d'AIDE Syntaxe: HLPSEQ(GROUP1 02) ! ! ! !-----n° de séquence dans le groupe ! nom de groupe A l'affichage d'un format contenant ce mot clé le système cherche un format d'aide ayant le même nom de groupe avec un n° supérieur si ROLLUP avec un n° inférieur si ROLLDOWN et l'affiche Tous les formats sans HLPSEQ sont considérés appartenant au même groupe |
|
Exemple:
A R NOMFMT TEXT('format de dspf')
A H HLPRCD(FMTA1)
A HLPARA(01 010 04 080)
A H HLPRCD(FMTA2)
A HLPBDY
A HLPARA(05 001 08 080)
A H HLPRCD(FMTB1)
A HLPARA(10 010 10 040)
A H HLPRCD(FMTB2)
A HLPBDY
A HLPARA(11 001 24 080)
......
A R FMTA1 HLPSEQ(GRP1 01)
A 04 10'Texte affiché'
A R FMTA11 HLPSEQ(GRP1 02)
04 10'Autre texte affiché'
SI FMTA1 est affiché le système fera FMTA11-FMTA2-FMTA1 etc..avec ROLLUP
(en fin de groupe le système recherchant les specifs H suivantes.)
|
|
Il est enfin possible d'autoriser un ou des touches de commande
sur le format d'aide.
Sans incidence aucune pour le programme (retour au format initial)
sans le mot clé HLPCMDKEY.
Avec envoi de l'indicateur associé sur le format initial au programme
si cette touche était déclaré sur le format initial
en employant le mot clé HLPCMDKEY.
Exemple:
A R FMT1 TEXT('format de dspf')
CA03(03)
A H HLPRCD(FMTA1)
A HLPARA(01 010 04 080)
A R FMTA1 HLPCMDKEY
CA03
Si l'utilisateur appuie sur F3 lors de l'affichage de FMTA1 il se passera
la même chose que s'il avait utilisé cette touche sur FMT1
|
|
MOTS-CLES SPECIFIQUE AUX PANNEAUX D'AIDE
Niveau fichier:
HLPTITLE('texte') Titre de l'aide par défaut si non précisé
dans le panneau
HLPFULL Aide affiché plein écran
(si non précisé recherche dans le profil
utilisateur,dft = fenetre)
HLPSCHIDX(nom-index) Index de recherche accessible par F11
Niveau format:
HLPPNLGRP(nom-aide nom-pnlgrp)
HLPEXCLD Permet d'exclure de l'aide complementaire
un panneau déja indiqué.
L'aide complémentaire (via F2) est composée
du panneau niveau fichier et des panneaux
des formats encore à l'écran.
Si un panneau est indiqué deux fois,il apparait
donc deux fois sans HLPEXCLD.
|
