[Libreoffice-commits] core.git: connectivity/registry

[Libreoffice Gerrit user]

 connectivity/registry/README |   24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

New commits:
commit 690dffce4fa5db01fcda60df467e75272d5a4863
Author:     Julien Nabet <serval2412 at yahoo.fr>
AuthorDate: Tue Oct 2 21:26:55 2018 +0200
Commit:     Julien Nabet <serval2412 at yahoo.fr>
CommitDate: Wed Oct 3 05:14:51 2018 +0200

    Add README for xcu drivers in connectivity/registry
    
    I used comments from https://bugs.documentfoundation.org/show_bug.cgi?id=119743
    + https://gerrit.libreoffice.org/#/c/61144/
    
    Thank you to Lionel and Stephan
    
    Change-Id: I956b0c2009e3fa1169ba57a059dde0016375def5
    Reviewed-on: https://gerrit.libreoffice.org/61272
    Reviewed-by: Lionel Elie Mamane <lionel at mamane.lu>
    Tested-by: Julien Nabet <serval2412 at yahoo.fr>

diff --git a/connectivity/registry/README b/connectivity/registry/README
new file mode 100644
index 000000000000..833006be3e3e
--- /dev/null
+++ b/connectivity/registry/README
@@ -0,0 +1,24 @@
+xcu files are made from several sections, the main ones are: Properties and Features
+
+Property: actual setting with its underlying type and its default value
+
+Feature: a boolean that says "let the user change that setting in the Advanced Settings UI"
+
+This is checked by using officecfg/registry/schema/org/openoffice/Office/DataAccess/Drivers.xcs
+and configmgr mechanism
+There are two kinds of properties named "Value":
+- first one is in "Property" groups and has a static oor:type="any" (can take on boolean, int and other types of values)
+- second one is in "Feature" groups and has a static oor:type="boolean" so can take on only boolean values.
+
+Each node in Feature section must have an equivalent in Property section
+Most of the time the node name of both sections should be equal,
+however there are 4 known exceptions (more?):
+- "UseBracketedOuterJoinSyntax" feature => "EnableOuterJoinEscape" property
+- "UseDOSLineEnds" feature => "PreferDosLikeLineEnds" property
+- "UseSQL92NamingConstraints" feature => "EnableSQL92Check" property
+- "UseKeywordAsBeforeAlias" feature => "GenerateASBeforeCorrelationName"
+
+See dbaccess/source/ui/dlg/DbAdminImpl.cxx, ODbDataSourceAdministrationHelper constructor, eg:
+m_aIndirectPropTranslator.emplace( <ID>, <property> )
+and dbaccess/source/ui/misc/dsmeta.cxx, lcl_getFeatureMappings() function, eg:
+{ <ID>, <feature> }
\ No newline at end of file