4D Doc Center : TABLEAU VERS LISTE

4D v14.3

TABLEAU VERS LISTE


TABLEAU VERS LISTE ( tableau ; liste {; réfEléments} )

Paramètre	Type	Description
tableau	Tableau	Tableau duquel copier les éléments
liste	Chaîne, RefListe	Nom ou référence de la liste dans laquelle copier les éléments du tableau
réfEléments	Tableau	Tableau numérique des numéros de référence des éléments

Description

La commande TABLEAU VERS LISTE crée ou remplace la liste hiérarchique ou l'énumération liste en utilisant les éléments du tableau tableau.

Vous pouvez passer dans le paramètre liste soit un nom d'énumération (une chaîne) soit une référence de liste hiérarchique (RefListe). Dans ce deuxième cas, la liste doit déjà avoir été créée (par exemple via la commande Nouvelle liste) pour que la commande fonctionne.

Le paramètre optionnel réfEléments, s'il est passé, doit être un tableau de type numérique synchronisé avec le tableau tableau. Chaque élément de ce tableau indique le numéro de référence de l'élément de la liste correspondant dans tableau. Si ce paramètre est omis, 4D affecte automatiquement aux éléments de la liste les numéros de référence 1, 2... N.

Note de compatibilité : La commande TABLEAU VERS LISTE doit être utilisée avec précaution du fait des limitations suivantes :

cette commande permet de définir seulement les éléments du premier niveau de la liste.
lorsque vous l'utilisez avec une énumération, cette commande modifie la structure de l'application (les énumérations sont stockées dans le fichier de structure), les modifications effectuées en local seront donc perdues lors de mise à jour du fichier de structure en production.
cette commande ne peut pas être utilisée dans un composant avec une énumération car les composants sont chargés avec la structure en lecture seulement.

Vous pouvez utiliser TABLEAU VERS LISTE pour construire une liste basée sur les éléments d'un tableau. Cependant, pour vous affranchir de ces contraintes et exploiter pleinement les listes de valeurs, il est conseillé d'utiliser les commandes du thème Listes hiérarchiques.

Exemple

L'exemple suivant copie le tableau tabRégions dans l'énumération "Régions" :

TABLEAU VERS LISTE(tabRégions;"Régions")

Exemple

Vous souhaitez placer les valeurs distinctes d’un champ dans une liste, par exemple pour créer un pop up menu hiérarchique. Vous pouvez écrire :

 TOUT SELECTIONNER([Company])

 VALEURS DISTINCTES([Company]country;$tabPays)

 listePays:=Nouvelle liste

 TABLEAU VERS LISTE($tabPays;listePays)

Gestion des erreurs

La commande TABLEAU VERS LISTE génère l'erreur -9957 lorsqu'elle est appliquée à une énumération en cours de modification en mode Développement. Vous pouvez intercepter cette erreur à l'aide d'une méthode projet de gestion des erreurs installée par la commande APPELER SUR ERREUR.