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
  • Mise à jour données contenues dans les champs Table (ou dans les champs Zone répétée)
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>.VersSource (Fonction)
En anglais : <Page>.ToSource
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>.VersSource ne permet pas d'écrire dans le fichier de données : seules les variables des rubriques de 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 sont gérées. La liaison avec les variables WLangage n'est pas gérée dans cette version.
Exemple
// Clic sur BTN_AJOUTER
PAGE_Client.VersSource()
Client.Ajoute
SI HErreurDoublon() = Vrai ALORS
	Erreur("Ce numéro existe déjà")
FIN
Syntaxe
<Page>.VersSource([<Source>])
<Page> : Nom de page
Nom de la page où les champs sont présents.
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.
<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/page 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 <Page>.VersSource :
    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>.VersSource.
  • 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>.VersSource. 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>.VersSource n'affecte pas les rubriques pour les champs de type Image. Utilisez la fonction <Source>.AttacheMémo.
  • La fonction <Page>.VersSource 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.

Mise à jour données contenues dans les champs Table (ou dans les champs Zone répétée)

La fonction <Page>.VersSource est sans effet sur le contenu d'un champ Table.
Le transfert effectif des données d'un champ Table vers sa source de données (fichier de données ou variable) se fait lors de l'enregistrement. Cet enregistrement est effectué :
  • en sortie de saisie, si l'option "Enregistrer en sortie de ligne (Modif.)" est sélectionnée (onglet "Détail" de la fenêtre de description du champ Table),
  • avec la fonction <Table>.Enregistre.
Le même principe s'applique aux champs Zone répétée liés à une source de données.
Composante : wd290page.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