home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / progmisc / bldr10b.zip / BREPORT.DOC < prev    next >
Text File  |  1993-03-19  |  83KB  |  2,243 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                 Aeolus Software
  22.                             BREPORT REFERENCE GUIDE
  23.  
  24.                                    COPYRIGHT
  25.  
  26.  
  27.  
  28.                           (c) 1992 by Aeolus Software
  29.                               All rights reserved
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                TABLE OF CONTENTS
  66.  
  67.     Introduction................................................1
  68.     Main Menu...................................................2
  69.     File Menu...................................................4
  70.       Loading/Creating a Report (.RPT) File.....................5
  71.       Select Database(s)........................................12
  72.       Generate Source Code......................................14
  73.     Format Menu.................................................15
  74.       Subtotal Entry............................................16
  75.       Modify Page Layout........................................18
  76.     Change a Report Field.......................................21
  77.     Add a Field to the Report...................................24
  78.     Delete a Report Field.......................................29
  79.     Move a Report Field.........................................32
  80.     Report Column Maintenance...................................33
  81.     About the Source Code Created...............................35
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                           The Aeolus BREPORT User Manual
  120.  
  121.  
  122.  
  123.  
  124.     INTRODUCTION
  125.  
  126.     BREPORT.EXE the BUILDER Report Generator.
  127.  
  128.     The  Aeolus  Report  Generator  creates  report  source code for the Clipper
  129.     programmer to  complete.   This  is  similar  to  the  way  the  BUILDER.EXE
  130.     program  operates,  however,  the  BREPORT.EXE  program differs in that each
  131.     report generates  a  seperate  .PR1  (.PRG)  source  code  file.   The  BRE-
  132.     PORT.EXE  program,  like  BUILDER.EXE,  allows  the programmer to create the
  133.     basic report format easily, which the  programmer  can  then  finish.   This
  134.     makes  creating  reports  that  cannot  be  done in REPORT FORM programmable
  135.     quickly and easily.
  136.  
  137.     The source code created by  the  Aeolus  Report  Generator  is  designed  to
  138.     be  incorporated  into  a  large  PROCEDURE  file containing many or all the
  139.     reports for the system you are writing.   This  is  only  a  suggestion  and
  140.     the source code is quite flexible on this point.
  141.  
  142.     To  execute  the  Report  Generator  type  BREPORT,  making certain that the
  143.     BREPORT.EXE program is  in  the  default  directory  or  found  in  the  DOS
  144.     PATH.
  145.  
  146.     READ  THE  BOTTOM  LINE  OF  THE  SCREEN  TO  DETERMINE  WHAT KEYS TO PRESS.
  147.     ESC EXITS.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                       <1>
  178.                           The Aeolus BREPORT User Manual
  179.  
  180.  
  181.  
  182.  
  183.     MAIN MENU
  184.  
  185.     After executing the BREPORT program the following screen should appear.
  186.  
  187.  
  188. [BREPORT Main Menu]
  189. █File█ Format  Change  Add  Delete  Move  About
  190. ╔════════╦═════════════════════════════════════════════════════════════════════╗
  191. ║        ║                                                                     ║
  192. ║        ║                                                                     ║
  193. ║        ║                                                                     ║
  194. ║        ║                                                                     ║
  195. ║        ║                                                                     ║
  196. ║        ║                                                                     ║
  197. ║        ║                                                                     ║
  198. ║        ║                                                                     ║
  199. ║        ║                                                                     ║
  200. ║        ║                                                                     ║
  201. ║        ║                                                                     ║
  202. ║        ║                                                                     ║
  203. ║        ║                                                                     ║
  204. ║        ║                                                                     ║
  205. ║        ║                                                                     ║
  206. ║        ║                                                                     ║
  207. ║        ║                                                                     ║
  208. ║        ║                                                                     ║
  209. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  210. ║Scale1  ║         1         2         3         4         5         6         ║
  211. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  212. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  213. ▓ Right/Left-Move Pointer ▓ ENTER-Select ▓ ESC-Exit ▓
  214.  
  215.  
  216.     At this point no report is  loaded  and  the  report  view  area  is  empty.
  217.     You  must  load  a  database  or  report  at  this time, all other functions
  218.     are unavailable until a report is loaded or started.
  219.  
  220.     Understanding the screen:
  221.     The screen is divided  in  to  three  main  sections,  the  main  menu,  the
  222.     report layout view area, and the key assistance line.
  223.  
  224.     The  main  menu  occupies  the  topmost  line  of the screen and is used for
  225.     most user interaction.
  226.  
  227.     Screen sections:
  228.     The report  layout  view  area  comprises  all  the  boxed  in  screen  area
  229.     below  the  main  menu  and  contains  four  sections 1-the report line type
  230.     area in the upper left; 2-the  report  layout  display  area  in  the  upper
  231.     right;  3-the  scale  line  type  displayed  in  the  lower  left; 4-and the
  232.     scale itself displayed in the lower right.
  233.  
  234.     View area sections:
  235.  
  236.                                       <2>
  237.                           The Aeolus BREPORT User Manual
  238.  
  239.  
  240.  
  241.  
  242.     1.  The report line  type  area  displays  the  type  of  report  line  dis-
  243.     played  on  the  screen  line  to the right and can be 'PgHdr#', 'Body#', or
  244.     'Subttl#'. These are for  information  only  and  the  programs  deals  with
  245.     them automatically. There is no work to perform in this screen area.
  246.  
  247.     2.   The  report  layout  area,  the largest boxed area, displays the report
  248.     layout page header, body, and subtotal lines the report will contain.
  249.  
  250.     3.  The scale line type is always displays in the  lower  left  box  and  is
  251.     there only to note the scale to the right.
  252.  
  253.     4.   The  scale  will  automatically  scroll  right  or left with the report
  254.     layour and is a display only area to assist in report design.
  255.  
  256.     To load  a  report  move  the  highlight  bar  over  the  'File'  main  menu
  257.     option and press ENTER, this will present the File Submenu.
  258.  
  259.  
  260.  
  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.                                       <3>
  296.                           The Aeolus BREPORT User Manual
  297.  
  298.  
  299.  
  300.  
  301.     MAIN MENU FILE OPTION
  302.  
  303.  
  304. [BREPORT File Sub-Menu]
  305. █File█ Format  Change  Add  Delete  Move  About
  306. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  307. ║█Load Report█████║                                                            ║
  308. ║ Select Database ║                                                            ║
  309. ║ Generate Source ║                                                            ║
  310. ╚═════════════════╝                                                            ║
  311. ║        ║                                                                     ║
  312. ║        ║                                                                     ║
  313. ║        ║                                                                     ║
  314. ║        ║                                                                     ║
  315. ║        ║                                                                     ║
  316. ║        ║                                                                     ║
  317. ║        ║                                                                     ║
  318. ║        ║                                                                     ║
  319. ║        ║                                                                     ║
  320. ║        ║                                                                     ║
  321. ║        ║                                                                     ║
  322. ║        ║                                                                     ║
  323. ║        ║                                                                     ║
  324. ║        ║                                                                     ║
  325. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  326. ║Scale1  ║         1         2         3         4         5         6         ║
  327. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  328. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  329. ▓ Up/Down-Move Pointer ▓ ENTER-Select ▓ ESC-Exit ▓
  330.  
  331.  
  332.     The File Submenu has three options.
  333.     1.  Load an existing report or create a new report.
  334.     2.   Load  a  .DBF  database  fields  for  selection  when  entering expres-
  335.     sions.
  336.     3.  Create source code for the currently loaded report.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                       <4>
  355.                           The Aeolus BREPORT User Manual
  356.  
  357.  
  358.  
  359.  
  360.     MAIN MENU FILE OPTION - Load Report
  361.  
  362.     To load an existing report or create a  new  report  use  the  up  and  down
  363.     arrow  keys  and  move  the  highlight bar over the 'Load Report' option and
  364.     press ENTER.  This will display the following screen.
  365.  
  366.  
  367. [BREPORT File/Load Report - Entry Window]
  368. █File█ Format  Change  Add  Delete  Move  About
  369. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  370. ║█Load Report█████║                                                            ║
  371. ║ Select╔═══════════════════════════════╗                                      ║
  372. ║ Genera║ Report:  ████████████████████ ║                                      ║
  373. ╚═══════║                               ║                                      ║
  374. ║       ╚═══════════════════════════════╝                                      ║
  375. ║        ║                                                                     ║
  376. ║        ║                                                                     ║
  377. ║        ║                                                                     ║
  378. ║        ║                                                                     ║
  379. ║        ║                                                                     ║
  380. ║        ║                                                                     ║
  381. ║        ║                                                                     ║
  382. ║        ║                                                                     ║
  383. ║        ║                                                                     ║
  384. ║        ║                                                                     ║
  385. ║        ║                                                                     ║
  386. ║        ║                                                                     ║
  387. ║        ║                                                                     ║
  388. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  389. ║Scale1  ║         1         2         3         4         5         6         ║
  390. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  391. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  392. ▓ Enter Report Name ▓ ESC-Exit ▓
  393.  
  394.  
  395.     Type the name of the report you wish to  load  or  create.   If  the  report
  396.     already  exists  it  will  be  loaded,  if not found it will be created.  If
  397.     you press ENTER with the field  empty  and  there  are  .RPT  files  in  the
  398.     default  directory  a  pick-list  box  will  be displayed from which you may
  399.     select a  report  to  load.   Press  ESC  to  exit  and  remove  the  Report
  400.     Dialog box from the screen.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       <5>
  414.                           The Aeolus BREPORT User Manual
  415.  
  416.  
  417.  
  418.  
  419.     MAIN MENU FILE OPTION - Load Report
  420.  
  421.     If  you  are  creating  a  new  report  or loading an uninitialized report a
  422.     menu will be presented as follows.
  423.  
  424.  
  425. [BREPORT File/Load Report - New Report Type Selection]
  426. █File█ Format  Change  Add  Delete  Move  About
  427. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  428. ║█Load Report█████║                                                            ║
  429. ║ Select╔═══════════════════════════════╗                                      ║
  430. ║ Genera║ Report:  DUMMY███████████████ ║                                      ║
  431. ╚═══════║                     ╔══════════╗                                     ║
  432. ║       ╚═════════════════════║█Columns██║                                     ║
  433. ║        ║                    ║ Labels   ║                                     ║
  434. ║        ║                    ║ Freeform ║                                     ║
  435. ║        ║                    ╚══════════╝                                     ║
  436. ║        ║                                                                     ║
  437. ║        ║                                                                     ║
  438. ║        ║                                                                     ║
  439. ║        ║                                                                     ║
  440. ║        ║                                                                     ║
  441. ║        ║                                                                     ║
  442. ║        ║                                                                     ║
  443. ║        ║                                                                     ║
  444. ║        ║                                                                     ║
  445. ║        ║                                                                     ║
  446. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  447. ║Scale1  ║         1         2         3         4         5         6         ║
  448. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  449. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  450. ▓ Up/Down-Move Pointer ▓ ENTER-Select ▓ ESC-Exit ▓
  451.  
  452.  
  453.     From here you must select a  report  type  to  create.   Pressing  ESC  from
  454.     here exits and leaves an uninitialized report file on the disk.
  455.  
  456.     Select  a  Column  report  for  reports  with  page  and column headings and
  457.     data that is placed under the  appropriate  columns.   This  will  create  a
  458.     report similar to one created with REPORT FORM.
  459.  
  460.     Select a Labels report for printing mailing labels.
  461.  
  462.     Freeform reports a for creating anything else.
  463.  
  464.     When  a  report  type  is  selected  one of three dialogs will be presented,
  465.     each report type has a different dialog.  See the following screens.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                       <6>
  473.                           The Aeolus BREPORT User Manual
  474.  
  475.  
  476.  
  477.  
  478.     MAIN MENU FILE OPTION - Load Report
  479.  
  480.     Column report initialization dialog.
  481.  
  482.  
  483. [BREPORT File/Load Report - Column Report Initialization]
  484. █File█ Format  Change  Add  Delete  Move  About
  485. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  486. ║█Load Report█████║                                                            ║
  487. ║ Select╔═══════════════════════════════╗                                      ║
  488. ║ Genera║ Report:  DUMMY███████████████ ║                                      ║
  489. ╚═══════║                     ╔══════════╗                                     ║
  490. ║       ╚═════════════════════║█Columns██║                                     ║
  491. ║        ║                    ║ Lab╔══════════════════════════════════╗        ║
  492. ║        ║                    ║ Fre║ COLUMN REPORT OPTIONS-           ║        ║
  493. ║        ║                    ╚════║                                  ║        ║
  494. ║        ║                         ║             Page Width: █80      ║        ║
  495. ║        ║                         ║         Lines per Page: █58      ║        ║
  496. ║        ║                         ║ Spaces Between Columns: █2       ║        ║
  497. ║        ║                         ║        Database Select: ████████ ║        ║
  498. ║        ║                         ║                                  ║        ║
  499. ║        ║                         ║ Page Heading:                    ║        ║
  500. ║        ║                         ║ ████████████████████████████████ ║        ║
  501. ║        ║                         ║ ████████████████████████████████ ║        ║
  502. ║        ║                         ║ ████████████████████████████████ ║        ║
  503. ║        ║                         ║ ████████████████████████████████ ║        ║
  504. ╠════════╬═════════════════════════║                                  ║════════╣
  505. ║Scale1  ║         1         2     ╚══════════════════════════════════╝        ║
  506. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  507. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  508. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  509.  
  510.  
  511.     Fill in the report initialization and press  ENTER  in  the  last  field  of
  512.     the dialog to complete.
  513.  
  514.     Field descriptions:
  515.     Page Width:
  516.     The  maximum  number  of  characters  that can be printed across your print-
  517.     ers page.
  518.  
  519.     Lines per Page:
  520.     The maximum number of lines you want on  your  report,  including  page  and
  521.     column heading lines.
  522.  
  523.     Spaces Between Columns:
  524.     The  number  of  empty  spaces  placed  between  each column of data on your
  525.     report.
  526.  
  527.     Database Select:
  528.     Enter the name of the database  you  want  SELECTed  when  the  source  code
  529.     is  created.   This  is  optional  and  you  may  want  to  code some of the
  530.  
  531.                                       <7>
  532.                           The Aeolus BREPORT User Manual
  533.  
  534.  
  535.  
  536.  
  537.     database set up yourself.
  538.  
  539.     Page Heading:
  540.     Up to four lines of page heading  may  be  entered.   Maximum  width  is  80
  541.     characters.  The headings will be automatically centered on the page.
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                       <8>
  591.                           The Aeolus BREPORT User Manual
  592.  
  593.  
  594.  
  595.  
  596.     MAIN MENU FILE OPTION - Load Report
  597.  
  598.     Label Report Initialization Options.
  599.  
  600.  
  601. [BREPORT File/Load Report - Label Report Initialization]
  602. █File█ Format  Change  Add  Delete  Move  About
  603. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  604. ║█Load Report█████║                                                            ║
  605. ║ Select╔═══════════════════════════════╗                                      ║
  606. ║ Genera║ Report:  DUMMY███████████████ ║                                      ║
  607. ╚═══════║                     ╔══════════╗                                     ║
  608. ║       ╚═════════════════════║ Columns  ║                                     ║
  609. ║        ║                    ║█Labels███║                                     ║
  610. ║        ║                    ║ Fre╔══════════════════════════════════╗        ║
  611. ║        ║                    ╚════║ MAILING LABEL OPTIONS-           ║        ║
  612. ║        ║                         ║                                  ║        ║
  613. ║        ║                         ║            Label Width: ██0      ║        ║
  614. ║        ║                         ║        Lines per Label: ██0      ║        ║
  615. ║        ║                         ║          Labels Across: 0        ║        ║
  616. ║        ║                         ║        Database Select: ████████ ║        ║
  617. ║        ║                         ║                                  ║        ║
  618. ║        ║                         ╚══════════════════════════════════╝        ║
  619. ║        ║                                                                     ║
  620. ║        ║                                                                     ║
  621. ║        ║                                                                     ║
  622. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  623. ║Scale1  ║         1         2         3         4         5         6         ║
  624. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  625. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  626. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  627.  
  628.  
  629.     Fill  in  the  report  initialization  and  press ENTER in the last field of
  630.     the dialog to complete.
  631.  
  632.     Field descriptions:
  633.     Label Width:
  634.     If more than one label  across  enter  the  number  of  character  from  the
  635.     beginning  of  the  first  label  to  the beginning of the one to the right.
  636.     If only one label across enter the character width of the label.
  637.  
  638.     Lines per Label:
  639.     Enter the number of lines from the top the one  label  to  the  top  of  the
  640.     next.
  641.  
  642.     Labels Across:
  643.     Enter the number of labels across the page that will be printed.
  644.  
  645.     Database Select:
  646.     Enter  the  name  of  the  database  you  want SELECTed when the source code
  647.     is created.  This is  optional  and  you  may  want  to  code  some  of  the
  648.  
  649.                                       <9>
  650.                           The Aeolus BREPORT User Manual
  651.  
  652.  
  653.  
  654.  
  655.     database set up yourself.
  656.     MAIN MENU FILE OPTION - Load Report
  657.  
  658.     Freeform report initialization dialog.
  659.  
  660.  
  661. [BREPORT File/Load Report - Free From Initialization]
  662. █File█ Format  Change  Add  Delete  Move  About
  663. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  664. ║█Load Report█████║                                                            ║
  665. ║ Select╔═══════════════════════════════╗                                      ║
  666. ║ Genera║ Report:  DUMMY███████████████ ║                                      ║
  667. ╚═══════║                     ╔══════════╗                                     ║
  668. ║       ╚═════════════════════║ Columns  ║                                     ║
  669. ║        ║                    ║ Labels   ║                                     ║
  670. ║        ║                    ║█Fre╔══════════════════════════════════╗        ║
  671. ║        ║                    ╚════║ FREE FORM OPTIONS-               ║        ║
  672. ║        ║                         ║                                  ║        ║
  673. ║        ║                         ║             Page Width: █80      ║        ║
  674. ║        ║                         ║         Lines per Page: █58      ║        ║
  675. ║        ║                         ║        Database Select: ████████ ║        ║
  676. ║        ║                         ║                                  ║        ║
  677. ║        ║                         ╚══════════════════════════════════╝        ║
  678. ║        ║                                                                     ║
  679. ║        ║                                                                     ║
  680. ║        ║                                                                     ║
  681. ║        ║                                                                     ║
  682. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  683. ║Scale1  ║         1         2         3         4         5         6         ║
  684. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  685. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  686. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  687.  
  688.  
  689.     Fill  in  the  report  initialization  and  press ENTER in the last field of
  690.     the dialog to complete.
  691.  
  692.     Field descriptions:
  693.     Page Width:
  694.     The maximum number of characters that can  be  printed  across  your  print-
  695.     ers page.
  696.  
  697.     Lines per Page:
  698.     The  maximum  number  of  lines  you want on your report, including page and
  699.     column heading lines.
  700.  
  701.     Database Select:
  702.     Enter the name of the database  you  want  SELECTed  when  the  source  code
  703.     is  created.   This  is  optional  and  you  may  want  to  code some of the
  704.     database set up yourself.
  705.  
  706.     After the initialization options  have  been  successfully  entered,  report
  707.  
  708.                                       <10>
  709.                           The Aeolus BREPORT User Manual
  710.  
  711.  
  712.  
  713.  
  714.     text  and  expressions  will  be  displayed  in  the report view area of the
  715.     screen (large boxed in area above the  'Scale').   At  first  this  will  be
  716.     underneath  the  File  Submenu  and  Load  Report  dialog.   For  a  further
  717.     description of the report view area  see  the  General  Information  section
  718.     at the end of this chapter.
  719.  
  720.     Press ESC to remove the Report dialog.
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                       <11>
  768.                           The Aeolus BREPORT User Manual
  769.  
  770.  
  771.  
  772.  
  773.     MAIN MENU FILE OPTION - Select Database
  774.  
  775.     Once  the  report  is  initialized  you  may  optionally  load  a  databases
  776.     fields using the Select Database option  of  the  File  Submenu.   Using  up
  777.     and  down  arrow  keys  position  the highlight bar over the Select Database
  778.     menu option  and  press  Enter.  The  Database  dialog  will  be  presented,
  779.     enter  the  name  of  a  .DBF database you may use an extension, however, if
  780.     you don't .DBF will be assumed.  Press Enter with  the  field  empty  and  a
  781.     pick-list  will  be  presented  of  all  the  .DBF  databases in the current
  782.     DOS default directory.
  783.  
  784.     Th following sample screen shows the Select Database dialog.
  785.  
  786.  
  787. [BREPORT File/Selct File - Entry Window]
  788. █File█ Format  Change  Add  Delete  Move  About
  789. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  790. ║ Load Report     ║                                                            ║
  791. ║█Select╔═════════════════════════════════╗                                    ║
  792. ║ Genera║ Database:  ████████████████████ ║                                    ║
  793. ╚═══════║                                 ║                                    ║
  794. ║       ╚═════════════════════════════════╝                                    ║
  795. ║        ║                                                                     ║
  796. ║        ║                                                                     ║
  797. ║        ║                                                                     ║
  798. ║        ║                                                                     ║
  799. ║        ║                                                                     ║
  800. ║        ║                                                                     ║
  801. ║        ║                                                                     ║
  802. ║        ║                                                                     ║
  803. ║        ║                                                                     ║
  804. ║        ║                                                                     ║
  805. ║        ║                                                                     ║
  806. ║        ║                                                                     ║
  807. ║        ║                                                                     ║
  808. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  809. ║Scale1  ║         1         2         3         4         5         6         ║
  810. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  811. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  812. ▓ Enter Database Name ▓ ESC-Exit ▓
  813.  
  814.  
  815.     Once a valid database name  is  entered  the  following  information  window
  816.     is displayed.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                       <12>
  827.                           The Aeolus BREPORT User Manual
  828.  
  829.  
  830.  
  831.  
  832.     MAIN MENU FILE OPTION - Select Database
  833.  
  834.  
  835. [BREPORT File/Select File - Fields Loaded Information Window]
  836.     █File█ Format  Change  Add  Delete  Move  About
  837. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  838. ║ Load Report     ║                                                            ║
  839. ║█Select╔═════════════════════════════════╗                                    ║
  840. ║ Genera║ Database:  OPTIONS.DBF█████████ ║                                    ║
  841. ╚═══════║                ╔════════════════════════════════╗                    ║
  842. ║       ╚════════════════║                                ║                    ║
  843. ║        ║               ║  Fields Loaded for Selection   ║                    ║
  844. ║        ║               ║  Any Key...                    ║                    ║
  845. ║        ║               ║                                ║                    ║
  846. ║        ║               ╚════════════════════════════════╝                    ║
  847. ║        ║                                                                     ║
  848. ║        ║                                                                     ║
  849. ║        ║                                                                     ║
  850. ║        ║                                                                     ║
  851. ║        ║                                                                     ║
  852. ║        ║                                                                     ║
  853. ║        ║                                                                     ║
  854. ║        ║                                                                     ║
  855. ║        ║                                                                     ║
  856. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  857. ║Scale1  ║         1         2         3         4         5         6         ║
  858. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  859. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  860. ▓ Press Any Key to Remove Box ▓
  861.  
  862.  
  863.     This  indicates  that  the  databases  fields have been loaded into BREPORTs
  864.     internal memory  table,  and  when  when  the  cursor  is  positioned  on  a
  865.     report  expression  field  the  message  'F10  for  Field List' will be dis-
  866.     played and the F10 key will  pop-up  a  pick-list  of  the  fields  in  that
  867.     database.
  868.  
  869.     Up  to  ten  databases  may  be  loaded  for  selection  at a time.  To load
  870.     another, just type type .DBF name in the load database dialog.
  871.  
  872.     Press any key to remove  the  'Fields  Loaded'  information  box,  then  ESC
  873.     at the Select Database dialog to return to the File Submenu.
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                       <13>
  886.                           The Aeolus BREPORT User Manual
  887.  
  888.  
  889.  
  890.  
  891.     MAIN MENU FILE OPTION - Generate Source
  892.  
  893.     When  you  have  completed  your  report  layout,  select  the  File Submenu
  894.     option 'Generate Source'  to  create  a  .PR1  (.PRG)  Clipper  source  code
  895.     file.
  896.  
  897.  
  898. [BREPORT File/Generate Source - Dialog Window]
  899. █File█ Format  Change  Add  Delete  Move  About
  900. ╔═════════════════╗════════════════════════════════════════════════════════════╗
  901. ║ Load Report     ║                                                            ║
  902. ║ Select Dat╔════════════════════════════════════════╗                         ║
  903. ║█Generate S║ File: DUMMY.PR1                        ║                         ║
  904. ╚═══════════║ Ready to Generate Source? (Y/N)        ║                         ║
  905. ║        ║  ╚════════════════════════════════════════╝                         ║
  906. ║        ║                                                                     ║
  907. ║        ║                                                                     ║
  908. ║        ║                                                                     ║
  909. ║        ║                                                                     ║
  910. ║        ║                                                                     ║
  911. ║        ║                                                                     ║
  912. ║        ║                                                                     ║
  913. ║        ║                                                                     ║
  914. ║        ║                                                                     ║
  915. ║        ║                                                                     ║
  916. ║        ║                                                                     ║
  917. ║        ║                                                                     ║
  918. ║        ║                                                                     ║
  919. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  920. ║Scale1  ║         1         2         3         4         5         6         ║
  921. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  922. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  923. ▓ Press Y for Yes or N for No ▓
  924.  
  925.  
  926.     After  selecting  the  'Generate  Source'  menu  option  a dialog will allow
  927.     you one last chance to back out  of  this  decision,  Press  the  Y  key  to
  928.     proceed  and  create  the  report  source file or the N key to return to the
  929.     File Submenu.
  930.  
  931.     The filename created will  have  the  filename  of  the  report  named  when
  932.     you  created  the  report  (.RPT)  file, however, the file extension will be
  933.     .PR1.  This file will be placed in the  DOS  default  drive  and  directory.
  934.     You  can  then  edit  this  file  as  if  it  were  any other Clipper source
  935.     file.
  936.  
  937.     The file extension .PR1 is used instead of  .PRG.   This  is  to  help  pre-
  938.     vent accidentally overwriting report source during development.
  939.  
  940.  
  941.  
  942.  
  943.  
  944.                                       <14>
  945.                           The Aeolus BREPORT User Manual
  946.  
  947.  
  948.  
  949.  
  950.     MAIN MENU FORMAT OPTION
  951.  
  952.     Select  the  Format  option  from  the  main  menu  using the right and left
  953.     arrows to move  the  highlight  pointer  to  the  second  main  menu  option
  954.     'Format'  and  press  Enter.   This  will  present  the  Format Submenu like
  955.     the following screen example.
  956.  
  957.  
  958. [BREPORT Format Sub-Menu]
  959. File █Format█ Change  Add  Delete  Move  About
  960. ╔═╔═══════════════════╗════════════════════════════════════════════════════════╗
  961. ║ ║█Subtotal Grouping█║                                                        ║
  962. ║ ║ Page Layout       ║                                                        ║
  963. ║ ╚═══════════════════╝                                                        ║
  964. ║        ║                                                                     ║
  965. ║        ║                                                                     ║
  966. ║        ║                                                                     ║
  967. ║        ║                                                                     ║
  968. ║        ║                                                                     ║
  969. ║        ║                                                                     ║
  970. ║        ║                                                                     ║
  971. ║        ║                                                                     ║
  972. ║        ║                                                                     ║
  973. ║        ║                                                                     ║
  974. ║        ║                                                                     ║
  975. ║        ║                                                                     ║
  976. ║        ║                                                                     ║
  977. ║        ║                                                                     ║
  978. ║        ║                                                                     ║
  979. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  980. ║Scale1  ║         1         2         3         4         5         6         ║
  981. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  982. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  983. ▓ Up/Down-Move Pointer ▓ ENTER-Select ▓ ESC-Exit ▓
  984.  
  985.  
  986.     The Format Submenu contains  two  options,  'Subtotal  Grouping'  and  'Page
  987.     Layout',  move  the  hightlight  bar  using  the  up and down arrow keys and
  988.     press Enter on either option to present the dialog for it.
  989.  
  990.     Note:  If you do not yet have  a  report  loaded  selecting  either  of  the
  991.     Format  Submenu  options  will  only  display  an error message.  Be sure to
  992.     load a report before using these options.
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                       <15>
  1004.                           The Aeolus BREPORT User Manual
  1005.  
  1006.  
  1007.  
  1008.  
  1009.     MAIN MENU OPTION FORMAT - Subtotal Grouping.
  1010.  
  1011.  
  1012. [BREPORT Format/Subtotal Grouping - Entry Window]
  1013. File █Format█ Change  Add  Delete  Move  Columns  About
  1014. ╔═╔═══════════════════╗════════════════════════════════════════════════════════╗
  1015. ║P║█Subtotal Grouping█║                                        Aeolus Software ║
  1016. ║P║ Page Lay╔═══════════════════════════════════╗                    Report Mak║
  1017. ║P╚═════════║ Group Expression:                 ║               Test Report Num║
  1018. ║PgHdr4  ║  ║ AUTH_NAM█████████████████████████ ║             From xx/xx/xx To ║
  1019. ║PgHdr5  ║  ║    Group Heading:                 ║                              ║
  1020. ║PgHdr6  ║Fi║ "Author: "+auth_nam██████████████ ║hdate  Test Column  Subtotal  ║
  1021. ║PgHdr7  ║--║ Page Eject After Group? (Y/N) █   ║-----  -----------  --------  ║
  1022. ║Body1   ║FL║                                   ║       FLD3         SBTTL     ║
  1023. ║Subttl1 ║ A╚═══════════════════════════════════╝                    SBTTL     ║
  1024. ║        ║                                                                     ║
  1025. ║        ║                                                                     ║
  1026. ║        ║                                                                     ║
  1027. ║        ║                                                                     ║
  1028. ║        ║                                                                     ║
  1029. ║        ║                                                                     ║
  1030. ║        ║                                                                     ║
  1031. ║        ║                                                                     ║
  1032. ║        ║                                                                     ║
  1033. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1034. ║Scale1  ║         1         2         3         4         5         6         ║
  1035. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1036. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1037. ▓ Enter Group Info ▓ PgUp/PgDn-Prev/Next ▓ Ctrl+N/Ctrl+U-Ins/Del ▓ ESC-Abort ▓
  1038.  
  1039.  
  1040.     The program will only allow subtotals on column type reports.
  1041.  
  1042.     You may enter up to 99 subtotal  groupings.   You  will  want  your  subtot-
  1043.     als  to  reflect  the  sort  or index order of the database.  The first sub-
  1044.     total being the first level sort,  the  second  the  second  and  so  on  to
  1045.     the  desired  level.   Not  using  a  sorted  or indexed database or putting
  1046.     the subtotals in an incorrect  order  will  cause  your  report  to  produce
  1047.     incorrect results.
  1048.  
  1049.     In  the  'Group  Expression'  field  enter  the database field name or field
  1050.     expression that will trip the subtotal when it changes.
  1051.  
  1052.     In the 'Group Heading' enter a  quoted  literal  and/or  database  field  to
  1053.     print on the subtotal line.
  1054.  
  1055.     Press  the  Page  Up  and  Page  Down  keys  to  move  between the subtotals
  1056.     entered into the current report.
  1057.  
  1058.     Press Ctrl+N to insert a subtotal between two others.
  1059.  
  1060.     Press Ctrl+U to delete the displayed subtotal.
  1061.  
  1062.                                       <16>
  1063.                           The Aeolus BREPORT User Manual
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.     Press ESC to exit the 'Subtotal Grouping' dialog.
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                       <17>
  1122.                           The Aeolus BREPORT User Manual
  1123.  
  1124.  
  1125.  
  1126.  
  1127.     MAIN MENU OPTION FORMAT - Page Layout
  1128.  
  1129.     The 'Page Layout' option of the Format Submenu  allows  you  to  change  the
  1130.     information  you  entered  when  the  report  was  initialized.   (See  MAIN
  1131.     MENU FILE OPTION -Load Report Section to review the field settings)
  1132.  
  1133.     One  of  the  following  three  screens  will  be  displayed  when  this  is
  1134.     selected depending on the report type.
  1135.  
  1136.     If a column type report was selected the following screen is presented.
  1137.  
  1138.  
  1139. [BREPORT Format/Page Layout (Columns) - Modification Window]
  1140. File █Format█ Change  Add  Delete  Move  Columns  About
  1141. ╔═╔═══════════════════╗════════════════════════════════════════════════════════╗
  1142. ║P║ Subtotal Grouping ║                                        Aeolus Software ║
  1143. ║P║█Page Lay╔══════════════════════════════════╗                     Report Mak║
  1144. ║P╚═════════║ COLUMN REPORT OPTIONS-           ║                Test Report Num║
  1145. ║PgHdr4  ║  ║                                  ║              From xx/xx/xx To ║
  1146. ║PgHdr5  ║  ║             Page Width: 132      ║                               ║
  1147. ║PgHdr6  ║Fi║         Lines per Page:  58      ║thdate  Test Column  Subtotal  ║
  1148. ║PgHdr7  ║--║ Spaces Between Columns:  2       ║------  -----------  --------  ║
  1149. ║Body1   ║FL║        Database Select: DATAFILE ║E       FLD3         SBTTL     ║
  1150. ║Subttl1 ║ A║                                  ║                     SBTTL     ║
  1151. ║        ║  ║ Page Heading:                    ║                               ║
  1152. ║        ║  ║ Aeolus Software Company█████████ ║                               ║
  1153. ║        ║  ║ Report Maker████████████████████ ║                               ║
  1154. ║        ║  ║ Test Report Number One██████████ ║                               ║
  1155. ║        ║  ║ From xx/xx/xx To xx/xx/xx███████ ║                               ║
  1156. ║        ║  ║                                  ║                               ║
  1157. ║        ║  ╚══════════════════════════════════╝                               ║
  1158. ║        ║                                                                     ║
  1159. ║        ║                                                                     ║
  1160. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1161. ║Scale1  ║         1         2         3         4         5         6         ║
  1162. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1163. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1164. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.                                       <18>
  1181.                           The Aeolus BREPORT User Manual
  1182.  
  1183.  
  1184.  
  1185.  
  1186.     MAIN MENU OPTION FORMAT -- Page Layout
  1187.  
  1188.  
  1189.     If a label type report was selected the following screen is presented
  1190.  
  1191.  
  1192. [BREPORT Format/Page Layout (Labels) - Entry Window]
  1193. File █Format█ Change  Add  Delete Move About
  1194. ╔═╔═══════════════════╗════════════════════════════════════════════════════════╗
  1195. ║B║ Subtotal Grouping ║                                                        ║
  1196. ║B║█Page Lay╔══════════════════════════════════╗                               ║
  1197. ║B╚═════════║ MAILING LABEL OPTIONS-           ║                               ║
  1198. ║Body4   ║  ║                                  ║                               ║
  1199. ║Body5   ║  ║            Label Width:  40      ║                               ║
  1200. ║Body6   ║  ║        Lines per Label:   6      ║                               ║
  1201. ║        ║  ║          Labels Across: 3        ║                               ║
  1202. ║        ║  ║        Database Select: LBLFILE  ║                               ║
  1203. ║        ║  ║                                  ║                               ║
  1204. ║        ║  ╚══════════════════════════════════╝                               ║
  1205. ║        ║                                                                     ║
  1206. ║        ║                                                                     ║
  1207. ║        ║                                                                     ║
  1208. ║        ║                                                                     ║
  1209. ║        ║                                                                     ║
  1210. ║        ║                                                                     ║
  1211. ║        ║                                                                     ║
  1212. ║        ║                                                                     ║
  1213. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1214. ║Scale1  ║         1         2         3         4         5         6         ║
  1215. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1216. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1217. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.                                       <19>
  1240.                           The Aeolus BREPORT User Manual
  1241.  
  1242.  
  1243.  
  1244.  
  1245.     MAIN MENU OPTION FORMAT -- Page Layout
  1246.  
  1247.  
  1248.     If  a  freeform  type  report  was  selected  the  following  screen is pre-
  1249.     sented.
  1250.  
  1251.  
  1252. [BREPORT Format/Page Layout (Freeform) - Modification Window]
  1253.   █File█ Format  Change  Add  Delete  Move  About  Exit
  1254. ╔═╔═══════════════════╗═════════════════════════════════════════════╡FTEST.RPT╞╗
  1255. ║P║ Subtotal Grouping ║                                                        ║
  1256. ║P║█Page Lay╔══════════════════════════════════╗                               ║
  1257. ║B╚═════════║ FREE FORM OPTIONS-               ║                               ║
  1258. ║        ║  ║                                  ║                               ║
  1259. ║        ║  ║             Text Width: █80      ║                               ║
  1260. ║        ║  ║                 Margin: █0       ║                               ║
  1261. ║        ║  ║         Lines per Page: █58      ║                               ║
  1262. ║        ║  ║        Database Select: DATAFILE ║                               ║
  1263. ║        ║  ║                                  ║                               ║
  1264. ║        ║  ╚══════════════════════════════════╝                               ║
  1265. ║        ║                                                                     ║
  1266. ║        ║                                                                     ║
  1267. ║        ║                                                                     ║
  1268. ║        ║                                                                     ║
  1269. ║        ║                                                                     ║
  1270. ║        ║                                                                     ║
  1271. ║        ║                                                                     ║
  1272. ║        ║                                                                     ║
  1273. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1274. ║Scale1  ║         1         2         3         4         5         6         ║
  1275. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1276. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1277. ▓ Enter Page Layout Information ▓ ESC-Abort ▓
  1278.  
  1279.  
  1280.     Make any changes to the options presented, the  results  will  be  shown  on
  1281.     the report layout in the report view area.
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                       <20>
  1299.                           The Aeolus BREPORT User Manual
  1300.  
  1301.  
  1302.  
  1303.  
  1304.     MAIN MENU OPTION CHANGE
  1305.  
  1306.     The  'Change'  main  menu  option  will  allow  you to modify a text literal
  1307.     or field expression that is already on the report layout.
  1308.  
  1309.     Select the 'Change'  main  menu  option  using  the  right  and  left  arrow
  1310.     keys,   move  the  highlight  block  over  the  'Change'  option  and  press
  1311.     Enter.  The following prompt  will  be  display  where  the  main  menu  had
  1312.     been.
  1313.  
  1314.     -MOVE CURSOR ON FIELD TO CHANGE
  1315.  
  1316.     A  cursor  will  be  placed  in  the  report layout area of the screen.  Use
  1317.     the four arrow keys, Tab, Shift+Tab, Home,  End  and,  if  needed,  Page  Up
  1318.     and  Page  Down  to  move  the cursor on any part of a text literal or field
  1319.     expression  you  want  to  change.  Press  Enter  to  present   the   change
  1320.     dialog.  Press ESC to return to the main menu.
  1321.  
  1322.     Also,  pressing  the  Ctrl+U  key  will  delete  the  report layout line the
  1323.     cursor is on.  The Ctrl+N key will insert a  blank  line  after  the  cursor
  1324.     position
  1325.  
  1326.     Note:  If  you  deleted  all  the  Body lines of your report layout, insert-
  1327.     ing a line with the cursor positioned on the last  PgHdr  line  will  add  a
  1328.     blank  Body  line.  If  you  deleted  all  the  PgHdr  lines, you cannot get
  1329.     them back.  This note does not apply to label report layouts.
  1330.  
  1331.     When you  have  selected  a  field  to  change  one  of  the  following  two
  1332.     screens will be presented, depending on the field type.
  1333.  
  1334.     If  a  text  literal  is  selected for change, that text will be placed in a
  1335.     dialog for editting, in the example below the  text  'Page  Nbr:'  is  being
  1336.     modified.  The field cannot exceed 80 characters in length.
  1337.  
  1338.     Press ESC to exit without making the changes.
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.                                       <21>
  1358.                           The Aeolus BREPORT User Manual
  1359.  
  1360.  
  1361.  
  1362.  
  1363.     MAIN MENU OPTION CHANGE
  1364.  
  1365.  
  1366. [BREPORT Change - Modify Text Literal Window]
  1367. File  Format █Change█ Add  Delete  Move  Columns  About
  1368. ╔═══════╔════════════════════════════════════╗═════════════════════════════════╗
  1369. ║PgHdr1 ║ Text Literal: Page Nbr:███████████ ║                 Aeolus Software ║
  1370. ║PgHdr2 ╚════════════════════════════════════╝                       Report Mak║
  1371. ║PgHdr3  ║                                                      Test Report Num║
  1372. ║PgHdr4  ║                                                    From xx/xx/xx To ║
  1373. ║PgHdr5  ║                                                                     ║
  1374. ║PgHdr6  ║Field One  Field Two  Test Insert  Birthdate  Test Column  Subtotal  ║
  1375. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1376. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1377. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1378. ║        ║                                                                     ║
  1379. ║        ║                                                                     ║
  1380. ║        ║                                                                     ║
  1381. ║        ║                                                                     ║
  1382. ║        ║                                                                     ║
  1383. ║        ║                                                                     ║
  1384. ║        ║                                                                     ║
  1385. ║        ║                                                                     ║
  1386. ║        ║                                                                     ║
  1387. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1388. ║Scale1  ║         1         2         3         4         5         6         ║
  1389. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1390. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1391. ▓ Enter/Modify Text for Selected Position ▓ ESC-Abort ▓
  1392.  
  1393.  
  1394.     If  a  field  expression  was  selected to be changed, the field information
  1395.     will be placed  in  a  dialog  for  editting.   In  the  example  below  the
  1396.     field 'RPG' is being changed.
  1397.  
  1398.     Field Descriptions:
  1399.     Field  Expression:  A  valid  Clipper  expression,  you  may  use functions,
  1400.     memory  variables  (remember  to  put  them  in  your   program),   database
  1401.     fields,  quoted  literals  or  any  combination  as  long  as  you  create a
  1402.     valid expression.
  1403.  
  1404.     Data Type:
  1405.     The data type the expression will be, can be:
  1406.     C - Character
  1407.     N - Numeric
  1408.     D - Date
  1409.     L - Logical
  1410.     (Memo fields are not allowed)
  1411.  
  1412.     Width:
  1413.     Enter the total width the field will occupy on the report.
  1414.  
  1415.  
  1416.                                       <22>
  1417.                           The Aeolus BREPORT User Manual
  1418.  
  1419.  
  1420.  
  1421.  
  1422.     Decimal:
  1423.     If the Data Type is Numeric, you may enter  the  number  of  decimal  places
  1424.     the number on the report will occupy.
  1425.  
  1426.     Press ESC to exit without changes.
  1427.  
  1428.  
  1429. [BREPORT Change - Modify Data Element Window]
  1430. File  Format █Change█ Add  Delete  Move  Columns  About
  1431. ╔═══════╔════════════════════════════════════════╗═════════════════════════════╗
  1432. ║PgHdr1 ║ Field Expression: RPG█████████████████ ║             Aeolus Software ║
  1433. ║PgHdr2 ║        Data Type: N                    ║                   Report Mak║
  1434. ║PgHdr3 ║            Width: ██3                  ║              Test Report Num║
  1435. ║PgHdr4 ║          Decimal: █0                   ║            From xx/xx/xx To ║
  1436. ║PgHdr5 ║                                        ║                             ║
  1437. ║PgHdr6 ╚════════════════════════════════════════╝date  Test Column  Subtotal  ║
  1438. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1439. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1440. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1441. ║        ║                                                                     ║
  1442. ║        ║                                                                     ║
  1443. ║        ║                                                                     ║
  1444. ║        ║                                                                     ║
  1445. ║        ║                                                                     ║
  1446. ║        ║                                                                     ║
  1447. ║        ║                                                                     ║
  1448. ║        ║                                                                     ║
  1449. ║        ║                                                                     ║
  1450. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1451. ║Scale1  ║         1         2         3         4         5         6         ║
  1452. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1453. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1454. ▓ Enter Field Information ▓ ESC-Abort ▓
  1455.  
  1456.  
  1457.     After  entering  any  changes,  they  will  be  displayed in the report lay-
  1458.     out.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.                                       <23>
  1476.                           The Aeolus BREPORT User Manual
  1477.  
  1478.  
  1479.  
  1480.  
  1481.     MAIN MENU OPTION ADD
  1482.  
  1483.     The 'Add' main menu option will allow you to  add  a  new  text  literal  or
  1484.     field expression to the report layout.
  1485.  
  1486.     Select  the  'Add'  main  menu  option  using the right and left arrow keys,
  1487.     move the highlight block  over  the  'Add'  option  and  press  Enter.   The
  1488.     following prompt will be display where the main menu had been.
  1489.  
  1490.     -MOVE CURSOR TO BLANK AREA FOR ADD
  1491.  
  1492.     A  cursor  will  be  placed  in  the  report layout area of the screen.  Use
  1493.     the four arrow keys, Tab, Shift+Tab, Home,  End  and,  if  needed,  Page  Up
  1494.     and  Page  Down  to  move  the  cursor  to any blank area of the report lay-
  1495.     out.  Press Enter at the  leftmost  position  you  would  like  to  add  the
  1496.     field,  the  Add  Submenu  will  then  be presented.  Press ESC to return to
  1497.     the main menu.
  1498.  
  1499.     Also, pressing the Ctrl+U  key  will  delete  the  report  layout  line  the
  1500.     cursor  is  on.   The  Ctrl+N  key will insert a blank line after the cursor
  1501.     position.
  1502.  
  1503.     Note: If you deleted all the Body  lines  of  your  report  layout,  insert-
  1504.     ing  a  line  with  the  cursor positioned on the last PgHdr line will add a
  1505.     blank Body line. If  you  deleted  all  the  PgHdr  lines,  you  cannot  get
  1506.     them back.  This note does not apply to label report layouts.
  1507.  
  1508.     Add menu-
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.                                       <24>
  1535.                           The Aeolus BREPORT User Manual
  1536.  
  1537.  
  1538.  
  1539.  
  1540.     MAIN MENU OPTION ADD
  1541.  
  1542. [BREPORT Add Menu]
  1543. File  Format  Change █Add█ Delete  Move  Columns  About
  1544. ╔════════╦════════════╔═══════╗════════════════════════════════════════════════╗
  1545. ║PgHdr1  ║Page Nbr: RP║█Text██║                                Aeolus Software ║
  1546. ║PgHdr2  ║            ║ Field ║                                      Report Mak║
  1547. ║PgHdr3  ║            ╚═══════╝                                 Test Report Num║
  1548. ║PgHdr4  ║                                                    From xx/xx/xx To ║
  1549. ║PgHdr5  ║                                                                     ║
  1550. ║PgHdr6  ║Field One  Field Two  Test Insert  Birthdate  Test Column  Subtotal  ║
  1551. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1552. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1553. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1554. ║        ║                                                                     ║
  1555. ║        ║                                                                     ║
  1556. ║        ║                                                                     ║
  1557. ║        ║                                                                     ║
  1558. ║        ║                                                                     ║
  1559. ║        ║                                                                     ║
  1560. ║        ║                                                                     ║
  1561. ║        ║                                                                     ║
  1562. ║        ║                                                                     ║
  1563. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1564. ║Scale1  ║         1         2         3         4         5         6         ║
  1565. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1566. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1567. ▓ Up/Down-Move Pointer ▓ ENTER-Select ▓ ESC-Exit ▓
  1568.  
  1569.  
  1570.     Select  the  type  of  field  to  add  to the report layout using the up and
  1571.     down arrow keys to move the highlight bar,  press  enter  to  select  either
  1572.     'Text'  for  a  text  literal  or  'Field' to add a field expression.  Press
  1573.     ESC to exit the add menu.
  1574.  
  1575.     If the 'Text' option  is  selected  from  the  Add  Submenu,  the  following
  1576.     screen is presented.
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.                                       <25>
  1594.                           The Aeolus BREPORT User Manual
  1595.  
  1596.  
  1597.  
  1598.  
  1599.     MAIN MENU OPTION ADD
  1600.  
  1601.  
  1602. [BREPORT Add/Text Entry Window]
  1603. File  Format  Change █Add█ Delete  Move  Columns  About
  1604. ╔════════╦════════════╔═══════╗════════════════════════════════════════════════╗
  1605. ║PgHdr1  ║Page Nbr: RP║█Text██║                                Aeolus Software ║
  1606. ║PgHdr2  ║            ║ Fi╔════════════════════════════════════╗     Report Mak║
  1607. ║PgHdr3  ║            ╚═══║ Text Literal:  ███████████████████ ║Test Report Num║
  1608. ║PgHdr4  ║                ╚════════════════════════════════════╝om xx/xx/xx To ║
  1609. ║PgHdr5  ║                                                                     ║
  1610. ║PgHdr6  ║Field One  Field Two  Test Insert  Birthdate  Test Column  Subtotal  ║
  1611. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1612. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1613. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1614. ║        ║                                                                     ║
  1615. ║        ║                                                                     ║
  1616. ║        ║                                                                     ║
  1617. ║        ║                                                                     ║
  1618. ║        ║                                                                     ║
  1619. ║        ║                                                                     ║
  1620. ║        ║                                                                     ║
  1621. ║        ║                                                                     ║
  1622. ║        ║                                                                     ║
  1623. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1624. ║Scale1  ║         1         2         3         4         5         6         ║
  1625. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1626. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1627. ▓ Enter New Text for Selected Position ▓ ESC-Abort ▓
  1628.  
  1629.  
  1630.     Type  in  the  text  you  would  like  displayed  at  the location selected,
  1631.     Press Enter when finished or ESC to  abandon  the  operation.   The  maximum
  1632.     width of the text can be 80 characters.
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                                       <26>
  1653.                           The Aeolus BREPORT User Manual
  1654.  
  1655.  
  1656.  
  1657.  
  1658.     MAIN MENU OPTION ADD
  1659.  
  1660.     If  the  'Field'  option  is  selected  from  the Add Submenu, the following
  1661.     screen is presented.
  1662.  
  1663. [BREPORT Add/Field Entry Window]
  1664. File  Format  Change █Add█ Delete  Move  Columns  About
  1665. ╔════════╦════════════╔═══════╗════════════════════════════════════════════════╗
  1666. ║PgHdr1  ║Page Nbr: RP║ Text  ║                                Aeolus Software ║
  1667. ║PgHdr2  ║            ║█Fi╔════════════════════════════════════════╗ Report Mak║
  1668. ║PgHdr3  ║            ╚═══║ Field Expression: ████████████████████ ║ Report Num║
  1669. ║PgHdr4  ║                ║        Data Type: █                    ║x/xx/xx To ║
  1670. ║PgHdr5  ║                ║            Width: ██0                  ║           ║
  1671. ║PgHdr6  ║Field One  Field║          Decimal: █0                   ║ Subtotal  ║
  1672. ║PgHdr7  ║---------  -----║                                        ║ --------  ║
  1673. ║Body1   ║FLD1       FLD2 ╚════════════════════════════════════════╝ SBTTL     ║
  1674. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1675. ║        ║                                                                     ║
  1676. ║        ║                                                                     ║
  1677. ║        ║                                                                     ║
  1678. ║        ║                                                                     ║
  1679. ║        ║                                                                     ║
  1680. ║        ║                                                                     ║
  1681. ║        ║                                                                     ║
  1682. ║        ║                                                                     ║
  1683. ║        ║                                                                     ║
  1684. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1685. ║Scale1  ║         1         2         3         4         5         6         ║
  1686. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1687. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1688. ▓ Enter Field Information ▓ ESC-Abort ▓
  1689.  
  1690.  
  1691.     Enter the fields in this dialog to add a  field  expression  to  the  report
  1692.     layout.
  1693.  
  1694.     Field Expression:
  1695.     Field  Expression:  A  valid  Clipper  expression,  you  may  use functions,
  1696.     memory  variables  (remember  to  put  them  in  your   program),   database
  1697.     fields,  quoted  literals  or  any  combination  as  long  as  you  create a
  1698.     valid expression.
  1699.  
  1700.     Data Type:
  1701.     The data type the expression will be, can be:
  1702.     C - Character
  1703.     N - Numeric
  1704.     D - Date
  1705.     L - Logical
  1706.     (Memo fields are not allowed)
  1707.  
  1708.     Width:
  1709.     Enter the total width the field will occupy on the report.
  1710.  
  1711.                                       <27>
  1712.                           The Aeolus BREPORT User Manual
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.     Decimal:
  1719.     If the Data Type is Numeric, you may enter  the  number  of  decimal  places
  1720.     the number on the report will occupy.
  1721.  
  1722.     Press ESC to exit abandon the operation.
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.                                       <28>
  1771.                           The Aeolus BREPORT User Manual
  1772.  
  1773.  
  1774.  
  1775.  
  1776.     MAIN MENU OPTION DELETE
  1777.  
  1778.     The  'Delete'  main  menu  option  will  allow  you to remove a text literal
  1779.     or field expression that is already on the report layout.
  1780.  
  1781.     Select the 'Delete'  main  menu  option  using  the  right  and  left  arrow
  1782.     keys,   move  the  highlight  block  over  the  'Delete'  option  and  press
  1783.     Enter.  The following prompt  will  be  display  where  the  main  menu  had
  1784.     been.
  1785.  
  1786.     -MOVE CURSOR ON FIELD TO DELETE
  1787.  
  1788.     A  cursor  will  be  placed  in  the  report layout area of the screen.  Use
  1789.     the four arrow keys, Tab, Shift+Tab, Home,  End  and,  if  needed,  Page  Up
  1790.     and  Page  Down  to  move  the cursor on any part of a text literal or field
  1791.     expression  you  want  to  delete.  Press  Enter  to  present   the   delete
  1792.     dialog.  Press ESC to return to the main menu.
  1793.  
  1794.     Also,  pressing  the  Ctrl+U  key  will  delete  the  report layout line the
  1795.     cursor is on.  The Ctrl+N key will insert a  blank  line  after  the  cursor
  1796.     position
  1797.  
  1798.     Note:  If  you  deleted  all  the  Body lines of your report layout, insert-
  1799.     ing a line with the cursor positioned on the last  PgHdr  line  will  add  a
  1800.     blank  Body  line.  If  you  deleted  all  the  PgHdr  lines, you cannot get
  1801.     them back.  This note does not apply to label report layouts.
  1802.  
  1803.     When you  have  selected  a  field  to  delete  one  of  the  following  two
  1804.     screens will be presented, depending on the field type.
  1805.  
  1806.  
  1807.     This dialog is presented if a text literal is selected for deletion.
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.                                       <29>
  1830.                           The Aeolus BREPORT User Manual
  1831.  
  1832.  
  1833.  
  1834.  
  1835. [BREPORT Delete/Delete Literal Dialog]
  1836. File  Format  Change  Add █Delete█ Move  Columns  About
  1837. ╔════════╦══════════╔════════════════════════════════════╗═════════════════════╗
  1838. ║PgHdr1  ║Page Nbr: ║ Text Literal: Page Nbr:███████████ ║     Aeolus Software ║
  1839. ║PgHdr2  ║          ║ O.K. to Delete? (Y/N)              ║           Report Mak║
  1840. ║PgHdr3  ║          ╚════════════════════════════════════╝      Test Report Num║
  1841. ║PgHdr4  ║                                                    From xx/xx/xx To ║
  1842. ║PgHdr5  ║                                                                     ║
  1843. ║PgHdr6  ║Field One  Field Two  Test Insert  Birthdate  Test Column  Subtotal  ║
  1844. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1845. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1846. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1847. ║        ║                                                                     ║
  1848. ║        ║                                                                     ║
  1849. ║        ║                                                                     ║
  1850. ║        ║                                                                     ║
  1851. ║        ║                                                                     ║
  1852. ║        ║                                                                     ║
  1853. ║        ║                                                                     ║
  1854. ║        ║                                                                     ║
  1855. ║        ║                                                                     ║
  1856. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1857. ║Scale1  ║         1         2         3         4         5         6         ║
  1858. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1859. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1860. ▓ Press Y-Yes or N-No ▓ ESC-Abort ▓
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.                                       <30>
  1889.                           The Aeolus BREPORT User Manual
  1890.  
  1891.  
  1892.  
  1893.  
  1894.     MAIN MENU OPTION DELETE
  1895.  
  1896.     This  dialog  is  presented  if  a  field  expression  is selected for dele-
  1897.     tion.
  1898.  
  1899.  
  1900. [BREPORT Delete/Delete Expression Dialog]
  1901. File  Format  Change  Add █Delete█ Move  Columns  About
  1902. ╔════════╦══════════╔════════════════════════════════════════╗═════════════════╗
  1903. ║PgHdr1  ║Page Nbr: ║ Field Expression: RPG█████████████████ ║ Aeolus Software ║
  1904. ║PgHdr2  ║          ║        Data Type: N                    ║       Report Mak║
  1905. ║PgHdr3  ║          ║            Width: ██3                  ║  Test Report Num║
  1906. ║PgHdr4  ║          ║          Decimal: █0                   ║From xx/xx/xx To ║
  1907. ║PgHdr5  ║          ║ O.K. to Delete? (Y/N)                  ║                 ║
  1908. ║PgHdr6  ║Field One ╚════════════════════════════════════════╝olumn  Subtotal  ║
  1909. ║PgHdr7  ║---------  ---------  -----------  ---------  -----------  --------  ║
  1910. ║Body1   ║FLD1       FLD2       FLDI         BDTE       FLD3         SBTTL     ║
  1911. ║Subttl1 ║ Author: +auth_nam                                         SBTTL     ║
  1912. ║        ║                                                                     ║
  1913. ║        ║                                                                     ║
  1914. ║        ║                                                                     ║
  1915. ║        ║                                                                     ║
  1916. ║        ║                                                                     ║
  1917. ║        ║                                                                     ║
  1918. ║        ║                                                                     ║
  1919. ║        ║                                                                     ║
  1920. ║        ║                                                                     ║
  1921. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  1922. ║Scale1  ║         1         2         3         4         5         6         ║
  1923. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  1924. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  1925. ▓ Press Y-Yes or N-No ▓ ESC-Abort ▓
  1926.  
  1927.  
  1928.     In either case, press the  Y  key  to  delete  the  field  from  the  report
  1929.     layout, or press the N key to leave it alone.
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.                                       <31>
  1948.                           The Aeolus BREPORT User Manual
  1949.  
  1950.  
  1951.  
  1952.  
  1953.     MAIN MENU OPTION MOVE
  1954.  
  1955.     The  'Move'  main  menu  option  will  allow  you  to move a text literal or
  1956.     field expression that is already on the report layout.
  1957.  
  1958.     Select the 'Move' main menu option using the  right  and  left  arrow  keys,
  1959.     move  the  highlight  block  over  the  'Move'  option and press Enter.  The
  1960.     following prompt will be display where the main menu had been.
  1961.  
  1962.     -MOVE CURSOR ON FIELD TO MOVE
  1963.  
  1964.     A cursor will be placed in the  report  layout  area  of  the  screen.   Use
  1965.     the  four  arrow  keys,  Tab,  Shift+Tab,  Home, End and, if needed, Page Up
  1966.     and Page Down to move the cursor on any part of  a  text  literal  or  field
  1967.     expression  you  want  to  move.   Press  Enter  to  highlight  the selected
  1968.     field.  Press ESC to return to the main menu.
  1969.  
  1970.     Also, pressing the Ctrl+U  key  will  delete  the  report  layout  line  the
  1971.     cursor  is  on.   The  Ctrl+N  key will insert a blank line after the cursor
  1972.     position
  1973.  
  1974.     Note: If you deleted all the Body  lines  of  your  report  layout,  insert-
  1975.     ing  a  line  with  the  cursor positioned on the last PgHdr line will add a
  1976.     blank Body line. If  you  deleted  all  the  PgHdr  lines,  you  cannot  get
  1977.     them back.  This note does not apply to label report layouts.
  1978.  
  1979.     When  you  have  highlighted  a  field  to  move  the  following prompt will
  1980.     appear where the main menu  is  normally  positioned  on  the  top  line  of
  1981.     the screen.
  1982.  
  1983.     -MOVE HIGHLIGHTED FIELD TO NEW POSITION
  1984.  
  1985.     Use  the  four  arrow  keys,  Tab, Shift+Tab, Home, End and "C" keys to move
  1986.     the field to its new  location.   Pressing  the  "C"  key  will  center  the
  1987.     highlighted  text  on  the  report.   Pressing  PgUp  or PgDn will highlight
  1988.     the previous or  next  field  on  the  screen  allowing  that  field  to  be
  1989.     moved.  Press Enter or ESC when finished to return to the main menu.
  1990.  
  1991.     Note:   You  cannot  move  a  field  from  the  Body of a report to the Page
  1992.     Header of a report, or visa versa.   If  you  need  to  make  this  type  of
  1993.     move, Delete from one section and Add to the other.
  1994.  
  1995.     Warning  for  Column  Reports:   If  you  use  this  option  to move a field
  1996.     originally entered from the main menu Column  dialog,  it  is  possible  the
  1997.     field  will  be  automatically  repositioned.   If  you  re-enter the Column
  1998.     dialog after moving such a field and  either  insert  or  delete  a  column,
  1999.     all fields attached to columns will be repositioned.
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.                                       <32>
  2007.                           The Aeolus BREPORT User Manual
  2008.  
  2009.  
  2010.  
  2011.  
  2012.     MAIN MENU OPTION COLUMNS
  2013.  
  2014.     If  a  column  type  report  has  been  loaded,  the  'Columns'  option will
  2015.     appear on the main menu.  Select  this  option  using  the  right  and  left
  2016.     arrow  keys  to  move  the  highlight  block  over  the 'Columns' option and
  2017.     press Enter.  The Column dialog will then be presented.
  2018.  
  2019.     The column information initially  presented  in  this  dialog  will  be  the
  2020.     leftmost  column  currently  displayed  in  the  report  layout view area of
  2021.     the screen.  All columns will be available  for  editting,  press  the  Page
  2022.     Up  key  to  edit  the  previous  column or Page Down for the next.  You may
  2023.     insert or delete a column by pressing the  Ctrl+N  or  Ctrl+U  keys  respec-
  2024.     tively.
  2025.  
  2026.     The column dialog looks like the following:
  2027.  
  2028.  
  2029. [BREPORT Columns Entry/Modification Window]
  2030. File  Format  Change  Add  Delete  Move █Columns█ About
  2031. ╔════════╦═══════════════╔═══════════════════════════════════╗═════════════════╗
  2032. ║PgHdr1  ║Page Nbr: RPG  ║ Column Heading:                   ║ Aeolus Software ║
  2033. ║PgHdr2  ║               ║ █████████████████████████████████ ║       Report Mak║
  2034. ║PgHdr3  ║               ║ █████████████████████████████████ ║  Test Report Num║
  2035. ║PgHdr4  ║               ║ Field One████████████████████████ ║From xx/xx/xx To ║
  2036. ║PgHdr5  ║               ║ ---------████████████████████████ ║                 ║
  2037. ║PgHdr6  ║Field One  Fiel║ Contents:                         ║olumn  Subtotal  ║
  2038. ║PgHdr7  ║---------  ----║ FLD1█████████████████████████████ ║-----  --------  ║
  2039. ║Body1   ║FLD1       FLD2║ Data Type: C                      ║       SBTTL     ║
  2040. ║Subttl1 ║ Author: +auth_║ Width: ██9 Decimal: █0            ║       SBTTL     ║
  2041. ║        ║               ║                                   ║                 ║
  2042. ║        ║               ║ Total/Average/None? (T/A/N) N     ║                 ║
  2043. ║        ║               ║                                   ║                 ║
  2044. ║        ║               ╚═══════════════════════════════════╝                 ║
  2045. ║        ║                                                                     ║
  2046. ║        ║                                                                     ║
  2047. ║        ║                                                                     ║
  2048. ║        ║                                                                     ║
  2049. ║        ║                                                                     ║
  2050. ╠════════╬═════════════════════════════════════════════════════════════════════╣
  2051. ║Scale1  ║         1         2         3         4         5         6         ║
  2052. ║Scale2  ║....|....|....|....|....|....|....|....|....|....|....|....|....|....║
  2053. ╚════════╩═════════════════════════════════════════════════════════════════════╝
  2054. ▓ Enter Column Info ▓ Ctrl+N/U-Ins/Del ▓ PgUp/PgDn-Prev/Next ▓ ESC-Abort ▓
  2055.  
  2056.  
  2057.     Column Heading:
  2058.     Enter  up  to  four  column  heading  lines  in  this  area, up to a maximum
  2059.     width of 80 characters each.
  2060.  
  2061.     Contents:
  2062.     A  valid  Clipper  expression,  you  may  use  functions,  memory  variables
  2063.     (remember  to  put  them  in  your  program), database fields, quoted liter-
  2064.  
  2065.                                       <33>
  2066.                           The Aeolus BREPORT User Manual
  2067.  
  2068.  
  2069.  
  2070.  
  2071.     als or any combination as long as you create a valid expression.
  2072.     MAIN MENU OPTION COLUMNS
  2073.  
  2074.     Data Type:
  2075.     The data type the expression will be, can be:
  2076.     C - Character
  2077.     N - Numeric
  2078.     D - Date
  2079.     L - Logical
  2080.     (Memo fields are not allowed)
  2081.  
  2082.     Width:
  2083.     Enter the total width the field will occupy on the report.
  2084.  
  2085.     Decimal:
  2086.     If the Data Type is Numeric, you may enter  the  number  of  decimal  places
  2087.     the number on the report will occupy.
  2088.  
  2089.     Total/Average/None.
  2090.     If  the  Data  Type  is  specified  as Numeric you may optionally enter T to
  2091.     total this column  or  A  to  average  the  column,  otherwise  enter  N  to
  2092.     disregard.
  2093.  
  2094.     Note:  if  any  column  contain  totals  report  grand  totals are automati-
  2095.     cally accumulated  and  these  columns  will  be  printed  on  any  subtotal
  2096.     lines.
  2097.  
  2098.     Press Ctrl+U to delete the column you are editting.
  2099.  
  2100.     Press  Ctrl+N  to  insert  a  new  column  ahead of the column you are edit-
  2101.     ting.
  2102.  
  2103.     Press ESC to exit,  when  the  column  dialog  box  is  cleared  the  report
  2104.     view area will be updated displaying any changes made to the report.
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.                                       <34>
  2125.                           The Aeolus BREPORT User Manual
  2126.  
  2127.  
  2128.  
  2129.  
  2130.     A WORD ABOUT GENERATED SOURCE
  2131.  
  2132.     ALL REPORTS:
  2133.  
  2134.     Source  code  for  reports  is  generated with each report as a single self-
  2135.     contained procedure.
  2136.  
  2137.     Before the main report loop (default is  a  DO  WHILE  !EOF())  there  is  a
  2138.     section 
  2139.     where report variables are initialized.
  2140.  
  2141.     The  initialization  section  of  column  and  freeform  type  reports  will
  2142.     contain three report memory variables:
  2143.     RPG     is the report page counter,  I  like  to  print  this  as  the  page
  2144.     number
  2145.     on report headings.
  2146.     RPG_LEN is used to set the aproximate lines on the printed page.
  2147.     NEW_PAG is a logical variable used when subtotals are to eject a page.
  2148.  
  2149.     The  initialization  section  of  label  reports  will contain three differ-
  2150.     ent report memory variables:
  2151.     LBL_ACRSS is the number of labels across a page to print.
  2152.     LBL_WDTH  is the number of characters each label is wide.
  2153.     LBL_LEN   is the number of lines each label is long.
  2154.  
  2155.     Two other memory variables may be used  in  the  initialization  section  if
  2156.     you uncomment them:
  2157.     OTHM    old thermometer, compared to see if it has changed.
  2158.     RECS    thermometer variable to count records processed.
  2159.  
  2160.     There  is  a  section  of  code  generated  at  the start of the main report
  2161.     loop that is commented out.  This  code,  if  uncommented,  will  display  a
  2162.     progression  thermometer  on  the  screen  as  the report prints.  The ther-
  2163.     mometer should only be used if the report  loop  spins  through  the  entire
  2164.     database, otherwise the report will finish before the thermometer.
  2165.  
  2166.     After  the  thermometer  code  an  IF  construct  traps the ESC key and dis-
  2167.     plays a dialog box which asks if the report should be aborted.
  2168.  
  2169.     Following the ESC  key  trap  is  the  comment  '**  SKIP/LOOP  from  here'.
  2170.     Immediately  after  this  line  is  a  good  place to put IF constructs that
  2171.     filter database records that do not get  printed.   I  usually  do  not  use
  2172.     the  SET  FILTER  TO  ...  command  in  reports because with a SET FILTER TO
  2173.     ... active the thermometer does not work properly.
  2174.  
  2175.  
  2176.     ABOUT COLUMN REPORT SOURCE CODE:
  2177.  
  2178.     Not including the items contained under 'ALL REPORTS'.
  2179.  
  2180.     Column reports contain at  least  two  and  as  many  as  six  primary  sec-
  2181.     tions, these are, in the order they appear in the code:
  2182.  
  2183.                                       <35>
  2184.                           The Aeolus BREPORT User Manual
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.     Section Name                      Location in Source       Required
  2193.     --------------------------------  -----------------------  ------------
  2194.     Subtotal Variable Initialization  Before Main Report Loop  Not Required
  2195.     Report Heading                    In Main Report Loop      Required
  2196.     Subtotal Checking and Printing    In Main Report Loop      Not Required
  2197.     Report Detail Line Printing       In Main Report Loop      Required
  2198.     Subtotal Variables Incremented    In Main Report Loop      Not Required
  2199.     Subtotal and Total Printing       After Main Report Loop   Not Required
  2200.  
  2201.     The  required  items  will  always  appear in the generated source code.  In
  2202.     the case of Column reports the  not  required  items  appear  only  if  col-
  2203.     umns  are  selected  to  be  totaled  or averaged.  Only as much source code
  2204.     as is  needed  will  be  created,  so  the  amount  reports  vary  is  quite
  2205.     limitless.   Keep  in  mind  that  the  'core'  logic  of  most reports will
  2206.     need to be modified  as  all  reports  are  in  a  simple  DO  WHILE  !EOF()
  2207.     loop.
  2208.  
  2209.     ABOUT LABEL REPORT SOURCE CODE:
  2210.  
  2211.     The  generated  label  source  code  is  a very forgiving piece of code, the
  2212.     three variables  noted  above  provide  enough  flexibility  to  make  minor
  2213.     adjustments without major difficulty.
  2214.  
  2215.     Label  source  is  nearly  identical  for  each  one that is generated.  The
  2216.     major sections are:
  2217.  
  2218.     Section Name             Where Located            Required
  2219.     -----------------------  -----------------------  ------------
  2220.     Label Alignment Testing  Before Main Report Loop  Required
  2221.     Label Variable Loading   In Main Report Loop      Required
  2222.     Label Printing           In Main Report Loop      Required
  2223.  
  2224.     If you  are  printing  to  a  laser  printer  it  is  usually  advisable  to
  2225.     delete  the  whole  'Label  Alignment  Testing' section of code.  Except for
  2226.     that only database filtering code should be required.
  2227.  
  2228.     ABOUT FREEFORM REPORT SOURCE CODE:
  2229.  
  2230.     Freeform report source code  is  identical  to  column  report  source  code
  2231.     except that total and subtotal code is never present.
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.                                       <36>
  2243.