Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

Descriptif du programme Xtools


Xtools est l'utilitaire de gestion des fichiers "Harmony". Il traite aussi bien les fichiers locaux que les fichiers situés sur un serveur de données.
Au démarrage, le programme affiche un tableau vide. Vous pouvez alors soit sélectionner / pointer un ensemble de fichiers, soit appeler une fonction applicable à un fichier isolé, soit appeler une fonction " diverse " :
La sélection et le pointage permettent de choisir une liste de fichiers, auxquels on pourra ensuite appliquer des opérations :


D'autres opérations sont réservées à un fichier isolé :
Affichage / modification du contenu (enregistrement / enregistrement). Affichage / modification du contenu d'après la description de l'enregistrement dans le dictionnaire des données. Affichage / modification du contenu " brut " du fichier (donc sans notion d'enregistrement). Modification des caractéristiques. Création d'un fichier séquentiel indexé , Affichage / modification du paramétrage des clés, d'un séquentiel indexé Réorganisation , Régénération des clésCopie logique d'un fichier (avec possibilité de copie partielle, de modification du nom du fichier des données, …) Création, Changement de nom Suppression Effacement, Exploration d'un dossier par Xtools , Exploration d'un dossier par l'explorateur de Windows , Ouverture d'un fichier par le programme associé
Enfin, Xtools offre quelques fonctions " diverses " :
Changement des chemins implicites. Test d'ouverture d'un fichier , Interprétation d'un code d'erreur Harmony
Remarque :
Les fonctions sont appelées soit au menu, soit par une touche de raccourci clavier, soit par un bouton de la barre d'outils. Le menu est actif pendant les opérations de pointage mais devient inactif en cours d'exécution d'une opération.

Ancre
Top_of_S_lectionnerdesfichiers_h
Top_of_S_lectionnerdesfichiers_h

Sélectionner des fichiers

Ancre
Top_of_M_thodesdes_lection_htm
Top_of_M_thodesdes_lection_htm

Méthodes de sélection

Une sélection de fichiers est déclenchée de trois manières :

...

Ancre
Top_of_S_lectiondansunseuldossie
Top_of_S_lectiondansunseuldossie

Sélection dans un seul dossier

Les deux premières méthodes ne traitent qu'un seul chemin et la sélection correspondante n'affiche que le contenu d'un seul dossier. Le tableau présente alors uniquement les fichiers correspondant au filtre et au format indiqués ET les dossiers fils du dossier choisi.
Pour afficher ensuite le contenu d'un dossier fils, tapez la touche Return ou double-cliquez sur la ligne affichant ce dossier fils.
Pour afficher le contenu du dossier père du dossier courant, cliquez sur le bouton Dossier Parent (ou sélectionnez le choix <Chemin ® Monter d'un niveau> du menu).
Attention : lorsque vous opérez une nouvelle sélection, la sélection en cours est PERDUE, sans demande de confirmation.
Cette sélection des fichiers tient compte de trois paramètres :

Pour modifier un ou plusieurs de ces paramètres, cliquez dans le champ correspondant en haut de l'écran. Après validation de la saisie, le tableau est actualisé avec les fichiers répondant aux nouveaux critères choisis.
Remarque : en bas et à gauche de l'écran, Xtools affiche le nombre de fichiers pointés / le nombre de fichiers sélectionnés.

Ancre
Top_of_S_lectiondansplusieursdos
Top_of_S_lectiondansplusieursdos

Sélection dans plusieurs dossiers et recherche de fichiers

Pour rechercher des fichiers et / ou pour sélectionner des fichiers dans plusieurs dossiers, utilisez le choix du menu <Rechercher>, qui ouvre la boîte de dialogue " Recherche de fichier ".
Cette recherche tient compte de trois paramètres :

  • Le ou les chemins.

  • Le filtre (optionnel).

  • Le format (optionnel).

La boîte de dialogue permet la saisie du filtre et / ou du format. Le ou les chemins sont à choisir parmi la liste des chemins paramétrés dans Harmony et proposés à l'écran dans un tableau en mode sélection multiple (avec possibilité d'ajouter temporairement des chemins dans ce tableau). La méthode pour effectuer des sélections dans un tel tableau est décrite dans la rubrique consacrée au pointage des fichiers sélectionnés.
L'ajout (temporaire) d'un chemin s'obtient par la touche F3, le bouton Création ou en cliquant sur la colonne d'état affichant une étoile. Comme la création n'est que temporaire, le programme saute la saisie du nom du chemin et propose de renseigner uniquement le chemin lui-même (pour créer un chemin de façon permanente, appelez le choix <Chemin ® Changer les chemins Implicites> du menu - qui fait appel à Xpath - puis cliquez sur le bouton Chemins pour charger le zoom des chemins).
Lorsqu'ici vous sélectionnez un chemin, sachez que vous sélectionnez également tous les sous-dossiers du dossier choisi. Après validation de la boîte de dialogue, Xtools affiche maintenant les fichiers (correspondant au filtre et au format indiqués) de tous les dossiers ET sous-dossiers choisis. Les sous-dossiers eux-mêmes n'apparaissent pas.
Chaque ligne de tableau affiche alors une colonne supplémentaire (par rapport au cas de la sélection dans un dossier unique décrite précédemment), qui présente le dossier contenant le fichier.
Attention : Dans ce cas, la liste pourra contenir des fichiers portant le même nom. Si vous leur appliquez une fonction de copie, compression ou décompression, ces fichiers homonymes seront tous copiés dans le même fichier destination : le contenu final de ce dernier correspondra alors au dernier fichier copié.

Ancre
Top_of_Filtre_htm
Top_of_Filtre_htm

Filtre

Un filtre est une fonction booléenne (résultat = vrai ou faux) appliquée aux fichiers trouvés dans le ou les dossiers choisis. Il permet de spécifier des critères de recherche pour ces fichiers : lors de la sélection, Xtools parcourt le(s) dossier(s) et applique le filtre à chaque fichier ; si le résultat est positif, le fichier est sélectionné.
La syntaxe de l'expression FILTRE est la suivante :
Critère Op_Test Constante [ Op_Booléen Critère Op_Test ... ]
Exemples :
DATE > 01/06/01 DATE > 01/06/01 or DATE = 01/05/01 DATE > 01/06/01 and TYPE <> I
Les critères qui peuvent figurer à gauche d'un opérateur de test sont :

...

=

Egal.

>

Supérieur.

>=

Supérieur ou égal.

<=

Inférieur ou égal.

<

Inférieur.

<>

Différent.

LIKE

Ressemblance avec un format (Cf. rubrique consacrée au format).


Les opérateurs booléens sont :

...

Ancre
Top_of_Format_htm
Top_of_Format_htm

Format

Un format est une suite de caractères interprétés par l'opérateur LIKE pour opérer une sélection suivant le nom du fichier :

...

Ancre
Top_of_Pointerlesfichierss_lecti
Top_of_Pointerlesfichierss_lecti

Pointer les fichiers sélectionnés

Après une sélection, les fichiers sont affichés par ordre alphabétique sur leur nom (il est possible de les trier suivant d'autres critères). Les dossiers fils du dossier en cours sont également affichés dans le cas d'une sélection sur un dossier unique.
Le pointage sert à déterminer, parmi les fichiers sélectionnés, ceux auxquels il faudra appliquer une opération multi-fichiers (les fichiers pointés sont affichés avec une coche dans la colonne d'état).
Les fichiers sélectionnés sont affichés dans un tableau. Un tableau est un objet standard d'Harmony qui comporte :

...


Sur un tableau, vous pouvez :
Opérations concernant la présentation du tableau
Cliquer sur un en-tête de colonne pour afficher les fichiers dans l'ordre de tri désigné par celle-ci. Un deuxième clic sur l'en-tête de colonne change le sens du tri (croissant / décroissant : une flèche dans l'en-tête rappelle le sens courant).
Changer la largeur d'une colonne, en cliquant sur la frontière droite de l'en-tête puis en faisant glisser le pointeur à droite ou à gauche.
Changer la position d'une colonne, en cliquant sur l'en-tête de cette colonne puis en la faisant glisser vers sa nouvelle position.
Changer la hauteur des lignes, en cliquant sur la frontière entre deux lignes de la colonne d'état puis en faisant glisser le pointeur vers le haut ou vers le bas.
Déplacer l'ascenseur horizontal, pour afficher les colonnes n'apparaissant pas à l'écran.
Augmenter le nombre de lignes affichées, en agrandissant ou en maximisant la fenêtre.
Déplacements dans le tableau
Vous déplacer sur une ligne, en cliquant dessus ou en vous servant des touches de déplacement (Flèche en haut, Flèche en bas, Début, Fin).
Afficher la page suivante de la liste, en cliquant entre le curseur et la flèche inférieure de l'ascenseur vertical ou en tapant Page Suivante. Le déplacement par l'ascenseur ne dépointe pas les fichiers contrairement à la touche Page Suivante.
Afficher la page précédente de la liste, en cliquant entre le curseur et la flèche supérieure de l'ascenseur vertical ou en tapant Page Précédente. Le déplacement par l'ascenseur ne dépointe pas les fichiers contrairement à la touche Page Précédente.
Afficher la liste à partir d'un fichier donné, en déplaçant le curseur de l'ascenseur vertical.
Faire défiler la liste d'une ligne vers le haut ou vers le bas, en cliquant sur la flèche inférieure ou supérieure de l'ascenseur vertical. Le déplacement par l'ascenseur ne dépointe pas les fichiers contrairement aux touches fléchées.
Accéder directement au premier fichier de la liste dont le nom commence par les lettres saisies.
Opérations sur les fichiers
Modifier le nom du fichier de la ligne courante en tapant la touche F4.
Ouvrir un menu " Pop-Up " qui propose d'explorer le dossier par Xtools, d'ouvrir l'explorateur sur le dossier ou d'ouvrir le fichier avec le programme correspondant au type du fichier.
Réactualiser la liste des fichiers affichés en tapant F5 ou par le choix du menu <Chemin ® Actualiser>.
Opérations de pointage
Pointer l'ensemble des lignes en tapant Ctrl+A ou par le choix du menu <Edition ® Pointer tout les fichiers>.
Pointer une ligne, en cliquant sur la colonne d'état en regard de cette ligne.
Pointer un groupe de lignes contiguës : sélectionnez d'abord la ligne de départ puis cliquez sur la ligne de fin (ou déplacez-vous au clavier à la manière habituelle jusqu'à atteindre la ligne de fin), tout en maintenant la touche Shift enfoncée.
Pointer des lignes non contiguës : après avoir sélectionné une ou plusieurs lignes, cliquez sur les nouvelles lignes à sélectionner (ou tapez Espace après vous être positionné au clavier à la manière habituelle), tout en gardant la touche Ctrl enfoncée. Remarques : La touche Espace fonctionne en bascule c'est à dire qu'elle sélectionne une ligne non sélectionnée et qu'elle désélectionne une ligne déjà sélectionnée. Vous pouvez aussi combiner les touches Shift et Ctrl pour sélectionner plusieurs groupes disjoints de lignes contiguës.
Inverser l'état de pointage de tous les fichiers en tapant CTRL+B ou par le choix du menu <Edition ® Inverser le pointage>. Les fichiers qui étaient pointés auparavant ne le sont plus et les autres le deviennent.
Oter les fichiers pointés de la liste en tapant Shift+F3 ou par le choix du menu <Edition ® Oter les fichiers pointés>.
Remarque : pendant le pointage, il est également possible d'appeler des fonctions à effectuer sur un fichier isolé ou de créer un nouveau fichier.

Ancre
Top_of_Pr_s_lectiond_unr_pertoir
Top_of_Pr_s_lectiond_unr_pertoir

Présélection d'un répertoire au démarrage de Xtools

Vous pouvez demander qu'à l'appel de Xtools, celui-ci affiche immédiatement une sélection de fichiers. Pour ce faire, créez un raccourci sur Xtools.dhop en faisant suivre son nom des paramètres suivants :
/env -format format -filtre filtre -chemin chemin
(/env est obligatoire, tout autre paramètre non renseigné est mis à espace).
Exemples de raccourcis :
c:\Divalto\Sys\xrtDiva.exe xtools.dhop /env -format f* -chemin /Divalto/sys
c:\Divalto\Sys\xrtDiva.exe xtools.dhop /env -filtre date > 01/06/01 -chemin /Divalto/fic

Ancre
Top_of_FonctionsdeXtools_htm
Top_of_FonctionsdeXtools_htm

Fonctions de Xtools

Ancre
Top_of_AppeldesfonctionsdeXtools
Top_of_AppeldesfonctionsdeXtools

Appel des fonctions de Xtools

Les fonctions de Xtools sont appelées de trois manières :

...

Ancre
Top_of_Fonctionsmono_fichier_htm
Top_of_Fonctionsmono_fichier_htm

Fonctions mono-fichier

Ancre
Top_of_Cr_erunfichier_htm
Top_of_Cr_erunfichier_htm

Créer un fichier

La création d'un fichier non séquentiel indexé s'obtient uniquement par le menu <Fichier ® Créer>. Xtools demande le nom du fichier à créer, son type et sa longueur d'enregistrements. Le bouton parcourir permet de désigner le dossier dans lequel il faut créer le fichier sans avoir à saisir le chemin.

Ancre
Top_of_Afficher_Modifierleconten
Top_of_Afficher_Modifierleconten

Afficher / Modifier le contenu d'un fichier

Cette fonction est appelée par :

...

Ancre
Top_of_Afficher_Modifierleconten_1
Top_of_Afficher_Modifierleconten_1

Afficher / Modifier le contenu d'un fichier d'après le dictionnaire

Cette fonction est appelée par le choix du menu <Fichier ® Afficher / Modifier d'après le dictionnaire>. Elle permet d'afficher les enregistrements d'un fichier d'après leur description dans le dictionnaire des données.
Choix de l'enregistrement à afficher
Lorsque vous appelez cette fonction pour la première fois (pour un enregistrement donné), vous devez introduire le nom réel du fichier, ainsi que le nom du dictionnaire des données, le nom du fichier et le nom de l'enregistrement dans le dictionnaire. Par la suite, si vous avez sauvegardé votre paramétrage dans un fichier, vous pouvez introduire simplement le nom du fichier paramètres : vous retrouverez alors le paramétrage sauvegardé.
En saisie d'un nom de fichier, le bouton Parcourir ouvre la boîte de dialogue permettant de sélectionner le fichier en naviguant dans les dossiers ou en sélectionnant un chemin implicite. En saisie du champ " Nom d'enregistrement ", le bouton Parcourir permet de sélectionner l'enregistrement dans la liste des enregistrements du dictionnaire.
Affichage de l'enregistrement
La boîte de saisie initiale validée, Xtools affiche un tableau présentant UN enregistrement du fichier. Chaque ligne du tableau présente UNE donnée de cet enregistrement. Les premières colonnes affichent la description de la donnée dans le dictionnaire (nom, libellé, position, longueur, nature), la dernière affiche la valeur de cette donnée dans le fichier. Au dessus du tableau, la clé en cours est également affichée et peut être saisie.
Remarque : le dictionnaire renseigne sur l'existence et la position d'un code enregistrement pour l'enregistrement sélectionné. Le cas échéant, Xtools n'affiche que les enregistrements du fichier dont le code enregistrement correspond à celui précisé dans le dictionnaire.
Plus précisément, les colonnes du tableau contiennent :

...

Ancre
Top_of_Afficher_Modifierleconten_2
Top_of_Afficher_Modifierleconten_2

Afficher / Modifier le contenu physique d'un fichier

Cette fonction est appelée par :

...

Elle lit le fichier sans tenir compte de la structure Harmony des enregistrements, c'est à dire qu'elle lit le contenu du fichier tel qu'il est écrit sur le disque (en-tête Harmony excepté). Xtools lit le fichier par paquets de 400 octets. La modification du fichier est possible mais il faut faire attention à ne pas modifier les longueurs d'enregistrement.
Si le choix est appelé par le menu, Xtools demande le nom du fichier ainsi que le numéro d'octet à partir duquel il faut démarrer l'affichage. L'appel par la touche Ctrl+C provoque l'affichage à partir du début du fichier.
Le fichier est affiché en mode liste dans un tableau par tranches de 400 octets divisées en colonnes de 50 octets. La première colonne du tableau affiche le numéro d'octet correspondant au début des 400 octets. Les touches traitées sont les mêmes que pour le choix Afficher / Modifier le contenu d'un fichier.

Ancre
Top_of_Copierunfichier_htm
Top_of_Copierunfichier_htm

Copier un fichier

La fonction de copie de fichier est appelée uniquement depuis le menu <Fichier ® Copier un fichier>. Elle permet de recopier un fichier vers un autre et se distingue de la copie multiple par les caractéristiques suivantes :

...

Ancre
Top_of_Modifierlescaract_ristiqu
Top_of_Modifierlescaract_ristiqu

Modifier les caractéristiques d'un fichier

L'affichage des caractéristiques d'un fichier est obtenu par la touche Shift F4 pendant le pointage. C'est le mode fiche du pointage, dans lequel on affiche des informations complémentaires sur le fichier.
En mode fiche, les touches suivantes sont traitées :

...

Pour mettre en oeuvre le contrôle de cohérence, il faut compiler les nouveaux programmes avec un numéro de version dans le dictionnaire et livrer les nouveaux fichiers avec ce numéro de version et la case « Toujours contrôler la version » cochée.

Ancre
Top_of_Supprimerunfichier_htm
Top_of_Supprimerunfichier_htm

Supprimer un fichier

Ce choix est appelé à partir du menu <Fichier ® Supprimer>, par le bouton ou la touche Suppr. Si aucun ou un seul fichier est pointé, Xtools demande le nom du fichier à supprimer. Si un fichier est pointé, il est proposé par défaut. Si plusieurs fichiers sont pointés, on effectue la suppression des fichiers pointés.
Si le fichier est séquentiel indexé, seul le fichier des clés est supprimé.
La suppression du fichier passe par une confirmation avec le message "Suppression du fichier xxxxxx Oui Non Tous Abandon". Le choix Tous supprime tous les fichiers pointés, sans confirmation fichier par fichier.

Ancre
Top_of_Effacerunfichier_htm
Top_of_Effacerunfichier_htm

Effacer un fichier

Ce choix est appelé à partir du menu <Fichier ® Effacer>, ou avec le bouton Effacement. Si aucun fichier n'est pointé, Xtools demande le nom du fichier à effacer. Si un fichier est pointé, il est proposé par défaut.
Un fichier séquentiel indexé est réinitialisé, c'est à dire que le fichier des données est effacé.
L'effacement du fichier passe par une confirmation avec le message "Effacement du fichier xxxxxx Oui Non Tous Abandon". Le choix Tous efface tous les fichiers pointés, sans confirmation fichier par fichier.

Ancre
Top_of_Renommerunfichier_htm
Top_of_Renommerunfichier_htm

Renommer un fichier

Le changement du nom d'un fichier est obtenu par le menu <Fichier ® Renommer>, le bouton correspondant ou par la touche F4.
Si le choix est obtenu par le menu, Xtools demande l'ancien nom du fichier (le fichier désigné par le curseur dans le pointage est proposé par défaut) puis son nouveau nom. Ce nouveau nom ne doit pas comporter de chemin. Le fichier est renommé dans le même dossier.
Dans tous les cas, si on renomme un fichier Séquentiel Indexé, Xtools propose également de renommer le fichier des données dans les paramètres du Séquentiel Indexé.

Ancre
Top_of_Cr_erunfichiers_quentieli
Top_of_Cr_erunfichiers_quentieli

Créer un fichier séquentiel indexé

Les caractéristiques d'un fichier séquentiel-indexé sont résumées dans le tableau suivant :

...

Ancre
Top_of_Afficher_Modifierlesparam
Top_of_Afficher_Modifierlesparam

Afficher / Modifier les paramètres d'un fichier séquentiel indexé

Ce choix est appelé par :

...

Ancre
Top_of_R_g_n_rerunfichiers_quent
Top_of_R_g_n_rerunfichiers_quent

Régénérer un fichier séquentiel indexé

Cette fonction est appelée à partir du menu <Isam ® Régénérer>. Si aucun ou un seul fichier est pointé, Xtools demande le nom du fichier à traiter (si un fichier est pointé, il est proposé par défaut). Si plusieurs fichiers sont pointés, Xtools effectue le traitement demandé sur tous les fichiers pointés. Remarque : les régénérations sont faites par le programme XREOF.

Ancre
Top_of_R_organiserunfichiers_que
Top_of_R_organiserunfichiers_que

Réorganiser un fichier séquentiel indexé

Cette fonction est appelée à partir du menu <Isam ® Réorganiser>. Si aucun ou un seul fichier est pointé, Xtools demande le nom du fichier à traiter (si un fichier est pointé, il est proposé par défaut). Si plusieurs fichiers sont pointés, Xtools effectue le traitement demandé sur tous les fichiers pointés. Remarque : les réorganisations sont faites par le programme XREOF.
Attention : avant de lancer une réorganisation des fichiers, il faut avoir effectué une sauvegarde des fichiers à réorganiser. Un incident survenant pendant la réorganisation (par exemple une coupure secteur) peut provoquer la destruction des données.

Ancre
Top_of_ExplorerundossieravecXtoo
Top_of_ExplorerundossieravecXtoo

Explorer un dossier avec Xtools

Cette fonction est accessible depuis le menu " Pop-Up ", appelé en cliquant avec le bouton droit de la souris sur la ligne du fichier ou du dossier concerné.
Elle permet d'afficher la liste des fichiers inclus dans le dossier et correspondant au filtre et au format. Si la ligne courante correspond à un dossier, on affiche ses fichiers ; si elle correspond à un fichier, on affiche les fichiers du dossier contenant ce fichier. Cette fonction est particulièrement intéressante après une recherche de fichier multi-dossier car elle permet de se placer directement dans le dossier du fichier trouvé.

Ancre
Top_of_Explorerundossieravecl_ex
Top_of_Explorerundossieravecl_ex

Explorer un dossier avec l'explorateur

Cette fonction est accessible depuis le menu " Pop-Up ", appelé en cliquant avec le bouton droit de la souris sur la ligne du fichier ou du dossier concerné.
Elle permet d'ouvrir l'explorateur de Windows sur le dossier concerné ou sur le dossier contenant le fichier concerné.

Ancre
Top_of_Ouvrirunfichieravecleprog
Top_of_Ouvrirunfichieravecleprog

Ouvrir un fichier avec le programme associé

Cette fonction est accessible depuis le menu " Pop-Up ", appelé en cliquant avec le bouton droit de la souris sur la ligne du fichier ou du dossier concerné. Elle permet d'ouvrir le fichier pointé avec le programme associé (c.a.d. suivant son extension).
Exemples :
Xwin (.dhsp, .dhse, .dhsi) XrtDiva (.dhop) DivaltoViewer (.dhvw) Excel (.xls).
Si la ligne correspond à un dossier, Xtools ouvre l'explorateur sur ce dossier.

Ancre
Top_of_Fonctionsmulti_fichier_ht
Top_of_Fonctionsmulti_fichier_ht

Fonctions multi-fichier

Ancre
Top_of_Supprimerlesfichierspoint
Top_of_Supprimerlesfichierspoint

Supprimer les fichiers pointés

La suppression des fichiers pointés est appelée par :

...

Ancre
Top_of_Effacerlesfichierspoint_s
Top_of_Effacerlesfichierspoint_s

Effacer les fichiers pointés

L'effacement des fichiers pointés est appelé par :

...

Un fichier séquentiel indexé est réinitialisé, c'est à dire que le fichier des données est effacé.
L'effacement passe par une confirmation avec le message " Effacement du fichier xxxxxx Oui Non Tous Abandon " (voir rubrique précédente).

Ancre
Top_of_R_g_n_rerlescl_sdesfichie
Top_of_R_g_n_rerlescl_sdesfichie

Régénérer les clés des fichiers pointés

La régénération est appelée depuis le menu <Isam ® Régénérer>.
Seuls les fichiers de type séquentiel indexé sont traités.
Xtools appelle (sans confirmation) XREOF pour chaque fichier concerné. En cas d'erreur de régénération, Xtools affiche un message d'erreur à acquitter puis poursuit avec le fichier suivant.

Ancre
Top_of_R_organiserlesfichierspoi
Top_of_R_organiserlesfichierspoi

Réorganiser les fichiers pointés

La réorganisation est appelée depuis le menu <Isam ® Réorganiser>.
Le déroulement est identique à la régénération (il est toutefois possible d'arrêter la réorganisation, par exemple si les sauvegardes – fortement conseillées – n'ont pas été effectuées).
Attention : avant de lancer une réorganisation des fichiers, il faut avoir effectué une sauvegarde des fichiers à réorganiser. Un incident survenant pendant la réorganisation (par exemple une coupure secteur) peut provoquer la destruction des données.

Ancre
Top_of_Copierlesfichierspoint_s
Top_of_Copierlesfichierspoint_s

Copier les fichiers pointés

La copie des fichiers pointés est appelé par :

...

Ancre
Top_of_Comprimer_d_comprimerlesf
Top_of_Comprimer_d_comprimerlesf

Comprimer / décomprimer les fichiers pointés

La compression des fichiers pointés est appelé par :

...

  • Xtools demande le chemin destination qui désigne le dossier dans lequel il faut copier les fichiers. Le bouton Parcourir ouvre une boîte de dialogue qui permet de sélectionner un chemin en naviguant dans les dossiers ou en choisissant un chemin implicite. Si le dossier de destination n'existe pas, Xtools propose de le créer.

  • Le fichier destination est toujours effacé avant la copie.

  • Xtools refuse la compression d'un fichier déjà comprimé et la décompression d'un fichier non comprimé.

  • La création du fichier destination est effectuée après le message de confirmation suivant (Cf. rubrique consacrée à la copie de fichiers) : " Création du fichier /CHEMIN/FICHIER Oui, Non, Tous, Abandon, aUcun ? ".

  • Si le fichier destination existe déjà, son remplacement est effectué après le message de confirmation suivant (Cf. rubrique consacrée à la copie de fichiers) : " Remplacement du fichier /CHEMIN/FICHIER Oui, Non, Tous, Abandon, aUcun ? ".

Ancre
Top_of_Contr_ler_l_int_grit__des
Top_of_Contr_ler_l_int_grit__des

Contrôler l'intégrité des fichiers pointés

Remarque préliminaire
Par la suite, lorsque nous parlerons de fichier « .err », « .new » et « .old », il s'agira du fichier « Xxxx.err/new/old », où Xxxx désigne le nom (sans extension) du fichier contrôlé.
Méthodologie du programme de contrôle d'intégrité
Pour chaque fichier pointé, le fichier des données est balayé séquentiellement. Xtools contrôle la longueur de chaque ligne lue par rapport à la taille de la table indiquée dans le dictionnaire. Si le fichier contient plusieurs tables, Xtools détermine à quelle table correspond une ligne grâce aux identifiants décrits dans le dictionnaire.
Pour chaque ligne lue, deux cas peuvent se produire :

...

Ancre
Top_of_Imprimerlesfichierspoint
Top_of_Imprimerlesfichierspoint

Imprimer les fichiers pointés

La liste des fichiers pointés est appelée par :

...

Cette fonction imprime une ligne pour chaque fichier pointé, reprenant en partie les informations affichées dans le tableau de pointage.

Ancre
Top_of_Cr_erunfichierpilote_htm
Top_of_Cr_erunfichierpilote_htm

Créer un fichier pilote

La génération d'un fichier pilote est accessible uniquement par le choix du menu <Outils ® Créer un fichier pilote>. Elle permet par exemple de générer des pilotes de compilation ou de régénération des clés.
Xtools demande le nom d'un fichier modèle et le nom du fichier pilote à générer. Le bouton Parcourir ouvre une boîte de dialogue qui permet de sélectionner le fichier en naviguant dans les dossiers ou en choisissant un chemin implicite. Si le fichier à générer existe, il propose de l'effacer ou au contraire d'écrire à la suite.
Le fichier modèle est constitué de deux parties nommées 1 et 2. La partie 1 est optionnelle : elle est présente si une des lignes du fichier commence par la chaîne "/DEBUT", absente sinon (cette chaîne "/DEBUT" en première colonne d'une ligne sépare partie 1 et partie 2).
Si la partie 1 est présente, Xtools la copie telle quelle dans le fichier de sortie. Ensuite, et pour chaque fichier pointé, il copie la partie 2 du fichier modèle dans le fichier à générer en effectuant le remplacement de 4 paramètres de substitution ayant la signification suivante (exemple avec le fichier /Divalto/sys/xtools.dhop) :

...


Exemple : Soit les 2 fichiers pointés /Divalto/src/xpath.dhse et /Divalto/src/xtools.dhse.
Si le fichier modèle contient la ligne suivante : xFormCompiler,$0,$1$2.dhoe,o,,, on obtiendra le fichier pilote de compilation suivant : xFormCompiler,/Divalto/src/xpath.dhse,/Divalto/src/xpath.dhoe,o,,, xFormCompiler,/Divalto/src/xtools.dhse,/Divalto/src/xtools.dhoe,o,,,
Si le fichier modèle contient les lignes suivantes : ;Compilation des masques de l'application xxx ;… /DEBUT xFormCompiler,$0,$1$2.dhoe,o,,, on obtiendra le fichier pilote suivant : ;Compilation des masques de l'application xxx ;… xFormCompiler,/Divalto/src/xpath.dhse,/Divalto/src/xpath.dhoe,o,,, xFormCompiler,/Divalto/src/xtools.dhse,/Divalto/src/xtools.dhoe,o,,,

Ancre
Top_of_Fonctionsdiverses_htm
Top_of_Fonctionsdiverses_htm

Fonctions diverses

Ancre
Top_of_Changerlescheminsimplicit
Top_of_Changerlescheminsimplicit

Changer les chemins implicites

Xtools permet de changer les chemins implicites de la tâche courante par le choix du menu <Chemin ® Changer les chemins Implicites>.
Ce choix fait appel à l'utilitaire Xpath.dhop.

Ancre
Top_of_Testerl_ouvertured_unfich
Top_of_Testerl_ouvertured_unfich

Tester l'ouverture d'un fichier

Ce choix permet de simuler l'ouverture d'un fichier par un programme d'application. Il demande en entrée :

...

En réponse, Xtools affiche le nom complet du fichier ouvert OU une erreur si la tentative d'ouverture a échoué.
Vous pouvez ainsi vérifier dans quel dossier se trouve le fichier qui sera ouvert par une application (avec la liste des chemins implicites courante) ou si la liste d'implicites courante mène bien au fichier.

Ancre
Top_of_Interpr_teruncoded_erreur
Top_of_Interpr_teruncoded_erreur

Interpréter un code d'erreur Harmony

Ce choix permet de connaître la signification d'un code d'erreur Harmony. Il faut saisir le code en hexadécimal.
Exemples :
0A36 003D

Ancre
Top_of_Interpreter_un_code_d_err
Top_of_Interpreter_un_code_d_err

Interpréter un code d'erreur Windows

Ce choix permet de connaître la signification d'un code d'erreur Windows (parmi les plus courants).

Ancre
Top_of_Garnissage_des_noms_de_di
Top_of_Garnissage_des_noms_de_di

Garnissage du nom de dictionnaire et de fichier

Ce choix renseigne les champs "Dictionnaire" et "Mnémonique fichier dans le dictionnaire" dans l'en tête de fichiers physiques (voir rubrique Modifier les caractéristiques d'un fichier).
Xtools parcourt un répertoire complet, à la recherche des fichiers et des dictionnaires ; lorsqu'il rencontre un fichier dont le nom physique correspond à un nom de fichier physique d'un dictionnaire, il garnit son en tête, si celle-ci n'est pas à jour, avec le nom du dictionnaire et le nom du fichier dans le dictionnaire.