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
<Page>.VersFichier (Fonction)
En anglais : <Page>.ToFile
ODBCNon disponible avec ce type de connexion
Initialise automatiquement :
  • la valeur mémoire des rubriques d'un fichier de données avec la valeur des champs de la page. Les rubriques du fichier de données de base reliées aux champs de la page sont automatiquement affectées avec les valeurs des champs correspondants.
  • la valeur des variables WLangage avec la valeur des champs de la page. Les variables WLangage reliées aux champs de la page sont automatiquement affectées avec les valeurs des champs correspondants.
Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
Remarques :
  • La fonction <Page>.VersFichier 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 <Source>.Ajoute, <Source>.Modifie, <Source>.Ecrit, etc.
  • 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" 
PAGE_Client.VersFichier()
Client.Ajoute()
SI HErreurDoublon() = Vrai ALORS Erreur("Ce numéro existe déjà")
Syntaxe
<Page>.VersFichier([<Source>])
<Page> : Nom de page
Nom de la page où les champs sont présents.
<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 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 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 <Page>.VersFichier :
    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 <Page>.VersFichier.
  • 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 <Page>.VersFichier. 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 <Page>.VersFichier n'affecte pas les rubriques pour les champs de type Image. Utilisez la fonction <Source>.AttacheMémo.
  • La fonction <Page>.VersFichier 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.
Composante : wd300page.dll
Version minimum requise
  • Version 24
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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