home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 1996 Counselor / COMPUSERVE.ISO / internet / dpm / readme.tx_ / readme.tx
Encoding:
Text File  |  1996-06-23  |  13.1 KB  |  285 lines
  1.  
  2. DataPage Maker(tm) : a Web DataPage creation utility.
  3. ============================================
  4. DataPage Maker (DPM), Version 1.4.1, does the following:
  5.  
  6. a.  DPM transforms information, which is resident in a Microsoft(r) 
  7. Access(tm) database, into text files called DataPages.  These text 
  8. files are formatted to function as HomePages on the World-Wide Web 
  9. (WWW) and consist of HyperText Markup Language (HTML) that
  10. encapsulates the data extracted from tables in the selected database.
  11.  
  12.     (1).  DataPages are indented lists of ordered database records
  13.     (2).  DataPages contain a hyperlinked record index at the top
  14.     (3).  DataPages have checkboxes* to highlight specific records 
  15.     (4).  DataPages are hyperlinked to other DataPages to turn pages
  16.     (5).  DataPages explode foreign keys* to provide greater details
  17.  
  18.     * features activated in the Professional Version
  19.  
  20. b.  DPM operates on 386/486/Pentium class PC, using Microsoft (MS)
  21. Windows(tm), Version 3.1 or Windows 95(tm).  DPM performs the
  22. best with at least 8 Megabytes of RAM.  The DataPage Maker is written
  23. in Microsoft's Visual Basic(tm) 4.0 and requires Visual Basic's Run-
  24. Time executive, which is included in the distributed zip file set of 
  25. DPMx.ZIP. DPM.ZIP has VB Run-Time & the MS Jet Engine(tm)
  26. (VB40016.DLL & MSAJT200.DLL), while DPM1.ZIP has just VB 
  27. Run-Time (VB40016.DLL), and DPM2.ZIP which has only the
  28. minimium executable file set (DPM.EXE).
  29.  
  30. Special Note
  31. ============
  32. The Professional Version of DataPage Maker creates multiple 
  33. DataPages for larger database tables (with hyperlinked push 
  34. buttons on the top & bottom of each datapage) and also provides 
  35. a Web Forms feedback capability (feedback to the data provider) 
  36. through utilization of checkboxes, with 'Submit' and 'Reset' 
  37. buttons.
  38.  
  39. General Introduction
  40. ====================
  41. DataPage Maker utilizes Microsoft's Visual Basic 4.0, Access 2.0 
  42. databases, and MS Jet Engine 2.5. 
  43.  
  44. Limitations of DataPage Maker Version 1.4.1 are:
  45.  
  46. Twenty (20) Tables per Database -- fifteen (15) screen visible.
  47.  
  48. Twenty (20) Fields  per Table -- fifteen (15) can be SELECTED 
  49. to be visible. (a new feature)
  50.  
  51. 50,000 Records per Table (excess ignored) -- greater Record Numbers
  52. can be accommodated by custom release of the Professional Version.
  53.  
  54.  
  55. DataPage Maker assumes target databases follow design guidelines 
  56. of Microsoft's Access 2.0/7.0 (databases with the 'MDB' file extension).
  57. Once a Database is selected, a single Table must be selected from the 
  58. list of possible Tables within that Database.  The Foreign Keys within 
  59. that Table (keys that are Primary keys in other Tables), may be used 
  60. to provide additional details to the keyed fields -- if that option is
  61. selected.
  62.  
  63. Sequence of Operation
  64. =====================
  65. 1.  Select a Database.  Using the Database File Selection window upon
  66. startup, select both the Disk Drive & Directory containing the database
  67. file, as well as the specific database File Name (of File Type MS Access
  68. with an 'MDB' extension).  Once selected, press the "OK" button.
  69.  
  70. 2.  Start Section.  Activate Start button and wait until the Database
  71. Table Names are displayed in the 'Select Table' section.  The delay
  72. is due to the collection of Table & Field statistics.  You may select a
  73. Table prior to pressing the Start button if you know the number of the
  74. Table in advance.  You may also select the Fetch Key Data checkbox,
  75. as well as the Display Page Index checkbox.
  76.  
  77.     <<Start Button>>
  78.     If the Database Path and Name in the boxes at the top-left
  79.     of the screen are correct, begin the process by pressing the
  80.     Start Button.   There will be a delay, while vital database
  81.     statistics are being collected.  After this delay, the database
  82.     Table Names will be listed and you will be required to select
  83.     one of the tables.  Watch the color of the lights by each of the
  84.     command buttons to guide your flow sequence through this
  85.     process.  The Green Light near the 'Extract Data' button will
  86.     indicate when it is time to proceed.
  87.  
  88.     <<Fetch Key Data>>
  89.     In the Foreign Key Data section of the screen, there is a Fetch
  90.     Key Data checkbox.  When checked, data such as Part Number
  91.     (which is a Key or Index into another Table which contains the
  92.     Name of the Part, the Price, etc.) is exploded into many details
  93.     about that Part Number.  It is not necessary to check the Fetch
  94.     Key Data button, unless there is a need to see some cross-table
  95.     relationships.  Fetching Key Data is expensive in terms of time
  96.     to explode the data and in the number of bytes in a DataPage.
  97.  
  98.     <<Display Page Index>>
  99.     In the Directory of Records section of the screen, there is a
  100.     Display Page Index checkbox.  When checked, each DataPage
  101.     will contain an indexed list of the Record ID's that are to be
  102.     viewed below (on that page).  The Page Index is very handy
  103.     because one may jump (hyperlink) into the middle of records,
  104.     right to the desired record.  When desired, you may jump back
  105.     to the top of the Page Index to scan for the next desired data.
  106.     There is a small expense in this feature, some process time and
  107.     some additional amount of increase in bytes per DataPage.
  108.  
  109.  
  110.  
  111. 3.  Select Table Section.  When the Green Light is illuminated by 'Extract
  112. Data' button, select the desired Table by clicking one of the radio buttons
  113. in the Select Table Section -- if you haven't already done so.  Data from
  114. this selected Table will be utilized throughout the DataPage(s). 
  115.  
  116.     <<new feature>> 
  117.     There is a way process each Table in Database (one at a time)
  118.     and eliminate some (not all) of the overhead of a complete run.
  119.     Once you select a Table and let the "Extract Data" button builds
  120.     the support files (Tab_xx.DAT, where xx=table number), you
  121.     will not be required to press the Extract Data button for the next
  122.     Table.  To over-ride the non-Green Light Status of the DataPage
  123.     button, one simply needs to select the radio button right on
  124.     the "DataPage" button.  This selected radio button authorizes
  125.     you to bypass Data Extract -- assuming the data in the LAST
  126.     FULL RUN of the DataPage Maker is still current data.
  127.  
  128.  
  129. 4.  Extract Data Section.  Data records are pulled from the Fields of the 
  130. selected Table.  Support files are built for the DPM system and remain
  131. valid for the next run, as long as the selected Database remains the
  132. same and as long as the Table Data does not change.
  133. (see <<new feature>> above)
  134.  
  135.     << Extract Data Button>>
  136.     Once the desired Table has been selected, the 'Extract Data' 
  137.     procedure retrieves applicable records from the database and
  138.     stores the data, in preparation for the addition of HTML
  139.     characters.  Database information must be encapsulated in
  140.     HTML in order to be displayed on the WWW.  If the amount
  141.     of the data is too large for one WWW DataPage, the necessary
  142.     number of DataPages (max = 99) will be created (featured only
  143.     in the Professional Version). 
  144.  
  145. 5.  DataPage Section.  The extracted data is packaged in an HTML 
  146. wrapper and placed into a DataPage.  During this process Foreign
  147. Key data is exploded if the Fetch Key Data checkbox is checked and
  148. a Directory of Records is assembled if Display Page Index is checked.
  149.  
  150.     <<DataPage Button>>
  151.     DataPage Maker creates a minimum of three (3) files within
  152.     the same directory that the SOURCE database (*.MDB) 
  153.     file exists.  The files are named dxxyyyzz, where xx = is the
  154.     DataPage Page Number, yyy = the first three letters of the 
  155.     Database Name and zz = the sequential Table Number, within
  156.     that database.  The file named dxxyyyzz.htm is an HTML
  157.     DataPage displayable on WWW.  The companion files are
  158.     named dxxyyyzz.jpg, which is the logo displayed at the top
  159.     of each DataPage, and 'dp.jpg', which is the 'turn-page' graphic. 
  160.  
  161.     Example:  The 4th Page of data from the 2nd Table, of a
  162.     database named 'prices.mdb', is labeled 'd04pri02.htm', and
  163.     the companion files are labeled 'd04pri02.jpg' and 'dp.jpg'.
  164.  
  165.  
  166. 6.  Stop Section.  There is very little else that needs to be done when
  167. the Green Light is illuminated by the "Stop" button.  Clicking this
  168. button simply closes down all files & forms in a graceful fashion.
  169. This close-down may be accomplished at any time during this
  170. process -- realizing that recovery is possible only by a re-start.
  171.  
  172.     <<Stop Button>>
  173.     Make note the Database Path (upper left-hand portion of the
  174.     screen) and especially the DataPage Name (listed directly
  175.     below the 'Stop' button).  This information is required when
  176.     you display the DataPage on a Web Browser.
  177.  
  178. 6.  Viewing Data within Selected Table.  The Data Control slider 
  179. bar on the right-hand side of the screen, is associated with the selected
  180. Table.  Data from a maximum of fifteen (15) Fields may be viewed by
  181. use of the slider bar.
  182.  
  183. Forms
  184. =====
  185. The Professional Version of DataPage Maker has a Forms 'Submit' and 
  186. 'Reset' capability with checkboxes built into each DataPage, to permit 
  187. the user to select specific data records by marking the checkboxes 
  188. and submitting those marks, via E-Mail, back to the owner of the 
  189. database.  Two things must occur in order to activate this feature:
  190. (1) the destination E-Mail address must be specified so the submitted
  191. Forms may be sent to the desired location and (2) a CGI Script should
  192. be implemented on the Web Server which is home to the database
  193. owner.
  194.  
  195. HTML Specifics
  196. ==============
  197. The DataPage Maker produces a HyperText Markup Language (HTML)
  198. file,  appropriate for display of WWW DataPages, representing one (1) 
  199. Table (Entity) from the source Database.  The maximum size of a HTML 
  200. DataPage is approximately 60,000 bytes and DataPages that approach
  201. this maximum size are truncated.  The number of DataPages that will 
  202. be generated for each database Table is dependent upon the disk space
  203. available and less than a total of 99 DataPages.  (only the Professional
  204. Version of the DataPage Maker produces more than 1 DataPage per
  205. Table).
  206.  
  207. Questions, Problems, and Comments
  208. ===========================
  209. Any questions about the status of the shipment of the order, refunds, 
  210. registration options, product details, technical support, volume 
  211. discounts, dealer pricing, site licenses, non-credit card orders, 
  212. etc. must be directed to Entity Master System.  Another way to 
  213. communicate with us, is to visit our HomePage on the WWW.
  214.  
  215.  
  216. Visit us at http://www.entity-master.com/e-m.htm to record problems,  
  217. get the latest news, products, & advisories.  You can also Register 
  218. on-line and download DataPage Maker over the Internet.  We encourage 
  219. you to Register your DataPage Maker shareware.  To insure that you 
  220. get the latest version, PsL notifies us on the day of your order and 
  221. we ship the product directly to you. [ Reference PsL Product #14431 ]
  222.  
  223. Contact
  224. =======
  225. You may contact Entity Master Systems by mail: c/o Dave Fashenpour, 
  226. 714 Regency Court, Friendswood, TX 77546; or by phone at 713-996-
  227. 0819.
  228.  
  229. You may send E-Mail to either: 76461.2413@compuserve.com or 
  230. ems@entity-master.com -- but best of all, visit our HomePage at: 
  231. http://www.entity-master.com/e-m.htm.
  232.  
  233. Product Registration
  234. ====================
  235. We have contracted with Public (software) Library (PsL) to process 
  236. any orders that you may wish to place with your valid MC, Visa, 
  237. Amex, or Discover cards. Reference PsL Product #14431. PsL may be 
  238. contacted via any of the following methods:  Voice: 800-242-4775 
  239. (7 a.m.- 6 p.m. CST, except Friday afternoons).  FAX: 713-524-6398. 
  240. E-MAIL: 71355.470@Compuserve.Com. You may also mail credit card 
  241. orders to PsL, P.O. Box 35705, Houston, TX 77235. 
  242.  
  243. THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY.  
  244. THE PROGRAM AUTHOR CANNOT BE REACHED AT THE
  245. ABOVE NUMBERS. 
  246.  
  247. Reasons to Register
  248. ===================
  249. When you Register with PsL, you will receive the full set of
  250. DPM diskettes, which contains the DataPage Maker Professional (PRO)
  251. Version and user documentation.  As a registered member you will
  252. receive individual assistance with difficulties you may experience
  253. and you will also receive bug-fixes and features-update notifications, 
  254. as they occur.
  255.  
  256. E-Mail Customization
  257. ====================
  258. To set your own E-Mail address, in order to receive comments 
  259. from DataPage users, do the following:  
  260.  
  261. 1) Begin with a Green Lite on 'Start'.  (but don't press button yet)
  262.  
  263. 2) Replace 'Database Path' (at the top left of the screen) with 
  264. your E-Mail address followed directly by '@@@'.  (For example, 
  265. if your address is 'ems@entity-master.com', then enter 
  266. 'ems@entity-master.com@@@') 
  267.  
  268. 3) Press the Start button.  (Database Path will be reset 
  269. automatically & your E-Mail address will be permanently stored.) 
  270.  
  271. Help with Error #3356
  272. ================
  273. DataPage Maker Version 1.4.1, cannot open databases exclusively.  
  274. If you experience 'Run-Time Error 3356'  that states 'You cannot 
  275. open this database exclusively', an easy fix is to change the 
  276. status of the file.  A file status of 'Read Only' can be corrected 
  277. at the DOS level by typing 'attrib <file name.MDB> -r'. + 
  278.  
  279. (c) 1996 Entity Master Systems, All rights Reserved
  280. DataPage Maker(tm) -- Trademark of Entity Master Systems
  281. Microsoft(r) -- Registered Trade Name, Microsoft Corp.
  282. Access(tm) -- Trademark of Microsoft Corp.
  283. Visual Basic(tm) -- Trademark of Microsoft Corp.
  284. Jet Engine(tm) -- Trademark of Microsoft Corp.
  285.