ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
Revision: 430
Committed: Thu Jan 4 11:57:50 2024 UTC (3 months, 3 weeks ago) by tony
File size: 85228 byte(s)
Log Message:
Fixes 5 and 6 - see changelog

File Contents

# User Rev Content
1 tony 430 IBX Change Log version (2.6-4 Build 14165) Sat, 30 Dec 2023 16:04:23 +0000
2 tony 426
3     1. TIBCustomDataSet.ApplyUpdates: ensure controls are not permanently disabled
4     if ApplyUpdates called before a cursor exists.
5    
6     2. TIBCustomDataSet.CreateBlobStream: add check for empty dataset before
7     creating the blob.
8    
9 tony 427 3. TIBCustomDataset.Requery: The display buffer pool is now also reset avoiding
10     issues with left over pointers to invalid internal buffers.
11    
12 tony 429 4. TIBCustomDataset.PrimaryKeys when used in InternalRefresh. when more than one
13     primary key is used by the dataset then the list of primary keys is now
14     properly separated by a ';'.
15    
16 tony 430 5. When refresh is called for a dataset without any primary keys (e.g. views and
17     stored procedures), the internal record number is now used to restore the cursor
18     following the refresh. However, it should be noted that cannot be 100% reliable.
19     The internal record number simply reflects the record fetch order and this can
20     change between successive queries if records are inserted or deleted by the
21     current or another user (if the read_committed transaction isolation level is used).
22    
23     6. Inserting a record at the start of a grid and then resizing the grid should
24     no longer result in an apparent duplication of records in the grid. Note: this
25     was due to TDataset.SetCurrentRecord ignoring the bookmark flag (bfInserted). IBX
26     works around this by no longer using this bookmark flag value.
27    
28 tony 421 IBX Change Log version (2.6-3 Build 14080) Sat, 21 Oct 2023 14:14:22 +0100
29    
30     1. Update to calls to EInterbaseError to add default code page. Consequential
31     on change to fbintf.
32    
33     2. Update some examples to replace test for null date with the NullDate constant
34     instead of zero. This is because Laz 3.0 changes the value of NullDate.
35    
36 tony 419 IBX Change Log version (2.6-2 Build 14016) Sat, 05 Aug 2023 11:54:55 +0100
37 tony 416
38     1. Fixed repeated "type" keyword in IBBufferCursors. This may cause a compile error
39 tony 418 with later versions of fpc - later than 3.2.2.
40 tony 416
41 tony 418 2. IBUpdateSQL. update internal queries if parent dataset database changed.
42    
43     3. IBUpdateSQL: Do not prepare an empty internal query.
44    
45 tony 419 4. IBBufferedCursors: avoid range error when max field no. is > fields.count
46 tony 418
47 tony 419 5. IBBufferedCursors: avoid End of File error if refresh query returns and empty row count
48    
49 tony 412 IBX Change Log version (2.6-1 Build 13985) Mon, 17 Jul 2023 14:16:41 +0100
50    
51     1. Maintenance update of 2.6.0. This version is still at beta.
52    
53     2. Reverse out changes to DrawCellText signature in IBArrayGrid and IBDynamic Grid.
54     See https://gitlab.com/freepascal.org/lazarus/lazarus/-/commit/53aaae9c5e2a5edac5b1d2f70739a8ef7b0a9623
55    
56     3. ibxscript: When parsing a store procedure or function with a variable name
57     enclosed in doublequotes, the double quotes are no longer removed.
58    
59 tony 410 IBX Change Log version (2.6-0 Build 13976) Thu, 22 Jun 2023 13:49:22 +0100
60 tony 407
61 tony 410 NOTE: THIS VERSION RE-WRITES THE INTERNAL BUFFER MANAGER AND SHOULD BE CONSIDERED
62     AS BETA SOFTWARE. EVEN THOUGH IT HAS PASSED ALL REGRESSION TESTS, IT CANNOT
63     BE ASSUMED TO BE PRODUCTION READY UNTIL WIDER USE. PLEASE REPORT ANY
64     ISSUES TO support@mwasoftware.co.uk
65    
66     1. Complete rewrite of internal buffer management in order to improve performance
67     and maintainability. Highlights:
68    
69     * Extending the size of the buffer pool no longer has to copy the entire record
70     cache. Instead, a new extent is simply added to the buffer pool.
71     * A memory to memory copy of each display buffer now is avoided when scolling the
72     dataset.
73     * A separate set of buffers is now used for calculated fields. This avoids
74     having to keep copies of calculated field values in the buffer cache.
75     * Compact bitmaps are used to record null status and need to refresh in each
76     buffer.
77     * Display buffer type changed from PChar to TRecordBuffer in line with change of
78     buffer type in FCL-DB.
79    
80     2. TIBUpdateSQL: changes to SQL text will close linked dataset if open. This is
81     to ensure same behaviour as TIBDataset, TIBTable and TIBStoredProcedure.
82    
83     3. TField Provider Flags: pfRefreshOnInsert and pfRefreshOnUpdate are now supported.
84     If either or both of these flags are set at design time (using the fields editor)
85     then this forces a row refresh on respectively insert or update, or both, when the
86     corresponding field is not present in an SQL RETURNING clause.
87    
88     4. TIBCustomDataset.FieldDefsFromQuery moved to a helper class (TFieldDefsMaker) in order to improve
89     maintainability and readability and to add identification of primary key fields.
90    
91     5. TIBQuery, TIBDataset and TIBTable. Traditionally, IBX has implemented the Refresh method
92     as a refresh of the current row. However, this is different behaviour to that described
93     in the FPC documentation for TDataset.Refresh which is described as "refetches the data in
94     the dataset from the underlying database, and attempts to reposition the cursor on
95     the same record as it was". IBX now complies with the FPC definition of Refresh.
96    
97     6. A progammatic Row Refresh should no longer be required.
98     Use Insert/Update... returning to refresh any fields that may change following an
99     insert or update i.e. Identify fields on Insert only, Computed By, Blob and array fields
100     on both. If there are any other fields (e.g. updated by triggers) set the appropriate ProviderFlag
101     for the field at Design Time to force a row refresh if not in the returning clause.
102    
103     7. It should now be possible to insert a row into an empty unidirectional dataset.
104    
105     8. New TIBQuery, TIBDataSet and TIBTable property: BufferChunksInFirstBlock (default 50).
106     This gives the number of buffers in the initial block for the buffer pool in
107     bi-directional datasets. BufferChunks (default 1000) gives the number of buffers
108     in subsequent buffer pool blocks. This avoids large and mostly unused memory allocations
109     for small datasets.
110    
111     IBX Change Log version (2.5-1 Build 13927) Tue, 6 Dec 2022 23:13:00 +0000
112    
113 tony 407 1. IBCustomDataset: avoid problem with additions to TFieldType by using a subset instead.
114    
115     2. TIBDynamicGrid: change DrawCellText declaration to comply with laz 2.3.0
116    
117 tony 409 3. TIBArrayGrid: change DrawCellText declaration to comply with laz 2.3.0
118    
119 tony 402 IBX Change Log version (2.5-0 Build 13868) Fri, 29 Jul 2022 09:52:01 +0100
120    
121     1. TIBTransaction: new properties
122     property TransactionID: integer read GetTransactionID;
123     property IsReadOnly: boolean read GetIsReadOnly;
124     {published}
125     property TransactionName: string read FTransactionName write SetTransactionName;
126    
127     2. IBCustomDataset: per row blob and array buffer cached clear before processing
128     Insert or Update...Returning. This allows blobs and arrays to be returned
129     by the statement.
130    
131     3. TSQLXMLReader moved from IBXScript to package fbintf unit IBUtils.
132    
133     4. TransactionName initialised to a newly generated GUID if empty.
134    
135     5. New unit: IBJournal. This provides the TIBJournal component which is a wrapper
136     for the fbintf package's journaling capability. TIBJournal is used to set the
137     file path and filename for the journal file and to Enabled (start journaling) and
138     disable (stop journaling). See fbintf/doc/README.ClientSideJournaling.pdf for
139     more information, and comments in IBJournal.pas.
140    
141     6. TIBDatabase.InternalTransaction is now a read only transaction.
142    
143     7. Bug fix: blob id no longer set to null on update when blob has not been
144     retrieved.
145    
146     8. Row auto refreshed on update/insert if blob or array field updated and field
147     not in a returning clause.
148    
149     9. ColumnCount moved from record buffer header to a single per dataset count. Reduces
150     buffer overhead and avoids problem when refresh query has a different column
151     count to select query i.e. incorrectly changing number of columns.
152    
153     10. IBExtract: support added for UDR Functions, Procedure and Trigger declarations.
154    
155     11. TIBDatabaseInfo. New property FirebirdVersion. This returns the current Firebird version
156     string. Note that the Version property returns an InterBase compatible version string.
157    
158     12. IBExtract: ensure sql identifiers returned as a LIST are always quoted.
159    
160 tony 359 IBX Change Log version (2.5-0 Build 12933) Mon, 29 Nov 2021 14:59:54 +0000
161    
162     1. IBCustomDataset: Modify TISQL component now defaults to GoToFirstRecordOnExecute := true.
163     This is for compatibility with Firebird 5 where Update...Returning can return
164     a cursor.
165    
166 tony 356 IBX Change Log version (2.4-3 Build 12886) Sat, 23 Oct 2021 14:58:30 +0100
167 tony 347
168     1. Add try-..except check when initially loading library in IDE. This should
169     ensure that IDE continues to load even when a failure occurs in IBX load
170     library.
171    
172 tony 348 2. IBXScript: now recognises a CASE...END block within a stored procedure and
173     hence will correctly detect end of the outer containing block when the block
174     contains a SELECT ... CASE ... END construct.
175    
176     3. IBExtract: some further tidying up to remove extraneous white space.
177    
178 tony 349 4. IBCustomDataSet: DefaultFieldClasses array declaration updated to avoid compile time
179     errors when extra elements are added to DB.TFieldType.
180    
181     5. IBUpdate: updated to reflect changes to ISQLParam.
182    
183     6. IBXScript: now correctly parses a DECLARE statement which includes a quoted string.
184    
185     7. IBExtract: for ODS >=13, increment generator value by one for ALTER SEQUENCE statement.
186    
187 tony 353 8. IBSQL: Support for scrollable cursors added (note: local databases only)
188    
189 tony 345 IBX Change Log version (2.4-2 Build 12773) Mon, 23 Aug 2021 11:59:42 +0100
190    
191     1. TIBDatabaseInfo: review and tidy-up of property types. Most widen to int64 with the
192     exception of those defined to be one byte wide e.g. DBImplementationNo.
193    
194     2. TIBSQL: Batch Update/Insert support added.
195    
196     3. TIBStoredProc: when generating the SQL, the value of the StoredProcName property
197     is no longer automatically converted to upper case when it is syntactically a
198     SQL Identifier. This is to support the use of stored procedures defined e.g.
199     as CREATE PROCEDURE "iCASE".
200    
201     There could be a backwards compatibility issue when the StoredProcName was entered
202     manually at design time. That is not selected from the drop down list. If the
203     StoredProcName is entered in mixed case and the procedure was declared e.g. as
204     CREATE PROCEDURE iCASE, then the SQL generation will be incorrect. You should
205     ensure that the value of the StoredProcName is all upper case, unless it was
206     declared under dialect 3 and explicitly as mixed case (i.e. delimited by double
207     quotes).
208    
209     Note that when a stored procedure name was declared delimited in double quotes,
210     as in the first example above, the value of the StoredProcName property must not
211     include the delimiters (double quotes).
212    
213     4. IBXUpgradeConfFile: an exception is now raised if a patch file specified in
214     upgrade.conf was not found. This replaces silently ignoring the problem.
215    
216     5. TIBLocalDBSupport: new property "SectionHeaderTemplate". This defaults to
217     'Version.%.3d' and is used to generate the section header names (for a given
218     version no.) in the upgrade.conf file.
219    
220 tony 340 IBX Change Log version (2.4-1 Build 12550) Wed, 23 Jun 2021 13:59:14 +0100
221    
222     1. -c command line option added to fbsql example program. Used to set connection
223     character set.
224    
225 tony 338 IBX Change Log version (2.4-0 Build 12543) Mon, 22 Feb 2021 11:00:08 +0000
226 tony 315
227     1. Firebird 4 support added.
228    
229     2. New FB4 data types TIME WITH TIME ZONE, TIMESTAMP WITH TIME ZONE, DECFLOAT and
230     extended precision NUMERIC fields are supported.
231    
232     3. TFmtBCDField is used to support access to DECFLOAT and extended precision NUMERIC fields.
233    
234     4. TIBDateTimeField and TIBTimeField are introduced in support of TIMESTAMP WITH TIME ZONE
235     and TIME WITH TIME ZONE fields. These inherit from TDateTimeField.
236    
237     5. IBExtract now supports FB4 enhancements:
238     - new data types as above
239     - Identity column extensions
240     - Default user role
241     - SQL Security clause for Database, Tables, Procedures, Functions and Triggers
242     - Internal Functions
243    
244     6. IBExtract: new event: OnExtractLines.
245    
246     7. IBExtract: revert create trigger to legacy syntax see Firebird CORE-6243, CORE-5545 and DOC-145
247    
248     8. IBXServices: Server version no. parsing now allows any letter before major version number
249     and is no longer restricted to 'V' e.g. "LI-T4.0.0.1436 Firebird 4.0 Beta 1"
250    
251     9. TIBDataSet and TIBQuery: new property TZTextOption. Used to determine the default
252     format for rendering a time zone.
253    
254     10. TIBDataSet and TIBQuery: new property DefaultTZDate. Used to provide the default date
255     to convert TIME WITH TIME ZONE data type values to and from GMT.
256    
257     11. Unit name IBTypes changed to IBInternals. Internal interfaces TIBGUIInterface and TIBTimerInf renamed to
258     IIBGUIInterface and IIBTimerInf respectively.
259    
260     12. Constants: DPBPrefix and TPBPrefix moved to IB unit. DPBConstantNames and TPBConstantNames
261     now accessible as properties of TIBDatabase and TIBTransaction respectively.
262    
263     13. String Fields: when a fixed character with (CHAR) field is returned, it is now
264     truncated to its fixed character width rather than being right padded with
265     white space to the maximum data size.
266    
267     14. TIBTable.Empty table. In additional to deleting all records in the underlying
268     table, the internal buffers are now also flushed ensuring that the TIBTable is
269     also empty.
270    
271     15. TBatchSQLStatementReader: Line buffer is now cleared on call to reset.
272    
273     16. TIBXControlService descendents: DatabaseName may now be set using a database
274     connect string. The database name is extracted from the connect string.
275    
276     17. DBControlGrid: Minor bug fixes. avoid AV on form closure, avoid black panel
277    
278     18. TIBExtract: Data type of COMPUTED By columns is no longer included in SQL.
279    
280     19. Local database on Linux and with legacy API and FB 2.5 embedded server: fixed problem with password
281     not being present as required.
282    
283     20. IBTreeView split into DBTreeView and IBTreeView. This former is an IBX indepedent
284     version that can be customised to work with other database drivers.
285    
286 tony 319 21. ISQLMonitor: use platform specific LineEnding to delimit messages. Avoids
287     unnecessary CR at end of line on Unix platforms.
288    
289     22. ISQLMonitor: Unix: Default semaphore timeout increased from 1 second to 10
290     seconds in order to reduce risk of message loss.
291    
292     23. ISQLMonitor: read and write count statistics now available via:
293     property TIBSQLMonitor.ReadCount;
294     IIBSQLMonitorHook.GetWriteCount: integer;
295    
296     24. ISQLMonitor tidy up and unit split. IPC functions moved to new unit IBIPC.
297    
298 tony 312 IBX Change Log version (2.3-5 Build 12350) Tue, 25 Aug 2020 16:11:02 +0100
299 tony 308
300     1. TIBStringField: when a string value is read from a dataset buffer, if the
301     number of UTF8 characters exceeds the string size then string is truncated
302     to the maximum string size. This is usually a problem with fixed width columns
303     right padded with white space.
304    
305     2. SQLFiltered and SQLFilterParams added to TIBQuery, TIBTable and TIBDataset.
306     If SQLFiltered is set then when a dataset is opened, each line in the
307     SQLFilterParams property is assumed to be a SQL condition clause and
308     ANDed into the Where clause of the SQL Select statement provided as a
309     dataset property. Each such SQL condition thus acts as an additional filter
310 tony 315 on the dataset.
311 tony 308
312     3. The Filtered property inherited from TDataset is no longer used for SQL (server
313     side filters).
314    
315 tony 311 4. IBLookupComboEditBox: Selection should no longer reset to start of text when
316     text matches complete entry.
317    
318     5. TIBDataLink: Detail Dataset params not refreshed unless both master and detail
319     dataset are active (avoids risk of access violation if master is inactive)
320    
321     6. TIBEvents: Registered property can now be set at design time even if database not open
322    
323     7. TIBEvents: component now correctly re-initialised after call to UnregisterEvents.
324     This should prevent "spillover" of events between sessions.
325    
326     8. TIBCustomDataset: GetNextRecord now called when reseting to first record of a unidirectional dataset.
327     This should ensure that the internal buffer is set up correctly and avoids
328     a duplicate initial row.
329    
330     9. TIBStringField: DataSize now given as byte size of string less trailing any zero character.
331     That is, the DataSize should be the field size * character set width. The
332     value returned by DataSize is now the same as the Dataset buffer size reserved
333     for the field.
334    
335 tony 312 10. IBExtract: Tidyup of SQL generation. Avoid unnecessary double quotes.
336 tony 311
337     11. TIBCustomDataset: Add checks on buffer sizes when copying data from row to field buffer
338     and vice-versa. This may result in an exception being raised (correctly) for
339     older programs when using dataset fields added to a form and the database has been
340     upgraded. For example, computed fields can change from 32-bit to 64-bit integers.
341     In such cases, the field needs to be deleted in the IDE fields editor and then
342     added back in.
343    
344 tony 312 12. IBCustomDataSet: CanInsert, CanEdit, CanDelete and CanRefresh updated to return
345 tony 315 false if query contains only white space and not just empty.
346 tony 312
347 tony 311 12. IBCustomDataset: Blob data is now cleared when TDataSet.Cancel is called. This
348     should ensure that (e.g.) a TDBMemo is correctly refreshed after a dataset edit
349     is cancelled.
350    
351 tony 315 13. IBCustomDataset: SetArrayIntf should no longer cause an access violation if
352     called on a null field.
353    
354     14. IBCustomDataSet: An access violation should no longer occur when calling CancelUpdates
355     results in an empty dataTC86 Client side Filtered Dataset 1 X
356     set.
357    
358     15. IBCustomDataSet: OnUpdateError should now be called in all circumstances when
359     a cached update is applied and an exception is raised.
360    
361     16. IBCustomDataSet: Avoid access violation when SetBookmarkData called with nil pointer.
362    
363     17. Console Mode Local Database support: backup/restore should now work correctly.
364    
365     18. Local Database Support: if an upgrade fails, a downgrade is now performed if
366     possible and an exception raised.
367    
368     19. MinimumVersionNo added to Local Database Support. Database will not open if
369     below this version no. and upgrade not possible.
370    
371 tony 307 IBX Change Log version (2.3-4 Build 12041) Fri, 17 Apr 2020 14:00:32 +0100
372 tony 306
373 tony 307 1. TIBXDataSet and Generators: Generator Names that are not all upper case or
374     not SQL Identifiers are now supported.
375 tony 306
376 tony 307 2. TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is
377     passed to the Firebird engine for execution.
378 tony 306
379 tony 307 3. TIBDataSet: Unidirectional datasets now give an error message if an attempt
380     is made to scroll back.
381 tony 306
382 tony 307 4. New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf
383 tony 306
384 tony 307 5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now
385     only enclosed in double quotes in SQL dialect 3 and when it needs to be.
386 tony 306
387 tony 307 6. TIBLookupComboEditBox: when the list source opens, the ListField name is now
388     validated. If no match is found in the list of field names and the database has
389     been opened in SQL Dialect 3, then the ListField Name is converted to upper case
390     if it then matches a field name. Otherwise, a Listfield not valid exception occurs.
391 tony 306
392 tony 307 7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance
393     with fpc 3.2.
394 tony 306
395 tony 307 IBX Change Log version (2.3-3 Build 11512) Fri, 28 Dec 2018 10:04:17 +0000
396 tony 287
397    
398 tony 307 1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides"
399     and is used to override the default settings in the client side "firebird.conf" This
400     includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings".
401     Each line of the string list should be a setting in the same format as "firebird.conf".
402     For example "WireCompression = true" in order to request wire compression on the client side.
403 tony 287
404 tony 307 Note: explicit settings in the client side "firebird.conf" appear to take precedence
405     over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings
406     also require a compatible setting in the server side "firebird.conf". For example
407     "WireCompression = true" must also be set in the server's "firebird.conf" for wire
408     compression to be used.
409 tony 291
410 tony 307 Whether or not WireCompression or WireCrypt are in use can be checked using the information
411     returned with the Client/Server protocol version. See ibx/examples/dbadmin and
412     ibx/examples/dbinfo for examples of how to display this information.
413 tony 291
414 tony 307 2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This
415     is a "convenience" property. If set the "WireCompression=true" is added to the
416     ConfigOverrides. If unchecked then this setting is removed.
417 tony 291
418 tony 307 3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and
419     not "INT64".
420 tony 291
421 tony 307 4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut
422     These are:
423     property TimestampFormat: string;
424     property DateFormat: string;
425     property TimeFormat: string;
426 tony 291
427 tony 307 Respectively, these provide the date time format templates for SQL types: TIMESTAMP,
428     DATETIME and TIME. The format strings use the standard FPC date/time format
429     characters (see https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html).
430 tony 266
431 tony 307 If any of the above properties are set to an empty string, then the locale default
432     is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the
433     locale default is extended by appending '.zzz' to include milliseconds.
434 tony 272
435 tony 307 TIBCSVDataOut by default sets these properties to the empty string, while the other
436     two use: 'yyyy.mm.dd hh:nn:ss.zzz', 'yyyy.mm.dd' and 'hh:nn:ss.zzz' respectively.
437 tony 266
438 tony 307 5. New published property for TIBCSVDataOut:
439     property QuoteStrings: boolean (default true)
440 tony 266
441 tony 307 If false then strings are unquoted, otherwise, the QuoteChar property value is
442     used to delimit each and every string in the output.
443 tony 263
444 tony 307 6. New published properties for TIBCSVDataOut:
445     property FieldSeparator: string;
446     property HeaderSeparator: string;
447 tony 267
448 tony 307 Respectively, these provide the separator character(s) used to separate fields
449     in data and header rows. Both default to ','.
450 tony 270
451 tony 307 7. New published properties for TIBCSVDataOut and TIBBlockFormatOut:
452     TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object;
453     property OnFormatTextString;
454 tony 270
455 tony 307 This event handler can be used to process text strings before they are included
456     in the output e.g. to replace unprintable characters with alternative strings.
457     This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT.
458 tony 270
459 tony 307 8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name.
460     Uses "FindParam" if in order to find out if a parameter with a given name exists
461     and without raising and exception if it does not.
462 tony 270
463 tony 307 9. TIBQuery now uses IBX SQL Parser instead of the TParams SQL parser in order to ensure
464     consistency with SQL queries.
465 tony 270
466 tony 307 10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery.
467     When true, SQL statement parameter names are parsed case sensitive. Note for
468     TIBDataSet only applies to Select query.
469 tony 270
470 tony 307 11. IBEvents: removing a TIBEvent component from a form should no longer result in
471     an IDE exception.
472 tony 270
473 tony 307 12. LocalDBSupport: initial database creation should now work correctly
474     when the schema source is an sql file.
475 tony 270
476 tony 307 13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent"
477     when defined, this handler will be called by the internal TIBXScript during
478     initial database creation when the schema source is an sql file and may be used
479     to provide a visual indication of progress in console mode.
480 tony 270
481 tony 307 14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set
482     to true while a new local database is being created and its schema populated.
483     Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions
484     when the database is disconnected/connected during the create DB procedure.
485 tony 270
486 tony 307 15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement
487     are now always ignored and replaced by the user name and password provided as
488     the login parameters for the TIBDatabase referenced from the TIBXScript. The
489     IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is
490     completely ignored if this property is true.
491 tony 270
492 tony 307 16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes
493     to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise
494     ImageIndex and SelectImageIndex values on AddNode.
495 tony 270
496 tony 307 17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now
497     read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share
498     the same database connection.
499 tony 270
500 tony 307 18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property.
501     if provided, this should be an conditional SQL expression suitable for
502     including in an SQL Select statement "where" clause. If non-empty and the
503     "Filtered" property is true then the SQL expression provided as the value of
504     the "Filter" property is "ANDed" with any existing condition statement
505     in the SQL statement's "Where" clause.
506 tony 270
507 tony 307 If the "Filter" property is set at run time, the "Filtered" property is true
508     and the dataset is already open, then the dataset is closed and re-opened automatically.
509 tony 271
510 tony 307 The "Filter" condition may include IBX style parameters. In which case, their
511     value must be set by the dataset's "OnBeforeOpen" event handler.
512 tony 272
513 tony 307 This is a public property for TIBDataSet and TIBQuery query and intended for
514     use at run time.
515 tony 272
516 tony 307 Note: The property is a published property of TIBTable. The TIBTable functionality
517     is unaffected by this change.
518 tony 272
519 tony 307 IBX Change Log version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000
520 tony 272
521 tony 307 1. Remove need to check for IsMultiThread by providing access to GUI timers via
522     IBGUIInterface. Note: master/detail delay timer does not apply to console
523     mode apps.
524 tony 272
525 tony 307 2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select
526     statement. This avoids problems if "Execute Block" is used as the Query.
527 tony 272
528 tony 307 3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the
529     internal SQL tokeniser routines.
530 tony 272
531 tony 307 4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse
532     as a select statement, with or without CTEs.
533 tony 272
534 tony 307 5. IBSQLParser: parser now recognises the "ROWS" clause.
535 tony 272
536 tony 307 6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the
537     internal SQL tokeniser routines.
538 tony 272
539 tony 307 7. Fix error in TIBXScript processing of "set" statements. This avoids exceptions
540     being raised for valid set statements processed by a data formatter.
541 tony 272
542 tony 307 8. New published property for TIBDatabase and TIBXServicesConnection. This is
543     FirebirdLibraryPathName: string. If not empty it is used to explicitly specify
544     the path of the Firebird Library used by the database/services connection.
545 tony 267
546 tony 307 9. New read only public property for TIBDatabase and TIBXServicesConnection. This
547     is FirebirdAPI and returns the IFirebirdAPI interface used by the database/
548     services connection.
549 tony 263
550 tony 307 10.SQL Property editors now quote parameter names if "Quote identifier" is selected
551     or param name is not a valid SQL identifier.
552 tony 263
553 tony 307 11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive
554     view of whether the text box should be editable when no DataSource is specified.
555     TIBLookupComboEditBox has been updated to workaround this problem. As long as
556     ReadOnly is false, the text box is editable when no DataSource is specified.
557 tony 263
558 tony 307 12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of
559     the FBLIB environment variable. If you do not want to permit this then you
560     must modify the Register procedure in the design/IBDBReg.pas unit to remove
561     this setting.
562 tony 263
563 tony 307 IBX Change Log version (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
564 tony 263
565 tony 307 1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
566     Utf8EscapeControlChars
567 tony 263
568 tony 307 IBX Change Log version (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
569 tony 263
570 tony 307 IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
571     all previous copies of the IBX source code tree before installing this release.
572 tony 263
573 tony 307 The IBX packages used by most users have not changed, with one exception. The
574     IBServices unit has been moved to the package iblegacyServices.lpk. To continue
575     to use the IBServices unit in your applications, please add the iblegacyServices
576     to the list of dependencies. To do this, open the Project Inspector and select
577     Add->New Requirement and select "ibLegacyServices" from the list of available
578     packages.
579 tony 263
580 tony 307 1. New unit IBXServices. The IBXServices unit is a re-architectured update of
581     the IBServices unit providing what is intended to be a clearer and easier to
582     use set of IB Services components. See Chapter 10 of the IBX User Guide for
583     more information and the guide to "Firebird Service Management Using IBX".
584     As indicated above, the legacy services components are still available and
585     provided in a separate package. There is no need to update working applications
586     using the older versions except for an additional package dependency.
587 tony 263
588 tony 307 2. The IBX packages and source code tree have been re-organised in an attempt to
589     finally get rid of the "duplicate ppu" warnings. This re-organisation should
590     not affect existing users. Section 2.3 of the IBX User Guide describes the
591     new set of IBX packages.
592 tony 263
593 tony 307 3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
594     updated to use the new Services API components.
595 tony 263
596 tony 307 4. The iblocal package has been updated to use the new Services API components.
597 tony 241
598 tony 307 5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
599     TIBXSecurityService. It had been wrongly classified in the previous version
600     as a per database configuration item. It is global to a server and hence
601     correctly positioned as part of the Security Package. In the DBAdmin example,
602     the setting has moved to the mappings page.
603 tony 241
604 tony 307 6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
605     are ignored.
606 tony 101
607 tony 307 7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
608     closed before the database is dropped. Before and After Disconnect event handlers
609     are also fired.
610 tony 209
611 tony 307 8. TIBTransaction: OnStartTransaction event now fires every time the transaction
612     is started and not just the first time.
613 tony 209
614 tony 307 9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
615     depenendency with comp type.
616 tony 209
617 tony 307 10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
618 tony 209
619 tony 307 11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
620     then this is recognised and not ignored.
621 tony 209
622 tony 307 12. TIBDataSet, TIBQuery, TIBTable: additions:
623     function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
624     function GetPerfStatistics(var stats: TPerfCounters): boolean;
625     property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
626 tony 209
627 tony 307 GetRowsAffected returns the affected row counts from the last insert/update/delete
628     if EnableStatistics = true then GetPerfStatistics returns the current stats
629     counters for the select query. Note: stats accumulate after each fetch from
630     the database. To get total query cost after open, call the "Last" method
631     and then GetPerfStatistics.
632 tony 209
633 tony 307 See ibx/examples/consolemode for an example of the use of GetPerfStatistics
634 tony 209
635 tony 307 13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
636     in parenthesises.
637 tony 209
638 tony 307 14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
639     SQL identifiers are always delimited by double quotes. If false, then they are
640     only delimited if the identifier is a reserved word, contains lower case or special
641     characters. Set this property to true to retain previous behaviour.
642 tony 209
643 tony 307 15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
644     are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
645 tony 209
646 tony 307 16. TIBDataSet, TIBQuery, TIBTable: addition:
647     property MasterDetailDelay: integer {defaults to zero}
648 tony 209
649 tony 307 When non-zero and the dataset is a detail table referencing a master table
650     through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
651     then a synchronisation delay is added (in milliseconds) between the master
652     row changing and the detail dataset being re-opened. If the master dataset
653     is scrolled before the delay expires then the delay is reset. This can be used
654     to avoid performance overheads when scrolling through a large master dataset.
655 tony 209
656 tony 307 Note: uses fptimer and hence requires a thread manager. Under Linux the
657     chreads unit must be included in your project. TTimer is not used in order
658     to avoid an LCL dependency. Requires FPC 3.0.2 or later.
659 tony 209
660 tony 307 17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
661     with Extract Option eoDatabase.
662 tony 209
663 tony 307 18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
664     When a deLayoutChanged event is reported on the ListSource dataset, the
665     combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
666     relationship with the control's datasource (master).
667 tony 209
668 tony 307 19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
669 tony 209
670 tony 307 20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
671     stubs. Pedantic fix really, as procedures output in dependency order anyway.
672 tony 209
673 tony 307 21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
674     DDL (Firebird 3 and later only).
675 tony 209
676 tony 307 22. TIBLookupComboBox Autocomplete Fixes:
677     i. Only appended text is now selected after autocomplete.
678     ii. Uppercase keys no longer ignored for autocomplete.
679     iii. Retain Prefix case is now honoured correctly.
680     iv. When a DataSource is assigned, typing after autocomplete now extends prefix
681     before autocomplete performed. i.e. behaviour now the same as when
682     no DataSource assigned.
683 tony 209
684 tony 307 23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
685     between SQL statements.
686 tony 209
687 tony 307 24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
688     ObjectNames are converted to upper case before matching against metadata object
689     names, unless the objectname is delimited by double quotes, in which case, the
690     double quotes are removed and the remaining string is used (unmodified) to match
691     against the metadata object name.
692 tony 209
693 tony 307 If true then the ObjectName is used as is without modification and matched
694     against the metadata object name. No attempt is made to remove double quotes.
695 tony 209
696 tony 307 25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
697     with eoTrigger, these extract types can be used to select only Database Triggers,
698     or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
699 tony 209
700 tony 307 26. TIBXScript: If an exception occurs during the processing of a statement, the
701     statement separate character is now reset to the default (';').
702 tony 221
703 tony 307 27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
704 tony 221
705 tony 307 28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
706     a commit or reconnect statement and instead activated only when next SQL statement
707     is executed.
708 tony 221
709 tony 307 29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
710 tony 225
711 tony 307 30. TIBXScript: case insensitive regex now used when matching statements instead of
712     converting statement to upper case.
713 tony 225
714 tony 307 31. TIBExtract: metadata comments now supported. New published property
715     IncludeMetaDataComments (default true). If true then metadata comments included
716     in extracted DDL. New Extract Object member eoComments. This may be used with
717     ExtractObject method to list all metadata comments.
718 tony 225
719 tony 307 32. TIBExtract: ListObjectNames method added.
720 tony 225
721 tony 307 33. Updated Database component editor to support additional connection string
722     types.
723 tony 226
724 tony 307 IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
725 tony 227
726 tony 307 NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
727     AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
728     RELEASE.
729 tony 229
730 tony 307 NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
731 tony 229
732 tony 307 1. IBExtract: Identity columns - add additional check for null column for generator name.
733 tony 229
734 tony 307 2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
735     The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
736     information). However, this is also a very useful mechanism for returning updated computed by
737     column values. Values returned as a result of executing an Insert or Update statement
738     replace existing values in the current row for each corresponding column.
739 tony 229
740 tony 307 Previously, if a dataset's select query included read only (computed by) fields then
741     an automatic row refresh was performed after an insert or update query had been processed,
742     irrespective of the setting of the "ForcedUpdates" property. This has changed such
743     that an automatic refresh is no longer performed if an insert or update query contains
744     a returning clause that updates one or more fields on the current row. A full row
745     refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
746     field values and the select query contains read only fields. Use of Insert/update
747     returning should be significantly more efficient than executing a refresh query.
748 tony 229
749 tony 307 This behaviour change is intended to be backwards compatible and there should be no need to change
750     existing programs, other than to improve performance by using the new capability.
751 tony 229
752 tony 307 3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
753     they are called when the dataset row is being deleted, there is no value in
754     updating the current record from the query result. Instead, a new event handler
755     "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
756     an OnDeleteReturning event handler is provided then it is called with the IResults returned
757     by the query. The event handler can then interrogate the query results and
758     perform whatever action is necessary. For example to confirm, to the user,
759     the deletion of a row with the returned values.
760 tony 231
761 tony 307 4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
762     any Computed By or Identity Columns. The IBTables example has been updated to
763     illustrate the computation of the employee Full Name on update.
764 tony 209
765 tony 307 5. TIBTable: The GeneratorField property is now published.
766 tony 151
767 tony 307 6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
768     When InsertSQL is generated, the Identity columns are not included in the list of values to
769     be inserted. A RETURNING clause is added to the insert statement to return the value of
770     each Identity column after the insert is executed.
771 tony 151
772 tony 307 7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
773     Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
774     Insert..Returning clause.
775 tony 101
776 tony 307 8. TIBGenerator: small performance improvement by not preparing query each time
777     a new value is generated.
778 tony 101
779 tony 307 9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
780    
781     10. Property editors will now sync table name to a System Table when "Include System
782     Tables" is selected and the query is for a System Table.
783    
784     11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
785     values are no longer converted to milliseconds from TDateTime and then back again
786     to TDateTime (the conversion to milliseconds is the default TDataset approach).
787    
788     12. Property Editors handling of Stored Procedures.
789     * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
790     which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
791     query).
792     * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
793    
794     13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
795     can be used to select a package. If non-empty, the stored procedure name is
796     expected to be a stored procedure defined in the specified package and the
797     generated SQL will be as required for a stored procedure located in a package.
798    
799     14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
800     a "Package Name" drop down box to allow selection of a Firebird 3 Package from
801     which a stored procedure can be selected. With no package name selected, non-package
802     stored procedures are listed.
803    
804     15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
805     for password on reconnect.
806    
807     16. TIBDatabase: use IAttachment for connection default character set id, code page
808     and character set name.
809    
810     17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
811     DB info lookups"
812    
813     18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
814    
815     19. Add a property Editor for TIBUpdate.RefreshSQL.
816    
817     20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
818     parameters. This stops an exception being raised when the field cannot be
819     located in the record buffer.
820    
821     21. Property Editors now automatically include System Tables when opened and when the query table
822     is a System Table.
823    
824     22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
825     This avoids errors due to a stale SQRB or SRB being used for the next query.
826    
827     23. IBServices: Service attach parameters now include "expected_db". This is used to
828     add the SPB item isc_spb_expected_db. This names a database using
829     an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
830     database. examples/services re-written to illustrate use of "expected_db".
831    
832     24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
833     This avoids truncated backups when the server returns a timeout (busy) response.
834    
835     25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
836    
837     26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
838     databasenames. These are respectively expanded to the local system's temp directory
839     (including trailing delimiter) or to a prescribed data directory (including
840     trailing delimiter). Under Unix systems the data directory is a hidden directory
841     in the user's home directory. The hidden directory name is either the string returned
842     from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
843     Under Windows, the directory is the same as the Data Directory as decribed
844     above but instead prefixed by the User's application data path. These may be
845     used to improve application portability for Personal Databases.
846    
847     27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
848     this has not worked for a long time and is not useful either. FieldDefs should be
849     managed using the Fields Editor as with any other dataset. To access the fields
850     editor for a TIBTable component, double click on the component. The fields editor
851     is then displayed.
852    
853     28. TIBDatabaseInfo: new properties/function
854     * DateDBCreated (returns date/time database created)
855     * TransactionCount (returns no. of active transactions)
856     * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
857     * PagesFree (Firebird 3 or later)
858     * PagesUsed (Firebird 3 or later)
859     * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
860     * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
861    
862     29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
863    
864     30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
865    
866     31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
867     the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
868    
869     32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
870     in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
871     firing during backup and restore.
872    
873     33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
874     for verbose output using the new property "StatisticsRequested".
875     see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
876    
877     34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
878    
879     35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
880     palette. This uses the online validation feature added in Firebird 2.5. The
881     services's properties enable inclusion/exclusion of tables and indexes using
882     regular expressions. See.
883     https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
884    
885     36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
886     option on a database.
887    
888     37. TIBCustomService: Assign method implemented to allow copying of service login
889     context between service API components. "Detach" method now only detaches
890     service when last reference to the service interface detaches. Tidy up of
891     code for SetActive and Attach methods including password hiding.
892    
893     38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
894     and used to determine the auth method and protocol used for the connection.
895    
896     39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
897     a Create Database Statement generated by IBX.
898    
899     40. All IBServices now have an additional published property "PortNo". This may
900     be set to a non-standard port number when necessary. If zero then the default
901     port number is used.
902    
903     41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
904     and not just the mouse.
905    
906     42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
907    
908     43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
909     image index and selected image index for each node to be set from a database field.
910    
911     44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
912     then database schema includes grants to all users. If not present then the
913     only user grants included are those to User PUBLIC.
914    
915     45. TIBTreeView: performance improvement. When expanding include both expanded node
916     and child nodes in dataset.
917    
918    
919     IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
920    
921     1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf
922     changes.
923    
924     2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString.
925     Bug could result in truncated multi-byte character set values.
926    
927     3. Changes consequential on moving fbintf character set utility functions from
928     IFirebirdAPI to IAttachment.
929    
930     4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true
931    
932     5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally
933     results in autocomplete ignoring prefix text.
934    
935     6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when
936     entering a new name into the text box.
937    
938     7. IBCustomDataset: ensure that TIBStringField uses the field size reported by
939     Firebird rather than recomputing it.
940    
941     8. Property Editor positioning tidy up: All IBX Property editors should now be
942     screen centre. Previously some were "poDesigned" which may be inappropriate
943     for multi monitor desktops.
944    
945     10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node.
946    
947     11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending
948     a transaction and always reset the object.
949    
950     12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows.
951    
952     13. TIBXScript: Allow for override of database filename in Create Database statements.
953    
954     14. IBLocaldb: Support initialisation of the database from an SQL script in addition
955     to a gbak format archive.
956    
957     15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised.
958    
959     16. IBLocaldb: Drop database if error creating an empty database.
960    
961     17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset
962     unless selected node not in current dataset.
963    
964     18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package)
965     to TIBCustomService, and IBlocalDB code tidy up.
966    
967     19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable
968     behaviour due to uninitialised variable.
969    
970     20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from
971     integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode.
972    
973     21. IBSQL: When Database changed ensure that all resources are freed.
974    
975     22. IBCustomDataset: When database changed ensure that queries an unprepared.
976    
977     23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include:
978     * Line Wrap on SQL Token boundaries (on user command)
979     * auto-complete table names in drop down list of table names
980     * Double click on tablename or field name adds to SQL text
981    
982     24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d).
983    
984     25. IBTreeView: Call to FindNode: param type change from "array of Variant" to
985     TVariantArray. Seems to avoid memory corruption in Windows (probably a
986     workaround for a problem in fpc 3.0.4 win64).
987    
988     26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open.
989    
990     27. IBDatabaseInfo: Remove memory leak when accessing database operation counts.
991    
992     IBX Change Log version (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000
993    
994     1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to
995     include remote system name.
996    
997     2. TIBExtract: No longer include comment header and COMMIT statement for empty
998     tables when data included in output.
999    
1000     3. Profiling: IBSQL now has conditional compilation flags to enable query performance
1001     and timing information to be written to stdout. This may be used to locate
1002     performance bottlenecks.
1003    
1004     4. SQLParser: only call "OnChanging" event handler when value is different.
1005    
1006     5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit
1007    
1008     6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures
1009     that BindFields is called when the query is next activated. Avoids FieldName
1010     not found error.
1011    
1012     7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general
1013     purpose and allows the programmer to define any action they want for Update, Insert
1014     or Delete. This may be complex SQL (similar to a Trigger), application specific
1015     filtering of updates, or use of statements such as Grant or Revoke instead of
1016     normal DML. See User Manual for more information.
1017    
1018     IBX Change Log version (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
1019    
1020     1. TIBEvents: Fix uninitialised variable that could result in lost events.
1021    
1022     2. TIBExtract: Added support for FB3 "USAGE" privilege.
1023    
1024     3. TIBExtract: data formatted as Charset set "octets" is now output using
1025     hexadecimal notation.
1026    
1027     4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements
1028     using a simple XML format.
1029    
1030     5. TIBExtract: extract of individual Triggers and Stored Procedures can now include
1031     grants to these objects.
1032    
1033     6. TIBExtract: Stored Procedures and Views output in dependency order to avoid
1034     dependency problems restoring complex databases.
1035    
1036     7. TIBXScript: This component has been restructured to allow for the processing of
1037     embedded XML in INSERT statements and to support interactive sources in addition
1038     to non-interactive data sources such as files.
1039    
1040     8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported.
1041    
1042     9. TIBXScript: ISQL compatiable Set statements are now supported:
1043     SET SQL DIALECT
1044     SET TERM
1045     SET AUTODDL
1046     SET BAIL
1047     SET ECHO
1048     SET COUNT
1049     SET STATS
1050     SET NAMES <character set>
1051    
1052     10. IBVersion unit added to hold current IBX Version Number information.
1053    
1054     11. TIBExtract: Use character rather than byte length for VarChar procedure arguments.,
1055     and domain definitions.
1056    
1057     12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers
1058     fully supported.
1059    
1060     13. TIBExtract: when a database dump includes data, the generator values are now also set.
1061    
1062     14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later.
1063    
1064     IBX Change Log version (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
1065    
1066     See also doc/IBX4LazarusGuide.pdf for important information on
1067     upgrading to IBX2.
1068    
1069     1. Size property of TIBStringField is now the width in characters of the field
1070     and not the byte length. This applies only to multi-byte character sets such
1071     as UTF8. The original approach aligned with TStringField. However, the TStringField
1072     code is not recognised as a bug and hence this change to align the behaviour.
1073     The TStringField change is expected in fpc 3.2.0.
1074    
1075     2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
1076     true (default) then Size property value saved in the lfm is ignored. Size is
1077     always set from the dynamic information read from the database. It is unclear
1078     why anyone would want to override this and set Size to false.
1079    
1080     3. ibxscript: should now handle correctly a Case..End statement within a procedure
1081     block.
1082    
1083     4. IBDatabase: new property - CreateIfNotExists. If true and database does not
1084     exist when an attempt is made to connect to it (run time only) then an attempt
1085     is made to create the database.
1086    
1087     5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
1088     has been successfully created as a result of a call to CreateDatabase or when
1089     creating a database after it was found not to exist.
1090    
1091     6. DBControlGrid: a race condition could result in the wrong row image being
1092     written to the cache. This has been avoided by a trip round the message
1093     loop before rendering the row image.
1094    
1095     7. DBControlGrid: It is strongly recommended not to open the source DataSet for
1096     a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
1097     known to risk corrupt rendering of row images when the control is first
1098     displayed. If necessary use "Application.QueueAsyncCall" to delay opening
1099     of the dataset (see DBControlGrid examples) until the Form's Window has been created.
1100    
1101     8. DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
1102     a TDateEdit control located on an editor panel.
1103    
1104     9. TIBExtract: brought up-to-date plus many bug fixes.
1105    
1106     10. DBControlGrid: Removed memory leak when updating rows.
1107    
1108     11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
1109    
1110     IBX Change Log version (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
1111    
1112     1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
1113     when target codepage is CP_NONE. This is a workaround for
1114     http://bugs.freepascal.org/view.php?id=30622.
1115    
1116     2. DBLog option removed from TIBStatisticalService - not supported by server
1117     since Firebird 1.5.
1118    
1119     3. ibxscript: An error is no longer generated for "on commit preserve rows" or
1120     similar.
1121    
1122     4. IBCodePage: updated mapping between codepages and character id.
1123    
1124     5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
1125     Firebird. Character sets with a char width of two are not UTF16.
1126    
1127     6. Strings received from the database are now always transliterated into UTF8
1128     regardless of the database character set or connection character set. This
1129     is for compatibility with the LCL.
1130    
1131     IBX Change Log version (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
1132    
1133     1. IBBlob: Defer reading of blob until read method called. This avoids having to
1134     read in an entire blob just to get the size of the blob. General performance
1135     improvement when opening datasets containing blobs.
1136    
1137     2. Clearing a Blob now sets the corresponding field's modified flag.
1138    
1139     3. IBLookupCombo: When not performing auto-complete, original query sort order
1140     is now used.
1141    
1142     4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
1143     determined.
1144    
1145     5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
1146    
1147     6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
1148     lazarus 1.6.0
1149    
1150     7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
1151     compilation error.
1152    
1153     IBX Change Log version (1.4-1) Tue, 17 May 2016 09:14:51 +0100
1154    
1155     1. No character set specified for connection: when a text blob is retrieved, the
1156     character set is determined by looking up the native character set using then
1157     Firebird API. Otherwise a text mode blob is assumed to have the same character
1158     set as the connection.
1159    
1160     2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
1161     for Login Dialog returing a change to the database path.
1162    
1163     3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
1164     to be changed from that given in the TIBDatabase/TIBServer component and for the
1165     entered value to be saved on a project specific basis (design time only).
1166    
1167     4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
1168     column fieldname. If they are the same then it is acts as a look up for the KeyValue
1169     Otherwise, it sets the column text to the selected ListField Value.
1170    
1171     5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
1172     column width.
1173    
1174     6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
1175     and a case insensitive search is requested.
1176    
1177     7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
1178     or column ListSource.
1179    
1180     8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
1181     unprepare) when closing and the text has not changed.
1182    
1183     9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
1184     Less likely to cause a cursor re-use error on Windows.
1185    
1186     10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
1187     Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
1188    
1189     11. TIBTreeView: Guard against nil destination on record changed
1190    
1191     12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
1192     string type with the code page set to reflect the returned field encoding after
1193     Firebird driver transliteration, if any. FPC 3.0.0 onwards only. Behaviour unchanged for
1194     earlier versions.
1195    
1196     13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
1197     will now result in transliteration to the code page specified for the Firebird driver
1198     if the assigned string has a different code page. FPC 3.0.0 onwards only.
1199    
1200     14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
1201     is ignored and the lc_ctype value, when the database is opened, is set to align with
1202     the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
1203     platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
1204     3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
1205     the GETACP is used to determine the Windows code page.
1206    
1207     15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
1208     name used as the lc_ctype when the database was opened. Only valid while the
1209     Database is connected.
1210    
1211     16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
1212     id that corresponds to the DefaultCharSetName.
1213    
1214     IBX Change Log version (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
1215    
1216     1. Unix: If Firebird Embedded Server shared object is loaded and a local database
1217     path is given and database attach fails due to access permission issues on the
1218     temp directory or security database, then the attach is retried with "localhost:"
1219     prefixing the databasename. This should avoid problems when the database has to
1220     be accessed by a local (e.g. classic) server and libfbembed is used.
1221    
1222     2. Windows: revised search order for Firebird DLL:
1223     i. The Firebird Embedded Server in the application Directory.
1224     ii. If the FIREBIRD environment variable is set then the directory this
1225     points to is searched for the FB Client DLL and then then underlying
1226     "bin" directory.
1227     iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
1228     is used to locate the Firebird installation directory and the underlying
1229     "bin" directory is searched for the FB Client DLL.
1230     iv. The Default installation directories C:\Program Files\Firebird\Firebird_2_x
1231     are searched for the FB Client DLL.
1232     v. The PATH Environment variable is used to search for the FB Client DLL.
1233     vi. Finally the PATH Environment variable is used to search for IBASE.DLL.
1234    
1235     3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
1236     See doc/readme.scriptengine and example applications.
1237    
1238     4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
1239     simplify the use of the embedded firebird server on both Linux and Windows platforms.
1240     See dpc/readme.localdatabase and example applications.
1241    
1242     5. IBDynamicGrid: Reordering on column header click should now also work for
1243     dynamic columns.
1244    
1245     6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
1246     between incrementing/decrementing the lock count and signalling the event.
1247    
1248     IBX Change Log version (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
1249    
1250     1.3.2 was never formally released and only made available as beta copies.
1251    
1252     1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
1253    
1254     2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
1255    
1256     3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
1257    
1258     4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
1259     i.e. when it is a calculated field
1260    
1261     5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
1262     This problem was due to a race condition between recalculating row heights and
1263     determining which row was selected by the mouse click. The row height calculation
1264     is now deferred by an extra trip round the message loop allowing the row to
1265     be always calculated on the current grid layout rather than risking it being
1266     calculated on the grid layout after the expanded row has been shrunk.
1267    
1268     6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
1269     Windows.
1270    
1271     7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
1272     These properties allow the (Firebird) character set name for the field and the max number of bytes per character
1273     to be determined at runtime. See doc/readme.charactersets.html.
1274    
1275     8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
1276     TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
1277    
1278     9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
1279     TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
1280     1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
1281    
1282     Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
1283     from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
1284     implies no truncation.
1285    
1286     10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
1287    
1288     11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
1289     (avoids "Not in Edit Mode" error).
1290    
1291     12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
1292    
1293     13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
1294     DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
1295    
1296     14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
1297    
1298     15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
1299    
1300     16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
1301    
1302     17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
1303    
1304     IBX Change Log version (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
1305    
1306     1. OnCloseUp Event Handler added to TDBLookupProperties
1307    
1308     2. IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
1309     problem with row size when exception is called.
1310    
1311     3. IBLookupComboEditBox: Force pending autocomplete on combobox exit.
1312    
1313     4. IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
1314     in a TCustomComboBox and ignores return key if in a TCustomMemo
1315    
1316     5. IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
1317     keyed in i.e. when autocomplete not performed
1318    
1319     6. Cleanup of "Uses" clauses and add console mode support. IBX should now support
1320     console mode applications with all LCL required functions (builtin dialogs and
1321     cursor management) centralised in the IBDialogs unit. As long as "IBDialogs" is
1322     not included in your project, IBX should compile and link with a console mode program.
1323     See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
1324     console mode application or the IDE will automatically assume that your
1325     application is GUI based. Instead, you should include the ibexpressconsolemode package.
1326    
1327     IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
1328     to use the built in dialogs and cursor management. IBDialogs is
1329     included by default if "ibexpress" is in your project source's "uses" clause.
1330     This should be the case for all projects created through the IDE. This is why
1331     you do not want to add the ibexpress package to console mode applications. The
1332     ibexpressconsolemode package has been created to allow console mode programs
1333     to avoid adding LCL dependencies when using IBX, while still having the
1334     unit search paths set up correctly.
1335    
1336     Existing users should check to ensure that the "ibexpress" unit is included in
1337     each project's source file (*.lpr).
1338    
1339     You may find that in order for the IDE to recognise that ibexpressconsolemode
1340     exists, you have to first open the package in the IDE and then close it. This
1341     adds it to the most recently accessed packages list. To make it permanently
1342     available, add the package name to lazarus' staticpackages.inc file.
1343    
1344     Thanks to Julio Jiménez for suggesting support of console mode.
1345    
1346     7. SQL Parser can now accept quoted strings that include new lines
1347    
1348     8. IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
1349     of text on start of edit. This is particularly useful when tabbing to a
1350     column and then inserting text.
1351    
1352     9. New Examples provided for IB Services and ISQLMonitor.
1353    
1354     10. Fix error when writing to blob streams that recorded only the last buffer
1355     write in the blob stream. In most cases, this did not cause a problem as the
1356     IB Blob Stream is written in a single write. However, with the TDBImage, write
1357     of a graphic type prefix was lost which caused a problem when the image could
1358     not be automatically recognised.
1359    
1360     11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
1361     already open" errors due to random numbers used for the cursor name being identical.
1362    
1363     12. IBTable: corrected error that could result in an "Index out of bounds" error
1364     when opening the table and the Primary Key is the last or only column in the
1365     table. Thanks to Rick Hoover for the fix.
1366    
1367     13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
1368     of "UTF-8", and update list of available database character sets. Existing
1369     users should check the current lc_ctype setting in their applications.
1370    
1371     IBX Change Log version (1.2-4) Sat, 09 May 2015 12:38:29 +0100
1372    
1373     1. Firebird Services: avoid List Index error when opening a service with an
1374     empty Params property.
1375    
1376     2. IBControls: Fix problem with new link mechanism introduced in 1.2.3.
1377     Link now set up in Loaded method - avoids occasional failure to apply
1378     SQL markup on initial open.
1379    
1380     3. "Employees" example performance improvements when scrolling.
1381    
1382     4. DBControlGrid: Correctly handle edit panel removal when panel is child control of a
1383     TFrame. Force recaching of selected frame to avoid GTK race (results in a
1384     random image cached).
1385    
1386     5. DBControlGrid: Should now react to changes in panel height at run time.
1387    
1388     6. IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
1389     even when further rows exist.
1390    
1391     7. DBControlGrid: DefaultRowHeight is no longer a published property as it should
1392     always be derived from panel height and setting this property can cause confusion.
1393     Note for existing projects: to avoid a missing property error at run time,
1394     each form using the DBControlGrid must be opened, updated and saved in the IDE
1395     in order to remove the property value from the lfm.
1396    
1397    
1398     IBX Change Log version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
1399    
1400     1. TIBStoredProc. Prepare now called by ParamByName to avoid need to always
1401     call Prepare before setting parameter values.
1402    
1403     2. Error message on ParamByName (all cases) not found now includes name of missing parameter.
1404    
1405     3. Code tidyup and more robust handling of dsql information result vector.
1406    
1407     4. Support for centralised handling of transaction status changes. TIBTransaction
1408     has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
1409     and "AfterExecQuery". The first three are called after the same event is called
1410     for an IBCustomDataSet descendent using the Transaction. The fourth is called
1411     after a call to TIBSQL.ExecQuery, again using this transaction. These new events
1412     enable monitoring of transaction status changes for a given transaction to be
1413     handled in a single place. For example, when a change to the dataset occurs
1414     an indicator can be set that shows the user that in order to save changes,
1415     the transaction should be committed. Rather than doing this per dataset, this
1416     can now be done per transaction.
1417    
1418     5. TDataSet.CheckBrowseMode automatically posts changes to the current row when
1419     the dataset is scrolled. However, any changes to the current row are, by default,
1420     discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
1421     have a new property "DataSetCloseAction" that adds automatic posting of changes
1422     on dataset close. If this property is set to dcDiscardChanges (default) then the
1423     behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
1424     then IBX will attempt to post any unsaved changes before the dataset is closed
1425     (and after the BeforeClose event handler is called). The exception is when the
1426     dataset is being closed as a result of a transaction rollback. In this case,
1427     no action is taken and any unsaved changes are discarded. This avoids both
1428     unnecessary overhead and the risk that a validation error may occur in the Post
1429     raising an exception and thereby preventing a rollback.
1430    
1431     6. String Field sizes and Display Widths should now be correct for multi-byte character sets.
1432     In earlier versions, the Display Width was set to the maximum byte width rather than the character
1433     width. Display Widths are now corrected by dividing by the max byte width per character.
1434     For UTF8 character sets, the byte width is four and hence the Display Width will be
1435     the byte width divided by 4. The byte width of each character set is determined
1436     dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
1437     system table. (see also http://bugs.freepascal.org/view.php?id=27766).
1438    
1439     7. SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
1440    
1441     8. IBLookupComboEditBox: List should now always be restored to full list when the
1442     control loses focus. Default Key press default interval reduced to 200ms.
1443    
1444     9. DBControlGrid: Ensure that selection is changed to newly appended row, even
1445     when dataset rows are less than visible rows.
1446    
1447     10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
1448     does not exist or DataSet is empty. More responsive on dataset open. New event
1449     OnRestorePosition. Column sort disabled if no header row.
1450    
1451     11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
1452     while dataset state is dsInsert. Avoids posting errors.
1453    
1454     12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
1455     avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
1456    
1457     13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
1458    
1459     14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
1460     to solve a specific problem. That is when the dataset cursor is moved (e.g. by
1461     a grid mouse click and the current row is being edited or inserted. In this case, TDataset
1462     always "posts" the current record regardless or whether or not it may be more appropriate
1463     to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
1464     "MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
1465     as the first action of the "Post" method and allows the handler to convert the Post
1466     into a Cancel if that is the appropriate action on moving to a different row. This is
1467     achieved by returning with "CancelPost" argument set to true. Note that an exception could be
1468     raised here, but it may still be more appropriate to validate a post and signal
1469     a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
1470    
1471     15. On Unix derived systems, the Firebird library name can now be given as a colon
1472     separated list. Each library name on the list is tried in turn, in left to right
1473     order with the first found being used as the firebird library. By default, on Linux,
1474     the library name list is 'libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so.2'. This can be
1475     overidden by the FBLIB environment variable or the OnGetLibraryName function.
1476    
1477     Note: when using the libfbembed.so, if you prefix the database name with "localhost:"
1478     then it will still attempt to access the database via the Firebird Server and will
1479     require a username and password. If only the pathname is given, then the username
1480     and password should be omitted and the unix file permissions are used to grant
1481     access.
1482    
1483     IBX Change Log version (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
1484    
1485     1. A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
1486     rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
1487     that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
1488     corresponds to a row of the linked DataSource. Any data aware control on the
1489     replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
1490    
1491     2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
1492     When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
1493     takes place during database access. This may be useful when there are performance issues with
1494     the change of cursor. Setting the property to false suppresses the change of cursor.
1495    
1496     3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
1497     and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
1498     Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
1499     making all changes permanent immediately rather than when the transaction is explicitly
1500     committed.
1501    
1502     4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
1503     using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
1504    
1505     IBX Change Log version (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
1506    
1507     Development version only.
1508    
1509     IBX Change Log version (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
1510    
1511     1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
1512     This is typically used during an "OnBeforeOpen" event handler to manipulate the
1513     "Where" and "Having" clauses to implement user specified filters of arbitrary
1514     complexity.
1515    
1516     2. A new Component Palette entry "Firebird Data Controls" is now available. This has
1517     three new data aware controls dependent on IBX and which make use of the SQL Parser.
1518     These are:
1519    
1520     - TIBLookupComboEditBox
1521     - TIBDynamicGrid
1522     - TIBTreeview
1523    
1524     TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
1525     of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
1526     to revise the available list and restrict it to items that are prefixed by the
1527     typed text (either case sensitive or case insensitive). Autoinsert allows a
1528     newly typed entry to be added to the list dataset and included in the available
1529     list items.
1530    
1531     TIBDynamicGrid is a TDBGrid descendent that provides for:
1532     - automatic resizing of selected columns to fill the available row length
1533     - automatic positioning and sizing of a "totals" control, typically at the
1534     column footer, on a per column basis.
1535     - DataSet resorting on header row click, sorting the dataset by the selected column.
1536     A second click on the same header cell reversed the sort order.
1537     - Support for a "Panel Editor". That is on clicking the indicator column, the row
1538     is automatically expanded and a panel superimposed on it. The panel can have any
1539     number of child controls, typically data aware controls with the same datasource
1540     as the grid allowing for editing of additional fields and more complex editors.
1541     - Reselection of the same row following resorting.
1542     - A new cell editor that provides the same functionality as TIBLookupComboEditBox.
1543     Its properties are specified on a per column basis and allows for one or more
1544     columns to have their values selected from a list provided by a dataset.
1545     Autocomplete and autoinsert are also available. The existing picklist editor
1546     is unaffected by the extension.
1547    
1548     TIBTreeView is a data aware TCustomTreeView.
1549    
1550     3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
1551     zero scale will no longer return an error. An Int64 will be returned instead.
1552    
1553     4. TIBTransaction now has events for Before and After Transaction End and a new function
1554     "GetEndAction" allowing the EndAction to be accessed by these event handlers.
1555    
1556     5. TIBQuery can now handle correctly queries which contain the same keyword parameter
1557     repeated multiple times.
1558    
1559     6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
1560     check used to get in the way of using Stored Procedures, and "Update or Insert"
1561     statements.
1562    
1563     7. Insert, Modify and Delete property Editors now support Query Generation from
1564     Stored Procedures.
1565    
1566     8. Three new examples illustrate the use of the new IB Controls
1567    
1568    
1569     IBX Change Log version (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
1570    
1571     1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
1572     setting performance. See "readme.field+param.names in the doc folder.(Thanks to
1573     Gabor Boros for reporting this problem and for testing the improvements).
1574    
1575     2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
1576     See readme.field+param.names in the doc folder.
1577    
1578     3. IBX SQL Editors will now automatically add double quotes around column names when the database
1579     dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
1580    
1581     4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
1582    
1583     5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
1584     actions.
1585    
1586     6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
1587     thanks to Yuriy Kopnin for pointing this out).
1588    
1589     7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
1590    
1591     8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
1592     for both fields and parameter setting.
1593    
1594     9. Changes to the Select SQL in an IBCustomDataset descendent should now be
1595     visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
1596    
1597     10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
1598     when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
1599    
1600     11. TIBTable now has a property editor for "MasterFields"
1601    
1602     12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
1603     GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
1604    
1605     13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
1606     of settings is unrecognised. Selecting this radio button has no effect on the settings.
1607    
1608    
1609     IBX Change Log version (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
1610    
1611     1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
1612    
1613     IBX Change Log version (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
1614    
1615     1. In a TIBCustomDataset descendent, a generator now only sets the value when
1616     it is null. This allows for alternative user defined setting of the generator
1617    
1618     Many thanks to Julio Jiménez for this fix
1619    
1620     2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
1621     and suggests that the user may have forgotten to install it.
1622    
1623     IBX Change Log version (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
1624    
1625     1. Conditional compilation used to limit registration of TIntegerField to
1626     Lazarus versions less than 1.1
1627    
1628     2. When a database connection is created, character set is now by default set
1629     to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
1630     1250 to 1254.
1631    
1632    
1633     IBX Change Log version (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
1634    
1635     1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
1636    
1637    
1638     IBX Change Log version (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
1639    
1640     1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
1641     Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
1642    
1643     2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
1644     package is changed to do this (which it should do).
1645    
1646     IBX Change Log version (1.0-0) Sat, 28 Apr 2012 16:43:00 +0100
1647    
1648     1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
1649    
1650     2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
1651    
1652     3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
1653    
1654     4. Property editors should now correctly resize.
1655    
1656     5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
1657     (restored original functionality)
1658    
1659     6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
1660     library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.

Properties

Name Value
svn:eol-style native