Comment utiliser SanityCheck
Ce chapitre présente les bases de SanityCheck. Vous y trouverez également des raccourcis pour vous aider à travailler plus vite avec SanityCheck.
Installation de SanityCheck
SanityCheck ne requiert aucun installeur spécifique - Glissez simplement l'icône de SanityCheck du disque SanityCheck sur le disque dur de votre Macintosh. Vous pouvez lancer SanityCheck directement du disque SanityCheck, mais SanityCheck fonctionnera beaucoup plus vite en le démarrant sur votre disque dur.
Démarrage de SanityCheck
Démarrer SanityCheck en double-cliquant
1 Double-cliquez sur l'icône SanityCheck pour le lancer. La fenêtre d'ouverture s'affiche.
SanityCheck suppose que vous souhaitez ouvrir un fichier de structure et vous propose d'en sélectionner un sur votre disque
2 Sélectionnez le fichier de structure que vous souhaitez ouvrir
3 Cliquez sur le bouton Ouvrir
Démarrer SanityCheck par glisser-déposer
1 Sur le Bureau, glissez votre fichier de structure et déposez-le sur l'icône (ou alias) de SanityCheck.
SanityCheck autorise le glisser-déposer d'un fichier n'importe quand, tant qu'il dispose d'assez de mémoire pour ouvrir le fichier. SanityCheck vous demandera de sélectionner l'application 4D utilisée avec ce fichier de structure.
2 Localisez le programme 4D dont la version correspond à la structure actuellement ouverte par SanityCheck.
Utilisation de SanityCheck
Quand votre structure est ouverte par SanityCheck, une fenêtre s'affiche vous permettant de sélectionner les options générales et de démarrer une analyse. La fenêtre affiche également le résultat de l'analyse, appelée le "log" de l'analyse, dans la partie basse de la fenêtre.
Note: cette fenêtre combine les fenêtres analyse et log précédemment affichées par SanityCheck v1 et v2.
Pour analyser un fichier de base de données
1 Cliquez sur le bouton Démarrer. SanityCheck va immédiatement effectuer un contrôle d'intégrité et rechercher les erreurs de programmation de votre fichier de structure. Si vous voulez utiliser la fonction de Recherche, référez-vous à la section "Utilisation du dialogue de recherche"
Pour fermer un fichier de structure
1 Cliquez sur la case de fermeture ou sélectionnez la commande Fermer dans le menu Fichier, lorsque le fichier de structure est dans la fenêtre de premier plan. Voir les Questions courantes pour des détails sur la manière dont SanityCheck gère les fichiers.
Utilisation du fichier de log
Lorsque SanityCheck analyse le fichier de structure et rencontre un élément à reporter, la zone de log de la fenêtre affiche l'élément en question pendant que l'analyse progresse. Le fichier de log est séparé en deux, la liste des éléments et la liste de description des éléments (voir ci-dessous). La partie supérieure du fichier de log dresse la liste de tous les éléments trouvés dans votre fichier de structure.
1 - Nom du fichier structure
2 - Numéro de l'information rapportée
3 - Lien hypertexte vers le détail de l'information
4 - Explications pour chacune des informations présentes dans le log.
La clé pour lire la liste des éléments est de se souvenir que l'indentité détermine une hiérarchie, à la manière d'un arbre généalogique.
Note : Bien que les éléments statistiques qui apparaissent dans le log soient numérotés (désactivation possible), ils n'apparaissent pas dans la partie inférieure du fichier de Log.
Imprimer le fichier de Log
1 Assurez-vous que la fenêtre de premier plan est un fichier de log
2 Sélectionnez la commande Imprimer du menu fichier
Conseil : Si vous cliquez sur la case de zoom (située dans le coin supérieur droit de la fenêtre) SanityCheck ajuste au mieux la taille de la fenêtre en fonction de l'imprimante courante et des options d'impression.
Utilisation des Boutons hypertexte du fichier de Log
Le fichier de Log intègre des boutons hypertexte à côté de la plupart des éléments reportés. Il suffit de cliquer sur le bouton hypertexte pour afficher l'objet concerné.
Bulles d'aide pour les éléments reportés
Il est possible d'activer l'affichage des bulles d'aide pour les éléments reportés. La bulle d'aide contient le même détail d'informations que celui du bas de la fenêtre de Log de SanityCheck. L'utilisation de cette fonctionnalité permet de visualiser conjointement l'explication et l'élément concerné, sans avoir à dérouler la fenêtre de Log.
Utiliser les bulles d'aide pour les éléments reportés
1 Cliquez sur le bouton d'aide (Point d'interrogation).
Ce bouton active la fonction "Bulles d'aide".
2 Déplacez le curseur de la souris au-dessus de n'importe quel élément reporté.
SanityCheck affiche les informations détaillées pour l'élément concerné.
Utiliser le dialogue de recherche
Le dialogue de recherche de SanityCheck permet de trouver, dans la fenêtre de Log, les occurrences du texte spécifié.
Utilisation du dialogue de recherche
1 Assurez-vous qu'un fichier de structure est ouvert et que la fenêtre d'analyse et rapport est au premier plan.
2 Choisissez la commande Rechercher du menu fichier, ou Commande-F. Le dialogue de recherche s'affiche.
3 Tapez le texte à rechercher.
4 Cliquez sur le bouton Chercher.
SanityCheck cherche la première occurrence du texte indiqué. Pour trouver les occurrences suivantes, choisir Chercher encore du menu fichier, ou Commande-G.
Les recherches sur les objets peuvent être définies par type, par expression littérale et plus encore en utilisant l'explorateur de SanityCheck. Pour plus d'informations, se référer à la section "Comment utiliser l'explorateur de SanityCheck".
Définir les préférences de SanityCheck
Le dialogue des préférences permet le contrôle de l'ensemble des comportements de SanityCheck.
Modifier les préférences de SanityCheck
Pour modifier un des éléments des préférences
1 Choisissez Préférences dans le menu Fichier. Le dialogue s'affiche.
2 Cliquez sur la case à cocher désirée.
3 Cliquez sur le bouton Enregistrer.
Définir les réglages "communs" de SanityCheck
Depuis la version 4 de SanityCheck, il est possible d'enregistrer les réglages sous forme de fichier commun à plusieurs projets. En général, les réglages sont propres à chaque structure, maintenant vous pouvez utiliser des réglages communs à plusieurs bases. Chaque fichier de réglage devient alors un fichier partageable. Ceci inclut tous les réglages de plug-ins, tolérances, parasites, etc. Il est alors possible de dupliquer, copier, renommer et manipuler ces fichiers.
Si vous ne souhaitez pas utiliser les réglages communs, SanityCheck peut utiliser les réglages propres à chaque projet.
Il est fortement recommandé d'utiliser un fichier de réglage commun pour chaque version de 4D. Entre autres raisons, SanityCheck y stocke les informations relatives à la version de 4D utilisée avec la structure courante. Plusieurs autres options pouvant être directement liées à la version de 4D utilisée, il vous suffit de nommer vos réglages communs sous la forme v6.7.2 ou v6.5.9,etc. de manière à clarifier la situation. L'implémentation des réglages communs est accessible via le menu des réglages.
Editer les réglages pour cette base
Cette option permet d'éditer les réglages spécifiques au fichier de la structure courante. Puisque SanityCheck conserve les réglages par structure, cette option vous permet d'éditer les réglages dans ce fichier. Cependant, dès que vous commencerez à utiliser les réglages communs pour la structure actuelle, cette option apparaîtra grisée et l'élément - Ne plus utiliser <réglage> pour cette structure - deviendra actif.
Ne plus utiliser les réglages par défaut
Ceci vous permet d'arrêter l'utilisation des réglages communs pour la structure courante. Cette option est active uniquement lorsque vous utilisez les réglages communs pour la structure courante. Quand il est actif, cet élément de menu change de libellé - Ne plus utiliser <réglage> pour cette structure - où <réglage> est le nom de la configuration commune en service pour l'actuelle structure.
Définir les réglages communs
Cette option ouvre le répertoire des réglages communs sous le Finder / Explorateur et permet de modifier les fichiers de réglages à votre convenance. SanityCheck détecte tout changement dans le répertoire et met automatiquement à jour le menu Réglages.
Créer de nouveaux réglages communs
Cette option crée un nouveau fichier de réglage commun (Common) et ouvre le dossier contenant les fichiers de réglages communs : ceci vous permet de copier, renommer, effacer, etc.
Editer <réglage>
Si plusieurs fichiers de réglages existent, ils sont listés et préfixés (du mot éditer), permettant ainsi d'éditer le contenu du fichier de réglage.
Utiliser <réglage> pour cette structure
Si vous disposez de plusieurs fichiers cette option vous permet d'indiquer à SanityCheck quel fichier de réglage communs utiliser pour la structure courante. Une fois sélectionné, cet élément de menu est coché, et le nom <réglage> apparaît dans l'élément de menu - Ne plus utiliser <réglage> pour cette structure -.
Paramétrer "VariableNamer"
Depuis la version 4, SanityCheck tente une approche de contrôle des conventions d'écritures. Il est, par exemple, possible de contrôler les noms de variables au travers d'une externe accessible via le menu Plug-ins, et nommée VariableNamer. Une erreur sera générée dans le fichier log pour tout écart aux règles de convention d'écriture des variables, paramétrables via le dialogue suivant :
Exemple
Si vos modules sont préfixés par trois caractères (ex : module gérant la table des adhérents préfixé par aDh), toutes les variables process de ce module commenceront par le même préfixe (chaque module ayant sont préfixe attitré).
Définir les options de SanityCheck
La plupart des opérations d'analyse et de rapport de SanityCheck sont modifiables en utilisant les dialogues de préférences et d'options.
Modifier les options de SanityCheck
1 Choisir la commande Options du menu Fichier, ou Commande-point virgule. Le dialogue d'options apparaît.
2 Sélectionner l'onglet correspondant à votre choix.
Eléments reportés
SanityCheck peut identifier et lister des centaines d'éléments suite à une analyse. SanityCheck peut être configuré pour ignorer certains de ces éléments en utilisant le panneau Eléments signalés dans le dialogue d'options.
Déplacer un élément reporté d'une liste vers l'autre
1 Sélectionnez l'élément à déplacer. La sélection peut s'opérer à la souris, en tapant le numéro de l'élément ou en utilisant les flèches de direction. La touche tabulation permet de se déplacer d'une liste à l'autre.
2 Glissez l'élément sur l'autre liste, ou appuyez sur la touche Return. Un double-clic sur n'importe quel élément le transfère vers l'autre liste.
Le bouton Options par défaut rétablit les options de cet écran telles qu'elles étaient lors de la première installation de SanityCheck.
Modifier les tolérances
Certains éléments reportés dépendent de certaines tolérances.
1 Choisissez la commande tolérances dans le menu fichier, ou commande-T. Le dialogue de paramétrage s'affiche à l'onglet des tolérances.
2 Tapez un nombre dans la zone appropriée. Ces tolérances ne seront effectives pendant une analyse que si les éléments reportés sont activés dans le Panneau Eléments signalés. Afin de vous aider à retrouver les éléments correspondants dans le dialogue Eléments signalés, les numéros d'éléments pris en compte par les tolérances sont affichés dans ce dialogue.
Parasites
4D peut parfois avoir des difficultés avec certains caractères de la table ASCII étendue. SanityCheck identifie ces caractères, appelés caractères parasites, afin de les supprimer. Ils peuvent se trouver dans les méthodes et autres objets.
Il est possible de déterminer quels caractères ASCII seront considérés comme parasites, en utilisant le tableau de parasites dans le dialogue d'options.
Réparation
SanityCheck peut réparer certains problèmes identifiés pendant l'analyse d'un fichier de structure 4D. SanityCheck est paramétrable pour réaliser l'opération de réparation en mode automatique ou semi-automatique.
Note: Toujours créer une copie du fichier de structure avant d'effectuer toute modification ou réparation sur le fichier avec SanityCheck.
Paramétrages divers
D'autres paramétrages sont accessibles via l'onglet Divers du dialogue d'options.C'est depuis cet onglet que l'application 4D utilisée pour ouvrir le fichier de structure doit être identifiée.
Pour identifier l'application 4D utilisée pour le fichier de structure courant
1 Sélectionnez la commande Options dans le menu Fichier
2 Cliquez sur l'onglet Divers
3 Cliquez sur le bouton Définir. SanityCheck demande d'identifier l'application 4D utilisée avec le fichier de structure.
4 Sélectionnez l'application 4D et cliquez sur le bouton Enregistrer.
On peut également choisir d'effectuer une vérification complète des ressources de 4D. Ce paramétrage entraîne un temps d'analyse plus long mais fournit une analyse plus complète, ce qui peut être bénéfique pour résoudre des problèmes.
Les fonctionnalités de références croisées sont utilisées pour permettre l'exécution du dialogue de l'explorateur. Pour plus d'informations, se référer à la section Comment utiliser l'explorateur SanityCheck.
Structures récemment utilisées
Les 5 derniers fichiers de structure ouverts avec SanityCheck sont automatiquement mémorisés. Cette liste est disponible dans le menu Fichier. SanityCheck trie toujours cette liste et conserve la dernière structure utilisée en haut de la liste.
N'importe quelle structure récemment utilisée est disponible en la choisissant dans le menu Fichier.
Pour ouvrir automatiquement la dernière structure utilisée au démarrage
1 Sélectionnez la commande Préférences dans le menu Fichier
2 Cochez la case "Ouvrir le dernier fichier au lancement"
3 Cliquez sur le bouton Enregistrer
Effacer le système de mots de passe
Il est possible d'effacer complètement les mots de passe et groupes de 4D. Il faut être conscient que cette action ne concerne que les problèmes sérieux rencontrés dans le domaine des mots de passe,et doit être utilisée avec précautions. Voici les raisons pour lesquelles vous devez rarement utiliser cette fonction.
Les mots de passe et groupes sont utilisés dans toute la structure. Par exemple, on peut définir une table accessible par un seul groupe. Donc si vous effacez tous vos groupes, 4D peut conserver des références au groupe actuellement non-existant. Cela peut entraîner de sérieux problèmes pour la stabilité du fichier de structure.
Il est donc conseillé de n'utiliser cette fonctionnalité qu'en dernier recours pour sauver une structure gravement endommagée.
Cette fonctionnalité exécute ce qui suit, et rien de plus : met à zéro le nombre de mots de passe, met à zéro le nombre de groupes (aussi bien pour les groupes et mots de passe de l'administrateur et du super-utilisateur) puis, redéfinit au minimum la taille des objets Mots de passe / Groupes. Le même effet est produit (sauf changer la taille de la ressource) en ouvrant la ressource mots de passe et en mettant à zéro le nombre de mots de passe et de groupes.
Pour effacer les mots de passe d'un fichier de structure
1 Ouvrez et analysez un fichier de structure 4D
2 Sélectionnez la commande Effacer tous les mots de passe dans le menu Spécial
Note:Le mot de passe Super-Utilisateur est nécessaire pour accéder à cette fonctionnalité. Si le mot de passe Super-utilisateur est inconnu ou endommagé, vous n'avez pas de chance et devez restaurer à partir d'une sauvegarde.
Menu Fenêtre
Les commandes suivantes sont disponibles dans le menu Fenêtre.
| Commande |
Description |
| Ranger |
Empile les fenêtres en cascade |
| Tout fermer |
Ferme toutes les fenêtres. On peut aussi cliquer, touche option enfoncée, sur n'importe quelle case de fermeture. |
| Liste des fenêtres |
Lorsque les fenêtres sont ouvertes, elles sont ajoutées au menu Fenêtre. Pour choisir une fenêtre, la sélectionner dans la liste. Les fenêtres sont toujours triées dans l'ordre d'empilement, avec la fenêtre de premier plan en haut de la liste. |