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
  • Liaison avec une rubrique : types de liaison
  • Divers
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
FichierVersPage (Fonction)
En anglais : FileToPage
ODBCNon disponible avec ce type de connexion
Initialise automatiquement les champs d'une page avec :
  • les valeurs des rubriques associées dans l'enregistrement en cours (chargé en mémoire) du fichier de données décrit sous l'éditeur d'analyses. Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
  • les valeurs des variables WLangage associées. Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
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.
Remarque : La fonction FichierVersPage n'effectue aucune lecture du fichier de données. C'est la valeur de l'enregistrement chargé en mémoire qui est utilisée pour initialiser les champs. Il faut donc qu'un enregistrement soit au préalable chargé en mémoire (fonctions HLit, HLitRecherche, HLitPremier, ...).
Exemple
HLitRecherchePremier(CLIENT, NOM, "PAUL")
SI HTrouve() = Vrai ALORS FichierVersPage()

// Lecture de l'enregistrement et transfert des rubriques vers les champs
HLitPremier(CLIENT, NOM)
FichierVersPage()
Syntaxe
FichierVersPage([<Page> [, <Source>]])
<Page> : Nom de page
Nom de la page où les champs doivent être initialisés avec les valeurs de l'enregistrement en cours dans le fichier de données. Si ce paramètre n'est pas spécifié ou correspond à une chaîne vide (""), la page à 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 sont liées les champs à mettre à jour. Cette source peut être :
  • Le nom d'un fichier de données : seuls les champs ayant un lien avec une rubrique de 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 page ayant un lien avec une rubrique d'un fichier de données décrit sous l'éditeur d'analyses ou avec 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.

Liaison avec une rubrique : types de liaison

La liaison d'un champ vers une rubrique peut être de deux types :
  • liaison directe : Dans ce cas, la fonction FichierVersPage transfère la valeur des rubriques de l'enregistrement chargé en mémoire dans le champ relié, sans effectuer de lecture.
  • liaison par recherche dans un fichier de données relié.
WINDEVWEBDEV - Code ServeurWINDEV MobilePHPAjaxHFSQL ClassicHFSQL Client/ServeurHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Divers

  • Les espaces dans les rubriques HFSQL sont conservés.
  • La fonction FichierVersPage initialise les champs Image reliés à des rubriques de type mémo image.
  • La fonction FichierVersPage ne fonctionne pas avec les vues. Il est nécessaire d'initialiser un à un les champs avec le contenu des rubriques.
  • Liaison avec des rubriques de type "Mot de passe sécurisé" :
    • Dans un champ de saisie lié à une rubrique de type Mot de passe, les caractères "*****" sont affichés. Si le champ de saisie est de type "Mot de passe", des ronds sont alors affichés dans le champ de saisie.
    • La valeur de la rubrique "Mot de passe" ne peut pas être relue tant que l'utilisateur n'a pas modifié la valeur du mot de passe.
    • La valeur de la rubrique "Mot de passe" peut toujours être comparée a une chaîne de caractères (par exemple "" ou "1234").
Composante : wd300page.dll
Version minimum requise
  • Version 9
Commentaires
En cas de modification après initialisation de la COMBO
Après la mise à jour des valeurs liées (FichierVersPage) il peut être nécessaire de faire dans le code de fin d'initialisation de la page :

ListeAffiche(nom_de_la_combo)

pour tenir compte aussitôt d'une modification des valeurs liées intervenue après initialisation de la COMBO
Cf https://forum.pcsoft.fr/fr-FR/pcsoft.fr.windev.old/12777-wd11-rafraichir-champ-combo-lie-fichier/read.awp
CV
26 fév. 2018

Dernière modification : 03/06/2024

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