4D v14.3

CHARGER SUR LIEN

Accueil

 
4D v14.3
CHARGER SUR LIEN

CHARGER SUR LIEN 


 

CHARGER SUR LIEN ( tableN | champN {; discriminant} ) 
Paramètre Type   Description
tableN | champN  Table, Champ in Table pour laquelle définir tous les liens automatiques ou Champ avec lien manuel partant vers la table 1
discriminant  Champ in Champ discriminant de la table 1

CHARGER SUR LIEN accepte deux syntaxes.

La première syntaxe de la commande, CHARGER SUR LIEN(tableN), active tous les liens aller automatiques (de N vers 1) pour la table tableN dans le process courant. Cela signifie que pour chaque champ de la tableN d'où part un lien aller automatique, la commande sélectionnera l'enregistrement lié dans chaque table liée. Cela peut donc modifier l'enregistrement courant dans la (les) table(s) liée(s) du process courant.

La seconde syntaxe, CHARGER SUR LIEN(champN{;discriminant}), recherche l'enregistrement lié au champ champN. Il n'est pas nécessaire que le lien soit automatique. S'il existe, CHARGER SUR LIEN charge en mémoire l'enregistrement lié, et en fait l'enregistrement et la sélection courants de la table à laquelle il appartient.

Le paramètre optionnel discriminant ne peut être spécifié que si champN est de type Texte ou Alpha. Le champ discriminant doit être un champ de la table liée. Il peut être de type Alpha, Texte, numérique, Date, Heure ou Booléen. Autrement dit, il ne peut être du type Image ou BLOB.

Si champN est spécifié, et si plus d'un enregistrement est trouvé dans la table liée, CHARGER SUR LIEN affiche une liste des enregistrements qui correspondent à la valeur de champN, permettant à l'utilisateur de sélectionner un enregistrement. Dans cette liste, la colonne de gauche affiche les valeurs des champs liés, la colonne de droite affiche les valeurs de discriminant.

Généralement, plusieurs enregistrements sont trouvés lorsque champN se termine par le caractère Joker (@). S'il n'y en a qu'un seul, la liste de sélection n'apparaît pas.

Dans l'écran ci-dessous, un enregistrement est en train d'être saisi et une liste de sélection s'affiche au premier plan.

La commande suivante a fait apparaître la liste de sélection :

 CHARGER SUR LIEN([Personnes]Société;[Sociétés]Région)

L'utilisateur a saisi SARL@ pour visualiser la liste de toutes les sociétés dont le nom commence par SARL, ainsi que leur région.

Spécifier un champ dans discriminant est la même opération que celle qui consiste à définir un champ discriminant dans la boîte de dialogue de définition des propriétés d'un lien en mode Développement. Pour plus d'informations sur la définition d'un champ discriminant, reportez-vous au manuel Mode Développement de 4D.

Exemple  

Dans l'exemple suivant, la table [Factures] est reliée à la table [Clients] par deux liens manuels. Un lien part du champ [Factures]AuNomDe et va vers le champ [Clients]Numéro, l'autre lien va de [Factures]ExpédierA à [Clients]Numéro.

Voici le formulaire de la table [Factures] affichant les informations "AuNomDe" et "ExpédierA".

Comme les deux liens pointent vers la même table, [Clients], l'information qu'ils récupèrent doit être affichée dans des variables. Si le formulaire contenait les champs de [Clients], seules les valeurs issues du second lien seraient affichées.

Les deux méthodes suivantes sont les méthodes objet des champs [Factures]ExpédierA et [Factures]AuNomDe. Voici la méthode objet du champ [Factures]AuNomDe :

 CHARGER SUR LIEN([Factures]AuNomDe;[Clients]Adresse)
 vAdress1:=[Clients]Adresse
 vVille1:=[Clients]Ville
 vPays1:=[Clients]Pays
 vCode1:=[Clients]CP

Voici la méthode objet du champ [Factures]ExpédierA :

 CHARGER SUR LIEN([Factures]ExpédierA;[Clients]Adresse)
 vAdress2:=[Clients]Adresse
 vVille2:=[Clients]Ville
 vPays2:=[Clients]Pays
 vCode2:=[Clients]CP

Si la commande a été correctement exécutée et si les enregistrements liés ont bien été chargés, la variable système OK prend la valeur 1. Si l'utilisateur a cliqué sur le bouton Annuler dans la boîte de dialogue de choix d'enregistrement (qui apparaît si l'enregistrement lié avait été modifié), la variable OK prend la valeur 0.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Liens
Numéro : 42
Nom intl. : RELATE ONE

Cette commande modifie la variable système OKCette commande change l'enregistrement courantCette commande change la sélection courante

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
VOIR AUSSI  

CHARGER ANCIEN
LIEN RETOUR

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)