ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
Revision: 37
Committed: Mon Feb 15 14:44:25 2016 UTC (8 years, 1 month ago) by tony
File size: 24620 byte(s)
Log Message:
Committing updates for Release R1-4-0

File Contents

# User Rev Content
1 tony 37 IBX Change Log version (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
2    
3     1. Unix: If Firebird Embedded Server shared object is loaded and a local database
4     path is given and database attach fails due to access permission issues on the
5     temp directory or security database, then the attach is retried with "localhost:"
6     prefixing the databasename. This should avoid problems when the database has to
7     be accessed by a local (e.g. classic) server and libfbembed is used.
8    
9     2. Windows: revised search order for Firebird DLL:
10     i. The Firebird Embedded Server in the application Directory.
11     ii. If the FIREBIRD environment variable is set then the directory this
12     points to is searched for the FB Client DLL and then then underlying
13     "bin" directory.
14     iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
15     is used to locate the Firebird installation directory and the underlying
16     "bin" directory is searched for the FB Client DLL.
17     iv. The Default installation directories C:\Program Files\Firebird\Firebird_2_x
18     are searched for the FB Client DLL.
19     v. The PATH Environment variable is used to search for the FB Client DLL.
20     vi. Finally the PATH Environment variable is used to search for IBASE.DLL.
21    
22     3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
23     See doc/readme.scriptengine and example applications.
24    
25     4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
26     simplify the use of the embedded firebird server on both Linux and Windows platforms.
27     See dpc/readme.localdatabase and example applications.
28    
29     5. IBDynamicGrid: Reordering on column header click should now also work for
30     dynamic columns.
31    
32     6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
33     between incrementing/decrementing the lock count and signalling the event.
34    
35 tony 35 IBX Change Log version (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
36    
37 tony 37 1.3.2 was never formally released and only made available as beta copies.
38    
39 tony 35 1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
40    
41     2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
42    
43     3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
44    
45     4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
46     i.e. when it is a calculated field
47    
48     5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
49     This problem was due to a race condition between recalculating row heights and
50     determining which row was selected by the mouse click. The row height calculation
51     is now deferred by an extra trip round the message loop allowing the row to
52     be always calculated on the current grid layout rather than risking it being
53     calculated on the grid layout after the expanded row has been shrunk.
54    
55     6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
56     Windows.
57    
58     7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
59     These properties allow the (Firebird) character set name for the field and the max number of bytes per character
60 tony 37 to be determined at runtime. See doc/readme.charactersets.html.
61 tony 35
62     8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
63 tony 37 TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
64 tony 35
65     9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
66     TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
67 tony 37 1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
68 tony 35
69     Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
70     from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
71     implies no truncation.
72    
73     10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
74    
75     11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
76     (avoids "Not in Edit Mode" error).
77    
78     12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
79    
80     13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
81     DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
82    
83     14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
84    
85     15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
86    
87     16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
88    
89     17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
90    
91 tony 33 IBX Change Log version (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
92 tony 31
93     1. OnCloseUp Event Handler added to TDBLookupProperties
94    
95     2. IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
96     problem with row size when exception is called.
97    
98     3. IBLookupComboEditBox: Force pending autocomplete on combobox exit.
99    
100     4. IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
101     in a TCustomComboBox and ignores return key if in a TCustomMemo
102    
103     5. IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
104     keyed in i.e. when autocomplete not performed
105    
106 tony 33 6. Cleanup of "Uses" clauses and add console mode support. IBX should now support
107     console mode applications with all LCL required functions (builtin dialogs and
108     cursor management) centralised in the IBDialogs unit. As long as "IBDialogs" is
109     not included in your project, IBX should compile and link with a console mode program.
110     See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
111     console mode application or the IDE will automatically assume that your
112     application is GUI based. Instead, you should include the ibexpressconsolemode package.
113 tony 31
114     IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
115     to use the built in dialogs and cursor management. IBDialogs is
116 tony 33 included by default if "ibexpress" is in your project source's "uses" clause.
117 tony 31 This should be the case for all projects created through the IDE. This is why
118     you do not want to add the ibexpress package to console mode applications. The
119     ibexpressconsolemode package has been created to allow console mode programs
120     to avoid adding LCL dependencies when using IBX, while still having the
121     unit search paths set up correctly.
122    
123 tony 33 Existing users should check to ensure that the "ibexpress" unit is included in
124     each project's source file (*.lpr).
125    
126 tony 31 You may find that in order for the IDE to recognise that ibexpressconsolemode
127     exists, you have to first open the package in the IDE and then close it. This
128     adds it to the most recently accessed packages list. To make it permanently
129     available, add the package name to lazarus' staticpackages.inc file.
130    
131 tony 33 Thanks to Julio Jiménez for suggesting support of console mode.
132 tony 31
133     7. SQL Parser can now accept quoted strings that include new lines
134    
135     8. IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
136     of text on start of edit. This is particularly useful when tabbing to a
137     column and then inserting text.
138    
139     9. New Examples provided for IB Services and ISQLMonitor.
140    
141     10. Fix error when writing to blob streams that recorded only the last buffer
142     write in the blob stream. In most cases, this did not cause a problem as the
143     IB Blob Stream is written in a single write. However, with the TDBImage, write
144     of a graphic type prefix was lost which caused a problem when the image could
145     not be automatically recognised.
146    
147     11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
148 tony 33 already open" errors due to random numbers used for the cursor name being identical.
149 tony 31
150     12. IBTable: corrected error that could result in an "Index out of bounds" error
151     when opening the table and the Primary Key is the last or only column in the
152     table. Thanks to Rick Hoover for the fix.
153    
154 tony 33 13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
155     of "UTF-8", and update list of available database character sets. Existing
156     users should check the current lc_ctype setting in their applications.
157 tony 29
158 tony 33 IBX Change Log version (1.2-4) Sat, 09 May 2015 12:38:29 +0100
159    
160 tony 29 1. Firebird Services: avoid List Index error when opening a service with an
161     empty Params property.
162    
163     2. IBControls: Fix problem with new link mechanism introduced in 1.2.3.
164     Link now set up in Loaded method - avoids occasional failure to apply
165     SQL markup on initial open.
166    
167     3. "Employees" example performance improvements when scrolling.
168    
169     4. DBControlGrid: Correctly handle edit panel removal when panel is child control of a
170     TFrame. Force recaching of selected frame to avoid GTK race (results in a
171     random image cached).
172    
173     5. DBControlGrid: Should now react to changes in panel height at run time.
174    
175     6. IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
176     even when further rows exist.
177    
178     7. DBControlGrid: DefaultRowHeight is no longer a published property as it should
179     always be derived from panel height and setting this property can cause confusion.
180     Note for existing projects: to avoid a missing property error at run time,
181     each form using the DBControlGrid must be opened, updated and saved in the IDE
182     in order to remove the property value from the lfm.
183    
184    
185 tony 33 IBX Change Log version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
186 tony 27
187     1. TIBStoredProc. Prepare now called by ParamByName to avoid need to always
188     call Prepare before setting parameter values.
189    
190     2. Error message on ParamByName (all cases) not found now includes name of missing parameter.
191    
192     3. Code tidyup and more robust handling of dsql information result vector.
193    
194     4. Support for centralised handling of transaction status changes. TIBTransaction
195     has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
196     and "AfterExecQuery". The first three are called after the same event is called
197     for an IBCustomDataSet descendent using the Transaction. The fourth is called
198     after a call to TIBSQL.ExecQuery, again using this transaction. These new events
199     enable monitoring of transaction status changes for a given transaction to be
200     handled in a single place. For example, when a change to the dataset occurs
201     an indicator can be set that shows the user that in order to save changes,
202     the transaction should be committed. Rather than doing this per dataset, this
203     can now be done per transaction.
204    
205     5. TDataSet.CheckBrowseMode automatically posts changes to the current row when
206     the dataset is scrolled. However, any changes to the current row are, by default,
207     discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
208     have a new property "DataSetCloseAction" that adds automatic posting of changes
209     on dataset close. If this property is set to dcDiscardChanges (default) then the
210     behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
211     then IBX will attempt to post any unsaved changes before the dataset is closed
212     (and after the BeforeClose event handler is called). The exception is when the
213     dataset is being closed as a result of a transaction rollback. In this case,
214     no action is taken and any unsaved changes are discarded. This avoids both
215     unnecessary overhead and the risk that a validation error may occur in the Post
216     raising an exception and thereby preventing a rollback.
217    
218     6. String Field sizes and Display Widths should now be correct for multi-byte character sets.
219     In earlier versions, the Display Width was set to the maximum byte width rather than the character
220     width. Display Widths are now corrected by dividing by the max byte width per character.
221     For UTF8 character sets, the byte width is four and hence the Display Width will be
222     the byte width divided by 4. The byte width of each character set is determined
223     dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
224     system table. (see also http://bugs.freepascal.org/view.php?id=27766).
225    
226     7. SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
227    
228     8. IBLookupComboEditBox: List should now always be restored to full list when the
229     control loses focus. Default Key press default interval reduced to 200ms.
230    
231     9. DBControlGrid: Ensure that selection is changed to newly appended row, even
232     when dataset rows are less than visible rows.
233    
234     10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
235     does not exist or DataSet is empty. More responsive on dataset open. New event
236     OnRestorePosition. Column sort disabled if no header row.
237    
238     11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
239     while dataset state is dsInsert. Avoids posting errors.
240    
241     12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
242     avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
243    
244     13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
245    
246     14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
247     to solve a specific problem. That is when the dataset cursor is moved (e.g. by
248     a grid mouse click and the current row is being edited or inserted. In this case, TDataset
249     always "posts" the current record regardless or whether or not it may be more appropriate
250     to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
251     "MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
252     as the first action of the "Post" method and allows the handler to convert the Post
253     into a Cancel if that is the appropriate action on moving to a different row. This is
254     achieved by returning with "CancelPost" argument set to true. Note that an exception could be
255     raised here, but it may still be more appropriate to validate a post and signal
256     a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
257    
258     15. On Unix derived systems, the Firebird library name can now be given as a colon
259     separated list. Each library name on the list is tried in turn, in left to right
260     order with the first found being used as the firebird library. By default, on Linux,
261     the library name list is 'libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so.2'. This can be
262     overidden by the FBLIB environment variable or the OnGetLibraryName function.
263    
264     Note: when using the libfbembed.so, if you prefix the database name with "localhost:"
265     then it will still attempt to access the database via the Firebird Server and will
266     require a username and password. If only the pathname is given, then the username
267     and password should be omitted and the unix file permissions are used to grant
268     access.
269    
270 tony 33 IBX Change Log version (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
271 tony 23
272     1. A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
273     rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
274     that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
275 tony 27 corresponds to a row of the linked DataSource. Any data aware control on the
276 tony 23 replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
277    
278     2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
279 tony 25 When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
280 tony 23 takes place during database access. This may be useful when there are performance issues with
281     the change of cursor. Setting the property to false suppresses the change of cursor.
282    
283     3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
284     and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
285     Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
286     making all changes permanent immediately rather than when the transaction is explicitly
287     committed.
288    
289 tony 25 4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
290 tony 27 using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
291 tony 23
292 tony 33 IBX Change Log version (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
293 tony 25
294     Development version only.
295    
296 tony 33 IBX Change Log version (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
297 tony 21
298     1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
299     This is typically used during an "OnBeforeOpen" event handler to manipulate the
300     "Where" and "Having" clauses to implement user specified filters of arbitrary
301     complexity.
302    
303     2. A new Component Palette entry "Firebird Data Controls" is now available. This has
304     three new data aware controls dependent on IBX and which make use of the SQL Parser.
305     These are:
306    
307     - TIBLookupComboEditBox
308     - TIBDynamicGrid
309     - TIBTreeview
310    
311     TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
312     of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
313     to revise the available list and restrict it to items that are prefixed by the
314 tony 25 typed text (either case sensitive or case insensitive). Autoinsert allows a
315 tony 21 newly typed entry to be added to the list dataset and included in the available
316     list items.
317    
318     TIBDynamicGrid is a TDBGrid descendent that provides for:
319     - automatic resizing of selected columns to fill the available row length
320     - automatic positioning and sizing of a "totals" control, typically at the
321     column footer, on a per column basis.
322     - DataSet resorting on header row click, sorting the dataset by the selected column.
323     A second click on the same header cell reversed the sort order.
324     - Support for a "Panel Editor". That is on clicking the indicator column, the row
325     is automatically expanded and a panel superimposed on it. The panel can have any
326     number of child controls, typically data aware controls with the same datasource
327     as the grid allowing for editing of additional fields and more complex editors.
328     - Reselection of the same row following resorting.
329     - A new cell editor that provides the same functionality as TIBLookupComboEditBox.
330     Its properties are specified on a per column basis and allows for one or more
331     columns to have their values selected from a list provided by a dataset.
332     Autocomplete and autoinsert are also available. The existing picklist editor
333     is unaffected by the extension.
334    
335     TIBTreeView is a data aware TCustomTreeView.
336    
337     3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
338     zero scale will no longer return an error. An Int64 will be returned instead.
339    
340     4. TIBTransaction now has events for Before and After Transaction End and a new function
341     "GetEndAction" allowing the EndAction to be accessed by these event handlers.
342    
343     5. TIBQuery can now handle correctly queries which contain the same keyword parameter
344     repeated multiple times.
345    
346     6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
347     check used to get in the way of using Stored Procedures, and "Update or Insert"
348     statements.
349    
350     7. Insert, Modify and Delete property Editors now support Query Generation from
351     Stored Procedures.
352    
353     8. Three new examples illustrate the use of the new IB Controls
354    
355    
356 tony 33 IBX Change Log version (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
357 tony 19
358     1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
359     setting performance. See "readme.field+param.names in the doc folder.(Thanks to
360     Gabor Boros for reporting this problem and for testing the improvements).
361    
362     2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
363     See readme.field+param.names in the doc folder.
364    
365     3. IBX SQL Editors will now automatically add double quotes around column names when the database
366     dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
367    
368     4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
369    
370     5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
371     actions.
372    
373     6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
374     thanks to Yuriy Kopnin for pointing this out).
375    
376     7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
377    
378     8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
379     for both fields and parameter setting.
380    
381     9. Changes to the Select SQL in an IBCustomDataset descendent should now be
382     visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
383    
384     10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
385     when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
386    
387     11. TIBTable now has a property editor for "MasterFields"
388    
389     12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
390     GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
391    
392     13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
393     of settings is unrecognised. Selecting this radio button has no effect on the settings.
394    
395    
396 tony 17 IBX Change Log version (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
397    
398     1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
399    
400 tony 15 IBX Change Log version (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
401    
402     1. In a TIBCustomDataset descendent, a generator now only sets the value when
403     it is null. This allows for alternative user defined setting of the generator
404    
405     Many thanks to Julio Jiménez for this fix
406    
407     2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
408     and suggests that the user may have forgotten to install it.
409    
410 tony 13 IBX Change Log version (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
411    
412     1. Conditional compilation used to limit registration of TIntegerField to
413     Lazarus versions less than 1.1
414    
415     2. When a database connection is created, character set is now by default set
416     to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
417     1250 to 1254.
418    
419    
420 tony 11 IBX Change Log version (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
421    
422     1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
423    
424    
425 tony 9 IBX Change Log version (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
426 tony 7
427     1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
428     Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
429    
430     2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
431     package is changed to do this (which it should do).
432    
433     IBX Change Log version (1.0-0) Sat, 28 Apr 2012 16:43:00 +0100
434    
435     1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
436    
437     2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
438    
439     3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
440    
441     4. Property editors should now correctly resize.
442    
443     5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
444     (restored original functionality)
445    
446     6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
447     library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.