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 <Source>.ChangeRepJnl
  • 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 JournalOperation et JournalIdentification s'ils existent).
Rappel : Les fichiers JournalOperation 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é
Client.ChangeRepJnl("\\MonServeur\Journal\JNL", "\\MonServeur\Journal\Operation")
...
Client.Ajoute()
// -> le fichier "ClientJNL" est ouvert 
// dans le répertoire "\\MonServeur\Journal\JNL"
//-> les fichiers "JournalOperation" et "JournalIdentification" 
// sont ouverts dans le répertoire "\\MonServeur\Journal\Operation"
...
Syntaxe
<Résultat> = <Source>.ChangeRepJnl(<Emplacement du fichier JNL> [, <Emplacement du fichier JournalOperation> [, <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.
<Source> : Type correspondant à la source spécifiée
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).
<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 JournalOperation> : Chaîne de caractères optionnelle
Nouveau chemin d'accès du fichier JournalOperation et du fichier JournalIdentification associé au fichier journalé (chemin complet ou relatif). Le fichier JournalOperation 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 <Source>.HistoriqueModification 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 <Source>.Création).
  2. Emplacement spécifié par la fonction <Source>.ChangeRepJnl.
  3. Emplacement spécifié dans l'analyse.
  4. Emplacement du fichier journalé.

Le fichier Journal existe lors de l'utilisation de la fonction <Source>.ChangeRepJnl

Si le fichier Journal existe déjà lors de l'appel à la fonction <Source>.ChangeRepJnl, 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 <Source>.DéclareExterne avec un fichier journalé : si une application utilise la fonction <Source>.Dé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 <Source>.ChangeRepJnl, 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 <Source>.InitAbonné est utilisée, il est également nécessaire d'initialiser l'emplacement des journaux et des tables d'opérations (fonction <Source>.ChangeRepJnl, 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 : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 10/04/2024

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