PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HRégénèreFichier (Fonction)
En anglais : HRegenerateFile
HFSQLHFSQL 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.
Windows Mobile Attention : La journalisation est disponible uniquement en mode Client/Serveur.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
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 ServeurWindows MobileAjaxHFSQLHyper 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.
Windows Mobile Cette fonction est utilisable uniquement sur des fichiers de données HFSQL Client/Serveur. Cette fonction renvoie Vrai mais n'a aucun effet sur des fichiers de données HFSQL Mobile.
<Fichier journal> : Chaîne de caractères (avec guillemets)
Nom complet du fichier journal à utiliser.
<Mot de passe> : Chaîne de caractères optionnelle (avec guillemets)
  • 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 (avec guillemets)
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 ServeurWindows MobileAjaxHFSQL 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.
Windows Mobile Cette fonction est utilisable uniquement sur des fichiers de données HFSQL Client/Serveur. Cette fonction renvoie Vrai mais n'a aucun effet sur des fichiers de données HFSQL Mobile.
<Connexion> : Chaîne de caractères (avec ou sans guillemets)
Connexion pour laquelle la base de données doit être regénérée. Cette connexion correspond :
<Fichier journal> : Chaîne de caractères (avec guillemets)
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 (avec guillemets)
  • 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 (avec guillemets)
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 AAAAMMJJHHMMSSMMM : AAAA : année, MM : mois, JJ : jour, HH : heure, MM : minutes, SS : secondes, CC : 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 AAAAMMJJHHMMSSMMM : AAAA : année, MM : mois, JJ : jour, HH : heure, MM : minutes, SS : secondes, CC : 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 : wd250hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire