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

Comparing ibx/trunk/changelog (file contents):
Revision 306 by tony, Fri Jul 17 22:53:33 2020 UTC vs.
Revision 350 by tony, Wed Oct 20 14:58:56 2021 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines