LIRE LIEN CHAMP

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 2004


LIRE LIEN CHAMP (champN; aller; retour{; *})

ParamètreTypeDescription
champNChampChamp de départ du lien
allerEntier longStatut du lien aller
retourEntier longStatut du lien retour
** Si passé : aller et retour retournent le statut courant
effectif du lien (valeurs 2 ou 3 uniquement)
Si omis (défaut) : aller et retour peuvent retourner
la valeur 1 si le lien n'a pas été modifié par
programmation

Description

La commande LIRE LIEN CHAMP permet de connaître le statut automatique/manuel du lien partant du champN pour le process courant. Tous les liens peuvent être consultés, y compris les liens déclarés automatiques dans la fenêtre de Structure.

Passez dans champN le nom du champ de la table N d'où part le lien dont vous souhaitez connaître le statut. Si aucun lien ne part du champ champN, les paramètres aller et retour retournent 0, une erreur est générée et la variable système OK prend la valeur 0 (cf. ci-dessous).

Après l'exécution de la commande, la variable aller contient une valeur indiquant si le lien aller spécifié est défini comme automatique :

0 = il n'y a pas de lien partant de champN. L'erreur de syntaxe n°16 ("Ce champ ne possède pas de lien") est générée et la variable système OK prend la valeur 0.
1 = le statut automatique/manuel du lien aller spécifié est celui défini par l'option Lien aller auto dans les propriétés du lien en mode Développement (il n'a pas été modifié par programmation).
2 = le lien N vers 1 est manuel pour le process.
3 = le lien N vers 1 est automatique pour le process.

Après l'exécution de la commande, la variable retour contient une valeur indiquant si le lien retour spécifié est défini comme automatique :

0 = il n'y a pas de lien partant de champN. L'erreur de syntaxe n°16 ("Ce champ ne possède pas de lien") est générée et la variable système OK prend la valeur 0.
1 = le statut automatique/manuel du lien retour spécifié est celui défini par l'option Lien retour auto dans les propriétés du lien en mode Développement (il n'a pas été modifié par programmation).
2 = le lien 1 vers N est manuel pour le process.
3 = le lien 1 vers N est automatique pour le process.

Vous pouvez comparer les valeurs reçues dans les paramètres aller et retour aux constantes du thème "Liens" :

ConstanteTypeValeur
Pas de lienEntier long0
Configuration StructureEntier long1
ManuelEntier long2
AutomatiqueEntier long3

Le paramètre facultatif * permet de "forcer" la lecture du statut courant du lien, même s'il n'a pas été modifié par programmation. Autrement dit, lorsque vous passez le paramètre *, seules les valeurs 2 ou 3 peuvent être retournées dans les paramètres aller et retour.

Exemple

Soit la structure suivante :

Les propriétés du lien reliant le champ [Employés]Société au champ [Sociétés]Nom sont les suivantes :

Le code ci-dessous illustre les différentes possibilités offertes par les commandes LIRE LIEN CHAMP, LIRE LIENS AUTOMATIQUES, FIXER LIEN CHAMP et FIXER LIENS AUTOMATIQUES ainsi que leurs effets :

   LIRE LIENS AUTOMATIQUES(liens_Appel;liens_Retour)  `retourne Faux, Faux
   LIRE LIEN CHAMP([Employés]Société;aller;retour)  `retourne 1,1
   LIRE LIEN CHAMP([Employés]Société;aller;retour;*)  `retourne 3,2

   FIXER LIEN CHAMP ([Employés]Société;2;0)  `passe le lien N vers 1 en manuel

   LIRE LIEN CHAMP([Employés]Société;aller;retour) `retourne 2,1
   LIRE LIEN CHAMP([Employés]Société;aller;retour;*) `retourne 2, 2

   FIXER LIEN CHAMP ([Employés]Société;1;0)  `rétablit les paramètres définis en 
                              `structure pour le lien N vers 1 

   LIRE LIEN CHAMP([Employés]Société;aller;retour)  `retourne 1,1
   LIRE LIEN CHAMP([Employés]Société;aller;retour;*)  `retourne 3,2

   FIXER LIENS AUTOMATIQUES(Vrai;Vrai) `passe tous les liens de toutes les tables en automatique

   LIRE LIENS AUTOMATIQUES(liens_Appel;liens_Retour) `retourne Vrai, Vrai
   LIRE LIEN CHAMP([Employés]Société;aller;retour)  `retourne 1,1
   LIRE LIEN CHAMP([Employés]Société;aller;retour;*)  `retourne 3,3

Référence

FIXER LIEN CHAMP, FIXER LIENS AUTOMATIQUES, LIRE LIENS AUTOMATIQUES, LIRE PROPRIETES LIEN.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant