Cegid XRP Ultimate  |  
I3   Actualisé le 06/10/2022
Fondations Web
GFLS - Champs supplémentaires

   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).

Transactions associées

   GTFPS - Paramètres de synchronisation d'une transaction

Paramètres

   TYPGAFLD

Messages
   GAFLS050 - Insertion d'une caractéristique référence interdite

   GAFLS051 - L'intitulé doit être renseigné pour ce type de champ ($1, $2, $3)

   GAFLS052 - Pour ce type de champ, le champ parent doit être renseigné ($1, $2, $3)

   GAFLS053 - Le champ parent n'est pas un champ de ce formulaire ($1, $2, $3)

   GAFLS054 - Le champ et le champ parent doivent être différents ($1, $2, $3)

   GAFLS056 - L'ordre ($1) est déjà utilisé dans ce bloc et ce formulaire ($2, $3, $4)

   GAFLS057 - Pas de liste de valeurs : ne pas saisir de numéro de liste de valeurs ($1, $2, $3)

   GAFLS058 - Liste de valeurs saisie : préciser un numéro de liste de valeurs ($1, $2, $3)

   GAFLS059 - La description de la colonne doit être renseignée, le champ est basé ($1, $2, $3)

   GAFLS060 - La valeur par défaut doit être saisie pour un champ obligatoire caché ($1, $25, $3)

   GAFLS068 - L'intitulé de fin ne peut être renseigné que pour une fourchette ($1, $2, $3)

   GAFLS069 - La recopie ne peut être renseignée que pour un champ fourchette ($1, $2, $3)

   GAFLS070 - La description pour le champ de fin ne doit pas être renseignée ($1, $2, $3)

   GAFLS071 - La valeur par défaut ne peut être renseignée que pour une fourchette ($1, $2, $3)

   GAFLS072 - Pour ce type de champ, l'ordre SQL (GASEL) ne doit pas être renseigné ($1, $2, $3)

   GAFLS073 - Pour ce type de champ, le nombre d'éléments ne doit pas être renseigné ($1, $2, $3)

   GAFLS074 - Pour ce type de champ, la variable $1 ne doit pas être renseignée ($2, $3, $4)

   GAFLS080 - Ce type de champs nécessite certaines propriétés spécifiques ($1, $2, $3)

   GAFLS093 - Le nom des champs supplémentaires doit commencer par la lettre "Y" ($1, $2, $3)