ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
Revision: 312
Committed: Tue Aug 25 15:40:58 2020 UTC (8 months, 1 week ago) by tony
File size: 70021 byte(s)
Log Message:
Fixes Merged
Line User Rev File contents
1 tony 312 IBX Change Log version (2.3-5 Build 12350) Tue, 25 Aug 2020 16:11:02 +0100
2 tony 308
3     1. TIBStringField: when a string value is read from a dataset buffer, if the
4     number of UTF8 characters exceeds the string size then string is truncated
5     to the maximum string size. This is usually a problem with fixed width columns
6     right padded with white space.
8     2. SQLFiltered and SQLFilterParams added to TIBQuery, TIBTable and TIBDataset.
9     If SQLFiltered is set then when a dataset is opened, each line in the
10     SQLFilterParams property is assumed to be a SQL condition clause and
11     ANDed into the Where clause of the SQL Select statement provided as a
12     dataset property. Each such SQL condition thus acts as an additional filter
13     on the dataset. (Not yet tested)
15     3. The Filtered property inherited from TDataset is no longer used for SQL (server
16     side filters).
18 tony 311 4. IBLookupComboEditBox: Selection should no longer reset to start of text when
19     text matches complete entry.
21     5. TIBDataLink: Detail Dataset params not refreshed unless both master and detail
22     dataset are active (avoids risk of access violation if master is inactive)
24     6. TIBEvents: Registered property can now be set at design time even if database not open
26     7. TIBEvents: component now correctly re-initialised after call to UnregisterEvents.
27     This should prevent "spillover" of events between sessions.
29     8. TIBCustomDataset: GetNextRecord now called when reseting to first record of a unidirectional dataset.
30     This should ensure that the internal buffer is set up correctly and avoids
31     a duplicate initial row.
33     9. TIBStringField: DataSize now given as byte size of string less trailing any zero character.
34     That is, the DataSize should be the field size * character set width. The
35     value returned by DataSize is now the same as the Dataset buffer size reserved
36     for the field.
38 tony 312 10. IBExtract: Tidyup of SQL generation. Avoid unnecessary double quotes.
39 tony 311
40     11. TIBCustomDataset: Add checks on buffer sizes when copying data from row to field buffer
41     and vice-versa. This may result in an exception being raised (correctly) for
42     older programs when using dataset fields added to a form and the database has been
43     upgraded. For example, computed fields can change from 32-bit to 64-bit integers.
44     In such cases, the field needs to be deleted in the IDE fields editor and then
45     added back in.
47 tony 312 12. IBCustomDataSet: CanInsert, CanEdit, CanDelete and CanRefresh updated to return
48     false if query contains white space and not just empty.
50 tony 311 12. IBCustomDataset: Blob data is now cleared when TDataSet.Cancel is called. This
51     should ensure that (e.g.) a TDBMemo is correctly refreshed after a dataset edit
52     is cancelled.
54 tony 307 IBX Change Log version (2.3-4 Build 12041) Fri, 17 Apr 2020 14:00:32 +0100
55 tony 306
56 tony 307 1. TIBXDataSet and Generators: Generator Names that are not all upper case or
57     not SQL Identifiers are now supported.
58 tony 306
59 tony 307 2. TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is
60     passed to the Firebird engine for execution.
61 tony 306
62 tony 307 3. TIBDataSet: Unidirectional datasets now give an error message if an attempt
63     is made to scroll back.
64 tony 306
65 tony 307 4. New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf
66 tony 306
67 tony 307 5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now
68     only enclosed in double quotes in SQL dialect 3 and when it needs to be.
69 tony 306
70 tony 307 6. TIBLookupComboEditBox: when the list source opens, the ListField name is now
71     validated. If no match is found in the list of field names and the database has
72     been opened in SQL Dialect 3, then the ListField Name is converted to upper case
73     if it then matches a field name. Otherwise, a Listfield not valid exception occurs.
74 tony 306
75 tony 307 7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance
76     with fpc 3.2.
77 tony 306
78 tony 307 IBX Change Log version (2.3-3 Build 11512) Fri, 28 Dec 2018 10:04:17 +0000
79 tony 287
81 tony 307 1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides"
82     and is used to override the default settings in the client side "firebird.conf" This
83     includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings".
84     Each line of the string list should be a setting in the same format as "firebird.conf".
85     For example "WireCompression = true" in order to request wire compression on the client side.
86 tony 287
87 tony 307 Note: explicit settings in the client side "firebird.conf" appear to take precedence
88     over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings
89     also require a compatible setting in the server side "firebird.conf". For example
90     "WireCompression = true" must also be set in the server's "firebird.conf" for wire
91     compression to be used.
92 tony 291
93 tony 307 Whether or not WireCompression or WireCrypt are in use can be checked using the information
94     returned with the Client/Server protocol version. See ibx/examples/dbadmin and
95     ibx/examples/dbinfo for examples of how to display this information.
96 tony 291
97 tony 307 2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This
98     is a "convenience" property. If set the "WireCompression=true" is added to the
99     ConfigOverrides. If unchecked then this setting is removed.
100 tony 291
101 tony 307 3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and
102     not "INT64".
103 tony 291
104 tony 307 4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut
105     These are:
106     property TimestampFormat: string;
107     property DateFormat: string;
108     property TimeFormat: string;
109 tony 291
110 tony 307 Respectively, these provide the date time format templates for SQL types: TIMESTAMP,
111     DATETIME and TIME. The format strings use the standard FPC date/time format
112     characters (see
113 tony 266
114 tony 307 If any of the above properties are set to an empty string, then the locale default
115     is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the
116     locale default is extended by appending '.zzz' to include milliseconds.
117 tony 272
118 tony 307 TIBCSVDataOut by default sets these properties to the empty string, while the other
119     two use: ' hh:nn:ss.zzz', '' and 'hh:nn:ss.zzz' respectively.
120 tony 266
121 tony 307 5. New published property for TIBCSVDataOut:
122     property QuoteStrings: boolean (default true)
123 tony 266
124 tony 307 If false then strings are unquoted, otherwise, the QuoteChar property value is
125     used to delimit each and every string in the output.
126 tony 263
127 tony 307 6. New published properties for TIBCSVDataOut:
128     property FieldSeparator: string;
129     property HeaderSeparator: string;
130 tony 267
131 tony 307 Respectively, these provide the separator character(s) used to separate fields
132     in data and header rows. Both default to ','.
133 tony 270
134 tony 307 7. New published properties for TIBCSVDataOut and TIBBlockFormatOut:
135     TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object;
136     property OnFormatTextString;
137 tony 270
138 tony 307 This event handler can be used to process text strings before they are included
139     in the output e.g. to replace unprintable characters with alternative strings.
140     This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT.
141 tony 270
142 tony 307 8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name.
143     Uses "FindParam" if in order to find out if a parameter with a given name exists
144     and without raising and exception if it does not.
145 tony 270
146 tony 307 9. TIBQuery now uses IBX SQL Parser instead of the TParams SQL parser in order to ensure
147     consistency with SQL queries.
148 tony 270
149 tony 307 10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery.
150     When true, SQL statement parameter names are parsed case sensitive. Note for
151     TIBDataSet only applies to Select query.
152 tony 270
153 tony 307 11. IBEvents: removing a TIBEvent component from a form should no longer result in
154     an IDE exception.
155 tony 270
156 tony 307 12. LocalDBSupport: initial database creation should now work correctly
157     when the schema source is an sql file.
158 tony 270
159 tony 307 13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent"
160     when defined, this handler will be called by the internal TIBXScript during
161     initial database creation when the schema source is an sql file and may be used
162     to provide a visual indication of progress in console mode.
163 tony 270
164 tony 307 14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set
165     to true while a new local database is being created and its schema populated.
166     Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions
167     when the database is disconnected/connected during the create DB procedure.
168 tony 270
169 tony 307 15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement
170     are now always ignored and replaced by the user name and password provided as
171     the login parameters for the TIBDatabase referenced from the TIBXScript. The
172     IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is
173     completely ignored if this property is true.
174 tony 270
175 tony 307 16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes
176     to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise
177     ImageIndex and SelectImageIndex values on AddNode.
178 tony 270
179 tony 307 17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now
180     read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share
181     the same database connection.
182 tony 270
183 tony 307 18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property.
184     if provided, this should be an conditional SQL expression suitable for
185     including in an SQL Select statement "where" clause. If non-empty and the
186     "Filtered" property is true then the SQL expression provided as the value of
187     the "Filter" property is "ANDed" with any existing condition statement
188     in the SQL statement's "Where" clause.
189 tony 270
190 tony 307 If the "Filter" property is set at run time, the "Filtered" property is true
191     and the dataset is already open, then the dataset is closed and re-opened automatically.
192 tony 271
193 tony 307 The "Filter" condition may include IBX style parameters. In which case, their
194     value must be set by the dataset's "OnBeforeOpen" event handler.
195 tony 272
196 tony 307 This is a public property for TIBDataSet and TIBQuery query and intended for
197     use at run time.
198 tony 272
199 tony 307 Note: The property is a published property of TIBTable. The TIBTable functionality
200     is unaffected by this change.
201 tony 272
202 tony 307 IBX Change Log version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000
203 tony 272
204 tony 307 1. Remove need to check for IsMultiThread by providing access to GUI timers via
205     IBGUIInterface. Note: master/detail delay timer does not apply to console
206     mode apps.
207 tony 272
208 tony 307 2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select
209     statement. This avoids problems if "Execute Block" is used as the Query.
210 tony 272
211 tony 307 3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the
212     internal SQL tokeniser routines.
213 tony 272
214 tony 307 4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse
215     as a select statement, with or without CTEs.
216 tony 272
217 tony 307 5. IBSQLParser: parser now recognises the "ROWS" clause.
218 tony 272
219 tony 307 6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the
220     internal SQL tokeniser routines.
221 tony 272
222 tony 307 7. Fix error in TIBXScript processing of "set" statements. This avoids exceptions
223     being raised for valid set statements processed by a data formatter.
224 tony 272
225 tony 307 8. New published property for TIBDatabase and TIBXServicesConnection. This is
226     FirebirdLibraryPathName: string. If not empty it is used to explicitly specify
227     the path of the Firebird Library used by the database/services connection.
228 tony 267
229 tony 307 9. New read only public property for TIBDatabase and TIBXServicesConnection. This
230     is FirebirdAPI and returns the IFirebirdAPI interface used by the database/
231     services connection.
232 tony 263
233 tony 307 10.SQL Property editors now quote parameter names if "Quote identifier" is selected
234     or param name is not a valid SQL identifier.
235 tony 263
236 tony 307 11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive
237     view of whether the text box should be editable when no DataSource is specified.
238     TIBLookupComboEditBox has been updated to workaround this problem. As long as
239     ReadOnly is false, the text box is editable when no DataSource is specified.
240 tony 263
241 tony 307 12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of
242     the FBLIB environment variable. If you do not want to permit this then you
243     must modify the Register procedure in the design/IBDBReg.pas unit to remove
244     this setting.
245 tony 263
246 tony 307 IBX Change Log version (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
247 tony 263
248 tony 307 1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
249     Utf8EscapeControlChars
250 tony 263
251 tony 307 IBX Change Log version (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
252 tony 263
253 tony 307 IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
254     all previous copies of the IBX source code tree before installing this release.
255 tony 263
256 tony 307 The IBX packages used by most users have not changed, with one exception. The
257     IBServices unit has been moved to the package iblegacyServices.lpk. To continue
258     to use the IBServices unit in your applications, please add the iblegacyServices
259     to the list of dependencies. To do this, open the Project Inspector and select
260     Add->New Requirement and select "ibLegacyServices" from the list of available
261     packages.
262 tony 263
263 tony 307 1. New unit IBXServices. The IBXServices unit is a re-architectured update of
264     the IBServices unit providing what is intended to be a clearer and easier to
265     use set of IB Services components. See Chapter 10 of the IBX User Guide for
266     more information and the guide to "Firebird Service Management Using IBX".
267     As indicated above, the legacy services components are still available and
268     provided in a separate package. There is no need to update working applications
269     using the older versions except for an additional package dependency.
270 tony 263
271 tony 307 2. The IBX packages and source code tree have been re-organised in an attempt to
272     finally get rid of the "duplicate ppu" warnings. This re-organisation should
273     not affect existing users. Section 2.3 of the IBX User Guide describes the
274     new set of IBX packages.
275 tony 263
276 tony 307 3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
277     updated to use the new Services API components.
278 tony 263
279 tony 307 4. The iblocal package has been updated to use the new Services API components.
280 tony 241
281 tony 307 5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
282     TIBXSecurityService. It had been wrongly classified in the previous version
283     as a per database configuration item. It is global to a server and hence
284     correctly positioned as part of the Security Package. In the DBAdmin example,
285     the setting has moved to the mappings page.
286 tony 241
287 tony 307 6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
288     are ignored.
289 tony 101
290 tony 307 7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
291     closed before the database is dropped. Before and After Disconnect event handlers
292     are also fired.
293 tony 209
294 tony 307 8. TIBTransaction: OnStartTransaction event now fires every time the transaction
295     is started and not just the first time.
296 tony 209
297 tony 307 9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
298     depenendency with comp type.
299 tony 209
300 tony 307 10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
301 tony 209
302 tony 307 11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
303     then this is recognised and not ignored.
304 tony 209
305 tony 307 12. TIBDataSet, TIBQuery, TIBTable: additions:
306     function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
307     function GetPerfStatistics(var stats: TPerfCounters): boolean;
308     property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
309 tony 209
310 tony 307 GetRowsAffected returns the affected row counts from the last insert/update/delete
311     if EnableStatistics = true then GetPerfStatistics returns the current stats
312     counters for the select query. Note: stats accumulate after each fetch from
313     the database. To get total query cost after open, call the "Last" method
314     and then GetPerfStatistics.
315 tony 209
316 tony 307 See ibx/examples/consolemode for an example of the use of GetPerfStatistics
317 tony 209
318 tony 307 13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
319     in parenthesises.
320 tony 209
321 tony 307 14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
322     SQL identifiers are always delimited by double quotes. If false, then they are
323     only delimited if the identifier is a reserved word, contains lower case or special
324     characters. Set this property to true to retain previous behaviour.
325 tony 209
326 tony 307 15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
327     are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
328 tony 209
329 tony 307 16. TIBDataSet, TIBQuery, TIBTable: addition:
330     property MasterDetailDelay: integer {defaults to zero}
331 tony 209
332 tony 307 When non-zero and the dataset is a detail table referencing a master table
333     through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
334     then a synchronisation delay is added (in milliseconds) between the master
335     row changing and the detail dataset being re-opened. If the master dataset
336     is scrolled before the delay expires then the delay is reset. This can be used
337     to avoid performance overheads when scrolling through a large master dataset.
338 tony 209
339 tony 307 Note: uses fptimer and hence requires a thread manager. Under Linux the
340     chreads unit must be included in your project. TTimer is not used in order
341     to avoid an LCL dependency. Requires FPC 3.0.2 or later.
342 tony 209
343 tony 307 17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
344     with Extract Option eoDatabase.
345 tony 209
346 tony 307 18. TIBLookupComboEditBox: Workaround added for
347     When a deLayoutChanged event is reported on the ListSource dataset, the
348     combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
349     relationship with the control's datasource (master).
350 tony 209
351 tony 307 19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
352 tony 209
353 tony 307 20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
354     stubs. Pedantic fix really, as procedures output in dependency order anyway.
355 tony 209
356 tony 307 21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
357     DDL (Firebird 3 and later only).
358 tony 209
359 tony 307 22. TIBLookupComboBox Autocomplete Fixes:
360     i. Only appended text is now selected after autocomplete.
361     ii. Uppercase keys no longer ignored for autocomplete.
362     iii. Retain Prefix case is now honoured correctly.
363     iv. When a DataSource is assigned, typing after autocomplete now extends prefix
364     before autocomplete performed. i.e. behaviour now the same as when
365     no DataSource assigned.
366 tony 209
367 tony 307 23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
368     between SQL statements.
369 tony 209
370 tony 307 24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
371     ObjectNames are converted to upper case before matching against metadata object
372     names, unless the objectname is delimited by double quotes, in which case, the
373     double quotes are removed and the remaining string is used (unmodified) to match
374     against the metadata object name.
375 tony 209
376 tony 307 If true then the ObjectName is used as is without modification and matched
377     against the metadata object name. No attempt is made to remove double quotes.
378 tony 209
379 tony 307 25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
380     with eoTrigger, these extract types can be used to select only Database Triggers,
381     or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
382 tony 209
383 tony 307 26. TIBXScript: If an exception occurs during the processing of a statement, the
384     statement separate character is now reset to the default (';').
385 tony 221
386 tony 307 27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
387 tony 221
388 tony 307 28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
389     a commit or reconnect statement and instead activated only when next SQL statement
390     is executed.
391 tony 221
392 tony 307 29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
393 tony 225
394 tony 307 30. TIBXScript: case insensitive regex now used when matching statements instead of
395     converting statement to upper case.
396 tony 225
397 tony 307 31. TIBExtract: metadata comments now supported. New published property
398     IncludeMetaDataComments (default true). If true then metadata comments included
399     in extracted DDL. New Extract Object member eoComments. This may be used with
400     ExtractObject method to list all metadata comments.
401 tony 225
402 tony 307 32. TIBExtract: ListObjectNames method added.
403 tony 225
404 tony 307 33. Updated Database component editor to support additional connection string
405     types.
406 tony 226
407 tony 307 IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
408 tony 227
411     RELEASE.
412 tony 229
414 tony 229
415 tony 307 1. IBExtract: Identity columns - add additional check for null column for generator name.
416 tony 229
417 tony 307 2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
418     The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
419     information). However, this is also a very useful mechanism for returning updated computed by
420     column values. Values returned as a result of executing an Insert or Update statement
421     replace existing values in the current row for each corresponding column.
422 tony 229
423 tony 307 Previously, if a dataset's select query included read only (computed by) fields then
424     an automatic row refresh was performed after an insert or update query had been processed,
425     irrespective of the setting of the "ForcedUpdates" property. This has changed such
426     that an automatic refresh is no longer performed if an insert or update query contains
427     a returning clause that updates one or more fields on the current row. A full row
428     refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
429     field values and the select query contains read only fields. Use of Insert/update
430     returning should be significantly more efficient than executing a refresh query.
431 tony 229
432 tony 307 This behaviour change is intended to be backwards compatible and there should be no need to change
433     existing programs, other than to improve performance by using the new capability.
434 tony 229
435 tony 307 3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
436     they are called when the dataset row is being deleted, there is no value in
437     updating the current record from the query result. Instead, a new event handler
438     "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
439     an OnDeleteReturning event handler is provided then it is called with the IResults returned
440     by the query. The event handler can then interrogate the query results and
441     perform whatever action is necessary. For example to confirm, to the user,
442     the deletion of a row with the returned values.
443 tony 231
444 tony 307 4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
445     any Computed By or Identity Columns. The IBTables example has been updated to
446     illustrate the computation of the employee Full Name on update.
447 tony 209
448 tony 307 5. TIBTable: The GeneratorField property is now published.
449 tony 151
450 tony 307 6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
451     When InsertSQL is generated, the Identity columns are not included in the list of values to
452     be inserted. A RETURNING clause is added to the insert statement to return the value of
453     each Identity column after the insert is executed.
454 tony 151
455 tony 307 7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
456     Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
457     Insert..Returning clause.
458 tony 101
459 tony 307 8. TIBGenerator: small performance improvement by not preparing query each time
460     a new value is generated.
461 tony 101
462 tony 307 9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
464     10. Property editors will now sync table name to a System Table when "Include System
465     Tables" is selected and the query is for a System Table.
467     11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
468     values are no longer converted to milliseconds from TDateTime and then back again
469     to TDateTime (the conversion to milliseconds is the default TDataset approach).
471     12. Property Editors handling of Stored Procedures.
472     * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
473     which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
474     query).
475     * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
477     13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
478     can be used to select a package. If non-empty, the stored procedure name is
479     expected to be a stored procedure defined in the specified package and the
480     generated SQL will be as required for a stored procedure located in a package.
482     14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
483     a "Package Name" drop down box to allow selection of a Firebird 3 Package from
484     which a stored procedure can be selected. With no package name selected, non-package
485     stored procedures are listed.
487     15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
488     for password on reconnect.
490     16. TIBDatabase: use IAttachment for connection default character set id, code page
491     and character set name.
493     17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
494     DB info lookups"
496     18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
498     19. Add a property Editor for TIBUpdate.RefreshSQL.
500     20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
501     parameters. This stops an exception being raised when the field cannot be
502     located in the record buffer.
504     21. Property Editors now automatically include System Tables when opened and when the query table
505     is a System Table.
507     22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
508     This avoids errors due to a stale SQRB or SRB being used for the next query.
510     23. IBServices: Service attach parameters now include "expected_db". This is used to
511     add the SPB item isc_spb_expected_db. This names a database using
512     an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
513     database. examples/services re-written to illustrate use of "expected_db".
515     24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
516     This avoids truncated backups when the server returns a timeout (busy) response.
518     25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
520     26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
521     databasenames. These are respectively expanded to the local system's temp directory
522     (including trailing delimiter) or to a prescribed data directory (including
523     trailing delimiter). Under Unix systems the data directory is a hidden directory
524     in the user's home directory. The hidden directory name is either the string returned
525     from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
526     Under Windows, the directory is the same as the Data Directory as decribed
527     above but instead prefixed by the User's application data path. These may be
528     used to improve application portability for Personal Databases.
530     27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
531     this has not worked for a long time and is not useful either. FieldDefs should be
532     managed using the Fields Editor as with any other dataset. To access the fields
533     editor for a TIBTable component, double click on the component. The fields editor
534     is then displayed.
536     28. TIBDatabaseInfo: new properties/function
537     * DateDBCreated (returns date/time database created)
538     * TransactionCount (returns no. of active transactions)
539     * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
540     * PagesFree (Firebird 3 or later)
541     * PagesUsed (Firebird 3 or later)
542     * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
543     * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
545     29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
547     30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
549     31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
550     the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
552     32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
553     in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
554     firing during backup and restore.
556     33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
557     for verbose output using the new property "StatisticsRequested".
558     see
560     34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
562     35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
563     palette. This uses the online validation feature added in Firebird 2.5. The
564     services's properties enable inclusion/exclusion of tables and indexes using
565     regular expressions. See.
568     36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
569     option on a database.
571     37. TIBCustomService: Assign method implemented to allow copying of service login
572     context between service API components. "Detach" method now only detaches
573     service when last reference to the service interface detaches. Tidy up of
574     code for SetActive and Attach methods including password hiding.
576     38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
577     and used to determine the auth method and protocol used for the connection.
579     39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
580     a Create Database Statement generated by IBX.
582     40. All IBServices now have an additional published property "PortNo". This may
583     be set to a non-standard port number when necessary. If zero then the default
584     port number is used.
586     41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
587     and not just the mouse.
589     42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
591     43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
592     image index and selected image index for each node to be set from a database field.
594     44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
595     then database schema includes grants to all users. If not present then the
596     only user grants included are those to User PUBLIC.
598     45. TIBTreeView: performance improvement. When expanding include both expanded node
599     and child nodes in dataset.
602     IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
604     1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf
605     changes.
607     2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString.
608     Bug could result in truncated multi-byte character set values.
610     3. Changes consequential on moving fbintf character set utility functions from
611     IFirebirdAPI to IAttachment.
613     4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true
615     5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally
616     results in autocomplete ignoring prefix text.
618     6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when
619     entering a new name into the text box.
621     7. IBCustomDataset: ensure that TIBStringField uses the field size reported by
622     Firebird rather than recomputing it.
624     8. Property Editor positioning tidy up: All IBX Property editors should now be
625     screen centre. Previously some were "poDesigned" which may be inappropriate
626     for multi monitor desktops.
628     10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node.
630     11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending
631     a transaction and always reset the object.
633     12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows.
635     13. TIBXScript: Allow for override of database filename in Create Database statements.
637     14. IBLocaldb: Support initialisation of the database from an SQL script in addition
638     to a gbak format archive.
640     15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised.
642     16. IBLocaldb: Drop database if error creating an empty database.
644     17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset
645     unless selected node not in current dataset.
647     18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package)
648     to TIBCustomService, and IBlocalDB code tidy up.
650     19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable
651     behaviour due to uninitialised variable.
653     20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from
654     integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode.
656     21. IBSQL: When Database changed ensure that all resources are freed.
658     22. IBCustomDataset: When database changed ensure that queries an unprepared.
660     23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include:
661     * Line Wrap on SQL Token boundaries (on user command)
662     * auto-complete table names in drop down list of table names
663     * Double click on tablename or field name adds to SQL text
665     24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d).
667     25. IBTreeView: Call to FindNode: param type change from "array of Variant" to
668     TVariantArray. Seems to avoid memory corruption in Windows (probably a
669     workaround for a problem in fpc 3.0.4 win64).
671     26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open.
673     27. IBDatabaseInfo: Remove memory leak when accessing database operation counts.
675     IBX Change Log version (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000
677     1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to
678     include remote system name.
680     2. TIBExtract: No longer include comment header and COMMIT statement for empty
681     tables when data included in output.
683     3. Profiling: IBSQL now has conditional compilation flags to enable query performance
684     and timing information to be written to stdout. This may be used to locate
685     performance bottlenecks.
687     4. SQLParser: only call "OnChanging" event handler when value is different.
689     5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit
691     6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures
692     that BindFields is called when the query is next activated. Avoids FieldName
693     not found error.
695     7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general
696     purpose and allows the programmer to define any action they want for Update, Insert
697     or Delete. This may be complex SQL (similar to a Trigger), application specific
698     filtering of updates, or use of statements such as Grant or Revoke instead of
699     normal DML. See User Manual for more information.
701     IBX Change Log version (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
703     1. TIBEvents: Fix uninitialised variable that could result in lost events.
705     2. TIBExtract: Added support for FB3 "USAGE" privilege.
707     3. TIBExtract: data formatted as Charset set "octets" is now output using
708     hexadecimal notation.
710     4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements
711     using a simple XML format.
713     5. TIBExtract: extract of individual Triggers and Stored Procedures can now include
714     grants to these objects.
716     6. TIBExtract: Stored Procedures and Views output in dependency order to avoid
717     dependency problems restoring complex databases.
719     7. TIBXScript: This component has been restructured to allow for the processing of
720     embedded XML in INSERT statements and to support interactive sources in addition
721     to non-interactive data sources such as files.
723     8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported.
725     9. TIBXScript: ISQL compatiable Set statements are now supported:
727     SET TERM
729     SET BAIL
730     SET ECHO
731     SET COUNT
732     SET STATS
733     SET NAMES <character set>
735     10. IBVersion unit added to hold current IBX Version Number information.
737     11. TIBExtract: Use character rather than byte length for VarChar procedure arguments.,
738     and domain definitions.
740     12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers
741     fully supported.
743     13. TIBExtract: when a database dump includes data, the generator values are now also set.
745     14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later.
747     IBX Change Log version (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
749     See also doc/IBX4LazarusGuide.pdf for important information on
750     upgrading to IBX2.
752     1. Size property of TIBStringField is now the width in characters of the field
753     and not the byte length. This applies only to multi-byte character sets such
754     as UTF8. The original approach aligned with TStringField. However, the TStringField
755     code is not recognised as a bug and hence this change to align the behaviour.
756     The TStringField change is expected in fpc 3.2.0.
758     2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
759     true (default) then Size property value saved in the lfm is ignored. Size is
760     always set from the dynamic information read from the database. It is unclear
761     why anyone would want to override this and set Size to false.
763     3. ibxscript: should now handle correctly a Case..End statement within a procedure
764     block.
766     4. IBDatabase: new property - CreateIfNotExists. If true and database does not
767     exist when an attempt is made to connect to it (run time only) then an attempt
768     is made to create the database.
770     5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
771     has been successfully created as a result of a call to CreateDatabase or when
772     creating a database after it was found not to exist.
774     6. DBControlGrid: a race condition could result in the wrong row image being
775     written to the cache. This has been avoided by a trip round the message
776     loop before rendering the row image.
778     7. DBControlGrid: It is strongly recommended not to open the source DataSet for
779     a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
780     known to risk corrupt rendering of row images when the control is first
781     displayed. If necessary use "Application.QueueAsyncCall" to delay opening
782     of the dataset (see DBControlGrid examples) until the Form's Window has been created.
784     8. DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
785     a TDateEdit control located on an editor panel.
787     9. TIBExtract: brought up-to-date plus many bug fixes.
789     10. DBControlGrid: Removed memory leak when updating rows.
791     11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
793     IBX Change Log version (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
795     1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
796     when target codepage is CP_NONE. This is a workaround for
799     2. DBLog option removed from TIBStatisticalService - not supported by server
800     since Firebird 1.5.
802     3. ibxscript: An error is no longer generated for "on commit preserve rows" or
803     similar.
805     4. IBCodePage: updated mapping between codepages and character id.
807     5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
808     Firebird. Character sets with a char width of two are not UTF16.
810     6. Strings received from the database are now always transliterated into UTF8
811     regardless of the database character set or connection character set. This
812     is for compatibility with the LCL.
814     IBX Change Log version (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
816     1. IBBlob: Defer reading of blob until read method called. This avoids having to
817     read in an entire blob just to get the size of the blob. General performance
818     improvement when opening datasets containing blobs.
820     2. Clearing a Blob now sets the corresponding field's modified flag.
822     3. IBLookupCombo: When not performing auto-complete, original query sort order
823     is now used.
825     4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
826     determined.
828     5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
830     6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
831     lazarus 1.6.0
833     7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
834     compilation error.
836     IBX Change Log version (1.4-1) Tue, 17 May 2016 09:14:51 +0100
838     1. No character set specified for connection: when a text blob is retrieved, the
839     character set is determined by looking up the native character set using then
840     Firebird API. Otherwise a text mode blob is assumed to have the same character
841     set as the connection.
843     2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
844     for Login Dialog returing a change to the database path.
846     3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
847     to be changed from that given in the TIBDatabase/TIBServer component and for the
848     entered value to be saved on a project specific basis (design time only).
850     4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
851     column fieldname. If they are the same then it is acts as a look up for the KeyValue
852     Otherwise, it sets the column text to the selected ListField Value.
854     5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
855     column width.
857     6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
858     and a case insensitive search is requested.
860     7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
861     or column ListSource.
863     8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
864     unprepare) when closing and the text has not changed.
866     9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
867     Less likely to cause a cursor re-use error on Windows.
869     10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
870     Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
872     11. TIBTreeView: Guard against nil destination on record changed
874     12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
875     string type with the code page set to reflect the returned field encoding after
876     Firebird driver transliteration, if any. FPC 3.0.0 onwards only. Behaviour unchanged for
877     earlier versions.
879     13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
880     will now result in transliteration to the code page specified for the Firebird driver
881     if the assigned string has a different code page. FPC 3.0.0 onwards only.
883     14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
884     is ignored and the lc_ctype value, when the database is opened, is set to align with
885     the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
886     platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
887     3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
888     the GETACP is used to determine the Windows code page.
890     15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
891     name used as the lc_ctype when the database was opened. Only valid while the
892     Database is connected.
894     16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
895     id that corresponds to the DefaultCharSetName.
897     IBX Change Log version (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
899     1. Unix: If Firebird Embedded Server shared object is loaded and a local database
900     path is given and database attach fails due to access permission issues on the
901     temp directory or security database, then the attach is retried with "localhost:"
902     prefixing the databasename. This should avoid problems when the database has to
903     be accessed by a local (e.g. classic) server and libfbembed is used.
905     2. Windows: revised search order for Firebird DLL:
906     i. The Firebird Embedded Server in the application Directory.
907     ii. If the FIREBIRD environment variable is set then the directory this
908     points to is searched for the FB Client DLL and then then underlying
909     "bin" directory.
910     iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
911     is used to locate the Firebird installation directory and the underlying
912     "bin" directory is searched for the FB Client DLL.
913     iv. The Default installation directories C:\Program Files\Firebird\Firebird_2_x
914     are searched for the FB Client DLL.
915     v. The PATH Environment variable is used to search for the FB Client DLL.
916     vi. Finally the PATH Environment variable is used to search for IBASE.DLL.
918     3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
919     See doc/readme.scriptengine and example applications.
921     4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
922     simplify the use of the embedded firebird server on both Linux and Windows platforms.
923     See dpc/readme.localdatabase and example applications.
925     5. IBDynamicGrid: Reordering on column header click should now also work for
926     dynamic columns.
928     6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
929     between incrementing/decrementing the lock count and signalling the event.
931     IBX Change Log version (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
933     1.3.2 was never formally released and only made available as beta copies.
935     1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
937     2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
939     3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
941     4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
942     i.e. when it is a calculated field
944     5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
945     This problem was due to a race condition between recalculating row heights and
946     determining which row was selected by the mouse click. The row height calculation
947     is now deferred by an extra trip round the message loop allowing the row to
948     be always calculated on the current grid layout rather than risking it being
949     calculated on the grid layout after the expanded row has been shrunk.
951     6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
952     Windows.
954     7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
955     These properties allow the (Firebird) character set name for the field and the max number of bytes per character
956     to be determined at runtime. See doc/readme.charactersets.html.
958     8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
959     TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
961     9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
962     TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
963     1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
965     Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
966     from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
967     implies no truncation.
969     10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
971     11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
972     (avoids "Not in Edit Mode" error).
974     12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
976     13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
977     DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
979     14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
981     15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
983     16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
985     17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
987     IBX Change Log version (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
989     1. OnCloseUp Event Handler added to TDBLookupProperties
991     2. IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
992     problem with row size when exception is called.
994     3. IBLookupComboEditBox: Force pending autocomplete on combobox exit.
996     4. IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
997     in a TCustomComboBox and ignores return key if in a TCustomMemo
999     5. IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
1000     keyed in i.e. when autocomplete not performed
1002     6. Cleanup of "Uses" clauses and add console mode support. IBX should now support
1003     console mode applications with all LCL required functions (builtin dialogs and
1004     cursor management) centralised in the IBDialogs unit. As long as "IBDialogs" is
1005     not included in your project, IBX should compile and link with a console mode program.
1006     See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
1007     console mode application or the IDE will automatically assume that your
1008     application is GUI based. Instead, you should include the ibexpressconsolemode package.
1010     IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
1011     to use the built in dialogs and cursor management. IBDialogs is
1012     included by default if "ibexpress" is in your project source's "uses" clause.
1013     This should be the case for all projects created through the IDE. This is why
1014     you do not want to add the ibexpress package to console mode applications. The
1015     ibexpressconsolemode package has been created to allow console mode programs
1016     to avoid adding LCL dependencies when using IBX, while still having the
1017     unit search paths set up correctly.
1019     Existing users should check to ensure that the "ibexpress" unit is included in
1020     each project's source file (*.lpr).
1022     You may find that in order for the IDE to recognise that ibexpressconsolemode
1023     exists, you have to first open the package in the IDE and then close it. This
1024     adds it to the most recently accessed packages list. To make it permanently
1025     available, add the package name to lazarus' file.
1027     Thanks to Julio Jiménez for suggesting support of console mode.
1029     7. SQL Parser can now accept quoted strings that include new lines
1031     8. IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
1032     of text on start of edit. This is particularly useful when tabbing to a
1033     column and then inserting text.
1035     9. New Examples provided for IB Services and ISQLMonitor.
1037     10. Fix error when writing to blob streams that recorded only the last buffer
1038     write in the blob stream. In most cases, this did not cause a problem as the
1039     IB Blob Stream is written in a single write. However, with the TDBImage, write
1040     of a graphic type prefix was lost which caused a problem when the image could
1041     not be automatically recognised.
1043     11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
1044     already open" errors due to random numbers used for the cursor name being identical.
1046     12. IBTable: corrected error that could result in an "Index out of bounds" error
1047     when opening the table and the Primary Key is the last or only column in the
1048     table. Thanks to Rick Hoover for the fix.
1050     13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
1051     of "UTF-8", and update list of available database character sets. Existing
1052     users should check the current lc_ctype setting in their applications.
1054     IBX Change Log version (1.2-4) Sat, 09 May 2015 12:38:29 +0100
1056     1. Firebird Services: avoid List Index error when opening a service with an
1057     empty Params property.
1059     2. IBControls: Fix problem with new link mechanism introduced in 1.2.3.
1060     Link now set up in Loaded method - avoids occasional failure to apply
1061     SQL markup on initial open.
1063     3. "Employees" example performance improvements when scrolling.
1065     4. DBControlGrid: Correctly handle edit panel removal when panel is child control of a
1066     TFrame. Force recaching of selected frame to avoid GTK race (results in a
1067     random image cached).
1069     5. DBControlGrid: Should now react to changes in panel height at run time.
1071     6. IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
1072     even when further rows exist.
1074     7. DBControlGrid: DefaultRowHeight is no longer a published property as it should
1075     always be derived from panel height and setting this property can cause confusion.
1076     Note for existing projects: to avoid a missing property error at run time,
1077     each form using the DBControlGrid must be opened, updated and saved in the IDE
1078     in order to remove the property value from the lfm.
1081     IBX Change Log version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
1083     1. TIBStoredProc. Prepare now called by ParamByName to avoid need to always
1084     call Prepare before setting parameter values.
1086     2. Error message on ParamByName (all cases) not found now includes name of missing parameter.
1088     3. Code tidyup and more robust handling of dsql information result vector.
1090     4. Support for centralised handling of transaction status changes. TIBTransaction
1091     has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
1092     and "AfterExecQuery". The first three are called after the same event is called
1093     for an IBCustomDataSet descendent using the Transaction. The fourth is called
1094     after a call to TIBSQL.ExecQuery, again using this transaction. These new events
1095     enable monitoring of transaction status changes for a given transaction to be
1096     handled in a single place. For example, when a change to the dataset occurs
1097     an indicator can be set that shows the user that in order to save changes,
1098     the transaction should be committed. Rather than doing this per dataset, this
1099     can now be done per transaction.
1101     5. TDataSet.CheckBrowseMode automatically posts changes to the current row when
1102     the dataset is scrolled. However, any changes to the current row are, by default,
1103     discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
1104     have a new property "DataSetCloseAction" that adds automatic posting of changes
1105     on dataset close. If this property is set to dcDiscardChanges (default) then the
1106     behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
1107     then IBX will attempt to post any unsaved changes before the dataset is closed
1108     (and after the BeforeClose event handler is called). The exception is when the
1109     dataset is being closed as a result of a transaction rollback. In this case,
1110     no action is taken and any unsaved changes are discarded. This avoids both
1111     unnecessary overhead and the risk that a validation error may occur in the Post
1112     raising an exception and thereby preventing a rollback.
1114     6. String Field sizes and Display Widths should now be correct for multi-byte character sets.
1115     In earlier versions, the Display Width was set to the maximum byte width rather than the character
1116     width. Display Widths are now corrected by dividing by the max byte width per character.
1117     For UTF8 character sets, the byte width is four and hence the Display Width will be
1118     the byte width divided by 4. The byte width of each character set is determined
1119     dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
1120     system table. (see also
1122     7. SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
1124     8. IBLookupComboEditBox: List should now always be restored to full list when the
1125     control loses focus. Default Key press default interval reduced to 200ms.
1127     9. DBControlGrid: Ensure that selection is changed to newly appended row, even
1128     when dataset rows are less than visible rows.
1130     10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
1131     does not exist or DataSet is empty. More responsive on dataset open. New event
1132     OnRestorePosition. Column sort disabled if no header row.
1134     11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
1135     while dataset state is dsInsert. Avoids posting errors.
1137     12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
1138     avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
1140     13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
1142     14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
1143     to solve a specific problem. That is when the dataset cursor is moved (e.g. by
1144     a grid mouse click and the current row is being edited or inserted. In this case, TDataset
1145     always "posts" the current record regardless or whether or not it may be more appropriate
1146     to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
1147     "MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
1148     as the first action of the "Post" method and allows the handler to convert the Post
1149     into a Cancel if that is the appropriate action on moving to a different row. This is
1150     achieved by returning with "CancelPost" argument set to true. Note that an exception could be
1151     raised here, but it may still be more appropriate to validate a post and signal
1152     a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
1154     15. On Unix derived systems, the Firebird library name can now be given as a colon
1155     separated list. Each library name on the list is tried in turn, in left to right
1156     order with the first found being used as the firebird library. By default, on Linux,
1157     the library name list is ''. This can be
1158     overidden by the FBLIB environment variable or the OnGetLibraryName function.
1160     Note: when using the, if you prefix the database name with "localhost:"
1161     then it will still attempt to access the database via the Firebird Server and will
1162     require a username and password. If only the pathname is given, then the username
1163     and password should be omitted and the unix file permissions are used to grant
1164     access.
1166     IBX Change Log version (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
1168     1. A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
1169     rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
1170     that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
1171     corresponds to a row of the linked DataSource. Any data aware control on the
1172     replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
1174     2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
1175     When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
1176     takes place during database access. This may be useful when there are performance issues with
1177     the change of cursor. Setting the property to false suppresses the change of cursor.
1179     3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
1180     and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
1181     Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
1182     making all changes permanent immediately rather than when the transaction is explicitly
1183     committed.
1185     4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
1186     using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
1188     IBX Change Log version (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
1190     Development version only.
1192     IBX Change Log version (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
1194     1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
1195     This is typically used during an "OnBeforeOpen" event handler to manipulate the
1196     "Where" and "Having" clauses to implement user specified filters of arbitrary
1197     complexity.
1199     2. A new Component Palette entry "Firebird Data Controls" is now available. This has
1200     three new data aware controls dependent on IBX and which make use of the SQL Parser.
1201     These are:
1203     - TIBLookupComboEditBox
1204     - TIBDynamicGrid
1205     - TIBTreeview
1207     TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
1208     of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
1209     to revise the available list and restrict it to items that are prefixed by the
1210     typed text (either case sensitive or case insensitive). Autoinsert allows a
1211     newly typed entry to be added to the list dataset and included in the available
1212     list items.
1214     TIBDynamicGrid is a TDBGrid descendent that provides for:
1215     - automatic resizing of selected columns to fill the available row length
1216     - automatic positioning and sizing of a "totals" control, typically at the
1217     column footer, on a per column basis.
1218     - DataSet resorting on header row click, sorting the dataset by the selected column.
1219     A second click on the same header cell reversed the sort order.
1220     - Support for a "Panel Editor". That is on clicking the indicator column, the row
1221     is automatically expanded and a panel superimposed on it. The panel can have any
1222     number of child controls, typically data aware controls with the same datasource
1223     as the grid allowing for editing of additional fields and more complex editors.
1224     - Reselection of the same row following resorting.
1225     - A new cell editor that provides the same functionality as TIBLookupComboEditBox.
1226     Its properties are specified on a per column basis and allows for one or more
1227     columns to have their values selected from a list provided by a dataset.
1228     Autocomplete and autoinsert are also available. The existing picklist editor
1229     is unaffected by the extension.
1231     TIBTreeView is a data aware TCustomTreeView.
1233     3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
1234     zero scale will no longer return an error. An Int64 will be returned instead.
1236     4. TIBTransaction now has events for Before and After Transaction End and a new function
1237     "GetEndAction" allowing the EndAction to be accessed by these event handlers.
1239     5. TIBQuery can now handle correctly queries which contain the same keyword parameter
1240     repeated multiple times.
1242     6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
1243     check used to get in the way of using Stored Procedures, and "Update or Insert"
1244     statements.
1246     7. Insert, Modify and Delete property Editors now support Query Generation from
1247     Stored Procedures.
1249     8. Three new examples illustrate the use of the new IB Controls
1252     IBX Change Log version (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
1254     1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
1255     setting performance. See "readme.field+param.names in the doc folder.(Thanks to
1256     Gabor Boros for reporting this problem and for testing the improvements).
1258     2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
1259     See readme.field+param.names in the doc folder.
1261     3. IBX SQL Editors will now automatically add double quotes around column names when the database
1262     dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
1264     4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
1266     5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
1267     actions.
1269     6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
1270     thanks to Yuriy Kopnin for pointing this out).
1272     7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
1274     8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
1275     for both fields and parameter setting.
1277     9. Changes to the Select SQL in an IBCustomDataset descendent should now be
1278     visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
1280     10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
1281     when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
1283     11. TIBTable now has a property editor for "MasterFields"
1285     12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
1286     GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
1288     13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
1289     of settings is unrecognised. Selecting this radio button has no effect on the settings.
1292     IBX Change Log version (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
1294     1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
1296     IBX Change Log version (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
1298     1. In a TIBCustomDataset descendent, a generator now only sets the value when
1299     it is null. This allows for alternative user defined setting of the generator
1301     Many thanks to Julio Jiménez for this fix
1303     2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
1304     and suggests that the user may have forgotten to install it.
1306     IBX Change Log version (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
1308     1. Conditional compilation used to limit registration of TIntegerField to
1309     Lazarus versions less than 1.1
1311     2. When a database connection is created, character set is now by default set
1312     to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
1313     1250 to 1254.
1316     IBX Change Log version (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
1318     1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
1321     IBX Change Log version (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
1323     1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
1324     Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
1326     2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
1327     package is changed to do this (which it should do).
1329     IBX Change Log version (1.0-0) Sat, 28 Apr 2012 16:43:00 +0100
1331     1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
1333     2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
1335     3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
1337     4. Property editors should now correctly resize.
1339     5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
1340     (restored original functionality)
1342     6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
1343     library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.