Utilisation des paramètres Web avec le source DDS

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 Fenêtre > Afficher la vue > Autre > WebFacing > Projets WebFacing.

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é.

Tableau 1. Paramètres Web
Objet DDS Icône Paramètres Web disponibles
Niveau fichier
Affichage du fichier physique source
  • Libellés des touches
Enregistrements
Enregistrement standard
  • Libellés et ordre des touches
  • Touches désactivées
  • Taille d'affichage
  • Insertion de script
  • Passerelle d'application
Enregistrement de contrôle de sous-fichier
Constantes
Constante de type message
  • Apparence
  • Substitutions HTML
  • Emplacement
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
  • Apparence
  • Substitutions HTML
  • Emplacement
  • Libellés d'options (uniquement disponibles si la zone d'entrée est précisée et accompagnée du mot clé VALUES)
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
  • Apparence
  • Libellés des touches dynamiques
  • Substitutions HTML
  • Hyperlien
  • Image
  • Emplacement
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
  • Envoi au navigateur
Zone non condensée
Date
Heure
Horodatage
Variable flottante
DBCS Just
DBCS ou autre
DBCS Open
DBCS Graphic

Modification des paramètres Web d'un membre DDS

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 :

  1. Dans la perspective WebFacing, développez Projet WebFacing > DDS.
  2. Cliquez avec le bouton droit de la souris sur le membre DDS à utiliser, puis sélectionnez Ouvrir avec > Editeur LPEX de systèmes distants.
  3. A l'invite, identifiez-vous sur le serveur. Le programme ouvre le fichier dans l'éditeur.
  4. Cliquez sur un objet DDS dans l'éditeur. Le programme affiche la liste des paramètres de l'objet dans la vue Paramètres Web.
  5. Dans la liste, cliquez sur un paramètre pour le modifier. Le programme affiche les options du paramètre Web sur la partie droite de la vue Paramètres Web.
  6. Si la vue Paramètres Web n'apparaît pas, sélectionnez Fenêtre > Afficher la vue > Autre > WebFacing > Paramètres Web pour l'ouvrir.
  7. Pour parcourir rapidement les objets spécifiques, sélectionnez Fenêtre > Afficher la vue > Structure pour ouvrir la vue Structure. Dès que vous cliquez sur les objets de la vue Structure, le programme met l'objet en surbrillance dans l'éditeur.

Description des paramètres Web

Les Paramètres Web disponibles pour un objet DDS sont différents selon l'objet que vous utilisez. La présente section décrit chaque paramètre en détail. Lorsque vous utilisez des Paramètres Web pour un objet, des commentaires spéciaux sont ajoutés au source DDS qui est ensuite traité par la conversion WebFacing. Les commentaires associés aux Paramètres Web commencent par *%%WB. La liste suivante détaille la convention de syntaxe des paramètres Web :
*%%WB <numéro> <niveau>
<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.

Paramètres Web (niveau fichier)

Le seul paramètre Web au niveau fichier est Libellés des touches.

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.
Remarque : Les libellés de touche de fonction ne peuvent pas être supprimés.

Syntaxe :

A*%%WB 9 FIL <libellé_de_touche >["|"<libellé_de_touche2>["|"<libellé_de_touche3>[...]]]

Exemple :

A*%%WB 9 FIL 12=Annuler|03=Quitter 

Paramètres Web (niveau enregistrement)

La liste suivante détaille les catégories de paramètres Web au niveau enregistrement :
  • Taille d'affichage
  • Insertion de script
  • Libellés des touches
  • Ordre des touches
  • Touches désactivées
  • Passerelle d'application
Taille d'affichage

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
Insertion de script
Utilisez le paramètre Insertion de script pour personnaliser les fichiers JSP qui sont créés pour des enregistrements classiques ou pour des enregistrements de contrôle de sous-fichiers. Par exemple, si vous disposez d'un enregistrement de contrôle de sous-fichiers appelé LISTCTL, la conversion pour WebFacing créera un fichier JSP correspondant appelé LISTCTLJavaScript.jsp. Le code que vous indiquez dans la zone de texte du paramètre Insertion de script sera ajouté au fichier LISTCTLJavaScript.jsp pendant sa génération. Ce paramètre permet d'entrer du code JavaScript ou des scriptlets JSP arbitraires dans les fichiers JSP convertis. Il peut être utilisé pour initialiser des zones ou pour effectuer des travaux requis pour le format d'enregistrement spécifique. Par exemple, vous pourriez ajouter du code définissant une valeur pour une zone à condition que sa valeur initiale de celle-ci soit indéfinie :
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}
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 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).

Remarque : Plusieurs méthodes permettent de définir le libellé des touches de fonction figurant dans les applications WebFacing. Si plusieurs libellés sont affectés à une touche, les processus de conversion et d'exécution WebFacing utilisent une table de priorité particulière pour déterminer le libellé qui apparaîtra dans le navigateur. Pour connaître la priorité utilisée pour déterminer les libellés de touche, voir Libellés des boutons des touches.

Syntaxe :

A*%%WB 9 REC <libellé_de_touche >["|"<libellé_de_touche2>["|"<libellé_de_touche3>[...]]]

Exemple :

A*%%WB 9 REC 2=Entrée|1=Imprimer
Ordre des touches

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.

Remarque : Si vous utilisez CODE Designer pour modifier le paramètre Web, le programme séparera les touches de commande et de fonction. Si vous souhaitez modifier l'ordre des touches de commande et de fonction, vous devez uniquement utiliser la vue Paramètres Web pour modifier le paramètre Web.

Syntaxe :

 A*%%WB 11 REC <touche_caractère_signalisation> [<touche_caractère_signalisation2> [<touche_caractère_signalisation3> [...]]]

<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.

Touches désactivées

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.

Sur l'interface utilisateur des paramètres Web, vous pouvez définir l'état d'une touche sur l'une des trois valeurs suivantes :
  • Visible : Le libellé de la touche est visible et la touche associée sur le clavier est active.
  • Masqué : Le libellé de la touche est masqué mais la touche associée sur le clavier est active.
  • Désactivé : Le libellé de la touche est masqué et la touche associée sur le clavier est désactivée.

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

Touches affectées : CF03 CA01 PRINT HELP
  1. 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)

  2. 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)

  3. 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)

  4. 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)

Passerelle d'application

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

  • Si vous spécifiez le paramètre Passerelle d'application, tous les autres paramètres contenus dans cet enregistrement et dans toutes les zones de ce dernier ne seront pas disponibles et seront supprimés le cas échéant. Pour éviter cela, utilisez la fonction Annuler ou la combinaison de touches Ctrl-Z pour revenir aux paramètres d'origine.
  • Les caractères admis dans les noms de zones de l'enregistrement sont limités à 'A' à 'Z' et '0' à '9'.
  • Les mots clés DATFMT et DATSEP ne doivent pas être utilisés dans une zone de date masquée et les mots clés TIMFMT et TIMSEP dans une zone horaire masquée.

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

Paramètres Web (niveau zone)

La liste suivante détaille les catégories de paramètres Web au niveau zone :
  • Aspect
  • Libellés des touches dynamiques
  • Substitutions HTML
  • Hyperlien
  • Image
  • Emplacement
  • Libellés des options
  • Envoi au navigateur
Aspect

La catégorie Aspect et texte propose plusieurs options, notamment Visibilité, Remplacer la classe de style et Remplacer la valeur de zone :

  • L'option Visibilité permet de masquer la zone par le biais du paramètre Web Caché. Vous pouvez également utiliser le paramètre Web Caractères masqués pour indiquer une plage de caractères que vous ne souhaitez pas afficher. Par exemple, vous pouvez masquer les deux premiers caractères pour afficher uniquement le texte de l'option (1. Tâches utilisateur - 2. Tâches bureau) si l'écran affiche un menu proposant plusieurs options répertoriées par numéro et que l'utilisateur peut choisir. Dans une situation de ce type, vous devez choisir l'option Caractères masqués et indiquer la plage De 1 à 2. Si vous utilisez le paramètre Web Caché, la même zone n'autorise aucun autre paramètre Web.
  • L'option Remplacer la classe de style permet de préciser la classe de feuille de style à utiliser avec la zone. Imaginons que vous souhaitez que toutes les données numériques s'affichent dans une police ou une couleur particulière et que vous avez défini une classe de feuille de style numérique à cet effet. Si le programme comporte une zone de numéro de client (numcli, par exemple), vous pouvez cocher la case Remplacer la classe de style et mentionner le nom de la classe de la feuille de style numérique.
  • Remplacer la valeur de zone vous permet d'indiquer le texte que vous souhaitez afficher à la place de la valeur renvoyée pour votre zone. Dans le cas des zones de constante, le programme remplace le titre de la case à cocher par Remplacer texte et la zone prend par défaut le texte de la constante.

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
Libellés des touches dynamiques

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.

Pour utiliser ce paramètre, choisissez le paramètre Libellés des touches dynamiques et sélectionnez l'option Utiliser la valeur de zone en tant que libellé de la touche de fonction. Dans la liste, choisissez la touche qui sera associée au texte de la zone de sortie. Sinon, vous pouvez également choisir l'option *AUTO dans la liste. *AUTO signifie que la valeur de zone est analysée au moment de l'exécution pour déterminer à quelle touche de commande le libellé est associé. Le programme peut ainsi analyser plusieurs libellés.
Remarque : Plusieurs méthodes permettent de définir le libellé des touches de fonction figurant dans les applications WebFacing. Si plusieurs libellés sont affectés à une touche, les processus de conversion et d'exécution WebFacing utilisent une table de priorité particulière pour déterminer le libellé qui apparaîtra dans le navigateur. Pour connaître la priorité utilisée pour déterminer les libellés de touche, voir Libellés des boutons des touches.
Remarque : A l'heure actuelle, seul un petit nombre de types de chaîne sont pris en charge par *AUTO. Déterminez si *AUTO fonctionne avec votre application en fonction des schémas répertoriés dans le tableau des préfixes et des séparateurs ci-dessous et des chaînes de libellé de touche de commande utilisées dans votre application. Le tableau identifie les schémas par un préfixe et un séparateur. Par exemple, le programme utilisera la chaîne Quitter comme libellé de la touche de commande si la chaîne F3=Quitter constitue la valeur de sortie et si vous avez choisi l'option *AUTO dans la liste. F est considéré comme le préfixe, = est le séparateur et le texte après le séparateur est utilisé comme libellé. Si vous précisez l'option *AUTO, vous pourrez définir plusieurs libellés dans la zone de sortie.
Préfixe Séparateur
F =
FP =
CF =
CA =
PF =
Avertissements
  • *AUTO peut influer sur les performances d'exécution. Vous pouvez éviter d'utiliser *AUTO en vous assurant que chaque mappage de zone de sortie vers une touche de commande est bien unique.
  • Si vous utilisez non pas l'option *AUTO, mais des MSGF pour le texte des zones de sortie, le texte du MSGF ne doit pas inclure la touche. Par exemple, pour Quitter, le texte d'un MSGF doit être Quitter et non F3=Quitter.

Syntaxe :

A*%%WB 20 FLD (<numéro_touche> | *AUTO)

Exemple :

A*%%WB 20 FLD F12
Substitutions HTML

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 :

Avant (%%WB 6)

<strong>64- préfixe obligatoire</strong>

A l'intérieur de (%%WB 7)

value="64-"

Après (%%WB 8)

<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>
Hyperlien

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.

Remarque : Sous certaines conditions, les liens hypertexte Action que vous créez à l'aide des paramètres Web ne s'affichent pas dans un navigateur. De cette façon, les conditions d'erreur sont évitées lorsque l'hyperlien ne s'applique pas à ce qui est actif ou disponible dans le navigateur. Par exemple :
  • L'hyperlien se trouve dans un enregistrement ne correspondant pas actuellement à la fenêtre supérieure et ne se trouvant pas non plus sur la couche supérieure.
  • Une touche de fonction que vous avez associée au lien n'est pas active en ce moment.
  • Une zone référencée qui constitue une partie du lien n'est pas un enregistrement actif ou n'est pas lisible. Par exemple, l'enregistrement est protégé par d'autres enregistrements qui utilisent le mot clé PROTECT.
Utiliser les paramètres DDS

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
Aller à l'URL

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.

Si le fichier DDS comprend une valeur de zone que vous souhaitez intégrer à l'URL, cliquez sur le bouton associé à la zone URL et choisissez l'enregistrement, la zone et l'attribut de votre choix. Par exemple, vous pouvez utiliser la valeur de zone Insérer pour construire l'URL si vous souhaitez ajouter des paramètres à l'URL http://monsite.com/monapplicationweb/servlet/MonServlet et si le servlet attend des arguments pour les variables parm1 et parm2. Dans cet exemple, l'URL finale ressemblera à http://monsite.com/monapplicationweb/servlet/MonServlet?parm1=&{FIELD1.INITIALVALUE}&parm2=&{FIELD2.INITIALVALUE}&{FIELD1.INITIALVALUE} et &{FIELD2.INITIALVALUE} représentent les paramètres que vous avez ajoutés et qui seront remplacés au stade de l'exécution.
Remarque : Si vous souhaitez utiliser une valeur de zone d'un format d'enregistrement différent au sein de l'URL de la zone hyperlien, assurez-vous que la zone est disponible sur la page Web où s'affiche l'hyperlien. Les zones de formats d'enregistrement différents peuvent être identifiées dans la boîte de dialogue Insérer l'attribut de zone car elles contiennent le nom du format d'enregistrement (&{RECORD2.FIELD1.INITIALVALUE}, par exemple). Si aucun des deux formats d'enregistrement n'est disponible sur la page Web quand l'hyperlien est affiché, une erreur apparaîtra lorsque l'hyperlien sera sélectionné. Pour savoir comment utiliser les variables de remplacement de zone, voir Définition des variables de remplacement de zone.

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}
Effectuer les actions
Le paramètre Effectuer les actions permet de créer un lien, qui place le curseur sur une zone, effectue un envoi et/ou les deux à la fois dès qu'un utilisateur clique dessus. Les options Placer le curseur sur la zone et Plus d'actions ont pour valeur celle que vous indiquez.
Placer le curseur sur la zone
Lorsque vous cliquez sur le lien, la valeur d'exécution de l'emplacement du curseur renvoyée à l'application correspond à l'emplacement de la zone que vous indiquez ici. Vous pouvez sélectionner une zone dans la liste déroulante ou entrer directement un nom pour cette zone. Si vous ne sélectionnez pas Placer le curseur sur la zone, le curseur est positionné sur la dernière zone sélectionnée par l'utilisateur. Cette valeur du curseur ne se rapporte pas au curseur tel qu'il s'affiche dans le navigateur mais à la valeur de la phase d'exécution de WebFacing pour l'emplacement du curseur en cours dans l'enregistrement DDS. Si vous souhaitez affecter une valeur à la zone sur laquelle le curseur est placé, choisissez une zone ou cochez la case Définir la valeur de zone sur et tapez une valeur dans la zone de texte associée. 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.

Syntaxe :

A*%%WB 12 FLD 5 fld=<zone>"|"value=<valeur>
Plus d'actions

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
Appeler JavaScript

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.

Syntaxe (option Touche de fonction de soumission) :
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>
Remarque : L'option Hyperlien JavaScript est obsolète et a été remplacée par l'option Appeler JavaScript.

Image

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.

Si le programme contient des zones qui renvoient à des valeurs pouvant appartenir au nom du fichier image ou à l'adresse URL complète d'un fichier image, vous pouvez ajouter les valeurs à la zone Nom de fichier en cliquant sur le bouton Insérer l'attribut de zone et en sélectionnant une zone dans la zone Zone. Par exemple, dans le cas de &{FIELD.INITIALVALUE} qui renvoie la valeur bicyclette1, vous pouvez désigner une image bicyclette1.gif. Dans cet exemple, commencez par sélectionner le bouton d'option Dynamique et complétez la zone Nom de fichier en cliquant sur le bouton Insérer l'attribut de zone et en rajoutant l'extension .gif. Les fichiers que vous identifiez en utilisant un attribut de zone doivent être copiés manuellement dans le répertoire ..\Contenu Web\images\generated\.
Remarque : Le seul attribut de zone autorisé pour ce paramètre Web est Valeur initiale. Les images doivent en effet être entièrement résolues la première fois qu'une page Web est chargée.
Pour savoir comment utiliser les variables de remplacement de zone, voir Définition des variables de remplacement de zone.

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
Emplacement

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.

  • Changer la position vous permet d'indiquer la ligne et la colonne de la table HTML correspondant à la position de début de votre zone.
  • Changer la plage vous permet d'indiquer le nombre de lignes et de colonnes qui seront attribuées à votre zone dans la table HTML. Il est possible d'utiliser l'option Changer la plage pour remplacer les valeurs de texte initialement utilisées par votre programme pour remplir la zone par une illustration. Par exemple, 7 colonnes étaient peut-être nécessaires pour le texte de la zone dans le programme initial, alors que l'illustration proposée n'utilise que 2 colonnes.

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.

L'option supplémentaire pour le paramètre Emplacement est Position CSS. Le paramètre de positionnement de la feuille de style en cascade vous permet de placer des zones à n'importe quel endroit de la page Web, sans restrictions.
  • Le paramètre Ligne vous permet de préciser la valeur de ligne de la zone. Vous devez indiquer un entier positif supérieur ou égal à 1.
  • Le paramètre Colonne vous permet de préciser la valeur de colonne de la zone. Vous devez indiquer un entier positif supérieur ou égal à 1.
  • Le paramètre Décalage vous permet de préciser le nombre de pixels d'ajustement de la zone, en fonction de la valeur de ligne ou de colonne. Vous pouvez indiquer 0 ou un nombre entier positif ou négatif.
  • L'option Désactiver la tabulation vous permet d'indiquer si la zone est accessible par tabulation une fois qu'elle a été déplacée. Si vous sélectionnez cette option, l'utilisateur ne pourra pas atteindre la zone via une tabulation. Sinon, la zone demeure dans le même ordre de tabulation qu'avant son déplacement.

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>
Remarque : Le décalage en pixels doit être précédé du signe + ou -. La valeur de désactiver_tabulation doit être true ou false.

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
Libellés des options

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
Envoi au navigateur

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

Définition des variables de remplacement de zone

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 :

&{FIELD.CURRENTVALUE}
Cette variable représente la valeur courante de l'objet zone HTML d'une zone d'entrée figurant dans l'enregistrement courant, qui peut être modifiée par l'utilisateur dans le navigateur ou qui est masquée tout en utilisant malgré tout le paramètre Web Envoi au navigateur.

La variable obsolète est &{FIELD.value}.

&{FIELD.INITIALVALUE}
Cette variable représente la valeur initiale de l'exécution WebFacing d'une zone d'entrée ou de sortie figurant dans l'enregistrement courant.

La variable obsolète est &{FIELD.value}.

&{RECORD.FIELD.CURRENTVALUE}
Cette variable représente la valeur courante de l'objet zone HTML d'une zone d'entrée figurant dans l'enregistrement spécifié, qui peut être modifiée par l'utilisateur dans le navigateur.

La variable obsolète est &{RECORD.FIELD.value}.

&{RECORD.FIELD.INITIALVALUE}
Cette variable représente la valeur initiale de l'exécution WebFacing d'une zone d'entrée ou de sortie figurant dans l'enregistrement précisé.

La variable obsolète est &{RECORD.FIELD.value}.

&{FIELD.REF}
Cette variable représente une référence à un objet zone HTML (document.SCREEN.l1_REC1$FIELD1, par exemple). Elle concerne uniquement les zones d'entrée ou les zones qui sont masquées mais qui utilisent malgré tout le paramètre Web Envoi au navigateur. Dans le cas des zones de sortie uniquement, utilisez la variable &{FIELD.ID}.

La variable obsolète est &{FIELD}.

&{FIELD.ID}
Cette variable représente un ID zone HTML (l1_REC1$FIELD1, par exemple). Elle concerne les zones d'entrée et de sortie.

La variable obsolète est &{FIELD}.

&{RECORD.FIELD.REF}
Cette variable représente une référence à un objet zone HTML figurant dans l'enregistrement précisé. Elle concerne uniquement les zones d'entrée. Dans le cas des zones de sortie uniquement, utilisez la variable &{RECORD.FIELD.ID}.

La variable obsolète est &{RECORD.FIELD}.

&{RECORD.FIELD.ID}
Cette variable représente un ID zone HTML figurant dans l'enregistrement spécifié. Elle concerne les zones d'entrée et de sortie.

La variable obsolète est &{RECORD.FIELD}.

&{WEBFACINGFORMID}
Cette variable représente la valeur de l'attribut ID du formulaire HTML, qui regroupe toutes les zones. Elle peut être utilisée dans le cas du code JavaScript personnalisé.

Utilisation de valeurs spéciales

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 :

&{*SYSNAME}
Cette valeur permet d'insérer le nom du système sur lequel l'application s'exécute. Elle ne concerne que la zone SYSNAME.

La valeur obsolète était &SystemName.

&{*USER}
Cette valeur permet d'insérer l'ID de l'utilisateur actuel. Elle ne concerne que la zone USER.

La valeur obsolète était &UserID.

&{*DATE}
Cette valeur permet d'insérer la date système actuelle. Elle ne concerne que la zone DATE.

La valeur obsolète était &Date.

&{*TIME}
Cette valeur permet d'insérer l'heure actuelle du système. Elle ne concerne que la zone TIME.

La valeur obsolète était &Time.