https://bugs.documentfoundation.org/show_bug.cgi?id=105039

--- Comment #4 from Howard Johnson <[email protected]> ---
Hi again,

I remember how baffled I was when I first encountered this stuff in early
Access versions many years ago. It is the first big thing that is quite
different in Base from say, a spreadsheet.  So I feel it is very important to
help the new user quickly understand this data setup, as being so fundamental
to using forms and subforms.  I want more people to use Base.  So I want it to
be easier to use.  

I suppose there are three ways that this all could be more clear:


1) First, I think the name `Analyze SQL command` could be more to the point. 
Is it possible to rename it to `Enable Filter and Sort`?  (BTW. MS Access calls
this same feature `Enable Filter`.)  I would think this would be the first,
best way to improve overall clarity.


2) But failing that, is there some way to produce a hover mode flyout help
message explaining this property better, i.e. saying that what it actually does
is: enable the Filter and Sort properties?


3) Or failing even that, there might be better F1 help.  See my specific
suggestions below.  Also I think the F1 help needs usage examples.  I suggest
you give a few examples for each and every one of these parameters.  I think
people learn much more quickly from examples than from explanations.


Here is what I suggest for help verbiage:




---------------------------------------------------------------
Content type

To select the data your form will operate on, select a `Content type` and then
specify a related `Content`.  Later you can also possibly specify a Filter
criteria and/or Sort specification.  Content types:

Table/View - To read or write to a Table or View, set `Content type` to `Table`
and `Content` to a table or view's name.

Query - To read or write to a query, set `Content type` to `Query` and
`Content` to a query's name.

SQL - To read or write to a data set described by a SQL statement, set `Content
type` to `SQL` and `Content` to the actual SQL code to specify the data set.

Examples:
    Content type     Table
    Content            Payroll

    Content type     Query
    Content         Payroll query

    Content type     SQL
    Content         ( SELECT FirstName, LastName FROM Payroll )


Notes:

* If you wish to create or write records, any table needs to be writeable, and
any query or SQL needs to be updatability.

* Each Form and SubForm has it's own independent (but possibly overlapping)
data set.  A SubForm's data set is often linked to its parent's form with
special criteria which filter a subset of the SubForm's data.

* See also: `Filter` and `Sort`

* If using a SubForm see also:  `Link Master Fields`, and `Link Slave Fields`. 
These engage additional selection criteria dependent on the parent's form.




---------------------------------------------------------------
Content

See Content type above.




---------------------------------------------------------------
Filter


(Note: at the moment I'm not seeing any help for Filter when I click F1 on it)


Enter any criteria desired to limit the data read via Content Type and Content.
 Format of this criteria is the same as for a SQL WHERE statement. 

This is only one of two possible filter stages, the other one being a subform
link that produces it's own, additional data filtering so that a subform can
respond to what is selected in a master form.

Example:

    Filter        FirstName='Fred'


See also: `Content type` and SubForm linking via `Link master fields`, and
`Link slave fields`.




---------------------------------------------------------------
Sort

"Specifies the conditions to sort ..." etc.  (Good enough I think, but pls add
a usage example:).

Example:

    Sort        FirstName, LastName DESC





---------------------------------------------------------------
Thanks guys!

-- 
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
Libreoffice-bugs mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

Reply via email to