DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
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
HRégénèreFichier (Fonction)
En anglais : HRegenerateFile
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Régénère un fichier de données à partir de son journal.
Rappel : Lorsque un fichier de données journalé est perdu, il est possible de le régénérer à partir de son journal. Il est conseillé pour cela d'utiliser l'outil de maintenance du journal.
Attention : La fonction HRégénèreFichier permet de recréer un fichier de données à partir de la description du journal.

Cette fonction est réservée à une utilisation avancée. Mal utilisée, cette fonction peut détruire ou corrompre les données.
Exemple
// Le fichier de données "Client" est journalé.
// Le fichier de données "Client" se trouve dans le répertoire "C:\Données".
// Le journal du fichier de données "Client.fic" se trouve dans le répertoire "C:\Journal".
// Le fichier de données "Client" a été détruit.
// Reconstruction du fichier de données à partir du journal
HRégénèreFichier("C:\Journal\ClientJNL.fic", hStructure + hDonnées)
Syntaxe
WINDEVWEBDEV - Code ServeurAjaxHFSQL ClassicHyper File 5.5

Régénération du fichier de données en mode HFSQL Classic Masquer les détails

<Résultat> = HRégénèreFichier(<Fichier journal> [, <Mot de passe> [, <Répertoire destination>]] [, <Options> [, <Date et heure de début de restauration> [, <Date et heure limite de restauration> [, <Jauge de restauration> [, <Jauge de réindexation>]]]]])
<Résultat> : Booléen
  • Vrai si le fichier de données a été régénéré,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Fichier journal> : Chaîne de caractères
Nom complet du fichier journal à utiliser.
<Mot de passe> : Chaîne de caractères optionnelle
  • Mot de passe du fichier journal (identique au mot de passe défini sur le fichier de données). Ce mot de passe est obligatoire pour préciser un répertoire de destination.
  • Chaîne vide ("") si il n'y a pas de mot de passe.
<Répertoire destination> : Chaîne de caractères optionnelle
Nom complet du répertoire où sera régénéré le fichier de données.
Si ce paramètre n'est pas défini, le fichier de données est régénéré dans son répertoire d'origine.
<Options> : Constante ou combinaison de constantes optionnelle
Paramètre la régénération du fichier. Par défaut (aucune option sélectionnée), la fonction n'a aucun effet.
hDonnéesToutes les opérations conservées dans le fichier journal sont appliquées au fichier de données existant. Les données du fichier sont mises à jour avec les données du journal.
hStructureUn nouveau fichier de données vide est créé à partir de la description du fichier de données contenue dans le fichier journal. Si le fichier de données existe déjà, il est effacé puis recréé.
<Date et heure de début de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC : AAAA : année, MM : mois, JJ : jour, HH : heure, mm : minutes, SS : secondes, CCC : centièmes de seconde) à partir desquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. Le fichier de données sera mis à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Date et heure limite de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC : AAAA : année, MM : mois, JJ : jour, HH : heure, mm : minutes, SS : secondes, CCC : centièmes de seconde) jusqu'auxquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. Le fichier de données sera mis à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Jauge de restauration> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la restauration des données.
<Jauge de réindexation> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la réindexation des données (après leur restauration).
WINDEVWEBDEV - Code ServeurAjaxHFSQL Client/Serveur

Régénération du fichier de données en mode HFSQL Client/Serveur Masquer les détails

<Résultat> = HRégénèreFichier(<Connexion> , <Fichier journal> [, <Mot de passe> [, <Répertoire destination>]] [, <Options> [, <Date et heure de début de restauration> [, <Date et heure limite de restauration> [, <Jauge de restauration> [, <Jauge de réindexation>]]]]])
<Résultat> : Booléen
  • Vrai si le fichier de données a été régénéré,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Chaîne de caractères
Connexion pour laquelle la base de données doit être regénérée. Cette connexion correspond :
<Fichier journal> : Chaîne de caractères
Nom du fichier journal à utiliser. Le chemin de ce fichier est relatif à la base de données JNL de la connexion (voir Structure des fichiers Journal en mode Client/Serveur).
<Mot de passe> : Chaîne de caractères optionnelle
  • Mot de passe du fichier journal (identique au mot de passe défini sur le fichier de données). Ce mot de passe est obligatoire pour préciser un répertoire de destination.
  • Chaîne vide ("") si il n'y a pas de mot de passe.
<Répertoire destination> : Chaîne de caractères optionnelle
Nom du répertoire où sera régénéré le fichier de données. Ce répertoire est relatif à la base de données définie par la connexion. Si ce paramètre n'est pas défini, le fichier de données est régénéré dans son répertoire d'origine.
<Options> : Constante ou combinaison de constantes optionnelle
Paramètre la régénération du fichier de données. Par défaut (aucune option sélectionnée), la fonction n'a aucun effet.
hDonnéesToutes les opérations conservées dans le fichier journal sont appliquées au fichier de données existant. Les données du fichier sont mises à jour avec les données du journal.
hStructureUn nouveau fichier de données vide est créé à partir de la description du fichier contenue dans le fichier journal. Si le fichier de données existe déjà, il est effacé puis recréé.
<Date et heure de début de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC : AAAA : année, MM : mois, JJ : jour, HH : heure, mm : minutes, SS : secondes, CCC : centièmes de seconde) à partir desquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. Le fichier de données sera mis à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Date et heure limite de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC : AAAA : année, MM : mois, JJ : jour, HH : heure, mm : minutes, SS : secondes, CCC : centièmes de seconde) jusqu'auxquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. Le fichier de données sera mis à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Jauge de restauration> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la restauration des données.
<Jauge de réindexation> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la réindexation des données (après leur restauration).
Remarques
La fonction HRégénèreFichier peut être utilisée uniquement sur des fichiers de données HFSQL (Classic ou Client/Serveur) journalés.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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