ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
Revision: 432
Committed: Sun Jan 7 16:17:19 2024 UTC (3 months, 2 weeks ago) by tony
File size: 85609 byte(s)
Log Message:
Fixes merged

File Contents

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

Properties

Name Value
svn:eol-style native