Composant Web Table

Le composant Web vous permet de construire une table contenant plusieurs colonnes, elles-mêmes composées de plusieurs composants Web. Ces derniers peuvent être mappés vers les paramètres d'entrée et de sortie du programme définis dans l'assistant d'interaction Web.

Le composant Web Table peut également être utilisé avec un programme de service sur l'hôte pour afficher une liste d'enregistrements provenant d'une base de données IBM® i. Pour plus d'informations sur l'utilisation de cette option, consultez la section Onglet Paramètres. Reportez-vous aux références connexes en bas de cette rubrique pour savoir comment accéder aux enregistrements de base de données et utiliser des API de sous-fichier.

Onglet Général (iwcl:WTable)

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.
Etat initial
L'attribut Masqué indique que le composant Web n'est pas visible sur la page.
Orientation
Sélectionnez la valeur de votre choix pour définir le sens de lecture du texte et l'alignement du composant Web sur la page. Les valeurs possibles sont les suivantes : Par défaut, Droite à gauche et Gauche à droite.
Par défaut
Indique que le sens de lecture du texte et l'alignement du composant Web sur la page sont hérités de l'élément contenant.

Par exemple, si le composant Web est inséré dans un formulaire et que le sens de lecture sélectionné pour ce formulaire est Droite à gauche, ce sens s'applique également au composant Web.

La valeur par défaut est Gauche à droite.

Droite à gauche
Indique que le texte doit être lu de droite à gauche et que le composant Web est aligné à droite sur la page. Cette valeur remplace la valeur héritée.
Remarque : Si vous utilisez Droite à gauche alors que le formatage Code d'édition ou Mot d'édition est spécifié pour le composant, les nombres ne seront pas affichés correctement. Pour obtenir un affichage correct, spécifiez un alignement horizontal à droite dans la zone Présentation du texte du style interne.
Gauche à droite
Indique que le texte doit être lu de gauche à droite et que le composant Web est aligné à gauche sur la page. Cette valeur remplace la valeur héritée.
Récapitulatif
Entrez la description qui apparaîtra si le navigateur ne parvient pas à afficher la table.
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.
Mode de sélection
Les options disponibles sont Aucun, Simple et Multiple.
Aucune
Indique que la table ne comporte ni colonne Sélection, ni case à cocher ou bouton d'option.
Simple
Indique que la table comporte une colonne Sélection contenant des boutons d'option. Ces boutons vous permettent de sélectionner un enregistrement. Lorsque vous utilisez cette option, la ligne sélectionnée apparaît en surbrillance.
Multiple
Indique que la table comporte une colonne Sélection contenant des cases à cocher. Ces cases vous permettent de sélectionner plusieurs enregistrements. Lorsque vous utilisez cette option, les lignes sélectionnées apparaissent en surbrillance.
Formatage
Utilisez cette zone pour définir la manière dont le formatage doit être appliqué aux données du composant Web.
Obtenir des valeurs d'environnement local à partir des
Indique comment le symbole décimal, le symbole monétaire, le séparateur de milliers et le séparateur de date sont appliqués.
  • Lorsque vous sélectionnez valeurs du système hôte, les valeurs du symbole décimal, du symbole monétaire, du séparateur de milliers et du séparateur de date sont extraites du travail hôte. La valeur du symbole monétaire est extraite de la valeur du système hôte QCURSYM.
  • Lorsque vous sélectionnez valeurs de l'environnement local du client, les valeurs du symbole décimal, du symbole monétaire, du séparateur de milliers et du séparateur de date sont extraites de l'environnement local du navigateur Web lors de l'exécution.
  • Lorsque vous sélectionnez valeurs définies par l'utilisateur, les valeurs du symbole décimal, du symbole monétaire, du séparateur de milliers et du séparateur de date peuvent être modifiées. Les valeurs par défaut du symbole décimal, du symbole monétaire et du séparateur de milliers sont extraites de l'environnement local du système client lors de la conception. La valeur par défaut du séparateur de date est "/".

Onglet Paramètres

Extraction des données de table à partir d'un programme de service IBM i
Sélectionnez cette option si le composant Web Table est destiné à être utilisé avec un programme de service sur un hôte IBM i. Lorsqu'elle est sélectionnée, les autres options de la page demeurent disponibles pour la sélection et la saisie.
Bibliothèque
Entrez le nom de la bibliothèque contenant le programme de service avec lequel le composant Web Table interagit.
Objet
Entrez le nom du programme de service compilé avec lequel le composant Web Table interagit.
Comportement du programme de service
Sélectionnez cette option pour indiquer le mode d'affichage dans la table des enregistrements lus dans la base de données.
Ecrit une page à la fois
Il s'agit de la valeur par défaut. Il indique que le programme de service efface l'espace utilisateur lorsque les procédures PGUP et PGDN sont appelées. Les procédures INIT, PGUP et PGDN doivent être codées dans le programme de service. Cette option indique également que la section de pied de page affiche uniquement les boutons Haut de Page et Bas de Page.
Ecrit une page à la demande
Indique que le programme de service n'effacera pas l'espace utilisateur à chaque appel de la procédure PGDN. Cette option requiert que les procédures INIT et PGDN soient codées dans le programme de service. La section de pied de page affiche uniquement les boutons Haut de Page et Bas de Page.
Ecrit un sous-fichier entier
Indique qu'une section de pied de page est affichée dans la table pour des raisons de pagination. Les boutons Haut de Page et Bas de Page, ainsi que les informations de pagination, apparaissent dans ce pied de page sous la forme "page x sur y" (Page 5 sur 10, par exemple.) Cette option indique également que ces enregistrements représentent l'ensemble d'enregistrements qui apparaîtra dans la table, quel que soit le nombre d'enregistrements lus dans l'espace utilisateur pour être affichés dans la table. Cette option requiert également le codage de la procédure INIT dans le programme de service. Les procédures PGUP et PGDN ne sont pas requises, étant donné qu'elles ne sont pas appelées dans ce cas.
Paramètres du programme de service
Les paramètres du programme de service définis à ce niveau sont transmis aux procédures INIT, PGUP et PGDN du programme de service spécifié. Les procédures acceptent jusqu'à deux paramètres : le premier correspond au nom du sous-fichier et le deuxième à la structure de données recevant les paramètres définis ici. Les zones définies dans la structure doivent correspondre aux paramètres définis ici.
Ajouter
Cliquez sur Ajouter chaque fois que vous souhaitez entrer des données pour la définition des paramètres du programme de service.
Nom
Indiquez un identificateur unique pour le paramètre du programme de service. Le nom ne doit comprendre ni blancs ni traits d'union. Le nom du paramètre doit correspondre à une variable de session correcte qui contient la valeur du paramètre.
Type de données
Cliquez dans la zone pour activer un bouton de menu. Il permet d'afficher la liste des types de données disponibles. Les types acceptés sont Caractère, Décimal condensé et Décimal étendu.
Longueur
Indiquez la valeur de la longueur du paramètre.
Décimal
Pour les types de données Décimal condensé ou Décimal étendu, indiquez le nombre de positions décimales.
Supprimer
Cliquez sur Supprimer pour supprimer le paramètre du programme de service sélectionné.
Haut
Cliquez sur Haut pour modifier l'ordre du paramètre de programme de service sélectionné.
Bas
Cliquez sur Bas pour modifier l'ordre du paramètre de programme de service sélectionné.

Onglet Fonctions

Afficher barre d'outils
Cette option, sélectionnée par défaut, fait apparaître dans la table une zone de barre d'outils. Elle active également les options suivantes pour le contenu de la barre d'outils :
Activer la réduction ou le développement des lignes de la table
Icône de la barre d'outils permettant de réduire ou d'étendre les lignes de la table
Activer le tri
Icône de la barre d'outils permettant le tri des données contenues dans trois colonnes maximum
Activer le filtrage
Icône de la barre d'outils permettant le filtrage hors lignes conformément aux indications de l'utilisateur
Afficher ligne de filtre
Cette option est disponible lorsque l'option Activer le filtre est sélectionnée. Elle indique les lignes filtrées dans le tableau.
Afficher en-tête
Cette option est sélectionnée par défaut. Lorsqu'elle est sélectionnée, une ligne d'en-tête contenant les en-têtes de colonne apparaît en haut de la table.
Afficher bas de page
Cette option est sélectionnée par défaut. Lorsqu'elle est sélectionnée, une ligne de pied de page apparaît au bas de la table pour les commandes de la page suivante et de la page précédente. Vous devez sélectionner cette option si une pagination est requise.
Activer la pagination
Sélectionnez cette option pour autoriser la pagination de la table. Des icônes Page précédente et Page suivante sont ajoutées dans la zone de bas de page de la table. La sélection de cette option entraîne l'activation des options Page initiale et Lignes par page.
Page initiale
Indiquez quelle page de la table (hormis la première page) vous souhaitez afficher au départ.
Lignes par page
Indiquez le nombre de lignes visibles pour l'utilisateur sur chaque page de la table.
Afficher le quadrillage
Cette option est sélectionnée par défaut. Lorsqu'elle est sélectionnée, les bordures des lignes et des colonnes deviennent visibles sur la table.

Onglet Colonnes

Ajouter
Cliquez sur Ajouter chaque fois que vous souhaitez entrer des données pour la définition d'attributs d'une colonne de la table.
Nom
Indiquez un identificateur unique pour la colonne de table. Le nom ne doit comprendre ni blancs ni traits d'union.
Longueur
Indiquez la longueur des données contenues dans cette colonne de table.
Texte d'en-tête
Indique la description de texte qui apparaît en en-tête de colonne dans la table.
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.
Fonctions
Cliquez dans la zone pour activer un bouton de menu. Il permet d'ouvrir la fenêtre Fonctions de colonnes. Cette fenêtre permet d'indiquer si la colonne est visible, si un tri ou un filtre peuvent lui être appliqués et de spécifier l'orientation des composants Web dans la colonne.
Type
Cliquez dans la zone pour activer un bouton de menu. Il permet d'afficher la liste des composants Web que vous pouvez sélectionner pour la colonne de table. Vous pouvez sélectionner les composants Web suivants :
Propriétés
Cliquez dans la zone pour activer un bouton de menu. Il permet d'ouvrir la fenêtre Propriétés de colonne. Cette fenêtre permet d'indiquer les propriétés des composants Web sélectionnés dans Type.
Style de l'en-tête
Cliquez dans la zone pour activer un bouton de menu. Il permet d'ouvrir la fenêtre Style de l'en-tête de colonne. Cette fenêtre permet d'indiquer le style de l'en-tête de colonne.
Style de données
Cliquez dans la zone pour activer un bouton de menu. Cliquez sur le bouton qui permet d'ouvrir la fenêtre Style de données des colonnes. Cette fenêtre permet d'indiquer le style des données des colonnes. Le style spécifié ici remplace celui défini dans l'onglet Styles. Si aucun style n'est spécifié ici, le style défini dans l'onglet Styles est utilisé.
Supprimer
Cliquez sur Supprimer pour supprimer les données sélectionnées pour la colonne de table.
Haut
Cliquez sur Haut pour modifier l'ordre de la colonne sélectionnée dans la table.
Bas
Cliquez sur Bas pour modifier l'ordre de la colonne sélectionnée dans la table.

Onglet Styles

L'onglet Styles propose des styles internes pour le composant Web IBM i. Les styles internes spécifiés ici sont applicables uniquement au corps du composant Web Table.
Style interne
Cliquez sur les boutons Polices, Styles de polices, Arrière-plan et Présentation 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.

Commentaires en retour