--- ibx/trunk/changelog 2017/02/02 16:20:12 49 +++ ibx/trunk/changelog 2018/02/28 11:14:15 156 @@ -1,6 +1,274 @@ -IBX Change Log version (2.0-2) tba, 09 Jan 2017 15:31:49 +0000 +IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000 -1. TIBDatabase.CreateDatabase: extract full DB Name using reg ex in order to +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. + +2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses. + The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further + information). However, this is also a very useful mechanism for returning updated computed by + column values. Values returned as a result of executing an Insert or Update statement + replace existing values in the current row for each corresponding column. + + Previously, if a dataset's select query included read only (computed by) fields then + an automatic row refresh was performed after an insert or update query had been processed, + irrespective of the setting of the "ForcedUpdates" property. This has changed such + that an automatic refresh is no longer performed if an insert or update query contains + a returning clause that updates one or more fields on the current row. A full row + refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any + field values and the select query contains read only fields. Use of Insert/update + returning should be significantly more efficient than executing a refresh query. + + This behaviour change is intended to be backwards compatible and there should be no need to change + existing programs, other than to improve performance by using the new capability. + +3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as + they are called when the dataset row is being deleted, there is no value in + updating the current record from the query result. Instead, a new event handler + "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and + an OnDeleteReturning event handler is provided then it is called with the IResults returned + by the query. The event handler can then interrogate the query results and + perform whatever action is necessary. For example to confirm, to the user, + the deletion of a row with the returned values. + +4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for + any Computed By or Identity Columns. The IBTables example has been updated to + illustrate the computation of the employee Full Name on update. + +5. TIBTable: The GeneratorField property is now published. + +6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List. + When InsertSQL is generated, the Identity columns are not included in the list of values to + be inserted. A RETURNING clause is added to the insert statement to return the value of + each Identity column after the insert is executed. + +7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause. + Similarly Insert Property Editor now generates Insert SQL with Computed By fields in + Insert..Returning clause. + +8. TIBGenerator: small performance improvement by not preparing query each time + a new value is generated. + +9. TIBSQL: Free resources when transaction changed - ensures new transaction is used. + +10. Property editors will now sync table name to a System Table when "Include System + Tables" is selected and the query is for a System Table. + +11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field + values are no longer converted to milliseconds from TDateTime and then back again + to TDateTime (the conversion to milliseconds is the default TDataset approach). + +12. Property Editors handling of Stored Procedures. + * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and + which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select + query). + * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2). + +13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName + can be used to select a package. If non-empty, the stored procedure name is + expected to be a stored procedure defined in the specified package and the + generated SQL will be as required for a stored procedure located in a package. + +14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include + a "Package Name" drop down box to allow selection of a Firebird 3 Package from + which a stored procedure can be selected. With no package name selected, non-package + stored procedures are listed. + +15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting + for password on reconnect. + +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 and Grants to DDL objects. + +19. Add a property Editor for TIBUpdate.RefreshSQL. + +20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input + 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 + +1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf + changes. + +2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString. + Bug could result in truncated multi-byte character set values. + +3. Changes consequential on moving fbintf character set utility functions from + IFirebirdAPI to IAttachment. + +4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true + +5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally + results in autocomplete ignoring prefix text. + +6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when + entering a new name into the text box. + +7. IBCustomDataset: ensure that TIBStringField uses the field size reported by + Firebird rather than recomputing it. + +8. Property Editor positioning tidy up: All IBX Property editors should now be + screen centre. Previously some were "poDesigned" which may be inappropriate + for multi monitor desktops. + +10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node. + +11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending + a transaction and always reset the object. + +12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows. + +13. TIBXScript: Allow for override of database filename in Create Database statements. + +14. IBLocaldb: Support initialisation of the database from an SQL script in addition + to a gbak format archive. + +15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised. + +16. IBLocaldb: Drop database if error creating an empty database. + +17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset + unless selected node not in current dataset. + +18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package) + to TIBCustomService, and IBlocalDB code tidy up. + +19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable + behaviour due to uninitialised variable. + +20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from + integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode. + +21. IBSQL: When Database changed ensure that all resources are freed. + +22. IBCustomDataset: When database changed ensure that queries an unprepared. + +23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include: + * Line Wrap on SQL Token boundaries (on user command) + * auto-complete table names in drop down list of table names + * Double click on tablename or field name adds to SQL text + +24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d). + +25. IBTreeView: Call to FindNode: param type change from "array of Variant" to + TVariantArray. Seems to avoid memory corruption in Windows (probably a + workaround for a problem in fpc 3.0.4 win64). + +26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open. + +27. IBDatabaseInfo: Remove memory leak when accessing database operation counts. + +IBX Change Log version (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000 + +1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to include remote system name. 2. TIBExtract: No longer include comment header and COMMIT statement for empty @@ -14,6 +282,16 @@ IBX Change Log version 5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit +6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures + that BindFields is called when the query is next activated. Avoids FieldName + not found error. + +7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general + purpose and allows the programmer to define any action they want for Update, Insert + or Delete. This may be complex SQL (similar to a Trigger), application specific + filtering of updates, or use of statements such as Grant or Revoke instead of + normal DML. See User Manual for more information. + IBX Change Log version (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000 1. TIBEvents: Fix uninitialised variable that could result in lost events. @@ -62,7 +340,7 @@ IBX Change Log version IBX Change Log version (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000 -See also doc/readme.upgrade-4-x.to.2-0-0.xhtml for important information on +See also doc/IBX4LazarusGuide.pdf for important information on upgrading to IBX2. 1. Size property of TIBStringField is now the width in characters of the field