--- ibx/trunk/changelog 2018/02/27 11:20:19 151 +++ ibx/trunk/changelog 2020/04/17 11:30:36 292 @@ -1,7 +1,360 @@ -IBX Change Log version (2.2-0) Mon, 26 Feb 2018 11:49:23 +0000 +IBX Change Log version (2.3-4 Build 12031) Fri, 17 Apr 2020 11:21:22 +0100 + +1. TIBXDataSet and Generators: Generator Names that are not all upper case or + not SQL Identifiers are now supported. + +2. TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is + passed to the Firebird engine for execution. + +3. TIBDataSet: Unidirectional datasets now give an error message if an attempt + is made to scroll back. + +4. New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf + +5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now + only enclosed in double quotes in SQL dialect 3 and when it needs to be. + +6. TIBLookupComboEditBox: when the list source opens, the ListField name is now + validated. If no match is found in the list of field names and the database has + been opened in SQL Dialect 3, then the ListField Name is converted to upper case + if it then matches a field name. Otherwise, a Listfield not valid exception occurs. + +7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance + with fpc 3.2. + +IBX Change Log version (2.3-3 Build 11512) Fri, 28 Dec 2018 10:04:17 +0000 + + +1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides" + and is used to override the default settings in the client side "firebird.conf" This + includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings". + Each line of the string list should be a setting in the same format as "firebird.conf". + For example "WireCompression = true" in order to request wire compression on the client side. + + Note: explicit settings in the client side "firebird.conf" appear to take precedence + over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings + also require a compatible setting in the server side "firebird.conf". For example + "WireCompression = true" must also be set in the server's "firebird.conf" for wire + compression to be used. + + Whether or not WireCompression or WireCrypt are in use can be checked using the information + returned with the Client/Server protocol version. See ibx/examples/dbadmin and + ibx/examples/dbinfo for examples of how to display this information. + +2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This + is a "convenience" property. If set the "WireCompression=true" is added to the + ConfigOverrides. If unchecked then this setting is removed. + +3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and + not "INT64". + +4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut + These are: + property TimestampFormat: string; + property DateFormat: string; + property TimeFormat: string; + + Respectively, these provide the date time format templates for SQL types: TIMESTAMP, + DATETIME and TIME. The format strings use the standard FPC date/time format + characters (see https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html). + + If any of the above properties are set to an empty string, then the locale default + is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the + locale default is extended by appending '.zzz' to include milliseconds. + + TIBCSVDataOut by default sets these properties to the empty string, while the other + two use: 'yyyy.mm.dd hh:nn:ss.zzz', 'yyyy.mm.dd' and 'hh:nn:ss.zzz' respectively. + +5. New published property for TIBCSVDataOut: + property QuoteStrings: boolean (default true) + + If false then strings are unquoted, otherwise, the QuoteChar property value is + used to delimit each and every string in the output. + +6. New published properties for TIBCSVDataOut: + property FieldSeparator: string; + property HeaderSeparator: string; + + Respectively, these provide the separator character(s) used to separate fields + in data and header rows. Both default to ','. + +7. New published properties for TIBCSVDataOut and TIBBlockFormatOut: + TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object; + property OnFormatTextString; + + This event handler can be used to process text strings before they are included + in the output e.g. to replace unprintable characters with alternative strings. + This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT. + +8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name. + Uses "FindParam" if in order to find out if a parameter with a given name exists + and without raising and exception if it does not. + +9. TIBQuery now uses IBX SQL Parser instead of the TParams SQL parser in order to ensure + consistency with SQL queries. + +10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery. + When true, SQL statement parameter names are parsed case sensitive. Note for + TIBDataSet only applies to Select query. + +11. IBEvents: removing a TIBEvent component from a form should no longer result in + an IDE exception. + +12. LocalDBSupport: initial database creation should now work correctly + when the schema source is an sql file. + +13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent" + when defined, this handler will be called by the internal TIBXScript during + initial database creation when the schema source is an sql file and may be used + to provide a visual indication of progress in console mode. + +14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set + to true while a new local database is being created and its schema populated. + Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions + when the database is disconnected/connected during the create DB procedure. + +15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement + are now always ignored and replaced by the user name and password provided as + the login parameters for the TIBDatabase referenced from the TIBXScript. The + IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is + completely ignored if this property is true. + +16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes + to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise + ImageIndex and SelectImageIndex values on AddNode. + +17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now + read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share + the same database connection. + +18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property. + if provided, this should be an conditional SQL expression suitable for + including in an SQL Select statement "where" clause. If non-empty and the + "Filtered" property is true then the SQL expression provided as the value of + the "Filter" property is "ANDed" with any existing condition statement + in the SQL statement's "Where" clause. + + If the "Filter" property is set at run time, the "Filtered" property is true + and the dataset is already open, then the dataset is closed and re-opened automatically. + + The "Filter" condition may include IBX style parameters. In which case, their + value must be set by the dataset's "OnBeforeOpen" event handler. + + This is a public property for TIBDataSet and TIBQuery query and intended for + use at run time. + + Note: The property is a published property of TIBTable. The TIBTable functionality + is unaffected by this change. + +IBX Change Log version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000 + +1. Remove need to check for IsMultiThread by providing access to GUI timers via + IBGUIInterface. Note: master/detail delay timer does not apply to console + mode apps. + +2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select + statement. This avoids problems if "Execute Block" is used as the Query. + +3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the + internal SQL tokeniser routines. + +4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse + as a select statement, with or without CTEs. + +5. IBSQLParser: parser now recognises the "ROWS" clause. + +6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the + internal SQL tokeniser routines. + +7. Fix error in TIBXScript processing of "set" statements. This avoids exceptions + being raised for valid set statements processed by a data formatter. + +8. New published property for TIBDatabase and TIBXServicesConnection. This is + FirebirdLibraryPathName: string. If not empty it is used to explicitly specify + the path of the Firebird Library used by the database/services connection. + +9. New read only public property for TIBDatabase and TIBXServicesConnection. This + is FirebirdAPI and returns the IFirebirdAPI interface used by the database/ + services connection. + +10.SQL Property editors now quote parameter names if "Quote identifier" is selected + or param name is not a valid SQL identifier. + +11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive + view of whether the text box should be editable when no DataSource is specified. + TIBLookupComboEditBox has been updated to workaround this problem. As long as + ReadOnly is false, the text box is editable when no DataSource is specified. + +12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of + the FBLIB environment variable. If you do not want to permit this then you + must modify the Register procedure in the design/IBDBReg.pas unit to remove + this setting. + +IBX Change Log version (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100 + +1. IBCustomDataset: replace deprecated function ValidUTF8String with call to + Utf8EscapeControlChars + +IBX Change Log version (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100 + +IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove +all previous copies of the IBX source code tree before installing this release. + +The IBX packages used by most users have not changed, with one exception. The +IBServices unit has been moved to the package iblegacyServices.lpk. To continue +to use the IBServices unit in your applications, please add the iblegacyServices +to the list of dependencies. To do this, open the Project Inspector and select +Add->New Requirement and select "ibLegacyServices" from the list of available +packages. + +1. New unit IBXServices. The IBXServices unit is a re-architectured update of + the IBServices unit providing what is intended to be a clearer and easier to + use set of IB Services components. See Chapter 10 of the IBX User Guide for + more information and the guide to "Firebird Service Management Using IBX". + As indicated above, the legacy services components are still available and + provided in a separate package. There is no need to update working applications + using the older versions except for an additional package dependency. + +2. The IBX packages and source code tree have been re-organised in an attempt to + finally get rid of the "duplicate ppu" warnings. This re-organisation should + not affect existing users. Section 2.3 of the IBX User Guide describes the + new set of IBX packages. + +3. The ibx/examples/DBAdmin and the ibx/examples/services example have been + updated to use the new Services API components. + +4. The iblocal package has been updated to use the new Services API components. + +5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of + TIBXSecurityService. It had been wrongly classified in the previous version + as a per database configuration item. It is global to a server and hence + correctly positioned as part of the Security Package. In the DBAdmin example, + the setting has moved to the mappings page. + +6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements + are ignored. + +7. TIBDatabase: DropDatabase now ensures that all transactions have been properly + closed before the database is dropped. Before and After Disconnect event handlers + are also fired. + +8. TIBTransaction: OnStartTransaction event now fires every time the transaction + is started and not just the first time. + +9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform + depenendency with comp type. + +10. IBDataOutput: select query data output is now sent to stdout instead of stderr. + +11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName + then this is recognised and not ignored. + +12. TIBDataSet, TIBQuery, TIBTable: additions: + function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean; + function GetPerfStatistics(var stats: TPerfCounters): boolean; + property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics; + + GetRowsAffected returns the affected row counts from the last insert/update/delete + if EnableStatistics = true then GetPerfStatistics returns the current stats + counters for the select query. Note: stats accumulate after each fetch from + the database. To get total query cost after open, call the "Last" method + and then GetPerfStatistics. + + See ibx/examples/consolemode for an example of the use of GetPerfStatistics + +13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated + in parenthesises. + +14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3 + SQL identifiers are always delimited by double quotes. If false, then they are + only delimited if the identifier is a reserved word, contains lower case or special + characters. Set this property to true to retain previous behaviour. + +15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names + are now inserted in double quotes if not Reserved Words or valid SQL Identifiers. + +16. TIBDataSet, TIBQuery, TIBTable: addition: + property MasterDetailDelay: integer {defaults to zero} + + When non-zero and the dataset is a detail table referencing a master table + through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery) + then a synchronisation delay is added (in milliseconds) between the master + row changing and the detail dataset being re-opened. If the master dataset + is scrolled before the delay expires then the delay is reset. This can be used + to avoid performance overheads when scrolling through a large master dataset. + + Note: uses fptimer and hence requires a thread manager. Under Linux the + chreads unit must be included in your project. TTimer is not used in order + to avoid an LCL dependency. Requires FPC 3.0.2 or later. + +17. TIBExtract: User role grants now excluded when etGrantsToUser not specified + with Extract Option eoDatabase. + +18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428 + When a deLayoutChanged event is reported on the ListSource dataset, the + combobox text is updated. This allows a listsource (detail) to be in a Master/Detail + relationship with the control's datasource (master). + +19. TIBExtract: Full BigInt value range now supported for Generators/Sequences. + +20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their + stubs. Pedantic fix really, as procedures output in dependency order anyway. + +21. TIBExtract: Package Headers and Package Bodies are now included in the extracted + DDL (Firebird 3 and later only). + +22. TIBLookupComboBox Autocomplete Fixes: + i. Only appended text is now selected after autocomplete. + ii. Uppercase keys no longer ignored for autocomplete. + iii. Retain Prefix case is now honoured correctly. + iv. When a DataSource is assigned, typing after autocomplete now extends prefix + before autocomplete performed. i.e. behaviour now the same as when + no DataSource assigned. + +23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring + between SQL statements. + +24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then + ObjectNames are converted to upper case before matching against metadata object + names, unless the objectname is delimited by double quotes, in which case, the + double quotes are removed and the remaining string is used (unmodified) to match + against the metadata object name. + + If true then the ObjectName is used as is without modification and matched + against the metadata object name. No attempt is made to remove double quotes. + +25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used + with eoTrigger, these extract types can be used to select only Database Triggers, + or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types. + +26. TIBXScript: If an exception occurs during the processing of a statement, the + statement separate character is now reset to the default (';'). + +27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect. + +28. TIBXScript: Transaction is no longer automatically reactivated immediately processing + a commit or reconnect statement and instead activated only when next SQL statement + is executed. + +29. TIBSQL.HasField should no longer generate and exception when the field does not exist. + +30. TIBXScript: case insensitive regex now used when matching statements instead of + converting statement to upper case. + +31. TIBExtract: metadata comments now supported. New published property + IncludeMetaDataComments (default true). If true then metadata comments included + in extracted DDL. New Extract Object member eoComments. This may be used with + ExtractObject method to list all metadata comments. + +32. TIBExtract: ListObjectNames method added. + +33. Updated Database component editor to support additional connection string + types. + +IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000 NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO -AVOID DUPLICATE PPU ERRORS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS +AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS RELEASE. NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.