4D Doc Center : SELECTION VERS TABLEAU

4D v12.4

SELECTION VERS TABLEAU


SELECTION VERS TABLEAU ( leChamp \| laTable ; tableau {; leChamp ; tableau} {; leChamp2 ; tableau2 ; ... ; leChampN ; tableauN} )

Paramètre	Type	Description
leChamp \| laTable	Champ, Table	Champ à récupérer dans le tableau ou Table dont les numéros d'enregistrements sont à récupérer dans le tableau
tableau	Tableau	Tableau recevant les valeurs des champs ou les numéros d'enregistrements
leChamp	Champ	Champ à récupérer dans le tableau
tableau	Tableau	Tableau recevant les valeurs du champ

Description

La commande SELECTION VERS TABLEAU crée un ou plusieurs tableau(x) et y copie les valeurs des champ(s) ou les numéros d'enregistrement(s) de la sélection courante.

SELECTION VERS TABLEAU s'applique à la sélection courante de la table désignée par le premier paramètre (nom de table ou nom de champ). La commande peut réaliser les opérations suivantes :

Charger les valeurs d'un ou plusieurs champs,
Charger les numéros des enregistrements de la table, à l'aide de la syntaxe [table];tableau
Charger des valeurs de champs liés, s'il existe un lien automatique de N vers 1 entre les tables, ou si vous avez préalablement appelé la commande FIXER LIENS AUTOMATIQUES pour rendre automatiques les liens manuels N vers 1 (dans les deux cas, les valeurs peuvent être chargées à travers plusieurs niveaux de liens N vers 1 entre les tables).

Chaque tableau est typé en fonction du type de champ. Il y a cependant deux exceptions :

La copie d'un champ de type Heure provoquera la création d'un tableau Entier long.
En mode compatibilité ASCII (non Unicode), lorsqu'un champ de type Texte est copié dans un tableau Alpha, le tableau reste de type Alpha.

Si vous chargez les numéros des enregistrements, ils sont copiés dans un tableau de type Entier long.

4D Server : La commande SELECTION VERS TABLEAU est optimisée pour 4D Server. Chaque tableau est créé sur le serveur puis envoyé en totalité sur le poste client.

ATTENTION : SELECTION VERS TABLEAU peut créer des tableaux de taille importante, en fonction de la taille de la sélection courante, ainsi que du type et de la taille des données à charger. Comme les tableaux résident en mémoire, il peut être utile de tester la taille des tableaux créés après l'exécution de la commande, ou d'utiliser une méthode projet d'appel sur erreur.

Note : Après un appel à SELECTION VERS TABLEAU, la sélection courante et l'enregistrement courant ne sont pas modifiés, mais l'enregistrement courant n'est plus chargé. Utilisez la commande CHARGER ENREGISTREMENT après un SELECTION VERS TABLEAU si vous souhaitez utiliser les valeurs des champs de l'enregistrement courant.

Exemple 1

Dans l'exemple suivant, la table [Personnes] dispose d'un lien automatique vers la table [Sociétés]. Les deux tableaux tabNoms et tabAdresseSociétés sont dimensionnés en fonction du nombre d'enregistrements dans la sélection de la table [Personnes] et contiennent des informations venant des deux tables :

SELECTION VERS TABLEAU([Personnes]Nom;tabNoms;[Sociétés]Adresse;tabAdresseSociétés)

Exemple 2

L'exemple ci-dessous retourne les numéros d'enregistrements de la table [Clients] dans le tableau tabNumEnr et les valeurs du champ [Clients]Noms dans le tableau tabNoms :

SELECTION VERS TABLEAU([Clients];tabNumEnr;[Clients]Noms;tabNoms)