GESTION_SFL_SQL

ADELIA
(I)

Attention : cet ordre est uniquement compatible avec le générateur RPG.

Paragraphe d'utilisation

INITIALISATION

Syntaxe

GESTION_SFL_SQL n SuiteEntités Distinct SélectionColonnes Condition GroupementColonnes TriDeZones OptimisationLignes MaxLignes Paramètre

SuiteEntités	→	SuiteEntités, Entité \| Entité
Entité	→	NomEntité NomCorrélation \| NomEntité
Distinct	→	*DISTINCT \| RIEN
SélectionColonnes	→	COL(SuiteZonesEntité) \| COL(SuiteFcts) \| RIEN
SuiteZonesEntité	→	SuiteZonesEntité, IdVarEntité \| IdVarEntité
SuiteFcts	→	SuiteFcts, FctCol :IdVarHote \| FctCol :IdVarHote
FctCol	→	NomFct(IdVarEntité) \| NOMBRE(*)
NomFct	→	SOMME \| MOYENNE \| MAX \| MIN \| NOMBRE_DISTINCT
IdVarHote	→	IdVar \| IdVar :IdVarIndicatrice
Condition	→	ConditionAdélia \| *COND(:IdVar)
GroupementColonnes	→	*GROUPE(SuiteZonesEntité) \| RIEN
SuiteZonesEntité	→	SuiteZonesEntité, IdVarEntité \| IdVarEntité
OptimisationLignes	→	*OPT(n) \| RIEN
MaxLignes	→	*LIGNES(m) \| RIEN
Paramètre	→	NON_RG \| RG \| RIEN

Description

Cet ordre marque le début de traitement d'un sous-fichier. Il doit être suivi par l'ordre FIN_GESTION_SFL.

n est le numéro du sous-fichier concerné ; il s'agit du chiffre se trouvant après l'astérisque (*) dans le code format de la maquette. Par exemple : 1 pour *1 ou 4 pour *4.

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 pour les colonnes indiquées dans SélectionColonnes.

Si *DISTINCT est précisé, seules les lignes distinctes sont récupérées (par rapport à l'ensemble des colonnes ou pour les colonnes sélectionnées dans SelectionColonnes).

*COL(SuiteFcts) est autorisé uniquement en présence de *GROUPE.

Si *GROUPE est précisé :

- Avec une clause *COL : la clause *COL ne peut contenir que des fonctions d'agrégation ; les zones de regroupement sont systématiquement ajoutées à la sélection.
- Sans clause *COL : la sélection est automatiquement construite avec les seules zones du regroupement.
- Les zones de la clause *TRI doivent être présentes dans la clause *GROUPE.

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, lorsque la condition n'est pas de type *COND( :IdVar), un sous-fichier en pagination dynamique travaille avec une clause d'optimisation correspondant au nombre de lignes du sous-fichier par page. Pour empêcher Adélia de générer la clause d'optimisation, il faut indiquer le paramètre *OPT(0).

En outre, il est possible d'indiquer à l'optimiseur de requête de récupérer uniquement les m premières lignes du curseur (paramètre *LIGNES).

Le paramètre *RG permet de générer les règles de gestion implicites de lecture liées à l'entité, même si le programme est généré avec l'option de génération des règles de gestion implicites.

Le paramètre *NON_RG permet de ne pas générer les règles de gestion implicites de lecture liées à l'entité, même si le programme est généré avec l'option de génération des règles de gestion implicites.

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

Attention : lorsque la Condition est contenue dans une variable *COND(:IdVar), la variable doit contenir la partie "where" d'une requête SQL, où il faut indiquer les noms réels des colonnes et des tables (et non pas les noms Adélia).

Par exemple

GESTION_SFL_SQL 1 ARTICLE *COND(CCODE_ARTICLE>:WCODE_ART) *TRI(CODE_ARTICLE)

PRESENTER ARTICLE

MAJ_SFL

FIN_GESTION_SFL

Voir aussi la liste des ordres L4G par thème

↑ Haut de page