Composant SYSCHAMP
Généralités
SYSCHAMP est le composant pour lire les champs des tables d'une base de Données.
La méthode LECTURE est disponible mais la méthode ECRITURE est verrouillée.
NB : L'identifiant d'un champ correspond à son code qui est lui-même la concaténation du code de sa base, du code de sa table et de son code court (séparés par un point). Par exemple, le champ GESCOM.GCPARTIC.DESIG est le "code" du champ mais DESIG et son "code court".
Voir aussi : Composant SYSBASE, Composant SYSTABLE
Les méthodes publiques
Paramètres : Chaine pident
Lecture de l'enregistrement par son identifiant (c'est-à-dire du code de sa base, suivi d'un point, suivi du code de la table, suivi de son code ; ex: "GESCOM.GCPARTIC.DESIG").
Paramètres : Chaine pcode
Lecture du champ pcode où pcode est le code court du champ (ex: "DESIG"). Utile avec un filtre (méthode DEBUT_PARCOURS), sinon utilisez la méthode LECTURE.
Paramètres :
Chaine pBase
Chaine pTable
Chaine pMode
Entier Reference pBt
Chaine pMono
Ouvre l'écran de sélection d'un ou plusieurs champs d'une table avec possibilité de sélectionner des champs en lien.
Paramètres :
Chaine pBase
Chaine pTable
Chaine Reference pLeChamp
Chaine Reference pLibel
Chaine Reference pTaille
Ouvre l'écran de sélection d'un champ d'une table.
Paramètres :
Chaine Reference pLien
Chaine Reference pLibel
Chaine Reference pTaille
Méthode pour récupérer les informations des champs choisis par l'utilisateur avec les méthodes CHOIX_CHAMPS*.
Paramètres :
Chaine pLien
Chaine pLibel
Chaine pTaille
Méthode pour ajouter un élément dans la liste des champs pour la sélection avec les méthodes CHOIX_CHAMPS*.
Paramètres :
Chaine pbase
Chaine ptable
Chaine pchamp
Permet de se positionner en début de la liste des champs d'une table pour effectuer un parcours avec un filtre "pchamp débute par". La lecture se fait ensuite avec LECTURE_CHAMP_SUIVANT.
Lecture du champ suivant. Le positionnement au début se fait avec DEBUT_PARCOURS_CHAMPS.
Paramètres :
Chaine pLeLien // lien à analyser
Chaine pDomaine // partie à récupérer
Chaine Reference pResultat
Chaine pExtrDebut
Extrait une information contenue dans le champ "lien" d'un champ.
pLeLien : Dans le lien il existe 4 parties :
C: ou R: est indiquer que c'est un lien Composant ou Relationnel
<le nom du composant ou table> ex : ADR (le nom de la table)
= <le nom du contexte> ex : ADRF, si il existe un contexte alors il faut extraire que le nom et effacer le =
La partie de la chaîne à extraire (Ex : dans C:EFAC(1,8) il faut récupérer les 8 premiers caractères
pDomaine : quelle partie doit être décomposée :
"C" la partie de Composant ou Relationnelle C: ou R:
"L" le lien. <le nom du composant> ex : ADR (le nom de la table)
"CTX" obtenir le contexte SI il existe.
"EXTR" La partie de l'extraction
"EXTR_DU" La partie de l'extraction Du ...
"EXTR_AU" La partie de l'extraction Au ...
Paramètres :
Chaine pBase
Chaine pTable
Chaine Reference pResultat
Méthode pour savoir si une table possède des liens vers d'autres tables ou des composants. (Champ SYSCHAMP.LIEN ; de type C: ou R: ). Utilisez ensuite la méthode DecomposerLien.
Paramètres :
Chaine pformat
Chaine Reference ptype
Entier Reference pMajusculesIndiff
Entier Reference pSansHomonymes
Chaine Reference pCadrage
Chaine Reference pTroncable
Chaine Reference pChampCompose
Entier Reference pSpecifique
Donne les détails du format d'un champ (SYSCHAMP.FRMT) notamment son type qui sera retourné sous la forme :
"Chaine" (C)
"Entier" (E)
"Simple" (S)
"Double" (D)
"Monnaie" (M)
"Date" (T)
"Clé composée" (K)
Paramètres :
Chaine pformat("Format")
Entier Reference lgf("Longueur formatée (numérique)")
Entier Reference lgr("Longueur réelle (chaine, dates ou clés)")
Calcule la longueur réelle (celle de stockage) et la longueur formatée (telle que la valeur est affichée à l'écran).