--- ibx/trunk/changelog 2018/03/16 11:28:58 219 +++ ibx/trunk/changelog 2021/12/07 09:37:32 359 @@ -1,4 +1,412 @@ -IBX Change Log version (2.3-0) Fri, 16 Mar 2018 11:07:39 +0000 +IBX Change Log version (2.5-0 Build 12933) Mon, 29 Nov 2021 14:59:54 +0000 + +1. IBCustomDataset: Modify TISQL component now defaults to GoToFirstRecordOnExecute := true. + This is for compatibility with Firebird 5 where Update...Returning can return + a cursor. + +IBX Change Log version (2.4-3 Build 12886) Sat, 23 Oct 2021 14:58:30 +0100 + +1. Add try-..except check when initially loading library in IDE. This should +ensure that IDE continues to load even when a failure occurs in IBX load +library. + +2. IBXScript: now recognises a CASE...END block within a stored procedure and + hence will correctly detect end of the outer containing block when the block + contains a SELECT ... CASE ... END construct. + +3. IBExtract: some further tidying up to remove extraneous white space. + +4. IBCustomDataSet: DefaultFieldClasses array declaration updated to avoid compile time + errors when extra elements are added to DB.TFieldType. + +5. IBUpdate: updated to reflect changes to ISQLParam. + +6. IBXScript: now correctly parses a DECLARE statement which includes a quoted string. + +7. IBExtract: for ODS >=13, increment generator value by one for ALTER SEQUENCE statement. + +8. IBSQL: Support for scrollable cursors added (note: local databases only) + +IBX Change Log version (2.4-2 Build 12773) Mon, 23 Aug 2021 11:59:42 +0100 + +1. TIBDatabaseInfo: review and tidy-up of property types. Most widen to int64 with the + exception of those defined to be one byte wide e.g. DBImplementationNo. + +2. TIBSQL: Batch Update/Insert support added. + +3. TIBStoredProc: when generating the SQL, the value of the StoredProcName property + is no longer automatically converted to upper case when it is syntactically a + SQL Identifier. This is to support the use of stored procedures defined e.g. + as CREATE PROCEDURE "iCASE". + + There could be a backwards compatibility issue when the StoredProcName was entered + manually at design time. That is not selected from the drop down list. If the + StoredProcName is entered in mixed case and the procedure was declared e.g. as + CREATE PROCEDURE iCASE, then the SQL generation will be incorrect. You should + ensure that the value of the StoredProcName is all upper case, unless it was + declared under dialect 3 and explicitly as mixed case (i.e. delimited by double + quotes). + + Note that when a stored procedure name was declared delimited in double quotes, + as in the first example above, the value of the StoredProcName property must not + include the delimiters (double quotes). + +4. IBXUpgradeConfFile: an exception is now raised if a patch file specified in + upgrade.conf was not found. This replaces silently ignoring the problem. + +5. TIBLocalDBSupport: new property "SectionHeaderTemplate". This defaults to + 'Version.%.3d' and is used to generate the section header names (for a given + version no.) in the upgrade.conf file. + +IBX Change Log version (2.4-1 Build 12550) Wed, 23 Jun 2021 13:59:14 +0100 + +1. -c command line option added to fbsql example program. Used to set connection + character set. + +IBX Change Log version (2.4-0 Build 12543) Mon, 22 Feb 2021 11:00:08 +0000 + +1. Firebird 4 support added. + +2. New FB4 data types TIME WITH TIME ZONE, TIMESTAMP WITH TIME ZONE, DECFLOAT and + extended precision NUMERIC fields are supported. + +3. TFmtBCDField is used to support access to DECFLOAT and extended precision NUMERIC fields. + +4. TIBDateTimeField and TIBTimeField are introduced in support of TIMESTAMP WITH TIME ZONE + and TIME WITH TIME ZONE fields. These inherit from TDateTimeField. + +5. IBExtract now supports FB4 enhancements: + - new data types as above + - Identity column extensions + - Default user role + - SQL Security clause for Database, Tables, Procedures, Functions and Triggers + - Internal Functions + +6. IBExtract: new event: OnExtractLines. + +7. IBExtract: revert create trigger to legacy syntax see Firebird CORE-6243, CORE-5545 and DOC-145 + +8. IBXServices: Server version no. parsing now allows any letter before major version number + and is no longer restricted to 'V' e.g. "LI-T4.0.0.1436 Firebird 4.0 Beta 1" + +9. TIBDataSet and TIBQuery: new property TZTextOption. Used to determine the default + format for rendering a time zone. + +10. TIBDataSet and TIBQuery: new property DefaultTZDate. Used to provide the default date + to convert TIME WITH TIME ZONE data type values to and from GMT. + +11. Unit name IBTypes changed to IBInternals. Internal interfaces TIBGUIInterface and TIBTimerInf renamed to + IIBGUIInterface and IIBTimerInf respectively. + +12. Constants: DPBPrefix and TPBPrefix moved to IB unit. DPBConstantNames and TPBConstantNames + now accessible as properties of TIBDatabase and TIBTransaction respectively. + +13. String Fields: when a fixed character with (CHAR) field is returned, it is now + truncated to its fixed character width rather than being right padded with + white space to the maximum data size. + +14. TIBTable.Empty table. In additional to deleting all records in the underlying + table, the internal buffers are now also flushed ensuring that the TIBTable is + also empty. + +15. TBatchSQLStatementReader: Line buffer is now cleared on call to reset. + +16. TIBXControlService descendents: DatabaseName may now be set using a database + connect string. The database name is extracted from the connect string. + +17. DBControlGrid: Minor bug fixes. avoid AV on form closure, avoid black panel + +18. TIBExtract: Data type of COMPUTED By columns is no longer included in SQL. + +19. Local database on Linux and with legacy API and FB 2.5 embedded server: fixed problem with password + not being present as required. + +20. IBTreeView split into DBTreeView and IBTreeView. This former is an IBX indepedent + version that can be customised to work with other database drivers. + +21. ISQLMonitor: use platform specific LineEnding to delimit messages. Avoids + unnecessary CR at end of line on Unix platforms. + +22. ISQLMonitor: Unix: Default semaphore timeout increased from 1 second to 10 + seconds in order to reduce risk of message loss. + +23. ISQLMonitor: read and write count statistics now available via: + property TIBSQLMonitor.ReadCount; + IIBSQLMonitorHook.GetWriteCount: integer; + +24. ISQLMonitor tidy up and unit split. IPC functions moved to new unit IBIPC. + +IBX Change Log version (2.3-5 Build 12350) Tue, 25 Aug 2020 16:11:02 +0100 + +1. TIBStringField: when a string value is read from a dataset buffer, if the + number of UTF8 characters exceeds the string size then string is truncated + to the maximum string size. This is usually a problem with fixed width columns + right padded with white space. + +2. SQLFiltered and SQLFilterParams added to TIBQuery, TIBTable and TIBDataset. + If SQLFiltered is set then when a dataset is opened, each line in the + SQLFilterParams property is assumed to be a SQL condition clause and + ANDed into the Where clause of the SQL Select statement provided as a + dataset property. Each such SQL condition thus acts as an additional filter + on the dataset. + +3. The Filtered property inherited from TDataset is no longer used for SQL (server + side filters). + +4. IBLookupComboEditBox: Selection should no longer reset to start of text when + text matches complete entry. + +5. TIBDataLink: Detail Dataset params not refreshed unless both master and detail + dataset are active (avoids risk of access violation if master is inactive) + +6. TIBEvents: Registered property can now be set at design time even if database not open + +7. TIBEvents: component now correctly re-initialised after call to UnregisterEvents. + This should prevent "spillover" of events between sessions. + +8. TIBCustomDataset: GetNextRecord now called when reseting to first record of a unidirectional dataset. + This should ensure that the internal buffer is set up correctly and avoids + a duplicate initial row. + +9. TIBStringField: DataSize now given as byte size of string less trailing any zero character. + That is, the DataSize should be the field size * character set width. The + value returned by DataSize is now the same as the Dataset buffer size reserved + for the field. + +10. IBExtract: Tidyup of SQL generation. Avoid unnecessary double quotes. + +11. TIBCustomDataset: Add checks on buffer sizes when copying data from row to field buffer + and vice-versa. This may result in an exception being raised (correctly) for + older programs when using dataset fields added to a form and the database has been + upgraded. For example, computed fields can change from 32-bit to 64-bit integers. + In such cases, the field needs to be deleted in the IDE fields editor and then + added back in. + +12. IBCustomDataSet: CanInsert, CanEdit, CanDelete and CanRefresh updated to return + false if query contains only white space and not just empty. + +12. IBCustomDataset: Blob data is now cleared when TDataSet.Cancel is called. This + should ensure that (e.g.) a TDBMemo is correctly refreshed after a dataset edit + is cancelled. + +13. IBCustomDataset: SetArrayIntf should no longer cause an access violation if + called on a null field. + +14. IBCustomDataSet: An access violation should no longer occur when calling CancelUpdates + results in an empty dataTC86 Client side Filtered Dataset 1 X +set. + +15. IBCustomDataSet: OnUpdateError should now be called in all circumstances when + a cached update is applied and an exception is raised. + +16. IBCustomDataSet: Avoid access violation when SetBookmarkData called with nil pointer. + +17. Console Mode Local Database support: backup/restore should now work correctly. + +18. Local Database Support: if an upgrade fails, a downgrade is now performed if + possible and an exception raised. + +19. MinimumVersionNo added to Local Database Support. Database will not open if + below this version no. and upgrade not possible. + +IBX Change Log version (2.3-4 Build 12041) Fri, 17 Apr 2020 14:00:32 +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. @@ -94,10 +502,66 @@ packages. with Extract Option eoDatabase. 18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428 - When a deLaoutChanged event is reported on the ListSource dataset, the + 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