From ed18f8e4f9fc516d1a9e117e983cdc8006838ad1 Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Tue, 8 Jun 2021 09:14:19 -0300 Subject: Refactor some database help files Change-Id: Ia9f3e2844cdf4ac16d7ee3ba70d64415c2bf964d Reviewed-on: https://gerrit.libreoffice.org/c/help/+/116837 Tested-by: Jenkins Reviewed-by: Olivier Hallot --- AllLangHelp_sdatabase.mk | 3 + AllLangHelp_shared.mk | 3 - source/text/sdatabase/dabaadvprop.xhp | 40 ++++++++ source/text/sdatabase/dabaadvpropdat.xhp | 108 +++++++++++++++++++++ source/text/sdatabase/dabaadvpropgen.xhp | 52 ++++++++++ .../text/shared/explorer/database/dabaadvprop.xhp | 43 -------- .../shared/explorer/database/dabaadvpropdat.xhp | 97 ------------------ .../shared/explorer/database/dabaadvpropgen.xhp | 49 ---------- 8 files changed, 203 insertions(+), 192 deletions(-) create mode 100644 source/text/sdatabase/dabaadvprop.xhp create mode 100644 source/text/sdatabase/dabaadvpropdat.xhp create mode 100644 source/text/sdatabase/dabaadvpropgen.xhp delete mode 100644 source/text/shared/explorer/database/dabaadvprop.xhp delete mode 100644 source/text/shared/explorer/database/dabaadvpropdat.xhp delete mode 100644 source/text/shared/explorer/database/dabaadvpropgen.xhp diff --git a/AllLangHelp_sdatabase.mk b/AllLangHelp_sdatabase.mk index b2723e0c47..337313b72e 100644 --- a/AllLangHelp_sdatabase.mk +++ b/AllLangHelp_sdatabase.mk @@ -45,6 +45,9 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,sdatabase,\ helpcontent2/source/text/sdatabase/11030100 \ helpcontent2/source/text/sdatabase/11080000 \ helpcontent2/source/text/sdatabase/11090000 \ + helpcontent2/source/text/sdatabase/dabaadvpropdat \ + helpcontent2/source/text/sdatabase/dabaadvpropgen \ + helpcontent2/source/text/sdatabase/dabaadvprop \ )) # vim: set noet sw=4 ts=4: diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk index 65feeac783..6ebe3e7db2 100644 --- a/AllLangHelp_shared.mk +++ b/AllLangHelp_shared.mk @@ -861,9 +861,6 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\ )) $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\ - helpcontent2/source/text/shared/explorer/database/dabaadvprop \ - helpcontent2/source/text/shared/explorer/database/dabaadvpropdat \ - helpcontent2/source/text/shared/explorer/database/dabaadvpropgen \ helpcontent2/source/text/shared/explorer/database/dabadoc \ helpcontent2/source/text/shared/explorer/database/dabaprop \ helpcontent2/source/text/shared/explorer/database/dabapropadd \ diff --git a/source/text/sdatabase/dabaadvprop.xhp b/source/text/sdatabase/dabaadvprop.xhp new file mode 100644 index 0000000000..fc008f5d58 --- /dev/null +++ b/source/text/sdatabase/dabaadvprop.xhp @@ -0,0 +1,40 @@ + + + + + +Advanced Properties +/text/sdatabase/dabaadvprop.xhp + + +Database advanced properties dialog + + + +
+

Advanced Properties

+Specifies advanced properties for the database. +
+
+In a database window, choose Edit - Database - Properties, click Advanced Properties tab +
+ + + +
diff --git a/source/text/sdatabase/dabaadvpropdat.xhp b/source/text/sdatabase/dabaadvpropdat.xhp new file mode 100644 index 0000000000..0a0e98f944 --- /dev/null +++ b/source/text/sdatabase/dabaadvpropdat.xhp @@ -0,0 +1,108 @@ + + + + + + + Special Settings + /text/sdatabase/dabaadvpropdat.xhp + + + + + + + database;special settings + database settings;SQL92 naming + database settings;keyword AS + database settings;outer join syntax + database settings;special SELECT statements + database settings;ODBC date/time + database settings;support primary keys + database settings;line ends + database settings;version columns + +
+

Special Settings

+ Specifies the way you can work with data in a database. +
+
+ In a database window, choose Edit - Database - Advanced Settings + +
+ The availability of the following controls depends on the type of database: +

Use SQL92 naming constraintsUFI: found this for dBase and for text file folder

+ Only allows characters that conform to the SQL92 naming convention in a name in a data source. All other characters are rejected. Each name must begin with a lowercase letter, an uppercase letter, or an underscore ( _ ). The remaining characters can be ASCII letters, numbers, and underscores. + +

Use keyword AS before table alias names

+ Some databases use the keyword "AS" between a name and its alias, while other databases use a whitespace. Enable this option to insert AS before the alias.http://dba.openoffice.org/specifications/Data_Source_Property_Dialog.sxw + + +

End text lines with CR + LFUFI: found for dBase and text file folder

+ Select to use the CR + LF code pair to end every text line (preferred for DOS and Windows operating systems). + +

Append the table alias name in SELECT statements

+ Appends the alias to the table name in SELECT statements. + +

Use Outer Join syntax '{OJ }'

+ Use escape sequences for outer joins. The syntax for this escape sequence is {oj outer-join}copied from shared\explorer\database\02010100.xhp + Example: + select Article.* from {oj item LEFT OUTER JOIN orders ON item.no=orders.ANR} + +

Ignore the privileges from the database driver

+ Ignores access privileges that are provided by the database driver. + +

Replace named parameters with ?

+ Replaces named parameters in a data source with a question mark (?). + +

Display version columns (when available)

+ Some databases assign version numbers to fields to track changes to records. The version number of a field is incremented by one each time the contents of the field are changed. Displays the internal version number of the record in the database table.copied from shared\explorer\database\11090000.xhp + +

Use the catalog name in SELECT statements

+ Uses the current data source of the catalog. This option is useful when the ODBC data source is a database server. Do not select this option if the ODBC data source is a dBASE driver.copie from shared\explorer\database\11020000.xhp + +

Use the schema name in SELECT statements

+ Allows you to use the schema name in SELECT statements.UFI: ??? + +

Create index with ASC or DESC statement

+ Creates an index with ASC or DESC statements.UFI: ??? + +

Comparison of Boolean values

+ Select the type of Boolean comparison that you want to use.UFI: ??? + +

Form data input checks for required fieldsi82291

+ When you enter a new record or update an existing record in a form, and you leave a field empty which is bound to a database column which requires input, then you will see a message complaining about the empty field. + If this control box is not enabled, then the forms in the current database will not be checked for required fields. + The control box is available for all data source types which support write access to their data. The control box does not exist for spreadsheets, text, csv, and the various read-only address books. + +

Ignore currency field information

+ Only for Oracle JDBC connections. When enabled it specifies that no column is treated as a currency field. The field type returned from the database driver is discarded. + + +

Use ODBC conformant date/time literals

+Use date/time literals that conform to ODBC standard. + + +

Supports primary keys

+Enable to overrule Base's heuristics used to detect whether the database supports primary keys. +When connecting to a database using a generic API like ODBC, JDBC, or ADO, Base currently applies heuristics to determine whether this database supports primary keys. None of those APIs has dedicated support to retrieve this information. +The heuristics sometimes fails. This tri-state check box by default is set to the undetermined state, which means "apply the heuristics". If the check box is enabled, primary key support is assumed. If the check box is disabled, no primary key support is assumed. +Note that if this option is just for overruling the heuristics. If you enable the check box for a database which actually does not support primary keys, you will see some errors. + +
diff --git a/source/text/sdatabase/dabaadvpropgen.xhp b/source/text/sdatabase/dabaadvpropgen.xhp new file mode 100644 index 0000000000..d9312dc5e5 --- /dev/null +++ b/source/text/sdatabase/dabaadvpropgen.xhp @@ -0,0 +1,52 @@ + + + + + +Generated Values +/text/sdatabase/dabaadvpropgen.xhp + + +Advanced Properties dialog Generated values tab page + + + + + database advanced properties;autoincrement values + database advanced properties;automatic generated values + database advanced properties;retrieve generated values + database advanced properties;query generated values + +
+

Generated Values

+Specifies the options for automatically generated values for new data records.UFI: all text copied from shared\explorer\database\11020000.xhp +
+how to get this: Edit Database AdvancedProp ??? I have no idea +The availability of the following controls depends on the type of database: +

Retrieve generated values

+Enables $[officename] support for auto-incremented data fields in the current ODBC or JDBC data source. Select this option if the auto-increment feature in the SDBCX layer of the database is not supported. In generalUFI: this does not mean that something is set by default, but "normally,", the auto-increment is selected for the primary key field. +

Auto-increment statement

+Enter the SQL command specifier that instructs the data source to auto-increment a specified Integer data field. For example, the following MySQL statement used the AUTO_INCREMENT statement to increase the "id" field each time the statement creates a data field: +CREATE TABLE "table1" ("id" INTEGER AUTO_INCREMENT) +For this example, you must enter AUTO_INCREMENT into the Auto-increment statement box. +

Query of generated values

+Enter an SQL statement that returns the last auto-incremented value for the primary key data field. For example: +SELECT LAST_INSERT_D(); + +
diff --git a/source/text/shared/explorer/database/dabaadvprop.xhp b/source/text/shared/explorer/database/dabaadvprop.xhp deleted file mode 100644 index ee8535766e..0000000000 --- a/source/text/shared/explorer/database/dabaadvprop.xhp +++ /dev/null @@ -1,43 +0,0 @@ - - - - - - - - -Advanced Properties -/text/shared/explorer/database/dabaadvprop.xhp - - -Database advanced properties dialog - - - -
-Advanced Properties -Specifies advanced properties for the database. -
-
-In a database window, choose Edit - Database - Properties, click Advanced Properties tab -
- - - -
diff --git a/source/text/shared/explorer/database/dabaadvpropdat.xhp b/source/text/shared/explorer/database/dabaadvpropdat.xhp deleted file mode 100644 index 399a8693d0..0000000000 --- a/source/text/shared/explorer/database/dabaadvpropdat.xhp +++ /dev/null @@ -1,97 +0,0 @@ - - - - - - - Special Settings - /text/shared/explorer/database/dabaadvpropdat.xhp - - - - - -
-

Special Settings

- Specifies the way you can work with data in a database. -
-
- In a database window, choose Edit - Database - Advanced Settings - -
- The availability of the following controls depends on the type of database: -

Use SQL92 naming constraintsUFI: found this for dBase and for text file folder

- Only allows characters that conform to the SQL92 naming convention in a name in a data source. All other characters are rejected. Each name must begin with a lowercase letter, an uppercase letter, or an underscore ( _ ). The remaining characters can be ASCII letters, numbers, and underscores. - -

Use keyword AS before table alias names

- Some databases use the keyword "AS" between a name and its alias, while other databases use a whitespace. Enable this option to insert AS before the alias.http://dba.openoffice.org/specifications/Data_Source_Property_Dialog.sxw - - -

End text lines with CR + LFUFI: found for dBase and text file folder

- Select to use the CR + LF code pair to end every text line (preferred for DOS and Windows operating systems). - -

Append the table alias name in SELECT statements

- Appends the alias to the table name in SELECT statements. - -

Use Outer Join syntax '{OJ }'

- Use escape sequences for outer joins. The syntax for this escape sequence is {oj outer-join}copied from shared\explorer\database\02010100.xhp - Example: - select Article.* from {oj item LEFT OUTER JOIN orders ON item.no=orders.ANR} - -

Ignore the privileges from the database driver

- Ignores access privileges that are provided by the database driver. - -

Replace named parameters with ?

- Replaces named parameters in a data source with a question mark (?). - -

Display version columns (when available)

- Some databases assign version numbers to fields to track changes to records. The version number of a field is incremented by one each time the contents of the field are changed. Displays the internal version number of the record in the database table.copied from shared\explorer\database\11090000.xhp - -

Use the catalog name in SELECT statements

- Uses the current data source of the catalog. This option is useful when the ODBC data source is a database server. Do not select this option if the ODBC data source is a dBASE driver.copie from shared\explorer\database\11020000.xhp - -

Use the schema name in SELECT statements

- Allows you to use the schema name in SELECT statements.UFI: ??? - -

Create index with ASC or DESC statement

- Creates an index with ASC or DESC statements.UFI: ??? - -

Comparison of Boolean values

- Select the type of Boolean comparison that you want to use.UFI: ??? - -

Form data input checks for required fieldsi82291

- When you enter a new record or update an existing record in a form, and you leave a field empty which is bound to a database column which requires input, then you will see a message complaining about the empty field. - If this control box is not enabled, then the forms in the current database will not be checked for required fields. - The control box is available for all data source types which support write access to their data. The control box does not exist for spreadsheets, text, csv, and the various read-only address books. - -

Ignore currency field information

- Only for Oracle JDBC connections. When enabled it specifies that no column is treated as a currency field. The field type returned from the database driver is discarded. - - -

Use ODBC conformant date/time literals

-Use date/time literals that conform to ODBC standard. - - -

Supports primary keys

-Enable to overrule Base's heuristics used to detect whether the database supports primary keys. -When connecting to a database using a generic API like ODBC, JDBC, or ADO, Base currently applies heuristics to determine whether this database supports primary keys. None of those APIs has dedicated support to retrieve this information. -The heuristics sometimes fails. This tri-state check box by default is set to the undetermined state, which means "apply the heuristics". If the check box is enabled, primary key support is assumed. If the check box is disabled, no primary key support is assumed. -Note that if this option is just for overruling the heuristics. If you enable the check box for a database which actually does not support primary keys, you will see some errors. - -
diff --git a/source/text/shared/explorer/database/dabaadvpropgen.xhp b/source/text/shared/explorer/database/dabaadvpropgen.xhp deleted file mode 100644 index 8627519bce..0000000000 --- a/source/text/shared/explorer/database/dabaadvpropgen.xhp +++ /dev/null @@ -1,49 +0,0 @@ - - - - - - - - -Generated Values -/text/shared/explorer/database/dabaadvpropgen.xhp - - -Advanced Properties dialog Generated values tab page - - - -
-Generated Values -Specifies the options for automatically generated values for new data records.UFI: all text copied from shared\explorer\database\11020000.xhp -
-how to get this: Edit Database AdvancedProp ??? I have no idea -The availability of the following controls depends on the type of database: -Retrieve generated values -Enables $[officename] support for auto-incremented data fields in the current ODBC or JDBC data source. Select this option if the auto-increment feature in the SDBCX layer of the database is not supported. In generalUFI: this does not mean that something is set by default, but "normally,", the auto-increment is selected for the primary key field. -Auto-increment statement -Enter the SQL command specifier that instructs the data source to auto-increment a specified Integer data field. For example, the following MySQL statement used the AUTO_INCREMENT statement to increase the "id" field each time the statement creates a data field: -CREATE TABLE "table1" ("id" INTEGER AUTO_INCREMENT) -For this example, you must enter AUTO_INCREMENT into the Auto-increment statement box. -Query of generated values -Enter an SQL statement that returns the last auto-incremented value for the primary key data field. For example: -SELECT LAST_INSERT_D(); - -
-- cgit