--- ibx/trunk/changelog 2018/01/24 16:16:29 139 +++ ibx/trunk/changelog 2020/08/25 15:40:58 312 @@ -1,4 +1,416 @@ -IBX Change Log version (2.2-0) Tue, 23 Jan 2018 11:23:09 +0000 +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. (Not yet tested) + +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 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. + +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. + +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 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. 1. IBExtract: Identity columns - add additional check for null column for generator name. @@ -75,13 +487,13 @@ IBX Change Log version 15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting for password on reconnect. -16. IBDatabase: use IAttachment for connection default character set id, code page +16. TIBDatabase: use IAttachment for connection default character set id, code page and character set name. 17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise DB info lookups" -18. IBExtract: now supports DDL Triggers. +18. IBExtract: now supports DDL Triggers and Grants to DDL objects. 19. Add a property Editor for TIBUpdate.RefreshSQL. @@ -89,6 +501,103 @@ IBX Change Log version parameters. This stops an exception being raised when the field cannot be located in the record buffer. +21. Property Editors now automatically include System Tables when opened and when the query table + is a System Table. + +22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception. + This avoids errors due to a stale SQRB or SRB being used for the next query. + +23. IBServices: Service attach parameters now include "expected_db". This is used to + add the SPB item isc_spb_expected_db. This names a database using + an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a + database. examples/services re-written to illustrate use of "expected_db". + +24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout. + This avoids truncated backups when the server returns a timeout (busy) response. + +25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase. + +26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local + databasenames. These are respectively expanded to the local system's temp directory + (including trailing delimiter) or to a prescribed data directory (including + trailing delimiter). Under Unix systems the data directory is a hidden directory + in the user's home directory. The hidden directory name is either the string returned + from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'. + Under Windows, the directory is the same as the Data Directory as decribed + above but instead prefixed by the User's application data path. These may be + used to improve application portability for Personal Databases. + +27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef + this has not worked for a long time and is not useful either. FieldDefs should be + managed using the Fields Editor as with any other dataset. To access the fields + editor for a TIBTable component, double click on the component. The fields editor + is then displayed. + +28. TIBDatabaseInfo: new properties/function + * DateDBCreated (returns date/time database created) + * TransactionCount (returns no. of active transactions) + * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only). + * PagesFree (Firebird 3 or later) + * PagesUsed (Firebird 3 or later) + * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only) + * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only) + +29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo. + +30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later). + +31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable + the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later). + +32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced + in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from + firing during backup and restore. + +33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options + for verbose output using the new property "StatisticsRequested". + see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats + +34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later). + +35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin" + palette. This uses the online validation feature added in Firebird 2.5. The + services's properties enable inclusion/exclusion of tables and indexes using + regular expressions. See. + https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation + +36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger + option on a database. + +37. TIBCustomService: Assign method implemented to allow copying of service login + context between service API components. "Detach" method now only detaches + service when last reference to the service interface detaches. Tidy up of + code for SetActive and Attach methods including password hiding. + +38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only + and used to determine the auth method and protocol used for the connection. + +39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using + a Create Database Statement generated by IBX. + +40. All IBServices now have an additional published property "PortNo". This may + be set to a non-standard port number when necessary. If zero then the default + port number is used. + +41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard + and not just the mouse. + +42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added. + +43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the + image index and selected image index for each node to be set from a database field. + +44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included + then database schema includes grants to all users. If not present then the + only user grants included are those to User PUBLIC. + +45. TIBTreeView: performance improvement. When expanding include both expanded node + and child nodes in dataset. + IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000