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