Composant Web Hyperlien

Le composant Web Hyperlien permet de créer un lien hypertexte à partir duquel vous pouvez ouvrir un autre fichier d'un simple clic.

Onglet Général (iwcl:WHyperlink)

Nom
Indiquez un identificateur unique pour le composant Web IBM® i. Le nom ne doit comprendre ni blancs ni traits d'union. Voir Règles concernant les valeurs et les noms des composants Web IBM i.
URL
Indiquez le chemin relatif ou absolu de la page Web qui s'affichera dans le navigateur. Pour savoir comment modifier l'URL de manière dynamique, reportez-vous à la description du délimiteur. Pour savoir comment utiliser des variables de substitution dans la zone URL, voir Utilisation de variables de substitution dans les composants Web Hyperlien.
La première partie de l'URL correspond au protocole, par exemple, http:. Il existe d'autres protocoles, comme ftp:, news:, mailto:. Vous pouvez utiliser le protocole mailto: pour appeler le client de messagerie sur le poste de travail de l'utilisateur. Par exemple, si vous avez renvoyé la valeur suivante dans le paramètre et que l'utilisateur a cliqué sur le lien, le client de messagerie par défaut démarrera avec une nouvelle fenêtre de courrier :
mailto:pierre@societe.com | Envoyer un courrier à Pierre
Par exemple, vous pouvez ajouter un paramètre "subject" à la zone préremplie d'objet du message :
mailto:pierre@societe.com?subject=Bonjour Pierre | Envoyer un courrier à Pierre
Citons, parmi les autres paramètres, body pour le texte du message, cc et bcc. Certains navigateurs ne prennent pas en charge ces paramètres supplémentaires. Vérifiez dans la documentation de votre navigateur. Si vous voulez inclure ces paramètres, vous devez les spécifier comme suit :
mailto:pierre@societe.com?subject=Bonjour Pierre&cc=Paul&body=Bonjour Pierre.
Texte
Entrez une description de texte qui s'affichera sur la page comme lien hypertexte. Par exemple, si l'URL est http://www.abc.com/, ce lien peut contenir le texte Cliquez ici pour ouvrir notre site Web. Pour savoir comment modifier du texte de manière dynamique, reportez-vous à la description du délimiteur. Pour savoir comment utiliser des variables de substitution dans la zone de texte, voir Utilisation de variables de substitution dans les composants Web Hyperlien.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Délimiteur
Entrez le caractère de séparation permettant d'identifier les descriptions d'URL et de texte renvoyées par le programme hôte. Le caractère par défaut est la barre verticale ('|'). Par exemple, si votre programme hôte renvoie un hyperlien du type http://www.ibm.com|Page d'accueil IBM, ne remplissez pas les zones d'attribut URL et Texte. Dans ce cas, la barre verticale de séparation est utilisée pour séparer l'URL du texte du lien. La partie texte correspond au lien sur lequel l'utilisateur clique dans la page. Si la partie texte de l'hyperlien n'a pas à être modifiée, spécifiez le texte dans la zone d'attribut Texte et votre programme hôte renverra la partie URL du lien (sans la barre verticale), par exemple http://www.ibm.com. Le cas échéant, l'URL renvoyée par le programme est associée à la description de texte spécifiée dans la zone d'attribut Texte. Dans le dernier exemple, si vous ne remplissez pas la zone d'attribut Texte, l'URL renvoyée par le programme hôte est également utilisée pour la description du texte.
Cible
Indiquez le mode d'affichage de la cible de l'hyperlien. Les valeurs possibles sont les suivantes : Nom, Nouvelle Fenêtre, Cadre identique, Cadre parent ou Plein écran. (Vous pouvez également entrer un nom dans la zone Cible pour spécifier le nom du cadre qui affichera la page cible de l'hyperlien).
Nouvelle fenêtre
Indique que la page cible apparaît dans une nouvelle fenêtre de navigateur.
Cadre identique
Indique que la page cible s'ouvre dans le même cadre que la page contenant l'hyperlien.
Cadre parent
Indique que la page cible s'ouvre dans l'ensemble de cadres parents.
Plein écran
Indique que la page cible s'ouvre dans le corps entier du navigateur.
Etat initial
Sélectionnez Désactivé ou Masqué.
Désactivé
Indique que le composant Web n'est pas disponible.
Masqué
Indique que le composant Web n'est pas visible sur la page.
Infobulle
Entrez la description qui s'affiche lorsque le pointeur de la souris se trouve au niveau du composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Clé d'accès
Associez un caractère à une touche de raccourci pour permettre à l'utilisateur d'activer le composant Web.
Indice de tabulation
Entrez un numéro correspondant à l'ordre de tabulation du composant Web créé. Par exemple, la valeur 1 signifie que ce composant Web est le premier objet à être activé dans la séquence de tabulation.

Onglet Evénements

Evénements
Dans la liste, choisissez un événement et utilisez le langage JavaScript™ pour coder l'action correspondante dans la zone Script. Par exemple, si vous sélectionnez OnBlur, vous pouvez coder le script alert ("non applicable"). Pour obtenir une brève description des événements qui s'appliquent à ce composant Web, voir Evénements du composant Web.

Onglet Styles

L'onglet Styles propose des styles internes pour le composant Web IBM i.
Style interne
Cliquez sur les boutons Polices, Styles de polices, Couleur d'arrière-plan et Présentation du texte pour ouvrir les fenêtres de définition de style respectives. Dans chaque fenêtre, sélectionnez les options que vous souhaitez appliquer au composant Web IBM i.

Utilisation de variables de substitution dans les composants Web Hyperlien

Vous pouvez utiliser le composant Web Hyperlien seul ou l'intégrer à un composant Web Table. Dans les deux cas, vous pouvez coder les variables de substitution des zones URL et Texte.

Si vous utilisez ce composant Web seul, vous devez indiquer la variable entre accolades dans les zones Texte et URL statiques. La variable correspond au nom du composant Web. Comme indiqué dans l'image suivante, le composant Web est baptisé HYPERLINK1. Par conséquent, la variable de substitution est également appelée HYPERLINK1.

Si les zones URL ou Texte statiques comprennent une variable, le système génère l'URL et le texte au stade de l'exécution en remplaçant la variable de substitution par la valeur renvoyée par le programme hôte. La valeur renvoyée par le programme hôte peut posséder une partie URL et une partie libellé sous la forme url | libellé. Le délimiteur permet de distinguer l'URL du libellé. Par exemple, la variable de substitution de l'URL statique est remplacée par la partie URL de la valeur renvoyée par le programme hôte si cette dernière est http://www.ibm.com | Lien vers IBM. De même, la variable de substitution du texte statique est remplacée par la partie libellé de la valeur renvoyée par le programme hôte.

Prenons un autre exemple pour illustrer le remplacement d'une variable dans les zones URL et Texte d'un hyperlien. Supposons que l'hyperlien d'une page affiche le nom du responsable d'un employé. Dans ce cas, le nom de l'hyperlien est lienresponsable et l'URL est getperson.do?personid={lienresponsable}. La zone Texte est définie sous la forme {lienresponsable}. Le composant Web Hyperlien est mappé sur une zone de sortie dans le programme hôte. Si le programme renvoie la valeur 1085 | Doe, John, la partie URL du lien est 1085 et la partie libellé est Doe, John. Lorsque la page s'affiche, le texte Doe, John apparaît en tant que libellé et la variable {lienresponsable} de la zone URL est remplacée par 1085. La valeur URL du lien est donc getperson.do?personid=1085. Le système affiche les informations relatives au responsable dès que l'utilisateur clique sur le lien.

Vous pouvez également intégrer des composants Web Hyperlien à un composant Web Table en définissant le type de colonne sur Hyperlien.

Si vous cliquez sur le bouton de la colonne Propriétés, le système affiche la boîte de dialogue Propriétés de colonne permettant d'entrer le texte et l'URL statiques. Vous pouvez également inclure des variables de substitution incluses entre accolades, par exemple http://www.{col1}.ibm.{col2}.com.

Dans cet exemple, les variables de substitution col1 et col2 correspondent à des noms de colonne corrects affectés au composant Web Table. Au stade de l'exécution, les variables de substitution sont remplacées par les données de la colonne spécifiée. Seules les données de la colonne spécifiée sont utilisées. Par exemple, les données de la colonne sont renvoyées dans une matrice name:value:true|false si la colonne de table spécifiée est un composant Web Zone de liste. Utilisées en l'état, les données ne sont pas analysées pour extraire un format spécial. Si la variable de substitution désigne une colonne correspondant à une zone d'hyperlien, la valeur utilisée pour remplacer la variable de substitution dépend toutefois de l'emplacement où la variable de substitution est définie. Si la variable est définie dans la zone URL statique, elle est remplacée par la partie URL de la valeur renvoyée par le programme hôte. Sinon, la variable de substitution est remplacée par la partie texte de la valeur renvoyée par le programme hôte.

Dans l'exemple suivant, vous pouvez utiliser des valeurs de substitution dans un composant Web Hyperlien qui est utilisé dans un sous-fichier.

La colonne Nom désigne un hyperlien et la colonne ID est masquée. Le sous-fichier est conçu de telle sorte que si un utilisateur clique sur un nom de la colonne Nom du sous-fichier, l'ID masqué associé au nom est transmis à une fonction JavaScript. Dans le sous-fichier, les colonnes sont définies comme suit :

Attributs du sous-fichier figurant sur la page JSP.
Les propriétés hyperlien de la colonne Nom incluent la fonction JavaScript de la zone URL illustrée :
Boîte de dialogue Propriétés de colonne affichant l'URL et le texte du lien utilisé dans la colonne Nom.
Les valeurs entre accolades correspondent aux noms des colonnes du sous-fichier. Les valeurs de la boîte de dialogue indiquent que le texte du lien de la colonne Nom correspond à la valeur de la colonne Nom. L'URL du lien appelle la fonction JavaScript getperson, qui transmet la valeur de la colonne hid masquée.


Commentaires en retour