Permet de savoir :
- si le contenu d'un fichier de données a été modifié.
- si le contenu d'un fichier de données utilisé par une requête a été modifié.
Cette fonction permet par exemple de détecter des modifications effectuées sur un fichier de données partagé entre plusieurs programmes. Si une modification est détectée, il est par exemple possible de rafraîchir les données affichées dans la fenêtre ou dans la page.
NumVer = HVersion(Client)
// Première évaluation de la version du fichier de données
NumVer est un entier
NumVer = HVersion(Client)
// Traitements
// Deuxième évaluation de la version du fichier de données
SI NumVer <> HVersion(Client) ALORS
Info("Le fichier de données Client a été modifié.")
FIN
Syntaxe
<Résultat> = HVersion([<Fichier de données ou requête>])
<Résultat> : Entier
Numéro de version du fichier de données.
<Fichier de données ou requête> : Chaîne de caractères optionnelle
- Nom du fichier de données manipulé.
- Nom de la requête manipulée.
- Si ce paramètre n'est pas spécifié, la fonction HVersion va manipuler le dernier fichier de données (dernière requête) manipulé.
Remarques
Incrémentation du numéro de version du fichier de données
A la création du fichier de données, le numéro de version est initialisé à 1. Ce numéro est incrémenté à chaque modification du contenu du fichier (
HAjoute,
HEcrit,
HModifie,
TableEnregistre,
TableSupprime,
HLibère,
HSupprime,
HRaye). Le numéro est incrémenté uniquement en cas de succès de la fonction.
Remarque : La fonction HVersion peut être utilisée sur les fichiers de données indexés ou non indexés.
Requêtes multifichiers
Dans le cas d'une requête multifichier, la fonction
HVersion retourne la somme des
HVersion de tous les fichiers de données concernés par la requête.