Si vous personnalisez vos pages à l'aide de Paramètres Web, vous bénéficiez du fait que les instructions relatives aux personnalisations sont intégrées en tant que commentaires dans votre source DDS. Les Paramètres Web font alors partie de votre code source et les modifications que vous effectuez ne sont pas perdues si vous convertissez ensuite un projet WebFacing. Toutefois, vous perdrez toutes les modifications directement apportées à un fichier JSP généré si vous reconvertissez le projet.
Si vous ajoutez ou modifiez des paramètres Web d'un projet déjà converti, reconvertissez le projet pour inclure les modifications dans votre application WebFacing. Vous pouvez également ne reconvertir que les membres DDS que vous avez changés. Pour reconvertir des membres spécifiques, ouvrez la perspective WebFacing, cliquez sur l'onglet Projets WebFacing, développez le dossier DDS, cliquez avec le bouton droit sur le membre que vous avez modifié et sélectionnez Convertir. Si la vue Projets WebFacing n'apparaît pas, sélectionnez .
Si plusieurs paramètres Web du même type sont indiqués dans une zone, un enregistrement ou un fichier unique, alors le comportement n'est pas défini. En d'autres termes, il est impossible de savoir quel paramètre Web sera appliqué.
Objet DDS | Icône | Paramètres Web disponibles |
---|---|---|
Niveau fichier | ||
Affichage du fichier physique source | ![]() |
|
Enregistrements | ||
Enregistrement standard | ![]() |
|
Enregistrement de contrôle de sous-fichier | ![]() |
|
Constantes | ||
Constante de type message | ![]() |
|
Constante date | ![]() |
|
Constante heure | ![]() |
|
Constante utilisateur | ![]() |
|
Constante système | ![]() |
|
Zones d'entrée (y compris les zones pour lesquelles l'option Les deux a été spécifiée) | ||
Zone alphanumérique | ![]() |
|
Zone non condensée | ![]() |
|
Date | ![]() |
|
Heure | ![]() |
|
Horodatage | ![]() |
|
Variable flottante | ![]() |
|
Zone prolongée | ![]() |
|
DBCS Just | ![]() |
|
DBCS ou autre | ![]() |
|
DBCS Open | ![]() |
|
DBCS Graphic | ![]() |
|
Zones de sortie uniquement | ||
Zone alphanumérique | ![]() |
|
Zone non condensée | ![]() |
|
Date | ![]() |
|
Heure | ![]() |
|
Horodatage | ![]() |
|
Variable flottante | ![]() |
|
DBCS Just | ![]() |
|
DBCS ou autre | ![]() |
|
DBCS Open | ![]() |
|
DBCS Graphic | ![]() |
|
Constante texte | ![]() |
|
Zones masquées | ||
Zone alphanumérique | ![]() |
|
Zone non condensée | ![]() |
|
Date | ![]() |
|
Heure | ![]() |
|
Horodatage | ![]() |
|
Variable flottante | ![]() |
|
DBCS Just | ![]() |
|
DBCS ou autre | ![]() |
|
DBCS Open | ![]() |
|
DBCS Graphic | ![]() |
Si vous ouvrez la perspective WebFacing pour la première fois, le programme affiche la vue Paramètres Web par défaut. Elle reste vide tant que vous n'avez pas ouvert de membre source DSPF DDS dans l'éditeur LPEX ou dans le Concepteur d'écran. Pour modifier les paramètres Web d'un membre DDS :
*%%WB <numéro> <niveau>où <numéro> représente le numéro du paramètre Web et <niveau>, son niveau ({FIL|REC|FLD}). Pour étendre les paramètres Web sur plusieurs lignes, placez simplement le signe + en guise de caractère non vide à la fin de la ligne et placez l'expression *%%WB + au début de la ligne suivante.
Les sections suivantes décrivent les paramètres Web par fichier, enregistrement et niveau de zone, mais également la syntaxe des commentaires ajoutés au source DDS de chaque paramètre. Si vous utilisez une version de WebSphere Development Studio Client for iSeries antérieure à 6.0, vous devez savoir que certains paramètres Web utilisent une syntaxe différente. Si la syntaxe de certains paramètres Web est obsolète, elle est convertie dans la nouvelle syntaxe pendant la conversion WebFacing. Le cas échéant, nous avons ajouté la syntaxe obsolète de chaque paramètre Web.
Le seul paramètre Web au niveau fichier est Libellés des touches.
Pour les touches de fonction ou de commande contenues dans votre source DDS, vous pouvez indiquer les libellés à utiliser dans vos pages Web pour représenter les touches. Pour modifier un libellé, sélectionnez une touche de fonction ou de commande dans la liste Libellés des touches, cliquez deux fois dans la zone Nouveau libellé et tapez le nouveau texte de la touche. Pour supprimer un libellé que vous avez défini, cliquez deux fois dans la zone Nouveau libellé et supprimez le texte.
Sinon, vous pouvez sélectionner la ligne appropriée et utiliser l'option Modifier l'intitulé ou la touche Supprimer.Syntaxe :
A*%%WB 9 FIL <libellé_de_touche >["|"<libellé_de_touche2>["|"<libellé_de_touche3>[...]]]
Exemple :
A*%%WB 9 FIL 12=Annuler|03=Quitter
Le paramètre Taille d'affichage est disponible si une taille d'affichage secondaire a été sélectionnée pour le fichier écran. Vous pouvez définir les tailles d'affichage secondaire en précisant le mot clé DSPSIZ de niveau fichier. Le paramètre Web Taille d'affichage permet de modifier la taille de la table HTML qui permettra d'afficher votre application dans un navigateur. Ce paramètre Web concerne uniquement les enregistrements comprenant un mot clé DSPMOD conditionnel. Ces enregistrements peuvent être affichés dans la taille d'affichage primaire ou secondaire, selon la valeur de la condition à l'exécution, mais la conversion WebFacing cible seulement une taille d'affichage. Si vous souhaitez que l'application affiche l'enregistrement à la taille d'affichage secondaire plutôt qu'à la taille d'affichage primaire par défaut, vous devez inclure ce paramètre Web.
Syntaxe :
A*%%WB 10 REC
Exemple :
A*%%WB 10 REC
if(&{CID.INITIALVALUE} == "") { &{CID.REF}.value = "0001"; }Dans cet exemple, le code &{CID.INITIALVALUE} désigne une CID de zone, sélectionnée via le bouton Insérer l'attribut de zone. Pour savoir comment utiliser les variables de remplacement de zone, voir Définition des variables de remplacement de zone. Il existe d'autres exemples, tels que le code JSP, qui détermine l'adresse IP d'un utilisateur WebFacing, ou encore le code JavaScript, qui affiche la date et l'heure du système de l'utilisateur. Vous pouvez utiliser le paramètre Insertion de script avec le paramètre Envoi au navigateur. Par exemple, vous pouvez utiliser les valeurs déterminées par vos scripts pour compléter les zones masquées pour lesquelles vous avez utilisé le paramètre Envoi au navigateur. Si vous souhaitez utiliser une zone existant déjà dans votre DDS comme partie de votre script, ajoutez-la à votre script en cliquant sur le bouton Insérer le nom de zone. Par exemple, vous pouvez sélectionner un H ou une zone masquée et l'utiliser dans votre script de manière à lui affecter une valeur.
Syntaxe :
A*%%WB 18 REC 1 <script>
Syntaxe obsolète :
A*%%WB 18 REC <script>
L'option Insertion de script comprend deux formes obsolètes des variables de substitution :
&SFLREC{FIELD} qui devient &{SFLREC.FIELD.REF}
et
&{FIELD} qui devient &{FIELD.REF}
Par exemple, l'ancienne option Insertion de script (REC) :
A*%%WB 18 REC &{FIELD1}.value=1;&RECORD3{FIELD1}.value=4
devient la nouvelle option Insertion de script (REC 1):
A*%%WB 18 REC 1 &{FIELD1.REF}.value=1;&{RECORD3.FIELD1.REF}.value=4
Exemple :
A*%%WB 18 REC 1 &{CUSTCTL.field1.CURRENTVALUE}
Pour les touches de fonction ou de commande contenues dans votre source DDS, vous pouvez indiquer les libellés à utiliser dans vos pages Web pour représenter les touches. Pour modifier un libellé, sélectionnez une touche dans la liste Libellés et ordre des touches, cliquez deux fois dans la zone Nouveau libellé et tapez le texte de votre choix. La valeur Nouveau libellé est attribuée par défaut au paramètre Web des libellés de touches au niveau fichier si l'un d'entre eux est défini. Pour supprimer un libellé que vous avez défini, cliquez deux fois dans la zone Nouveau libellé et supprimez le texte. Sinon, vous pouvez sélectionner la ligne appropriée et utiliser l'option Modifier le libellé ou la touche Supprimer. Le bouton Par défaut supprime tous les paramètres Web associés (notamment, les libellés des touches, l'ordre des touches et les touches désactivées).
Syntaxe :
A*%%WB 9 REC <libellé_de_touche >["|"<libellé_de_touche2>["|"<libellé_de_touche3>[...]]]
Exemple :
A*%%WB 9 REC 2=Entrée|1=Imprimer
Dans le cas des touches de fonction ou de commande figurant dans le source DDS, vous pouvez indiquer si un libellé de touche est masqué dans les pages Web, ainsi que l'ordre dans lequel les touches seront affichées.
Pour masquer une touche, sélectionnez la touche dans la liste Libellés et ordre des touches et sélectionnez Masqué dans la liste déroulante de la colonne Etat. Le programme supprime la touche de la liste des boutons sur la page Web mais ne désactive pas la touche correspondante sur le clavier.
Pour désactiver une touche, sélectionnez la touche dans la liste Libellés et ordre des touches et sélectionnez Désactivé dans la liste déroulante de la colonne Etat. Le programme supprime la touche de la liste des boutons sur la page Web et désactive la touche correspondante sur le clavier.
Si la liste Libellés et ordre des touches propose plusieurs touches, vous pouvez modifier l'ordre d'affichage de la touche en cliquant sur le bouton Monter ou Descendre. Le bouton Par défaut permet de restaurer l'ordre initial des touches.
Syntaxe :
A*%%WB 11 REC <touche_caractère_signalisation> [<touche_caractère_signalisation2> [<touche_caractère_signalisation3> [...]]]
Où <touche_caractère_signalisation> revient à CAnn | CFnn | SFLFOLD[(CAnn|CFnn)] | SFLDROP[(CAnn|CFnn)].
Exemple :
A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)
Si SFLFOLD ou SFLDROP est indiqué sans touche de caractère de signalisation, par exemple :
A*%%WB 11 REC CA02 CF14 SFLFOLD SFLDROP(CA09)
Le programme met à jour le paramètre Web sur la valeur suivante :
A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)
en ajoutant le mot clé SFLFOLD précisé via la touche de fonction 10.
Ce paramètre Web fonctionne avec les libellés des touches et l'ordre des touches. Il permet de désactiver une touche de caractère de signalisation active (touche de commande ou de fonction) sur le clavier et ne se contente pas de masquer son libellé dans l'interface utilisateur Web.
Les touches sont classées selon le paramètre Web Ordre des touches. Si le paramètre Web Ordre des touches n'est pas spécifié, l'ordre est déterminé selon l'ordre numérique des touches de commande et l'ordre alphabétique des touches de fonction, sachant que les touches de commande viennent toujours avant les touches de fonction. Si une touche est définie à la fois comme visible dans le paramètre Web Ordre des touches (A*%%WB 11) et dans le paramètre Web Touches désactivées (A*%%WB 41), la séquence visible a priorité.
Syntaxe
A*%%WB 41 REC <touche_caractère_signalisation> [<touche_caractère_signalisation2> [<touche_caractère_signalisation3> [...]]]
Exemples
Ordre des touches visibles : CA01 HELP
Désactivé : CA01 CF03
Résultats : (ordre des touches visibles : CA01 HELP ; touches masquées mais activées : PRINT ; touches désactivées : CF03)
Ordre des touches visibles : aucune
Désactivé : CA01 CF03
Résultats : (ordre des touches visibles : HELP PRINT ; touches masquées mais activées : aucune ; touches désactivées : CA01 CF03)
Ordre des touches visibles : CA01 HELP
Désactivé : aucune
Résultats : (ordre des touches visibles : CA01 HELP ; touches masquées mais activées : CF03 PRINT ; touches désactivées : aucune)
Ordre des touches visibles : aucune
Désactivé : aucune
Résultats : (ordre des touches visibles : CA01 CF03 HELP PRINT ; touches masquées mais activées : aucune ; touches désactivées : aucune)
Pour interagir avec une autre application Web, sélectionnez le paramètre Passerelle d'application, puis Utiliser cet enregistrement pour les paramètres de passerelle d'application. Ce paramètre est disponible uniquement pour les enregistrements comportant des zones masquées (usage H) ou aucune zone.
Dans la zone d'entrée, indiquez l'adresse URL de l'application cible. Cette URL est au format "/appContextRoot/appEntryPoint" où appContextRoot correspond à la racine de contexte de l'application Web avec laquelle vous voulez interagir et appEntryPoint au point d'entrée de cette application Web. Pour plus de détails sur la procédure à suivre pour interagir avec une autre application Web, voir Utilisation de la passerelle d'application WebFacing pour l'interaction avec d'autres applications Web.
Remarques
Syntaxe
A*%%WB 42 REC /appContextRoot/appEntryPoint
Exemple
Pour interagir avec une application Web où la racine du contexte correspond à webApp et le point d'entrée à ProcessOrder :
A*%%WB 42 REC /webApp/ProcessOrder
La catégorie Aspect et texte propose plusieurs options, notamment Visibilité, Remplacer la classe de style et Remplacer la valeur de zone :
Syntaxe (option Caché) :
A*%%WB 4 FLD
Syntaxe (option Caractères masqués) :
A*%%WB 5 FLD <de> <à>
Syntaxe (option Remplacer la classe de style) :
A*%%WB 1 FLD <style> <zone>
Syntaxe (option Remplacer la valeur de zone) :
A*%%WB 3 FLD <longueur>"|"<texte>
Exemple (option Caché) :
A*%%WB 4 FLD
Exemple (option Caractères masqués) :
A*%%WB 5 FLD 1 12
Exemple (option Remplacer la classe de style) :
A*%%WB 1 FLD wf_default wf_field
Exemple (option Remplacer la valeur de zone) :
A*%%WB 3 FLD 10|OOOOOOOOOO
Le paramètre Libellés des touches dynamiques peut permettre de déterminer le libellé du texte d'une touche de commande pendant la phase d'exécution. Ce paramètre est disponible uniquement pour les zones de sortie. Grâce à ce paramètre, une touche de commande est associée à la zone de sortie et le texte de la touche de commande est déterminé par la valeur d'exécution de la zone. Vous pouvez par exemple utiliser cette fonction si votre application doit prendre en charge plusieurs langues et que vous souhaitez que le texte de la touche de commande apparaisse dans la langue de l'utilisateur. L'une des méthodes consiste à disposer d'un MSGF par langue, contenant les chaînes de texte utilisées par l'application, et à placer chaque MSGF dans une bibliothèque spécifique à la langue. Si la valeur de la zone de sortie est lue depuis le MSGF, vous pouvez modifier la langue du texte affiché dans la zone en plaçant la bibliothèque contenant le MSGF associé à la langue de l'utilisateur plus haut dans la liste des bibliothèques du profil utilisateur. De cette façon, le libellé de la touche de commande apparaît dans la langue de l'utilisateur.
Préfixe | Séparateur |
---|---|
F | = |
FP | = |
CF | = |
CA | = |
PF | = |
Syntaxe :
A*%%WB 20 FLD (<numéro_touche> | *AUTO)
Exemple :
A*%%WB 20 FLD F12
Le paramètre Substitutions HTML vous permet de remplacer le code HTML généré par du code HTML défini par l'utilisateur ou d'ajouter votre propre code HTML dans le code HTML généré.
Cliquez sur le bouton d'option Défini par le programme pour préciser que la valeur de la zone sera utilisée en tant que code HTML généré. Vous pouvez utiliser ce paramètre si vous souhaitez que le programme d'application calcule le code HTML de la zone plutôt que d'utiliser un code quelconque généré par la conversion WebFacing.
Cliquez sur le bouton d'option Défini par l'utilisateur pour préciser le texte ou les balises HTML qui peuvent être affichés avec ou à la place de la valeur de la zone. Dans la zone d'entrée, tapez les balises HTML que vous souhaitez utiliser. Par défaut, le paramètre Web correspond au script qui représente la valeur de la zone ou le texte de la constante. Si vous souhaitez utiliser la valeur de la zone dans le code HTML, cliquez sur le bouton Insérer l'attribut de zone. Pour savoir comment utiliser les variables de remplacement de zone, voir Définition des variables de remplacement de zone. Par exemple, vous pouvez utiliser ce paramètre si vous souhaitez que la valeur de la zone apparaisse en caractères gras. Pour ce faire, associez la balise <B> au texte &{FIELD.INITIALVALUE}. Dans cet exemple, vous allez modifier la zone d'entrée de sorte que le code HTML affiche <B>&{FIELD.INITIALVALUE}</B>. Si le code de &{FIELD.INITIALVALUE} n'est pas présent par défaut, vous pouvez l'ajouter en cliquant sur le bouton Insérer l'attribut de zone. Vous pouvez également ajouter des valeurs spéciales (date ou heure du système, par exemple) au code HTML défini par l'utilisateur. Pour plus d'informations sur l'utilisation de valeurs spéciales dans le code HTML, voir Utilisation de valeurs spéciales.
Cliquez sur le bouton d'option Insérer pour personnaliser les zones en ajoutant du code HTML supplémentaire. Vous pouvez éventuellement ajouter du code HTML Avant, A l'intérieur de ou Après la balise HTML qui est générée automatiquement pour la zone. Imaginons que vous disposez d'une zone d'entrée pour les numéros d'employé et que dans votre entreprise, tous les numéros d'employé comportent le préfixe 64-. Vous pouvez simplifier l'utilisation de la zone en ajoutant du code HTML, par exemple :
<strong>64- préfixe obligatoire</strong>
value="64-"
<a href="help.htm">Cliquez ici pour plus d'informations sur cette zone</a>
Dans cet exemple, le code HTML Avant fournit certaines informations sur la zone et utilise la balise <strong> de manière à ce que les informations soient mises en évidence par une police en gras. Le code HTML généré par la conversion utilisant la balise <input> pour les zones d'entrée, l'attribut HTML value="64-" peut être inséré à l'intérieur de la balise <input> pour que la zone soit déjà complétée par le préfixe de numéro d'employé et que les utilisateurs n'aient pas à le saisir. Après la zone, le code HTML définit un lien sur lequel les utilisateurs peuvent cliquer pour obtenir plus d'informations sur celle-ci.
N'oubliez pas de tester de manière approfondie les pages d'essai que vous modifiez à l'aide du paramètre Insertion de HTML. Les modifications effectuées peuvent être incompatibles avec le code HTML qui est généré par la conversion WebFacing. Pour éviter cela, vous pouvez convertir votre programme sans utiliser les Paramètres Web, examiner la source .html ou .jsp qui est générée pour voir les modifications pouvant être réalisées sans risque à l'aide des paramètres Web, les appliquer, puis lancer de nouveau la conversion.
Syntaxe (option Défini par le programme) :
A*%%WB 16 FLD
Syntaxe (option Défini par l'utilisateur) :
A*%%WB 17 FLD 1 <html>
A*%%WB 17 FLD 1 &{FIELD.INITIALVALUE}
Dès que le programme rencontre la syntaxe obsolète %FieldValue, il lui associe la nouvelle forme &{FIELD.INITIALVALUE} :
A*%%WB 17 FLD <html>
A*%%WB 17 FLD &FieldValue
Syntaxe (option Avant) :
A*%%WB 6 FLD <html>
Syntaxe (option A l'intérieur de) :
A*%%WB 7 FLD <html>
Syntaxe (option Après) :
A*%%WB 8 FLD <html>
Exemple (option Défini par le programme) :
A*%%WB 16 FLD
Exemple (option Défini par l'utilisateur) :
A*%%WB 17 FLD 1 <BOLD>&{PARTSFL.STQTY.CURRENTVALUE}</BOLD>
Exemple (option Avant) :
A*%%WB 6 FLD <strong>64- préfixe obligatoire</strong>
Exemple (option A l'intérieur de) :
A*%%WB 7 FLD value="64-"
Exemple (option Après) :
A*%%WB 8 FLD <a href="help.htm">Cliquez ici pour plus d'informations sur cette zone.</a>
Le paramètre Hyperlien permet d'afficher la zone sous la forme d'un hyperlien. Après avoir formaté l'hyperlien selon les paramètres DDS ou les paramètres du navigateur, vous pouvez associer le lien à une page statique ou réaliser des actions. Si vous souhaitez remplacer les paramètres du navigateur pour affecter un autre aspect aux hyperliens, cochez la case Utiliser les paramètres DDS. Si vous associez le paramètre Hyperlien au paramètre Image, la zone peut être affichée sous la forme d'un graphique pouvant également jouer le rôle d'un hyperlien. Certains des paramètres acceptent des valeurs de zone en entrée. Pour savoir comment utiliser les variables de remplacement de zone, voir Définition des variables de remplacement de zone.
La plupart des navigateurs suivent une convention pour la couleur et l'apparence des hyperliens sur les pages Web ou utilisent des paramètres modifiables par l'utilisateur pour l'apparence des hyperliens. Par exemple, les liens non visités peuvent être affichés en bleu et les liens visités peuvent être affichés en violet. Si vous souhaitez que le navigateur affiche l'hyperlien selon la même apparence que celle qu'utilise la zone figurant dans le fichier DDS, sélectionnez le bouton d'option Utiliser les paramètres DDS.
Syntaxe (option Utiliser les paramètres DDS) :
A*%%WB 12 FLD 3 <type_hyperlien> <détails_hyperlien> 1
Syntaxe (option Utiliser les paramètres du navigateur) :
A*%%WB 12 FLD 3 <type_hyperlien> <détails_hyperlien>
Exemple :
A*%%WB 12 FLD 3 http://www.ibm.fr| 1
Si vous souhaitez afficher une URL spécifique dans une zone, sélectionnez l'option Aller à l'URL. La valeur qui apparaîtra dans votre zone correspondra au texte affiché comme hyperlien. L'emplacement chargé par le navigateur lorsqu'un utilisateur clique sur le lien correspond à la valeur entrée dans la zone URL. Si vous souhaitez que le lien lance une autre fenêtre de navigateur lorsque l'on clique dessus, entrez le nom de la fenêtre en question dans la zone Cible. Si vous laissez la zone Cible vide ou si vous tapez la chaîne *SAME, le programme ouvrira le lien dans la fenêtre de navigation active.
Si vous utilisez un projet de type portlet WebFacing, vous pouvez indiquer *PORTLET dans la zone Cible pour ouvrir le lien dans le portlet.
Syntaxe :
A*%%WB 12 FLD 3 <url>"|"<cible>
Syntaxe obsolète :
A*%%WB 12 FLD 1 <url>"|"<cible>
Exemple :
A*%%WB 12 FLD 3 http://serveur/chemin?p2=&{FIELD2.INITIALVALUE}&p1=&{FIELD1.INITIALVALUE+ A*%%WB +}&p3=&{FIELD1.INITIALVALUE}
Syntaxe obsolète :
A*%%WB 12 FLD 1 http://serveur/chemin?p2=&{FIELD2}&p1=&{FIELD1}&p3=&{FIELD1}
Syntaxe :
A*%%WB 12 FLD 5 fld=<zone>"|"value=<valeur>
Si vous cochez la case Plus d'actions, vous pouvez choisir une touche de fonction ou une action de soumission d'appel de fonction JavaScript que vous associerez à l'hyperlien. Par exemple, vous pouvez choisir ENTREE ou DECONNEXION dans la liste déroulante Touche de fonction de soumission ou une touche de fonction que vous aurez préalablement définie dans le fichier DDS. Si vous souhaitez utiliser une touche de fonction provenant d'un autre enregistrement DDS, entrez une valeur pour cette touche de fonction. Lorsqu'un utilisateur clique sur un lien que vous avez créé pour une touche de fonction, le programme exécute cette fonction. Dans la zone d'appel de fonction JavaScript, vous pouvez entrer le nom d'une fonction JavaScript que vous souhaitez voir exécuter lorsque l'on clique sur le lien. Il peut s'agir d'une fonction que vous avez entrée à l'aide du paramètre Web Appeler JavaScript, d'une fonction que vous avez définie dans un fichier externe JavaScript ou d'une fonction insérée dans le fichier webface.js à l'aide de WebFacing. Si vous créez vos propres fichiers JavaScript externes, mettez-les dans le répertoire "usr" de votre projet WebFacing. Ce répertoire est situé dans le chemin d'accès <nom_projet>\WebContent\ClientScript\usr. Tout script placé dans ce répertoire est disponible pour votre application WebFacing lors de la phase d'exécution.
Vous pouvez même associer les options Placer le curseur sur la zone et Touche de fonction de soumission. Cela vous permet de définir la valeur d'une zone spécifique et de la soumettre à votre programme. Pour ce faire, cochez la case Placer le curseur sur la zone, choisissez une zone dans la liste déroulante (ou tapez une zone), cochez la case Plus d'actions, sélectionnez le bouton d'option Touche de fonction de soumission et choisissez ENTREE dans la liste déroulante. Pour connaître le format d'entrée des zones Placer le curseur sur la zone et Touche de fonction de soumission, consultez la section Placer le curseur sur la zone du présent document.
Syntaxe :
A*%%WB 12 FLD 4 fld=<zone>"|"value=<valeur>"|"func=<touche_fonction>
Syntaxe obsolète :
A*%%WB 12 FLD 2 fld=<zone>"|"value=<valeur>
Exemple :
A*%%WB 12 FLD 4 fld=&{FIELD3.REF}|value=1|func=ENTER
Syntaxe obsolète :
A*%%WB 12 FLD 2 fld=FIELD3|value=1
Entrez le nom d'une fonction JavaScript que vous souhaitez voir appeler lorsque vous cliquez sur le lien. Par exemple, entrez maFonction(). Il peut s'agir d'une fonction que vous avez entrée à l'aide du paramètre Web Insertion de script, d'une fonction que vous avez définie dans un fichier externe JavaScript ou d'une fonction insérée dans le fichier webface.js à l'aide de WebFacing. Si vous créez vos propres fichiers JavaScript externes, mettez-les dans le répertoire "usr" de votre projet WebFacing. Ce répertoire est situé dans le chemin d'accès <nom_projet>\WebContent\ClientScript\usr. Tout script placé dans ce répertoire est disponible pour votre application WebFacing lors de la phase d'exécution. Si vous possédez une fonction JavaScript interne courte, vous pouvez également entrer la fonction entière dans la zone Appeler JavaScript.
A*%%WB 12 FLD 6 <touche_fonction>Syntaxe (option Appeler JavaScript) :
A*%%WB 12 FLD 7 <javascript>Syntaxe (option Placer le curseur sur la zone) :
A*%%WB 12 FLD 8 fld=<zone>"|"value=<valeur>"|"func=<javascript>Syntaxe (option Hyperlien JavaScript):
A*%%WB 12 FLD 9 <javascript>
Utilisez le paramètre Image si vous souhaitez afficher une image à la place de la zone. Ce paramètre peut être utilisé par exemple pour présenter une base de données de produits, avec des images des articles en stock.
Complétez la zone Nom de fichier en indiquant le chemin d'accès complet à un fichier image situé sur votre poste de travail ou l'adresse URL complète d'un fichier image (par exemple, http://www.ibm.com/image.gif). La zone Nom de fichier peut être remplie en entrant directement une valeur ou en utilisant le bouton Parcourir pour trouver un fichier local. Les images locales que vous spécifiez seront copiées dans le répertoire ..\Contenu Web\images\generated de votre projet WebFacing lors de la conversion WebFacing. Les images contenues dans ce répertoire sont ensuite publiées sur le serveur lorsque vous déployez votre projet à l'aide de l'assistant d'exportation.
Vous pouvez utiliser les options Largeur et Hauteur si vous connaissez les dimensions d'une image. L'ajout d'informations sur la largeur et la hauteur peut parfois accélérer la restitution des pages Web qui contiennent des images.
La zone Texte secondaire permet d'indiquer le texte secondaire de l'image.
Syntaxe :
A*%%WB 13 FLD 1 <largeur>"|"<hauteur>"|"<graphique>"|"<texte secondaire>
Syntaxe obsolète :
A*%%WB 13 FLD <largeur>"|"<hauteur>"|"<graphique>
Exemple :
A*%%WB 13 FLD 1 15|34|graphic.gif A*%%WB 13 FLD 1 15|34|graphic.gif|IBM logo
A*%%WB 13 FLD 1 3|2|&{FIELD1.INITIALVALUE}.gif
Syntaxe obsolète :
A*%%WB 13 FLD 15|34|graphic.gif
A*%%WB 13 FLD 3|2|&{FIELD1}.gif
Les options disponibles pour le paramètre Emplacement sont Changer la plage et Changer la position. Une fois que votre source DDS est converti à l'aide de l'outil WebFacing, votre application est positionnée sur une page Web à l'aide d'une table HTML. La table HTML comporte le même nombre de lignes et de colonnes que l'écran DDS -- 24 par 80 ou 27 par 132. A l'aide des paramètres Emplacement, vous pouvez modifier la manière dont les zones seront positionnées dans la table HTML après la conversion du source.
La fenêtre de l'éditeur illustre la présentation des lignes et des colonnes du source DDS. Elle vous donne une idée de la manière dont les zones seront placées les unes par rapport aux autres si vous apportez des modifications à l'aide des options Changer la position et Changer l'étendue.
Syntaxe (option Changer la position) :
A*%%WB 2 FLD <numéro_ligne> <numéro_colonne>
Syntaxe (option Changer l'étendue) :
A*%%WB 15 FLD <numéro_ligne> <numéro_colonne>
Syntaxe (option Position CSS) :
A*%%WB 21 FLD <numéro_ligne> +/-<décalage_pixels> | <numéro_colonne> +/-<décalage_pixels> | <désactiver_la_tabulation>
Exemple (option Changer la position) :
A*%%WB 2 FLD 14 3
Exemple (option Changer l'étendue) :
A*%%WB 15 FLD 1 1
Exemple (option Position CSS) :
Pour déplacer une zone d'entrée jusqu'à la ligne 30, colonne 20 (sans aucun décalage, ni pour l'une ni pour l'autre) et autoriser la tabulation :
A*%%WB 21 FLD 30 +0 | 20 +0 | false
Pour désactiver la tabulation et déplacer une zone d'entrée jusqu'à la ligne 40, colonne 10, en incluant un décalage de 20 pixels vers le bas et de 5 pixels vers la gauche (respectivement) :
A*%%WB 21 FLD 40 +20 | 10 -5 | true
Le paramètre Libellés des options est disponible pour les zones d'entrée qui comprennent le mot clé VALUES. Ces zones s'affichent dans les pages Web sous la forme d'une série de boutons d'option. Les options affichées dans la zone de sélection sont les valeurs fournies comme paramètres pour le mot clé VALUES dans votre source DDS.
Ce paramètre Web permet de modifier le libellé ou le texte présenté à l'utilisateur. Par exemple, si l'un des paramètres VALUES attendu par votre programme est "article8", vous pouvez entrer un texte plus descriptif pour l'affichage dans un navigateur, par exemple "câble calibre 8". Le texte affiché pour l'utilisateur sera "câble calibre 8" mais la valeur renvoyée à votre programme restera la valeur "article8" attendue par celui-ci.
Pour utiliser ce paramètre Web, cliquez deux fois sur la zone Intitulé de l'option et tapez le texte de votre choix.
Syntaxe :
A*%%WB 14 FLD <valeur>=<libellé>["|"<valeur2>=<libellé2>["|"<valeur3>=<libellé3>[...]]]
Exemple :
Avec des valeurs numériques :
A*%%WB 14 FLD 0=valeur 0|1=valeur 1
Avec des valeurs de texte :
A*%%WB 14 FLD 'valeur0'=valeur 0|'valeur1'=valeur 1
Le paramètre Envoi au navigateur peut être utilisé pour les zones DDS H ou masquées. Ce paramètre modifie les fichiers JSP pour vos enregistrements. Par exemple, si vous avez une zone H appelée LISTCTL, alors que ce paramètre est utilisé, un élément de type formulaire d'entrée HTML sera généré dans le fichier JSP appelé LISTCTL.jsp. Les éléments masqués de type formulaire d'entrée commencent par le code HTML suivant : <INPUT TYPE="hidden". L'utilisation du paramètre Envoi au navigateur permet à une zone H de faire partie de l'environnement du navigateur et aux valeurs d'être affectées à cette zone sur la base de cet environnement. Par exemple, l'adresse IP d'un utilisateur déterminée par un script ajouté avec le paramètre Insérer dans le script peut servir à renseigner la zone masquée.
Syntaxe :
A*%%WB 19 FLD
Exemple :
A*%%WB 19 FLD
Les paramètres Web Insertion de HTML, Langage HTML défini par l'utilisateur, Image, Insertion de script, Aller à l'URL, Placer le curseur sur la zone et Appeler JavaScript acceptent les variables de remplacement de zone. La liste suivante détaille les variables de remplacement de zone possibles, notamment les variables obsolètes (mais toujours prises en charge) éventuelles :
La variable obsolète est &{FIELD.value}.
La variable obsolète est &{FIELD.value}.
La variable obsolète est &{RECORD.FIELD.value}.
La variable obsolète est &{RECORD.FIELD.value}.
La variable obsolète est &{FIELD}.
La variable obsolète est &{FIELD}.
La variable obsolète est &{RECORD.FIELD}.
La variable obsolète est &{RECORD.FIELD}.
Vous pouvez utiliser des valeurs spéciales lorsque vous insérez du code HTML défini par l'utilisateur via le paramètre Web Défini par l'utilisateur dans Substitutions HTML. Les valeurs suivantes peuvent être utilisées dans le contexte du paramètre Web Défini par l'utilisateur sur les zones correspondantes dans votre spécification DDS :
La valeur obsolète était &SystemName.
La valeur obsolète était &UserID.
La valeur obsolète était &Date.
La valeur obsolète était &Time.