home *** CD-ROM | disk | FTP | other *** search
/ Microsoftware Monthly 19…2 Programming Power Tools / MASO9512.ISO / readme / reports.txt < prev    next >
Encoding:
Text File  |  1995-10-24  |  4.9 KB  |  111 lines
  1.  This file contains information that was not available for the
  2.  final versions of the product publications. The information in this
  3.  file applies to :
  4.  
  5.  VisualAge for Smalltalk Reports for OS/2 and for Windows
  6.  
  7.  1. Deleting a Field Break's watch field can cause problems
  8.  
  9.     EXPLANATION:
  10.     ------------------------
  11.  
  12.     When building a report using field breaks, DO NOT delete the watch
  13.     field for a break.  To delete a break, use the "Remove field
  14.     break..."  menu option.  Deleting the watch field will cause a
  15.     walkback during testing like:  "AbtExternalSubpartBuilder does not
  16.     understand coElement."  During runtime, it will cause the break to
  17.     never be triggered.
  18.  
  19.  2. Missing source code for private methods of some classes in Professional.
  20.  
  21.     EXPLANATION:
  22.     ------------------------
  23.  
  24.     After loading the Report feature into the Professional or Professional Client image,
  25.     you may notice that the source for some prerequisite classes of the Report feature
  26.     are not available.  To see the source, you can import and load version V 3.0.1 of
  27.     AbtReportRun:
  28.  
  29.         1. From the Configuration Map Browser, import AbtReportRun version V 3.0.1
  30.                 from the file ABTTRW30.DAT in the readme\fileins subdirectory.
  31.  
  32.         2. From the Configuration Map Browser, load AbtReportRun version V 3.0.1
  33.                 into your image.
  34.  
  35.  3. The Catalog of Classes report sample cannot be packaged
  36.  
  37.     EXPLANATION:
  38.     ------------------------
  39.  
  40.     The Catalog of Classes report includes references to class and
  41.     application info which is not available at runtime, such as the
  42.     owner of a class or app, and edition information.  This makes it
  43.     impossible to package and run this report as a runtime
  44.     application.  The IconViewer example from the Sample App can be
  45.     packaged instead.
  46.  
  47.  
  48.  4. The Catalog of Classes report sample cannot be be run in Standard
  49.  
  50.     EXPLANATION:
  51.     ------------------------
  52.  
  53.     The Catalog of Classes report includes references to class and
  54.     application information which is not available in the Standard version,
  55.     such as the owner of a class or app, and manager information.
  56.  
  57. Other known workarounds:
  58.  
  59. * During packaging, you can ignore the following problems:
  60.  
  61.   [2] AbtAccumulator class>>IS_average - No implementor of #average:
  62.   [2] AbtReportShell>>unitTypeSelected - No implementor of #defaultUnitType
  63.   [2] AbtShellView>>ownerWidget - No implementor of #defaultUnitType
  64.   [2] PositionableStream>>featuresAffectedByAction: - No implementor of #iterate
  65.  
  66.  
  67. * In VisualAge for Smalltalk, Standard, when you get to the Composition Editor to
  68.    see the examples in the sample applications, the Report Viewer and the Report
  69.    Shell may be overlapped.  Drag the Report Shell to the right of the Report Viewer.
  70.  
  71.    If you drag the Report Viewer instead, the Report Viewer will be displayed
  72.    too far to the right at run time.
  73.  
  74. * If you enter a Tab in a Report Text Field, a funny character will display in the field
  75.    during edit time.  At run time, it will be translated to a tab.
  76.  
  77. Tips for using scripts to calculate fields:
  78. * Scripts which are called via attribute to script connections may be called
  79.    before any queries or data initialization has been done.  Therefore you
  80.    code these scripts to handle nil values from uninitialized parts, and you should
  81.    use the "More dependencies..." feature of the attribute-to-script connection's
  82.    settings to make sure the field is recaclulated when the appropriate data
  83.    has been updated.
  84.  
  85. * To set multi-line text in a ReportField from a script, insert a backslash in the
  86.    string where you want a line break, and use the method #addLineDelimiters
  87.    to get the correct line delimiter inserted.
  88.  
  89.  
  90. Tips for reporting on multi-row query results:
  91. * ALWAYS check the "Enable packeting" checkbox on the "Fetch" page of the
  92.    query's settings notebook.  If this is not checked, the first row of data may
  93.    be pre-fetched and will be skipped when the report is formatted.
  94.  
  95. * ALWAYS check the "Read-Only" checkbox on the "Update" page of the
  96.    query's settings notebook.  Checking this will improve query performance
  97.    and prevent possible locking problems.
  98.  
  99. * Override finalInitialize in your part to set query host-variables
  100.    for your primary query.  Setting them via a connection from "aboutToFormat"
  101.    might set the host variable after the query has already been run.
  102.  
  103. * The users owning and managing the classes in AbtRunReportApp and
  104.    AbtEditReportApp will appear as 'Missing user' due to a packaging problem.  If
  105.    you encounter problems trying to create a new edition of these apps,
  106.    or get a walkback running the CatalogOfClassesReport, run the following
  107.    snippet to recreate the missing users:
  108.         EmUser uniqueName: 'srich' fullName: 'srich' networkName: 'srich'.
  109.         EmUser uniqueName: 'jenny' fullName: 'jenny' networkName: 'jenny'.
  110.  
  111.