PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Priorité pour la définition de l'emplacement des fichiers du journal
  • Le fichier Journal existe lors de l'utilisation de la fonction HChangeRepJnl
  • Divers
  • Réplication et journalisation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HChangeRepJnl (Fonction)
En anglais : HChangeLogDir
HFSQLHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Modifie l'emplacement des fichiers du journal correspondant à un fichier de données HFSQL (fichier *JNL et fichiers JournalOpération et JournalIdentification si ils existent).
Rappel : Les fichiers JournalOpération et JournalIdentification sont créés uniquement :
  • si la gestion de la réplication est demandée pour le fichier de données.
  • si la gestion du journal sélectionnée correspond au "Journal des écritures et Historique des accès".
Si seul le journal des historiques d'accès est demandé, le fichier *JNL n'est pas créé.
Par défaut, les fichiers physiques correspondant aux journaux sont créés :
  • dans le répertoire spécifié sous l'analyse (option "Description de l'analyse", onglet "Journal/Réplication").
  • dans le répertoire spécifié lors de la description du fichier de données (option "Description du fichier de données" du menu contextuel, onglet "Divers"). Cette option est disponible uniquement si le répertoire de l'analyse correspond à "<Répertoire par défaut des fichiers>".
HFSQL Client/Serveur L'emplacement des fichiers du journal ne peut pas être modifié. Cette fonction est ignorée. L'emplacement du journal est configuré dans le fichier HFCONF.INI.
Hyper File 5.5 Cette fonction n'a aucun effet et renvoie toujours Vrai.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Exemple
WINDEVWEBDEV - Code ServeurAjaxHFSQLHFSQL Client/ServeurHyper File 5.5
// Le fichier "Client" est journalé
HChangeRepJnl(Client, "\\MonServeur\Journal\JNL", "\\MonServeur\Journal\Operation")
...
HAjoute(Client)
// -> le fichier "ClientJNL" est ouvert
// dans le répertoire "\\MonServeur\Journal\JNL"
//-> les fichiers "JournalOpération" et "JournalIdentification"
// sont ouverts dans le répertoire "\\MonServeur\Journal\Operation"
...
Syntaxe
<Résultat> = HChangeRepJnl(<Nom du fichier> , <Nouvel emplacement du fichier JNL> [, <Nouvel emplacement du fichier JournalOpération> [, <Emplacement sauvegarde>]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
Nom logique du fichier de données dont le journal doit être déplacé.
Si ce paramètre est égal à "*", tous les fichiers de données de l'analyse en cours auront leur fichier journal déplacé.
<Nouvel emplacement du fichier JNL> : Chaîne de caractères (avec guillemets)
Nouveau chemin d'accès au fichier JNL associé au fichier journalé (chemin complet ou relatif).
Si ce paramètre correspond à une chaîne vide (""), l'emplacement actuel du fichier n'est pas modifié.
<Nouvel emplacement du fichier JournalOpération> : Chaîne de caractères (avec guillemets) optionnelle
Nouveau chemin d'accès du fichier JournalOpération et du fichier JournalIdentification associé au fichier journalé (chemin complet ou relatif). Le fichier JournalOpération contient toutes les opérations effectuées sur le fichier journalé.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'emplacement actuel du fichier n'est pas modifié.
<Emplacement sauvegarde> : Chaîne de caractères (avec guillemets) optionnelle
Chemin des sauvegardes des fichiers journaux. Par défaut, ce chemin correspond à : <répertoire des fichiers JNL>\__JNLBackup
Ce chemin est utilisé lors de la modification automatique des fichiers de données pour archiver les journaux. La fonction HHistoriqueModification recherchera également l'historique des modifications dans ces fichiers.
Si ce paramètre correspond à une chaîne vide (""), l'emplacement actuel n'est pas modifié.
Si ce paramètre correspond à un chemin relatif (et commence par un point), le chemin sera relatif aux fichiers de données.
Remarques
WINDEVWEBDEV - Code ServeurWindowsLinuxWindows MobileAjaxHFSQLHFSQL Client/ServeurHyper File 5.5

Priorité pour la définition de l'emplacement des fichiers du journal

La définition de l'emplacement des fichiers journal se fait selon l'ordre de priorité suivant :
  1. Emplacement spécifié lors de la création du fichier journalé (fonction HCréation).
  2. Emplacement spécifié par la fonction HChangeRepJnl.
  3. Emplacement spécifié dans l'analyse.
  4. Emplacement du fichier journalé.
WINDEVWEBDEV - Code ServeurWindowsLinuxWindows MobileAjaxHFSQLHFSQL Client/ServeurHyper File 5.5

Le fichier Journal existe lors de l'utilisation de la fonction HChangeRepJnl

Si le fichier Journal existe déjà lors de l'appel à la fonction HChangeRepJnl, ce fichier journal n'est plus utilisé : un fichier journal est créé à l'emplacement spécifié et associé au fichier HFSQL journalé.
Utilisation de la fonction HDéclareExterne avec un fichier journalé : si une application utilise la fonction HDéclareExterne sur un fichier journalé, les modifications effectuées par cette application sont enregistrées dans les fichiers journaux spécifiés dans l'entête du fichier HFSQL journalé.
WINDEVWEBDEV - Code ServeurWindowsLinuxWindows MobileAjaxHFSQLHFSQL Client/ServeurHyper File 5.5

Divers

  • Si les fichiers sont ouverts lors de la modification du répertoire, les fichiers sont automatiquement fermés.
  • Si le chemin du journal est redéfini plusieurs fois avec la fonction HChangeRepJnl, seul le dernier chemin est utilisé. La modification est effective pour toutes les applications utilisant le fichier journalé.
WINDEVWEBDEV - Code ServeurWindowsWindows MobileAjaxHFSQLHFSQL Client/ServeurHyper File 5.5

Réplication et journalisation

Si la fonction HInitAbonné est utilisée, il est également nécessaire d'initialiser l'emplacement des journaux et des tables d'opérations (fonction HChangeRepJnl, propriétés ..RépertoireJournal, ..RépertoireJournalOpération).
Rappel : La réplication se base sur les journaux et tables d'opérations des fichiers de données. Si l'emplacement des journaux et des tables d'opérations est erroné, la réplication ne peut pas fonctionner.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire