home *** CD-ROM | disk | FTP | other *** search
/ PC Format Collection 48 / SENT14D.ISO / tech / delphi / disk1 / readrs.pak / READRS.TXT
Encoding:
Text File  |  1995-08-24  |  12.8 KB  |  329 lines
  1.  
  2.  
  3. ReportSmith Version 2.5.2 Release Notes
  4. =====================================================================
  5.  
  6. Contents
  7. I.    New Features in this Version
  8. II.   Borland Database Engine (BDE) Installation Notes
  9. III.  BDE Driver for InterBase and Informix
  10. IV.   ODBC Installation Notes
  11. V.    BDECFG.EXE and BDE Connections for Paradox
  12. VI.   Customizing Sorting
  13. VII.  Warnings and Known Problems
  14. VIII. International Issues
  15. IX.   Changes since last version
  16. =====================================================================
  17.  
  18. I. New Features in this Version
  19.  
  20. ReportSmith 2.5 introduces new features to create more types of reports, as
  21. well as to simplify building reports.
  22.  
  23. This version allows you to perform the following tasks:
  24. -Create master/detail reports to combine multiple reports in one using
  25.  heterogenous data.
  26. -Choose to group, sort or summarize data locally or on a database server.
  27. -Access data using Borland's BDE drivers.
  28. -Include columns in a report for query-only or value-only.
  29. -Utilize an updated ReportBasic macro language.
  30. -Place page totals to display summary values for each page in a report.
  31. -Create data dictionaries to use with the PC or SQL versions of ReportSmith,
  32.  to simplify the view of the data.
  33.  
  34.  
  35. Undocumented New Features
  36. -------------------------
  37.  
  38. A. Source Database Name Editor
  39. ------------------------------
  40.  
  41. The Data Dictionary administrative tool now contains a Source Database
  42. Name Editor. The feature allows you to edit the name assigned to database
  43. sources within Data Dictionary views. To edit database source names,
  44. follow these steps:
  45.  
  46. 1. Choose File|Edit source database names and the Source Database
  47.    Editor dialog box appears.
  48.  
  49. 2. Select the dictionary on which you want to change the source name. If
  50.    the dictionary was created on a local database such as dBASE or Paradox,
  51.    the source names will be displayed. If the dictionary was created on
  52.    a remote database, you must first log in to the database before the
  53.    source is displayed.
  54.  
  55. 3. Select the source name that you want to edit and enter the new name
  56.    in the Add New Source Database Name edit box.
  57.  
  58. 4. Press Rename and the new source name appears in the source list.
  59.  
  60. 5. Press Done.
  61.  
  62. B. Preloading Records
  63. ---------------------
  64.  
  65. ReportSmith now offers the option of preloading records in the
  66. Tools|Options dialog box. When the Preload Records option is unchecked
  67. ReportSmith loads only the number of records necessary for display.
  68. When checked, this option will load all records in a query. When performing
  69. queries with multiple modifications this option may be preferable.
  70.  
  71.  
  72. C. New local SQL String Functions for BDE
  73. ------------------------------------------
  74.  
  75. Two string functions are now available: upper and lower. The following
  76. example shows their use. These can be used in either the Selection criteria
  77. or Derived Fields.
  78.  
  79. select *
  80. from customer
  81. where upper(Name) = "TODD JONES"
  82. =======================================================================
  83.  
  84. II. Borland Database Engine (BDE) Installation Notes
  85.  
  86. Note: The Borland Database Engine (BDE) may be referenced as IDAPI
  87. in some parts of the product and documentation.
  88.  
  89. ReportSmith automatically installs the BDE drivers for dBASE and Paradox.
  90. The BDE drivers support the following Borland table types:
  91.  
  92. - dBASE for DOS types 3 (III) and 4 (IV)
  93. - dBASE for Windows type 5 (5.0)
  94. - Paradox for DOS types 3 (version 3.5) and 4 (version 4.0)
  95. - Paradox for Windows type 5 (version 5.0)
  96.  
  97. Note: ReportSmith does not currently support the new data types BLOB.
  98.  
  99. You can still use ODBC drivers to connect to dBASE table types 3 (III)
  100. and 4 (IV) and Paradox table types 3 (version 3.5) and 4 (version 4.0).
  101.  
  102. ======================================================================
  103.  
  104. III. BDE Driver for InterBase and Informix
  105.  
  106. ReportSmith requires the appropriate BDE drivers and Borland's
  107. SQL Links to connect to an InterBase and Informix data sources.
  108. ReportSmith will recognize InterBase and Informix data sources
  109. during the install.  Use the BDE configuration utility (BDECFG.EXE)
  110. to configure and set up additional InterBase and Informix aliases.
  111.  
  112. =======================================================================
  113.  
  114. IV. ODBC Installation Notes
  115.  
  116. During the ReportSmith installation you can choose to install the
  117. ODBC 1.0 drivers that are shipped with the product. If these drivers
  118. are newer than the drivers you have installed on your machine, the install
  119. will overwrite them.  Otherwise, the install program will not overwrite
  120. your existing ODBC drivers.
  121.  
  122. The ReportSmith installation also creates data source names for each
  123. ODBC driver that you choose to install.  Each name is given the prefix
  124. RS_ followed by the database name (e.g.  RS_dBASE.)  These names appear
  125. in the data type list in ReportSmith.  If you do not wish to keep these
  126. data source names, you can easily delete or rename them through the ODBC
  127. administrator located in the Windows Control Panel.
  128.  
  129. This version of ReportSmith supports Microsoft ODBC 1.0 and 2.0 drivers.
  130.  
  131. ========================================================================
  132.  
  133. V. BDECFG.EXE and BDE Connections for Paradox
  134.  
  135.  -    ReportSmith will not correctly build Paradox SQL if the location of
  136.       the NETDIR item of the BDECFG.EXE is incorrect or missing.
  137.  
  138.       To correct or enter the NETDIR setting, select Paradox in the Driver
  139.       Name list box in the BDE Configuration Utility, browse to locate the
  140.       pdoxusrs.net file. Ask your Systems Administrator if you're unsure
  141.       of the location of this file. After selecting a valid directory for
  142.       this file, press return and File | Save before exiting the BDE
  143.       Configuration Utility.
  144.  
  145.  -    You should also set the Paradox Network Control File Path in the
  146.       Paradox Engine Network Configuration utility (PXENGCFG.EXE), and
  147.       a valid User Name.
  148.  
  149.  -    If you are running Paradox in a Network environment and want to
  150.       share data files, then all users MUST set the same Network Control
  151.       File Path.  See HELP in PXENGCFG.EXE.
  152.  
  153. ========================================================================
  154.  
  155. VI. Customizing Sorting
  156.  
  157. With this version of ReportSmith, sorting is performed locally whenever
  158. possible. ReportSmith automatically determines whether sorting should
  159. occur locally or on the server based on available memory or disk space.
  160.  
  161. To disable local sorting, put the following entry into the [OptionsSection]
  162. of the RPTSMITH.INI:
  163.  
  164. LocalSort=0
  165.  
  166. ========================================================================
  167.  
  168. VII. Warnings and Known Problems
  169.  
  170.   a.  When connecting to InterBase through BDE, each InterBase server and
  171.       each userID must have a separate alias.
  172.  
  173.   b.  Best fit cannot be performed on fields in headers.
  174.  
  175.   c.  Text and FoxPro ODBC drivers cannot be used as a data source in a
  176.       named connection.
  177.  
  178.   d.  Some third party components may not be available under Windows95
  179.       for client/server connectivity. Check with your third party vendors
  180.       for availability.
  181.  
  182.   e.  The new Microsoft ODBC 2.0 text driver does not support file names
  183.       with extensions. To open text files, either rename the files so
  184.       they do not have extensions, or within ReportSmith, use table aliases.
  185.  
  186.   f.  For Oracle connections, if using any lowercase for column or table names,
  187.       then put the following entry into the RS_SQLIF.INI under the [Oracle]
  188.       section:
  189.  
  190.       IDQUOTE="
  191.  
  192.  
  193.   Data Dictionary
  194.   -----------------
  195.   a.  ODBC and BDE connections for dBASE are treated as entirely different
  196.       connections by the Data Dictionary, as are Paradox ODBC and BDE
  197.       connections.
  198.  
  199.   b.  If a Data Dictionary view is created with a drive or directory mapping
  200.       in a source database that is different than the connection with which
  201.       it is associated in ReportSmith, the dictionary view will not be
  202.       applied. To apply the view, create an additional source database within
  203.       the first view, or create an additional view.
  204.  
  205.   c.  Apostrophes are not permissable in the name of a Data Dictionary view.
  206.  
  207.   d.  InterBase columns that have the same name as the table (such as
  208.       Country.Country) cannot be included in a Data Dictionary after an
  209.       exclude all is performed, and vice versa.
  210.  
  211.   e.  Data Dictionaries cannot be created in dBASE using the Microsoft
  212.       ODBC 2.0 dBASE driver. NOTE: Entries in a data dictionary can refer to
  213.       the 2.0 driver.
  214.  
  215.   f.  Database grouping does not function properly using data dictionaries.
  216.  
  217.  
  218.   Macro Language
  219.   ---------------
  220.   a.   The CloseReport and CloseRS commands will no longer return non-zero if
  221.        the user selects Cancel when prompted to save a report. The functions
  222.        will now return zero when executed successfully, or non-zero on error,
  223.        (such as no report open for the CloseReport command).
  224.  
  225.   b.   Str2Date, Date2Str, and DateField are now obsolete commands. These
  226.        commands are still supported for compatibility. The new Date/Time
  227.        commands should be used in place of these commands.
  228.  
  229.   c.   It is not valid to use the LoadReport command in the "Before Report
  230.        Open" event or the "After Report Open" event.
  231.  
  232.   d.   The LoadReport command cannot be used to initialize report variables
  233.        in the detail section of a master/detail report.
  234.  
  235.   e.  To disable a menu item for all reports, execute the macro command to
  236.       enable macros in the Application Startup event, or, place a '!' before
  237.       the menu to be disabled.
  238.  
  239.       For example: EnableMenu "!File|New"
  240.  
  241.   f.  SelectReport cannot be run from the macro dialog box.
  242.  
  243.  
  244. ========================================================================
  245.  
  246. VIII. International Issues
  247.  
  248.  
  249. A. To enable OEM<==>ANSI character translation for a native SQL ORACLE
  250.    connection, update the RS_SQLIF.INI to include:
  251.  
  252. [Oracle]
  253. LD=ldname
  254.    where ldname is the name of the language driver used to perform the
  255.    translation. See BDECFG online help or The Borland SQL Link User's
  256.    Guide for a list of language driver names.
  257.  
  258.  
  259. B. To enable OEM<==>ANSI character translation for a native SQL Server type
  260.    connection including Sybase, update the RS_SQLIF.INI to include:
  261.  
  262. [SQL Server]
  263. LD=ldname
  264.    where ldname is the name of the language driver used to perform the
  265.    translation. See BDECFG online help or The Borland SQL Link User's
  266.    Guide for a list of language driver names.
  267.  
  268.  
  269. C. To enable generation of SQL that conforms to that of a server configured
  270.    for a localized date format update the appropriate RS_SQLIF.INI section to
  271.    include a DateTimeFormat specification. For a server expecting dates in
  272.    dd/mm/yyyy format the following line would be added to the appropriate
  273.    connection section:
  274.  
  275.    DateTimeFormat=""'"dd\/mm\/yyyy hh:mm:ss"'""
  276.  
  277. ========================================================================
  278.  
  279. IX.  Changes since 2.5.1
  280.  
  281. A.  BDE aliases are now available for use in the connections type combobox.
  282.     The information for the alias is read from the IDAPI.CFG file, and
  283.     fields such as Server Name and User Name are filled in
  284.     automatically.
  285.  
  286. B.  Negative money fields for SQL Server are now displayed correctly.
  287.  
  288. C.  Improved speed of record retrieval for all databases.
  289.  
  290. D.  Crosstab currency formatting in a style remains constant.  For
  291.     example, a report with a crosstab created in the US with $ that is
  292.     sent to another country will retain the $ format.  It will not
  293.     change to the local currency format that's set in the control panel.
  294.  
  295.     NOTE: the date/time format and decimal seperator will change to reflect the
  296.     current control panel setting.
  297.  
  298. E.  The macro dataset object Connect now properly recognizes named
  299.     connections.
  300.  
  301. F.  Fixed GPF with dragging columns to a header/footer, then deleting
  302.     the header/footer, and inserting that field again.
  303.  
  304. G.  Fixed problem with GDI memory leak after printing reports. For example,
  305.     printing the same report 50 times in a single ReportSmith session
  306.     would cause GDI memory to decrease significantly.
  307.  
  308.  
  309. H.  A new Oracle setting was added to ReportSmith so that it will not qualify
  310.     synonymns with its owner in the SQL statment.
  311.  
  312.     Add the following item in the [Oracle] section of the RS_SQLIF.INI:
  313.     QualifySynonymsWithOwners=0
  314.  
  315. I.  In the RunTime product, can now enable/disable toolbar buttons
  316.     from the macro language.
  317.  
  318. J.  In the RunTime product, reports will never come up in draft mode.
  319.  
  320. K.  Fixed problem with custom sort order in a crosstab with international
  321.     numeric format.
  322.  
  323. L.  Fixed display problem when 2 graphs are in the same section.
  324.  
  325. M.  Macros linked to the "Before SQL is Executed" application event will
  326.     now execute.
  327.  
  328. ========================================================================
  329.