REC-VAR-ENT : Rech. valeur Variable « Entité »
BUT
Permet de rechercher la valeur d’une variable (standard ou spécifique) d’une entité pour une clé donnée et des entités liées à cette entité
Cette fonction est disponible dans les requêtes de type PSD, RCT, REB et REN.
TYPE
CARACTERE
SYNTAXE
Resultat = REC-VAR-ENT(ACTION=REC-TYPE,REC-FORMAT,REC-VALEUR,
ENTITE = Référence_Entité,
VARIABLE = Référence_Variable,
ENTITE-RECHERCHE= Référence_Entité_Recherche,
CLE-1 = Clé-1_Entité_Recherche,
CLE-2 = Clé-2_Entité_Recherche,
CLE-3 = Clé-3_Entité_Recherche,
S-VALEUR = Valeur résultat liée à l’action de la fonction)
PARAMETRES
Paramètre | E/S | O | Type | Description |
ACTION | E | Oui | Caractère | REC-TYPE : cette action demande à DIAPASON de donner le type (Caractère, Numérique, Date, Logique) de la variable définie dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE. Le type est retourné dans la variable du paramètre de sortie VALEUR. REC-FORMAT : cette action demande à DIAPASON de donner le format d’affichage défaut de la variable définie dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE. Le format est retourné dans la variable du paramètre de sortie VALEUR. REC-VALEUR : cette action demande à DIAPASON de rechercher la valeur de la variable définie dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE. La valeur est retournée dans la variable du paramètre de sortie VALEUR. |
ENTITE | E | Oui | Caractère | Référence entité. Cette référence peut être donnée par une variable locale, une constante globale, une constante locale ou par la sélection de l’entité (liste proposée). |
VARIABLE | E | Oui | Caractère | Référence variable. Cette référence peut être donnée par une variable locale, une constante globale, une constante locale ou par la sélection d’une variable de l’entité précédemment sélectionnée (présentation en saisie de la liste des variables si une entité a été précisée auparavant). |
ENTITE- RECHERC… | E | Oui | Caractère | Référence entité correspondant à la clé donnée de recherche. Les entités étant liées entre elles, il est possible de donner la clé d’une entité donnée et de rechercher la valeur d’une variable d’une entité liée (exemple : pour une clé correspondant à une entité de recherche de ligne de commande commerciale, rechercher le numéro de téléphone sur l’entité client liée). Cette référence peut être donnée par la valeur fixe ENTITE-COURANTE (correspond à l’entité de la variable), une variable locale, une constante globale, une constante locale ou par la sélection de l’entité (liste proposée). Remarque : ce paramètre n’est pas utilisé pour les actions REC-TYPE et REC-FORMAT. |
CLE-1 | E | Oui | Caractère | Clé de niveau 1 de l’entité correspondant à la clé donnée de recherche. Cette clé peut être donnée par une variable locale, une constante globale, une constante locale ou par la valeur d’une variable contextuelle (remarque : la définition de ce niveau de clé correspond à la définition du même niveau de clé de la fonction ENR-ACT-ENT). Remarque : ce paramètre n’est pas utilisé pour les actions REC-TYPE et REC-FORMAT. |
CLE-2 | E | Oui | Caractère | Clé de niveau 2 de l’entité correspondant à la clé donnée de recherche. Cette clé peut être donnée par une variable locale, une constante globale, une constante locale ou par la valeur d’une variable contextuelle (remarque : la définition de ce niveau de clé correspond à la définition du même niveau de clé de la fonction ENR-ACT-ENT). Remarque : ce paramètre n’est pas utilisé pour les actions REC-TYPE et REC-FORMAT. |
CLE-3 | E | Oui | Caractère | Clé de niveau 3 de l’entité correspondant à la clé donnée de recherche. Cette clé peut être donnée par une variable locale, une constante globale, une constante locale ou par la valeur d’une variable contextuelle (remarque : la définition de ce niveau de clé correspond à la définition du même niveau de clé de la fonction ENR-ACT-ENT). Remarque : ce paramètre n’est pas utilisé pour les actions REC-TYPE et REC-FORMAT. |
VALEUR | E-S | Oui | Caractère | Variable dont le comportement dépend de l’action : Action REC-TYPE : après exécution de la fonction, contient le type de la variable définie dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE. Action REC-FORMAT : après exécution de la fonction, contient le format de la variable défini dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE. Action REC-VALEUR : après exécution de la fonction, contient la valeur de la variable définie dans le paramètre VARIABLE de l’entité donnée dans le paramètre ENTITE et ces clés données. |
Cette fonction retourne dans la variable résultat le retour de l’exécution de la fonction (vide : exécution OK, non vide : problème).
Entités | CLE 1 | CLE 2 | CLE 3 |
AFO (Fournisseurs) | AppRefFour | ||
AL-ART-FOU (Liens Articles -> Fournisseurs) | AppRefFour | GenRefArt | GenOriPrin |
APE (Commandes Fournisseurs) | AppNumCom | ||
APL (Lignes de Commandes Fournisseurs) | AppNumCom | AppNumLig | |
ARE (Retours Fournisseurs | AppRetNum | ||
ARL (Lignes de Retours Fournisseurs) | AppRetNum | AppRetLig | |
FACE (Entête de facture client) | CdeFacRef | ||
FACL (Ligne de facture client) | CdeFacRef | CdeFacLig | |
GAD (Articles) | GenRefTypeArt | GenRefArt | |
GANOD (Nomenclatures de Définition) | NomTypRef | GenRefTypeCse | GenRefCse NomNumOrd |
GCAF (Affaires) | CliAffRef | ||
GCDE (Commandes Commerciales) | CdeNumCom | ||
GCDL (Lignes de Commandes Commerciales) | CdeNumCom | CdeNumLig | |
GCEX (Evènements d'Expéditions) | CdeExpRef | ||
GCLIENT (Clients) | CliResRef | CliGenRef | |
GCO (Commerciaux) | CliComRef | ||
GCPE (Besoins de Gestion) | CdeNumCom | ||
GCPL (Lignes de Besoin de Gestion) | CdeNumCom | CdeNumLig | |
GCRE (Retours Clients) | CdeRetNum | ||
GCRL (Lignes de Retours Clients) | CdeRetNum | CdeRetLig | |
GLA (Séries) | LanSerRef | ||
GLL (OFs) | LanSerFabOF | ||
GRESS (Ressources) | GamGenObj | ResGenRef | |
GVAD (Vari-Articles) | GenRefTypeVaArt | GenRefVaArt |
EXEMPLE
VLO.Fct = REC-VAR-ENT( ACTION= REC-VALEUR , ENTITE= AFO , VARIABLE= AppFouTelephone , ENTITE-RECHERCHE= ENTITE-COURANTE , CLE-1= SCR.AppFouRef , CLE-2= CLO."" , CLE-3= CLO."" , S-VALEUR= VLO.Telephone_Four )
La fonction permet d’affecter dans la variable VLO.Telephone_Four la valeur de la variable AFO.AppFouTelephone (Numéro de téléphone fournisseur) pour le fournisseur dont la référence est mémorisée dans la variable SCR.AppFouRef .
VLO.Fct = REC-VAR-ENT( ACTION= REC-VALEUR , ENTITE= GCAF , VARIABLE= CliAffDaD, ENTITE-RECHERCHE= GCDE , CLE-1= VLO.NumCde , CLE-2= CLO."" , CLE-3= CLO."", S-VALEUR= VLO.Date_Deb_Affaire )
La fonction permet d’affecter dans la variable VLO.Date_Deb_Affaire la valeur de la variable GCAF.CliAffDaD (Date début Affaire (entité affaire)) pour l’affaire rattachée à la commande commerciale dont le numéro de commande est défini dans la variable locale VLO.NumCde.
NOTES
La variable retour contient *INC si la fonction ne s’est pas exécutée correctement (variable inexistante par exemple). Dans le cas de l’action REC-VALEUR, si la variable est bien définie mais n’a pas de valeur (cas des variables spécifiques par exemple), le code retour de la fonction est *NO-DEF.
Les liens directs entre entités sont les suivants
Entité | Entité Liée |
AL-ART-FOU (Liens Articles -> Fournisseurs) | AFO (Fournisseurs) |
AL-ART-FOU (Liens Articles -> Fournisseurs) | GAD/R (Articles Standards) |
APE (Commandes Fournisseurs) | AFO (Fournisseurs) |
APL (Lignes de Commandes Fournisseurs) | APE (Commandes Fournisseurs) |
APL (Lignes de Commandes Fournisseurs) | GAD (Articles Standards) |
ARE (Retours Fournisseurs) | AFO (Fournisseurs) |
ARL (Lignes de Retours Fournisseurs) | ARE (Retours Fournisseurs) |
ARL (Lignes de Retours Fournisseurs) | GAD (Articles Standards) |
FA-CT (File d'Attente sur CT) | FA-RL (File d'Attente sur RL) |
FA-CT (File d'Attente sur CT) | GLL (OFs) |
FA-RL (File d'Attente sur RL) | GRESS(Ressources) |
FACE (Entête de facture Client) | GCLIENT (Clients) |
FACL (Ligne de Facture Client) | FACE (Entête de facture Client) |
GAD (Articles Standards) | GCPL (Lignes Besoins de Gestion) |
GANOD (Nomenclatures de Définition) | GAD/R (Articles Standards) |
GCAF (Affaires) | GCLIENT (Clients) |
GCDE (Commandes Commerciales) | GCAF (Affaires) |
GCDE (Commandes Commerciales) | GCLIENT (Clients) |
GCDE (Commandes Commerciales) | GCO (Commerciaux) |
GCDE (Commandes Commerciales) | GCPE (Besoins de Gestion) |
GCDL (Lignes Cde. Commerciales) | GAD (Articles Standards) |
GCDL (Lignes Cde. Commerciales) | GCDE (Commandes Commerciales) |
GCDL (Lignes Cde. Commerciales) | GCPE (Besoins de Gestion) |
GCDL (Lignes Cde. Commerciales) | GCPL (Lignes Besoins de Gestion) |
GCLIENT (Clients) | GCO (Commerciaux) |
GCPE (Besoins de Gestion) | GCAF (Affaires) |
GCPE (Besoins de Gestion) | GCDE (Commandes Commerciales) |
GCPE (Besoins de Gestion) | GCLIENT (Clients) |
GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
GCPL (Lignes Besoins de Gestion) | GCDE (Commandes Commerciales) |
GCPL (Lignes Besoins de Gestion) | GCDL (Lignes Cde. Commerciales) |
GCPL (Lignes Besoins de Gestion) | GCPE (Besoins de Gestion) |
GCRE (Retours Clients) | GCLIENT (Clients) |
GCRL (Lignes de Retours Clients) | GAD (Articles Standards) |
GCRL (Lignes de Retours Clients) | GCRE (Retours Clients) |
GLL (OFs) | GAD (Articles Standards) |
GLL (OFs) | GLA (Séries) |
Les liens entre entités avec utilisation d’une entité « intermédiaire », par exemple, pour accéder aux données fournisseurs (AFO) à partir d’une ligne de commande fournisseur (APL), on utilise l’entête de commande fournisseur (APE), sont les suivants :
Entité | Entité Liée | Entités Intermédiaires |
APL (Lignes de Commandes Fournisseurs) | AFO (Fournisseurs) | APE (Commandes Fournisseurs) |
APL (Lignes de Commandes Fournisseurs) | GCAF (Affaires) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
APL (Lignes de Commandes Fournisseurs) | GCDE (Commandes Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
APL (Lignes de Commandes Fournisseurs) | GCDL (Lignes Cde. Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
APL (Lignes de Commandes Fournisseurs) | GCLIENT (Clients) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCPE (Besoins de Gestion) |
APL (Lignes de Commandes Fournisseurs) | GCO (Commerciaux) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
APL (Lignes de Commandes Fournisseurs) | GCPE (Besoins de Gestion) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
APL (Lignes de Commandes Fournisseurs) | GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
ARL (Lignes de Retours Fournisseurs) | AFO (Fournisseurs) | ARE (Retours Fournisseurs) |
ARL (Lignes de Retours Fournisseurs) | GCAF (Affaires) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
ARL (Lignes de Retours Fournisseurs) | GCDE (Commandes Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
ARL (Lignes de Retours Fournisseurs) | GCDL (Lignes Cde. Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
ARL (Lignes de Retours Fournisseurs) | GCLIENT (Clients) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCPE (Besoins de Gestion) |
ARL (Lignes de Retours Fournisseurs) | GCO (Commerciaux) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
ARL (Lignes de Retours Fournisseurs) | GCPE (Besoins de Gestion) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
ARL (Lignes de Retours Fournisseurs) | GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
FA-CT (File d'Attente sur CT) | GAD (Articles Standards) | GLL (OFs) |
FA-CT (File d'Attente sur CT) | GCAF (Affaires) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
FA-CT (File d'Attente sur CT) | GCDE (Commandes Commerciales) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
FA-CT (File d'Attente sur CT) | GCDL (Lignes Cde. Commerciales) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
FA-CT (File d'Attente sur CT) | GCLIENT (Clients) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
FA-CT (File d'Attente sur CT) | GCO (Commerciaux) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
FA-CT (File d'Attente sur CT) | GCPE (Besoins de Gestion) | GLL (OFs) GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
FA-CT (File d'Attente sur CT) | GCPL (Lignes Besoins de Gestion) | GLL (OFs) GAD (Articles Standards) |
FA-CT (File d'Attente sur CT) | GLA (Séries) | GLL (OFs) |
FA-CT (File d'Attente sur CT) | GRESS (Ressources) | FA-RL (File d'Attente sur RL) |
FACE (Entête de Facture Client) | GCO (Commerciaux) | GCLIENT (Clients) |
FACL (Ligne de Facture Client) | GCLIENT (Clients) | FACE (Entête de Facture Client) |
FACL (Ligne de Facture Client) | GCO (Commerciaux) | FACE (Entête de Facture Client) GCLIENT (Clients) |
GAD (Articles Standards) | GCAF (Affaires) | GCPL (Lignes Besoins de Gestion) GCPE (Besoins de Gestion) |
GAD (Articles Standards) | GCDE (Commandes Commerciales) | GCPL (Lignes Besoins de Gestion) |
GAD (Articles Standards) | GCDL (Lignes Cde. Commerciales) | GCPL (Lignes Besoins de Gestion) |
GAD (Articles Standards) | GCLIENT (Clients) | GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
GAD (Articles Standards) | GCO (Commerciaux) | GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
GAD (Articles Standards) | GCPE (Besoins de Gestion) | GCPL (Lignes Besoins de Gestion) |
GCAF (Affaires) | GCO (Commerciaux) | GCLIENT (Clients) |
GCDE (Commandes Commerciales) | GCDE (Commandes Commerciales) | GCPE (Besoins de Gestion) |
GCDL (Lignes Cde. Commerciales) | GCAF (Affaires) | GCPE (Besoins de Gestion) |
GCDL (Lignes Cde. Commerciales) | GCDL (Lignes Cde. Commerciales) | GCPL (Lignes Besoins de Gestion) |
GCDL (Lignes Cde. Commerciales) | GCLIENT (Clients) | GCDE (Commandes Commerciales) |
GCDL (Lignes Cde. Commerciales) | GCO (Commerciaux) | GCDE (Commandes Commerciales) |
GCPE (Besoins de Gestion) | GCO (Commerciaux) | GCDE (Commandes Commerciales) |
GCPE (Besoins de Gestion) | GCPE (Besoins de Gestion) | GCDE (Commandes Commerciales) |
GCPL (Lignes Besoins de Gestion) | GCAF (Affaires) | GCDE (Commandes Commerciales) |
GCPL (Lignes Besoins de Gestion) | GCLIENT (Clients) | GCPE (Besoins de Gestion) |
GCPL (Lignes Besoins de Gestion) | GCO (Commerciaux) | GCDE (Commandes Commerciales) |
GCPL (Lignes Besoins de Gestion) | GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
GCRE (Retours Clients) | GCO (Commerciaux) | GCLIENT (Clients) |
GCRL (Lignes de Retours Clients) | GCAF (Affaires) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
GCRL (Lignes de Retours Clients) | GCDE (Commandes Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GCRL (Lignes de Retours Clients) | GCDL (Lignes Cde. Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GCRL (Lignes de Retours Clients) | GCLIENT (Clients) | GCRE (Retours Clients) |
GCRL (Lignes de Retours Clients) | GCO (Commerciaux) | GCRE (Retours Clients) GCLIENT (Clients) |
GCRL (Lignes de Retours Clients) | GCPE (Besoins de Gestion) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GCRL (Lignes de Retours Clients) | GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
GLL (OFs) | GCAF (Affaires) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCPE (Besoins de Gestion) |
GLL (OFs) | GCDE (Commandes Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GLL (OFs) | GCDL (Lignes Cde. Commerciales) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GLL (OFs) | GCLIENT (Clients) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCPE (Besoins de Gestion) |
GLL (OFs) | GCO (Commerciaux) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) GCDE (Commandes Commerciales) |
GLL (OFs) | GCPE (Besoins de Gestion) | GAD (Articles Standards) GCPL (Lignes Besoins de Gestion) |
GLL (OFs) | GCPL (Lignes Besoins de Gestion) | GAD (Articles Standards) |
Voir aussi INI-VAR-ENT