home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 9 / CDACTUAL9.iso / progs / CB / _SETUP.LIB / READRS.TXT < prev    next >
Encoding:
Text File  |  1996-06-07  |  8.7 KB  |  237 lines
  1. REPORTSMITH 3.02 FOR WINDOWS 95 AND WINDOWS NT RELEASE NOTES
  2. ------------------------------------------------------------------
  3.  
  4. TABLE OF CONTENTS
  5. ----------------------------------------
  6. 1.  GETTING HELP
  7. 2.  WHAT'S NEW 
  8. 3.  SUPPORTED CONNECTIONS
  9. 4.  DEMOS
  10. 5.  KNOWN PROBLEMS
  11. 6.  CHANGES
  12. 7.  DELPHI DATA CONNECTION
  13. 8.  INTERNATIONAL ISSUES
  14.  
  15. 1.  GETTING HELP
  16. -----------------
  17. For the latest technical information on ReportSmith please visit:
  18. o  Web Site http:\\www.borland.com
  19. o  FTP Site ftp.borland.com
  20. o  Compuserve Forum (Go Borland, BDEVTOOLS Forum, Section 7)
  21. o  Tech Fax service at (800) 822-4269.
  22.  
  23. For the complete guide to Borland's support offerings please 
  24. reference the assist brochure in the box.
  25.  
  26. 2.  WHAT'S NEW IN 3.02
  27. --------------------------
  28. The following areas of this version are different from 
  29. ReportSmith 2.5.
  30.  
  31. o  Fully 32 bit.
  32. o  Win95 common controls.
  33. o  Long file names and Universal Naming Convention
  34. o  Delphi data connection.
  35. o  CTLib native connection.
  36. o  Improved data access performance and true multitasking.
  37. o  MAPI Send Mail.
  38. o  C API for controlling ReportSmith from other applications.
  39. o  Updated connection to the 32 bit Borland Database Engine.
  40. o  Fewer dll's for easier deployment.
  41. o  New documentation and on-line help.
  42.  
  43. The following areas of this version are different from
  44. ReportSmith 3.0
  45.  
  46. o  Performance improvements in the data acquisition and crosstab 
  47.    areas.  Improvements are very apparent when dealing with large 
  48.    crosstabs.
  49. o  Support for reading data dictionaries.
  50. o  Install program updates.
  51. o  On-line help file updates.
  52.  
  53. 3.  SUPPORTED CONNECTIONS
  54. -------------------------
  55. o  Delphi 2.0
  56. o  32 bit ODBC*
  57. o  dBASE
  58. o  Paradox
  59. o  Oracle
  60. o  Interbase (via BDE SQL Link) 
  61. o  Sybase (including System10 via CTLib)
  62. o  MS SQL Server
  63. o  DB2 (via gateway)
  64. o  Terradata (via dblib) 
  65. o  AS/400 (via ODBC)
  66.  
  67. *IMPORTANT*: 32 bit applications cannot use 16-bit ODBC drivers.
  68. All current ODBC connections will need to be upgraded to 32-bit or 
  69. migrated to Delphi connections or BDE connections.  When opening a 
  70. report with an obsolete connection ReportSmith will prompt the user 
  71. for the name of the new connection.  For simple migration use the 
  72. same ODBC Data Source Name.  
  73.  
  74. ODBC drivers are available separately from companies such as 
  75. Intersolv, Microsoft, or from the database vendor.
  76.  
  77. 4. DEMOS
  78. -------------------------
  79. The ..\RPTSMITH\DEMOS directory contains several sample reports.
  80.  
  81. o  SMPSALE.RPT - grouping, sorting, derived fields, and summary
  82.    fields
  83. o  FORM.RPT - single page invoice type reporting
  84. o  SUMMARY.RPT - grouping, formatting, and calculated fields
  85. o  TRANSACT.RPT - master detail reporting
  86. o  MAIL_LBL.RPT - mailing labels
  87. o  DPHIDATA.RPT and DELPHIRS.DPR - Delphi project using the
  88.    Delphi Data connection and the companion ReportSmith report.
  89. o  MACRO.RPT - report variables and conditional formatting using 
  90.    macros
  91. o  CROSST.RPT - Crosstabs
  92.  
  93. 5.  KNOWN PROBLEMS
  94. -------------------------
  95. General
  96.  
  97. o  If a report is changed to user entered SQL and modifications
  98.    are made such that an error is generated, canceling and
  99.    returning to the report query will result in the query being
  100.    disconnected from the report surface.  This may have unpredictable
  101.    results.
  102.  
  103. o  Sorting, summing, or other field type actions on an OLE object 
  104.    may result in a protection fault.
  105.  
  106. o  If a report contains OLE objects, repeated saving and deleting/
  107.    adding of the OLE objects in the report will result in the RPT 
  108.    file growing significantly in size.  
  109.  
  110. o  If a report is created in Draft mode, running that report in
  111.    the runtime product will still display the 'Draft' watermark on
  112.    the report.  To workaround this save the report in Presentation 
  113.    mode.
  114.  
  115. o  Occasionally, when pasting into the page header, borders are lost
  116.    until another cut or copy is done to the clipboard.  Going into
  117.    the Format|Border dialog, selecting the border, and hitting OK
  118.    does display it.
  119.  
  120. Macros
  121.  
  122. o  Report macros linked to the 'On SQL Error' or 'Before SQL 
  123.    Execution' events may execute multiple times.  Checks should be
  124.    made in a macro to ensure that this does not lead to undesired
  125.    results.
  126.  
  127. o  Variable names cannot use any extended character as the first 
  128.    character
  129.  
  130. Master/Detail
  131.  
  132. o  Group Footers in a master/detail report may display data from 
  133.    the previous footer.
  134.  
  135.  
  136. 6.  CHANGES SINCE REPORTSMITH 2.5
  137. ---------------------------------
  138. o  There are changes to the Macro Menu Modification. Macros which
  139.    were linked to the Application Startup event may need to be
  140.    updated as they are now executed after menu creation.  NoReport
  141.    menus may now be modified also.  When a macro that modifies
  142.    the menu is executed, the current menu is modified. That
  143.    menu is either the active ReportSpecific menu or the NoReport menu.
  144.    A special character in the first position of the AfterMenu argument
  145.    indicates that a menu other than the current one will be
  146.    modified. If the flag is an exclamation point(!), then the 
  147.    DefaultReport menu will be modified and thus every ReportSpecific 
  148.    menu created after will be affected.  The current menu will not be 
  149.    affected. If the flag is an asterisk(*), then the NoReport menu is 
  150.    modified.  If this is the current menu, it will be redrawn.
  151.  
  152. o  Because of the uncertainty of licensing, support for handling GIF 
  153.    and TIFF pictures has been removed.
  154.  
  155. o  The RPTSMITH.INI setting that allows the sharing of the user's 
  156.    custom report styles (and location) has been renamed.  The new ini 
  157.    setting is ReportStylesPath32 and it is in the [ReportSmith] 
  158.    section. The old name ReportStylesPath is still used for 16 bit 
  159.    versions of Reportsmith.  
  160.    *IMPORTANT* These settings MUST point to different directories.
  161.  
  162. o  Only installed connections are listed in The Table Open dialog. 
  163.    Look in RS_SQLIF.TXT for more info.
  164.  
  165. o  BDE alias changes are reflected in RS named connections and saved 
  166.    reports.
  167.  
  168. o  To access the time portion of a TimeStamp data type from within
  169.    a macro, use the Field$(...) function in the same manner that the 
  170.    Format(...) function is used.  You supply the desired format as 
  171.    the second parameter to Field$(...).  
  172.  
  173.    For example:
  174.    Military Time Format:
  175.    Field$("TTimeStamp", "MM/DD/YY HH:SS:MM")
  176.  
  177. 7. Delphi Data Connection
  178. ---------------------------
  179. ReportSmith 3.0 and Delphi 2.0 can now share a connection to a 
  180. database.  This means users can use a Delphi TQuery or TTable as a 
  181. data source.  This places control of the report content on the Delphi
  182. side where it can be easily changed.  In order to initiate this kind 
  183. of connection, perform the following steps:
  184.  
  185. o  Prepare a Delphi form with any combination of active TTable 
  186.    or TQuery objects.
  187.  
  188. o  Place the Treport component from the Data Access page on the
  189.    same form.
  190.  
  191. o  Right Click on Treport and choose Edit Report.  This will launch
  192.    ReportSmith into the design environment.
  193.  
  194. o  Press the new report button on the far left of the toolbar.
  195.    Choose the type of report.
  196.  
  197. o  Press the Add Table button, and choose the Delphi type connection
  198.    from the drop down list in the lower left.  Press Server Connect.
  199.    Choose the name of the dataset component from Delphi. Press Done.
  200.  
  201. o  Rearrange and format the data coming from Delphi in any manner.
  202.    Save the report.  Close ReportSmith and return to the Delphi IDE.
  203.  
  204. o  Set the Report Name property of Treport to the new report name.
  205.    Place a button on the form.  Attach the code Report1.run; to the
  206.    OnClick event.
  207.  
  208. o  Run the Delphi application and press the button.  This will
  209.    launch the ReportSmith Runtime environment and show the contents
  210.    of the report.
  211.  
  212. 8. International Issues
  213. ----------------------------
  214. o  To enable OEM<==>ANSI character translation for a native SQL ORACLE
  215.    connection, update the RS_SQLIF.INI to include:
  216.    
  217.    [Oracle]
  218.    LD=ldname
  219.    
  220.    ldname is the name of the language driver used to perform the
  221.    translation. See BDECFG online help or The Borland SQL Link User's
  222.    Guide for a list of language driver names.
  223.  
  224. o  To enable OEM<==>ANSI character translation for a native SQL Server 
  225.    type connection including Sybase and Sybase 10, update the 
  226.    RS_SQLIF.INI to include:
  227.    
  228.    [SQL Server]
  229.    LD=ldname
  230.  
  231. o  To enable generation of SQL that conforms to that of a server 
  232.    configured for a localized date format update the appropriate 
  233.    RS_SQLIF.INI section to include a DateTimeFormat specification. For 
  234.    a server expecting dates in dd/mm/yyyy format the following line 
  235.    would be added to the appropriate connection section:
  236.    DateTimeFormat=""'"dd\/mm\/yyyy hh:mm:ss"'""
  237.