U I M User Interface Manager Gestionnaire d'Interface Utilisateur. Langage de définition de panneaux d'aide basé sur la notion d'étiquette (TAG). Toute étiquette devant commencer par " : " (deux points) et se terminer par " . " (un point) Tout ce qui n'est pas étiquette est considéré comme du texte à afficher. La commande CRTPNLGRP permet de créer un panneau d'aide à partir d'un source UIM.(fichier source par dft = QPNLSRC) Les panneaux d'aide peuvent être associés à des DSPF des Commandes utilisateur des indexs de recherche (*SCHIDX) |
U I M User Interface Manager Gestionnaire d'Interface Utilisateur. ................................................................... : ATTENTION : : : : Sur les pages suivantes vous verrez les aides via fenetres : : telles qu'elles sont affichées sur un écran. : : : : : : : : L'affichage des aides est fait par l'intermediaire : : de l'API (pgm d'interface système) QUHDSPH. : : : : : : : : : : : :.................................................................: |
U I M Structure générale d'un source UIM * commentaire -->:PNLGRP. <-----------------------------début et fin de panel------------- ! ... ! ! -:IMPORT PNLGRP='panel' NAME='AIDE01' (pour :IMHELP) <--niveau-- ! ! ! ... général ! ! ! !:ISCHSYN ROOT='racine1'.equivalent1 equivalent2 equivalent3 ... ! ! ! !:ISCHSYN ... ! ! ! - ... <---------- ! ! -:HELP NAME='nom-aide'.texte-aide. <-début et fin d'aide-- ! ! !:XH3.texte-aide-étendue. (aide étendue via F2) ! ! ! !:ISCH ROOTS='racine1'. (mot-clé pour cette aide) ! ! ! ! ... ! ! ! ! ... ! ! ! !:IMHELP NAME='AIDE01'. (importation) ! ! ! ! ... ! ! ! -:EHELP. <------------------------------------------------ ! ! ... ! ! ... ! !-->EPNLGRP. <-------------------------------------------------------------- |
............................................................................. : Symboles. : : Définition des symboles UIM. : : : : UIM connait un certain nombre de symboles à remplacer à l'exécution : : : : Symbole remplacé par. : : : : &. ET commercial (&) : : : : &colon. deux point (:) : : : : &cont. continuation d'un texte ligne suivante : : : : &period. point (.) : : : : &slr. Slash (/) : : ############ : : F3=Fin d'aide F10=Début au curseur F11=Aide par index F12=Annuler : : F13=Assistance F14=Imprimer aide : :...........................................................................: |
............................................................................. : Symboles. : : # : : &msg.(id,msgf,bib) texte du message : : : : msgf et bib sont optionnels dans le symbole &msg.s'ils ne sont pas : : indiqués UIM cherchera le paramètre SUBMSGF du tag :PNLGRP. : : : : Remarque : ces symboles peuvent être en minuscule ou MAJUSCULE. : : : : : : : : : : : : : : : : : : ############ : : F3=Fin d'aide F10=Début au curseur F11=Aide par index F12=Annuler : : F13=Assistance F14=Imprimer aide : :...........................................................................: |
Regardons ensemble les principales etiquettes reconnues par UIM. :PNLGRP. première etiquette du source :EPNLGRP. derniere etiquette du source entre ces deux délimitateurs, des aides commencant par :HELP NAME = 'nom-aide'.texte-de-l'aide (WIDTH= ) (DEPTH= ) ... :EHELP. (sans paramètre) le nom de l'aide peut faire 32 caracteres,peut contenir un "/" doit être construit de la maniere suivante dans le cas d'une commande 'CCCCCC/PPPPP' ou CCCCCC est le nom de la cde PPPPPP le paramètre. WIDTH permet d'imposer une largeur de fenetre,DEPTH une hauteur :XH3. indique le texte à afficher avec l'aide étendue. |
:P. indique le début d'un paragraphe.chaque paragraphe est encadré (en haut et en bas) d'une ligne blanche.A l'interieur d'un paragraphe UIM gere la présentation sans tenir compte du formattage dans le source. :PC. indique la continuation d'un paragraphe. ########################################################## :PNLGRP. :HELP NAME = 'UIM/F2' .Aide étendue. :XH3. Voici le texte de l'aide étendue. :P. Les aides que vous voyez actuellement sont enregistrées dans un panneau d'aide qui s'appelle UIM. :P. ce texte est affiché quand vous appuyez sur F2 (AIDE ETENDUE). :EHELP. :HELP NAME = 'UIM/H1' WIDTH=32 DEPTH=9 .Paragraphes. :XH3. Exemple de paragraphe. :P. Voici un premier paragraphe. :P. En voici un deuxieme. :EHELP. |
:P. indique le début d'un paragraphe.chaque paragraphe est encadré .................................... blanche.A l'interieur d'un paragraphe : Paragraphes. : nir compte du formattage dans le : # : : Voici un premier paragraphe. : graphe. : : ###################################### : En voici un deuxieme. : : Fin : : F2=Aide étendue F12=Annuler : e. : F24=Autres touches : : : sont enregistrées dans un panneaux :..................................: :P. ce texte est affiché quand vous appuyez sur F2 (AIDE ETENDUE). :EHELP. ... :HELP NAME = 'UIM/H1' WIDTH=32 DEPTH=9 .Paragraphes. : :XH3. Exemple de paragraphe. z : :P. #################################### : Voici un premier paragraphe. #################################### : :P. En voici un deuxieme. #################################### : :EHELP. ..: |
............................................................................. : Aide entendue. : : # : : Voici le texte de l'aide étendue. : : : : Les aides que vous voyez actuellement sont enregistrées dans un : : panneau d'aide qui s'appelle UIM. : : : : ce texte est affiché quand vous appuyez sur F2 (AIDE ETENDUE). : : : : Exemple de paragraphe. : : : : Voici un premier paragraphe. : : : : En voici un deuxieme. : : Fin : : F3=Fin d'aide F10=Début au curseur F11=Aide par index F12=Annuler : : F13=Assistance F14=Imprimer aide : : : :...........................................................................: :EHELP. |
UIM permet de gérer des listes. :PARML. = Liste de paramètres (utile pour les commandes) :PT. = définition de terme. :PK. (def). défintion d'un mot réservé(def = valeur par défaut) :PV. définition d'une valeur possible. terminé par :EPK. ou :EPV. :PD. = texte explicatif du terme. Les termes sont en haute intensité les mots réservés en majuscule. les valeurs en minuscules la valeur par défaut est soulignée :EPARML. Indique la fin d'une liste de paramètres. |
:HELP NAME = 'UIM/H2'.Liste de paramètres. :XH3.Exemple de liste de paramètres. :P. Voici une liste de paramètres. :PARML. :PT.:PK def. *LIBL :EPK. :PD. La liste de bibliothèque (mot réservé par défaut) :PT.:PK. *CURLIB :EPK. :PD. La bibliothèque en cours (mot réservé possible) :PT.:PV. nom-bibli :EPV. :PD. Un nom de bibliothèque (valeur possible) :EPARML. :PC.continuation du paragraphe. :EHELP. |
:HELP NAME = 'UIM/H2'.Liste de paramètres. .......................................................................... : Liste de paramètres. : : # : : Voici une liste de paramètres. : : : : *LIBL : : La liste de bibliothèque (mot réservé par défaut) : : : : *CURLIB : : La bibliothèque en cours (mot réservé possible) : : : : nom-bibli : : Un nom de bibliothèque (valeur possible) : : continuation du paragraphe. : : Fin : : F2=Aide étendue F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F24=Autres touches : : : :........................................................................: |
UIM gestion de listes (suite). :OL. = Liste ordonnée(les éléments de la liste sont numérotés par UIM) :LI. = un élément de la liste. :EOL. = Fin de la liste numérotée. :HELP NAME = 'UIM/H3'.Liste ordonnée. :XH3.Exemple de liste ordonnée. :P. Voici une liste ordonnée. :OL. :LI. Premiere ligne :LI. Deuxieme ligne :LI. et enfin la troisieme :EOL. :P.c'est le système qui numérote. :EHELP. |
UIM gestion de listes (suite). ............................................................................. : Liste ordonnée. : : : : Voici une liste ordonnée. : : : : 1. Premiere ligne : : : : 2. Deuxieme ligne : : : : 3. et enfin la troisieme : : : : c'est le système qui numérote. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: :P.c'est le système qui numérote. :EHELP. |
UIM gestion de listes (suite). Les listes ordonnées peuvent être imbriquées le marquage se fera alors avec une notion de lettre a,b,c,... :HELP NAME = 'UIM/H4'.Listes ordonnées imbriquées. :XH3.Exemple listes ordonnées imbriquées. :P. Voici deux listes ordonnées imbriquées. :OL. :LI. Premiere ligne :LI. Deuxieme ligne :OL. :LI. première sous partie :LI. deuxieme sous partie :EOL. :LI. et enfin la troisieme :EOL. :P.c'est toujours le système qui numérote. :EHELP. |
UIM gestion de listes (suite). ............................................................................. : Listes ordonnées imbriquées. : : : : Voici deux listes ordonnées imbriquées. : : : : 1. Premiere ligne : : : : 2. Deuxieme ligne : : : : a. première sous partie : : : : b. deuxieme sous partie : : : : 3. et enfin la troisieme : : : : c'est toujours le système qui numérote. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
UIM gestion de listes (suite). :UL. = Liste non ordonnée. (les éléments sont marqués ("o") par le système mais non numérotés) :EUL. = Fin de liste non ordonnée. :HELP NAME = 'UIM/H5'.Listes non ordonnées imbriquées. :XH3.Exemple listes non ordonnées. :P. Voici deux listes non ordonnées imbriquées. :UL. :LI.première ligne :LI.deuxieme ligne :UL. :LI.première sous partie :LI.deuxieme sous partie :EUL. :LI.et enfin la troisieme :EUL. :EHELP. |
UIM gestion de listes (suite). ............................................................................. : Listes non ordonnées imbriquées. : : : : Voici deux listes non ordonnées imbriquées. : : : : o première ligne : : : : o deuxieme ligne : : : : - première sous partie : : : : - deuxieme sous partie : : : : o et enfin la troisieme : : : : : : : : A suivre... : : F2=Aide étendue F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F20=Agrandir F24=Autres touches : :...........................................................................: |
UIM gestion de listes (suite). ............................................................................. : Listes non ordonnées imbriquées. : : # : : le système rajoute : : : : "o" pour le premier niveau : : : : "-" pour le second niveau : : : : "--" pour le troisieme niveau : : : : : : : : : : : : : : : : Fin : : F2=Aide étendue F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F20=Agrandir F24=Autres touches : :...........................................................................: |
UIM gestion de listes (suite). :SL. = Liste simple. (éléments non marqués, non numérotés) :ESL. = Fin de liste simple. :HELP NAME = 'UIM/H6'.Liste simple. :XH3.Exemple de liste simple. :P. Voici une liste simple (sans marquage) :SL. :LI.1er élément :LI.2eme élément :LI.3eme élément :ESL. :EHELP. |
UIM gestion de listes (suite). ............................................................................. : Listes simple. : : # : : Voici une liste simple (sans marquage) : : : : 1er élément : : : : 2eme élément : : : : 3eme élément : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
UIM gestion de listes (suite). :LP. = Partie d'une liste (suite d'un élément) Sans TAG de fin. :HELP NAME = 'UIM/H7'.Partie d'une liste :XH3.Exemple partie d'une liste. :P. Voici une liste ordonnée avec une sous partie. :OL. :LI.première ligne :LI.deuxieme ligne :LP. suite de la deuxieme ligne. :LI.et enfin la troisieme :EOL. :EHELP. |
UIM gestion de listes (suite). ............................................................................. : Partie d'une liste : : # : : Voici une liste ordonnée avec une sous partie. : : : : 1. première ligne : : : : 2. deuxieme ligne : : : : suite de la deuxieme ligne. : : : : 3. et enfin la troisieme : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
UIM définition de termes (gestion automatique d'entetes) :DL. = Liste de définitions :DTHD. = Entete du terme :DDHD. = Entete de la définition :DT. un terme :DD. sa définition :DT. autre terme :DD. sa définition etc... :EDL. = fin de liste |
UIM définition de termes (gestion automatique d'entetes) :HELP NAME = 'UIM/H8'.Entetes. :XH3.Exemple de gestion automatique d'entetes. :P. Voici un exemple avec des entetes. :DL. :DTHD. Agence. :DDHD. Région couverte. :DT. NANTES :DD. Région ouest :DT. LYON :DD. Sud-est :DT. PARIS :DD. La capitale :EDL. :EHELP. |
UIM définition de termes (gestion automatique d'entetes) ............................................................................. : Entetes. : : # : : Voici un exemple avec des entetes. : : : : Agence. Région couverte. : : : : NANTES Région ouest : : : : LYON Sud-est : : : : PARIS La capitale : : : : ##################################################################### : : Fin. : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
UIM gestion des entetes :Hn. = définition d'une entete. :XHn. = définition d'une entete (affichée uniquement sur l'aide étendue (via F2). ) OU n peut prendre les valeurs suivantes: 1 Texte centré (Haute intensité + soulignement) 2 Cadré à gauche (Haute intensité + soulignement) 3 Cadré à gauche (Haute intensité) 4 Cadré à gauche (soulignement) :HELP NAME = 'UIM/HD'.Texte premier niveau :XH3. Ce texte n'est affiché que sur l'aide étendue. :P. Appuyez sur F2 pour voir le texte associé à l'aide étendue. :EHELP. |
UIM gestion des entetes ............................................................................. : Texte premier niveau : : # : : Appuyez sur F2 pour voir le texte associé à l'aide étendue. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: 2 Cadré à gauche (Haute intensité + soulignement) 3 Cadré à gauche (Haute intensité) 4 Cadré à gauche (soulignement) :HELP NAME = 'UIM/HD'.Texte premier niveau :XH3. Ce texte n'est affiché que sur l'aide étendue. :P. Appuyez sur F2 pour voir le texte associé à l'aide étendue. :EHELP. |
UIM gestion des entetes ............................................................................. : Aide entendue. : : # : : Voici le texte de l'aide étendue. : : : : Les aides que vous voyez actuellement sont enregistrées dans un : : panneau d'aide qui s'appelle UIM. : : : : ce texte est affiché quand vous appuyez sur F2 (AIDE ETENDUE). : : : : Ce texte n'est affiché que sur l'aide étendue. : : : : Appuyez sur F2 pour voir le texte associé à l'aide étendue. : : Fin : : F3=Fin d'aide F10=Début au curseur F11=Aide par index F12=Annuler : : F13=Assistance F14=Imprimer aide : : : :...........................................................................: :P. Appuyez sur F2 pour voir le texte associé à l'aide étendue. :EHELP. |
UIM gestion des attributs. :HPn. = définition d'un attribut d'affichage et d'impression. :EHPn. = fin d'attribut. OU n peut prendre les valeurs suivantes: n ! Affichage ! Impression -----!--------------------------------!------------------------------- 0 ! normal ! normal 1 ! Souligné ! Souligné 2 ! Haute intensité ! Caracteres gras 3 ! Haute intensité +soulignement ! Caracteres gras +soulignement 4 ! idem :HP0 (normal) ! idem :HP0 (normal) 5 ! :HP0 + inversion video ! :HP0 + soulignement 6 ! :HP1 + inversion video ! :HP1 7 ! :HP2 + inversion video (= ND) ! :HP2 + soulignement 8 ! idem :HP7 ! idem :HP7 9 ! :HP0 + inversion video ! :HP0 + soulignement |
UIM gestion automatique d'attributs. :CIT. = définition d'une citation (automatiquement soulignée) :ECIT. = Fin de la citation. :HELP NAME = 'UIM/H9'.Citation. :XH3.Exemple de citation. :P. Voici un exemple de citation. :P. Pour de plus amples explications voir :CIT. Programming display and help :ECIT. dans la salle machine. :EHELP. |
UIM gestion automatique d'attributs. ............................................................................. : Citation. : : # : : Voici un exemple de citation. : : : : Pour de plus amples explications voir Programming display and help dans : : la salle machine. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: Pour de plus amples explications voir :CIT. Programming display and help :ECIT. dans la salle machine. :EHELP. |
UIM gestion automatique d'attributs. :FIG. = définition d'une figure (automatiquement encadrée par deux lignes soulignées) :FIGCAP.= Texte associé à la figure :EFIG. = Fin de la figure. :HELP NAME = 'UIM/HA'.Figure . :XH3.Exemple de figure. :P. Voici un exemple de figure. :FIG. j'écris ce que je veux ou je veux. :FIGCAP. Voilà une figure. :EFIG. :EHELP. |
UIM gestion automatique d'attributs. ............................................................................. : Figure . : : # : : Voici un exemple de figure. : : : : : : j'écris ce que je veux : : ou je veux. : : : : Figure : Voilà une figure. : : : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: :EHELP. |
UIM Exemples :XMP. = définition d'un exemple(lignes non formattées, décalées de quatres positions vers la droite) :EXMP. = Fin de l'exemple. :HELP NAME = 'UIM/HB'.Exemple . :XH3.Exemple d'exemple UIM. :P. Voici un exemple d'exemple. :XMP. j'écris ce que je veux ou je veux. (les lignes sont décalées de 4 positions vers la droite) :EXMP. :EHELP. |
UIM Exemples ............................................................................. : Exemple . : : # : : Voici un exemple d'exemple. : : : : j'écris ce que je veux : : ou je veux. : : (les lignes sont décalées de 4 positions vers la droite) : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: ou je veux. (les lignes sont décalées de 4 positions vers la droite) :EXMP. :EHELP. |
UIM Lignes non formattées. :LINES = Début de lignes non formattées(affichées telles que saisies) :ELINES. = Fin de l'exemple. :HELP NAME = 'UIM/HL'.Lignes . :XH3.Exemple de lignes non formattées. :P. Voici un exemple de lignes non formattées par UIM. :LINES. j'écris ce que je veux ou je veux. (les lignes restent telles que saisies dans le source) :ELINES. :EHELP. |
UIM Lignes non formattées. ............................................................................. : Lignes . : : # : : Voici un exemple de lignes non formattées par UIM. : : : : j'écris ce que je veux : : ou je veux. : : (les lignes restent telles que saisies dans le source) : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: ou je veux. (les lignes restent tel que saisies dans le source) :ELINES. :EHELP. |
UIM Notes :NT. = définition d'une remarque automatiquement precédée de Remarque: (en france) en haute intensité. :ENT. = Fin de la note. :HELP NAME = 'UIM/HC'.Note. :XH3.Exemple de note. :P. Voici un exemple de note. :NT. voila une note automatiquement précédée de REMARQUE. :ENT. :EHELP. |
UIM Notes ............................................................................. : Note. : : # : : Voici un exemple de note. : : : : Remarque : voila une note automatiquement précédée de REMARQUE. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: :NT. voila une note automatiquement précédée de REMARQUE. :ENT. :EHELP. |
UIM Copie d'aide. :IMHELP NAME = 'HHHHHH' permet de demander l'exécution d'une autre aide dont le nom est HHHHH (si cet aide n'appartient pas au même PNLGRP il faudra utiliser au préalable le TAG :IMPORT.) :HELP NAME = 'UIM/HE' .Aide à copier :XH3.Texte affiché en cas de copie. :P. Cette ligne fait partie de l'aide copiée. :EHELP. :HELP NAME = 'UIM/HF'.Aide contenant une copie. :XH3.Exemple de copie d'aide. :P. L'aide copiée est en dessous cette ligne. :IMHELP NAME='UIM/HE'. :P. Retour à l'aide d'origine. :EHELP. |
UIM Copie d'aide. ............................................................................. : Aide contenant une copie. : : # : : L'aide copiée est en dessous cette ligne. : : : : Texte affiché en cas de copie. : : : : Cette ligne fait partie de l'aide copiée. : : : : Retour a l'aide d'origine. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: L'aide copiée est en dessous cette ligne. :IMHELP NAME='UIM/HE'. :P. Retour à l'aide d'origine. :EHELP. |
UIM Copie d'aide. avec :IMPORT dans panel UIMIMPORT :HELP NAME = 'UIM/IMP'.Aide importée. :XH3.Voici le texte étendu de l'aide importée. :P. Les aides peuvent être importées venant d'un autre *PNLGRP :P.ceci ce fait via &colon.IMPORT apres &colon.PNLGRP et avant le premier &colon.HELP. :NT.le lien est fait à l'exécution. :ENT. :EHELP. autre panel groupe (UIM) :PNLGRP. :IMPORT pnlgrp='UIMIMPORT' name='UIM/IMP'. .... :HELP NAME = 'UIM/HM'.Importation. :XH3.Exemple d'aide importée. :ISCH ROOTS='import'.Exemple d'importation. :P.Voici un exemple d'aide importée L'aide copiée est en dessous cette ligne. :IMHELP NAME='UIM/IMP'. :P.Retour a l'aide d'origine. :EHELP. |
UIM Copie d'aide. avec :IMPORT dans panel UIMIMPORT :HELP NAME ................................................................ :XH3.Voici : Importation. : :P. : # : Les aides p : Voici un exemple d'aide importée L'aide copiée est en : :P.ceci ce : dessous cette ligne. : premier &co : : :NT.le lien : Voici le texte étendu de l'aide importée. : :EHELP. : : a : Les aides peuvent être importées venant d'un autre *PNLGRP : :PNLGRP. : : :IMPORT pnl : ceci ce fait via :IMPORT apres :PNLGRP et avant le premier : .... : :HELP. : :HELP NAME : : :XH3.Exempl : Remarque : le lien est fait à l'exécution. : :ISCH ROOTS : : :P.Voici un : Retour a l'aide d'origine. : L'aide copi : Fin : :IMHELP NAM : F2=Aide étendue F10=Début au curseur : :P.Retour a : F11=Aide par index F12=Annuler F24=Autres touches : :EHELP. :..............................................................: |
UIM Hypertexte. L'hypertexte permet d'associer une aide complementaire à un mot de module d'aide. Ce mot sera précédé d'une zone de saisie.l'utilisateur pourra alors saisir un caractere (n'importe lequel) pour visualiser l'aide associée à ce mot. :LINK PERFORM = 'DSPHELP HHHHHHH ppppppp'. ou HHHHHH est le nom du module d'aide pppppp est le nom du PNLGRP (faculatif si c'est le même) suivi du mot concerné, puis :ELINK. TAG de fin. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). :XH3.Définition de l'HYPERTEXTE. :P. L'hypertexte est une aide associée à un mot d'un panneau d'aide. :P. Une aide de l'aide en quelque sorte. :NT.La touche F6 est active :ENT. :EHELP. :HELP NAME = 'UIM/HH'.Hypertexte (utilisation). :XH3.Utilisation de l'HYPERTEXTE. :P. Voici un exemple d'utilisation de l' :LINK PERFORM='DSPHELP UIM/HG'. hypertexte :ELINK. avec UIM. :NT.Tapez un caractere dans la zone de saisie puis appuyez sur <ENTREE> :ENT. :EHELP. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). .......................................................................... : Hypertexte (utilisation). : : # : : Voici un exemple d'utilisation de l' * hypertexte avec UIM. : : : : Remarque : Tapez un caractere dans la zone de saisie puis : : appuyez sur <ENTREE> : : Fin : : F2=Aide étendue F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F24=Autres touches : : : :........................................................................: Voici un exemple d'utilisation de l' :LINK PERFORM='DSPHELP UIM/HG'. hypertexte :ELINK. avec UIM. :NT.Tapez un caractere dans la zone de saisie puis appuyez sur <ENTREE> :ENT. :EHELP. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). .......................................................................... : Hypertexte (définition). : : # : : Définition de l'HYPERTEXTE. : : : : L'hypertexte est une aide associée a un mot d'un panneau d'aide. : : : : A suivre... : : F6=Sujets visualisés F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F20=Agrandir F24=Autres touches : : : :........................................................................: Voici un exemple d'utilisation de l' :LINK PERFORM='DSPHELP UIM/HG'. hypertexte :ELINK. avec UIM. :NT.Tapez un caractere dans la zone de saisie puis appuyez sur <ENTREE> :ENT. :EHELP. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). .......................................................................... : Hypertexte (définition). : : # : : Une aide de l'aide en quelque sorte. : : : : Remarque : La touche F6 est active : : : : Fin : : F6=Sujets visualisés F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F20=Agrandir F24=Autres touches : : : :........................................................................: Voici un exemple d'utilisation de l' :LINK PERFORM='DSPHELP UIM/HG'. hypertexte :ELINK. avec UIM. :NT.Tapez un caractere dans la zone de saisie puis appuyez sur <ENTREE> :ENT. :EHELP. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). .......................................................................... : Hypertexte (définition). : : ................................................................ : : : Sujets visualisés. : : : : : : : : Pour revenir à un sujet, positionnez le curseur en regard : : : : de ce sujet et appuyez sur ENTREE. : : : : : Fin : : : # Hypertexte (utilisation). Curseur positionné ici : : : : # Hypertexte (définition). : : : : : : :. : : .....: Voi : : :LI : : hyp : : :EL : Fin : ave : F12=Annuler : :NT : : E> :EN :..............................................................: :EHELP. |
:HELP NAME = 'UIM/HG' .Hypertexte (définition). .......................................................................... : Hypertexte (utilisation). : : # : : Voici un exemple d'utilisation de l' > hypertexte avec UIM. : : : : Remarque : Tapez un caractere dans la zone de saisie puis : : appuyez sur <ENTREE> : : Fin : : F2=Aide étendue F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F24=Autres touches : : : :........................................................................: Voici un exemple d'utilisation de l' :LINK PERFORM='DSPHELP UIM/HG'. hypertexte :ELINK. avec UIM. :NT.Tapez un caractere dans la zone de saisie puis appuyez sur <ENTREE> :ENT. :EHELP. |
Le lien avec l'hypertexte peut être conditionné LINKWHEN 'condition' Il est possible d'associer plusieurs conditions à un "LINK". SYNTAXE COMPLETE: :LINK PERFORM='DSPHELP aide panel' (UNLESSx='conditionx' THENDOx='DSPHELP aide1 panel' (UNLESSy='conditiony' THENDOy='DSPHELP aide2 panel') ) (LINKWHEN='conditionz'). Le "LINK" n'est exécuté que si 'conditionz' est VRAIE si conditiony est vraie THENDOy est exécuté sinon si conditionx est vraie THENDOx est exécuté dans tous les autres cas le PERFORM initial est exécuté. |
Les conditions utilisables 1/ Tester l'existance et les droits sur un objet 'CHKOBJ("OBJET","TYPE"(,"DROITS"))' si QRPG existe 'CHKOBJ("QRPG","*LIB") si l'utilisateur a le droit de modifier le fichier CLIENTP1 'CHKOBJ("CLIENTP1","*FILE","*CHANGE")' 2/ Tester la classe de l'utilisateur 'CHKUSRCLS("user-classe")' ! !--> *SECOFR Officier de sécurité *SECADM (ou *SECOFR) *PGMR (ou *SECADM ou *SECOFR) *SYSOPR (ou *PGMR ou *SECADM ou *SECOFR) *USER (ou un des précédents = tout le monde) |
Exemple avec une condition vraie (existence d'une Data area) La data area est crée dans QTEMP puis l'aide est affichée |
Exemple avec une condition vraie (existence d'une Data area) ............................................................................. : Hypertexte conditionné. : : # : : Le mot DATAAREA ne renvoie à un Hypertexte que si une * DATAAREA portant : : le nom DA_QTEMP existe. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
Exemple avec une condition vraie (existence d'une Data area) ............................................................................. : hypertexte DATAAREA. : : # : : Hypertexte pour DATA AREA (DA_QTEMP). : : : : Fin. : : F6=Sujets visualisés F10=Début au curseur F11=Aide par index : : F12=Annuler F13=Assistance F20=Agrandir F24=Autres touches : : : :...........................................................................: |
Exemple avec une condition vraie (existence d'une Data area) ............................................................................. : Hypertexte conditionné. : : # : : Le mot DATAAREA ne renvoie à un Hypertexte que si une > DATAAREA portant : : le nom DA_QTEMP existe. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
Le même exemple avec condition fausse La data area est supprimée |
Le même exemple avec condition fausse ............................................................................. : Hypertexte conditionné. : : # : : Le mot DATAAREA ne renvoie à un Hypertexte que si une DATAAREA portant le : : nom DA_QTEMP existe. : : Fin : : F2=Aide étendue F3=Fin d'aide F10=Début au curseur : : F11=Aide par index F12=Annuler F13=Assistance F14=Imprimer aide : : : :...........................................................................: |
UIM Index de recherche Il est possible de prévoir des entrées d'index de recherche dans un panneau d'aide. :ISCH ROOTS='paragraphe'.Exemple de paragraphe. ou "paragraphe" est le mot "clé" associé à cet aide "Exemple de ..." le texte affiché par le pgm de recherche dans l'index (cde STRSCHIDX) quelques exemples: :HELP NAME = 'UIM/H2'.Liste de paramètres. :XH3.Exemple de liste de paramètres. :ISCH ROOTS='liste paramètre'.Exemple liste de parametres. ..... :HELP NAME = 'UIM/H4'.Listes ordonnées imbriquées. :XH3.Exemple listes ordonnées imbriquées. :ISCH ROOTS='liste imbriquee'.Exemple listes imbriquées. ..... |
UIM Index de recherche Il est en général conseillé d'associer à chaque mot "clé" une liste de synonymes afin de faciliter la recherche des utilisateurs :ISCHSYN ROOT'mot-clé'.synonyme1 synonyme2 synonyme3 etc... Ces définitions de synonymes se placent en général en début de source Puis il faut associer le panneau d'aide à l'index par la cde CL ADDSCHIDXE. :PNLGRP :ISCHSYN ROOT='liste'.liste OL UL SL LI LP list listes :ISCHSYN ROOT='parametre'.parametre paramètres mot clé mot-clé keyword :ISCHSYN ROOT='ordonnée'.ordonnée ordonnées ordonner :ISCHSYN ROOT='ordonnée'.numérotée numérotées numeroter numérotation :ISCHSYN ROOT='imbriquee'.imbriquée imbriquées imbriquation imbriquer |
Consultation de l'index d'aide L'Aide par index vous permet de rechercher, dans le système, des informations particulières. Pour vous servir de cette fonction, procédez ainsi : 1. Entrez la phrase ou les mots à rechercher. 2. Appuyez sur ENTREE. Quand vous appuyez sur ENTREE, le système recherche les sujets correspondants aux mots indiqués, et affiche la liste des sujets trouvés. Si vous n'indiquez rien et faites ENTREE, le système affiche la liste de tous les sujets disponibles. Indiquez les termes à rechercher, puis appuyez sur ENTREE. liste ordonnée |
Exemple d'index(Tous les exemples UIM sont répertoriés) Indiquez vos options, puis appuyez sur Entrée. 5=Afficher le sujet 6=Imprimer le sujet Option Sujet 5 Exemple liste de paramètres. Exemple liste ordonnée. Exemple listes imbriquées. Exemple listes non ordonnées. Exemple liste simple. Exemple partie d'une liste. Fin Pour une nouvelle recherche, indiquez d'autres termes et appuyez sur Entrée. liste ordonnée |
AIDE Liste de paramètres. Exemple de liste de paramètres. Voici une liste de paramètre. *LIBL La liste de bibliothèque (mot réservé par défaut) *CURLIB La bibliothèque en cours (mot réservé possible) nom-bibli Un nom de bibliothèque (valeur possible) continuation du paragraphe. Fin F3=Fin d'aide F10=Début au curseur F12=Annuler F13=Assistance |
Exemple d'index(Tous les exemples UIM sont répertoriés) Indiquez vos options, puis appuyez sur Entrée. 5=Afficher le sujet 6=Imprimer le sujet Option Sujet Exemple liste de paramètres. Exemple liste ordonnée. Exemple listes imbriquées. Exemple listes non ordonnées. Exemple liste simple. Exemple partie d'une liste. Fin Pour une nouvelle recherche, indiquez d'autres termes et appuyez sur Entrée. liste ordonnée |
ATTENTION le lien entre l'index et le panel groupe est fait lors de l'exécution de la commande ADDSCHIDXE. SI vous modifiez les entrées (:ISCH) ou les synonymes (:ISCHSYN) il faut refaire ce lien: RMVSCHIDXE puis ADDSCHIDXE Depuis la VR30 on peut organiser les sujets en ordre hièrarchique. sujet 1 sujet 11 --> sujet 11 est sous-rubrique de sujet 1 sujet 11a sujet 11b --> sujet 11a et 11b sont sous rubriques de sujet 11 sujet 12 sujet 12a etc ... sujet 2 |
Ma mise en oeuvre est la suivante : :HELP NAME = 'UIM/S1' .Sujet 1 :ISCH ROOTS='sujet1'.Sujet de niveau 1 :ISCHSUBT topics='sujet11' topics='sujet12'. :P.aide du sujet de niveau 1 :EHELP. :HELP NAME = 'UIM/S11' .Sujet 1-1. :ISCH ROOTS='sujet 1'.Sujet de niveau 11. :ISCHSUBT topics='UIM/S11a' topics='UIM/S11b'. :P.aide du sujet de niveau 1 sous rubrique 1. :EHELP. :HELP NAME = 'UIM/S12' .Sujet 1-2. :ISCH ROOTS='sujet 12'.Sujet de niveau 12. :P.aide du sujet de niveau 1 sous rubrique 2 :EHELP. :HELP NAME = 'UIM/S11a' .Sujet 1-1/a. :ISCH ROOTS='sujet 11 a'.Sujet de niveau 11/a. :P.aide du sujet de niveau 1 sous rubrique 1/a :EHELP. |
:HELP NAME = 'UIM/S11b' .Sujet 1-1/b. :ISCH ROOTS='sujet 11 b'.Sujet de niveau 11/b. :P.aide du sujet de niveau 1 sous rubrique 1/b :EHELP. :HELP NAME = 'UIM/S2' .Sujet 2. :ISCH ROOTS='sujet 2'.Sujet de niveau 2. :P.aide du sujet de niveau 2 :EHELP. Un panneau ne peut pas être indiqué plusieurs fois en tant que sous rubrique d'un même panneau : :ISCHSUBT topics='H1' topics='H1' est interdit Mais un panneau peut être sous rubrique de plusieurs panneaux différents La seule limite est le niveau d'imbriquation limité à 16 !! Tous les panneaux n'étant pas référencés en tant que sous rubrique sont considérés de premier niveau (un index sans sous rubrique ne contient que des panneaux de premier niveau = index avant V2R30) Voici le résultat : |
Index d'aide Indiquez vos options et appuyez sur ENTREE (+ indique des sous-rubriques) 5=Afficher rubrique 6=Imprimer rubrique 7=Détailler rubrique 8=Condenser rubrique Opt Rubrique Index avec sous rubriques (V2R30) + Sujet de niveau 1. Sujet de niveau 2. ou entrez les termes à rechercher et appuyez sur ENTREE (le signe * indique les rubriques contenant les termes recherchés). F3=Fin d'aide F5=Toutes les rubriques F6=Rubriques principales F11=Cacher structure F12=Annuler F18=Autres index F24=Autres touches |
Index d'aide Indiquez vos options et appuyez sur ENTREE (+ indique des sous-rubriques) 5=Afficher rubrique 6=Imprimer rubrique 7=Détailler rubrique 8=Condenser rubrique Opt Rubrique Index avec sous rubriques (V2R30) 7 + Sujet de niveau 1. Sujet de niveau 2. ou entrez les termes à rechercher et appuyez sur ENTREE (le signe * indique les rubriques contenant les termes recherchés). F3=Fin d'aide F5=Toutes les rubriques F6=Rubriques principales F11=Cacher structure F12=Annuler F18=Autres index F24=Autres touches |
Index d'aide Indiquez vos options et appuyez sur ENTREE (+ indique des sous-rubriques) 5=Afficher rubrique 6=Imprimer rubrique 7=Détailler rubrique 8=Condenser rubrique Opt Rubrique Index avec sous rubriques (V2R30) Sujet de niveau 1. 7 + Sujet de niveau 11. Sujet de niveau 12. Sujet de niveau 2. Fin ou entrez les termes à rechercher et appuyez sur ENTREE (le signe * indique les rubriques contenant les termes recherchés). F3=Fin d'aide F5=Toutes les rubriques F6=Rubriques principales F11=Cacher structure F12=Annuler F18=Autres index F24=Autres touches |
Index d'aide Indiquez vos options et appuyez sur ENTREE (+ indique des sous-rubriques) 5=Afficher rubrique 6=Imprimer rubrique 7=Détailler rubrique 8=Condenser rubrique Opt Rubrique Index avec sous rubriques (V2R30) 8 Sujet de niveau 1. Sujet de niveau 11. Sujet de niveau 11/a. Sujet de niveau 11/b. Sujet de niveau 12. Sujet de niveau 2. Fin ou entrez les termes à rechercher et appuyez sur ENTREE (le signe * indique les rubriques contenant les termes recherchés). F3=Fin d'aide F5=Toutes les rubriques F6=Rubriques principales F11=Cacher structure F12=Annuler F18=Autres index F24=Autres touches |
Index d'aide Indiquez vos options et appuyez sur ENTREE (+ indique des sous-rubriques) 5=Afficher rubrique 6=Imprimer rubrique 7=Détailler rubrique 8=Condenser rubrique Opt Rubrique Index avec sous rubriques (V2R30) + Sujet de niveau 1. Sujet de niveau 2. Fin ou entrez les termes à rechercher et appuyez sur ENTREE (le signe * indique les rubriques contenant les termes recherchés). F3=Fin d'aide F5=Toutes les rubriques F6=Rubriques principales F11=Cacher structure F12=Annuler F18=Autres index F24=Autres touches |