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 60 by tony, Mon Mar 27 15:21:02 2017 UTC vs.
Revision 241 by tony, Thu Oct 25 13:57:12 2018 UTC

# Line 1 | Line 1
1 < IBX Change Log  version                   (2.0.3) tba, 24 Feb 2017 12:17:53 +0000
1 > IBX Change Log  version                 (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
2 >
3 > 1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
4 >   Utf8EscapeControlChars
5 >
6 >
7 > IBX Change Log  version                (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
8 >
9 > IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
10 > all previous copies of the IBX source code tree before installing this release.
11 >
12 > The IBX packages used by most users have not changed, with one exception. The
13 > IBServices unit has been moved to the package iblegacyServices.lpk. To continue
14 > to use the IBServices unit in your applications, please add the iblegacyServices
15 > to the list of dependencies. To do this, open the Project Inspector and select
16 > Add->New Requirement and select "ibLegacyServices" from the list of available
17 > packages.
18 >
19 > 1. New unit IBXServices. The IBXServices unit is a re-architectured update of
20 >   the IBServices unit providing what is intended to be a clearer and easier to
21 >   use set of IB Services components. See Chapter 10 of the IBX User Guide for
22 >   more information and the guide to "Firebird Service Management Using IBX".
23 >   As indicated above, the legacy services components are still available and
24 >   provided in a separate package. There is no need to update working applications
25 >   using the older versions except for an additional package dependency.
26 >
27 > 2. The IBX packages and source code tree have been re-organised in an attempt to
28 >   finally get rid of the "duplicate ppu" warnings. This re-organisation should
29 >   not affect existing users. Section 2.3 of the IBX User Guide describes the
30 >   new set of IBX packages.
31 >
32 > 3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
33 >   updated to use the new Services API components.
34 >
35 > 4. The iblocal package has been updated to use the new Services API components.
36 >
37 > 5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
38 >   TIBXSecurityService. It had been wrongly classified in the previous version
39 >   as a per database configuration item. It is global to a server and hence
40 >   correctly positioned as part of the Security Package. In the DBAdmin example,
41 >   the setting has moved to the mappings page.
42 >
43 > 6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
44 >   are ignored.
45 >
46 > 7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
47 >   closed before the database is dropped. Before and After Disconnect event handlers
48 >   are also fired.
49 >
50 > 8. TIBTransaction: OnStartTransaction event now fires every time the transaction
51 >   is started and not just the first time.
52 >
53 > 9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
54 >   depenendency with comp type.
55 >
56 > 10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
57 >
58 > 11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
59 >    then this is recognised and not ignored.
60 >
61 > 12. TIBDataSet, TIBQuery, TIBTable: additions:
62 >    function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
63 >    function GetPerfStatistics(var stats: TPerfCounters): boolean;
64 >    property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
65 >
66 >    GetRowsAffected returns the affected row counts from the last insert/update/delete
67 >    if EnableStatistics = true then GetPerfStatistics returns the current stats
68 >    counters for the select query. Note: stats accumulate after each fetch from
69 >    the database. To get total query cost after open, call the "Last" method
70 >    and then GetPerfStatistics.
71 >
72 >    See ibx/examples/consolemode for an example of the use of GetPerfStatistics
73 >
74 > 13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
75 >    in parenthesises.
76 >
77 > 14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
78 >    SQL identifiers are always delimited by double quotes. If false, then they are
79 >    only delimited if the identifier is a reserved word, contains lower case or special
80 >    characters. Set this property to true to retain previous behaviour.
81 >
82 > 15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
83 >    are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
84 >
85 > 16. TIBDataSet, TIBQuery, TIBTable: addition:
86 >       property MasterDetailDelay: integer {defaults to zero}
87 >
88 >    When non-zero and the dataset is a detail table referencing a master table
89 >    through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
90 >    then a synchronisation delay is added (in milliseconds) between the master
91 >    row changing and the detail dataset being re-opened. If the master dataset
92 >    is scrolled before the delay expires then the delay is reset. This can be used
93 >    to avoid performance overheads when scrolling through a large master dataset.
94 >
95 >    Note: uses fptimer and hence requires a thread manager. Under Linux the
96 >    chreads unit must be included in your project. TTimer is not used in order
97 >    to avoid an LCL dependency. Requires FPC 3.0.2 or later.
98 >
99 > 17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
100 >    with Extract Option eoDatabase.
101 >
102 > 18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
103 >    When a deLayoutChanged event is reported on the ListSource dataset, the
104 >    combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
105 >    relationship with the control's datasource (master).
106 >
107 > 19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
108 >
109 > 20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
110 >    stubs. Pedantic fix really, as procedures output in dependency order anyway.
111 >
112 > 21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
113 >    DDL (Firebird 3 and later only).
114 >
115 > 22. TIBLookupComboBox Autocomplete Fixes:
116 >    i. Only appended text is now selected after autocomplete.
117 >    ii. Uppercase keys no longer ignored for autocomplete.
118 >    iii. Retain Prefix case is now honoured correctly.
119 >    iv. When a DataSource is assigned, typing after autocomplete now extends prefix
120 >        before autocomplete performed. i.e. behaviour now the same as when
121 >        no DataSource assigned.
122 >
123 > 23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
124 >    between SQL statements.
125 >
126 > 24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
127 >    ObjectNames are converted to upper case before matching against metadata object
128 >    names, unless the objectname is delimited by double quotes, in which case, the
129 >    double quotes are removed and the remaining string is used (unmodified) to match
130 >    against the metadata object name.
131 >
132 >    If true then the ObjectName is used as is without modification and matched
133 >    against the metadata object name. No attempt is made to remove double quotes.
134 >
135 > 25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
136 >    with eoTrigger, these extract types can be used to select only Database Triggers,
137 >    or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
138 >
139 > 26. TIBXScript: If an exception occurs during the processing of a statement, the
140 >    statement separate character is now reset to the default (';').
141 >
142 > 27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
143 >
144 > 28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
145 >    a commit or reconnect statement and instead activated only when next SQL statement
146 >    is executed.
147 >
148 > 29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
149 >
150 > 30. TIBXScript: case insensitive regex now used when matching statements instead of
151 >    converting statement to upper case.
152 >
153 > 31. TIBExtract: metadata comments now supported. New published property
154 >    IncludeMetaDataComments (default true). If true then metadata comments included
155 >    in extracted DDL. New Extract Object member eoComments. This may be used with
156 >    ExtractObject method to list all metadata comments.
157 >
158 > 32. TIBExtract: ListObjectNames method added.
159 >
160 > 33. Updated Database component editor to support additional connection string
161 >    types.
162 >
163 > IBX Change Log  version  (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
164 >
165 > NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
166 > AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
167 > RELEASE.
168 >
169 > NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
170 >
171 > 1. IBExtract: Identity columns - add additional check for null column for generator name.
172 >
173 > 2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
174 >   The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
175 >   information). However, this is also a very useful mechanism for returning updated computed by
176 >   column values. Values returned as a result of executing an Insert or Update statement
177 >   replace existing values in the current row for each corresponding column.
178 >
179 >   Previously, if a dataset's select query included read only (computed by) fields then
180 >   an automatic row refresh was performed after an insert or update query had been processed,
181 >   irrespective of the setting of the "ForcedUpdates" property. This has changed such
182 >   that an automatic refresh is no longer performed if an insert or update query contains
183 >   a returning clause that updates one or more fields on the current row. A full row
184 >   refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
185 >   field values and the select query contains read only fields. Use of Insert/update
186 >   returning should be significantly more efficient than executing a refresh query.
187 >
188 >   This behaviour change is intended to be backwards compatible and there should be no need to change
189 >   existing programs, other than to improve performance by using the new capability.
190 >
191 > 3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
192 >   they are called when the dataset row is being deleted, there is no value in
193 >   updating the current record from the query result. Instead, a new event handler
194 >   "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
195 >   an OnDeleteReturning event handler is provided then it is called with the IResults returned
196 >   by the query. The event handler can then interrogate the query results and
197 >   perform whatever action is necessary. For example to confirm, to the user,
198 >   the deletion of a row with the returned values.
199 >
200 > 4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
201 >   any Computed By or Identity Columns. The IBTables example has been updated to
202 >   illustrate the computation of the employee Full Name on update.
203 >
204 > 5. TIBTable: The GeneratorField property is now published.
205 >
206 > 6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
207 >   When InsertSQL is generated, the Identity columns are not included in the list of values to
208 >   be inserted. A RETURNING clause is added to the insert statement to return the value of
209 >   each Identity column after the insert is executed.
210 >
211 > 7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
212 >   Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
213 >   Insert..Returning clause.
214 >
215 > 8. TIBGenerator: small performance improvement by not preparing query each time
216 >   a new value is generated.
217 >
218 > 9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
219 >
220 > 10. Property editors will now sync table name to a System Table when "Include System
221 >    Tables" is selected and the query is for a System Table.
222 >
223 > 11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
224 >    values are no longer converted to milliseconds from TDateTime and then back again
225 >    to TDateTime (the conversion to milliseconds is the default TDataset approach).
226 >
227 > 12. Property Editors handling of Stored Procedures.
228 >    * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
229 >      which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
230 >      query).
231 >    * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
232 >
233 > 13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
234 >    can be used to select a package. If non-empty, the stored procedure name is
235 >    expected to be a stored procedure defined in the specified package and the
236 >    generated SQL will be as required for a stored procedure located in a package.
237 >
238 > 14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
239 >    a "Package Name" drop down box to allow selection of a Firebird 3 Package from
240 >    which a stored procedure can be selected. With no package name selected, non-package
241 >    stored procedures are listed.
242 >
243 > 15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
244 >    for password on reconnect.
245 >
246 > 16. TIBDatabase: use IAttachment for connection default character set id, code page
247 >    and character set name.
248 >
249 > 17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
250 >    DB info lookups"
251 >
252 > 18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
253 >
254 > 19. Add a property Editor for TIBUpdate.RefreshSQL.
255 >
256 > 20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
257 >    parameters. This stops an exception being raised when the field cannot be
258 >    located in the record buffer.
259 >
260 > 21. Property Editors now automatically include System Tables when opened and when the query table
261 >    is a System Table.
262 >
263 > 22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
264 >    This avoids errors due to a stale SQRB or SRB being used for the next query.
265 >
266 > 23. IBServices: Service attach parameters now include "expected_db". This is used to
267 >    add the SPB item isc_spb_expected_db. This names a database using
268 >    an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
269 >    database. examples/services re-written to illustrate use of "expected_db".
270 >
271 > 24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
272 >    This avoids truncated backups when the server returns a timeout (busy) response.
273 >
274 > 25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
275 >
276 > 26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
277 >    databasenames. These are respectively expanded to the local system's temp directory
278 >    (including trailing delimiter) or to a prescribed data directory (including
279 >    trailing delimiter). Under Unix systems the data directory is a hidden directory
280 >    in the user's home directory. The hidden directory name is either the string returned
281 >    from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
282 >    Under Windows, the directory is the same as the Data Directory as decribed
283 >    above but instead prefixed by the User's application data path. These may be
284 >    used to improve application portability for Personal Databases.
285 >
286 > 27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
287 >    this has not worked for a long time and is not useful either. FieldDefs should be
288 >    managed using the Fields Editor as with any other dataset. To access the fields
289 >    editor for a TIBTable component, double click on the component. The fields editor
290 >    is then displayed.
291 >
292 > 28. TIBDatabaseInfo: new properties/function
293 >     * DateDBCreated (returns date/time database created)
294 >     * TransactionCount (returns no. of active transactions)
295 >     * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
296 >     * PagesFree (Firebird 3 or later)
297 >     * PagesUsed (Firebird 3 or later)
298 >     * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
299 >     * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
300 >
301 > 29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
302 >
303 > 30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
304 >
305 > 31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
306 >    the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
307 >
308 > 32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
309 >    in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
310 >    firing during backup and restore.
311 >
312 > 33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
313 >    for verbose output using the new property "StatisticsRequested".
314 >    see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
315 >
316 > 34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
317 >
318 > 35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
319 >    palette. This uses the online validation feature added in Firebird 2.5. The
320 >    services's properties enable inclusion/exclusion of tables and indexes using
321 >    regular expressions. See.
322 >    https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
323 >
324 > 36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
325 >    option on a database.
326 >
327 > 37. TIBCustomService: Assign method implemented to allow copying of service login
328 >    context between service API components. "Detach" method now only detaches
329 >    service when last reference to the service interface detaches. Tidy up of
330 >    code for SetActive and Attach methods including password hiding.
331 >
332 > 38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
333 >    and used to determine the auth method and protocol used for the connection.
334 >
335 > 39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
336 >    a Create Database Statement generated by IBX.
337 >
338 > 40. All IBServices now have an additional published property "PortNo". This may
339 >    be set to a non-standard port number when necessary. If zero then the default
340 >    port number is used.
341 >
342 > 41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
343 >    and not just the mouse.
344 >
345 > 42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
346 >
347 > 43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
348 >    image index and selected image index for each node to be set from a database field.
349 >
350 > 44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
351 >    then database schema includes grants to all users. If not present then the
352 >    only user grants included are those to User PUBLIC.
353 >
354 > 45. TIBTreeView: performance improvement. When expanding include both expanded node
355 >    and child nodes in dataset.
356 >
357 >
358 > IBX Change Log  version                            (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
359  
360   1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf
361     changes.
# Line 9 | Line 366 | IBX Change Log  version
366   3. Changes consequential on moving fbintf character set utility functions from
367     IFirebirdAPI to IAttachment.
368  
369 + 4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true
370 +
371 + 5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally
372 +   results in autocomplete ignoring prefix text.
373 +
374 + 6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when
375 +   entering a new name into the text box.
376 +
377 + 7. IBCustomDataset: ensure that TIBStringField uses the field size reported by
378 +   Firebird rather than recomputing it.
379 +
380 + 8. Property Editor positioning tidy up: All IBX Property editors should now be
381 +   screen centre. Previously some were "poDesigned" which may be inappropriate
382 +   for multi monitor desktops.
383 +
384 + 10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node.
385 +
386 + 11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending
387 +    a transaction and always reset the object.
388 +
389 + 12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows.
390 +
391 + 13. TIBXScript: Allow for override of database filename in Create Database statements.
392 +
393 + 14. IBLocaldb: Support initialisation of the database from an SQL script in addition
394 +    to a gbak format archive.
395 +
396 + 15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised.
397 +
398 + 16. IBLocaldb: Drop database if error creating an empty database.
399 +
400 + 17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset
401 +    unless selected node not in current dataset.
402 +
403 + 18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package)
404 +    to TIBCustomService, and IBlocalDB code tidy up.
405 +
406 + 19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable
407 +    behaviour due to uninitialised variable.
408 +
409 + 20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from
410 +    integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode.
411 +
412 + 21. IBSQL: When Database changed ensure that all resources are freed.
413 +
414 + 22. IBCustomDataset: When database changed ensure that queries an unprepared.
415 +
416 + 23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include:
417 +    * Line Wrap on SQL Token boundaries (on user command)
418 +    * auto-complete table names in drop down list of table names
419 +    * Double click on tablename or field name adds to SQL text
420 +
421 + 24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d).
422 +
423 + 25. IBTreeView: Call to FindNode: param type change from "array of Variant" to
424 +    TVariantArray. Seems to avoid memory corruption in Windows (probably a
425 +    workaround for a problem in fpc 3.0.4 win64).
426 +
427 + 26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open.
428 +
429 + 27. IBDatabaseInfo: Remove memory leak when accessing database operation counts.
430 +
431   IBX Change Log  version                   (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000
432  
433   1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to
# Line 29 | Line 448 | IBX Change Log  version
448     that BindFields is called when the query is next activated. Avoids FieldName
449     not found error.
450  
451 + 7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general
452 +   purpose and allows the programmer to define any action they want for Update, Insert
453 +   or Delete. This may be complex SQL (similar to a Trigger), application specific
454 +   filtering of updates, or use of statements such as Grant or Revoke instead of
455 +   normal DML. See User Manual for more information.
456 +
457   IBX Change Log  version                  (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
458  
459   1. TIBEvents: Fix uninitialised variable that could result in lost events.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines