Sommaire
Les champs correspondent aux composants graphiques des masques qui permettent à l'utilisateur de saisir et de consulter les données de la transaction.
Les champs supplémentaires saisis pour un formulaire viennent s'ajouter aux champs définis pour ce formulaire en standard dans la gestion des champs (GFLD).
Vous pouvez donc ajouter des champs à un formulaire standard sans avoir à le dupliquer.
Les personnalisations du formulaire existantes seront bien prises en considération.
Le propriétaire pris en compte pour les champs supplémentaires est le plus fin pour l'utilisateur connecté (l'utilisateur, le profil ou *), indépendamment du propriétaire de l'association transaction - formulaire (GAOF).
Données
Appartenance
Formulaire
Il s'agit du nom du formulaire auquel appartient le champ.
Bloc
Il s'agit du nom du bloc auquel appartient le champ.
Propriétaire
Le propriétaire correspond au propriétaire du champ.
Dans cette transaction, le propriétaire ne peut pas être "IFR" ; aucun champ supplémentaire n'est disponible en standard.
Personnalisation
Il s'agit de l'identifiant du nom de la personnalisation. Non utilisé actuellement.
Langue
Cette information ne correspond pas à une caractéristique du champ supplémentaire. Il s'agit de la langue dans laquelle sont recherchés les différents textes des libellés dans GALIB.
Nom
Il s'agit de l'identifiant du champ supplémentaire.
Cet identifiant doit obligatoirement commencer par la lettre "Y" afin de ne pas être confondu avec les champs livrés en standard dans GFLD.
Type
Il s'agit d'un code qui combine le type de composant graphique et le type de données gérées par le champ.
Ces différents types sont définis dans les occurrences du paramètre TYPGAFLD.
Pour les champs supplémentaires de type LEGEND, il est possible d'appeler une procédure stockée ou d'exécuter un select qui doit être créé au préalable dans GSEL, avec un maximum de neuf valeurs passées en paramètre.
Description
Pour les consultations et les gestions, il s'agit du nom de la description qui sera utilisée lors de la construction et de l'exécution de la requête SQL.
Il est également possible de référencer un ordre SQL (GSEL) dans ce champ, qui sera remplacé au moment de la recherche. Les paramètres de substitution pour remplacer les "?" dans l'ordre SQL sont définis dans les valeurs de 1 à 10 des propriétés spécifiques.
Pour les valeurs :
- :CHAMP (ou :BLOC:CHAMP) : le "?" sera remplacé par la colonne associée au champ ;
- $VAL : le "?" sera remplacé par la valeur du symbole ;
- Valeur : le "?" sera remplacé par cette valeur.
Si le champ est de type LEGEND, saisir "null" pour cette description.
Pour une valeur constante, saisir la constante entourée de quotes. Exemple : 'O'.
Dans le cas des soumissions, cette description correspond aux critères de traitement référencés dans GCTR.
Objet de la forme sélection
Quand un champ est déplacé d'une transaction de sélection vers une transaction principale, un champ est automatiquement créé dans cette dernière.
Le mode, s'il est renseigné, indique l'objet (GOBJ) de la transaction de sélection de référence du champ.
Défaut
Il s'agit de la valeur par défaut du champ, visible dès l'ouverture du masque. Cette valeur par défaut est prise en compte également pour les champs cachés.
Il est possible de saisir un symbole à la place d'une valeur par défaut.
Ces symboles sont ceux habituellement utilisés, exemples : $ETS, $USER, $DATEMIN, ...
Intitulé
Il s'agit du code de l'intitulé écrit dans le masque pour libeller le champ.
Il est suivi du texte de l'intitulé de la colonne stocké dans GALIB. Ce texte dépend du code et vice versa.
Champ associé
Il s'agit d'un autre champ qui sera associé à celui en cours. Cette association est utilisée pour les fourchettes et les champs d'informations liés à un champ code.
Pour les fourchettes, ce champ devra obligatoirement commencer par la lettre "Y" afin de ne pas être confondu avec les champs livrés en standard dans GFLD.
Pour les champs de type Graphique, il s'agit du nom du champ de la transaction qui gère les libellés du graphique.
Taille affichée
Il s'agit du nombre de caractères maximum pouvant être affichés dans le champ.
Taille du champ
Il s'agit du nombre maximal de caractères pouvant être saisis dans le champ.
Ordre tabulation
Correspond à l'ordre de déplacement du curseur par la touche "Tabulation". Correspond également à l'ordre d'affichage du champ pour un masque non dessiné.
Pour un masque non dessiné, les champs supplémentaires seront affichés après les champs définis dans GFLD, sauf pour les champs de type LEGEND qui seront affichés sur la même ligne que leur champ associé.
Champ géré
Cette information n'est gérée que pour les applications mobiles et la technologie HTML5.
Seuls les champs gérés seront chargés et utilisés. Cette option permet d'optimiser l'ouverture des transactions.
Champ basé
Cette case à cocher indique si le champ fait référence à la colonne principale de la liste de valeurs (case cochée) ou s'il faut rechercher la liste de valeurs dans les équivalences de colonnes (GECL).
Liste de valeurs
La liste de valeurs sur un champ peut être calculée, saisie ou inexistante.
Les différentes valeurs sont définies dans les occurrences du paramètre LVCGAFLD.
Numéro
Il s'agit du numéro de la liste de valeurs qui sera associée au champ.
Complément pour fourchette
Cette forme détail gère les différentes caractéristiques du champ fin de la fourchette.
Champ fin
Il s'agit d'un champ qui reprend la valeur du champ "Champ associé" de la forme principale.
Recopie champ début
Ce champ gère la possibilité de recopie du champ début, dans le champ fin de la fourchette.
Les différents types de recopies sont définis dans les occurrences du paramètre FRDGAFLC.
Intitulé
Il s'agit du code de l'intitulé écrit dans le masque pour libeller le champ de fin. Le texte de cet intitulé est recherché dans GALIB.
Il est suivi du texte de l'intitulé de la colonne, stocké dans GALIB. Ce texte dépend du code et vice versa.
Description
Pour les consultations et les gestions, il s'agit de la description qui sera utilisée lors de la construction et de l'exécution de la requête SQL.
Dans le cas des soumissions, cette description correspond aux critères de traitement référencés dans GCTR.
Défaut
Il s'agit de la valeur par défaut du champ, visible dès l'ouverture du masque. Cette valeur par défaut est prise en compte également pour les champs cachés.
Il est possible de saisir un symbole à la place d'une valeur par défaut.
Ces symboles sont ceux habituellement utilisés, exemples : $ETS, $USER, $DATEMIN, ...
Libellé
Il s'agit du code de l'intitulé écrit dans :
- la colonne de la grille pour la colonne de fin sur un bloc de saisie ou d'affichage ;
- la page de recherche simplifiée sur un bloc de recherche. Si cet intitulé n'est pas renseigné, le texte pris en compte dans la recherche simplifiée est l'intitulé associé au champ de fin.
Le texte de cet intitulé est recherché dans GALIB.
Champ fin : Texte intitulé grille
Il s'agit du texte de l'intitulé de la colonne de fin dans la grille, stocké dans GALIB.
Champ fin : Ordre grille
Ordre d'affichage de la colonne de fin dans la grille. Si l'ordre est égal à 0 ou nul, la colonne n'est pas affichée.
Exportable
La colonne de fin sera prise en compte lors de l'export des enregistrements. Actuellement cette information n'est pas gérée.
Ordre
Il s'agit de l'ordre d'export pour la colonne de fin dans le cas où la colonne est exportable. Actuellement cette information n'est pas gérée.
Paramètres standard
Propriétés Générales
Gestion des caractéristiques générales du champ.
Basé
Il s'agit de déterminer si le champ est lié à une colonne de la table gérée ou pas.
Dans un masque de critères de recherche, les champs permettant la saisie d'un de ces critères doivent être basés. Seuls les champs de travail ou les champs gérant un libellé ne seront pas basés.
Pour un masque de saisie des données d'une gestion, la saisie dans un champ basé provoquera la modification de la ligne de données courante et donc la modification dans la base de données après validation.
Pour une soumission, cet attribut permet de lier le champ à un critère de traitement référencé dans GCTR.
Obligatoire
Rend obligatoire la saisie dans le champ que ce soit pour un critère de recherche ou une donnée.
Majuscule
Transforme automatiquement en majuscule, la saisie dans le champ.
Lecture seule
Impossibilité de saisir dans le champ, mais le curseur peut y être positionné.
Champ caché
Il s'agit de la propriété d'affichage du champ.
Les différentes valeurs de cette propriété sont définies dans les occurrences du paramètre HIDGAFLC.
Accessible
Permet de saisir et de mettre le curseur dans le champ.
Paramétrable
Permet de saisir et de mettre le curseur dans le champ lorsque le masque est en mode paramétrage par défaut.
Duplicable
Lors de la duplication de lignes de données, la valeur dans ce champ est recopiée vers la ligne dupliquée.
Non utilisé dans les masques des critères de recherche et dans les soumissions.
Exclusif en query
Ne concerne que les critères de recherche, où il y a obligation de saisir au moins un champ qui possède cette propriété dans le masque. Non utilisé dans les soumissions.
Modifiable en gestion
Dans un masque de saisie, le champ est accessible lorsqu'il affiche une valeur d'une ligne de données dans l'état "modifiée".
Non utilisé dans les masques des critères de recherche et dans les soumissions.
Ne pas respecter la casse en recherche
Cette option permet de ne pas tenir compte des caractères majuscule/minuscule lors de la recherche. Elle est accessible seulement sur les champs alphanumériques qui ne sont pas en majuscule et ne concerne que les critères de recherche.
Non utilisé dans les soumissions.
PostChange
Ce champ gère l'évènement postchange du champ.
Les différentes valeurs du bouton radio sont définies dans les occurrences du paramètre OPCGAFLC.
OnFocus
Il s'agit de l'événement lié à l'arrivée du focus sur le champ. Un traitement spécifique peut être alors codé sur cet événement.
OnBlur
Il s'agit de l'événement lié à la sortie du focus du champ. Un traitement peut alors être codé sur cet événement.
OnClick
Il s'agit de l'évènement "cliquer" sur un bouton, un bouton radio ou une case à cocher.
Actions spécifiques
Ce champ gère les différentes actions spécifiques possibles sur un champ.
Les différentes valeurs sont définies dans les occurrences du paramètre SPEGAFLD
Remarque : Si l'option "clé analytique" est sélectionnée dans les propriétés générales, alors vous devez obligatoirement saisir l'établissement dans les propriétés spécifiques du champ pour l'appel de la clé analytique.
Affichage dans la grille
Libellé
Il s'agit du code de l'intitulé écrit dans :
- la colonne de la grille sur un bloc de saisie ou d'affichage ;
- la page de recherche simplifiée sur un bloc de recherche. Si cet intitulé n'est pas renseigné, le texte pris en compte dans la recherche simplifiée est l'intitulé associé au champ.
Le texte de cet intitulé est recherché dans GALIB.
Texte intitulé grille
Il s'agit du texte de l'intitulé de la colonne, stocké dans GALIB.
Ordre
Ordre d'affichage de la colonne dans la grille. Si l'ordre est égal à 0, la colonne n'est pas affichée.
Dans les grilles non dessinées par un JSP, les colonnes représentant les champs supplémentaires seront affichées en fin de grille.
Champ bufferisé
Cette information indique si le champ à une valeur par ligne de données et est visualisable dans la grille ou si le champ n'a qu'une seule valeur, unique pour toutes les lignes de données et non visualisable dans la grille.
Type de colonne
Il s'agit du type de la colonne de la requête SQL.
Remarque : Pour une colonne associée à un champ LEGEND ou GPHxxx dans GFLD, sélectionnez "colonne de travail" et affectez la valeur "null" à la description de la colonne.
Champ exportable
La colonne sera prise en compte lors de l'export des enregistrements. Actuellement cette information n'est pas gérée.
Ordre
Il s'agit de l'ordre d'export pour la colonne dans le cas où la colonne est exportable. Actuellement cette information n'est pas gérée.
Propriétés Spécifiques
Cette partie regroupe les propriétés spécifiques du champ.
Les propriétés spécifiques sont différentes suivant le type du champ à définir.
Leur paramétrage est identique à celui de la gestion des champs (GFLD).