home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 14 / CD_ASCQ_14_0694.iso / demoware / gestrec / grecdoc.fr < prev    next >
Text File  |  1994-01-31  |  38KB  |  1,094 lines
  1.                              ┌────────────────┐
  2.                              │   GESTRECORD   │
  3.                              │   Version 1.   │
  4.                              │   15.01.1994   │
  5.                              └────────────────┘
  6.  
  7.                           (c)opyright Janvier 1994
  8.                     Ecrit et développé par JANNOTA PASCAL
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17. Ce programme peut être librement utilisé pendant 15 jours. Passé ce délai,
  18. et si ce programme vous intéresse (ce que j'espère), vous devez m'acquitter
  19. une licence.
  20. Vous trouverez dans le fichier "LICENCE.FR" tous les renseignements utiles
  21. à ce sujet.
  22.  
  23. J'espère que GESTRECORD vous apportera toutes les satisfactions attendus
  24. et que j'aurai prochainement de vos nouvelles!
  25. En attendant, bon travail.
  26.  
  27.  
  28. Remerciements:
  29.   - Neil Rubenking, pour son livre "Le guide programmeur Turbo Pascal" aux
  30.     éditions "DUNODTECH".
  31.   - Thomas Lachand-Robert, pour son livre "Programmation orientée objet en
  32.     Turbo Pascal" aux éditions "SYBEX".
  33.   - Borland, pour son langage et les différents outils fournis en démo que
  34.     j'ai cru utile d'incorporer à GestRecord.
  35.   - Ma femme et mes deux enfants pour leur patience.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44. Bien que GestRecord dispose d'une aide en ligne, j'ai jugé qu'il n'était pas
  45. inutile de clarifier certains points, notamment en ce qui concerne le
  46. fonctionnement du programme et la structure des fichiers d'initialisations.
  47.  
  48. GestRecord a été programmé en Turbo Pascal version 7, à l'aide de Turbo
  49. Vision.
  50. Des extensions futures sont prévus tels que la recherche multi clés, la
  51. possibilité de gérer plus de 8 millions d'enregistrements, une version
  52. pour window, etc.
  53.  
  54. GestRecord vise à atteindre le maximum d'utilisateurs: aussi bien le
  55. programmeur qui désire monter rapidement ses fichiers d'enregistrements tout
  56. en gardant la possibilité de les utiliser dans ses programmes sans aucun
  57. effort de programmation supplémentaire, que les simples utilisateurs qui
  58. désirent se 'fabriquer' un annuaire téléphonique, ou je ne sais quoi d'autre.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. Installation du programme:
  68. ==========================
  69.  
  70. A partir du DOS:
  71. ───────────────
  72.   Si la disquette a été compressée par votre distributeur, décompressez les
  73.   fichiers dans un répertoire temporaire.
  74.   Mettez-vous dans ce répertoire:
  75.     Ex: tapez sur la ligne de commande: CD\TEMP
  76.   Tapez INSTALLE
  77.  
  78. A partir de Window:
  79. ──────────────────
  80.   Après avoir décompressé la disquette,
  81.     Ouvrez le menu 'Fichier',
  82.     Cliquez sur 'Exécutez...',
  83.     Dans la fenêtre ligne de commande, tapez le chemin d'accès suivi de
  84.     INSTALLE.EXE.
  85.       Ex: C:\TEMP\INSTALLE.EXE
  86.  
  87. Le programme INSTALLE créera:
  88.  1 répertoire racine nommé: GREC
  89.  3 sous-répertoires nommés: FDATAS
  90.                             FHEADER
  91.                             FTEMP
  92.  
  93. Le répertoire GREC accueillera: le fichier d'exécution : GESTREC.EXE
  94.                                 le fichier d'aide      : GRECHELP.HLP
  95.                                 le fichier ressource   : GRECRES.TVR
  96.                                 ce fichier             : GRECDOC.FR
  97.                                 le fichier licence     : LICENCE.FR
  98.                                 Pour window:
  99.                                 un icône               : GRECIMAG.ICO
  100.                                 le fichier de lancement: GESTREC.PIF
  101.  
  102. Le répertoire GREC\FDATAS accueillera les fichiers de données qui seront
  103. créés par GESTRECORD.
  104.  
  105. Le répertoire GREC\FTEMP accueillera les fichiers temporaires utiles au
  106. programme qui seront toujours détruits en fin de cession.
  107.  
  108. Le répertoire GREC\FHEADER accueillera les fichiers d'initialisation
  109. (.~DA et .C..) créés par GestRecord pour vos fichiers de données.
  110.  
  111. ATTENTION: GESTRECORD ne pourra s'exécuter si la procédure d'installation
  112. =========  n'est pas respectée.
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Caractéristiques du programme:
  119. =============================
  120.  
  121. (Suppose que la licence a été acquitté)
  122.  
  123. Dans la mesure ou GestRecord dispose de mémoire suffisante:
  124.  - 16380 enregistrements par fichier,
  125.    (limité à 50 pour la version démo)
  126.  -   255 champs maximum par enregistrement,
  127.  -     9 types de données,
  128.  -   255 fiches 'enregistrements' différentes affichables simultanément,
  129.  -   255 fiches 'champs' différentes affichables simultanément,
  130.  - Différents outils dont certains issus des démos de Turbo Vision.
  131.  - Gestion mémoire EMS.
  132.  
  133. Configuration requise:
  134. =====================
  135.  
  136.   - Un IBM PC/AT ou 100% compatible 286 minimum,
  137.   - MS DOS 5.0 or latter,
  138.   - Une souris,
  139.   - Mémoire EMS (Non indispensable mais fortement souhaitable!).
  140.  
  141.  
  142. Démarrage du programme:
  143. =======================
  144.  
  145. A partir du DOS:
  146. ───────────────
  147. Placez vous dans le répertoire GREC en tapant sur la ligne de commande:
  148. CD GREC
  149. Puis tapez GESTREC.
  150.  
  151. A Partir de Window:
  152. ──────────────────
  153. Cliquez sur l'icône de GESTRECORD.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  ┌────────────────┐
  163.  │ MENU PRINCIPAL │
  164.  ├────────────────┘
  165.  │
  166.  ├─ Création d'un fichier
  167.  │   ├─ Initialisation du traitement
  168.  │   ├─ Nom du fichier
  169.  │   ├─ Construction des types de l'enregistrement
  170.  │   │     ├─ Nombre de champs
  171.  │   │     └─ Type de champs
  172.  │   ├─ Validation de l'initialisation des types
  173.  │   └─ Ce que fait GestRecord
  174.  │
  175.  ├─ Ouverture d'un fichier
  176.  │   ├─ Initialisation du traitement
  177.  │   ├─ Nom du fichier
  178.  │   └─ Ce que fait GestRecord
  179.  │
  180.  ├─ Construction de votre fichier
  181.  │   ├─ Enregistrements
  182.  │   │      ├─ Modifier
  183.  │   │      ├─ Ajouter
  184.  │   │      ├─ Supprimer
  185.  │   │      ├─ Rechercher
  186.  │   │      └─ Restaurer
  187.  │   └─ Champs
  188.  │          ├─ Modifier
  189.  │          ├─ Ajouter
  190.  │          ├─ Supprimer
  191.  │          └─ Rechercher
  192.  │
  193.  ├─ Fenêtres Champs et Enregistrements
  194.  │   ├─ Suivi enregistrements
  195.  │   ├─ Pour un enregistrement
  196.  │   └─ Champs
  197.  │
  198.  ├─ Sauvegarde du fichier
  199.  │   ├─ Sous le même nom
  200.  │   ├─ Sous un nom, un répertoire, une unité différent
  201.  │   └─ fermer sans sauvegarder
  202.  │
  203.  ├─ Outils
  204.  │   ├─ Calculatrice
  205.  │   ├─ Calendrier
  206.  │   ├─ Souris
  207.  │   ├─ Conversion
  208.  │   ├─ Test bit
  209.  │   ├─ Horloge
  210.  │   └─ Mémoire disponible
  211.  │
  212.  ├─ Arranger les fenêtres sur le bureau
  213.  │
  214.  └─ Quitter GestRecord
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223. DESCRIPTION DU MENU PRINCIPAL:
  224. =============================
  225.  
  226. Pour vous déplacer à l'intérieur du menu (ainsi que des boites de dialogue),
  227. vous pouvez soit utiliser la souris ou les touches du clavier:
  228.  - Avec la souris, il vous suffit de cliquer sur la commande du menu désirée.
  229.  - Avec le clavier, vous utilisez: la touche 'tabulation' pour passer d'un
  230.                                    menu à l'autre,
  231.                                    les touches flèches de direction pour
  232.                                    choisir une commande,
  233.                                    la touche <ENTREE> pour la sélectionner.
  234.  
  235. Pour toute aide désirée ne figurant pas dans ce document, reportez-vous à
  236. l'aide en ligne.
  237.  
  238.  
  239.  
  240.  
  241.  
  242. 1.1  |
  243.      ├─ Création d'un fichier
  244.      │   ├─ Initialisation du traitement
  245.      │   ├─ Nom du fichier
  246.      │   ├─ Construction des types de l'enregistrement
  247.      │   │     ├─ Nombre de champs
  248.      │   │     └─ Type de champs
  249.      │   ├─ Validation de l'initialisation des types
  250.      │   └─ Ce que fait GestRecord
  251.      |
  252.  
  253.  
  254. 1.1.1) Initialisation du traitement:
  255.        ===========================
  256.  
  257. Dans le menu 'Init' choisissez la commande 'Fichier'.
  258. Une boite de dialogue apparaît vous proposant différentes options de
  259. traitement de votre fichier.
  260.  
  261. Cette boite de dialogue ne peut pas être demandé lorsqu'un fichier est
  262. ouvert.
  263.  
  264.  
  265.  1.1.1.1) ┌ Taille Enreg.────┐
  266.           │  (∙) Fixe        │
  267.           │  ( ) Variable    │
  268.           └──────────────────┘
  269.  En cochant la case appropriée, vous indiquez à GestRecord quel type
  270.  d'enregistrement vous désirez utiliser:
  271.  
  272.  - Enregistrements fixes: les champs de type STRING (Chaîne) sont écrits
  273.    sur le disque pour la taille réelle indiquée lors de l'initialisation
  274.    des types (voir 1.1.3).
  275.    Si une taille de 100 caractères à été indiqué à GestRecord, 100
  276.    caractères seront sauvegardés même si le champs ne contient qu'un
  277.    mot de 2 caractères.
  278.    D'où un gaspillage de place.
  279.    De plus, les champs de types STRING ne pourront jamais être agrandis.
  280.    Je m'explique:
  281.      Si, lors de l'initialisation des types, vous avez indiqué à GestRecord
  282.      une taille chaîne de 20 caractères et qu'au moment d'entrer la
  283.      énième valeur de champs, vous vous apercevez que cette valeur est
  284.      plus longue ne serait-ce que d'un caractère, il vous sera impossible
  285.      d'entrer la phrase entière, contrairement aux enregistrements
  286.      variables (voir ci-dessous).
  287.    Les enregistrements constants sont davantage indiqués pour les
  288.    enregistrements ne contenant que des valeurs numériques.
  289.  
  290.  
  291.  - Enregistrements variables: les champs de types STRING (Chaîne) sont
  292.    écrits sur le disque pour leur taille réelle et non pour leur taille
  293.    initialisée (qui est toujours de 132 caractères): Un champs de type
  294.    chaîne contenant un mot de 2 lettres par exemple sera sauvegardé sur disque
  295.    pour 2 caractères et non pour 132.
  296.    Contrairement aux enregistrements fixes, la taille du champs pourra
  297.    toujours être agrandie (dans la limite des 132 caractères).
  298.  
  299.    ATTENTION: cela n'est possible que si vous choisissez l'option
  300.               'compression' (voir 1.1.1.2).
  301.  
  302.  
  303.  1.1.1.2)  ┌ Gestion fichier───┐
  304.            │  [ ] Entête       │
  305.            │  [ ] Compression  │
  306.            │  [ ] Index        │
  307.            └───────────────────┘
  308.  
  309.  Ces 3 cases à cocher permettent de définir:
  310.   - un entête: impossible pour les fichiers demandés en création.
  311.                (voir 2.1.1.)
  312.  
  313.   - une compression: Si, comme expliqué plus haut, vous avez choisi les
  314.     enregistrements variables, votre intérêt est de cocher cette case.
  315.     Elle permettra de comprimer les champs de type STRING mais également
  316.     ne sauvegardera pas les enregistrements que vous aurez supprimés.
  317.     Si vous êtes tenu par la place sur votre disque, cochez cette case.
  318.  
  319.   - Index: Les enregistrements dans GESTRECORD sont toujours pourvus d'un
  320.     index: il facilite les recherches.
  321.     Toutefois, si vous désirez initialisez vous-même l'index pour chacun de
  322.     vos enregistrements ou, si vous voulez que GestRecord bâtisse cet
  323.     index sur la base d'un de vos champs (voir 1.1.1.4) vous pouvez cocher
  324.     cette case.
  325.     Dans cette dernière éventualité, il vous faudra indiquer un numéro de
  326.     champs dans la ligne de saisie 'Champs Index' (voir 1.1.1.4) ou lors
  327.     de l'initialisation des types (voir 1.2.1).
  328.  
  329.  
  330.  1.1.1.3)   ┌─Taille Entête─────┐
  331.             └───────────────────┘
  332.  
  333.  La taille de l'entête n'est à définir que pour les fichiers demandés en
  334.  ouverture (voir 2.1.1).
  335.  
  336.  
  337.  
  338.  
  339.  1.1.1.4)   ┌─Champs Index─────┐
  340.             └──────────────────┘
  341.  
  342.  Si vous avez coché la case 'Index' (voir 1.1.1.2) vous pouvez indiquer sur
  343.  cette ligne de saisie le numéro du champs qui servira à l'indexation du
  344.  fichier.
  345.  
  346.  Ce champs doit obligatoirement indiquer un champs de type STRING.
  347.  
  348.  GESTRECORD 'prélèvera les 5 premières lettres (au maximum) de ce champs, pour
  349.  chacun de vos enregistrements, et en constituera votre index.
  350.  Il se peut que des doublons soient ainsi fabriqués, une boite message
  351.  vous en avertira et vous devrez alors entrer une nouvelle clé.
  352.  
  353.  
  354.  1.1.1.5)   ┌ Language ──────┐
  355.             │  (∙) Français  │
  356.             │  ( ) Anglais   │
  357.             └────────────────┘
  358.  
  359.  Vous indiquez à l'aide de ces deux boutons-radio le langage utilisé.
  360.  Le français est sélectionné par défaut mais vous pouvez toujours
  361.  sélectionner l'anglais si cette langue vous attire.
  362.  
  363.  
  364. 1.1.2) Nom du fichier:
  365.        ==============
  366.  
  367. Vous entrez le nom du fichier en activant la commande 'Créer' du menu
  368. 'Fichier'.
  369.  
  370. Une boite dialogue (voir aide en ligne) vous demandera d'entrer le
  371. nom du fichier que vous voulez créer.
  372. Celui-ci sera placé dans le répertoire GREC\FDATAS avec l'extension '.DAT'.
  373.  
  374. Le nom du fichier doit être de 8 caractères maximum + extension.
  375.  
  376.  
  377. 1.1.3) Construction des types de l'enregistrement:
  378.        ==========================================
  379.  
  380. GESTRECORD a besoin de différentes informations pour pouvoir créer votre
  381. fichier. Ces informations seront sauvegardés dans un fichier
  382. d'initialisation et vous n'aurez plus à les entrer.
  383.  
  384.  
  385.  
  386.  1.1.3.1) Nombre de champs:
  387.           ================
  388.  
  389.  Un champs représente une partie d'enregistrement.
  390.  Chaque enregistrement peut contenir jusqu'à 255 champs et chaque champs
  391.  peut être de 9 types différents (voir 1.1.3.2).
  392.  
  393.  Exemple d'enregistrement:
  394.    Telephone = Nom      type STRING
  395.                Prenom   type STRING
  396.                Numero   type STRING
  397.    3 champs de types STRING.
  398.  (Rappel: l'index peut être basé sur les deux trois champs, les trois
  399.   étant de type STRING).
  400.  
  401.    Client    = Nom       type STRING
  402.                Adresse   type STRING
  403.                CAnnuel   type LONGINT
  404.                CAMensuel type WORD
  405.    2 champs de type STRING,
  406.    1 champs de type LONGINT,
  407.    1 champs de type WORD.
  408.  (Rappel: l'index peut être basé sur le 1er champs -et à la rigueur sur le
  409.   deuxième).
  410.  
  411.  Pour indiquer à GESTRECORD le nombre de champs de votre enregistrement,
  412.  celui-ci vous affichera une boite dialogue dans laquelle vous pourrez
  413.  indiquer un nombre compris entre 1 et 255.
  414.  
  415.  
  416.  1.1.3.2) Types de champs:
  417.           ===============
  418.  
  419.  Le type d'un champs représente en quelque sorte sa taille en octets ainsi
  420.  que son domaine de validité.
  421.  Vous trouverez ces informations dans le tableau ci-dessous.
  422.  
  423.  A Savoir: Un champs de type numérique (autre que CHAR,STRING ou BOOLEAN)
  424.            ne peut pas commencer par un zéro.
  425.            Vous ne pouvez entrer pour un type de champs qu'une valeur
  426.            comprise dans son domaine de validité.
  427.  
  428.  Si vous ne désirez pas vous occuper des types ou si vous n'en comprenez pas
  429.  tellement l'utilité, choisissez pour vos champs le type STRING (Chaîne de
  430.  caractère).
  431.  Toutefois, cette méthode présente deux inconvénients:
  432.   - la place sur disque prise par un champs de type STRING est beaucoup
  433.     plus importante que pour les autres types.
  434.     Ex: 2 500 000 est de type LONGINT et occupe 4 octets sur le disque,
  435.         mais 8 octets (7caractères + octet de longueur) si il est de
  436.         type STRING, soit le double.
  437.   - Aucune vérification ne pourra être faite par GESTRECORD quand à la
  438.     validité du nombre entré.
  439.     Ex: Vous avez un champs dont la valeur doit être positive et qui ne
  440.         doit pas dépassé 255 (type BYTE).
  441.         Si vous sélectionner pour ce champs, le type BYTE, GESTRECORD
  442.         vérifiera que vous n'entrez que des nombres valides (compris entre
  443.         0 et 255).
  444.         Alors que si votre champs est de type STRING, c'est à vous qu'il
  445.         incombe de vérifier que vous entrer des nombres corrects.
  446.  
  447.  
  448.  
  449.                          ╔════════════════════╗
  450.  ╔════════════╤══════════╣  TABLEAU DES TYPES ╠═══════╤════════════════╗
  451.  ║            │          ╚══════════════════╤═╝       │                ║
  452.  ║  Nom Types │         Validité            │ Octets  │     Type       ║
  453.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  454.  ║  SHORTINT  │        -128 à +127          │   1     │   numérique    ║
  455.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  456.  ║  BYTE      │          0 à 255            │   1     │   numérique    ║
  457.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  458.  ║  INTEGER   │       -32768 à +32767       │   2     │   numérique    ║
  459.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  460.  ║  WORD      │          0 à 65535          │   2     │   numérique    ║
  461.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  462.  ║  LONGINT   │   -2147483648 à +2147483647 │   4     │   numérique    ║
  463.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  464.  ║  REAL      │      -2.9E-39 à +1.7E38     │   6     │   numérique    ║
  465.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  466.  ║  CHAR      │     1 lettre ou un nombre   │   1     │ alpha-numérique║
  467.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  468.  ║  STRING    │     jusqu'à 132 caractères  │ 3 à 133 │ alpha-numérique║
  469.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  470.  ║  BOOLEAN   │      0 ou 1/ Vrai ou Faux   │   1     │    numérique   ║
  471.  ╚════════════╧═════════════════════════════╧═════════╧════════════════╝
  472.  
  473.  
  474.  Pour l'initialisation des types GESTRECORD vous propose une boite de
  475.  dialogue dans laquelle vous pourrez le nom  (10 caractères maxi), et le
  476.  type de chaque champs, la longueur en caractères des champs de types
  477.  STRING (132 maximum et uniquement pour enregistrements fixes).
  478.  Voir l'aide en ligne pour tous renseignements concernant le fonctionnement
  479.  de cette boite dialogue.
  480.  
  481.  
  482. 1.1.4) Validation de l'initialisation des types:
  483.        ========================================
  484.  
  485. Une fois le type de chaque champs initialisé, une fenêtre de confirmation
  486. sera proposée.
  487. Elle listera le numéro, le nom, le type et la taille en octets de chaque
  488. champs de votre enregistrement.
  489. Si vous vous apercevez d'une erreur, et que vous annuliez cette fenêtre
  490. par le bouton ANNULER, la boite dialogue d'initialisation des types vous sera
  491. de nouveau proposée afin d'y effectuer toute modifications nécessaires.
  492.  
  493. Sinon, la séance d'initialisation se termine. GestRecord vous demandera
  494. encore de spécifier un numéro de champs pour l'index, si l'option a été
  495. cochée (voir 1.1.1.2).
  496. Vous pourrez alors commencer à entrer des données dans votre fichier.
  497.  
  498. A Savoir: Le nombre de champs d'un enregistrement pourra toujours être
  499.           modifié par les commandes Ajouter ou supprimer du menu
  500.           'Champs' (Voir 1.3.2) mais en aucun cas un type champs ne pourra
  501.           être modifié une fois votre enregistrement construit.
  502.           Si, votre fichier construit, vous vous apercevez d'une
  503.           erreur de type, il vous faudra annuler le champs par la
  504.           commande Champs|supprimer (et perdre les données du champs) puis
  505.           ajouter ce champs, pourvu de son nouveau type, à l'aide de la
  506.           commande Champs|ajouter.
  507.  
  508.  
  509. 1.1.5) Ce que fait GESTRECORD:
  510.        ======================
  511.  
  512. Pour se 'souvenir' de la structure de votre enregistrement, GestRecord
  513. utilise lui-même (en autre) des enregistrements.
  514.   Pour ceux que ça intéresse, vous pourrez trouver la structure de ces
  515.   enregistrements et des fichiers d'initialisation dans le code source
  516.   du programme).
  517.  
  518.   Avertissement: GESTRECORD est sur de ce qu'il écrit dans ses fichiers
  519.   d'initialisation, et il ne s'attend pas (mais alors pas du tout) à ce
  520.   qu'on les modifie sans l'en avertir!
  521.   Aussi, des modifications dans les fichiers d'initialisation (.~DA et
  522.   .C..) pourraient se révéler être une catastrophe pour vos fichiers de
  523.   données, sinon pour votre système (vous voilà avertie!).
  524.  
  525.   Si j'ai créé des fichiers d'initialisation séparés du fichier de données,
  526.   c'est afin de permettre aux programmeurs d'utiliser ces derniers dans
  527.   leurs programmes sans devoir s'encombrer d'un entête.
  528.   Ainsi, peuvent-ils les utiliser en tant que fichiers typés (pour les
  529.   enregistrements constants) leur évitant de se battre avec les octets.
  530.  
  531. Que fait donc GESTRECORD? C'est assez simple:
  532.   Pour chacun de vos champs il garde en mémoire (sur le tas) son nom,
  533.   son type, son rang, sa taille en octets, et la position du champs suivant.
  534.   Le tout sera sauvegardé dans le fichier '.~DA' à la fermeture du fichier.
  535.  
  536.  
  537.  
  538. 1.2)     |
  539.          ├─ Ouverture d'un fichier
  540.          │   ├─ Initialisation du traitement
  541.          │   ├─ Nom du fichier
  542.          │   └─ Ce que fait GestRecord
  543.          |
  544.  
  545.  
  546. 1.2.1) Initialisation du traitement:
  547.        ============================
  548.  
  549.  Les initialisations de traitement sont les mêmes que pour la création
  550.  d'un fichier (se reporter à 1.1.1) si ce n'est l'option d'entête.
  551.  
  552.  Si votre fichier n'a pas été créé par GestRecord et qu'il comporte un
  553.  entête, vous DEVEZ en avertir le programme en:
  554.    - cochant la case Entête
  555.    - indiquer sa taille sur la ligne de saisie 'Taille entête'.
  556.  
  557.  Si vous n'indiquez pas une bonne taille (ou pire, aucune taille),
  558.  GestRecord pourrait ne pas être capable de déceler l'erreur et il y a
  559.  de fortes chances pour qu'il écrase cet entête.
  560.  Aussi, soyez prudent si votre fichier en comporte une.
  561.  
  562.  Si votre fichier a déjà été traité avec succès par GestRecord, certaines
  563.  options seront initialisé par lui:
  564.    - la taille entête,
  565.    - l'index et le numéro du champs,
  566.    - enregistrement variable ou fixe.
  567.  
  568.  Il vous demandera en outre, si votre fichier est à enregistrements
  569.  variables, et si vous n'avez pas coché l'option 'compression', si vous
  570.  désirez cette dernière.
  571.  
  572.  
  573.  
  574. 1.2.2) Nom du fichier:
  575.        ==============
  576.  
  577. La même boite de dialogue que pour la création d'un fichier vous sera
  578. proposée, comportant la liste des fichiers à extension '.DAT'.
  579.  
  580. Attention: veillez à vous trouvez dans le répertoire contenant ce
  581. fichier, et qui deviendra le répertoire courant. Au cas, utilisez la
  582. commande Fichier|Change rep.
  583.  
  584.  
  585. 1.2.3) Ce que fait GestRecord:
  586.        ======================
  587.  
  588. Après ouverture du fichier GestRecord effectue les tâches suivantes:
  589.  - lecture dans le fichier d'initialisation (.~DA)
  590.      - the version number,
  591.      - du nombre d'enregistrement de votre fichier,
  592.      - du nombre d'index valides et invalides,
  593.      - du nombre de cle par enregistrement (uniquement pour versions
  594.        futures)
  595.      - de la taille entête,
  596.      - des options de traitements,
  597.      - du type, nom, etc de chacun des champs,
  598.      - de  la taille, position de chacun des enregistrements du fichier,
  599.  - lecture du fichier '.C..' pour construction d'une collection de clés,
  600.  - vérification de la taille de l'entête,
  601.  - vérification que le nombre d'enregistrement dans votre fichier
  602.    correspond bien à celui sauvegarder par GestRecord.
  603.  C'est tout.
  604.  Le travail sur votre fichier peut commencer.
  605.  
  606.  
  607.  
  608. 1.3)   |
  609.        ├─ Construction de votre fichier
  610.        │   ├─ Enregistrements
  611.        │   │      ├─ Modifier
  612.        │   │      ├─ Ajouter
  613.        │   │      ├─ Supprimer
  614.        │   │      ├─ Rechercher
  615.        │   │      └─ Restaurer
  616.        │   └─ Champs
  617.        │          ├─ Modifier
  618.        │          ├─ Ajouter
  619.        │          ├─ Supprimer
  620.        │          └─ Rechercher
  621.        |
  622.  
  623.  
  624.  
  625. 1.3.1) Enregistrements:
  626.        ===============
  627.  
  628. Rappel: Les enregistrements sont des structures de données regroupant
  629.         différents champs et sauvegardés séquenciellement sur disque.
  630.         Un enregistrement peut être de deux types:
  631.           - Fixe    : voir 1.1.1.1
  632.           - variable: voir 1.1.1.2
  633.         Le traitement des enregistrements variables est un peut plus
  634.         long que pour les enregistrements fixes mais le jeu en vaut la
  635.         chandelle.
  636.  
  637.         Votre fichier peut contenir autant d'enregistrements qu'il y a
  638.         de place sur votre disque mais GestRecord ne peut (pour l'instant)
  639.         n'en gérer que 16380 par fichier.
  640.  
  641.         Ce chiffre représente le nombre maximum de pointeurs que peut
  642.         contenir une collection et est du à la segmentation de la
  643.         mémoire gérée sous Turbo Pascal:
  644.          1 segment = 65520 octets
  645.          1 pointeur = 4 octets
  646.          65520/4 = 16380 pointeurs.
  647.  
  648.         Une prochaine version dépassera largement ce seuil.
  649.  
  650.  
  651.  
  652.   1.3.1.1) Modifier:
  653.            ========
  654.  
  655.   Cliquer sur la commande Enregistrement|Modifier créera une boite de
  656.   dialogue qui vous permettra:
  657.    - de modifier chaque valeur de champs,
  658.    - d'annuler un enregistrement,
  659.    - d'en ajouter,
  660.    - de rechercher un enregistrement ou un champs,
  661.    - de restaurer un enregistrement.
  662.  
  663.   Reportez-vous à l'aide en ligne pour l'utilisation de cette boite dialogue.
  664.  
  665.  
  666.  
  667.   1.3.1.2) Ajouter:
  668.            =======
  669.  
  670.   Cliquer sur cette commande ajoute un enregistrement vide à la fin de
  671.   votre fichier.
  672.   La clé de cet enregistrement sera initialisée avec une valeur par défaut
  673.   et il vous sera toujours possible de la modifier ultérieurement.
  674.  
  675.  
  676.  
  677.   1.3.1.3) Supprimer:
  678.            =========
  679.  
  680.   Cliquer sur cette commande fait apparaître une boite dialogue vous
  681.   demandant d'entrer le numéro d'index ou le numéro d'enregistrement ou
  682.   la clé d'index de l'enregistrement à supprimer.
  683.  
  684.   Après vérification de la validité de la valeur entrée, GestRecord marque
  685.   votre enregistrement comme étant supprimé, mais ne l'efface pas du
  686.   disque.
  687.  
  688.   Cet enregistrement pourra toujours être restauré par la commande
  689.   Enregistrement|Restaurer (Voir 1.3.1.5) sauf
  690.    - si par la commande Enregistrement|Ajouter, GestRecord l'a utilisé,
  691.    - si vous avez demandé la compression (voir 1.1.1.2) auquel cas
  692.      l'enregistrement sera réellement effacé lors de la fermeture du
  693.      fichier.
  694.  
  695.  
  696.  
  697.   1.3.1.4) Rechercher:
  698.            ==========
  699.  
  700.   La même boite de dialogue que pour la commande Enregistrement|supprimer
  701.   vous demandera d'entrer le numéro d'index ou le numéro d'enregistrement
  702.   ou la clé d'index.
  703.  
  704.   Après vérification de la valeur entrée, une boite message vous donnera
  705.   le rang index, le rang sur disque et la clé de l'enregistrement
  706.   recherché.
  707.  
  708.   Si dans la boite dialogue Enregistrement, vous avez coché la case
  709.   'Fenêtre', une fenêtre pour un enregistrement (voir 1.4.2)
  710.   s'affichera sur le bureau, à moins qu'elle n'ait déjà été créée, auquel
  711.   cas, elle sera amené en avant plan.
  712.  
  713.  
  714.  
  715.   1.3.1.5) Restaurer:
  716.            =========
  717.  
  718.   Comme indiqué en 1.3.1.3, il vous est possible de récupérer un
  719.   enregistrement effacé du moment que GestRecord ne l'a pas utilisé
  720.   ou que votre fichier n'ait pas été refermé depuis la suppression
  721.   avec l'option 'compression' active.
  722.  
  723.   Une boite de dialogue vous renseignera sur les enregistrements qui
  724.   peuvent encore être restaurés et vous demandera d'entrer le rang index de
  725.   celui à restaurer.
  726.  
  727.   L'enregistrement deviendra de nouveau valide.
  728.  
  729.   Si GestRecord ne peut pas récupérer la clé index de cet enregistrement,
  730.   un clé par défaut lui sera affectée, clé que vous pourrez toujours
  731.   modifier par la suite.
  732.  
  733.  
  734.  
  735. 1.3.2) Champs:
  736.        ======
  737.  
  738. Rappel: Un champs peut être de 9 types différents (voir 1.1.3.2) et
  739.         chaque enregistrement peut contenir jusqu'à 255 champs.
  740.  
  741.  
  742.  
  743.   1.3.2.1) Modifier:
  744.            ========
  745.  
  746.   Tout comme la commande Enregistrement|modifier, cette commande construit
  747.   une boite de dialogue qui vous permet d'initialiser les valeurs de
  748.   champs (voir 1.3.1.1)
  749.  
  750.  
  751.  
  752.   1.3.2.2) Ajouter:
  753.            =======
  754.  
  755.   Ajouter un champs modifie la structure de l'enregistrement. Si vous
  756.   désirez ajouter un champs, ce sont tous les enregistrements de votre
  757.   fichier qui seront modifiés.
  758.  
  759.   Cette commande, après que GestRecord vous ait demander de confirmer,
  760.   vous demande d'initialiser le champs supplémentaire, tout comme vous
  761.   l'avez fait lors de la création d'un fichier (voir 1.1.3.2).
  762.   Chaque enregistrement de votre fichier est ensuite greffé du
  763.   nouveau champs.
  764.  
  765.   Toutes les fenêtres d'affichage d'enregistrement ou de champs ainsi
  766.   que la boite dialogue de gestion des champs seront détruites. Vous
  767.   serez libre de les reconstruire une fois le champs ajouté.
  768.  
  769.  
  770.  
  771.   1.3.2.3) Supprimer:
  772.            =========
  773.  
  774.   Tout comme pour ajouter un champs, une confirmation vous est demandé.
  775.   Cette fois, GestRecord supprime le champs que vous lui aurez indiqué.
  776.   Attention: GestRecord ne peut pas récupérer un champs supprimé et
  777.   toutes les données contenu dans le champs en question, et ce, pour
  778.   tous vos enregistrements, seront perdus (sans espoir de retour).
  779.  
  780.   Aussi, réfléchissez bien avant de supprimer un champs.
  781.   Il est bien souvent préférable d'avoir un champs inutilisé pour
  782.   certains enregistrements.
  783.  
  784.   Comme pour la commande Champs|ajouter toutes les fenêtres champs et
  785.   enregistrements seront détruites.
  786.  
  787.  
  788.  
  789.   1.3.2.4) Rechercher:
  790.            ==========
  791.  
  792.   Une boite de dialogue contenant la liste des noms des champs vous est
  793.   proposé.
  794.   Le seul moyen pour GestRecord de rechercher un champs est par ce nom.
  795.   Aussi, veillez à donner un nom bien précis à chacun de vos champs lors
  796.   de l'initialisation des types (voir 1.1.3.2).
  797.  
  798.   Le champs trouvé, GestRecord vous indiquera son rang, son type, et son
  799.   nom.
  800.  
  801.  
  802. 1.4   |
  803.       ├─ Fenêtres Champs et Enregistrements
  804.       │   ├─ Suivi enregistrements
  805.       │   ├─ Pour un enregistrement
  806.       │   └─ Champs
  807.       |
  808.  
  809.  
  810.  
  811.  
  812.  1.4.1) Suivi enregistrements:
  813.         ======================
  814.  
  815.  La fenêtre Suivie enregistrements n'est réellement utile que si vous
  816.  travaillez avec la boite dialogue 'gestion des champs'.
  817.  
  818.  A chaque changement d'enregistrement, cette fenêtre vous affichera le
  819.  contenu de l'enregistrement en cours.
  820.  Les valeurs des champs seront mises à jour en temps réel, c'est à dire
  821.  à chaque initialisation ou changement des valeurs de champs.
  822.  
  823.  Cette fenêtre est reconnaissable à sa couleur cyan (bleu clair).
  824.  
  825.  
  826.  
  827.  1.4.2) Pour un enregistrement:
  828.         ======================
  829.  
  830.  Contrairement à la fenêtre précédente, celle-ci n'est construite que
  831.  pour un enregistrement spécifique que vous aurez à préciser, soit
  832.  par son numéro d'index, son numéro d'enregistrement ou sa clé
  833.  d'index.
  834.  
  835.  Cette fenêtre n'est mise à jour que dans la mesure où vous modifier un
  836.  des champs de l'enregistrement rattaché à celle-ci.
  837.  
  838.  Sa couleur est bleu.
  839.  
  840.  
  841.  
  842.  1.4.3) Champs:
  843.         ======
  844.  
  845.  La fenêtre champs liste un champs, précisé lors de la construction de la
  846.  fenêtre, de tous les enregistrements de votre fichier.
  847.  Comme les deux précédentes, sa mise à jour s'effectue en temps réel.
  848.  
  849.  
  850. Il vous est possible d'ouvrir:
  851.   1 fenêtre de suivi,
  852.   255 fenêtres un enregistrement,
  853.   255 fenêtres champs.
  854.  
  855. Ce programme travaillant en mode réel, et bien qu'utilisant l'EMS, il
  856. y a fort peu de chances pour que vous puissiez en ouvrir autant.
  857.  
  858. Sachez toutefois, que comme dit précédemment, les fenêtres sont mises
  859. à jour en temps réel et qu'un grand nombre de fenêtres ouvertes
  860. simultanément peut entraîner des ralentissement importants.
  861.  
  862. Si vous trouvez que le programme 'rame' un peu, faites un peu le
  863. nettoyage de votre bureau. Un bureau encombré n'a jamais été propice au
  864. bon boulot!
  865.  
  866. Les fenêtres champs et enregistrements sont détruites par GestRecord
  867. lors de certaines actions:
  868.  - fermeture du fichier,
  869.  - ajout ou suppression d'un champs,
  870.  - ajout, suppression ou restauration d'un enregistrement (ne détruit que
  871.    la fenêtre de suivie).
  872.  
  873. Vous pouvez créer ces fenêtres à tout moment du programme, tant que la
  874. mémoire le permet.
  875. GestRecord s'occupe que vous n'ouvriez pas deux fois la même fenêtre, en
  876. amenant celle-ci au premier plan du bureau.
  877.  
  878.  
  879.  
  880.  
  881. 1.5   |
  882.       ├─ Sauvegarde du fichier
  883.       │   ├─ Sous le même nom
  884.       │   ├─ Sous un nom, un répertoire, une unité différent
  885.       │   └─ fermer sans sauvegarder
  886.       |
  887.  
  888.  
  889.  
  890.  1.5.1) Sous le même nom:
  891.         ================
  892.  
  893.  Pour cela choisissez la commande Fichier|sauvegarder.
  894.  GestRecord - sauvegardera vos données,
  895.             - fermera votre fichier,
  896.             - sauvegardera l'initialisation, les clés,
  897.             - détruira les fichiers temporaires.
  898.  
  899.  Vous serez libre ensuite d'ouvrir un autre fichier ou de quitter
  900.  le programme.
  901.  
  902.  
  903.  
  904.  1.5.2) Sous un nom, un répertoire, une unité différente:
  905.         ================================================
  906.  
  907.  Pour cela, choisissez la commande Fichier|Sauve sous.
  908.  
  909.  GestRecord vous demandera d'entrer le nouveau nom de fichier.
  910.  Si ce fichier existe déjà, il vous sera demandé si vous désirez l'écraser.
  911.  
  912.  La suite du traitement est identique à Sauvegarder (1.5.1).
  913.  
  914.  Sachez que les données ne sont pas sauvegardées sur l'ancien fichier.
  915.  
  916.  
  917.  
  918.  1.5.3) Fermer sans sauvegarder:
  919.         =======================
  920.  
  921.  Pour cela, choisissez la commande Fichier|sans sauve.
  922.  
  923.  Votre fichier sera fermé sans sauvegarde de vos dernières modifications et
  924.  ces dernières seront perdues.
  925.  
  926.  
  927.  
  928.  
  929. 1.6)   |
  930.        ├─ Outils
  931.        │   ├─ Calculatrice
  932.        │   ├─ Calendrier
  933.        │   ├─ Souris
  934.        │   ├─ Conversion
  935.        │   ├─ Test bit
  936.        │   ├─ Horloge
  937.        │   └─ Mémoire disponible
  938.        |
  939.  
  940.  
  941. La calculatrice, le calendrier, la souris, l'horloge et le visionneur
  942. de mémoire disponible sont des outils "offerts" par Borland dans ses
  943. programmes de démonstration.
  944. Si j'ai cru bon de les inclure dans ce logiciel, c'est qu'ils représentent,
  945. à mon avis, un réel intérêt et qu'ils peuvent vraiment vous être utiles.
  946.  
  947. Le seul changement apporté est que ces outils peuvent être affichés en
  948. français.
  949.  
  950. Pour l'utilisation des outils, reportez vous à l'aide en ligne.
  951.  
  952.  
  953.  
  954.  1.6.1) Calculatrice:
  955.         ============
  956.  C'est une simple calculatrice qui permet les 4 opérations de base.
  957.  Elle reste présente sur le bureau tant que vous ne la refermez pas
  958.  à l'aide de son icône de fermeture.
  959.  
  960.  
  961.  
  962.  1.6.2) Calendrier:
  963.         ==========
  964.  
  965.  Le calendrier affiche la date du jour (de votre système) et peut vous
  966.  renseigner sur les années passées ou à venir.
  967.  
  968.  
  969.  
  970.  1.6.3) Souris:
  971.         ======
  972.  
  973.  L'outil souris vous permet de régler la vitesse du double-click ainsi que
  974.  d'inverser les boutons droit et gauche.
  975.  Cet outil ne peut pas rester ouvert sur le bureau.
  976.  
  977.  1.6.4) Conversion:
  978.         ==========
  979.  
  980.  Cet outil est de ma fabrication! (il en faut bien)
  981.  Il vous permet de convertir un nombre entier nom signé en décimale,
  982.  binaire et hexadécimale.
  983.  
  984.  
  985.  
  986.  1.6.5) Test bit:
  987.         ========
  988.  
  989.  Cet outil vous permet de savoir si un bit précis, ou un masque de bits,
  990.  est posé dans un nombre entier non signé.
  991.  Il peut être utile pour la gestion des champs de bit, souvent utilisés
  992.  sous window ou turbo vision.
  993.  Ces deux derniers outils peuvent rester ouverts sur le bureau.
  994.  
  995.  Ex: Vous disposez d'un nombre décimal de type WORD pour lequel vous désirez
  996.      savoir si le bit 7 est posé:
  997.      2 solutions:
  998.       - utilisation de l'outil conversion:
  999.          1) vous entrez votre nombre: 559 par exemple,
  1000.          2) vous cliquez la case décimale => binaire,
  1001.          3) vous cliquez sur le bouton OK,
  1002.          4) sur la ligne résultat apparaîtra 559 en binaire:
  1003.             0000001000110000
  1004.          Vous pouvez ainsi voir tous les bits posés: le 4°,5° et 9°.
  1005.          rappel: en binaire le bit 0 est le bit le plus à droite, ainsi
  1006.             le bit 7 est-il en réalité le 8em bit.
  1007.          Le bit 7 n'est donc pas posé.
  1008.  
  1009.       - utilisation de l'outil Test bit:
  1010.          1) Vous entrez le nombre à tester: 559,
  1011.          2) Vous entrez le rang du bit à tester: 7,
  1012.          3) Vous appuyez sur le bouton 'Bit',
  1013.          4) le résultat vous sera indiqué sur la ligne résultat:
  1014.               'Bit non posé'.
  1015.  
  1016.     Pour un masque de bit, il vous suffit d'entrer le masque, sous sa
  1017.     forme décimale ou binaire dans la ligne de saisie 'Masque' et
  1018.     de cliquer le bouton 'Masque'.
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  1.6.6) Horloge:
  1026.         =======
  1027.  
  1028.  L'horloge est situé dans le coin supérieur droit du bureau et vous
  1029.  indique l'heure système.
  1030.  Ne peut être sélectionné ni modifié à l'intérieur de GESTRECORD.
  1031.  
  1032.  
  1033.  
  1034.  1.6.7) Mémoire disponible:
  1035.         ==================
  1036.  
  1037.  La mémoire disponible est indiqué dans le coin inférieur droit du
  1038.  bureau et vous indique la taille du plus grand bloc mémoire disponible.
  1039.  
  1040.  Il vous est ainsi possible de gérer la création de vos fenêtre afin
  1041.  que GESTRECORD ne vous affiche pas un message désagréable tel que:
  1042.  'plus de mémoire, ajout enregistrement impossible'!
  1043.  
  1044.  Cet outil ne tient pas compte de la mémoire EMS.
  1045.  
  1046.  
  1047.  
  1048.  
  1049. 1.7) |
  1050.      ├─ Arranger les fenêtres sur le bureau
  1051.      |
  1052.  
  1053. Le menu Fenêtre vous permet d'arranger les fenêtres de votre bureau.
  1054. Il permet la disposition en mosaïque, en cascade, la fermeture de
  1055. la fenêtre courante, etc.
  1056.  
  1057. Consultez l'aide en ligne pour l'utilisation de ses commandes.
  1058.  
  1059. Rappel: un grand nombre de fenêtres ouvertes simultanément peut entraîner
  1060. des ralentissements du programme. Aussi, de temps en temps, faites un
  1061. peu le ménage.
  1062.  
  1063.  
  1064.  
  1065. 1.8) |
  1066.      └─ Quitter GestRecord
  1067.  
  1068. Vous n'avez le droit de quitter GestRecord qu'une fois le fichier en
  1069. cours de traitement refermé.
  1070.  
  1071. Pour cela, choisissez la commande Fichier|Quitter.
  1072.  
  1073. GESTRECORD sera détruit et enlevé de votre programme.
  1074.  
  1075.  
  1076.  
  1077.  
  1078. 2.
  1079. Je reste ouvert à toute critiques (et pourquoi pas aux compliments) ou toutes
  1080. demandes d'améliorations concernant GestRecord.
  1081. Vous pouvez me joindre par courrier à l'adresse indiquée dans le fichier
  1082. LICENCE.FR (la même que pour le paiement de la licence -ne m'oubliez pas!-).
  1083.  
  1084. GESTRECORD n'est peut-être pas parfait, et c'est pourquoi je prévois des
  1085. améliorations futures, mais et il été fait et testé de manière à vous
  1086. apporter un maximum de confort dans son utilisation.
  1087.  
  1088. Ces améliorations ne pourront être apportées seulement si chacune des
  1089. personnes qui utilisent ce produit me règlent leur licence. le ShareWare est
  1090. une affaire de confiance, et le non paiement des licences entraînera
  1091. inévitablement sa mort.
  1092.  
  1093. Merci.
  1094.