DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions Liaison
  • Lien d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données
  • Mise à jour des rubriques : Cas particuliers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Initialise automatiquement :
  • la valeur mémoire des rubriques d'un fichier de données avec la valeur des champs de la fenêtre. Les rubriques du fichier de données de base reliées aux champs de la fenêtre sont automatiquement affectées avec les valeurs des champs correspondants (même si ces champs sont grisés, inactifs, ou invisibles).
  • la valeur des variables WLangage avec la valeur des champs de la fenêtre. Les variables WLangage reliées aux champs de la fenêtre sont automatiquement affectées avec les valeurs des champs correspondants (même si ces champs sont grisés, inactifs, ou invisibles).
Remarques :
  • La fonction EcranVersFichier ne permet pas d'écrire dans le fichier de données : seules les variables des rubriques du fichier de données sont affectées (c'est-à-dire les variables de l'enregistrement chargé en mémoire). Pour modifier les enregistrements, il faut utiliser les fonctions HAjoute, HModifie, HEcrit, etc.
  • WEBDEV - Code ServeurPHP Cette fonction est également disponible pour les pages WEBDEV. Elle est équivalente à la fonction PageVersFichier.
  • PHP Seule la liaison avec les rubriques d'un fichier de données est gérée. La liaison avec les variables WLangage n'est pas gérée dans cette version.
Exemple
// Clic sur le bouton "Ajouter"
EcranVersFichier()
HAjoute(Client)
SI HErreurDoublon() = Vrai ALORS 
	Erreur("Ce numéro existe déjà")
FIN
Syntaxe
EcranVersFichier([<Fenêtre> [, <Source>]])
<Fenêtre> : Nom de fenêtre
Nom de la fenêtre où les champs sont présents. Si ce paramètre n'est pas spécifié ou correspond à une chaîne vide (""), la fenêtre à laquelle appartient le code en cours est utilisée.
PHP Si ce paramètre est spécifié, il doit correspondre au nom de la page en cours. Dans le cas contraire, une erreur est affichée.
<Source> : Chaîne de caractères optionnelle
Nom de la source à laquelle appartiennent les données à mettre à jour. Cette source peut être :
  • Le nom d'un fichier de données : seuls les champs ayant un lien avec ce fichier de données sont pris en compte.
  • Le nom d'une variable WLangage : seuls les champs ayant un lien avec cette variable WLangage sont pris en compte.
    Remarques :
    • Si le nom de la variable est indiqué entre guillemets, la liaison sera effectuée avec la variable spécifiée.
    • Si le nom de la variable n'est pas indiqué entre guillemets, la liaison sera effectuée avec le contenu de la variable (cas par exemple d'une variable contenant le nom d'une autre variable).
Si ce nom n'est pas spécifié, tous les champs de la fenêtre ayant un lien avec un fichier de données décrit sous l'éditeur d'analyses ou une variable WLangage sont pris en compte.
Remarques

Lien d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données

La liaison d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données peut être connue :
  • Sous l'éditeur, dans la fenêtre de description du champ (onglet "Liaison").
  • Par programmation, grâce à la propriété LiaisonFichier.

Mise à jour des rubriques : Cas particuliers

  • Pour affecter automatiquement la valeur NULL à une rubrique avec la fonction EcranVersFichier :
    1. Cochez l'option "NULL supporté" pour le fichier de données dans l'éditeur d'analyses.
    2. Cochez l'option "NULL autorisé" pour la rubrique dans l'éditeur d'analyses.
    3. Cochez l'option "Retourner NULL si vide" dans l'onglet "Détail" de la fenêtre de description du champ de saisie associé à la rubrique.
  • Les rubriques du fichier de données non reliées à un champ ne sont pas mises à jour par la fonction EcranVersFichier.
  • Si plusieurs champs de la fenêtre (ou de la page) sont reliés à une même rubrique du fichier de données, la rubrique reliée peut ne pas être mise à jour correctement par la fonction EcranVersFichier. Il est déconseillé de relier plusieurs champs d'une fenêtre (ou d'une page) à une même rubrique d'un fichier de données.
  • La fonction EcranVersFichier n'affecte pas les rubriques pour les champs de type Image. Utilisez la fonction HAttacheMémo.
  • La fonction EcranVersFichier ne fonctionne pas avec les vues.
  • Liaison avec des rubriques de type "Mot de passe sécurisé" : La valeur de la rubrique "Mot de passe sécurisé" n'est pas modifiée tant que l'utilisateur n'a pas modifié la valeur dans le champ lié à la rubrique.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/05/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale