ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
(Generate patch)

Comparing ibx/trunk/changelog (file contents):
Revision 101 by tony, Thu Jan 18 14:37:18 2018 UTC vs.
Revision 221 by tony, Mon Mar 19 09:48:37 2018 UTC

# Line 1 | Line 1
1 < IBX Change Log  version                               (2.1-1) Fri, 05 Jan 2018 10:40:04 +0000
1 > IBX Change Log  version        (2.3-0) Mon, 19 Mar 2018 09:45:35 +0000
2  
3 < 1. IBExtract: Identity columns - add addition check for null column for generator name.
3 > IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
4 > all previous copies of the IBX source code tree before installing this release.
5 >
6 > The IBX packages used by most users have not changed, with one exception. The
7 > IBServices unit has been moved to the package iblegacyServices.lpk. To continue
8 > to use the IBServices unit in your applications, please add the iblegacyServices
9 > to the list of dependencies. To do this, open the Project Inspector and select
10 > Add->New Requirement and select "ibLegacyServices" from the list of available
11 > packages.
12 >
13 > 1. New unit IBXServices. The IBXServices unit is a re-architectured update of
14 >   the IBServices unit providing what is intended to be a clearer and easier to
15 >   use set of IB Services components. See Chapter 10 of the IBX User Guide for
16 >   more information and the guide to "Firebird Service Management Using IBX".
17 >   As indicated above, the legacy services components are still available and
18 >   provided in a separate package. There is no need to update working applications
19 >   using the older versions except for an additional package dependency.
20 >
21 > 2. The IBX packages and source code tree have been re-organised in an attempt to
22 >   finally get rid of the "duplicate ppu" warnings. This re-organisation should
23 >   not affect existing users. Section 2.3 of the IBX User Guide describes the
24 >   new set of IBX packages.
25 >
26 > 3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
27 >   updated to use the new Services API components.
28 >
29 > 4. The iblocal package has been updated to use the new Services API components.
30 >
31 > 5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
32 >   TIBXSecurityService. It had been wrongly classified in the previous version
33 >   as a per database configuration item. It is global to a server and hence
34 >   correctly positioned as part of the Security Package. In the DBAdmin example,
35 >   the setting has moved to the mappings page.
36 >
37 > 6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
38 >   are ignored.
39 >
40 > 7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
41 >   closed before the database is dropped. Before and After Disconnect event handlers
42 >   are also fired.
43 >
44 > 8. TIBTransaction: OnStartTransaction event now fires every time the transaction
45 >   is started and not just the first time.
46 >
47 > 9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
48 >   depenendency with comp type.
49 >
50 > 10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
51 >
52 > 11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
53 >    then this is recognised and not ignored.
54 >
55 > 12. TIBDataSet, TIBQuery, TIBTable: additions:
56 >    function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
57 >    function GetPerfStatistics(var stats: TPerfCounters): boolean;
58 >    property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
59 >
60 >    GetRowsAffected returns the affected row counts from the last insert/update/delete
61 >    if EnableStatistics = true then GetPerfStatistics returns the current stats
62 >    counters for the select query. Note: stats accumulate after each fetch from
63 >    the database. To get total query cost after open, call the "Last" method
64 >    and then GetPerfStatistics.
65 >
66 >    See ibx/examples/consolemode for an example of the use of GetPerfStatistics
67 >
68 > 13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
69 >    in parenthesises.
70 >
71 > 14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
72 >    SQL identifiers are always delimited by double quotes. If false, then they are
73 >    only delimited if the identifier is a reserved word, contains lower case or special
74 >    characters. Set this property to true to retain previous behaviour.
75 >
76 > 15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
77 >    are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
78 >
79 > 16. TIBDataSet, TIBQuery, TIBTable: addition:
80 >       property MasterDetailDelay: integer {defaults to zero}
81 >
82 >    When non-zero and the dataset is a detail table referencing a master table
83 >    through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
84 >    then a synchronisation delay is added (in milliseconds) between the master
85 >    row changing and the detail dataset being re-opened. If the master dataset
86 >    is scrolled before the delay expires then the delay is reset. This can be used
87 >    to avoid performance overheads when scrolling through a large master dataset.
88 >
89 >    Note: uses fptimer and hence requires a thread manager. Under Linux the
90 >    chreads unit must be included in your project. TTimer is not used in order
91 >    to avoid an LCL dependency. Requires FPC 3.0.2 or later.
92 >
93 > 17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
94 >    with Extract Option eoDatabase.
95 >
96 > 18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
97 >    When a deLaoutChanged event is reported on the ListSource dataset, the
98 >    combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
99 >    relationship with the control's datasource (master).
100 >
101 > 19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
102 >
103 > 20. Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
104 >    stubs. Pedantic fix really, as procedures output in dependency order anyway.
105 >
106 > 21. TIBExtact: Package Headers and Package Bodies are now included in the extracted
107 >    DDL (Firebird 3 and later only).
108 >
109 > IBX Change Log  version  (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
110 >
111 > NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
112 > AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
113 > RELEASE.
114 >
115 > NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
116 >
117 > 1. IBExtract: Identity columns - add additional check for null column for generator name.
118  
119   2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
120     The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
121 <   information). Values returned as a result of executing an Insert or Update statement
122 <   replace existing values in the current row for each corresponding column.
121 >   information). However, this is also a very useful mechanism for returning updated computed by
122 >   column values. Values returned as a result of executing an Insert or Update statement
123 >   replace existing values in the current row for each corresponding column.
124 >
125 >   Previously, if a dataset's select query included read only (computed by) fields then
126 >   an automatic row refresh was performed after an insert or update query had been processed,
127 >   irrespective of the setting of the "ForcedUpdates" property. This has changed such
128 >   that an automatic refresh is no longer performed if an insert or update query contains
129 >   a returning clause that updates one or more fields on the current row. A full row
130 >   refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
131 >   field values and the select query contains read only fields. Use of Insert/update
132 >   returning should be significantly more efficient than executing a refresh query.
133 >
134 >   This behaviour change is intended to be backwards compatible and there should be no need to change
135 >   existing programs, other than to improve performance by using the new capability.
136 >
137 > 3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
138 >   they are called when the dataset row is being deleted, there is no value in
139 >   updating the current record from the query result. Instead, a new event handler
140 >   "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
141 >   an OnDeleteReturning event handler is provided then it is called with the IResults returned
142 >   by the query. The event handler can then interrogate the query results and
143 >   perform whatever action is necessary. For example to confirm, to the user,
144 >   the deletion of a row with the returned values.
145 >
146 > 4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
147 >   any Computed By or Identity Columns. The IBTables example has been updated to
148 >   illustrate the computation of the employee Full Name on update.
149  
150 < 3. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
150 > 5. TIBTable: The GeneratorField property is now published.
151 >
152 > 6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
153     When InsertSQL is generated, the Identity columns are not included in the list of values to
154     be inserted. A RETURNING clause is added to the insert statement to return the value of
155     each Identity column after the insert is executed.
156  
157 + 7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
158 +   Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
159 +   Insert..Returning clause.
160 +
161 + 8. TIBGenerator: small performance improvement by not preparing query each time
162 +   a new value is generated.
163 +
164 + 9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
165 +
166 + 10. Property editors will now sync table name to a System Table when "Include System
167 +    Tables" is selected and the query is for a System Table.
168 +
169 + 11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
170 +    values are no longer converted to milliseconds from TDateTime and then back again
171 +    to TDateTime (the conversion to milliseconds is the default TDataset approach).
172 +
173 + 12. Property Editors handling of Stored Procedures.
174 +    * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
175 +      which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
176 +      query).
177 +    * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
178 +
179 + 13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
180 +    can be used to select a package. If non-empty, the stored procedure name is
181 +    expected to be a stored procedure defined in the specified package and the
182 +    generated SQL will be as required for a stored procedure located in a package.
183 +
184 + 14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
185 +    a "Package Name" drop down box to allow selection of a Firebird 3 Package from
186 +    which a stored procedure can be selected. With no package name selected, non-package
187 +    stored procedures are listed.
188 +
189 + 15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
190 +    for password on reconnect.
191 +
192 + 16. TIBDatabase: use IAttachment for connection default character set id, code page
193 +    and character set name.
194 +
195 + 17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
196 +    DB info lookups"
197 +
198 + 18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
199 +
200 + 19. Add a property Editor for TIBUpdate.RefreshSQL.
201 +
202 + 20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
203 +    parameters. This stops an exception being raised when the field cannot be
204 +    located in the record buffer.
205 +
206 + 21. Property Editors now automatically include System Tables when opened and when the query table
207 +    is a System Table.
208 +
209 + 22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
210 +    This avoids errors due to a stale SQRB or SRB being used for the next query.
211 +
212 + 23. IBServices: Service attach parameters now include "expected_db". This is used to
213 +    add the SPB item isc_spb_expected_db. This names a database using
214 +    an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
215 +    database. examples/services re-written to illustrate use of "expected_db".
216 +
217 + 24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
218 +    This avoids truncated backups when the server returns a timeout (busy) response.
219 +
220 + 25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
221 +
222 + 26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
223 +    databasenames. These are respectively expanded to the local system's temp directory
224 +    (including trailing delimiter) or to a prescribed data directory (including
225 +    trailing delimiter). Under Unix systems the data directory is a hidden directory
226 +    in the user's home directory. The hidden directory name is either the string returned
227 +    from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
228 +    Under Windows, the directory is the same as the Data Directory as decribed
229 +    above but instead prefixed by the User's application data path. These may be
230 +    used to improve application portability for Personal Databases.
231 +
232 + 27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
233 +    this has not worked for a long time and is not useful either. FieldDefs should be
234 +    managed using the Fields Editor as with any other dataset. To access the fields
235 +    editor for a TIBTable component, double click on the component. The fields editor
236 +    is then displayed.
237 +
238 + 28. TIBDatabaseInfo: new properties/function
239 +     * DateDBCreated (returns date/time database created)
240 +     * TransactionCount (returns no. of active transactions)
241 +     * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
242 +     * PagesFree (Firebird 3 or later)
243 +     * PagesUsed (Firebird 3 or later)
244 +     * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
245 +     * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
246 +
247 + 29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
248 +
249 + 30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
250 +
251 + 31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
252 +    the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
253 +
254 + 32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
255 +    in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
256 +    firing during backup and restore.
257 +
258 + 33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
259 +    for verbose output using the new property "StatisticsRequested".
260 +    see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
261 +
262 + 34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
263 +
264 + 35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
265 +    palette. This uses the online validation feature added in Firebird 2.5. The
266 +    services's properties enable inclusion/exclusion of tables and indexes using
267 +    regular expressions. See.
268 +    https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
269 +
270 + 36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
271 +    option on a database.
272 +
273 + 37. TIBCustomService: Assign method implemented to allow copying of service login
274 +    context between service API components. "Detach" method now only detaches
275 +    service when last reference to the service interface detaches. Tidy up of
276 +    code for SetActive and Attach methods including password hiding.
277 +
278 + 38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
279 +    and used to determine the auth method and protocol used for the connection.
280 +
281 + 39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
282 +    a Create Database Statement generated by IBX.
283 +
284 + 40. All IBServices now have an additional published property "PortNo". This may
285 +    be set to a non-standard port number when necessary. If zero then the default
286 +    port number is used.
287 +
288 + 41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
289 +    and not just the mouse.
290 +
291 + 42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
292 +
293 + 43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
294 +    image index and selected image index for each node to be set from a database field.
295 +
296 + 44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
297 +    then database schema includes grants to all users. If not present then the
298 +    only user grants included are those to User PUBLIC.
299 +
300 + 45. TIBTreeView: performance improvement. When expanding include both expanded node
301 +    and child nodes in dataset.
302 +
303 +
304   IBX Change Log  version                            (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
305  
306   1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines