DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Table / Table fichier
  • Présentation
  • Notes
  • Limites pour Android
  • Limites pour iOS
  • Table fichier à accès direct et Table fichier chargé en mémoire
  • Types de champs Table fichier
  • Limitation Java : Saisie en cascade
  • Synchronisation automatique (données HFSQL Client/Serveur)
  • Visualisation automatique des enregistrements reliés
  • Mise en place via l'éditeur de fenêtres (mode automatique)
  • Mise en place via l'éditeur de fenêtres (mode personnalisé)
  • Mise en place par programmation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Un champ Table fichier est un champ dont les colonnes sont reliées à des rubriques d'un fichier de données ou d'une requête (source de données). Chaque colonne du champ Table peut être :
  • Liée à une rubrique de la source de données.
  • Liée à une rubrique d'un fichier relié à la source de données.
  • Calculée : Si la colonne n'est pas reliée à une rubrique d'un fichier, c'est une colonne calculée. Pour les colonnes calculées, le contenu de la colonne est re-calculé à chaque affichage de ligne, il n'est pas mémorisé.
Chaque ligne du champ Table correspond à un enregistrement de la source de données.
Un champ Table fichier permet de :
  • Visualiser le contenu d'un fichier de données (ou d'une requête) à raison d'un enregistrement par ligne et de sélectionner un enregistrement (visualisation de tout le fichier ou d'une sélection d'enregistrements sélectionnés selon un filtre).
  • WINDEV Visualiser le contenu des enregistrements liés (par exemple, visualiser les lignes de commandes associées à une commande affichée dans le champ Table).
  • Supprimer un enregistrement en supprimant une ligne dans le champ Table.
  • Modifier un enregistrement en modifiant le contenu d'une ligne du champ Table.
  • Ajouter un enregistrement en saisissant une ligne dans le champ Table.
  • WINDEVHFSQL Client/Serveur Rafraîchir automatiquement les données modifiées depuis un autre poste.
Le nombre d'enregistrements pouvant être visualisés est illimité, seules les lignes visibles du champ Table sont chargées en mémoire.
WEBDEV - Code Serveur Remarque : Lors de la création d'un champ Table fichier non Ajax, une réglette est automatiquement associée à ce champ. Cette réglette permet d'afficher les différents enregistrements du champ Table.

Notes

  • Les champs Table fichier sont essentiellement utilisés pour visualiser des données. Pour saisir des données, utilisez des champs de saisie.
  • La ligne sélectionnée dans le champ Table correspond à l'enregistrement en cours dans le fichier de données. S'il y a changement de ligne dans le champ Table, l'enregistrement en cours dans le fichier de données est automatiquement modifié.
Android

Limites pour Android

iPhone/iPad

Limites pour iOS

Les champs Table sont disponibles uniquement en visualisation : la saisie n'est pas disponible dans cette version.
Table fichier à accès direct et Table fichier chargé en mémoire
WINDEVWEBDEV - Code ServeurAndroidiPhone/iPadJava

Types de champs Table fichier

Deux types de champs Table fichier sont disponibles :
  • Les champs Table fichier basés sur le fichier en accès direct. Ce sont les champs Table fichier "classiques".
  • Les champs Table fichier basés sur un fichier chargé en mémoire. Seul un nombre spécifique d'enregistrements du fichier (défini sous l'éditeur) est chargé en mémoire. Ces champs Table fichier permettent notamment de réaliser des tris et des recherches sur n'importe quelle colonne.
    Android Il n'est pas possible de définir le nombre d'enregistrements chargés en mémoire.
Pour plus de détails sur ces deux types de champs Table fichier, consultez le Comparatif des fonctionnalités des champs Table.
Java

Limitation Java : Saisie en cascade

En Java, la saisie en cascade n'est pas disponible sur les champs Table fichier à accès direct. La saisie en cascade est disponible uniquement pour les champs Table fichier chargé en mémoire.
WINDEV
Synchronisation automatique (données HFSQL Client/Serveur)
Un champ Table fichier peut se rafraîchir automatiquement, dès que le fichier de données HFSQL Client/Serveur associé est modifié. Cette fonctionnalité peut être mise en place :
  • sous l'éditeur :
    1. Affichez la fenêtre de description du champ Table fichier.
    2. Dans l'onglet "Contenu", sélectionnez le mode de synchronisation de l'affichage :
      Synchroniser l'affichage
      • Jamais : Aucune synchronisation n'est effectuée (cas par défaut).
      • Modification seulement : La synchronisation est effectuée uniquement lors de la modification d'un enregistrement.
      • Ajout/Suppression seulement : La synchronisation est effectuée uniquement lors de l'ajout ou de la suppression d'un enregistrement.
      • Toujours : La synchronisation est effectuée dès qu'une opération d'écriture ou de suppression est effectuée dans le fichier de données.
    3. Validez.
  • par programmation : via la propriété SynchroHFSQL utilisable sur le champ Table fichier.
La synchronisation automatique s'applique :
  • entre les différentes instances d'une même application sur un poste ou différents postes,
  • entre différentes applications sur un poste ou différents postes,
  • entre les différentes fenêtres d'une même application, que le contexte HFSQL soit le même ou non entre les fenêtres.
Attention : L'activation de cette fonctionnalité augmente la charge du serveur lors de l'affichage du champ Table ou lors des déplacements dans le champ.
WINDEV
Visualisation automatique des enregistrements reliés
Dans un champ Table fichier, il est possible de dérouler une ligne pour voir les enregistrements d'autres fichiers de données, reliés à la ligne sélectionnée.
Exemple :
Enregistrements liés

Mise en place via l'éditeur de fenêtres (mode automatique)

Pour permettre à l'utilisateur de dérouler les lignes d'un champ Table fichier pour visualiser les enregistrements liés :
  1. Affichez la fenêtre de description du champ Table fichier.
  2. Dans l'onglet "Contenu", cochez l'option "Afficher un [ + ] de détail d'une ligne".
    Afficher un détail
    La fenêtre de paramétrage s'affiche automatiquement.
  3. Dans la fenêtre de paramétrage :
    Enregistrements liés automatiquement
    • Cochez si nécessaire l'option "Activer l'affichage des données reliées".
    • Sélectionnez le mode d'affichage "Automatique". Avec ce mode, tous les fichiers de données reliés sont proposés à l'utilisateur.
    • Validez.
  4. Validez la fenêtre de description du champ Table.
Lors de l'exécution du champ Table, l'utilisateur dispose d'un menu contextuel permettant d'afficher les différentes données liées au fichier de données actuellement affiché dans le champ Table fichier.
Enregistrements liés
Enregistrements liés
Remarque : l'image du "+" affiché en début de ligne peut être personnalisée :
  1. Affichez la fenêtre de description du champ Table fichier.
  2. Dans l'onglet "Style" :
    • Sélectionnez l'élément "Image [+]/[-] FI de détails de ligne".
    • Cliquez sur le bouton "Image Plus/Moins de la Fenêtre Interne de détails".
    • Sélectionnez l'image correspondant au bouton et validez.

Mise en place via l'éditeur de fenêtres (mode personnalisé)

Pour permettre à l'utilisateur de dérouler les lignes d'un champ Table fichier pour visualiser les enregistrements liés :
  1. Affichez la fenêtre de description du champ Table fichier.
  2. Dans l'onglet "Contenu", cochez l'option "Afficher un [ + ] de détail d'une ligne". La fenêtre de paramétrage s'affiche automatiquement.
  3. Dans la fenêtre de paramétrage :
    • Cochez si nécessaire l'option "Activer l'affichage des données reliées".
    • Sélectionnez le mode d'affichage "Manuel". Avec ce mode, seules les données d'un fichier de données sont proposées à l'utilisateur. Il est possible de personnaliser les données affichées.
    • Sélectionnez la rubrique source, présente dans le fichier affiché par le champ Table.
    • Sélectionnez la rubrique liée, présente dans le fichier de données lié.
    • Sélectionnez les rubriques à afficher dans la table de visualisation des données liées. Les boutons et permettent de gérer les données à afficher.
      Sélection détail d'une ligne
    • Validez.
  4. Validez la fenêtre de description du champ Table.
Lors de l'exécution du champ Table, l'utilisateur dispose d'un signe "+" pour afficher les données liées au fichier de données actuellement affiché dans le champ Table fichier.
Aperçu détail
Remarque : l'image du "+" affiché en début de ligne peut être personnalisée :
  1. Affichez la fenêtre de description du champ Table fichier.
  2. Dans l'onglet "Style" :
    • Sélectionnez l'élément "Image [+]/[-] FI de détails de ligne".
    • Cliquez sur le bouton "Image Plus/Moins de la Fenêtre Interne de détails".
    • Sélectionnez l'image correspondant au bouton et validez.

Mise en place par programmation

Pour permettre à l'utilisateur de dérouler les lignes d'un champ Table fichier pour visualiser les enregistrements liés :
  1. Créez un champ Table fichier basé sur un fichier de données ou une requête.
  2. Dans le code d'initialisation du champ Table, utilisez la propriété LiaisonsDétailLigne.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale