CHARGEMENT

Paragraphe d'utilisation

DECLARATION

Syntaxe

CHARGEMENT Id NomObjet DéfAccès Pas Ajout OptimisationLignes

Description

Déclaration d'un type de chargement de liste graphique de nom Id qui charge la liste de l'objet graphique NomObjet à partir d'une entité, d'un index ou d'une jonction EntitéIndJon , avec la définition d'accès DéfAccès et les zones constituant la clé ZoneAccès . Le chargement se fait par le nombre spécifié Pas enregistrements à la fois.

Dans le cas de chargement de type *EGAL_CLE, *SEQ_CLE, *EGAL_ARR_CLE, *COMMENCE_PAR et *LECT_ARR, il faut préciser les zones constituant l'accès.

Dans le cas de chargement de type *DIRECT, il faut donner le nom de la variable numérique qui va servir de rang.

Dans le cas de chargement de type *SEQ_SANS_CLE, il n'y a pas de clé à préciser.

Dans le cas de chargement de type *SQL, il faut donner le nom des entités concernées, la condition de lecture et le critère de tri. La condition et le critère de tri sont facultatifs. Toutes les zones des entités recevront les valeurs de la base de données.

Cliquez ici pour l'explication de l'élément TriDeZones.

Par défaut l'ordre renvoie les valeurs de l'ensemble des colonnes des entités. Il est cependant possible de ne récupérer que les valeurs des colonnes indiquées dans SelectionColonnes.

Si *DISTINCT est précisé, on ne renvoie que les lignes distinctes (par rapport à l'ensemble des colonnes ou pour les colonnes sélectionnées dans SelectionColonnes).

Dans le cas de chargement de type *SQL_D, il faut donner soit le nom de la variable alphanumérique soit le nom de l'instruction SQL déclarée au préalable via l'ordre INSTRUCTION_SQL, qui contient la requête SQL à appliquer, suivie de la suite des zones qui recevront les valeurs de la base de données.

Attention : dans la requête SQL contenue dans la variable, il faut indiquer le nom réel des colonnes et des tables (et non pas les noms Adélia).

Le Pas peut être spécifié au moyen d'une constante entière ou de la valeur strictement positive contenue dans une variable numérique entière. Si on indique pour Pas la valeur *AUTO, le pas du chargement est déduit de la propriété PAS_GRAPHIQUE de l'objet sur lequel porte le chargement. La valeur *AUTO n'est autorisée que pour des objets possédant la propriété PAS_GRAPHIQUE. Si le Pas n'est pas spécifié, le chargement est statique.

Dans le cas de liste graphique en mise à jour, on peut préciser le nom de la procédure qui va ajouter des lignes supplémentaires différentes de celles par défaut. Les lignes par défaut sont pré-chargées à blanc pour les zones alphanumériques ou à zéro pour les zones numériques. La procédure de chargement est déterminée par Ajout .

L'Ajout n'est possible que si un Pas a été indiqué.

Dans le cas d'un chargement de type *SQL ou *SQL_D, il est possible de demander à l'optimiseur SQL d'optimiser l'exécution de la requête afin de récupérer plus rapidement les n premières lignes du curseur (paramètre *OPT). Par défaut, un chargement avec un Pas indiqué par une constante entière travaille avec une clause d'optimisation correspondant au pas du chargement. Pour empêcher qu'Adélia génère la clause d'optimisation, indiquer le paramètre *OPT(0).

Remarques :

• • Les accès *EGAL_CLE, *SEQ_CLE, *EGAL_ARR_CLE, *COMMENCE_PAR, *LECT_ARR, *DIRECT, *SEQ_SANS_CLE ne sont possibles que sur les bases de données acceptant ces accès fichier.
  • L'accès *DIRECT est impossible sur les bases de données Btrieve.
  • Les accès *SQL et *SQL_D ne sont possibles que sur les bases de données acceptant les accès de type SQL.

Cliquez ici l'explication de l'élément condition Adélia.

Par exemple

↑ Haut de page