PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Comment le faire ?
  • Créer un champ Table hiérarchique fichier
  • Créer un champ de type Table hiérarchique fichier
  • Définir les sources du champ Table hiérarchique fichier
  • Définir les liaisons des différentes colonnes du champ Table hiérarchique fichier
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Le champ Table hiérarchique Fichier
Présentation
Un champ Table hiérarchique fichier est une table hiérarchique liée à un fichier de données ou à une requête. Dans ce cas, la table hiérarchique ne peut être liée qu'à un fichier de données ou une requête chargée en mémoire.
Versions 18 et supérieures
WEBDEV - Code ServeurWindowsLinux Le champ Table hiérarchique est désormais disponible pour les sites WEBDEV.
PHP Le champ Table hiérarchique est désormais disponible pour les sites PHP.
Nouveauté 18
WEBDEV - Code ServeurWindowsLinux Le champ Table hiérarchique est désormais disponible pour les sites WEBDEV.
PHP Le champ Table hiérarchique est désormais disponible pour les sites PHP.
WEBDEV - Code ServeurWindowsLinux Le champ Table hiérarchique est désormais disponible pour les sites WEBDEV.
PHP Le champ Table hiérarchique est désormais disponible pour les sites PHP.
Comment le faire ?
WINDEVWINDEV Mobile

Créer un champ Table hiérarchique fichier

Pour créer un champ de type Table hiérarchique fichier :
  1. Sous l'éditeur de fenêtres, cliquez sur l'icône (ou sélectionnez l'option "Insertion .. Champ .. Table hiérarchique").Dans le ruban :
    • WINDEV Sous le volet "Création", dans le groupe "Données", déroulez "Table et liste" et sélectionnez "Table hiérarchique".
    • WINDEV Mobile Sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table hiérarchique".
  2. Cliquez dans la fenêtre à la position où le champ doit être créé.
  3. Affichez l'onglet "Contenu" de la fenêtre de description du champ Table.
    Onglet Contenu du champ Table hiérarchique
    Cet onglet permet de définir les différentes sources de la table hiérarchique. En effet, une table hiérarchique fichier est liée à différentes sources, permettant d'afficher des enregistrements imbriqués.
    Sélectionnez le mode de remplissage "Fichier/Requête".
  4. Définissez si nécessaire les liaisons des différentes colonnes de la table hiérarchique.
Versions 19 et supérieures
WINDEV Option "Remplissage différé des sous-niveaux"
Lorsque un champ Table hiérarchique fichier comporte de nombreux éléments et sous-éléments, son remplissage complet peut être long.
L'option "Remplissage différé des sous-niveaux" permet de remplir chaque sous-niveau uniquement lorsque l'utilisateur clique pour dérouler un niveau. Dans ce cas, la durée de remplissage est répartie et le remplissage initial est beaucoup plus rapide.
Note : Pour utiliser cette option sur un champ Table hiérarchique rempli par programmation, utilisez la propriété ..AjouteFilsDifféré.
Nouveauté 19
WINDEV Option "Remplissage différé des sous-niveaux"
Lorsque un champ Table hiérarchique fichier comporte de nombreux éléments et sous-éléments, son remplissage complet peut être long.
L'option "Remplissage différé des sous-niveaux" permet de remplir chaque sous-niveau uniquement lorsque l'utilisateur clique pour dérouler un niveau. Dans ce cas, la durée de remplissage est répartie et le remplissage initial est beaucoup plus rapide.
Note : Pour utiliser cette option sur un champ Table hiérarchique rempli par programmation, utilisez la propriété ..AjouteFilsDifféré.
WINDEV Option "Remplissage différé des sous-niveaux"
Lorsque un champ Table hiérarchique fichier comporte de nombreux éléments et sous-éléments, son remplissage complet peut être long.
L'option "Remplissage différé des sous-niveaux" permet de remplir chaque sous-niveau uniquement lorsque l'utilisateur clique pour dérouler un niveau. Dans ce cas, la durée de remplissage est répartie et le remplissage initial est beaucoup plus rapide.
Note : Pour utiliser cette option sur un champ Table hiérarchique rempli par programmation, utilisez la propriété ..AjouteFilsDifféré.
Versions 18 et supérieures
WEBDEV - Code Serveur

Créer un champ de type Table hiérarchique fichier

Pour créer un champ de type Table hiérarchique fichier :
  1. Sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table hiérarchique".
  2. L'assistant de création d'une table hiérarchique se lance.
  3. Dans l'assistant, sélectionnez l'option "Afficher les données d'un fichier ou d'une requête existante". Passez à l'étape suivante.
  4. Définissez les différentes sources de la table hiérarchique. En effet, une table hiérarchique fichier est liée à différentes sources, permettant d'afficher des enregistrements imbriqués.
    Sources de l'arborescence (assistant de création du champ)
Remarque : Si vous ne renseignez pas ces informations dans l'assistant, ces données pourront être modifiées dans l'onglet "Contenu" du champ.
Nouveauté 18
WEBDEV - Code Serveur

Créer un champ de type Table hiérarchique fichier

Pour créer un champ de type Table hiérarchique fichier :
  1. Sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table hiérarchique".
  2. L'assistant de création d'une table hiérarchique se lance.
  3. Dans l'assistant, sélectionnez l'option "Afficher les données d'un fichier ou d'une requête existante". Passez à l'étape suivante.
  4. Définissez les différentes sources de la table hiérarchique. En effet, une table hiérarchique fichier est liée à différentes sources, permettant d'afficher des enregistrements imbriqués.
    Sources de l'arborescence (assistant de création du champ)
Remarque : Si vous ne renseignez pas ces informations dans l'assistant, ces données pourront être modifiées dans l'onglet "Contenu" du champ.
WEBDEV - Code Serveur

Créer un champ de type Table hiérarchique fichier

Pour créer un champ de type Table hiérarchique fichier :
  1. Sous le volet "Création", dans le groupe "Données", déroulez "Table" et sélectionnez "Table hiérarchique".
  2. L'assistant de création d'une table hiérarchique se lance.
  3. Dans l'assistant, sélectionnez l'option "Afficher les données d'un fichier ou d'une requête existante". Passez à l'étape suivante.
  4. Définissez les différentes sources de la table hiérarchique. En effet, une table hiérarchique fichier est liée à différentes sources, permettant d'afficher des enregistrements imbriqués.
    Sources de l'arborescence (assistant de création du champ)
Remarque : Si vous ne renseignez pas ces informations dans l'assistant, ces données pourront être modifiées dans l'onglet "Contenu" du champ.

Définir les sources du champ Table hiérarchique fichier

Pour définir les sources du champ Table hiérarchique fichier :
  1. Cliquez sur le bouton "Ajouter". Une source de type "<Aucun>" est automatiquement ajoutée.
  2. Définissez les caractéristiques de cette source :
    • Source : correspond au fichier de données ou à la requête qui va être parcourue.
    • Parcours : correspond à la clé de parcours utilisée pour parcourir la source.
    • Affichée : correspond à la rubrique affichée dans la première colonne du champ Table hiérarchique.
      WEBDEV - Code Serveur Remarque : Pour chaque niveau, il est possible de personnaliser l'image enroulée et déroulée affichée.
  3. Définissez si nécessaire la source de la liaison du niveau précédent. Par exemple, si le premier niveau parcourt le fichier Client, le second peut par exemple parcourir le fichier Commande. Les rubriques qui permettront la liaison sont "Client.IDClient" et "Commande.IDClient". Par défaut, la source de la liaison est automatiquement déduite des rubriques et des liaisons définies dans l'analyse.
  4. Définissez autant de sources que nécessaire.
La première colonne de la table hiérarchique affiche les données "Affichées" des différentes sources sélectionnées.
Cas particulier : Table hiérarchique fichier récursive
Une table hiérarchique fichier peut afficher des enregistrements dépendant de l'enregistrement précédent (cas classique d'une liaison récursive permettant par exemple de gérer les parents / enfants)
Exemple de table hiérarchique récursive
Pour gérer ce type de table hiérarchique, il est possible de définir une liaison réflexive dans l'onglet "Contenu" de la fenêtre de description du champ.
Les lignes de type "racine" sont associées à un enregistrement pour lequel la rubrique de liaison correspond à 0 ou vide (selon le type de la rubrique).

Définir les liaisons des différentes colonnes du champ Table hiérarchique fichier

Par défaut, la première colonne du champ Table hiérarchique fichier (colonne représentant la hiérarchie) affiche les éléments indiqués dans les sources (onglet "Contenu", valeur "Affiché" des différentes sources).
Le champ Table hiérarchique peut également afficher d'autres données dans ses autres colonnes.
Pour définir les liaisons des différentes colonnes :
  1. Créez si nécessaire une nouvelle colonne (bouton "Nouveau" de la fenêtre de description de la table hiérarchique) ou sélectionnez une colonne existante.
  2. Affichez l'onglet "Liaison" et définissez la liaison voulue. La liaison peut être :
    • mono-fichier : dans ce cas, la liaison concerne un des fichiers source de la table hiérarchique.
      Si une modification est réalisée dans les enregistrements affichés par la table hiérarchique, cette modification est automatiquement reportée dans le fichier de données associé.
    • multi-fichier : dans ce cas, la liaison peut être réalisée avec un des fichiers reliés à un des fichiers source.
      Si une modification est réalisée dans les enregistrements affichés par la table hiérarchique, cette modification ne sera pas automatiquement reportée dans le fichier de données associé. Il est nécessaire de le gérer par programmation.
  3. Validez.
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Liaison réflexive
Une petite information pour éviter de tourner en rond :

Lors du paramétrage de la liaison réflexive, la première combo correspond à la rubrique contenant l'identifiant parent de l'enfant, et la deuxième combo correspond à la rubrique de l'identifiant parent.

Exemple :
FichierReflex
--> rubrique IDReflex (deuxième combo)
--> rubrique IDParent (première combo)
--> rubrique N
lo²
11 mar. 2016