4D Doc Center : TABLEAU VERS SELECTION

4D v14.3

TABLEAU VERS SELECTION


TABLEAU VERS SELECTION {( tableau ; leChamp {; tableau2 ; leChamp2 ; ... ; tableauN ; leChampN}{; *} )}

Paramètre	Type	Description
tableau	Tableau	Tableau à copier dans la sélection
leChamp	Champ	Champ recevant les valeurs du tableau
*	Opérateur	Attente d’exécution

Description

La commande TABLEAU VERS SELECTION copie un ou plusieurs tableau(x) vers une sélection d'enregistrements. Tous les champs listés doivent appartenir à la même table.

Si une sélection existe au moment de l'appel, les éléments du tableau sont copiés dans les enregistrements en fonction de l'ordre du tableau et de l'ordre des enregistrements. Si le nombre d'éléments du tableau est supérieur au nombre d'enregistrements de la sélection courante, de nouveaux enregistrements sont créés. Les enregistrements, qu'ils soient nouveaux ou existants, sont automatiquement sauvegardés.

Note : Comme elle permet de créer de nouveaux enregistrements, cette commande ne tient pas compte de l'état lecture seulement éventuel de la table (cf. Verrouillage d'enregistrements).

Tous les tableaux doivent avoir le même nombre d'éléments. Si des tableaux ont des tailles différentes, une erreur de syntaxe est générée.

Cette commande effectue l'opération inverse de SELECTION VERS TABLEAU. Cependant, TABLEAU VERS SELECTION ne permet pas d'utiliser de champs en provenance de tables différentes ni de tables liées, même si un lien automatique existe.

Si vous passez un * en dernier paramètre, 4D n’exécute pas immédiatement la ligne d’instruction correspondante mais la stocke en mémoire ; vous pouvez ainsi empiler plusieurs lignes se terminant par un *. L’ensemble des lignes en attente sera exécuté par une instruction TABLEAU VERS SELECTION finale sans paramètre *. A cette fin, la commande peut être appelée sans aucun paramètre.
A l’image de la commande CHERCHER, ce principe vous permet de scinder une instruction complexe en un ensemble de lignes, plus lisibles et plus faciles à maintenir. Il est également possible d’insérer des instructions intermédiaires.

ATTENTION : Comme TABLEAU VERS SELECTION remplace les informations éventuellement présentes dans les enregistrements existants, cette commande doit être utilisée avec prudence. Si un enregistrement est verrouillé par un autre process pendant l'exécution de la commande TABLEAU VERS SELECTION, il n'est pas modifié. Tous les enregistrements verrouillés sont placés dans l'ensemble LockedSet. Après l'exécution de TABLEAU VERS SELECTION, vous pouvez tester si l'ensemble LockedSet contient des enregistrements qui étaient verrouillés.

Note : Cette commande ne tient pas compte du statut lecture seule/lecture écriture de la table du champ.

4D Server : Cette commande est optimisée pour 4D Server. Le tableau est envoyé au serveur depuis le poste client. Les enregistrements sont modifiés ou créés sur le serveur. Comme une telle requête est gérée de façon synchrone, le poste client doit attendre que l'opération se soit correctement déroulée. Dans les environnements multi-utilisateurs et multi-process, aucun enregistrement verrouillé ne sera réécrit.

Exemple 1

Dans l'exemple suivant, les deux tableaux tabNoms et tabSociétés écrivent des données dans la table [Personnes]. Les valeurs du tableau tabNoms sont placées dans le champ [Personnes]Nom et les valeurs du tableau tabSociétés sont placées dans le champ [Personnes]Société :

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

Exemple 2

Cet exemple permet de dupliquer une sélection d’enregistrements :

 TABLEAU TEXTE(a1;0)

 TABLEAU TEXTE(a2;0)

 TABLEAU TEXTE(a3;0)

 TABLEAU TEXTE(a4;0)

 

 TOUT SELECTIONNER([Table_1])

 Boucle($i;1;Lire numero dernier champ(1))

    $p:=Pointeur vers("a"+Chaine($i))

    SELECTION VERS TABLEAU(Champ(1;$i)->;$p->;*)  // Construction différée des tableaux

 Fin de boucle

 SELECTION VERS TABLEAU //Exécution des instructions

 

 REDUIRE SELECTION([Table_1];0)

 Boucle($i;1;Lire numero dernier champ(1))

    $p:=Pointeur vers("a"+Chaine($i))

    TABLEAU VERS SELECTION($p->;Champ(1;$i)->;*) // Construction de la sélection

 Fin de boucle

 TABLEAU VERS SELECTION //Exécution des instructions