Rescue for 4D Data - Documentation

DOCUMENTATION RESCUE FOR 4D Data - Doctor

DOCTOR

Doctor
- Choix des tables à contrôler
Vérifier seulement (Only Log)
- Lancer ou arrêter la vérification
- Messages de Doctor
Vérification et correction manuelles
Vérification et correction automatiques
Compléments d'informations
Enregistrer un Log

Doctor :

Rescue For 4D Data est prévu pour vous apporter un maximum d'aide dans la réparation de vos bases. Cependant, il ne fera pas de miracle avant la version 2000 ;-)))

Rescue For 4D Data récupère tout ce qu'il peut. Cependant, il supprimera les enregistrements vraiment trop endommagés. Son travail est donc de remettre le data en état de fonctionnement. Mais cela ne suffira pas toujours.

En effet, 4D est une base de donnée relationnelle très évoluée avec des contrôles d'intégrité automatiques.

Ces derniers risquent fort d'être perturbés après une réparation qui a supprimé des enregistrements.

Imaginons une table A liée à une table B par un lien automatique avec intégrité référencielle. Il sera impossible de valider une fiche B sans la fiche correspondante dans A.

Un autre cas plus simple, avec ou sans contrôle d'intégrité, avec ou sans lien. Soit un fichier Facture et un fichier Client. Si une fiche Client est supprimée, comment va réagir votre base par la suite ?

Doctor permet d'ouvrir les data créés par 4ème Dimension :

version supérieure à 5.1.x,
version 6.0.X et
version 6.5.

Suivant les options sélectionnées dans les Préférences, Doctor vérifie :

Les Index : Vérification des index (Vérification des Headers, type d'index, si la fiche existe bien pour cet index, du nombre d'index par rapport au nombre de fiches).
Les tables Primaires d'Adresse (PRA) : vérifient la cohérence de la Primary Record Address.
Les tables Secondaires d'Adresse (SRA): vérifient la cohérence de la Secondary Record Adress.
Delete Records : vérifie la cohérence de la table d'effacement.

L'entête des enregistrements (Record Headers) : vérifie la cohérence de l'entête des enregistrements.
Le contenu de chaque champ.

Suivant l'option choisie dans le pop up menu de la zone Action, Doctor :

N'effectue pas de corrections (option Log Only),

Vous permet de corriger manuellement (option Manual correction),
Ou corrige automatiquement (option Auto correction).

Le Log fonctionne avec le bouton supplémentaire des souris Intellimouse de Microsoft©.

Choix des tables à vérifier

Vous pouvez choisir les tables à vérifier. Cliquez sur le bouton, à droite de la zone Action

La fenêtre de sélection des tables apparait :

Le bouton Select All permet de sélectionner ou de désélectionner toutes les tables.
Pour Sélectionner ou désélectionner une table, cliquer sur l'icône

Cliquez sur le bouton Use It pour valider votre choix ou sur le bouton Cancel pour annuler.
Vérifier seulement (Only Log):: Vérifier seulement (Only Log):

Lancer ou Arrêter la vérification
Pour lancer ou Arrêter la vérification, cliquez sur le bouton

Les messages du Doctor:

jeudi 11 février 1999
La date de la vérification.

Start Log On "MyDataBase.4dD".
Le type d'opération et le nom du fichier de structure analysé.

Used On 4D v5 Macintosh.
La version de 4D et le type de machine sur laquelle la base est utilisée.

Data File Size : 6891520 Bytes.
La taille du fichier data en octets.

Checking Resources :
Expert Log.
Checking Index.
Checking PRA Table.
Checking SRA Table.
Checking Deleted Records.
Checking Record Headers.
Checking Record Fields.

Checking Alpha Fields.
Checking Integer Fields.
Checking Long Fields.
Checking Real Fields.
Checking Date Fields.
Checking Time Fields.
Checking Boolean Fields.
Checking SubFields.
Checking Text Fields.
Checking Picture Fields.
Checking Blob Fields.

Vérifications effectuées suivant le réglage des Préférences.

Checking Data File Tables :
Allocation Table Size 23552 Bytes.
10 File(s), 35 Index.
File Information Table Size 362 Bytes.
114157 Operations Make In Data File Since Last 4D Tool Compact.

- " 4D Was Interrupted When Saving A Bit Table ".
- " 4D Was Interrupted When Saving An Index ".
- " 4D Was Interrupted When Deleting An Index ".
- " 4D Found An Invalid Record Address ".
- " 4D Was Interrupted When Flushing Cache "

- "4D Has A Unknow Operation TAG"

La taille de la table d'allocation en octets.
Le nombre de fichiers, le nombre d'index
La taille de la FIT en octets
Le nombre d'opérations effectuées sur le data depuis le dernier compactage avec 4D Util.

L'entête du log affiche l'état 4D lorsque la base a été quittée pour la dernière fois :

Le doctor ne change pas ce flag.
Il est possible de modifier ce flag dans l'Editor.

Ce message indique un flag non documenté.

Vérification des enregistrements

Checking "FSE":
Début du travail sur le fichier FSE.

Checking PRA Validity...
Checking PRA Loading...Ok

Checking SRA Validity...
2 SRA Table(s) Used 32768 Bytes.

Checking SRA Loading...Ok
Checking SRA / Record Position...Ok
Checking SRA / Deleted Records...Ok

Checking Record Validity...
6478 Record(s) In File.
0 Unused Record(s) Address(es).

Vérification de la Primary Record Adress.

Vérification de la Secondary Record Adress.
Nombre de SRA et taille en octets

Vérification de l'adresse de l'enregistrement
et de la table d'effacement

Vérification des enregistrements
Nombre de fiches trouvées
Nombre d'enregistrements effacés.

Checking Records...Ok
Résultat de la vérification des enregistrements de la table

Autres Messages suivant les réglages des Préférences de Doctor:

Problème d'entête
Message

Solution Rescue For 4D Data

Vérification des PRA.

PRA cannot be loaded. This file cannot be repaired.

Contacter
JCS Développement

Vérification des SRA

SRA cannot be loaded.

Suppression de la SRA et des 1024 enregistrements qui lui sont liés (512 en v6).

Vérification des adresses des enregistrements.

Error on SRA record nX.

Suppression de l’enregistrement associé.

Fin de la delete Table introuvable.

Error Delete Table

Recréation par Rescue For 4D Data de la table de suppression sans altération des données.

Nombre d’enregistrements supprimés different dans la Delete Table et dans la SRA.

Error On SRA Deleted Records

Recréation par Rescue For 4D Data de la table de suppression sans altération des données.

Table de suppression endommagée.

Bad Delete Table, Impossible To Count Records.

Recréation par Rescue For 4D Data de la table de suppression sans altération des données.

Vérification des Index

Checking Index "[FSE]NumCard"	Début du travail sur l'index du champ 'NumCard' de la table 'FSE'.
Index Type Long Integer. Checking Headers & Values : Index Number Different from Record Number.	Type d'index Vérification des Index et de leur valeur Résultat du contrôle -> OK ou message d'erreur

Autres Messages suivant les réglages des Préférences de Doctor:

Problème Message Solution Rescue For 4D Data Vérifie que les index sont de type connu (Alpha, Entier, etc.) Bad Index Type. Suppression d’index et reconstruction par 4D. Vérifie qu’il existe bien une fiche attachée, puis la charge. Corresponding Record Not Found. Suppression d’index et reconstruction par 4D. Vérifie la bonne correspondance entre le nombre de clés d’index et le nombre de fiches. Index Number Different From Record Number. Suppression d’index et reconstruction par 4D. Les headers de l’index sont mauvais. Bad Index Headers. Suppression d’index et reconstruction par 4D. L’index contient une valeur interdite du type alpha > 80 car, Bool != 0 ou 1. Bad Index Value. Suppression d’index et reconstruction par 4D. Index gravement endommagé, ou Rescue For 4D Data n’arrive pas à le lire. INDEX CAUSES EXCEPTION. This index cannot be parsed. Suppression d’index et reconstruction par 4D.

Récapitulatif de l'analyse du Doctor

Doctor Analysis :	Récapitulatif de l'analyse du Doctor.
Analysis Time : 00:00:48 Total Major Error: 1. Total Minor Error: 0. Warning(s) Total: 0.. Doctor Corrected Nothing. Use This Database With CAUTION...	Durée de l'analyse. Nombre d'erreurs graves. Nombre d'erreurs secondaires. Nombre de warnings Conseil du Doctor

Correction manuelle :

Pour chaque erreur détectée, un dialogue apparaît.

Ce dialogue indique :

Des informations sur l'objet qui pose problème : zone Record,
Le problème rencontré : zone Problem,
Une explication sur ce que fera Doctor si vous choisissez de corriger : zone Advice,
et le conseil de Doctor, ici : 'Press Correct to DELETE the character'.

Comme toujours, la décision finale vous appartient. (Avertissement)

Le bouton Stop Doctor vous permet d'annuler l'action de Doctor.

La case à cocher Auto Correct permet de demander à Rescue For 4D Data de corriger automatiquement le type d'erreur présenté s'il se présente à nouveau (très utile, surtout sur les erreurs de filtrage Alpha qui risquent d'être assez répétitives).

Messages possibles en correction manuelle :

Problème de chargement d'un enregistrement Message Solution Rescue For 4D Data Mauvaise Structure de fiche RECORD STRUCTURE : This record has a bad structure Suppression de la fiche. Fiche non trouvée RECORD NOT FOUND : This record cannot be found Suppression de la fiche. Taille de la fiche trop grande OUT OF MEMORY : This record cannot be Loaded Suppression manuelle de la fiche dans le Doctor ou l'Editor (c'est peut-être un objet de taille importante qui ne peut pas être chargé). Mauvaise entête de fiche BAD RECORD HEADER : This record cannot be loaded Suppression de la fiche. Table n'existe pas FILE DOES NOT EXIST: This record cannot be loaded Suppression de la fiche. SRA non trouvée SRA NOT FOUND : This record cannot be load Suppression de la fiche. Fiche n'existe pas RECORD DOES NOT EXIST: This record cannot be loaded Suppression de la fiche. Fiche supprimée DELETED RECORD : This record cannot be loaded Suppression de la fiche. Erreur cache de SRA SRA CACHE ERROR : This record cannot be loaded Rien (bug) Mauvaise table de suppression BAD DELETE TABLE : This record cannot be loaded Correction par Rescue For 4D Data (sans perte de données) Mauvaise SRA BAD SRA : This record cannot be loaded Suppression de la fiche. SRA ne peut pas être chargée SRA CANNOT BE LOADED: Impossible to read this SRA Suppression de la SRA. Taille de fiche trop grande RECORD SIZE OUT OF DATA FILE: This record cannot be loaded Suppression de la fiche. Exception erreur RECORD CAUSES EXCEPTION: This record cannot be parsed Erreur grave (Bug Rescue ou Data très endommagé) Fiche trop grande RECORD OUT OF DATA FILE (SRA): This record cannot be loaded Suppression d'adresse de la fiche dans la SRA. Mauvaise table d'effacement BAD TRASH TABLE : Table Data Damaged Correction par Rescue For 4D Data (sans perte de données) Problème sur les champs Message Solution Rescue For 4D Data Type de rubrique inconnu. UNKNOWN FIELD: This record contains an unknown field type Suppression de la fiche. Alpha Size ALPHA SIZE : This alpha field has more than 80 characters La taille d'un alpha dépasse 80 caractères. Rescue For 4D Data fixe la taille à 80. Il y a de fortes chances pour que la fiche soit endommagée. Type de rubrique Alpha ALPHA FIELD : This field contains a character you defined as a Warning (in Preferences) Uniquement Warning Suppression de caractères Alpha ALPHA FIELD: This field contains a character you defined to delete (in Preferences) Suppression du caractère Remplacement de caractères Alpha ALPHA FIELD: This field contains a character you defined to replace (in Preferences) Remplacement du caractère Valeur différente de 0 ou 1 BOOLEAN FIELD : This field contains unreferenced data Mise à '1' de la valeur La valeur n’est pas une date existante. DATE FIELD: This date is not correct. It does not contain proper month and/or day values. Uniquement Warning Erreur NAN FLOAT FIELD: This field contains a calculation error or an infinite value. Mise à '0' de la valeur. Taille supérieure à 32767 TEXT FIELD: This text field is greater than the maximum text size allowed by 4D. Suppression de la fiche. Warning taille champ de type Texte TEXT FIELD: This text field is larger than the size you designated in Preferences. Uniquement Warning Warning taille champ de type Image PICTURE FIELD : This picture field is larger than the size you designated in Preferences. Uniquement Warning Warning taille champ de type Blob BLOB FIELD : This Blob field is larger than the size you designated in Preferences. Uniquement Warning Erreur interne d'adressage mémoire lors de l'analyse de l'enregistrement. Il y a fort à penser que l'enregistrement est endommagé ... ou qu'il y a un bug. Exception

Vérification et correction automatiques :

Si vous avez sélectionné l'option Auto Correct dans le pop-up menu de la zone Action, Doctor corrige automatiquement les erreurs.

Nous vous conseillons vivement d'utiliser d'abord l'option Only Log. (Avertissement)

Compléments d'informations :

La Table d'Allocation des fichiers de données n'est pas vérifiée dans son intégralité. En effet, une telle vérification est très longue ; alors, Rescue For 4D Data ne vérifie que les parties utilisées par des données.
La partie non vérifiée ne met pas en danger vos données. Ni aujourd'hui, ni demain.

Notez également que lorsque Rescue For 4D Data effectue certains types de corrections, il ne met pas à jour la Table d'Allocation du fichier Data. Cela lui permet d'aller plus vite et de ne pas risquer d'ajouter des erreurs dans le fichier 4D. Cette mise à jour sera automatiquement faite par 4D Utils lors du compactage.
Les tests sur les index ne sont complets que si vous testez aussi les enregistrements. Par exemple, si un index contient un caractère que vous avez défini comme 'interdit', la seule correction de l'index ne suffira pas : il faudra d'abord corriger l'enregistrement.
Il y a deux unités de bases dans un data 4D : les index et les fiches. La sous-fiche n'est qu'un sous ensemble très mineur de la fiche. Cependant, et compte-tenu de la façon dont sont intégrées les sous-fiches au coeur même des fiches, les sous-fiches ne peuvent pas être partiellement vérifiées.

C'est pourquoi vous n'avez pas le choix de ce que vous désirez analyser dans les sous-fiches. L'analyse d'une table entraîne obligatoirement l'analyse des sous-fiches de cette table. Si Rescue for 4D Data vous offrait le choix de vérifier ou non les éléments de base des sous-fiches, ses tests seraient INCOMPLETS et donc, sans intérêt. De plus, il est impossible de vérifier les champs de longueur variable tels que Texte, Picture ou Blob sans parser les sous-fiches.

Un test sur les dates est effectué afin de vérifier que le mois est bien compris entre 1 & 12, et que le jour est bien un jour possible. La routine tient compte des années Bisextiles. Si le cas se présente, Rescue For 4D Data affiche une alerte mais ne fait pas de corrections.

En V6, ce genre d'erreur ne peut se produire que par programmation, car un filtrage est effectué par 4D pour éviter les mauvaises saisies.

Imaginons qu'une base comporte la date 35/05/98. Une recherche entre le 01/05/98 et le 30/06/98 ne trouverait pas cet enregistrement.
Le développeur doit forcer 4D à calculer une date correcte, par exemple :

theDate := !35/05/98! -> Ici theDate vaut 35/05/98
theDate := theDate + 0 -> Ici theDate vaut 04/06/98

Si la structure ne correspond pas EXACTEMENT au data, Rescue For 4D Data ne pourra pas trouver ni les noms de champs ni des tables, et les remplacera par "* Field Name Not Found *" ou par "* Table Name Not Found *" (Soit par exemple, structure version 1 et data version 10).

Lorsque des Fiches ou autres blocs d'informations sont supprimés par Rescue For 4D Data, l'espace qu'ils occupaient n'est pas libéré ni même déclaré "réutilisable" par 4D. Le seul moyen de récupérer cet espace est de Compacter la base (la récupération par marqueur de fiche fonctionne aussi).
Compte-tenu de la continuelle évolution de 4D et de la diversité des ressources TRIC, Rescue For 4D Data ne refait pas les index lui-même. Les index seront refaits automatiquement par 4D lors de la prochaine ouverture de la base.

Enregistrer un log:
Enregistrer un log:
: Vous pouvez enregistrer un log en sélectionnant l'item Save du menu File.
Vous pouvez l'ouvrir avec un éditeur de texte RTF.

Avancée | Aide | Accueil WEB JCS| Sommaire| Avertissement | Historique des Versions | Installation | Quelques conseils pour mieux utiliser Rescue for 4D Data | | Menus | Préferences | Navigator | Doctor | Editor | Viewer | | 4th Dimension™ | Structure du Data 4ème Dimension™ |
Avancée | Aide | Accueil WEB JCS| Sommaire| Avertissement | Historique des Versions | Installation | Quelques conseils pour mieux utiliser Rescue for 4D Data | | Menus | Préferences | Navigator | Doctor | Editor | Viewer | | 4th Dimension™ | Structure du Data 4ème Dimension™ |

Problème de chargement d'un enregistrement	Message	Solution Rescue For 4D Data
Chargement complet de chaque enregistrement.	Loading Error (Plus message ci-dessous).	Suppression de la fiche.
Erreur d’allocation Mémoire.	Not Enough Memory.	L'enregistrement est trop grand. Cette erreur est en général dûe a un enregistrement endommagé. La correction automatique ne supprime en aucun cas l'enregistrement. Cette décision doit être prise manuellement dans l'Editor C'est peut-être un vrai problème de mémoire.
Header de fiche inconnu. L'entête de l'enregistrement n'est pas une entête 4D.	Bad Data Header.	Suppression de la fiche.
Table inconnu	Table Does Not Exist.	Suppression de la fiche.
SRA inconnu	SRA Does Not Exist.	Suppression de la fiche.
Numéro de fiche inconnu	Record Number Does Not Exist.	Suppression de la fiche.
Record supprimé	Deleted Record.	Suppression de la fiche.
Problème avec le Cache SRA. Les SRA qui sont dans le cache de Rescue For 4D Data sont différentes des SRA d'origine.	SRA Out Of Cache.	Rien, surtout pas (C'est un bug) ou ça en a 'l'odeur' ;-))
Mauvaise adresse de fiche (adresse négative)	Delete Table Error.	Suppression de la fiche.
SIAT introuvable	SIAT Does Not Exist.	Suppression de la fiche.
Adresse dans SRA en dehors du fichier de données.	Bad Address In SRA.	Suppression de la fiche.
L' enregistrement est en dehors du fichier de données (Interruption de 4D lors de l'écriture du cache)	Record Out Of Data File.	Réinitialisation de l'adresse dans la SRA.
Autre problème inconnu.	Loading Error On Record n°x.	Suppression manuelle de la fiche dans l'Editor mais avant, relancez Rescue For 4D Data pour vérifier cette erreur. (Il y a une erreur mais inconnue, aucune possibilité pour l'interpréter).

Problème sur l'entête d'un enregistrement	Message	Solution Rescue For 4D Data
Fiche taggée comme étant supprimée, mais encore pointée par une SRA.	Tag Deleted.	Suppression de la fiche.
Tag Inconnu	Unknown Tag On Record nX.	Suppression de la fiche.
Mauvais checksum de fiche.	CheckSum Error On Record n°x.	Suppression de la fiche.
Le nombre de champs de l'entête de fiche ne correspond pas au nombre de champs dans la fiche.	Number Of Fields In Record n°x.	Suppression de la fiche.
Le numéro de fiche de l'enregistrement ne correspond pas au numéro dans la SRA.	Record Number On Record n°x.	Suppression de la fiche.
Mauvais flag de fiche. L'enregistrement n'est pas un type connu de 4D.	Type Flag On Record n°x.	Suppression de la fiche.

jeudi 11 février 1999	La date de la vérification.

Start Log On "MyDataBase.4dD".	Le type d'opération et le nom du fichier de structure analysé.
Used On 4D v5 Macintosh.	La version de 4D et le type de machine sur laquelle la base est utilisée.
Data File Size : 6891520 Bytes.	La taille du fichier data en octets.
Checking Resources : Expert Log. Checking Index. Checking PRA Table. Checking SRA Table. Checking Deleted Records. Checking Record Headers. Checking Record Fields. Checking Alpha Fields. Checking Integer Fields. Checking Long Fields. Checking Real Fields. Checking Date Fields. Checking Time Fields. Checking Boolean Fields. Checking SubFields. Checking Text Fields. Checking Picture Fields. Checking Blob Fields.	Vérifications effectuées suivant le réglage des Préférences.
Checking Data File Tables : Allocation Table Size 23552 Bytes. 10 File(s), 35 Index. File Information Table Size 362 Bytes. 114157 Operations Make In Data File Since Last 4D Tool Compact. - " 4D Was Interrupted When Saving A Bit Table ". - " 4D Was Interrupted When Saving An Index ". - " 4D Was Interrupted When Deleting An Index ". - " 4D Found An Invalid Record Address ". - " 4D Was Interrupted When Flushing Cache " - "4D Has A Unknow Operation TAG"	La taille de la table d'allocation en octets. Le nombre de fichiers, le nombre d'index La taille de la FIT en octets Le nombre d'opérations effectuées sur le data depuis le dernier compactage avec 4D Util. L'entête du log affiche l'état 4D lorsque la base a été quittée pour la dernière fois : Le doctor ne change pas ce flag. Il est possible de modifier ce flag dans l'Editor. Ce message indique un flag non documenté.

Checking "FSE":	Début du travail sur le fichier FSE.
Checking PRA Validity... Checking PRA Loading...Ok Checking SRA Validity... 2 SRA Table(s) Used 32768 Bytes. Checking SRA Loading...Ok Checking SRA / Record Position...Ok Checking SRA / Deleted Records...Ok Checking Record Validity... 6478 Record(s) In File. 0 Unused Record(s) Address(es).	Vérification de la Primary Record Adress. Vérification de la Secondary Record Adress. Nombre de SRA et taille en octets Vérification de l'adresse de l'enregistrement et de la table d'effacement Vérification des enregistrements Nombre de fiches trouvées Nombre d'enregistrements effacés.
Checking Records...Ok	Résultat de la vérification des enregistrements de la table

Problème d'entête	Message	Solution Rescue For 4D Data
Vérification des PRA.	PRA cannot be loaded. This file cannot be repaired.	Contacter JCS Développement
Vérification des SRA	SRA cannot be loaded.	Suppression de la SRA et des 1024 enregistrements qui lui sont liés (512 en v6).
Vérification des adresses des enregistrements.	Error on SRA record nX.	Suppression de l’enregistrement associé.
Fin de la delete Table introuvable.	Error Delete Table	Recréation par Rescue For 4D Data de la table de suppression sans altération des données.
Nombre d’enregistrements supprimés different dans la Delete Table et dans la SRA.	Error On SRA Deleted Records	Recréation par Rescue For 4D Data de la table de suppression sans altération des données.
Table de suppression endommagée.	Bad Delete Table, Impossible To Count Records.	Recréation par Rescue For 4D Data de la table de suppression sans altération des données.

Problème sur les champs	Message	Solution Rescue For 4D Data
Rubrique non trouvée.	Field Not Found	Suppression de la fiche.
Rubrique en dehors de la fiche	Field Out of Record	Suppression de la fiche.

Problème	Message	Solution Rescue For 4D Data
Vérifie que les index sont de type connu (Alpha, Entier, etc.)	Bad Index Type.	Suppression d’index et reconstruction par 4D.
Vérifie qu’il existe bien une fiche attachée, puis la charge.	Corresponding Record Not Found.	Suppression d’index et reconstruction par 4D.
Vérifie la bonne correspondance entre le nombre de clés d’index et le nombre de fiches.	Index Number Different From Record Number.	Suppression d’index et reconstruction par 4D.
Les headers de l’index sont mauvais.	Bad Index Headers.	Suppression d’index et reconstruction par 4D.
L’index contient une valeur interdite du type alpha > 80 car, Bool != 0 ou 1.	Bad Index Value.	Suppression d’index et reconstruction par 4D.
Index gravement endommagé, ou Rescue For 4D Data n’arrive pas à le lire.	INDEX CAUSES EXCEPTION. This index cannot be parsed.	Suppression d’index et reconstruction par 4D.