home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / asa_v12.zip / ASA.DOC next >
Text File  |  1993-05-31  |  13KB  |  316 lines

  1.  
  2.  
  3.  
  4.  
  5.     
  6.     
  7.                     THE ANSWERING SERVICE ASSISTANT!
  8.     
  9.                                Version 1.0
  10.     
  11.                      Written by Charles H. Crawford.
  12.     
  13.     Documentation:
  14.     
  15.          The "Answering Service Assistant" (ASA) was created in
  16.     response to a request of the operators of an answering service
  17.     who require a speech friendly program to assist in the business
  18.     operations.  While I had already written a message taking
  19.     program, it was old and could have stood some improvement and I
  20.     needed a worthwhile project to test the latest version of Clipper
  21.     and it's speech capacity using routines written by Jamal Mazrui. 
  22.     I sincerely hope this software will evolve into something really
  23.     useful for folks who need speech output to take on the challenge
  24.     of operating their own business and making millions!
  25.     
  26.          Of course, neither I nor anyone else in the known Universe
  27.     can take any responsibility for what happens when folks use the
  28.     software, but I've tested it and it seems to operate fine.  The
  29.     best thing is that it is free!
  30.     
  31.          To run the program, 1) simply unzip it into a subdirectory
  32.     of your naming and go there, and 2) type "asa" and press enter. 
  33.     Can't get much simpler than that, huh!
  34.     
  35.          The ASA operations are fairly simple since they really only
  36.     allow you to encode customer information, take messages for them,
  37.     edit the messages if needed, and produce text file reports
  38.     between selected dates with the prices calculated.  Now here's
  39.     how to do it.
  40.     
  41.          The first thing is to bring up the program.  Typing (without
  42.     the quotes) "ASA" when in the subdirectory you have created will
  43.     bring up the program.
  44.     
  45.          The first thing the program does is to take a look at your
  46.     video card and if it detects color, then it will output bright
  47.     green text on a black background.  You can change the color
  48.     settings later if you like.  also folks who don't need speech can
  49.     pass a parameter to the program when first bringing it up to skip
  50.     the speech operations and simply display to screen.  That would
  51.     be done by typing "ASA quiet" at the DOS command line when
  52.     starting up the program.
  53.     
  54.          The next thing the program does is to check the files in the
  55.     subdirectory.  It looks to see if there are existing databases
  56.     from previous versions of the program to make sure that it does
  57.     not destroy information you may already have.  If it finds
  58.     existing active databases, then it will simply move on to the
  59.     main menu.  If it does not find existing active databases, then
  60.     it copies the failsafe databases that come in the zip file to
  61.     active ones.  Say, I bet that makes a bunch of people sleep
  62.     better.  WARNING!  Only in version 1.0 will folks who have used
  63.  
  64.                                      Page 1
  65.  
  66.  
  67.  
  68.     the beta (test) versions have to erase their "CC.dbf" database
  69.     before running ASA. This is because I have added a new rate field
  70.     to cover per call costs.  Failure to erase "CC.dbf" before
  71.     beginning with Version 1.0 will probably crash the program.
  72.     
  73.          Once we get past all that setup stuff, the program presents
  74.     you with a list of choices.  You can; 1) add a message to the
  75.     database as if you were getting one from the phone, 2) browse,
  76.     edit or delete existing messages, 3) add new customers to your
  77.     customer database, 4) use a different screen color configuration,
  78.     5) generate a text file report or invoice for a customer, or 6)
  79.     get our of the program.
  80.     
  81.          1. Adding a message to the message database is pretty
  82.     simple.  The main menu option is pressing he letter "A" and it
  83.     will immediately execute the command since all single letter
  84.     entries in the program are what are called "hot keys".  If you
  85.     press a key that does not correspond to the menu options, the
  86.     program will beep and let you know the valid choices.
  87.     
  88.          Once having entered the option to add a message, the program
  89.     automatically records the date and time of the entry and then
  90.     begins a series of questions you must answer.  These are like the
  91.     customer code which must match a customer record in the customer
  92.     database for the program to move forward.  If you select to add a
  93.     message when you first run the program, then you will not get any
  94.     further and will be told to use menu option "C" to get a customer
  95.     record first.  This is necessary since the program must relate
  96.     the message to be taken to a customer.
  97.     
  98.          You will get to a point in the message adding module where
  99.     the speech seems to disappear!  This in the actual long message
  100.     area where the Clipper full screen editor is used to get the
  101.     information.  It works pretty much like any word processor where
  102.     the arrow keys move the cursor and you simply type in the message
  103.     and it will later do the word wrap to keep the text properly
  104.     formatted for a DOS IBM screen.  Here it is important to say that
  105.     the combined control and "W" keys are used to exit the editor and
  106.     save the information you put in.  It is easy to forget how to get
  107.     out of the editor and so remember to keep the Ctrl-W key
  108.     combination in mind.
  109.     
  110.          Once you have entered the message, the program looks to the
  111.     customer database and get any Per call, per day and per minute
  112.     rates for that customer.  It then automatically records the time
  113.     you ended the message and calculates the minutes times the rate,
  114.     then adds the daily and per call rates and places the cost to the
  115.     customer in a cost field in the database.  You are shown the
  116.     information and then sent back to the main menu.  This allows you
  117.     to set up varying rates for varying customers.  You may decide to
  118.     have a service that only has a daily rate or a per minute rate or
  119.     a per call rate; or you may decide to have a combination of all
  120.     of them.  In any event, you can set the rates for your customers
  121.     based upon whatever plan they may have selected and ASA will
  122.     calculate each call based upon their individual plan and produce
  123.     invoices (reports) within their rate structiure.  Not bad huh!
  124.     
  125.          2. Browse/edit/delete.
  126.  
  127.                                      Page 2
  128.  
  129.  
  130.  
  131.     
  132.          The second menu option allows you to browse through your
  133.     records of messages and just read them, edit them as you go
  134.     along, or delete messages you don't want to save.  Pretty simple,
  135.     but again remember that when in the full screen editor, you will
  136.     need to use the combined control and "W" keys to get out.
  137.     
  138.          One nice thing you will notice when doing the browse, is
  139.     that the messages from the screen editor will be quite easy to
  140.     understand with speech.  this is because the program displays the
  141.     message with some filters to make sure that it all fits nicely on
  142.     the 80 column display used by the IBM stand screens.
  143.     
  144.          3. The Customer database.
  145.     
  146.          The third main menu option is the customer database which
  147.     really should be the first option you choose.  This one asks you
  148.     for a customer code and then brings up a screen of information
  149.     you need to fill in.  The screen is silent until you move the
  150.     arrow keys to go to another field or edit existing text in fields
  151.     you have already worked on and want to change.  You will need to
  152.     press the enter key to confirm your input into these fields in
  153.     order to make sure that all the information is gotten.
  154.     
  155.          Be sure to fill out the entire screen since the information
  156.     you put in goes into the text files that come up in the invoice
  157.     or report generation to be discussed later.  also be sure that
  158.     you enter the proper rates for the customer in the three rate
  159.     fields of per minute, per day, and per call.  These rates will be
  160.     read by the program when you take a message for the customer who
  161.     matches the customer code and the calls will be charged using
  162.     these rates.  Enter 0 if you don't want to charge that particular
  163.     customer a particular rate or rates.  For example, let's say you
  164.     like customer number 1 who is testing out the service and you
  165.     want to give them an introductory rate of just a per minute rate. 
  166.     Just answer 0 at the per call and baseline (daily) rates and that
  167.     customer will only be charged on the per minute rate you put in. 
  168.     Later, you can edit the record to increase the rate or add other
  169.     rates or whatever you choose.  The combined charges for all calls
  170.     make up your revenues.
  171.     
  172.          4. Using a different color combination.
  173.     
  174.          Some folks with low vision see different color combinations
  175.     better than others.  Hence, I have included the familiar color
  176.     selection program that I use in the Talking Checkbook and other
  177.     programs I have written.  Type "U" at the main menu to select a
  178.     different screen color combination.  future versions will have
  179.     the capacity to store your choice to a disk memory file and then
  180.     you will always get that color combination when you bring up the
  181.     program.
  182.     
  183.          5. The report generation module.
  184.     
  185.          The most important thing that the computer can do for your
  186.     business is to accurately compute the cost you charge to folks
  187.     for your service, documenting how it got to that figure, and
  188.     printing a list of the messages.
  189.  
  190.                                      Page 3
  191.  
  192.  
  193.  
  194.     
  195.          The "R" menu option immediately checks to see if you want a
  196.     text file generated that is more spacious with blank lines or
  197.     very tight with no blanks at all.  This is to allow you to
  198.     produce reports that will not take too much fax paper or to
  199.     produce reports that are more easy to read.
  200.     
  201.          Then the program asks you for the customer code and checks
  202.     the customer database to make sure that they are there.  This is
  203.     important because you want to produce a report for customers you
  204.     really have and need to get all their name and address info to
  205.     put into the report.
  206.     
  207.          If the program finds a customer match, then it moves along
  208.     to the next question of what dates you want to have reported on. 
  209.     If it does not find a customer, then it assumes you have not
  210.     entered that customer into the customer database and tells you
  211.     that it can't find a match.  Once you give the computer the
  212.     starting and ending dates of the messages you want the customer
  213.     to know about and pay for, then it goes off to do it's thing.
  214.     
  215.          The program will add in your name and address and all that
  216.     information you have placed in the "Owner" record of the customer
  217.     database.  It will also do all the necessary calculations and
  218.     summary info.
  219.     
  220.          The software asks you to give it a legitimate DOS file name
  221.     like "ASA.txt" or something you create with the normal DOS rules
  222.     and it generates a text file report.  This report (in addition to
  223.     your name&address info) contains:  1) the mane and address of the
  224.     customer being billed, 2) the summary information of the number
  225.     of calls/messages/minutes/rates between the dates in question
  226.     (including the dates you gave to start and end), 3) a listing of
  227.     all messages taken between the dates, and 4) select information
  228.     on the priority of the message.
  229.     
  230.          You can take the text file you create with the program and
  231.     put it into a word processor and make it prettier if you like. 
  232.     You might want to run it through one of those shareware format
  233.     programs if you like to get the margins better if they don't turn
  234.     you on.
  235.     
  236.          That's about all the program does right now, but future
  237.     versions will be written to incorporate suggestions of folks who
  238.     have done the wide area testing of it.  Call Charlie Crawford at
  239.     area (617)-727-5550 extension 4503 v(voice) from 9 to 5 Eastern
  240.     time to talk about the program or leave messages on the MCB BBS
  241.     (617)-451-5327 to the Sysop to help improve the program.  It's
  242.     all about helping folks who need speech output to get the
  243.     business moving and I hope you'll get in touch to let me know
  244.     what you need.
  245.     
  246.                                  Notes.
  247.     
  248.     
  249.          Some of the speech features work a bit slower with Clipper
  250.     version 5.2 since the work-arounds to get speech take a bit more
  251.     micro-processing time, but I think the speech works pretty well. 
  252.  
  253.                                      Page 4
  254.  
  255.  
  256.  
  257.     Give the program a bit of time to respond to keystrokes
  258.     especially in the editor and you'll be fine.
  259.     
  260.     -Charlie Crawford:  May 31, 1993.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                      Page 5