SELECTION LIMITEE VERS TABLEAU

version 5.5.3

SELECTION LIMITEE VERS TABLEAU (début; fin; champ | table; tableau{; champ2 | table2; tableau2; ...; champN | tableN; tableauN})

SELECTION LIMITEE VERS TABLEAU crée un ou plusieurs tableaux et y copie des données en provenance des champs de la sélection courante ou les numéros des enregistrements de la sélection courante.

A la différence de SELECTION VERS TABLEAU qui s'applique à l'intégralité de la sélection courante, SELECTION LIMITEE VERS TABLEAU s'applique uniquement à une sous-sélection d'enregistrements, définie par les paramètres début et fin.

Vous devez passer dans les paramètres début et fin des numéros d'enregistrements sous-sélectionnés s'inscrivant dans l'intervalle défini par la formule 1 <= début <= fin <= Enregistrements trouves ([...]).

Si vous passez des numéros correspondant à 1 <= début = fin <= Enregistrements trouves ([...]), ce sont les champs ou les numéros des enregistrements de la sélection courante répondant à début = fin qui seront chargés.

Si vous passez des numéros d'enregistrements incorrects, vous obtiendrez les résultats suivants :

• Si fin > Enregistrements trouves ([...]), la commande retourne toutes les valeurs, à partir de l'enregistrement sous-sélectionné spécifié par début jusqu'au dernier enregistrement sous-sélectionné.

• Si début > fin, la commande ne retourne que les valeurs de l'enregistrement début.

• Si les deux paramètres incompatibles avec la taille de la sous-sélection, les tableaux sont retournés vides

Comme SELECTION VERS TABLEAU, SELECTION LIMITEE VERS TABLEAU s'applique à la sélection de la table passée en paramètre. La commande peut réaliser les opérations suivantes :

• Charger les valeurs d'un ou plusieurs champs,

• Charger les numéros des enregistrements, à 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 :

• Lorsqu'un champ de type Texte est copié dans un tableau Alpha, le tableau reste de type Alpha.

• La copie d'un champ de type Heure provoquera la création d'un tableau Entier long.

Note : Vous ne pouvez pas utiliser de champs de type Sous-table ni de sous-champs.

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

4D Server : La commande SELECTION LIMITEE 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 LIMITEE VERS TABLEAU peut créer des tableaux de taille importante, en fonction de l'intervalle défini par début et fin, 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'interception d'erreurs, installée par la commande APPELER SUR ERREUR.

Une fois la commande correctement exécutée, la taille des tableaux résultants est égale à (fin-début)+1 — sauf si le paramètre fin est supérieur au nombre d'enregistrements dans la sélection. Dans ce cas, les tableaux contiennent (Enregistrements trouves([...])-début)+1 éléments.

(1) La ligne de code suivante utilise les 50 premiers enregistrements de la sélection courante de la table [Factures]. Les valeurs du champ [Factures]RéfFacture et du champ lié [Clients]RéfClient sont chargées.

   SELECTION LIMITEE VERS TABLEAU (1;50;[Factures]RéfFacture;tlRéfFacture;[Clients]RéfClient;tlRéfClient)

(2) Les lignes de code suivantes utilisent les 50 derniers enregistrements de la sélection courante de la table [Factures]. Les numéros d'enregistrements de la table [Factures] ainsi que ceux de la table liée [Clients] sont chargés :

   lTailleSél := Enregistrements trouves ([Factures])
   SELECTION LIMITEE VERS TABLEAU (lTailleSél-49;lTailleSél;[Factures];taFactureNum;[Clients];taClientNum)

(3) Les lignes de code suivantes vous permettent de travailler séquentiellement avec des portions de 1000 enregistrements d'une sélection importante qui ne peut pas être chargée dans des tableaux en une seule fois :

   lMaxPage := 1000
   lTailleSél := Enregistrements trouves ([Annuaire])
   Boucle ($lPage ; 1; 1+((lTailleSél-1)\lMaxPage) )
         ` Charger les valeurs et/ou les numéros d'enregistrements
      SELECTION LIMITEE VERS TABLEAU (1+(lMaxPage*($lPage-1));lMaxPage*$lPage;...;...;...;...;...;...)
         ` Faire quelque chose avec les tableaux
   Fin de boucle

APPELER SUR ERREUR, FIXER LIENS AUTOMATIQUES, SELECTION VERS TABLEAU.