DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • 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/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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 "Journalisation").
Analyse
  • 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 "Jounalisation"). Cette option est disponible uniquement si le répertoire de l'analyse correspond à "<Répertoire par défaut des fichiers>".
Option dans l'analyse
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.
Exemple
// 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(<Fichier de données> , <Emplacement du fichier JNL> [, <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.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données dont le journal doit être déplacé. Ce nom est le nom logique du fichier (défini dans l'éditeur d'analyses).
Si ce paramètre est égal à "*", tous les fichiers de données de l'analyse en cours auront leur fichier journal déplacé.
<Emplacement du fichier JNL> : Chaîne de caractères
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é.
<Emplacement du fichier JournalOpération> : Chaîne de caractères 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 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

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é.

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é.

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é.

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 : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/06/2023

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