home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1994 October / SOFM_Oct1994.bin / pc / bus / billtime / billtime.man < prev    next >
Text File  |  1994-06-25  |  34KB  |  766 lines

  1. BillTime.MAN    User manual for BillTime Version 3.12  6/25/94
  2.  
  3.                 THE DISCLAIMER
  4. Saroff Design offers BillTime "AS IS", and Saroff Design 
  5. makes no warranty, expressed or implied, with regard to the 
  6. software. All implied warranties, including the warranties of 
  7. merchantablitiy and fitness for a particular use, are hereby 
  8. excluded. In no event shall Saroff Design be liable for any lost 
  9. profits, lost savings; or other consequential, special, or indirect 
  10. damages, even if Saroff Design has been advised of the 
  11. possibility of such losses or damages. In any event, Saroff 
  12. Design liability arising out of any kind of legal claim (whether 
  13. in tort, contract, or otherwise) in connection with the software 
  14. will not exceed the fee paid for the software license.
  15.  
  16.                 THE DESCRIPTION
  17. BillTime is a full-featured, multi-user, time tracking system 
  18. which allows professionals who charge for their services to 
  19. easily keep detailed records of when and what they did. Include 
  20. features: unlimited number of work slips; multiple data areas; 
  21. reports; unlimited number of clients, activities, projects and 
  22. users. Fuzzy logic text search of all work slips. Bill charges by 
  23. time, flat rate, or not at all. Similar to expensive commercial 
  24. package, but much easier to use. It is not necessary to read the 
  25. user manual to begin using BillTime_all relevant menu choices 
  26. and hot-keys are shown at all times on the entry screens. Data 
  27. entry fields are automatically checked against automatic look-up 
  28. lists.  Free-form notes can be added to any work slip, and the 
  29. entire slip contents can be searched quickly and easily. 
  30. Registration fee: $39.00
  31. Make checks payable to 
  32. Steve Saroff,  Saroff Design  1901 Missoula Ave, Missoula MT  59802
  33.  
  34. What you get if you do pay the registration fee:  
  35. An incentive package, which contains the complete BillTime program PLUS 
  36. the ability to print invoices to the printer or a file; detail reports 
  37. which include the free-from text fields, a network licence, and access to 
  38. tech-support with E-mail and custom programming (for a fee).
  39. How hard is it to start using BillTime: not hard at all. In fact, I 
  40. suggest that once you have BillTime installed on your computer 
  41. that you go ahead and start  using it, then, if you have any 
  42. questions, read the rest of this document.
  43.  
  44.               INSTALLATION INSTRUCTIONS
  45. BillTime only needs two files to function: BillTime.exe  and 
  46. BillTime.ovl. If these files are copied to a directory called   
  47. C:\billtime  and then run (by typing  `billtime') all the data files 
  48. will be created.  
  49.  
  50. An install program is provided on the distribution diskette which 
  51. will copy these files (as well as several other optional files  -- 
  52. the manual txt file and some information files) to your hard disk, 
  53. and will allow you to designanate any drive and any directory 
  54. for your billtime system.
  55.  
  56. To use the install system, place the distribution diskette in either 
  57. drive A or drive B and then type        A:install       
  58.  
  59.  
  60.         UPDATING FROM AN EARLIER VERSION OF BILLTIME
  61. This Version of BillTime is fully back-compatible with data files 
  62. from all earlier versions of Billtime.
  63.  
  64. HOWEVER ----  when installing ANY update of ANY 
  65. database system, it is a safe practice to make a backup of 
  66. your current data files and current program files BEFORE 
  67. installing the update. This is to protect from installing files 
  68. that have been damaged by the shipping process (ie, being 
  69. X-rayed by the post office). The critical files which should 
  70. be backed up (by copying to floppy disk(s) or by using any 
  71. backup system that you are familiar with, or by copying to 
  72. another directory on your hard disk) are: billtime.exe,  
  73. billtime.ovl   and ALL the files ending with  .DBF   and .DBT extensions.
  74.  
  75.  
  76. If you are currently using an earlier version of billTime, or the 
  77. shareware version,  you should replace billtime.exe and 
  78. billtime.ovl with the new billtime.exe and billtime.ovl files. 
  79. When you run BillTime, the program will then modify several of 
  80. your data files. None of your current data will be changed, and 
  81. all of your current menu and program items will be the same. 
  82. What will be different is the addition of several more program 
  83. features as well as improved data features.
  84. To use the install system, place the distribution diskette in either 
  85. drive A or drive B and then type        A:install
  86.  
  87. You can also use the install program, provided on the 
  88. distribution diskette, to install the new version of BillTime.
  89.  
  90.  
  91.              RUNNING BILLTIME FOR THE FIRST TIME
  92. When BillTime is run for the first time it will create a working 
  93. database in the C:\BILLTIME directory. The database consists 
  94. of empty data files and their indexes. BillTime will display a 
  95. message asking you to confirm the creation of this database. 
  96. Type the letter `Y' (at the end of this document is a specific list 
  97. of all the files created by BillTime).
  98. After the empty database is  created, the following MAIN 
  99. MENU will appear:
  100.  
  101. ProVersion --- BillTime Time Track System --- ProVersion
  102.        ** MAIN MENU - MAKE CHOICE OR PRESS ESC **            
  103.         1) CREATE A WORK SLIP             
  104.         2) SEARCH FOR SLIPS               
  105.         3) USER LIST                        
  106.         4) CLIENT LIST                       
  107.         5) ACTIVITY LIST                      
  108.         6) PROJECT LIST                      
  109.         7) REPORTS                            
  110.         8) CHANGE DATA AREA                   
  111.         9) MAINTENANCE UTILITIES               
  112.         V) VERSION HISTORY                      
  113.         P) REGISTRATION AND ORDER FORM
  114.         M) MAKE A COPY FOR A FRIEND            
  115.         T) TRANSACTIONS AND INVOICES      
  116.         Q) QUIT                                   
  117.         Data Directory: C:\BILLTIME\        
  118.   Version 3.12  06/25/94  Copyright 1993, 94 Steve Saroff   
  119. (SSaroff@aol.com)
  120.  
  121. Work slips are where you will enter what work you have done 
  122. and all the information about the work. None of the information 
  123. is mandatory, however for you to get practical use from 
  124. BillTime you should enter as much information as possible.
  125. When entering information on slips, the User, Client, Activity 
  126. and Project data fields are cross checked against look-up lists. 
  127. Look-up tables will automatically be displayed when ever an 
  128. entry is made which is not found in the existing lists, and, if the 
  129. entry should be on the list, it can be added.
  130. Here is what a slip entry screen looks like:
  131.  F10=Save Changes       Esc=Exit with OUT save   F5=Mark as 
  132. Completed
  133.  F9=Add/Edit Notes                        F1=Look-up Tables 
  134.     >> TIME RECORD SLIP <<
  135.   Slip Num:  00000001                                                    
  136.   User:                                                              
  137.   Client:                                                              
  138.   Activity:                                                              
  139.   Date:                                                              
  140.   Time Spent:     0.00                                                     
  141.   Start Time:  14:41     Stop Time:   :     Completed:                     
  142.   Project:                                                              
  143.  
  144.   Charge at:  C Client's charge rate      Hourly rate:    0.00            
  145.   charge For this Work:                    
  146. F9=View/Edit Notes   
  147.                                                                  
  148. Here is what should be entered in the appropriate fields:
  149. User: name, or code, of the person doing the work.
  150. Client: name, or code, for who the work was done.
  151. Activity: name, or code, for what was done.
  152. Time spent: hours and decimal of time done for this slip.
  153. Start time: time work was begun
  154. Stop time: time work was done
  155. Completed: a date and time field of when slip was closed 
  156. (completed) used for creating invoices. Can be filled in 
  157. manually or by pressing F5.
  158. Project: the project which this slip should be included with.
  159. Charge at: Hourly charges can be set for the user, client or
  160. activity. The slip can also be billed at a flat rate or not at all.
  161. Hourly rate: a dollar per hour rate can be entered in instead of
  162. using the set rate for the client, user, or activity.
  163. FreeForm notes: can be added/edited by pressing the F9 key. 
  164. There is no limit to the length of the notes that can be added to a slip, 
  165. and any information entered in the notes can be searched and located.
  166. The time spent on a slip can be entered as an hour number, or 
  167. you can just enter the start time or the stop time of the work. In 
  168. the DEFAULT CONFIGURATION section of the program you may chose to have 
  169. the start time, or the end time automatically entered on the slip (using 
  170. your system's clock), or you may chose to not have anything automatically 
  171. entered. Each work slip can be assigned to a PROJECT. Projects are convenient 
  172. ways to keep track of time spent which may involve work with a variety of 
  173. clients.Once again, it is not necessary to enter any information on a 
  174. slip. There are two ways to create new work slips. The first is to 
  175. chose the very first menu selection, CREATE A WORK SLIP, 
  176. which will create a new slip, with the next sequential slip 
  177. number automatically assigned. Or, from the SEARCH FOR 
  178. SLIPS lists, you can create a new slip by pressing the F2 key.
  179.  
  180. How to locate a work slip:
  181. The second Main Menu choice is SEARCH FOR A SLIP. You 
  182. will be able to search for slips in the following four ways:
  183. ****      WORK SLIP SEARCH      **** 
  184. 1) LIST OF ALL WORK SLIPS BY SLIP NUMBER 
  185. 2) LIST OF ALL WORK SLIPS BY CLIENT      
  186. 3) LIST OF ALL WORK SLIPS BY USER
  187. 4) LIST OF ALL WORK SLIPS BY PROJECT     
  188. 5) BY SLIP COMPLETION DATE
  189. 6) FUZZY TEXT SEARCH OF ALL SLIPS        
  190. 7) RETURN TO MAIN MENU                   
  191.  
  192. 1) Chronologically by slip number. A list of all slips will be shown and 
  193. by entering in the slip number (or an approximation) you can locate slips.
  194. 2) Alphabetically by CLIENT. A list will show all slips sorted by clients, 
  195. and you can locate slips by typing a client Code/Name (or an approximation).
  196. 3)  Alphabetically by USER. A list will show all slips sorted by USER, and 
  197. you can locate slips by typing a user Code/Name (or an approximation).
  198. 4) Alphabetically by PROJECT. A list will show all slips sorted by projects, 
  199. and you can locate slips by typing a client Code/Name (or an approximation).
  200. 5) By slip completion date, with UN completed slips at top of list.
  201. 6) By fuzzy logic, which is really neat. You can enter ANY text and the 
  202. entire slip database will be search quickly (even text in the free-form 
  203. text notes), and a list of all direct text matches will be displayed.
  204.  
  205. Once a slip is located, by pressing the enter key the entire slip 
  206. will be displayed. You can edit any part of the slip except the 
  207. parts that are automatically filled in (the sequential slip number, 
  208. and the totals for project information).
  209. Slips can also be deleted, one-at-a-time from the lists by 
  210. pressing the F3 key. Slips can also be mass-deleted, many-at-a-
  211. time, from the PURGE utility, discussed bellow.
  212.  
  213.                 Lists
  214. All the lists in the slip database are dynamically updated while 
  215. entering information from the mail slip entry screen. However, 
  216. the lists can also be edited and added to from Main Menu 
  217. selections. There are lists for the following:
  218.     USERS  You can add any user who will you need to track time 
  219. for, and their hourly rate. There is no limit to the number of 
  220. users (just as there is no limit to any part of the BillTime 
  221. system), and each user can have a different default hourly 
  222. billing rate. This makes it possible to create entries with 
  223. different billing rates for the same person.
  224.    CLIENTS You enter client information in this list, and you can 
  225. add a different hourly charge for each client if you want. For 
  226. example, in my copy of BillTime (which I use for all my billing 
  227. for my business), I have several non profit clients whom I 
  228. charge less then the rest of my clients.
  229.    ACTIVITIES  You enter activities here, such as 
  230. PROGRAMMING, PHONE CALLS, MEETINGS, DIGGING 
  231. DITCHES, PREPARING BRIEFS, COURT TIME, TAKING 
  232. PHOTOS, etc. Each activity can have a set hourly billing rate. 
  233. For example, I charge one rate for Windows programming, 
  234. another for DOS programming, and another for Unix 
  235. programming. I even have rates for time I spend on the phone, 
  236. and for lunch meetings. This gives my clients a very nice picture 
  237. of what I do for them and why the totals on my bills are what 
  238. they are (If I have spent the last 100 hours doing kernel level 
  239. Unix programming it will be more expensive then if I had been 
  240. having a lot of lunch meetings and phone conversations). I also 
  241. use this field to enter direct expenses (which I charge back to 
  242. my clients at flat rates), such as PHOTOCOPIES, OFFICE 
  243. SUPPLIES, FAX CHARGES, GASOLINE, etc. 
  244.   PROJECTS  Projects are nice things to keep information on. 
  245. Any work slip can be assigned to any project, thus making it 
  246. possible for several people to work for several different clients 
  247. but all for the same project. You can enter estimated start and 
  248. stop dates, estimated completion times, as well as actual start 
  249. and completion dates and times. This information can be looked 
  250. up easily, and is also automatically displayed on the work slips. 
  251. (The full benefit of the project information is had when using 
  252. the Billing system, which is part of the Pro version, which you 
  253. can have for the registration fee of $19.00).
  254.  
  255.  
  256.                            REPORTS
  257. The main menu choice REPORTS is where you go to create 
  258. summary information about all, or some, of the work slips in the 
  259. slips database. Reports can be printed, displayed, sent to a file, 
  260. or written as SDF ASC files. Reports show summary 
  261. information (and detailed for the Pro version) between any two 
  262. dates, and for a variety of conditions and sort options. For 
  263. example,you can use this system to create summary reports for 
  264. any client showing the total number of hours worked between 
  265. any two dates.  Reports can (optionally) show sub-totals for 
  266. either or both of the sort methods of the report.
  267.  
  268.                       CHANGING DATA AREAS
  269. The main menu choice CHANGE DATA AREA lets you 
  270. completely change the working directory for BillTime. You can 
  271. have any number of completely separated work areas. When 
  272. you change data areas, a completely new and empty database 
  273. will be created in the newly chosen directory. This makes it 
  274. possible for two separate business who are sharing the same 
  275. office and computer, or who are on the same network, to keep 
  276. their information separate from each other. 
  277.  
  278. If you have several data areas, and want BillTime to 
  279. automatically start in an area other than C:\BILLTIME, you can 
  280. create a configuration file which contains the name of the new, 
  281. default data area. To do this you must create an ASC file called   
  282. BILLTIME.CFG   which has the following line in it:
  283. mDatapath=C:\xxxxx    where the xxxx's are the name of the 
  284. other data area. For example, if you have a data area called  
  285. C:\BIGPLANS    you would create a file called 
  286. BILLTIME.CFG and put the following line in it:
  287. mDatapath=C:\BIGPLANS          [the case doesn't matter] The 
  288. billtime.cfg file must be in your working directory; ie, wherever 
  289. it is you type `BILLTIME' from. This makes it possible to put 
  290. the billtime.exe file in a search path area (such as C:\dos) and 
  291. have your data areas in places besides c:\billtime.
  292. However, don't go creating new databases recklessly, as they will
  293. confuse you and take up disk space. Most businesses have been able to
  294. operate just fine_with several employees, many clients and
  295. activities and projects_from the single, default data area of C:\billtime.
  296.  
  297.                           MAINTENANCE UTILITIES
  298. The MAINTENANCE UTILITIES consist of the following menu choices:
  299.  
  300.     DOWNLOAD DATA  -- which is the same as going to reports 
  301. and choosing to output the report in SDF format.
  302.     REBUILD ALL INDEXES   -- if, and whenever things do not 
  303. seem to be working correctly, chose this menu option. All 
  304. database systems are subject to data index corruption from disk 
  305. problems, power interrupts, and, mostly, program bugs which 
  306. can leave indexes out of order.  Rebuilding indexes is a way to  fix problems.
  307.      EDIT DEFAULT CONFIGURATION  -- you can enter default 
  308. values for user, activity, client and project here, so if you find 
  309. yourself typing too much of the same exact thing over and over, 
  310. please set the default values to who you are. You can also have 
  311. the program automatically enter the stop time instead of the start 
  312. time (or you can turn the automatic fill in features off), set the 
  313. pkzip flag to Y (for using pkzip to create backup files when 
  314. indexes are rebuilt), and if you do not have a tractor-feed printer 
  315. you can set a flag which will then have the program pause for 
  316. you when it prints reports.
  317.     PURGE SLIPS  -- be careful purging slips. When you purge 
  318. slips they are gone forever. You purge by entering a 
  319. combination of data ranges, users, clients, activities and 
  320. projects. The more you enter, the more restrictive the purge is. 
  321. For example, if you just enter the user JOE, then all slips for 
  322. JOE will be gone. But, if you enter JOE and a date range, then 
  323. only slips in that date range will be gone, and if you further 
  324. restrict the purge criteria by entering an activity such as 
  325. GOOFING OFF, then only JOE's slips, for GOOFING OFF in 
  326. the entered date range will be purged.(The exception to this is a safety 
  327. feature: If you leave everything blank, then the purge will NOT be done.)
  328. MARK ALL SLIPS AS COMPLETED_You can mark all 
  329. slips, or just slips for a single client, as completed. You can set 
  330. a date range of what slips you want to mark as completed. Slips 
  331. that have already been completed will not be changed. When 
  332. invoices are generated you can select to only include slips that 
  333. have been marked as completed.  Slips can be individually 
  334. marked as completed from the main slip entry/edit screen. This 
  335. utility is a way to mark an entire range at once.
  336.     SET NEXT INVOICE NUMBER TO HIGHER NUMBER  -- 
  337. You can set what the next invoice number BillTime will use, as 
  338. long as it is GREATER than any previous number. (Be 
  339. CAREFUL!  You can NOT set the number to a smaller number). 
  340.  
  341.     
  342.                     TRANSACTIONS AND INVOICES  
  343. ****      TRANSACTIONS AND INVOICES      **** 
  344. 1) ENTER A MONEY TRANSACTION           
  345. 2) GENERATE INVOICES               
  346. 3) ENTER/EDIT BILLING CO'S INFORMATION FOR INVOICE PRINTING   
  347. 4) RE-PRINT AND INVOICE                      
  348. 5) CLIENT TRANSACTION AND INVOICE REPORT     
  349. 5) RETURN TO MAIN MENU                  
  350.  
  351.                         INVOICES
  352. BillTime contains a complete invoice and transaction system.  
  353. To use the invoice system, you must first enter in some 
  354. information for your business or company. You do this from the 
  355. 3rd menu option in the invoice and transaction main menu. You 
  356. must chose a company code, for example, my business' 
  357. company code is "SAROFF DESIGN". You must also enter a 
  358. company description. For example, my business description is 
  359. "Saroff Design, Software".  This information is only used for 
  360. printing invoices. You should also enter your address 
  361. information. There are other information fields which you can 
  362. enter, and which if entered will appear on all the printed 
  363. invoices. These fields are TERMS_which will appear after the 
  364. summary of current and past charges. For example, for my 
  365. company in the terms field I have entered: "TERMS: net due in 
  366. 30 days." for the second TERMS field, I have entered: "    %12 
  367. on all charges over 30 days." The two HEADER fields, if 
  368. information is entered, will be printed after the client's billing 
  369. address is printed, and the two TRAILER fields will be printed 
  370. after all other information is printed. For example, I have the 
  371. following in the first header fields: "Details follow summary", 
  372. and nothing in the second header field. In the TRAILER field I 
  373. have entered "Thank you for your business."
  374.  
  375. NOTE:  If you create a plain ASC text file in your default 
  376. BillTime directory  (C:\billtime) and call it     
  377. SPECIAL.TXT  it will be included on ALL of your invoices 
  378. AFTER the Terms area (immediately before the summary 
  379. listings of the invoice).  This  text file can be any length, up 
  380. to about 10,000 characters long, but must be plain ASC text.  
  381. special.txt can contain detailed information or special notes 
  382. that can not easily be fit into the terms, headers, or trailers 
  383. fields. 
  384.  
  385. Here is an example (short) invoice:
  386. *******************************************************
  387. ***************
  388. **********   INVOICE    For PATS ENGINEERING  
  389. Printed:10/03/93  Page: 1
  390. ------------------------------------------------------------------------------
  391. Saroff Design, Software       
  392. Steve Saroff                                          
  393. 1901 Missoula Ave.                                    
  394. Missoula, MT, 59802     
  395.       
  396. Pats Engineering           
  397. Attention: Joe Schmoe                                            
  398. 1234 This street                                      
  399. Your City, MT, 54321     
  400. (406) 123-1234      
  401.  
  402.  
  403. (details follow summary)                              
  404. Invoice Number: 0000004043              Invoice Date: 10/03/93
  405. This invoice is for work done from 10/03/93 15:15  Through 
  406. 10/03/93  23:14
  407.           The current due amount is:     $100.00
  408.            The total amount now due is:     $100.00
  409.  
  410. Your last invoice was invoice number: 0000002345  dated: 
  411. 09/03/93
  412. Your last payment was received on 10/02/93
  413. That payment amount was $3,000.00, credited to invoice 
  414. number 0000002345
  415. TERMS: net due in 30 days                             
  416. %12 on all unpaid charges over 30 days.        
  417.  
  418. Notes:
  419. This is where the file 'special.txt' will be printed on all invoices'
  420.  
  421.  
  422. This invoice has 1  current work Slips
  423. Work Slip#  Date    Hrs           Activity              Project           
  424. Done By       Charge
  425. -----------------------------------------------------------------
  426. 00000049  10/03/93   1.00 PROGRAMMING C     
  427. TRANSITION    SAROFF         $100.00
  428. =============================================
  429. Total Slips:     1    Total Hours:      1.00   Work Charge:    
  430. $100.00
  431. **********  Detailed Work Slip Information  *********
  432. Work Slip #: 00000049 10/03/93  Hours:  1.00 
  433. PROGRAMMING   Charge:   $100.00
  434. From 22:00  To  23:00
  435. Billed at rate of     $40.00  per hour  Project: TRANSITION 
  436.  Adding trigger based e-mail capability to the sendEM module. 
  437. Now system will    automatically send e-mail to network's cc 
  438. mail system whenever a program or a  system error is detected. 
  439. Linked with Borland's C++ system, and fully tested   the 
  440. Windows interface. System is now complete.                                 
  441. ------------------------------------------------------------------------------
  442. End of invoice                                        
  443. Thank you for your business                           
  444. *****************************************************************
  445.  
  446.  
  447. As a bonus, the registered copy of BillTime can send invoices 
  448. to a file, as well as to the printer. Unregistered copies of 
  449. BillTime will only print.  To generate invoices, chose the generate invoice 
  450. menu choice from the transaction and invoice main menu. The screen which 
  451. appears has detailed information on how to start the generation 
  452. process. Invoices can be generated at any time and for all or just 
  453. one client(s). All un-invoiced work slips will be included in the 
  454. invoice, up to the current date and time, or up to an arbitrary 
  455. date and time which you can enter. You can include only slips that have 
  456. charges on them. You can also include only slips that have a completion 
  457. date. Unregistered copies of BillTime, after there are 250 work slips in
  458. the slips database, will print a message on the invoices. 
  459.  
  460. You should generate TEST invoices by pressing the F5 key.  Do this 
  461. BEFORE generating the real invoices.Test invoices can be used to see if 
  462. all of the amounts and times on the slips are correct.  Test invoices 
  463. should NOT be sent to clients, since information on the test invoices 
  464. is not stored.
  465.  
  466.                         TRANSACTIONS
  467. When you receive payments for your invoices, you need to 
  468. enter the money amounts in the transactions section of the 
  469. program. The transaction menu choice will 1st prompt you for 
  470. the client's company code. If you are not sure of what it is, 
  471. press the F1 key for the full list. You will then see all the most 
  472. recent invoice and transaction records, and you will prompted to 
  473. enter the amount you are currently receiving. If you do not enter 
  474. transactions, your invoices will show past due amounts, thus it 
  475. is very, very important to enter each  received payment, and 
  476. make sure that the payments are entered for the correct client.
  477.  
  478.             CLIENT TRANSACTION AND INVOICE REPORT
  479. This report, from the transaction and invoice main menu, will 
  480. show for any entered client, all transaction amounts and dates, 
  481. as well as all invoice amounts and dates. This report can be sent 
  482. to the printer or to a file.
  483.  
  484.                       ORDERING INFORMATION
  485. If you like this program, and use it, I would like you to register 
  486. it.  The registration fee isn't much and you get a lot back for it. 
  487. There is a main menu choice called PRO FEATURES & REGISTRATION INFORMATION 
  488. which will print an order form for you. For registering your copy of this 
  489. program will receive the following bonus:     
  490. PRINTED USER MANUAL                                                
  491.     laser printed, detailed, easy to read.                          
  492. INVOICES CAN BE SENT TO FILES
  493. NETWORK LICENSE                                                    
  494.     allows unlimited use on networks.
  495. TECH NOTES                                                           
  496.    information on how to export/import dbf data to/from other programs.
  497. MOST RECENT VERSION                                                     
  498. TECH-SUPPORT VIA E-MAIL                                              
  499.    internet address used only for support of this program.    
  500. CUSTOM PROGRAMMING FROM SAROFF DESIGN
  501.    At our standard rate of $100/hour in 2 hour increments. e-mail us for details.
  502.        
  503. To register and receive these bonus features, send $39 (check or money order)
  504.         To: Steve Saroff 1901 Missoula Ave, Missoula MT 59802       
  505.                                           
  506.  
  507.  
  508.                      NETWORK INFORMATION
  509. BillTime is a true multi-user database system. It uses record 
  510. locking and allows for many people to be using it simultaneously. 
  511. If you use BillTime on a Novell network, make sure to flag the 
  512. BillTime.exe, billtime.ovl and all *.dbf, *.dbt and *.ntx files as Sharable.
  513.  
  514. List of files created and maintained by Billtime:
  515. Directory of C:\BILLTIME 
  516. BILLTIME.EXE  == the executable file
  517. BILLTIME.OVL  == overlay for the executable
  518.  
  519. All the DBF and DBT files are the data files (in dBase III  format)
  520. ACTILIST.DBF 
  521. DBF_DIC.DBF 
  522. CLIELIST.DBF 
  523. CONFIGURE.DBF
  524. NTX_DIC.DBF
  525. ERRORLST.DBF
  526. ERRORLST.DBT
  527. FIELDCON.DBF 
  528. LASTNUM.DBF 
  529. PASSWORD.DBF
  530. PROJECT.DBF
  531. SLIP.DBF
  532. SLIP.DBT
  533. USAGE.DBF 
  534. USER.DBF
  535. USERLIST.DBF
  536.  
  537. All the NTX and IA files are index files in Clipper Summer'87 format
  538. DBF_DIC.NTX
  539. NTX_DIC.NTX
  540. SLIPCLIE.NTX
  541. SLIPPROJ.NTX
  542. SLIPSYS.NTX 
  543. USERLIST.NTX
  544. CLIELIST.NTX
  545. ACTILIST.NTX
  546. PROJECT.NTX
  547. SLIP.IA 
  548. TIME.LST      === a marker file used to record the current time
  549. BILLTIME.MAN  === this document
  550. BILLTIME.ZIP  === the distribution zip file
  551.  
  552.                Tech Notes on Data File structures.
  553. To import and export to and from other files, use the following 
  554. information. All data files are dBaseIII compatable. Indexes are 
  555. created in Clipper (.NTX) files, as well as with a Text Search 
  556. algorithim (.IA) files. Files are opened in shared mode (set 
  557. exclusive OFF) and thus can be read over a network with ohter 
  558. xBase system. If you import (add) data to any of the dbf files, 
  559. you MUST rebuild all the indexes (from the maintenance 
  560. utilities). The following is a complete list of all the data files. 
  561. After each data file name, the file's structure is shown with the 
  562. following conventions:   FIELD_NAME  FIELD_TYPE  FIELD_SIZE
  563. where the field type is one of the following:
  564. C  for character
  565. D for date
  566. N for numeric
  567. M for memo
  568.  
  569. ACTILIST.DBF  Activity List 
  570. used for billable activities
  571. CODE C 20          ---- activity
  572. DESC C 20          ---- description
  573. RATE N 5,2         ---- rate per hour for charges
  574.  
  575. BILLINGC.DBF   Billing Company Information
  576. Has information for creating invoices with different looks to 
  577. them
  578. CODE C 20                       ---- Billing Company Code
  579. DESC C 30                       ---- description
  580. ---- the following fields will only be displayed if they are present  --
  581. CONTROLER C 54     
  582. ADD1  C  54
  583. ADD2  C  54
  584. CITY  C  54
  585. STATE  C  2
  586. ZIP  C  10
  587. PHONE1  C  20
  588. PHONE2  C 20
  589. TERMS  C  54
  590. TERMS2  C  54 
  591. HEADER  C  54      --- shown at the start of the invoice
  592. HEADER2  C  54 
  593. TRAILER  C  54     --- shown at end of invoice
  594. TRAILER2  C  54 
  595.  
  596. CLIELIST.DBF   Client List
  597. Has client address and default billing rate
  598. CODE    C  20
  599. DESC    C  30
  600. RATE    N  5
  601. CONTACT C  54
  602. ADD1    C  54
  603. ADD2    C  54
  604. CITY    C  54
  605. STATE   C  2
  606. ZIP     C  10
  607. PHONE1  C  20
  608. PHONE2  C  20
  609. MORE1   C  54   -- descriptive use only
  610. MORE2   C  54   -- descriptive use only
  611.  
  612.  
  613.  
  614. CLIENTIN.DBF    Client Invoice Records
  615. Has single record for each invoiced client and the current invoice status
  616. LASTINV C  10     -- invoice number
  617. CLIENT  C  20
  618. CURRENT N  8,2    -- current due for invoice period
  619. PAST    N  9,2    -- past due from all previous invoices
  620. LASTINVDAT      D  8  -- date of invoice
  621. LASTINVTIM      C  8  -- time
  622. LASTINVSLI      C  8  -- greates slip number
  623. TOTALDUE        N  10,2  -- current +  past
  624. LASTRECEIV      N  8,2
  625. LASTRECDAT      D  8
  626. LASTRECTIM      C  8
  627. LASTCREDIN      C  10
  628. TOTALRECEI      N  10,2   -- total amount from all transactions recieved
  629. OVERPAID        N  10,2   -- over paid amount
  630.  
  631. CONFIGUR.DBF  Configuration file. 
  632. Has user definable fields
  633.     DATAPATH        C  30
  634.     DRIVE   C  1 
  635.     DEFUSER C  10
  636.     DEFCLIE C  20
  637.     DEFACTI C  20
  638.     FILLDATE        C  1
  639.     FILLTIME        C  1
  640.     TIMEDEF C  1
  641.     DEFCHARGE       C  1
  642.     DEFRATE N  6
  643.     USEZIP  C  1        
  644.     USESUPERS       C  1
  645.     TRACTOR C  1        -- tractor feed or single page
  646.     DEFPROJN        C  20   -- default project
  647.     BILLINGCO       C  20   -- default billing Company 
  648.     LINESPER        N  3    -- printed lines per page
  649.  
  650. ERRORLST.DBF   Error List file
  651. Store any traped error messages
  652. DATE    D  8
  653. TIME    C  8
  654. PROC_NAME       C  19
  655. PROC_LINE       N  4
  656. DESCRIPTN       C  50
  657. COMMENTS        M  10
  658. LOGIN   C  10
  659.  
  660. FIELDCON.DBF      ---- not presently used
  661.  
  662. INVOICE.DBF    Invoice file
  663. A record is created for each generated invoice for each client. 
  664. Records are never deleted.
  665.     INVNUM  C  10     -- all invoice numbers are left 
  666. padded with zeros
  667.     CLIENT  C  20
  668.     INVDATE D  8
  669.     INVTIME C  8
  670.     FROMDATE        D  8
  671.     FROMTIME        C  8
  672.     FROMSLIP        C  8
  673.     TOSLIP  C  8
  674.     SLIPCOUNT       N  5
  675.     CURRENTDUE      N  8,2
  676.     PASTDUE N  8,2
  677.     TOTALDUE        N  8,2
  678.     PRINTED L  1
  679.     LASTINVNUM      C  10
  680.     LASTINVDAT      D  8
  681.     LASTINVTIM      C  8
  682.     LASTINVCUR      N  8,2
  683.     LASTINVPAS      N  8,2
  684.  
  685. LASTNUM.DBF  last Number file.
  686. Contains the next slip, invoice and transaction numbers in triplicate for crc.
  687. Warning: do not modify this file without changing values in ALL the records.
  688.     SLIPNO    C  8    -- all work slips are left padded with zeros
  689.     INVNUM    C  10   -- all invoice numbers are left padded with zeros
  690.     TRANSNUM  C  10   -- all transaction numbers are left padded with zeros
  691.  
  692. PASSWORD.DBF    not currently used
  693.  
  694. PROJECT.DBF   Project file
  695. Contains a list of all current projects
  696.     CODE    C  20
  697.     DESC    C  40
  698.     ESTSTARTD       D  8
  699.     ESTSTARTT       C  8
  700.     ESTENDDATE      D  8
  701.     ESTENDTIME      C  8
  702.     ESTHOURS        N  9,2
  703.     STARTDATE       D  8
  704.     STARTTIME       C  8
  705.     COMPDATE        D  8
  706.     COMPTIME        C  8
  707.     HOURSTODAT      N  9,2
  708.     CHARGTODAT      N  11,2
  709.     COMPLETED       L  1
  710.     SLIPCOUNT       N  5
  711.  
  712. SLIP.DBF   Slip file
  713. The master Work Slip File.
  714. SLIPNO  C  8      -- slip numbers are left padded with zeros
  715. USER    C  10
  716. CLIENT  C  20
  717. ACTIVITY        C  20
  718. STARTDATE       D  8
  719. STARTTIME       C  8
  720. STOPTIME        C  8
  721. BILLBY  C  1     -- N=no charge, F=Flat Rate, U=user, A=activity C=client
  722. BILLRATE        N  6,2  -- dollars per hour
  723. TIMESPENT       N  8,2
  724. CHARGE          N  9,2
  725. PROJNAME        C  20
  726. ONINVNUM        C  10   -- when ivoiced, this has the invoice number
  727. INVDATE D  8        -- invoice date
  728. NOTE    M  10       -- memo field. Indexed with Fuzzly logic.
  729. SCOMPDATE D  8   -- Date slip was marked as completed. User can modify or erase
  730. SCOMPTIME C  8   -- time slip was marked as completed.
  731. INVOICED  L  1   -- True if invoiced
  732. COMPLETED L  1   -- True if completed date if filled in or slip was invoiced
  733.  
  734. TRANSACT.DBF   Transaction file.
  735. Has a record for each money transaction entered. 
  736. TRANSNUM        C  10
  737. TRANSDATE       D  8
  738. TRANSTIME       C  8
  739. CLIENT  C  20
  740. AMTREC  N  8,2    -- dollar amount entered.
  741. RECFORM C  20     -- what form the payment is in, check or cash, etc.
  742. CHECKNUM        C  10  -- check number
  743. INVNUMCRED      C  10   -- credited to this invoice number
  744. NOTES   C  70     -- not a memo field. just chars.
  745.  
  746. USAGE.DBF   Usage file.
  747. Keeps record of when the program was used. Only keeps 50 most recent records.
  748.     LOGIN   C  20   -- if on a network, the users name
  749.     INUSE   L  1
  750.     USEDATE D  8
  751.     USETIME C  8
  752.     QUITDATE        D  8
  753.     QUITTIME        C  8
  754.     USECOUNT        N  5   -- what usage time this is
  755.  
  756. USER.DBF   not used.
  757. USERLIST.DBF   User List file.
  758. Has a record for each user and thier billing rate.
  759.     CODE    C  10
  760.     DESC    C  20
  761.     RATE    N  5    -- hourly bill rate
  762.  
  763.  
  764. ================================= end of 
  765. billtime.man
  766.