You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by wa...@apache.org on 2020/11/02 20:38:09 UTC
[openoffice-org] 02/02: Migration of dba html content
This is an automated email from the ASF dual-hosted git repository.
wave pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/openoffice-org.git
commit 6423f73a2238853319bd4a53fc2ff1046ecd516b
Author: Dave Fisher <da...@davefisher.tech>
AuthorDate: Mon Nov 2 12:37:44 2020 -0800
Migration of dba html content
---
content/dba/FAQ/LDAP_field_mapping.html | 790 ++++++++++++++
content/dba/FAQ/Outlook_field_mapping.html | 854 +++++++++++++++
content/dba/FAQ/index.html | 37 +
content/dba/FAQ/specific.html | 487 +++++++++
content/dba/development/index.html | 37 +
content/dba/development/project_structure.html | 100 ++
content/dba/development/projects.html | 516 +++++++++
content/dba/drivers/index.html | 58 ++
content/dba/drivers/mdb/index.html | 181 ++++
content/dba/drivers/postgresql/index.html | 780 ++++++++++++++
content/dba/drivers/sqlite/index.html | 153 +++
content/dba/howto/AppendTableAlias.html | 251 +++++
content/dba/howto/IgnoreDriverPrivileges.html | 251 +++++
content/dba/howto/OuterJoinSequence.html | 252 +++++
content/dba/howto/UserDefinedDriverUI.html | 176 ++++
content/dba/howto/index.html | 44 +
content/dba/howto/mozillaprofile.html | 102 ++
content/dba/howto/param_subst.html | 255 +++++
content/dba/index.html | 100 ++
content/dba/menu.html | 28 +
content/dba/project_tools.html | 53 +
.../dba/specifications/AutoIncrementValues.html | 306 ++++++
.../dba/specifications/Drag_Drop_DSBrowser.html | 137 +++
content/dba/specifications/Form_Navigator_DnD.html | 371 +++++++
.../dba/specifications/MySQL_data_source_page.html | 245 +++++
.../specifications/address_book_architecture.html | 1100 ++++++++++++++++++++
content/dba/specifications/character_sets.html | 105 ++
.../dba/specifications/file_based_functions.html | 210 ++++
content/dba/specifications/index.html | 610 +++++++++++
content/dba/test/DataSource.html | 495 +++++++++
content/dba/test/DataSource_new.html | 495 +++++++++
content/dba/test/DataSource_new_new.html | 495 +++++++++
content/dba/test/FormController.html | 266 +++++
33 files changed, 10340 insertions(+)
diff --git a/content/dba/FAQ/LDAP_field_mapping.html b/content/dba/FAQ/LDAP_field_mapping.html
new file mode 100644
index 0000000..6ccd88c
--- /dev/null
+++ b/content/dba/FAQ/LDAP_field_mapping.html
@@ -0,0 +1,790 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>LDAP address book – field mapping in OpenOffice.org</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.1 EA2 (Win32)">
+ <META NAME="CREATED" CONTENT="20020205;11525300">
+ <META NAME="CHANGED" CONTENT="20021010;11145871">
+ <STYLE>
+ <!--
+ TD P { color: #000000; font-family: "Albany" }
+ P { color: #000000; font-family: "Albany" }
+ H2 { color: #000000 }
+ -->
+ </STYLE>
+</head>
+<body LANG="en-US" TEXT="#000000">
+<H2 STYLE="margin-top: 0cm; margin-bottom: 0cm; page-break-before: always">
+<FONT COLOR="#cc3300"><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>LDAP
+address book – field mapping in OpenOffice.org</B></FONT></FONT></FONT></H2>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=2 CELLSPACING=0 STYLE="page-break-before: always">
+ <COL WIDTH=31*>
+ <COL WIDTH=44*>
+ <COL WIDTH=39*>
+ <COL WIDTH=38*>
+ <COL WIDTH=104*>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT><B>OOo Column Name</B></P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT><B>Mozilla/OOo Attribute</B></P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><B>Mozilla LDAP attribute</B></P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><B>Mozilla LDAP alias</B></P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT><B>Mozilla LDAP similar Attribute</B></P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>First Name</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>FirstName</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>givenname</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Last Name</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>LastName</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>sn</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>surname</P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Display Name</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>DisplayName</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>cn</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>commonname</P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>displayname</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Nickname</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>NickName</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>xmozillanickname</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>E-mail</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>PrimaryEmail</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>mail</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>E-mail (2)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>SecondEmail</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>xmozillasecondemail</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Mail Format</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>PreferMailFormat</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>xmozillausehtmlmail</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Phone (Work)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkPhone</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>telephonenumber</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Phone (Home)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomePhone</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>homephone</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Fax</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>FaxNumber</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>facsimiletelephonenumber</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>fax</P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Pager</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>PagerNumber</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>pager</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P>pagerphone</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Mobile</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>CellularNumber</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>mobile</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P>cellphone,carphone</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Address 1</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeAddress</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Address 2</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeAddress2</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>City</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeCity</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>State</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeState</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>ZIP/Postal (Home)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeZipCode</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Country</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>HomeCountry</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Work Address
+ </P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkAddress</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>postofficebox</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>streetaddress</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Work Address 2</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkAddress2</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>City (Work)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkCity</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>l</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>locality</P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>State (Work)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkState</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>st</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P>region</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>ZIP/Postal (Work)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkZipCode</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>Zip</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>postalcode</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Country (Work)</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WorkCountry</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>countryname</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Job Title</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>JobTitle</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>title</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Department</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Department</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>ou</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>department, orgunit, departmentnumber</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Company</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Company</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>o</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>company</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Web Page 1</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WebPage1</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>workurl</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Web Page 2</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>WebPage2</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>homeurl</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Year</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>BirthYear</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>birthyear</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Month</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>BirthMonth</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Day</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>BirthDay</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 1</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Custom1</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>custom1</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 2</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Custom2</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>custom2</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 3</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Custom3</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>custom3</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 4</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Custom4</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>custom4</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT>Comments</P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>Notes</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>notes</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P ALIGN=LEFT>description</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>_AimScreenName</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>nscpaimscreenname</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=12% HEIGHT=16>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=17%>
+ <P ALIGN=LEFT>LastModifiedDate</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P ALIGN=LEFT>modifytimestamp</P>
+ </TD>
+ <TD WIDTH=15%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=41%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+</TABLE>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+</body>
+</HTML>
diff --git a/content/dba/FAQ/Outlook_field_mapping.html b/content/dba/FAQ/Outlook_field_mapping.html
new file mode 100644
index 0000000..d47670c
--- /dev/null
+++ b/content/dba/FAQ/Outlook_field_mapping.html
@@ -0,0 +1,854 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Outlook/MAPI address book – field mapping in OpenOffice.org</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.1 Beta 1 (Win32)">
+ <META NAME="CREATED" CONTENT="20020205;11525300">
+ <META NAME="CHANGED" CONTENT="20030131;8450314">
+ <STYLE>
+ <!--
+ TD P { color: #000000; font-family: "Albany" }
+ P { color: #000000; font-family: "Albany" }
+ H2 { color: #000000 }
+ -->
+ </STYLE>
+</head>
+<body LANG="en-US" TEXT="#000000" DIR="LTR">
+<H2 STYLE="margin-top: 0cm; margin-bottom: 0cm; page-break-before: always">
+<FONT COLOR="#cc3300"><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>Outlook/MAPI
+address book – field mapping in OpenOffice.org</B></FONT></FONT></FONT></H2>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=2 CELLSPACING=0 STYLE="page-break-before: always">
+ <COL WIDTH=38*>
+ <COL WIDTH=46*>
+ <COL WIDTH=46*>
+ <COL WIDTH=100*>
+ <COL WIDTH=26*>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT><B>OOo Column Name</B></P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><B>Mozilla/OOo Attribute</B></P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><B>Outlook Column name</B></P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT><B>Outlook MAPI Propery name</B></P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><B>Comment</B></P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>First Name</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>FirstName</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>First Name</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_GIVEN_NAME_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Last Name</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>LastName</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Last Name</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_SURNAME_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Display Name</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>DisplayName</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Full Name</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_DISPLAY_NAME_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Nickname</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>NickName</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Nickname</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_NICKNAME_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>E-mail</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>PrimaryEmail</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>E-mail</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_EMAIL_ADDRESS_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>E-mail (2)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>SecondEmail</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Mail Format</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>PreferMailFormat</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Phone (Work)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkPhone</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business Phone</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BUSINESS_TELEPHONE_NUMBER_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Phone (Home)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomePhone</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home Phone</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_HOME_TELEPHONE_NUMBER_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Fax</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>FaxNumber</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business Fax</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_BUSINESS_FAX_NUMBER_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Pager</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>PagerNumber</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Pager</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_PAGER_TELEPHONE_NUMBER_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Mobile</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>CellularNumber</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Mobile</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_MOBILE_TELEPHONE_NUMBER_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Address 1</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeAddress</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home Address
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_STREET_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>First line</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Address 2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeAddress2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home Address</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_STREET_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>Remainder</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>City</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeCity</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home City</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_CITY_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>State</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeState</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home State/Province</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_STATE_OR_PROVINCE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>ZIP/Postal (Home)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeZipCode</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home ZIP/Postal Code</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_POSTAL_CODE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Country</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>HomeCountry</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home Country/Region</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_HOME_ADDRESS_COUNTRY_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Work Address
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkAddress</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business Address</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_BUSINESS_ADDRESS_STREET_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>First Line</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Work Address 2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkAddress2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business Address</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BUSINESS_ADDRESS_STREET_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT>Remainder</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>City (Work)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkCity</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business City</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_BUSINESS_ADDRESS_CITY_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>State (Work)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkState</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business State/Province</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>ZIP/Postal (Work)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkZipCode</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Business ZIP/Postal Code</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Country (Work)</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WorkCountry</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Home Country/Region</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P ALIGN=LEFT>PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Job Title</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>JobTitle</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Title</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_TITLE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Department</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Department</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Department</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_DEPARTMENT_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Company</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Company</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Company</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_COMPANY_NAME_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Web Page 1</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WebPage1</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Web Page Address</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BUSINESS_HOME_PAGE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Web Page 2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>WebPage2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_PERSONAL_HOME_PAGE_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Year</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>BirthYear</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Birthday</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BIRTHDAY (year)</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>derived</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Month</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>BirthMonth</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P>Birthday</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BIRTHDAY (month)</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>derived</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Birth Day</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>BirthDay</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P>Birthday</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_BIRTHDAY (day)</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P>derived</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 1</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Custom1</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Custom2</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 3</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Custom3</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Custom 4</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Custom4</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT>Comments</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Notes</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>Comments</P>
+ </TD>
+ <TD WIDTH=39%>
+ <P>PR_COMMENT_W</P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>_AimScreenName</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=15% HEIGHT=16>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT>LastModifiedDate</P>
+ </TD>
+ <TD WIDTH=18%>
+ <P ALIGN=LEFT><BR>
+ </P>
+ </TD>
+ <TD WIDTH=39%>
+ <P><BR>
+ </P>
+ </TD>
+ <TD WIDTH=10%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+</TABLE>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+</body>
+</HTML>
diff --git a/content/dba/FAQ/index.html b/content/dba/FAQ/index.html
new file mode 100644
index 0000000..131b03b
--- /dev/null
+++ b/content/dba/FAQ/index.html
@@ -0,0 +1,37 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>OpenOffice.org Base - Tips 'n' Tricks</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body lang="en-US">
+ <span style="font-weight: bold;">Project Sections</span>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../FAQ/index.html"><b>Tips 'n' Tricks</b></a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="../development/index.html">Development</a>
+ | <a href="../drivers/index.html">Database Drivers</a><br/>
+ <span style="font-weight: bold;">Tips 'n' Tricks Sections</span>:
+ <a href="specific.html">Database Specific Problems</a>
+ <div class="dba">
+ <h1 id="dba_tt">OpenOffice.org Base - Tips and Tricks</h1>
+ <table cellpadding="3" cellspacing="0" border=1>
+ <tbody>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top;"><a href="specific.html">Database Specific Problems</a><br>
+ </td>
+ <td style="vertical-align: top;">Problems and Questions concerning specific
+ databases.<br>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+ <p>Also visit the <a href="http://wiki.services.openoffice.org/wiki/Category:Base_Documentation">Base Documentation</a> in the Wiki,
+ which on the long run will replace this site here.</p>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/FAQ/specific.html b/content/dba/FAQ/specific.html
new file mode 100644
index 0000000..12ce3b9
--- /dev/null
+++ b/content/dba/FAQ/specific.html
@@ -0,0 +1,487 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
+ <meta content="text/css" http-equiv="Content-Style-Type">
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>OpenOffice.org Base - Tips 'n' Tricks</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body lang="en-US">
+ <span style="font-weight: bold;">Project Sections</span>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a style="font-weight: bold;" href="../FAQ/index.html">Tips 'n' Tricks</a>
+ | <a href="/QA/index.html">QA</a>
+ | <a href="../development/index.html">Development</a>
+ | <a href="/drivers/index.html">Database Drivers</a><br/>
+ <span style="font-weight: bold;">Tips 'n' Tricks Sections</span>:
+ <a href="../FAQ/specific.html"><b>Database Specific Problems</b></a>
+ <hr/>
+ <div class="dba">
+ <h1 id="dba_tt_specific">Database Specific Problems</h1>
+ <table style="width: 100%; text-align: left;" border="0" cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr>
+ <td colspan="2" rowspan="1" width="20"><a style="font-weight: bold;" href="#mysql">MySQL</a><br>
+ </td>
+ </tr>
+ <tr>
+ <td width="20"/>
+ <td><a href="#libversion">I get a strange error message about <b>library versions</b> and <b>symbols</b> - what's up?</a></td>
+ </tr>
+ <tr>
+ <td width="20"/>
+ <td><a href="#connectmysql">How can I <b>connect</b> to <b>MySQL</b>?</a></td>
+ </tr>
+ <tr>
+ <td width="20"><br>
+ </td>
+ <td><a href="#editmysqltable">I cannot <b>edit</b> a newly created <b>table</b>!</a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#mysqlenc">My strings are not correctly <b>encoded</b> when using
+ MySQL <b>connector</b> (JDBC).</a>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;"/>
+ <td style="vertical-align: top;"><a href="#mysqlnumeric">I get an error when
+ inserting values into a numeric field.</a></td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;"><br>
+ </td>
+ <td style="vertical-align: top;"><a href="#mysqllocalhost">I can't get <b>write
+ access</b> to the database running on <b>localhost</b> when connecting via <b>JDBC</b>!</a><br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" rowspan="1"><a href="#sqlserver"><b>SQL Server</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#sqls_auto">How to get the correct value for an auto value (<b>auto
+ increment</b>) when inserting a new row?<br>
+ </a>
+ </td>
+ </tr>
+
+ <tr>
+ <td colspan="2" rowspan="1"><a href="#ms_access"><b>MS Access</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#access_auto"><b>Auto increment</b> fields are not shown by connecting over <b>ODBC</b><br>
+ </a>
+ </td>
+ </tr>
+
+ <tr>
+ <td colspan="2" rowspan="1"><a href="#sapdb"><b>SAP DB</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#sap_adabas">How do I connect to a <b>SAP DB</b> through the <b>Adabas</b>
+ driver?<br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" rowspan="1"><a href="#postgresql"><b>PostgreSQL</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#postgres_hang">When trying to connect (ODBC) to <b>PostgreSQL</b> my
+ Office seems to <b>hang</b>.<br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#postgres_serial"><b>Serial</b> columns don't work.<br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#postgres_tcid">When executing a SQL query I get the error message
+ that column <b>tcid</b> is duplicate.<br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;"><br>
+ </td>
+ <td style="vertical-align: top;"><a href="#tablecrash">OOo <b>crashes</b> when I <b>create
+ a table</b> in PostgreSQL</a><br>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;"><br>
+ </td>
+ <td style="vertical-align: top;"><a href="#postgres_oid">I get the error <b>"ERROR: Attribute oid not found"</b> when I try to <b>open</b> a table</h4>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" rowspan="1" width="20"><a href="#oracle"><b>Oracle</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#oracle_odbc">When using the <b>ODBC</b> driver to connect to <b>Oracle</b>,
+ not all seems to work well.<br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#Oracle_Currency">All columns are shown as currency fields when using
+ their <b>JDBC</b> driver.</a><br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" rowspan="1"><a href="#db2"><b>DB2</b><br>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td><br>
+ </td>
+ <td><a href="#db2_relation">When trying to create <b>relations</b>, the new
+ relations aren't visible after reopening the relation design.<br>
+ </a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+ <hr style="width: 100%; height: 4px;">
+ <h3><a name="mysql"></a>MySQL</h3>
+
+ <!-- ============================================== -->
+ <h4><a name="libversion"></a>I get a strange error message about library versions and symbols - what's up?</h4>
+ <p>
+ When you try to connect to a MySQL Database via ODBC you may receive the following
+ error:
+ <pre>
+[unixODBC][Driver Manager]Can't open lib
+'/usr/lib/libmyodbc.so.2' : /usr/lib/libmyodbc.so.2: symbol errno, version
+GLIBC_2.0 not defined in file libc.so.6 with link time reference
+</pre>
+
+ This is because the ODBC Driver was compiled for kernel 2.4 and you are using
+ kernel 2.6.<br/>
+ A workaround is to start Open Office with a command line like this:
+ LD_ASSUME_KERNEL=2.4.22 '/path/to/OpenOffice.org1.1.1/soffice' -calc
+ </p>
+
+ <p>Thanks to <a href="mailto:eddie.who@gmx.at">Othmar Edel</a> for contributing this item.</p>
+ <div style="text-align: right;">
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#mysql">MySQL</a><br>
+ </div>
+ </div>
+
+ <!-- ============================================== -->
+ <h4><a name="connectmysql"></a>How can I connect to MySQL?</h4>
+ We just introduced a new type, specifically for MySQL. But you have always to
+ know which kind of connection you want to use. Please have a look at the MySQL
+ spec page <a href="http://dba.openoffice.org/specifications/MySQL_data_source_page.html">
+ http://dba.openoffice.org/specifications/MySQL_data_source_page.html</a>.<br>
+ First you should decide which kind of driver you should use. At the moment
+ there are two possibilities. Either you use an ODBC or a JDBC implementation.<br>
+ <br>
+ via ODBC: A good first look at can be found on the <a href="http://www.unixodbc.org/doc/OOoMySQL9.pdf">
+ unixODBC sites</a> in the manuals section.<br>
+ <br>
+ via JDBC: (These steps are only valid for the MySQL connector)<br>
+ <ol>
+ <li>
+ Get the newest JDBC driver from <a href="http://www.mysql.com">www.mysql.com</a>
+ </li>
+ <li>
+ Start OpenOffice.org
+ <ul>
+ <li>
+ Goto Tools/Options/Security
+ </li>
+ <li>
+ press the browse button near "Classpath" and browse for the *.jar file(s) of
+ your driver.</li>
+ </ul>
+ </li>
+ <li>
+ Restart OpenOffice.org
+ </li>
+ <li>
+ Open the data source administration dialog (Tools/Data Sources...)
+ </li>
+ <li>
+ Press the button "New Data Source", in the name field, enter a valid name like
+ "MySQL JDBC", and keep "JDBC" as type.
+ </li>
+ <li>
+ Enter the data source URL mysql://host:3306/DataabaseName
+ </li>
+ <li>
+ Switch to the tab page JDBC. Now you have to enter the driver class name. For
+ the MySQL connector driver you have to insert: com.mysql.jdbc.Driver.<br>
+ If you use any other kind of driver, you have to look at the manual for the
+ correct driver name.
+ </li>
+ <li>
+ Enter the name of the user you wish to connect, and mark the checkbox if this
+ user needs a password.
+ </li>
+ <li>
+ To be sure that your settings will be saved, press the Apply button.
+ </li>
+ <li>
+ To test if you could connect to MySQL switch to the Tables page.</li>
+ </ol>
+ If all went well you should now see the tables which already exists in the
+ database. If the connection has failed the tables control in the middle will be
+ disabled.<br>
+ <br>
+ <div style="text-align: right;">
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#mysql">MySQL</a><br>
+ </div>
+ </div>
+ <h4><a name="editmysqltable"></a>I cannot edit a newly created table!</h4>
+ The first reason may be that the table was created without a primary key or a
+ unique index. In this case open the table design for that specific table and
+ select the columns which identify a row uniquely, open the context menu and
+ select the entry "Primary key" and save the table. After that the table should
+ be editable.<br>
+ <br>
+ Second reason, the table privileges are not set right. This is the case when
+ the table "Mysql.tables_priv" doesn't contain the right privileges. To verify
+ this, open a new query design and insert in the text view the statement "SELECT
+ * FROM mysql.tables_priv" and switch the mode to native in toolbar. When
+ executing this statement, you should see your table name with the necessary
+ privileges. If your table name doesn't appear in this list, you have to grant
+ yourself the privileges. This isn't done automatically. Open the context menu
+ upon your tables entry on the left side in your data source browser and choose
+ SQL. In the appearing window insert "GRANT ALL ON yourtablename TO
+ yourusername" (find more about the <a href="http://www.mysql.com/doc/en/GRANT.html">
+ GRANT syntax</a> at the MySQL documentation site) and execute this statement.
+ Now your table should be editable.<br>
+ If you're connecting to MySQL via JDBC, the
+ <span style="font-weight: bold; font-family: monospace;">useHostsInPrivileges=false</span>
+ option in the connection URL may be worth additional consideration. It tells
+ MySQL to ignore the host which you are connecting from, when calculating your
+ privileges.<br>
+ <br>
+ Third reason, your driver which you are using isn't up to date. In earlier
+ releases of MyODBC we recognize that the privileges and the currently username
+ are not correctly returned.<br>
+ <br>
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="index.html#mysql">MySQL</a></div>
+ <h4><a name="mysqlenc"></a>My strings are not correctly encoded when using MySQL
+ connector (JDBC).</h4>
+ You can enable the use of Unocode with extending the connection string for
+ jdbc:mysql:<br>
+ <br>
+ <span style="font-family: monospace;">mysql://host:3306/DatabaseName?<span style="font-weight: bold;">useUnicode=TRUE&characterEncoding=your
+encoding</span></span><br>
+ <br>
+ When the character encoding is not set, then the encoding from server will be
+ used. Please have a look at the MySQL documentation for more information about
+ this topic.<br>
+ <br>
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="index.html#mysql">MySQL</a><br>
+ <div style="text-align: left;">
+ <h4><a name="mysqlnumeric"></a>I got an error when inserting values into a
+ numeric field.</h4>
+ The current implementation of MySQL ODBC doesn't recognize the correct locale.
+ So if you try to insert any value into a numeric field and you use an other
+ locale than English, you got an error.<br>
+ <br>
+ The workaround for this would be to switch your language setting to US-English.<br>
+ <br>
+ Here is a link to the issue, describing the bug. <a href="http://dba.openoffice.org/project/www/issues/show_bug.cgi?id=6600">
+ http://dba.openoffice.org/project/www/issues/show_bug.cgi?id=6600</a><br>
+ <br>
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="file:///G:/src/dba/www/FAQ/index.html">
+ Tips and Tricks</a> - <a href="file:///G:/src/dba/www/FAQ/index.html#mysql">MySQL</a><br>
+ <div style="text-align: left;">
+ <h4><a name="mysqllocalhost"></a>I can't get write access to the database running
+ on localhost when connecting via JDBC!</h4>
+ You probably already granted permissions to <b>user@localhost</b> for the table
+ in question, and you probably already <a href="/howto/IgnoreDriverPrivileges.html">
+ convinced OOo to assume all privileges</a> (ignoring what the driver tells).
+ Then you may also need to grant privileges to <b>user@127.0.0.1</b> (which is
+ the IP address of "localhost").<br>
+ Credits go to <a href="mailto:jpmcc@openoffice.org">John McCreesh</a> for
+ finding this.<br>
+ <div style="text-align: right;"><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="file:///G:/src/dba/www/FAQ/index.html">
+ Tips and Tricks</a> - <a href="file:///G:/src/dba/www/FAQ/index.html#mysql">MySQL</a><br>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ <h3><b><a name="sqlserver"></a>SQL Server</b></h3>
+ <h4><b><a name="sqls_auto"></a>How to get the correct value for an "auto value"
+ (auto increment) when inserting a new row?</b></h4>
+ To fetch auto increment values, insert "SELECT @@identity" into the field
+ "Query of generated values" on the second page in the data source
+ administration dialog.<br>
+ <br>
+ <div style="text-align: right;">
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#sqlserver">SQL server</a><br>
+ </b>
+ </div>
+ </div>
+
+ <h3><b><a name="ms_access"></a>MS Access</b></h3>
+ <h4><b><a name="access_auto"></a>Auto increment fields are not shown by connecting over ODBC</b></h4>
+ The problem with Access and ODBC is that you can create tables which contain auto increment fields, but the driver never tell you again that this column was an auto increment one. So auto increment columns,
+Access and ODBC do not work well with each other. If possible, connecting over ADO is to prever.<br>
+ <br>
+ <div style="text-align: right;">
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#ms_access">MS Access</a><br>
+ </b>
+ </div>
+ </div>
+
+ <h3><b><a name="sapdb"></a>SAP DB</b></h3>
+ <h4><b><a name="sap_adabas"></a>How do I connect to a SAP DB through the Adabas
+ driver?</b></h4>
+ To connect to SAP DB, you have to create a new folder (e.g. sapdb), in this
+ folder you create a 2nd folder named sql. In this folder you copy all libs (on
+ windows dlls) which are included in the ODBC driver of SAP DB. Then you define
+ a new data source for your SAP DB. A sample for this can be found in your SAP
+ DB installation (under Windows just open your ?ata Sources (ODBC)?. The next
+ step will be to define a system variable named DBROOT. This variable has to
+ point to the folder you created in the first step (sapdb). Now you can define a
+ data source in your OpenOffice and access the database.<br>
+ On Unix systems you also have to define soft link named odbclib.so to
+ ContentStorage.so. (ln -s $DBROOT/depend74/lib/ContentStorage.so
+ $DBROOT/depend74/lib/odbclib.so )<br>
+ This lib can be found in your sap installation sapdb/depend74/lib (may be this
+ folder is named different depending on your SapDB version you use).<br>
+ <br>
+ Another possibility to connect to SapDB would be simply to use the existing
+ ODBC or JDBC driver from SapDB.<br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#sapdb">SAP DB</a><br>
+ </b>
+ </div>
+ <h3><b><a name="postgresql"></a>PostgreSQL</b></h3>
+ <h4><b><a name="postgres_hang"></a>When trying to connect (ODBC) to PostgreSQL my
+ Office seems to hang.</b></h4>
+ Check the ODBC driver you are using. If this driver has the number 7.02.0005
+ then you have to go back and use a prior one. 7.02.0003 works.<br>
+ <br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#postgresql">PostgreSQL</a><br>
+ </b>
+ </div>
+ <h4><b><a name="postgres_serial"></a>Serial columns don't work.</b></h4>
+ Can't be solved until the ODBC driver returns correct information about this
+ kind of type. :-( Sorry.<br>
+ You might also be interested in <a href="http://www.openoffice.org/issues/show_bug.cgi?id=3872">
+ this bug</a> which requests the feature.<br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="index.html#postgresql">PostgreSQL</a><br>
+ </b>
+ </div>
+ <h4><b><a name="postgres_tcid"></a>When executing a SQL query I get the error
+ message that column "tcid" is duplicate.</b></h4>
+ This is a bug of the driver with number 7.02.0005. The version 7.02.0003
+ works. You can download PostgreSQL ODBC drivers from <a href="http://www.geocities.jp/inocchichichi/psqlodbc">
+ here</a>.<br>
+ <br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="index.html#postgresql">PostgreSQL</a><br>
+ </b>
+ </div>
+ <h4><b><a name="tablecrash"></a>OOo crashes when I create a table in PostgreSQL</b></h4>
+ If you're using unixodbc 2.2.4, please <a href="http://www.unixodbc.org/">upgrade
+ to 2.2.6</a>, at least. This version fixes the problem.<br>
+ If you're already using 2.2.6 or higher, or if you're using another driver
+ manager, or another platform, then you encountered a new bug. In this case,
+ please help us improving the product and <a href="http://www.openoffice.org/issues/enter_bug.cgi">
+ submit an issue for this</a> (component: "database access").<br>
+ <br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="file:///G:/src/www/dba/FAQ/index.html">
+ Tips and Tricks</a> - <a href="file:///G:/src/www/dba/FAQ/index.html#postgresql">
+ PostgreSQL</a><br>
+ </b>
+ </div>
+ <h4><b><a name="postgres_oid"></a>I get the error "ERROR: Attribute oid not found" when I try to open a postgres table</b></h4>
+ Please UNcheck the "updateable cursors" option in the settings of the ODBC driver
+ <br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="file:///G:/src/www/dba/FAQ/index.html">
+ Tips and Tricks</a> - <a href="file:///G:/src/www/dba/FAQ/index.html#postgresql">
+ PostgreSQL</a><br>
+ </b>
+ </div>
+
+ <h3><b><a name="oracle"></a>Oracle</b></h3>
+ <h4><b><a name="oracle_odbc"></a>When using the ODBC driver to connect to Oracle,
+ not all seems to work well.</b></h4>
+ Try the newest JDBC driver from Oracle - older drivers are known to have some
+ problems together with OpenOffice.org.<br>
+ <h4><b><a name="Oracle_Currency"></a>All columns are shown as currency fields when
+ using their JDBC driver.</b></h4>
+ This is a bug in the JDBC driver from Oracle.<br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#oracle">Oracle</a><br>
+ </b>
+ </div>
+ <h3><b><a name="db2"></a>DB2</b></h3>
+ <h4><b><a name="db2_relation"></a>When trying to create relations, the new
+ relations aren't visible after reopening the relation design.</b></h4>
+ This is a problem the ODBC driver for DB2 has. You should switch to their JDBC
+ driver to avoid such problems. May be this driver is even better than the ODBC
+ one.<br>
+ <br>
+ <div style="text-align: right;"><b><a href="http://www.openoffice.org">OpenOffice.org</a>
+ - <a href="http://dba.openoffice.org/index.html">Database Access</a> - <a href="index.html">
+ Tips and Tricks</a> - <a href="#db2">DB2</a></b></div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/development/index.html b/content/dba/development/index.html
new file mode 100644
index 0000000..9e3b69b
--- /dev/null
+++ b/content/dba/development/index.html
@@ -0,0 +1,37 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>OpenOffice.org Base - Miscellaneous</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body lang="en-US">
+ <b>Project Sections</b>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="./index.html"><b>Development</b></a>
+ | <a href="../drivers/index.html">Database Drivers</a><br/>
+ <b>Development Sections</b>:
+ <a href="./projects.html">Developer Projects</a>
+ | <a href="./project_structure.html">Project Structure</a>
+ <div class="dba">
+ <h1 id="dba_dev">OpenOffice.org Base - Development</h1>
+ <table cellpadding="0" cellspacing="0" ID="Table1">
+ <tbody>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top; width: 200px;"><a href="projects.html">Developer projects</a></td>
+ <td style="vertical-align: top;">You're a developer, and you want to help? Look
+ here for a list of (most self-contained) projects ....</td>
+ </tr>
+ <tr class="EvenTableRow">
+ <td style="vertical-align: top; width: 200px;"><a href="project_structure.html">Project Structure</a></td>
+ <td style="vertical-align: top;">You want to poke around in the code, and don't know where to start?</td>
+ </tr>
+ </tbody>
+ </table>
+ <br>
+ </body>
+</html>
diff --git a/content/dba/development/project_structure.html b/content/dba/development/project_structure.html
new file mode 100644
index 0000000..3929ac4
--- /dev/null
+++ b/content/dba/development/project_structure.html
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>OpenOffice.org Base - Miscellaneous</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body lang="en-US">
+ <b>Project Sections</b>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="./index.html"><b>Development</b></a>
+ | <a href="../drivers/index.html">Database Drivers</a><br/>
+ <b>Development Sections</b>:
+ <a href="../development/projects.html">Developer Projects</a>
+ | <a href="./project_structure.html"><b>Project Structure</b></a>
+ <div class="dba">
+ <h1 id="dba_dev_structure">Developer Projects</h1>
+ <table cellpadding="0" cellspacing="0">
+ <tbody>
+ <tr class="MainTableHeader">
+ <td colspan="2" width="100%">Modules in the Database Access Project</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td style="vertical-align: top;" width="15%">Module</td>
+ <td style="vertical-align: top;">Functionality</td>
+ </tr>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top;" width="15%"><a href="http://svn.apache.org/viewvc/openoffice/trunk/main/connectivity/">connectivity</a><br/>
+ </td>
+ <td style="vertical-align: top;">Base connectivity. This module contains database
+ driver implementations for ODBC 3.0, JDBC, ADO, dBase, and CSV files. The way
+ to access these drivers is very similar to JDBC as the drivers implement an API
+ which covers the JDBC API..<br/>
+ </td>
+ </tr>
+ <tr class="EvenTableRow">
+ <td style="vertical-align: top;" width="15%"><a href="http://svn.apache.org/viewvc/openoffice/trunk/main/dbaccess/">dbaccess</a><br/>
+ </td>
+ <td style="vertical-align: top;">Database access layer. This module contains code
+ for accessing databases from applications. It also contains the following:
+ <br/>
+ <ul>
+ <li>
+ Core implementations for configuration of data sources</li>
+ <li>
+ Additional implementations like RowSets and abstractions like database meta
+ informations</li>
+ <li>
+ A graphical user interface (GUI) for customizing data sources and access to
+ data<br/>
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <br />
+ <table cellpadding="0" cellspacing="0">
+ <tbody>
+ <tr class="MainTableHeader">
+ <td colspan="2" width="100%">Modules in other Projects, related to Database
+ Access</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td style="vertical-align: top;" width="15%">Module<br/>
+ </td>
+ <td style="vertical-align: top;">Functionality<br/>
+ </td>
+ </tr>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top;" width="15%"><a href="http://svn.apache.org/viewvc/openoffice/trunk/main/forms/">forms</a><br/>
+ </td>
+ <td style="vertical-align: top;">This module, though currently part of the GSL
+ project, is related to Database access as well. It contains most of the code
+ necessary to build up a form layer (means the components for logical forms,
+ control models, and controls). This project is self-contained, means it is only
+ exporting UNO components.<br/>
+ </td>
+ </tr>
+ <tr class="EvenTableRow">
+ <td style="vertical-align: top;" width="15%"><a href="http://svn.apache.org/viewvc/openoffice/trunk/main/svx/">svx</a><br/>
+ </td>
+ <td style="vertical-align: top;">Additional implementations for integrating the
+ form layer into the applications can be found in the SVX module, project
+ graphics. Here, the directories svx/source/form and svx/source/fmcomp belong to
+ Database Access.<br/>
+ <br/>
+ Additionally, basics for the form layer (more precise, basics for integrating
+ UNO controls into applications drawing layer) can be found in
+ svx/source/svdraw.<br/>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </body>
+</html>
diff --git a/content/dba/development/projects.html b/content/dba/development/projects.html
new file mode 100644
index 0000000..7fd5956
--- /dev/null
+++ b/content/dba/development/projects.html
@@ -0,0 +1,516 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
+ <meta content="text/css" http-equiv="Content-Style-Type">
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <style type="text/css">.effort_header { font-weight:bold; }</style>
+ <title>Developer projects</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body>
+ <b>Project Sections</b>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="./index.html"><b>Development</b></a>
+ | <a href="../drivers/index.html">Database Drivers</a><br/>
+ <b>Development Sections</b>:
+ <a href="../development/projects.html"><b>Developer Projects</b></a>
+ | <a href="./project_structure.html">Project Structure</a>
+ <hr/>
+ <div class="dba">
+ <h1 id="dba_dev_projects">Developer Projects</h1>
+ <p>Below is a list of projects which could be implemented by interested developers.
+ Most of these projects are relatively self-contained, and do not require too much knowledge
+ about OOo's code infrastructure.</p>
+ <p>Note that this list doesn't claim to be a complete repository of what will be
+ done in the near/medium future. There may be items on the list which will never
+ be realized, and there definitely are items which are not on the list, but will
+ be implemented.</p>
+ <p>If you are interested in anything from the list, please speak at
+ <a href="mailto:dev@dba.openoffice.org">dev@dba.openoffice.org</a>. We'll gladly
+ help you to get started on this.</p>
+
+ <p>Also, make sure you don't miss <a href="http://development.openoffice.org/todo.html">OpenOffice.org's global TODO list</a>,
+ which also contains interesting projects for developers.</p>
+
+ <p>Here is what you'll find below:
+ <ol>
+ <li>
+ <a href="#dbase_joins">Joins in dBase queries</a></li>
+ <li>
+ <a href="#ldap">SDBC driver for LDAP directories</a></li>
+ <li>
+ <a href="#form_controls">New/Enhanced Form Controls</a></li>
+ <li>
+ <a href="#form_dialogs">Dialogs with Form Functionality</a></li>
+ <li>
+ <a href="#driver_modules">Database driver UI modularization</a></li>
+ <li>
+ <a href="#single_file_backend">HSQLDB: single-file backend</a></li>
+ <li>
+ <a href="#embed_derby">Embed Derby into OpenOffice.org databases</a></li>
+ <li>
+ <a href="#cross_access">native, cross-platform access to MS Access databases</a></li>
+ <li>
+ <a href="#vcards">SDBC driver for vCards</a></li>
+ <li>
+ <a href="#new_filter">New Filter Dialog</a></li>
+ </ol></p>
+
+ <h3>General Notes</h3>
+ <p>Whenever we talk about user interface work, this implies working with VCL, the
+ Visual Class Library in OpenOffice.org. If you are not familiar with it, you
+ will curse it, since especially some of the older parts never heard the word
+ "documentation". On the other hand: In opposite to the native platform
+ controls, everything is there as source code, so if you like "learning by
+ debugging", you will love VCL
+ <img src="../images/smile.gif" alt="smile" style="width: 19px; height: 19px;" class="vertically_centerred"/>.</p>
+
+ <p>Additionally, be aware of the fact that feature implementations in
+ OpenOffice.org require a specification (you may visit
+ <a href="http://specs.openoffice.org">the specifications project</a> for more
+ information). There's a rule that nothing is checked into the master branch
+ which doesn't have a specification which all stakeholders agreed upon - so
+ unlike other open source projects you may know, the specification really is
+ an important part. Stakeholders are: the documentation team, the user experience
+ team, the quality assurance team, and development. Usually, one representative
+ from every team needs to accept your specification.</p>
+
+ <p>Well, don't let this hinder you in starting. Just be aware that there will be a
+ time when a specification is finally needed. Most developers don't like writing such documents
+ (and some people even claim that <a href="http://www.joelonsoftware.com/articles/fog0000000034.html">they shouldn't</a>).
+ Thus, you need to clarify who will take this for you, if you can't/don't want.</p>
+
+ <p>A note about the effort: This is a rather rough guess at the moment. In
+ general, it may be a good idea to add two or more weeks or so simply for
+ becoming familiar with the code and some concepts, so if it is "2 weeks", don't
+ expect to start today and finish it in 14 days ...</p>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ====================== -->
+ <!-- Joins in dBase queries -->
+ <h3><a name="dbase_joins"></a>Joins in dBase queries</h3>
+
+ <p>The descirption of this project has been moved to
+ <a href="http://wiki.services.openoffice.org/wiki/Base_To-Do/Joins_in_dBase_queries" target="_blank">our
+ Wiki</a>.</p>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ================================ -->
+ <!-- SDBC driver for LDAP directories -->
+ <h3><a name="ldap"></a>SDBC driver for LDAP directories</h3>
+ <p>The description of this project has been moved to
+ <a href="http://wiki.services.openoffice.org/wiki/Base_To-Do/SDBC_driver_for_LDAP_directories" target="_blank">our
+ Wiki</a>.</p>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ========================== -->
+ <!-- New/Enhanced Form Controls -->
+ <h3><a name="form_controls"></a>New/Enhanced Form Controls</h3>
+ <p>The description of this project has been moved to
+ <a href="http://wiki.services.openoffice.org/wiki/Base_To-Do/New+Enhanced_Form_Controls" target="_blank">our
+ Wiki</a>.</p>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- =============================== -->
+ <!-- Dialogs with Form Functionality -->
+ <h3><a name="form_dialogs"></a>Dialogs with Form Functionality</h3>
+ <h4>description</h4>
+ <p>When creating a form, the user always needs to bother with a Writer (or Calc or
+ Draw) document. Very often, this is much too oversized. It would be sufficient
+ to have a simple dialog which contains all the data access controls. Now that
+ we have UNO-based dialogs (in the Basic IDE), this is possible in general, as
+ there already are some basics for doing this. There still would be a lot of
+ work to be done (not mentioning the concrete design), but since some months,
+ it's at least possible.</p>
+
+ <p>The advantage would be to not slay the user with things she does not bother
+ – a writer document offers a lot of possibilities which are not relevant
+ for a form. In some cases, a full writer document does even contradict to what
+ users expect from a form – one thing to mention here is that documents
+ are always freely sizable (and even do autosizing according to the previous
+ instance of the same document type, the screen resolution, whatever), which is
+ nothing you expect from a carefully designed form, where controls are placed at
+ concrete positions and have a fixed size.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>C++</li>
+ <li>UNO</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>familiarity with OOo's database access and form API</li>
+ <li>familiarity with OOo's toolkit API (module com.sun.star.awt)</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>3 months</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>high</td>
+ </tr>
+ </tbody>
+ </table>
+ <br/>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- =============================== -->
+ <!-- Database driver UI modularization -->
+ <h3><a name="driver_modules"></a>Database driver UI modularization</h3>
+ <h4>description</h4>
+
+ <p>OpenOffice.org Base follows a component-oriented approach for enabling
+ database access. For this, database drivers are installed in
+ OpenOffice.org which provide access to a certain (class of) database(s).</p>
+
+ <p>While at the driver level, the implementation is pretty good
+ modularized, the UI implementation can be improved. Currently, there are
+ a lot of places in the code with hard-coded information, such as
+ "database X requires UI option Y".</p>
+
+ <p>The goal of this project is to design and implement a reasonable
+ architecture for bringing a driver to the UI. The existing
+ implementation needs to be migrated to this new architecture. As a proof
+ of concept, an existing currently-external driver (e.g. the
+ <a href="http://dba.openoffice.org/drivers/postgresql/index.html" title="http://dba.openoffice.org/drivers/postgresql/index.html">native PostgreSQL driver</a>)
+ should be modified so that it can be deployed into an OOo installation and makes
+ use of the features of the new architecture.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>C++</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>OOo's component technology (UNO)</li>
+ <li>OOo's configuration concepts</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>2 months</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>high</td>
+ </tr>
+ </tbody>
+ </table>
+ <br/>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- =============================== -->
+ <!-- HSQLDB: single-file backend -->
+ <h3><a name="single_file_backend"></a>HSQLDB: single-file backend</h3>
+ <h4>description</h4>
+
+ <p><a href="http:///hsqldb.org" title="http:///hsqldb.org">HSQLDB</a> is the default database
+ engine used by OpenOffice.org Base.</p>
+
+ <p>HSQLDB currently creates a number of adjacent files to store its data,
+ where all files together comprise the whole database. To allow the user
+ of OpenOffice.org Base to have a "all-in-one-file" database experience,
+ those HSQL files are currently embedded in some OOo-specific
+ container-file (the .odb file).</p>
+
+ <p>To overcome various disadvantages of this approach, it is desirable that
+ HSQL stores its data in a single, large file. Preliminary code and
+ concepts exist for this, but no final implementation.</p>
+
+ <p><i>The following project description was provided by Fred Toussi, HSQLDB project owner:</i>
+
+ <p>Currently, HSQLDB stores the database information in four separate files. These files are
+ written to using different API�s. Streams are used for some while random access is used for others.</p>
+
+ <p>The project�s aim is to allow a single file to be used for all permanent data (temporary session
+ data, or file locking may still use a separate file). So existing files that need to be integrated
+ into one are the .properties, .log, .data and .backup files. The new single file will be accessed
+ only as a random access file.</p>
+
+ <p>The project consists of developing an interface between existing code. At the low level, there is
+ already an implementation of a random access file, org.hsqldb.persist.ScaledRAFile. The new interfaces
+ will allow existing file services to use the single random access file.</p>
+
+ <p>All the files in the org.hsqldb.persist package should be studied, with the understanding that the
+ functionality of many of these files, including lock and property saving functionality, will become
+ redundant with the introduction of single file persistence.</p>
+
+ <p>The student is expected to study and become proficient in the Java IO packages and the API calls to
+ these packages currently made from HSQLDB, and write the code and test packages.</p>
+
+ <p>The mentor will provide regular guidance and help on the design of required interfaces and supervise
+ their implementation.</p>
+
+ <p>As this is considered an essential development for HSQLDB, all the work done by the student will be
+ used, and if necessary, modified or improved by other project developers. The student will get due credit
+ and will be provided with work references by the HSQLDB Project Maintainer upon successful completion of
+ the project.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>Java expertise</li>
+ <li>relational databases</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>HSQLDB architecture</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>2 months</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>high</td>
+ </tr>
+ </tbody>
+ </table>
+ <br/>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- =============================== -->
+ <!-- Embed Derby into OpenOffice.org databases -->
+ <h3><a name="embed_derby"></a>Embed Derby into OpenOffice.org databases</h3>
+
+ <p>The descirption of this project has been moved to
+ <a href="http://wiki.services.openoffice.org/wiki/Base_To-Do#Embed_Derby_into_OpenOffice.org_databases" target="_blank">our
+ Wiki</a>.</p>
+ <p> See also some <a href="http://openoffice.markmail.org/thread/6l27fyv7vpjwogsg">old information </a>on this topic from the dba@dev.openoffice.org archives. </p>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ==================================================== -->
+ <!-- Native, cross-platform access to MS Access databases -->
+ <h3><a name="cross_access"></a>Native, cross-platform access to MS Access
+ databases</h3>
+ <h4>description</h4>
+ <p><em>preliminary note</em>: In the meantime, there is an alpha version of a driver for this.
+ It's an OOo database driver which uses <a href="http://mdbtools.sourceforge.net">MDB Tools</a> to
+ read MS Access databases. See <a href="../drivers/mdb/index.html">it's home page</a> for more info.</p>
+
+ <p>A major goal of OpenOffice.org is interoperability with other office
+ applications, especially with a certain office suite which currently has some greater market share than
+ OpenOffice.org has :).</p>
+
+ <p>Unfortunately, currently OOo users, as long as they don't work on Windows, are not able <em>at all</em>
+ to access the databases of this office suite - we cannot read MDB files on platforms other than Windows
+ (where we can use Microsofts own API).</p>
+
+ <p>So the goal here is to allow Linux users to at least read the data from MDB files, using OOo.</p>
+
+ <p>There are several ways how this could be done.<br/>
+ One is to use MDB Tools, and wrap them in OOo. Since the SQL capabilities of the MDB Tools parser are
+ limited (e.g., no OR conditions in WHERE clauses are allowed), this requires work in either MDB Tools
+ itself (by improving their parser), or it would be used as provider for raw data, and OOo would faciliate
+ it's own parser/query engine (which unfortunately is also limited) to process this data.<br/>
+ Another current disadvantage of MDB Tools is that it doesn't handle UTF8, and since jet4 databases
+ stored their data in UTF8, this implies that it cannot be used for jet4 databases containing non-ASCII
+ characters (well, probably a little bit more that ASCII, but it's a serious limitation for an product as
+ international as OpenOffice.org).</p>
+
+ <p>Another way would be to re-engineer the MDB format ourself, and write a native SDBC driver (which could
+ be in C++ or probably even in Java) which provides the data. This is similar to the first approach, where
+ MDB Tools would have been used as the provider of raw data.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>C++</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>familiarity with OOo's database access API</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>2 months</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>medium</td>
+ </tr>
+ </tbody>
+ </table>
+ <br/>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ====================== -->
+ <!-- SDBC driver for vCards -->
+ <h3><a name="vcards"></a>SDBC driver for vCards</h3>
+ <h4>description</h4>
+
+ <p>OpenOffice.org has it's own open database access API called <a href="http://api.openoffice.org/docs/common/ref/com/sun/star/sdbc/module-ix.html">SDBC</a>
+ which is modeled on the architecture of <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/sql/package-summary.html">Java's
+ JDBC</a>. SDBC supports several databases and
+ database-like API's via an extensible provider architecture; ODBC 3.0, JDBC,
+ ADO, dBase and CSV are among the databases and database management systems
+ currently supported. Each SDBC provider is implemented as a UNO component.</p>
+
+ <p>It could be useful to have a dedicated driver for accessing vCards.
+ There is an infrastructure in the existing SDBC implementations for file-based
+ databases, which could be relatively easily specialized for vCard access. This would
+ broaden the range of address book data which can be used in OpenOffice.org.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>C++</li>
+ <li>familiarity with UNO</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>familiarity with OOo's database access API</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>2 weeks</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>medium</td>
+ </tr>
+ </tbody>
+ </table>
+ <br/>
+
+ <hr style="width: 100%; height: 2px;">
+
+ <!-- ================= -->
+ <!-- New Filter Dialog -->
+ <h3><a name="new_filter"></a>New Filter Dialog</h3>
+ <h4>description</h4>
+ <p>Similar to the Sort Dialog, there is a dialog which allows to filter queries
+ and tables – it can be reached the same way as the sort dialog, by using
+ the "Default Filter..." button in the toolbox of the data source browser.</p>
+ <p>This dialog suffers from some disadvantages:
+ <ul>
+ <li>
+ it's not dynamic, three filter criterions are the maximum</li>
+ <li>
+ The dialog does not really clearly distinguish between ORing and ANDing
+ filters. Though there the user can make a choice for AND or OR, it's not clear
+ what is the result if these are
+ <span style="font-style: italic;">mixed</span>. This UI is simply not
+ intuitive.<br/>
+ </li>
+ </ul>
+ This dialog should be re-implemented, so that it's functionality is extended
+ and it's more intuitive. Design (before implementation) is an important part of
+ this project.</p>
+ <p>One other place where a similar functionality is available is the
+ <span style="font-style: italic;">filter navigator</span>
+ in the
+ <span style="font-style: italic;">form based filter</span>.</p>
+ <p>This will show the so-called filter navigator, which uses a tree view to
+ represent the currently used filter for the form. It has other disadvantages
+ <ul>
+ <li>
+ it's impossible to add a filter with two AND criterions for the same column,
+ such as "name LIKE '%Foo%" and "name LIKE '%Bar%'".</li>
+ <li>
+ it's not intuitive, too (well, this is personal taste :)</li>
+ <li>
+ some functionality cannot be accessed from within the navigator, but only by
+ entering text in the form fields (for instance, try creating a new filter in a
+ form which previously does not have any filter<br/>
+ </li>
+ </ul></p>
+ <p>If the interface of the new implementation of the filter control in the new
+ filter dialog is abstract enough, then on the long term we can use it for the
+ filter navigator, too. This would require some discipline in designing the
+ classes for the new implementations, and some abstraction capabilities.
+ However, this is not the primary goal of this implementation.</p>
+
+ <table style="text-align: left;" cellspacing="0">
+ <tbody>
+ <tr>
+ <td class="effort_header" width="200px">required skills</td>
+ <td>
+ <ul>
+ <li>C++</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">useful skills</td>
+ <td>
+ <ul>
+ <li>familiarity with VCL (OpenOffice.org's visual toolkit)</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td class="effort_header">estimated effort</td>
+ <td>1 month for an experienced developer</td>
+ </tr>
+ <tr>
+ <td class="effort_header">difficulty</td>
+ <td>medium - high</td>
+ </tr>
+ </tbody>
+ </table>
+
+ <hr style="width: 100%; height: 2px;">
+
+ </div>
+ </body>
+</html>
diff --git a/content/dba/drivers/index.html b/content/dba/drivers/index.html
new file mode 100644
index 0000000..8d2d707
--- /dev/null
+++ b/content/dba/drivers/index.html
@@ -0,0 +1,58 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>OpenOffice.org Base - Drivers</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body lang="en-US">
+ <b>Project Sections</b>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="../development/index.html">Development</a>
+ | <a href="./index.html"><b>Database Drivers</b></a><br/>
+ <b>Database drivers</b>:
+ <a href="./postgresql/index.html">PostgreSQL</a>
+ | <a href="./mdb/index.html">Linux MDB</a>
+ | <a href="./sqlite/index.html">SQLite</a>
+ <div class="dba">
+ <h1 id="sdb_drivers">OpenOffice.org Base - Database Drivers</h1>
+
+ <p>There are several database drivers available which enable you to access certain database types which
+ OpenOffice.org does not have native support for. Those drivers are not (yet) part of the "official"
+ OpenOffice.org distributions, but hosted here. If you like bleeding edge technology, download the driver
+ if your choice, try it out, and give feedback to the author or in our <a href="mailto:dev@dba.openoffice.org">development
+ mailing list</a>!</p>
+
+ <p>Note that not even the authors of the drivers would, usually, call the current versions "production quality",
+ so the least thing you should have is a good backup.<img src="../images/smile.gif" alt="smile" style="width: 19px; height: 19px;"></p>
+
+ <table cellpadding="0" cellspacing="0" ID="Table1">
+ <tbody>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top;"><a href="../drivers/postgresql/index.html">PostgreSQL</a><br>
+ </td>
+ <td style="vertical-align: top;">The postgresql SDBC Driver allows to use the <a href="http://www.postgresql.org">
+ postgresql database</a> from OpenOffice.org without any other wrapper layer
+ such as odbc or jdbc.</td>
+ </tr>
+ <tr class="EvenTableRow">
+ <td style="vertical-align: top;"><a href="../drivers/mdb/index.html">Linux MDB</a><br>
+ </td>
+ <td style="vertical-align: top;">This driver (which is in development) uses the <a href="http://sourceforge.net/projects/mdbtools">MDBTools</a>
+ to provide (read) access to Microsoft Access files to Linux users of OpenOffice.org.</td>
+ </tr>
+ <tr class="OddTableRow">
+ <td style="vertical-align: top;"><a href="../drivers/sqlite/index.html">SQLite</a><br>
+ </td>
+ <td style="vertical-align: top;">This SDBC driver (currently in alpha state) is dedicated
+ to giving OpenOffice.org native access to <a href="http://www.sqlite.org">SQLite</a> databases.</td>
+ </tr>
+ </tbody>
+ </table>
+ <br>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/drivers/mdb/index.html b/content/dba/drivers/mdb/index.html
new file mode 100644
index 0000000..8efff44
--- /dev/null
+++ b/content/dba/drivers/mdb/index.html
@@ -0,0 +1,181 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="CONTENT-TYPE" content="text/html;>
+ <style type="text/css">
+ <![CDATA[ */
+ @import url("/css/dba.css");
+ /* ]]>
+ </style>
+ <title>Linux MDB driver - alpha version</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body>
+ <b>Project Sections</b>:
+ <a href="../../index.html">Home</a>
+ | <a href="../../specifications/index.html">Specifications</a>
+ | <a href="../../QA/index.html">QA</a>
+ | <a href="../../development/index.html">Development</a>
+ | <a href="../index.html"><b>Database Drivers</b></a><br/>
+ <b>Database drivers</b>:
+ <a href="../postgresql/index.html">PostgreSQL</a>
+ | <a href="../mdb/index.html"><b>Linux MDB</b></a>
+ | <a href="../sqlite/index.html">SQLite</a>
+ <hr/>
+ <div class="dba">
+ <h1 id="mdb_driver">mdb-sdbc-driver-0.1.0</h1>
+
+ <p><span style="font-size:xx-large"><b>Note</b></span>: This driver does not reflect the latest development anymore. If you want to test the latest version,
+ then please download the complete
+ <a href="http://ooo.services.openoffice.org/pub/OpenOffice.org/cws/upload/mdbdriver02/">OpenOffice.org snapshot</a>
+ containing the latest and greatest driver.</p>
+
+ <p>This snapshot has been taken from
+ <a href="http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Id=2959&Path=SRC680%2Fmdbdriver02">CWS mdbdriver02</a>, where the
+ actual development takes place.</p>
+
+ <p>If you download it, and want to share your feedback (please do so!), send a mail to
+ <a href="mailto:users@dba.openoffice.org">users@dba.openoffice.org</a>. Thanks.</p>
+
+ <h2>Content</h2>
+ <ul>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#intro">Introduction</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#install">Installation</a>
+ </p>
+ <ul>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#datasource">Adding a datasource</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#url">Url format</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#api">Using the driver via the API</a>
+ </p>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#features">Features</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#questions">Open questions</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#source">Building from source</a>
+ </p>
+ </li>
+ <li>
+ <p><a href="#author">Author</a>
+ </p>
+ </li>
+ </ul>
+ <h2><a name="intro"></a>Introduction</h2>
+ <p><a name="install"></a>Use <a href="http://sf.net/projects/mdbtools">MDB Tools</a>
+ to read Microsoft Access files under linux.
+ </p>
+ <h2>Installation</h2>
+ <ol>
+ <li>
+ <p style="margin-bottom: 0cm;">download <a href="http://prdownloads.sourceforge.net/mdbtools/mdbtools-0.5.tar.gz">
+ mdbtools 0.5.0 source tarball</a> from mdbtools.sourceforge.net.
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">unpack
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">apply this <a href="diff-mdbtools.diff">patch</a>.
+ Build and install mdbtools. See <a href="http://mdbtools.sourceforge.net/install/">
+ MDB Tools Installation Guide</a> for detail.
+ <br>
+ Patch for mdbtools cvs HEAD is <a href="diff-mdbtools-cvs-2004-01-19.diff">here</a>.<br>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">Install a OpenOffice.org1.1 or newer if you have
+ not done so already.
+ </p>
+ </li>
+ <li>
+ <p>Download the binary version of the driver.
+ </p>
+ </li>
+ </ol>
+ <p><a name="datasource"></a><a href="mdb-sdbc-0.1.0.zip">mdb-sdbc-driver-0.1.0.zip</a><br>
+ Copy the zip file in <code>OpenOffice1.1/user/uno_packages</code> folder (Note:
+ USE the zip file as a whole, DO NOT extract it). Open up a shell and switch to
+ the OpenOffice1.1/program directory and start the pkgchk tool. On success, no
+ output is given. Alternatively, you can install the driver for all users of a
+ OpenOffice.org network installation by placing the file into the <code>OpenOffice1.1/share/uno_packages</code>
+ and starting pkgchk --shared You can uninstall the package by deleting the file
+ in the uno_packages directory and starting pkgchk again.
+ </p>
+ <h3>Adding a datasource</h3>
+ <p><a name="url"></a>You can now add a datasource via the common Tools/Data
+ Sources dialog. Click on new datasource and select mdb from the Database type
+ combobox. You should currently put the file name of your mdb file into url
+ line.
+ </p>
+ <h3>URL format</h3>
+ <p>Format: <code>sdbc:mdb:mdb_filename </code>
+ </p>
+ <h3><a name="api"></a>Using the driver via the API</h3>
+ <p>To DO
+ </p>
+ <h2><a name="features"></a>Supported and missing features</h2>
+ <p><a name="DDE_LINK1"></a>The driver currently is implemented using the patched
+ MDBTOOLS v0.5. It currently has read-only support for Access 97 (Jet 3) and
+ Access 2000/2002 (Jet 4) formats. And it has following limitations:
+ </p>
+ <ol>
+ <li>
+ <p style="margin-bottom: 0cm;"><a name="DDE_LINK2"></a>It does not support i18n.
+ It means that you can only use it to access English date in a MS Access MDB
+ file. You can't use it to read Chinese , Japanese data and so on.
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">It is a readonly driver,you can't use to to write
+ data into a mdb file.
+ </p>
+ </li>
+ <li>
+ <p>It only supports a small set of sql language. Such as</p>
+ <p>select * from table_name</p>
+ <p><a name="DDE_LINK3"></a><a name="DDE_LINK4"></a>select * from ��table_name��
+ where col1 = 1 and col2 < 10
+ </p>
+ <p>select col1 from table_name where col1 = 1
+ </p>
+ <p>select ��col1�� from table_name where col1 = 1 and col2 < 10
+ </p>
+ <p><a name="DDE_LINK5"></a></p>
+ </li>
+ </ol>
+ <p><br>
+ <br>
+ </p>
+ <h2><a name="questions"></a>Open questions</h2>
+ <h2><a name="source"></a>Building from source</h2>
+ <p>To DO
+ </p>
+ <h3>Test</h3>
+ <p>To DO.
+ </p>
+ <h2><a name="author"></a>Authors</h2>
+ <p style="margin-bottom: 0cm;">The driver has been implemented and is maintained
+ by Wind Li (yl146652@openoffice.org).
+ </p>
+ </div>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/drivers/postgresql/index.html b/content/dba/drivers/postgresql/index.html
new file mode 100755
index 0000000..718bf44
--- /dev/null
+++ b/content/dba/drivers/postgresql/index.html
@@ -0,0 +1,780 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css">
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>PostgreSQL SDBC driver</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body>
+ <b>Project Sections</b>:
+ <a href="../../index.html">Home</a>
+ | <a href="../../specifications/index.html">Specifications</a>
+ | <a href="../../QA/index.html">QA</a>
+ | <a href="../../development/index.html">Development</a>
+ | <a href="../index.html"><b>Database Drivers</b></a><br/>
+ <b>Database drivers</b>:
+ <a href="../postgresql/index.html"><b>PostgreSQL</b></a>
+ | <a href="../mdb/index.html">Linux MDB</a>
+ | <a href="../sqlite/index.html">SQLite</a>
+ <hr/>
+ <div class="dba">
+ <h1 id="postgres_driver">postgresql-sdbc-driver</h1>
+ <h2>Content</h2>
+ <ul>
+ <li>
+ <a href="#intro">Introduction</a>
+ </li>
+ <li> <a href="#requirements">Requirements </a></li>
+ <li> <a href="#download">Download</a></li>
+ <li>
+ <a href="#install_2.0">Installation and usage in OO3.x/OOo2.x</a>
+ </li>
+ <li>
+ <a href="#install_1.1">Installation and usage in OO1.1.x</a>
+ </li>
+ <li> <a href="#changes">Changes</a></li>
+ <li>
+ <a href="#features">Features and know bugs</a></li>
+ <li>
+ <a href="#api">Using the driver via the API</a></li>
+ <li>
+ <a href="#source">Building from source</a></li>
+ <li>
+ <a href="#report">Reporting bugs</a></li>
+ <li>
+ <a href="#older_versions">Outdated versions</a>
+ </li>
+ <li>
+ <a href="#author">Author</a>
+ </li>
+ </ul>
+ <a name="intro">
+ <h2>
+ Introduction</h2>
+ </a>The postgresql SDBC Driver allows to use the <a href="http://www.postgresql.org">
+ postgresql database</a> from OpenOffice.org without any wrapper layer
+ such as odbc or jdbc.
+
+ <p> The current version 0.7.6a can be considerded as good beta quality (
+ with some <a href="#known_bugs">known issues</a> and missing features).
+
+ </p>
+ <p>
+ The driver is aimed at the OpenOffice.org versions 3.x/2.x/1.1.x, it does not
+ work with OOo1.0.x trees.
+ </p>
+ <p>
+ The final aim is to have an easier to use, faster, more feature rich database
+ driver than the jdbc-odbc solution. The current version should already allow
+ this in most places (though I actually have never compared them feature by feature).
+
+ <h2 id="requirements">Requirements</h2>
+
+ Install a postgresql server if you haven't one already. The current driver
+ version was tested using postgresql-7.3.2. It does not work with
+ postgresql 7.2.x server version. It should work with all other currently available including 8.x versions.
+
+ <p>
+ Install OpenOffice.org.
+
+ <h2 id="download">Download</h2></a>
+
+ Download the binary version of the driver (depending on your OOo version). <strong> Follow below installation instructions.</strong>
+ <table border="5">
+ <tbody>
+ <tr>
+ <th>Version</th>
+ <th>OOo version</th>
+ <th>
+ Platform</th>
+ <th>
+ Location</th>
+ <th>
+ md5sum</th>
+ </tr>
+ <tr>
+ <td> <strong>0.7.6b</strong> (released 2010-08-12)</td>
+ <td>OOo 3.3 and above</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.6b.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.6b.zip</a>
+ </td>
+ <td>ae8915cfd031b2c4c0cd970f9409a736</td>
+ </tr>
+ <tr>
+ <td> <strong>0.7.6a</strong> (released 2010-02-06)</td>
+ <td>OOo 2.x -> 3.2</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.6a.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.6a.zip</a>
+ </td>
+ <td>1723de995efd1ad69ee59b5e15e805a6</td>
+ </tr>
+
+ <tr>
+ <td> <strong>0.7.5</strong></td>
+ <td>OOo 1.1.x</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.5-for-oo11.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.5-for-oo11.zip</a>
+ </td>
+ <td>03484e135e2b3517a633936b211e7c7a</td>
+ </tr>
+ </tbody>
+ </table>
+ </p>
+
+ <p> Older (outdated) builds can be found <a href="#older_versions">below</a>. If your platform does not appear in the above list, you can build the driver from <a href="#source"> source</a>.
+
+ <h2 id="install_2.0"> Installation with OOo 3.x/2.x </h2>
+ <table>
+ <tr><td bgcolor="lightgrey"> OOo 2.x</td><td>
+ There are two different ways to install the driver:<br>
+ <table>
+ <tr><td bgcolor="lightgrey">1</td><td>
+ Start OpenOffice, choose Tools/Package Manager ... <br>
+ Click on the add button and select the downladed file (DO NOT EXTRACT IT !) in the
+ upcoming File dialog. The driver gets installed now, afterwards, the file is listed
+ in the dialog with state enabled. In case you have installed an older version of the
+ driver, remove it now. Close the dialog and shutdown openoffice (even the
+ quickstarter on windows must be shut down !!!).
+ </td></tr>
+ <tr><td bgcolor="lightgrey">2</td><td>
+ Shutdown OpenOffice.org (even the
+ quickstarter on windows must be closed, see the system tray at the
+ bottom right of your desktop).
+ </p>
+
+ <p> Start a shell and switch to /path/to/openoffice/program.
+ <p> <strong>Check, whether you have installed an older version of the driver.</strong>
+
+ <pre>
+ unopkg list
+ </pre>
+
+ In case there is an older version, remove it e.g. by invoking
+
+ <pre>
+ unopkg remove postgresql-sdbc-0.6.2.zip
+ </pre>
+
+ . Then install the new version with the following command:
+
+ <pre>
+ unopkg add /path/to/your/download/postgresql-sdbc-0.7.6.zip
+ </pre>
+
+ . Using the --shared option will install the driver for all users.
+ </td></tr></table>
+
+ <p>
+ Then start the OpenOffice.org Base program ./sbase. In the upcoming dialog choose
+ the option <strong> connect to an existing database</strong>. In the
+ combobox should appear <strong>postgresql</strong> (if the it is not there,
+ the installation of the driver has failed).
+
+ <p>In the upcoming dialog, you can enter space separated name/value pairs describing
+ the database connection. Note that there must not be a leading nor a trailing space
+ surrounding the attributes. At the simplest level, this string can be empty
+ ( which means connecting to the user's database instance running on the same machine ).
+ A typical url e.g. is
+
+ <pre>
+ dbname=pqtest host=mydatabaseserver
+ </pre>
+ . A full list of possible options can be found on the <a href="http://www.postgresql.org/docs/7.3/static/libpq-connect.html">postgresql site</a>
+
+ . User/password can be given in the following dialog (so that the password does not appear
+ in plain text).
+ <p> You can press the Test Connection button to verify, that your settings work.
+
+ Then press the Finish button, and you can work with your postgresql database.
+
+ <p>
+ Tip: Open the Tools/Table Filter dialog afterwards and deselect the schemas and tables, you don't want to work with (typically
+ you won't want to work with the pg_catalog (postgresql intern) schema.
+ </td></tr></table>
+
+
+ <h2 id="install_1.1"> Installation with OOo 1.1.x </h2>
+
+ <table>
+ <tr><td bgcolor="lightgrey"> OOo 1.1</td><td>
+
+ <p> <strong> In case you have used an older version of this driver, you have to deinstall
+ the old one before</strong>. This can simply be done by deleting the postgresql-sdbc-$(VERSION).zip (e.g. 0.5.0
+ or 0.6.0) file from the OpenOffice1.1.0/user/uno_packages folder.
+
+ <p>
+ Copy the postgresql-sdbc-0.7.5-for-oo11.zip file in <code>OpenOffice1.1.0/user/uno_packages</code> folder
+ <strong>(Note: USE the zip file as a whole, DO NOT extract it)</strong>. Open up a shell and switch to
+ the OpenOffice1.1.0/program directory and start the
+ </p>
+ <p>
+ pkgchk
+ </p>
+ <p>
+ tool (assuming that you have a . in your PATH). It should deinstall the old and install
+ the new version during in one run in case you have followed the steps as described above.
+ On success, no output is given.
+ </p>
+ <p>
+ Alternatively, you can install the driver for all users of a OpenOffice.org
+ network installation. This must be done by the user, who installed the network installation
+ (typically root or Administrator). All users should terminate there office before, running
+ offices won't see an effect until next restart and at worst may crash during or
+ after the installation. Place the file into the
+ <code>OpenOffice1.1.0/share/uno_packages</code>
+
+ folder (it must be the OpenOffice1.1.0 directory, which contains all the shared
+ libraries and executables). Change the
+ ownership of the file to root. Then start
+ </p>
+ <p>
+ pkgchk --shared
+
+ <p> (again assuming that you have a . in PATH). </p>
+
+ <p> You can uninstall the package by deleting the file in the uno_packages
+ directory and starting pkgchk (or as root pkgchk --shared) again.
+ </p>
+
+ <h3>
+ Adding a datasource
+ </h3>
+ <p>
+ In case you have used an older version of this driver, you can continue
+ to use your earlier configured datasources.
+ </p>
+ <p>
+ </a>You can add a new datasource via the common Tools/Data Sources dialog.
+ Click on new datasource and select postgresql from the Database type combobox.
+ You should currently put all connection information into url line by using the
+ following format (except for user/password, which optionally can be entered differently, see below ):
+ <a name="url">
+ <h3>URL format
+ </h3>
+ </a>The <code>XDriver.connect()</code> expects a url as parameter. This section
+ specifies, how the url must look like to access the postgresql driver.
+ </p>
+ <p>
+ Format: <code>sdbc:postgresql:[name1=value1] [name2=value2] [...] </code>
+ </p>
+ <p>
+ The URL must start with the <code>sdbc:postgresql:</code>prefix. The string
+ following this prefix is the connection string as it is expected by the <a href="http://www.postgresql.org/docs/7.3/static/libpq-connect.html">
+ postgresql client API </a>. Note that there must not be a leading nor a trailing space
+ surrounding the attributes, but all attributes must be separated by a space.
+ At the simplest level, this string can be empty ( which means connecting to
+ the user's database instance running on the same machine ).
+ </p>
+ <p> If you want to connect with a password and you don't want to have it appear in the url,
+ you can instead activate the second (in OOo1.1.x unnamed) tab page between General and Tables,
+ fill in the user in the appropriate input field and check the password required box. You are
+ now prompted for the password when connecting to the data source.
+ </p>
+
+
+ <p> After you have entered the url, you should switch to the tables tab in the same
+ dialog. The driver connects to the database and shows the found schemas and tables.
+ Select the schemas you want to work with (in general, you won't want to work with
+ the pg_catalog schema).
+ <a name="features">
+ </td></tr></table>
+
+ <h2>Supported and missing features</h2>
+ <ul>
+ <li>
+ Integration into OpenOffice GUI via DataSources
+ </li>
+ <li> Viewing, inserting and updating tables via the beamer window (press F4)
+ </li>
+ <li> Creation of a new table, view or index
+ </li>
+ <li> Structural modifications to existing tables</li>
+ <li> Viewing and creation of table's relationships (relational keys)</li>
+ <li> Supported data types include now strings, numbers, binaries, date and time.</li>
+ </ul>
+
+ <a name="known_bugs">The</a> following features work with some limitations one needs to keep in mind:
+ <ul>
+ <li> Renaming tables<br>
+ You can only change the schema of table or view, when your postgresql server's version is 8.1 or later.
+ Note that the change is not transactional,
+ (the alter table statement does not allow this). First the driver changes the schema
+ and if this succeeds, it tries to change the table's name.
+
+ With former versions, you can only change the table's name.
+ </li>
+ <li> Data modifcation <br>
+ Modification of data in tables via the UI (e.g. via the beamer window) is only possible, when
+ <strong>your table has a primary key</strong> and the primary key is part of the
+ used select statement (otherwise the OOo framework has no possibility to find the row
+ again to write the modification).
+ </li>
+
+ <li> The serial datatype (and default values)<br>
+ Support for serial (= auto increment ) datatype is difficult to implement,
+ because it is not really a type in postgresql.
+
+ <p> You can create tables with serial columns. Therefor you have
+ to choose a int or big int as data type of the column and set the autoincrement
+ flag to true. Note, that you can only do this during creation of the table
+ (before you press the save button the <strong>first</strong> time), as postgresql does not
+ support serials in ALTER TABLE statements.
+
+ <p> Additionally it is difficult to retrieve the generated value after an insertion in
+ such a table. The driver follows two strategies here. When the table supports
+ posgresql oids, it uses oid to find the just inserted row again. In case it does not,
+ it queries for the structure of the primary key of the table and uses the curr_val()
+ function to retrieve the last increment of the serial in this session.
+ <p> This is a little slow (because these reflection queries are executed for
+ every insertion). It might be sped up with cashing the reflection data when
+ too many people complain.
+ </li>
+ <li> Updateable resultsets<br>
+ Updateable resultsets are currently implemented for selects on simple
+ tables only. Resultsets containing data from multiple tables
+ raise errors in case a modification is attempted.
+ </li>
+ <li>Creating and editing table structures<br>
+ Creating and editing table structures works, but keep the following problems in mind
+ <ol>
+ <li> The table wizard does not yet work with the postgresql driver
+ (see <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=74185">i74185</a>).</li>
+ <li> You cannot change the type (including the lengths for
+ fixed width types) of a column. Instead delete the column,
+ press save, add a column with the same name and choose your new type
+ and press save again. This data stored in this column is lost.
+
+ <p> When you change the type by accident, OOo behaves somewhat strange.
+ When you press the save button, you don't get an error message but the
+ save button does not become disabled as it does normally. You have to
+ close the window without saving, otherwise you are locked up in
+ this window.
+ </li>
+ <li>Note also, that
+ all column comments are stored into the user's office
+ configuration and not within the postgresql database.
+ Consequently, the comments already stored in the postgresql
+ database are not shown. <p>
+ This is currently a limitation in the OOo framework itself,
+ so the framework will need to change to allow this.
+ </ol>
+ </li>
+ <li> Logging<br>
+ For diagnostic purposes, a rudimentary logging has been
+ implemented in the driver. The loglevel can be set by editing
+ a .ini or rc file in the extracted package. The file is
+ located in the following path :
+ ~/openoffice.org2/uno_packages/cache/uno_packages/postgresql-sdbc-0.7.6.zip.1086437099/postgresql-sdbc.unorc
+ , where the number is different on your system. The file
+ can be edited with a texteditor. The logevel can be set to
+ NONE (no logging), ERROR (only errornouss situations are logged),
+ INFO (some more verbose output) and SQL (every SQL statement
+ sent to the server is logged including access time in milliseconds ).
+
+ The data gets logged into the sdbc-pqsql.log in the program directory.
+ It would be nice, if someone with some database knowledge woud review
+ the queries needed to reflect the postgresql database for
+ performance problems, but just give me hints on the internal structure
+ of the queries. I can't do anything against the fact, that some queries are
+ executed multiple times (this must be done in the OOo framework).
+ </li>
+ <li> User Administration <br>
+ Priviliges are not shown and cannot be modified in the user administration dialog.
+
+ </li>
+ <li> Knwon issues</li>
+ <table>
+ <tr>
+ <td><a href="http://www.openoffice.org/issues/show_bug.cgi?id=30059">#i30059#</a></td>
+ <td>Updates may fail on tables with non-primary-indexes</td>
+ </tr>
+ <tr>
+ <td><a href="http://www.openoffice.org/issues/show_bug.cgi?id=16426">#i16426#</a></td>
+ <td>Table design dialog offer not-existent schema name</td>
+ </tr>
+ </table>
+ </ul>
+
+
+ The following features are not implemented yet, but may follow in future.
+ <ul>
+ <li> data types like clobs, blobs and arrays are not yet
+ supported. The whole datatype handling for non-standard datatypes is
+ crippled currently, here needs to be developed a concept first.
+ </li>
+ <li>
+ Callable statements (XConnection.prepareCall())
+ </li>
+ </ul>
+
+
+ <a name="api">
+ <h2>
+ Using the driver via the API</h2>
+ </a>You may use the driver via the API directly by instantiating <code>org.openoffice.comp.connectivity.pq.Driver</code>
+ service. You can use the driver also from within a python process or with a standalone java/C++ program.
+
+
+ <h2 id="source">Building from source </h2>
+ Build in a OO1.1 environment (this is needed to keep up compatibility with OOo1.1). I have actually
+ never checked, whether the driver builds in OOo2.0 env also.
+ <p>
+ Download the postgresql module from <a href="postgresql.zip">here</a>, it
+ contains the makefiles to build postgresql client API. You must place the
+ postgresql-7.3.2 tarball into the
+ download directory. Build and deliver the <code>postgresql</code> module.
+ Note, that the driver just uses the client part of the API. As postgresql
+ interprocess protocol is backward compatible, it shouldn't be problem to
+ later connect also to newer versions of the database.
+ </p>
+ <p>
+ Check out the connectivity project (e.g.
+ </p>
+ <p>
+ cvs co -r OpenOffice_1_1_rc3 connectivity
+ </p>
+ <p>
+ and then retrieve the postgresql driver code with this special tag OO_PQSDBC_x_y_z (where x,y,z are
+ the major, minor, micro of the version you wish to build).
+ </p>
+ <p>
+ cvs update -d connectivity/source/drivers/postgresql
+ connectivity/workben/postgresql<br>
+ cvs update -r OO_PQSDBC_0_6_1 connectivity/source/drivers/postgresql connectivity/workben/postgresql
+ </p>
+ <p>. Build connectivity/source/drivers/postgresql. You will then find a <code>postgresql-sdbc-0.x.y.zip</code>
+ uno-package in the bin or lib output directory.
+ </p>
+ <h3>
+ Test
+ </h3>
+ In order to test your build, you need a running instance of postgresql database
+ server and PyUNO. The test can be found in connectivity/workben/postgresql. The
+ test syntax for the dmake command is <code>dmake runtest
+ "dburl=sdbc:postgresql:dbname=pqtest" </code>. You should create a fresh
+ database pqtest (or any other name) as the test also writes data and drops
+ tables.
+ <p>
+ (Note, when you have never used postgresql server before and just want to test
+ your build, this short series of calls should give you an postgresql
+ test-server [note, that this is not the suggested way to install a postgresql
+ server, follow the postgresql instructions therefor]).
+ <table width="100%" bgcolor="lightgrey">
+ <tbody>
+ <tr>
+ <td><font size="-1">
+ <pre>gunzip < postgresql-7.3.2.tar.gz | tar -xvf -<br>cd postgresql-7.3.2<br>./configure --prefix=/path/to/your/postgres/installation<br>make ; make install<br>setenv PATH "$PATH":/path/to/your/postgres/installation/bin<br>mkdir /path/to/your/postgresql/installation/data<br>initdb -D /path/to/your/postgresl/installation/data<br>postmaster -D /path/to/your/postgresl/installation/data<br><br>now start a a separate shell:<br>setenv PATH "$PATH":/path/to/your/postgres/in [...]
+ </font>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </p>
+ <p>
+
+ <a name="changes"><h2>Changes</h2></a>
+ <ul>
+ <li>Version 0.7.6b<br>
+ <ul>
+ <li> <a href="http://www.openoffice.org/issues/show_bug.cgi?id=113494">i113494</a> the driver caused an error on OOo3.3 startup. This was fixed (an outdated configfile was removed from the package).</li>
+ </ul>
+ <li>Version 0.7.6a<br>
+ <ul>
+ <li> <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=108928">i108928</a> the driver didn't work with OOo3.2. This was fixed (an additional configuration
+ file within the package was necessary).</li>
+ </ul>
+ <li>Version 0.7.6<br>
+ <ul>
+ <li> <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=89685">i89685</a> numeric columns can now be edited again. The problem showed up since some OOo2.x version,
+ it does not occur in OOo1.x. As this is the only change, there is no 0.7.6 for OOo1.x.
+ </ul>
+ <li>Version 0.7.5<br>
+ <ul>
+ <li> <a href="http://www.openoffice.org/issues/show_bug.cgi?id=52352">i52352</a> you get now results when executing native (postgresql) queries
+ <li> minor build issues (
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=80085">i80085</a>,
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=77337">i77337</a>,
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=77336">i77336</a> )
+ <li> <a href="http://www.openoffice.org/issues/show_bug.cgi?id=80904">i80904</a>
+ a quoted single quote within a statement is now correctly recognized.
+ <li> There are now two different packages, one targeted at 1.1 version of OpenOffice, the other
+ one targeted at 2.x version of OpenOffice. The linux version differ, the windows
+ version is the same in both packages (both built in the OO1.1 build enviroment)
+ </ul>
+ <li>Version 0.7.4a<br>
+ <ul>
+ <li> identical source tree to 0.7.4, just ensures, that the driver also works, when OOo2.x is started with soffice.bin.
+ (see <a href="http://www.openoffice.org/issues/show_bug.cgi?id=77188">i77188</a>). Works only on Linux x86 with OOo2.2 and above.
+ </ul>
+ <li>Version 0.7.4<br>
+ <ul>
+ <li> Earlier versions of the driver couldn't interoperate with OOo's table wizard. There
+ had to be done changes within the driver (integrated in 0.7.4 release)
+ and OOo's table wizard (see
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=74185">i74185</a>). The fixes
+ for the table wizard have not yet been integrated into OOo (probably not before OOo 2.3).
+ <li> The varchar type is now reflected as varchar (You realize the change only in the
+ table's design view, there is now the type 'Text' instead of 'Text fix').
+ <li> Regression: The linux version of 0.7.3 had logging enabled by default, therefor the
+ driver logs information into the program directory (sdbc-pqsql.log), this has been
+ disabled again as it should.
+ </ul>
+ <li>Version 0.7.3<br>
+ <ul>
+ <li> Now both schema and table name can be changed via "table's context menu / Rename",
+ when postgresql-server's version is 8.1 or later. Note that the change is not transactional,
+ (the alter table statement does not allow this). First the driver changes the schema
+ and if this succeeds, it tries to change the table's name.
+
+ <li> In former version, the retrieval of auto values failed, when the table/primary key column
+ names had to be quoted. This bug has been fixed.
+ <li> The driver now builds also in OOo 2.x build environment.
+ </ul>
+ <li>Version 0.7.2<br>
+ <ul>
+ <li> postgresql >= 8.1.x fully supported<br>
+ In former versions, the driver could not edit/create a table with postgresql 8.1.0 and above.
+ This has been fixed (this was, because postgresql 8.1 does some stricter SQL checking).
+ <li> Type content recognition<br>
+
+ The postgresql function, that returns the type of a certain column of a result set
+ was not used correctly, this has been fixed. No content type recognition is needed
+ anymore (was introduced in 0.7.1) (thx a lot for the hint from the postgresql community).
+ </ul>
+ </li>
+ <li>Version 0.7.1<br>
+ <ul>
+ <li> Domain types fully supported (
+ <a href="http://www.openoffice.org/issues/show_bug.cgi?id=63918">63918</a>).<br>
+ In former versions, the driver could not handle columns with with domain types (
+ domain type columns were simply empty within the UI), now they are
+ fully supported.
+ <li> Type content recognition
+ <a href="http://www.openoffice.org/issues/show_bug.cgi?id=61887">61887</a>).<br>
+ When the postgresql database API does not inform about the type of a certain column in
+ a resultset, the driver now <i>guesses</i> the type of the column from content
+ of the first 100 rows within the resultset. Integers, numerics, date, time and timestamps
+ are guessed.
+ The is useful e.g. when you drag data into a spreadsheet.
+ <li> View renaming/deletion (
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=61777">61777</a> )<br>
+ Views can now be renamed or deleted using OOo UI.
+ </ul>
+ </li>
+ <li>Version 0.7.0<br>
+ <ul>
+ <li> raised driver from alpha to beta state (
+ no serious bugs have been reported for the earlier versions)
+ <li> fixed several issues with the former driver version and OO2.0.x (
+ problems with table creation, table renaming and crashes in user administration
+ have been fixed)
+ <li> data can now be inserted into tables without oids and the addition gets correctly
+ reflected in the UI. This also holds for tables with auto increment values in the
+ primary key. In former versions, this was only the case for tables with oids.
+ However the current solution requires some additional reflection queries, which
+ makes it a little slow and resource consuming.
+ <li> fixed a crash when executing native sql (see
+ <a href="http://qa.openoffice.org/issues/show_bug.cgi?id=52352">i52352</a>).
+ The bug itself is not fixed though, native sql statements still return empty resultsets only.
+ <li> adding/deleting users and password change is now supported. Privilege administration
+ is still not supported.
+ </ul>
+ <li>Version 0.6.2<br>
+ <ul>
+ <li> Tables created by OOo should now appear immediatly in the list of available
+ tables e.g. in the beamer window. Structural changes to tables (e.g. the addition
+ of a column) are now shown after reselecting the table in the beamer window. In
+ earlier versions, one had to a reconnect on the data source to see the changes.
+ <li> The driver now supports arrays, however, as the OOo framework itself currently does
+ not display arrays correctly, they are still reflected as plain strings as in earlier
+ versions. You can only make use of this new feature by using the driver via the API.
+ <li> An annoying bug has been fixed, that led to 'Input Error' pop up windows in forms. Under
+ certain circumstances, the 'not null' column property could be transported transported
+ incorrectly to OOo.
+ </ul>
+ <li>Version 0.6.1<br>
+ <ul>
+ <li> Data type handling<br>
+ Some postgresql data types are not yet correctly suppported by the driver (
+ arrays, blobs and 'esoteric types' such as circle, point, etc.). In prior version,
+ values of this type were not displayed by the driver at all. Now, they are shown in their
+ default string representation, which also allows modification of the values.
+ <p> All these types get currently mapped to the OOo Memo type, this is recognizable
+ in the Edit-table window, where they are grouped together in the type selection box.
+ </li>
+ <li> Named parameters in prepared statements (or subform support)<br>
+ In prior versions, only a '?' as a placeholder in prepared statements was supported,
+ which did not work out properly with subforms. Now additionally named parameters
+ (e.g. ':x' or ':myvar') are supported, which allows full subform support.
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h2 id="report">Reporting bugs</h2>
+ Please read through the <a href="#known_bugs"> known bugs section</a> before reporting bugs. Create an issue
+ and assign the issue to myself (jbu@openoffice.org).Questions should be raised
+ in dev@dba.openoffice.org mailinglist. Please don't fire usage questions directly at myself.
+
+ <h2 id="older_versions">Outdated versions</h2>
+ <table border="5">
+ <tbody>
+ <tr>
+ <th>Version</th>
+ <th>
+ Platform</th>
+ <th>
+ Location</th>
+ <th>
+ md5sum</th>
+ </tr>
+ <tr>
+ <td> 0.7.6 for >= OO2.x and <= OOo3.1 (released 2008-08-23)</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.6.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.6.zip</a>
+ </td>
+ <td>f30bd071ce0e35da6eadedbec4f6eef5</td>
+ </tr>
+ <tr>
+ <td> 0.7.5 for OO2.x (released 2007-08-27)</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.5.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.5.zip</a>
+ </td>
+ <td>6db1a4b3b811957e4c1191ae2ba736ac</td>
+ </tr>
+ <tr>
+ <td> 0.7.4 (released 2007-02-16)</td>
+ <td>
+ Windows, Linux x86 (multi platform package)<br>
+ Note: For Linux x86, use this only with OpenOffice.org 1.1 (see below)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.4.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.4.zip</a>
+ </td>
+ <td>4e15fa7dcb017b66dfb060498ab92f4d</td>
+ </tr>
+ <tr>
+ <td> 0.7.4a(recommended for OOo2.2 and above) (released 2007-05-27)</td>
+ <td>
+ ONLY Linux x86 with OpenOffice.org 2.2 and above (see issue
+ <a href="http://www.openoffice.org/issues/show_bug.cgi?id=77188">i77188</a>)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.4a.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.4a.zip</a>
+ </td>
+ <td>02e30ed857e836230159ab052ce21a70</td>
+ </tr>
+ <tr>
+ <td> 0.7.3 (released 2007-01-08 )</td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.3.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.3.zip</a>
+ </td>
+ <td>8586328f1e57f17e458a42da949ea174</td>
+ </tr>
+ <tr>
+ <td> 0.7.2</td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.2.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.2.zip</a>
+ </td>
+ <td>f3fa2a7b859eb5d1ccc2859a739cf620</td>
+ </tr>
+ <tr>
+ <td> 0.7.1 </td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.1.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.1.zip</a>
+ </td>
+ <td>213a34341a3c9e12476f58c76e29204b</td>
+ </tr>
+ <tr>
+ <td> 0.7.0</td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.7.0.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.7.0.zip</a>
+ </td>
+ <td>3d5d7996474f75cee9de20d741ffa5d8</td>
+ </tr>
+ <tr>
+ <td> 0.6.2</td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.6.2.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.6.2.zip</a>
+ </td>
+ <td>9522c14a1bc45edc3b5b3b50c99c2f9a</td>
+ </tr>
+ <tr>
+ <td> 0.6.1 </td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.6.1.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.6.1.zip</a>
+ </td>
+ <td>058689603b18a4f9a050e47fb35921ec</td>
+ </tr>
+ <tr>
+ <td> 0.6.0 </td>
+ <td>
+ Windows, Linux x86 (multi platform package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.6.0.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.6.0.zip</a>
+ </td>
+ <td>e7866011e976641b206b43c269fa1fcf</td>
+ </tr>
+ <tr>
+ <td> 0.5.0 </td>
+ <td>
+ Windows, Linux x86, Solaris sparc (multi platform uno package)
+ </td>
+ <td>
+ <a href="postgresql-sdbc-0.5.0.zip">http://dba.openoffice.org/drivers/<wbr>postgresql/postgresql-sdbc-0.5.0.zip</a>
+ </td>
+ <td>24edb8fac50676b486dc9534a73f9e3e</td>
+ </tr>
+ <tr>
+ <td>0.5.0</td>
+ <td>Linux PPC</td>
+ <td>
+ <a href="ftp://ftp.sunsite.utk.edu/pub/linux/yellowdog/software/openoffice/postgresql-sdbc-0.5.0.zip">
+ ftp://ftp.sunsite.utk.edu/pub<wbr>/linux/yellowdog/software/openoffice/<wbr>postgresql-sdbc-0.5.0.zip</a>
+ </td>
+ <td>
+ n.a.</td>
+ </tr>
+ </tbody>
+ </table>
+ <h2 id="author">Authors</h2>
+ The driver has been implemented and is maintained by Joerg Budischewski (<a href="mailto:JoergBudi@gmx.de">JoergBudi@gmx.de</a>
+ ) in my spare time.
+ </div>
+ </body>
+</html>
diff --git a/content/dba/drivers/sqlite/index.html b/content/dba/drivers/sqlite/index.html
new file mode 100644
index 0000000..6e4605c
--- /dev/null
+++ b/content/dba/drivers/sqlite/index.html
@@ -0,0 +1,153 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <style type="text/css">@import url("/css/dba.css");</style>
+ <title>Linux SQLite driver - alpha version</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ </head>
+ <body>
+ <b>Project Sections</b>:
+ <a href="../../index.html">Home</a>
+ | <a href="../../specifications/index.html">Specifications</a>
+ | <a href="../../QA/index.html">QA</a>
+ | <a href="../../development/index.html">Development</a>
+ | <a href="../index.html"><b>Database Drivers</b></a><br/>
+ <b>Database drivers</b>:
+ <a href="../postgresql/index.html">PostgreSQL</a>
+ | <a href="../mdb/index.html">Linux MDB</a>
+ | <a href="../sqlite/index.html"><b>SQLite</b></a>
+ <hr/>
+ <div class="dba">
+ <h1 id="sqlite_driver">sqlite-sdbc-driver-0.1.0</h1>
+ <h2>Content</h2>
+ <ul>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#intro">Introduction</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#install">Installation</a>
+ </p>
+ <ul>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#datasource">Adding a datasource</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#url">Url format</a>
+ </p>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#features">Features</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#questions">Open questions</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;"><a href="#source">Building from source</a>
+ </p>
+ </li>
+ <li>
+ <p><a href="#author">Author</a>
+ </p>
+ </li>
+ </ul>
+ <h2><a name="intro"></a>Introduction</h2>
+ <p><a name="install"></a>Use <a href="http://www.sqlite.org">SQLite 2.8.x</a> to
+ read single file SQLite databases under Linux (and later Windows).
+ </p>
+ <h2>Installation</h2>
+ <ol>
+ <li>
+ <p style="margin-bottom: 0cm;">On Linux, install the SQLite binary package
+ suitable for your distro. The minimum SQLite version required is 2.8.13
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">Install OpenOffice.org 1.1 or newer.<br>
+ </p>
+ </li>
+ <li>
+ <p>Download the binary version of the driver.
+ </p>
+ </li>
+ </ol>
+ <p>
+ <ul>
+ <li><a name="datasource"></a><a href="http://www.ch-werner.de/sqliteodbc/sqlite-sdbc-0.1.1.zip">sqlite-sdbc-driver-0.1.1.zip</a></li>
+ <li><a name="datasource"></a><a href="http://www.ch-werner.de/sqliteodbc/sqlite3-sdbc-0.1.1.zip">sqlite3-sdbc-0.1.1.zip</a></li>
+ </ul>
+ (The sqlite3... driver is a quick port to the upcoming SQLite 3 engine (currently beta version 3.0.6 on www.sqlite.org). It does
+ not use newer features of the SQLite3 API but merely is an adaption of the current driver.)
+ </p>
+
+ <p>
+ Copy the zip file in <code>OpenOffice1.1/user/uno_packages</code> folder (Note:
+ USE the zip file as a whole, DO NOT extract it). Open up a shell and switch to
+ the OpenOffice1.1/program directory and start the pkgchk tool. On success, no
+ output is given. Alternatively, you can install the driver for all users of a
+ OpenOffice.org network installation by placing the file into the <code>OpenOffice1.1/share/uno_packages</code>
+ and starting pkgchk --shared You can uninstall the package by deleting the file
+ in the uno_packages directory and starting pkgchk again.
+ </p>
+ <h3>Adding a datasource</h3>
+ <p><a name="url"></a>You can now add a datasource via the common Tools/Data
+ Sources dialog. Click on new datasource and select sqlite from the Database
+ type combobox. Then put the file name of your SQLite database right after the
+ sqlite: into the URL input field.</p>
+ <h3>URL format</h3>
+ <p>Format: <code>sdbc:sqlite:sqlite_database_filename </code>
+ </p>
+ <h3><br>
+ </h3>
+ <h2><a name="features"></a>Supported and missing features</h2>
+ <p>The driver supports reading and writing SQLite 2 databases. It has the
+ following limitations:
+ </p>
+ <ol>
+ <li>
+ <p style="margin-bottom: 0cm;">It uses the encoding of the SQLite engine.
+ Depending on how SQLite was generated, this is ISO 8859-1 or UTF-8.
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0cm;">The data types supported for now are INTEGER and
+ VARCHAR. In result sets, INTEGER is only reported for "INTEGER PRIMARY KEY"
+ fields, i.e. SQLite's auto incrementing columns. All other columns are
+ VARCHARs.</p>
+ </li>
+ <li>
+ <p>It is possible to create new SQLite tables from OpenOffice.org's table
+ designer. However, creating/deleting indexes may fail due to bugs in SQLite's
+ SQL parser or OpenOffice.org's SQL dialect.</p>
+ </li>
+ <li>
+ The driver is always in auto commit mode.</li>
+ <li>
+ <p>The driver may contain memory leaks and bugs which can crash OpenOffice.org<br>
+ </p>
+ </li>
+ </ol>
+ <h2><a name="questions"></a>Open questions</h2>
+ <h2><a name="source"></a>Building from source</h2>
+ <p>Linux: Fetch the <a href="http://www.ch-werner.de/sqliteodbc/sqlite-sdbc.tar.gz">
+ source code</a> and unpack it in .../connectivity/source/drivers. Setup your
+ OOo environment for building, then goto the
+ .../connectivity/source/drivers/sqlite directory and type dmake. The source
+ code expects the SQLite header files and libraries in standard places
+ (/usr/include and /usr/lib)<br>
+ </p>
+ <p>Building on Windows should be possible but was not tested so far.<br>
+ </p>
+ <h2><a name="author"></a>Authors</h2>
+ <p style="margin-bottom: 0cm;">The driver has been implemented based on the MDB
+ driver by Christian Werner(chw@openoffice.org)
+ </p>
+ </div>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/howto/AppendTableAlias.html b/content/dba/howto/AppendTableAlias.html
new file mode 100644
index 0000000..0fea9f8
--- /dev/null
+++ b/content/dba/howto/AppendTableAlias.html
@@ -0,0 +1,251 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Parameter Name Substitution</title>
+</head>
+<body>
+<h1>Table Aliases for data sources</h1>
+<span style="font-size:xx-large;font-weight:bold">Note:</span> <em>The below information
+is outdated, it applies only to OpenOffice.org versions prior to 2.0.</em>
+<h2>The Problem</h2>
+When working with select statements, OpenOffice.org usually uses an
+alias name for tables such as in "<span style="font-family: monospace;">SELECT
+* FROM <table> </span>aliasname" Here "aliasname"" is a
+so-called table alias. However, some
+databases do not allow such aliases. The
+statement then would be "<span style="font-family: monospace;">SELECT *
+FROM <table></span>". Such databases
+usually reject statements with aliases.<br>
+<h2>The Solution</h2>
+OpenOffice.org features the disabling as well as the enabling of this
+behavior.<br>
+<br>
+Table aliases can be enabled on a per-data-source basis.
+For this, the "Info" property of a <a
+ href="http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/DataSource.html">data
+source</a> should contain a name-value-pair with<br>
+<span style="font-family: monospace;">Name</span>: <span
+ style="font-family: monospace;">AppendTableAlias</span><br>
+<span style="font-family: monospace;">Value</span>: <span
+ style="font-family: monospace;">FALSE</span><br>
+<br>
+Unfortunately, there is no user interface, yet, for doing so. You could
+use the Basic macro provided below, until we get OOo 2.0 ui, which adds
+the setting for a data
+source of your choice.<br>
+<br>
+Note that this feature will be first available in version
+OpenOffice.org 2.0.
+<h2>The Macro</h2>
+The following macro disables the use of table alias names for a data
+source of your choice. You can also download this macro in the <a
+ href="../downloads/">downloads section</a>.<br>
+<br>
+<span style="font-family: monospace; color: rgb(102, 102, 102);">REM
+***** BASIC *****</span><br style="font-family: monospace;">
+<br style="font-family: monospace;">
+<span style="font-family: monospace;"><span
+ style="color: rgb(0, 0, 128);">Option Explicit</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">Main</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span><br>
+ <span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+= <span style="color: rgb(0, 128, 0);">InputBox</span>( <span
+ style="color: rgb(255, 0, 0);">"Please enter the name of the data
+source:"</span> )<br>
+ <span style="color: rgb(0, 128, 0);">AppendTableAlias</span>(<span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">AppendTableAlias</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span> )<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source context (ehm - the service name is historical :)</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aContext</span>
+= <span style="color: rgb(0, 128, 0);">createUnoService</span>( <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.sdb.DatabaseContext"</span>
+)<br>
+<br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 0, 128);">Not</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">hasByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> ) ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">MsgBox</span> <span
+ style="color: rgb(255, 0, 0);">"There is no data source named "</span>
++ <span style="color: rgb(0, 128, 0);">sDataSourceName</span> + <span
+ style="color: rgb(255, 0, 0);">"!"</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">Exit Sub</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aDataSource</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>
+= <span style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">getByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new AppendTableAlias flag</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bFlag</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bFlag</span> =
+<span style="color: rgb(0, 128, 0);">FALSE</span><br
+ style="color: rgb(0, 128, 0);">
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aInfo</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> =
+<span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> =
+<span style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aInfo</span>, <span
+ style="color: rgb(255, 0, 0);">"AppendTableAlias"</span>, <span
+ style="color: rgb(0, 128, 0);">bFlag</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' and
+write back</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span> = <span
+ style="color: rgb(0, 128, 0);">aInfo</span><br>
+ <span style="color: rgb(102, 102, 102);">' flush
+(not really necessary, but to be on the safe side :)</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">flush</span><br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Function</span> <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span>,<span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span>, <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span> ) <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nLower</span>
+= <span style="color: rgb(0, 128, 0);">LBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+ <span style="color: rgb(0, 128, 0);">nUpper</span>
+= <span style="color: rgb(0, 128, 0);">UBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' look if
+the setting is already present</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bNeedAdd</span>
+= <span style="color: rgb(0, 128, 0);">TRUE</span><br>
+<br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">i</span> <span
+ style="color: rgb(0, 0, 128);">As Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> = <span
+ style="color: rgb(0, 128, 0);">FALSE</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">End If</span><br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' allocate
+the new array</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nNewSize</span>
+= ( <span style="color: rgb(0, 128, 0);">nUpper</span> - <span
+ style="color: rgb(0, 128, 0);">nLower</span> )<br>
+ <span style="color: rgb(0, 0, 128);">If</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">Then</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> = <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> + <span
+ style="color: rgb(255, 0, 0);">1</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> ) <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' copy the
+elements (a simply copy does not work in Basic)</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ) = <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> )<br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new setting, if necessary</span><br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(0, 128, 0);">AddInfo</span>
+= <span style="color: rgb(0, 128, 0);">aNewInfo</span>()<br>
+<span style="color: rgb(0, 0, 128);">End Function</span></span>
+<h2></h2>
+</body>
+</html>
diff --git a/content/dba/howto/IgnoreDriverPrivileges.html b/content/dba/howto/IgnoreDriverPrivileges.html
new file mode 100644
index 0000000..609eb3d
--- /dev/null
+++ b/content/dba/howto/IgnoreDriverPrivileges.html
@@ -0,0 +1,251 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Parameter Name Substitution</title>
+</head>
+<body>
+<h1>Read/Write access rights (privileges) for JDBC/ODBC data sources</h1>
+<span style="font-size:xx-large;font-weight:bold">Note:</span> <em>The below information
+is outdated, it applies only to OpenOffice.org versions prior to 2.0.</em>
+<h2>The Problem</h2>
+When working with drivers which not fully support the access to the
+privileges of the database or returning just incorect
+information, OpenOffice.org only allows the operations which the driver
+returns. E.g. when the driver doesn't return the right to insert values
+into a table even when the database allows it, OpenOffice.org also
+shows the table in read only mode.
+<h2>The Solution</h2>
+The OpenOffice.org JDBC/ODBC-SDBC bridge (more sloppy: OOo's JDBC/ODBC
+driver) supports to work around the problem in just to return that all
+rigths are granted, the sytem driver won't be asked in that case.<br>
+<br>
+Read/Write access rights can be enabled on a per-data-source basis. For
+this, the "Info" property of a <a
+ href="http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/DataSource.html">data
+source</a> should contain a name-value-pair with<br>
+<span style="font-family: monospace;">Name</span>: <span
+ style="font-family: monospace; color: rgb(51, 0, 51);">IgnoreDriverPrivileges</span><br>
+<span style="font-family: monospace;">Value</span>: <span
+ style="font-family: monospace;">TRUE</span><br>
+<br>
+Unfortunately, there is no user interface, yet, for doing so. You could
+use the Basic macro provided below, which adds the setting for a data
+source of your choice.<br>
+<h2>The Macro</h2>
+The following macro enables Read/Write access rights for a data source
+of your choice. You can also download this macro in the <a
+ href="../downloads/">downloads section</a>.<br>
+<br>
+<span style="font-family: monospace; color: rgb(102, 102, 102);">REM
+***** BASIC *****</span><br style="font-family: monospace;">
+<br style="font-family: monospace;">
+<span style="font-family: monospace;"><span
+ style="color: rgb(0, 0, 128);">Option Explicit</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">Main</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span><br>
+ <span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+= <span style="color: rgb(0, 128, 0);">InputBox</span>( <span
+ style="color: rgb(255, 0, 0);">"Please enter the name of the data
+source:"</span> )<br>
+ <span style="font-family: monospace;"></span><span
+ style="font-family: monospace; color: rgb(0, 128, 0);">IgnoreDriverPrivileges</span></span><span
+ style="font-family: monospace;">(<span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+)<br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> </span><span
+ style="font-family: monospace; color: rgb(0, 128, 0);">IgnoreDriverPrivileges</span><span
+ style="font-family: monospace;"><span style="color: rgb(0, 128, 0);"></span>(<span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span> )<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source context (ehm - the service name is historical :)</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aContext</span>
+= <span style="color: rgb(0, 128, 0);">createUnoService</span>( <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.sdb.DatabaseContext"</span>
+)<br>
+<br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 0, 128);">Not</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">hasByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> ) ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">MsgBox</span> <span
+ style="color: rgb(255, 0, 0);">"There is no data source named "</span>
++ <span style="color: rgb(0, 128, 0);">sDataSourceName</span> + <span
+ style="color: rgb(255, 0, 0);">"!"</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">Exit Sub</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aDataSource</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>
+= <span style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">getByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new </span></span><span
+ style="font-family: monospace; color: rgb(102, 102, 102);">IgnoreDriverPrivileges</span><span
+ style="font-family: monospace;"><span
+ style="color: rgb(102, 102, 102);">flag</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bFlag</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bFlag</span> = <span
+ style="color: rgb(0, 128, 0);">TRUE</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aInfo</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> = <span
+ style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> = <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aInfo</span>, <span
+ style="color: rgb(255, 0, 0);">"IgnoreDriverPrivileges"</span>, <span
+ style="color: rgb(0, 128, 0);">bFlag</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' and
+write back</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span> = <span
+ style="color: rgb(0, 128, 0);">aInfo</span><br>
+ <span style="color: rgb(102, 102, 102);">' flush
+(not really necessary, but to be on the safe side :)</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">flush</span><br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Function</span> <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span>,<span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span>, <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span> ) <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nLower</span> = <span
+ style="color: rgb(0, 128, 0);">LBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+ <span style="color: rgb(0, 128, 0);">nUpper</span> = <span
+ style="color: rgb(0, 128, 0);">UBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' look if
+the setting is already present</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bNeedAdd</span>
+= <span style="color: rgb(0, 128, 0);">TRUE</span><br>
+<br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">i</span> <span
+ style="color: rgb(0, 0, 128);">As Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> = <span
+ style="color: rgb(0, 128, 0);">FALSE</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">End If</span><br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' allocate
+the new array</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nNewSize</span>
+= ( <span style="color: rgb(0, 128, 0);">nUpper</span> - <span
+ style="color: rgb(0, 128, 0);">nLower</span> )<br>
+ <span style="color: rgb(0, 0, 128);">If</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">Then</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> = <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> + <span
+ style="color: rgb(255, 0, 0);">1</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> ) <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' copy the
+elements (a simply copy does not work in Basic)</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ) = <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> )<br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new setting, if necessary</span><br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(0, 128, 0);">AddInfo</span>
+= <span style="color: rgb(0, 128, 0);">aNewInfo</span>()<br>
+<span style="color: rgb(0, 0, 128);">End Function</span></span>
+<h2></h2>
+</body>
+</html>
diff --git a/content/dba/howto/OuterJoinSequence.html b/content/dba/howto/OuterJoinSequence.html
new file mode 100644
index 0000000..6e5dcff
--- /dev/null
+++ b/content/dba/howto/OuterJoinSequence.html
@@ -0,0 +1,252 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Parameter Name Substitution</title>
+</head>
+<body>
+<h1>Disable/Enable outer join sequnce<br>
+</h1>
+<span style="font-size:xx-large;font-weight:bold">Note:</span> <em>The below information
+is outdated, it applies only to OpenOffice.org versions prior to 2.0.</em>
+<h2>The Problem</h2>
+When working with drivers which not fully support the JDBC or ODBC
+standard, it may happen that the escape sequences are not fully
+supported. Statement like this don't work. <br>
+"SELECT * from {OJ xx left join yy ... }"<br>
+<h2>The Solution</h2>
+The OpenOffice.org data source supports to work around the problem in
+just to remove the {OJ} keywords from the SQL statement.<br>
+<br>
+Disable/Enable outer join sequence can be enabled on a per-data-source
+basis. For
+this, the "Info" property of a <a
+ href="http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/DataSource.html">data
+source</a> should contain a name-value-pair with<br>
+<span style="font-family: monospace;">Name</span>: <span
+ style="font-family: monospace;">EnableOuterJoinEscape</span><span
+ style="font-family: monospace; color: rgb(51, 0, 51);"></span><br>
+<span style="font-family: monospace;">Value</span>: <span
+ style="font-family: monospace;">FALSE</span><br>
+<br>
+Unfortunately, there is no user interface, yet, for doing so. You could
+use the Basic macro provided below, which adds the setting for a data
+source of your choice.<br>
+<h2>The Macro</h2>
+The following macro enables Disable/Enable outer join sequence for a
+data source
+of your choice. You can also download this macro in the <a
+ href="../downloads/">downloads section</a>.<br>
+<br>
+<span style="font-family: monospace; color: rgb(102, 102, 102);">REM
+***** BASIC *****</span><br style="font-family: monospace;">
+<br style="font-family: monospace;">
+<span style="font-family: monospace;"><span
+ style="color: rgb(0, 0, 128);">Option Explicit</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">Main</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span><br>
+ <span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+= <span style="color: rgb(0, 128, 0);">InputBox</span>( <span
+ style="color: rgb(255, 0, 0);">"Please enter the name of the data
+source:"</span> )<br>
+ <span style="font-family: monospace;"></span><span
+ style="font-family: monospace; color: rgb(0, 128, 0);">IgnoreDriverPrivileges</span></span><span
+ style="font-family: monospace;">(<span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+)<br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> </span><span
+ style="font-family: monospace; color: rgb(0, 128, 0);">IgnoreDriverPrivileges</span><span
+ style="font-family: monospace;"><span style="color: rgb(0, 128, 0);"></span>(<span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span> )<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source context (ehm - the service name is historical :)</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aContext</span>
+= <span style="color: rgb(0, 128, 0);">createUnoService</span>( <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.sdb.DatabaseContext"</span>
+)<br>
+<br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 0, 128);">Not</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">hasByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> ) ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">MsgBox</span> <span
+ style="color: rgb(255, 0, 0);">"There is no data source named "</span>
++ <span style="color: rgb(0, 128, 0);">sDataSourceName</span> + <span
+ style="color: rgb(255, 0, 0);">"!"</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">Exit Sub</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aDataSource</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>
+= <span style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">getByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new </span></span><span
+ style="font-family: monospace; color: rgb(102, 102, 102);">IgnoreDriverPrivileges</span><span
+ style="font-family: monospace;"><span
+ style="color: rgb(102, 102, 102);">flag</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bFlag</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bFlag</span> =
+FALSE<span style="color: rgb(0, 128, 0);"></span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aInfo</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> =
+<span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> =
+<span style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aInfo</span>, <span
+ style="color: rgb(255, 0, 0);">"EnableOuterJoinEscape"</span>, <span
+ style="color: rgb(0, 128, 0);">bFlag</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' and
+write back</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span> = <span
+ style="color: rgb(0, 128, 0);">aInfo</span><br>
+ <span style="color: rgb(102, 102, 102);">' flush
+(not really necessary, but to be on the safe side :)</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">flush</span><br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Function</span> <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span>,<span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span>, <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span> ) <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nLower</span>
+= <span style="color: rgb(0, 128, 0);">LBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+ <span style="color: rgb(0, 128, 0);">nUpper</span>
+= <span style="color: rgb(0, 128, 0);">UBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' look if
+the setting is already present</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bNeedAdd</span>
+= <span style="color: rgb(0, 128, 0);">TRUE</span><br>
+<br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">i</span> <span
+ style="color: rgb(0, 0, 128);">As Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> = <span
+ style="color: rgb(0, 128, 0);">FALSE</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">End If</span><br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' allocate
+the new array</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nNewSize</span>
+= ( <span style="color: rgb(0, 128, 0);">nUpper</span> - <span
+ style="color: rgb(0, 128, 0);">nLower</span> )<br>
+ <span style="color: rgb(0, 0, 128);">If</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">Then</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> = <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> + <span
+ style="color: rgb(255, 0, 0);">1</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> ) <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' copy the
+elements (a simply copy does not work in Basic)</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ) = <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> )<br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new setting, if necessary</span><br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(0, 128, 0);">AddInfo</span>
+= <span style="color: rgb(0, 128, 0);">aNewInfo</span>()<br>
+<span style="color: rgb(0, 0, 128);">End Function</span></span>
+<h2></h2>
+</body>
+</html>
diff --git a/content/dba/howto/UserDefinedDriverUI.html b/content/dba/howto/UserDefinedDriverUI.html
new file mode 100644
index 0000000..2dfa793
--- /dev/null
+++ b/content/dba/howto/UserDefinedDriverUI.html
@@ -0,0 +1,176 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Register new driver types for OpenOffice UI</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Win32)">
+ <META NAME="CREATED" CONTENT="20030129;8365681">
+ <META NAME="CHANGED" CONTENT="20030129;9555296">
+ <META NAME="KEYWORDS" CONTENT="Driver">
+ <STYLE>
+ <!--
+ A:visited { color: #444488 }
+ A:link { color: #444488 }
+ -->
+ </STYLE>
+</head>
+<body LANG="de-DE" LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff">
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
+ <COL WIDTH=75>
+ <TR>
+ <TD BGCOLOR="#666699">
+ <H1 ALIGN=CENTER><A HREF="http://www.openoffice.org/"><IMG SRC="../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><FONT COLOR="#ffffff"><FONT FACE="Arial"><FONT SIZE=5>How to register a new database driver <BR>into
+ OpenOffice UI?</FONT></FONT></FONT></H1>
+ </TD>
+ </TR>
+</TABLE>
+<HR SIZE=3 NOSHADE>
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=256*>
+ <TR>
+ <TD WIDTH=100% BGCOLOR="#666699">
+ <H3 ALIGN=LEFT><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <DL>
+ <DT><A HREF="#background">The Problem</A><BR><A HREF="#chap1">The
+ Solution</A><A HREF="#installation"><BR></A><A HREF="#chap2">The
+ Macro</A></DT></DL>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100% BGCOLOR="#666699">
+ <H2 ALIGN=LEFT><FONT COLOR="#ffffff"><FONT FACE="Arial"><FONT SIZE=4><I>The
+ Problem</I></FONT></FONT></FONT></H2>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <P>You may want to use a new database driver for your database in OpenOffice but OpenOffice doesn't know it.</P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100% BGCOLOR="#666699">
+ <H2><FONT COLOR="#ffffff"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><I>The
+ Solution</I></FONT></FONT></FONT></H2>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <P>The OpenOffice.org UI supports the extension of database drivers through a configuration entry.</P>
+ Two steps have to be done before you can use your new driver with OpenOffice.
+ <BR>The first step is to copy the new driver in the folder $office/user/uno_packages.
+ After that you have to run the command $office/program/pkgchk. This command register the new driver.
+ In the future it will be possible to run only the pkgchk program to register the driver and to insert the configuration entry.
+ <BR>The second step is to adjust the macro and run it to insert a configuration entry.
+ <P>Three names have to be set in the macro:</P>
+ <TABLE WIDTH=100% BORDER=1 CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=53*>
+ <COL WIDTH=203*>
+ <TR VALIGN=TOP>
+ <TD WIDTH=21%>
+ <B>DriverPageDisplayName</B>
+ </TD>
+ <TD WIDTH=79%>
+ <P>This name will be used for the Tabpage of the new database driver.</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=21%>
+ <B>DriverTypeDisplayName</B>
+ </TD>
+ <TD WIDTH=79%>
+ <P>This name will be used in the database type listbox on the general tabpage in the data source administration dialog.</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=21%>
+ <B>DriverDsnPrefix</B>
+ </TD>
+ <TD WIDTH=79%>
+ <P>This name will be the prefix for the URL of the new database driver. <B>This name has to end with a colon.<B></P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=21%>
+ <B>Extension</B>
+ </TD>
+ <TD WIDTH=79%>
+ <P>The file extension, which match to this type. Only set when it is file based driver.</P>
+ </TD>
+ </TR>
+ </TABLE>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100% BGCOLOR="#666699">
+ <H3><FONT COLOR="#ffffff"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><I>The
+ Macro</I></FONT></FONT></FONT></H3>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <PRE>REM ***** BASIC *****
+
+Sub Main
+ ' access the global configuration provider
+ Dim aConfigProvider As Object
+ aConfigProvider = createUnoService( "com.sun.star.configuration.ConfigurationProvider" )
+
+ ' create an access object for the driver settings key
+ Dim aDriverSettings As Object
+ Dim aParams(0) As new com.sun.star.beans.PropertyValue
+ aParams(0).Name = "nodepath"
+ aParams(0).Value = "/org.openoffice.Office.DataAccess/UserDefinedDriverSettings"
+ aDriverSettings = aConfigProvider.createInstanceWithArguments( _
+ "com.sun.star.configuration.ConfigurationUpdateAccess", _
+ aParams() )
+
+ aDrv = aDriverSettings.createInstance()
+
+ aDrv.DriverPageDisplayName ="Ocke's own private Driver page"
+ aDrv.DriverTypeDisplayName = "Neo_1" ' this name will be displayed in the Type listbox on the general tabpage
+ aDrv.DriverDsnPrefix ="sdbc:matrix:" ' this name will be the prefix of the URL
+ aDrv.Extension = "*.OJ" ' will be used by the fileopen dialog
+
+ ' create an access object for the mozilla preferences node
+
+ aDriverSettings.insertByName( "Neo_1",aDrv ) ' just a name to make it distinct
+
+
+ ' commit the changes done
+ aDriverSettings.commitChanges
+End Sub
+</PRE>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <P><BR>
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <HR SIZE=1 NOSHADE>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100% BGCOLOR="#666699">
+ <P ALIGN=LEFT><FONT COLOR="#ffffff">Auhor: <A HREF="mailto:oj@openoffice.org"><FONT COLOR="#ffffff">Ocke
+ Janssen </FONT></A><A HREF="mailto:ibo@system-entwicklung.de"><BR></A>Last
+ Modified: $Date: 2004/10/15 08:12:12 $<BR><I>Copyright © 2001
+ OpenOffice.org</I></FONT></P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=100%>
+ <HR SIZE=1 NOSHADE>
+ </TD>
+ </TR>
+</TABLE>
+<HR SIZE=3 NOSHADE>
+</body>
+</HTML>
diff --git a/content/dba/howto/index.html b/content/dba/howto/index.html
new file mode 100644
index 0000000..0419bc8
--- /dev/null
+++ b/content/dba/howto/index.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css">
+ <style type="text/css">@import "/css/dba.css";</style>
+ <title>OpenOffice.org Base - HowTo's</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+</head>
+<body>
+ <b>Project Sections</b>:
+ <a href="../index.html">Home</a>
+ | <a href="../specifications/index.html">Specifications</a>
+ | <a href="../QA/index.html">QA</a>
+ | <a href="../development/index.html">Development</a>
+ | <a href="../drivers/index.html">Database Drivers</a><br/>
+<hr/>
+<div class="dba">
+<h1 id="dba_howto">HowTo's</h1>
+<table cellpadding="0" cellspacing="0" id="Table1">
+ <tbody>
+ <tr class="OddTableRow">
+ <td width="25%"><a href="mozillaprofile.html">change the preferred Mozilla profile</a></td>
+ <td>OpenOffic.org features a database driver which allows access to a variety of address data sources,
+ amongst them the address data of an existent mozilla installation. This describes how to force OOo to
+ access a specific mozilla user profile.
+ </td>
+ </tr>
+ <tr class="EvenTableRow">
+ <td width="25%" style="vertical-align: top;"><a href="UserDefinedDriverUI.html">register new driver types to
+ appear in the data source administration dialog</a>
+ </td>
+ <td>This is an introduction in how to register a new database driver into OpenOffice UI.</td>
+ </tr>
+ </tbody>
+</table>
+<br>
+<br>
+You may also want to visit the <a href="../FAQ/index.html">Tips 'n
+Tricks section</a>, which contains links to additional external
+resources, as well as yet more additional information which may help
+you to ease your OpenOffice.org Base. </div>
+</body>
+</html>
\ No newline at end of file
diff --git a/content/dba/howto/mozillaprofile.html b/content/dba/howto/mozillaprofile.html
new file mode 100644
index 0000000..f13ed26
--- /dev/null
+++ b/content/dba/howto/mozillaprofile.html
@@ -0,0 +1,102 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>How do I change the preferred mozilla address book user profile?</title>
+</head>
+<body>
+<h1><a name="mozTocId184500" class="mozTocH1"></a>How do I change the
+preferred mozilla address book user profile?</h1>
+<h2>Table of Content</h2>
+<ul>
+ <li><a href="#background">Background</a></li>
+ <li><a href="#config">Configuration</a></li>
+ <li><a href="#restrictions">Restrictions</a></li>
+ <li><a href="#sample">Sample Basic Macro</a><br>
+ </li>
+</ul>
+<h2><a name="background"></a>Background</h2>
+OpenOffic.org features a database driver which allows access to a
+variety of address data sources (mozilla address data, Outlook/Outlook
+Express address data, LDAP data).<br>
+When accessing the mozilla database, by default the first user profile
+found is choosen. On systems where more than one profile exists, this
+may not be what the user wants.<br>
+<h2><a name="config"></a>Configuration</h2>
+There is a configuration entry which tells the SDBC driver accessing
+the address data which profile to use when logging on to mozilla (I use
+the term "log on" here, because for every access to any of the
+above-mentioned data types a connection to mozilla, which provides all
+the data, is necessary).<br>
+<br>
+Setting this entry to a mozilla profile name string forces the driver
+to prefer this profile – if it is existent.<br>
+<br>
+This entry is located in the configuration module
+/org.openoffice.Office.DataAccess. There is a key
+/DriverSettings/com.sun.star.comp.sdbc.MozabDriver, which stores
+settings for the SDBC address book driver (the second part of the kay is
+the it's implementation name).<br>
+<br>
+Thereunder, there is a key MozillaPreferences/ProfileName, which is of
+type string. If this string is a valid mozilla profiles name, this
+profile is used when logging on to mozilla.<br>
+<h2><a name="restrictions"></a>Restrictions</h2>
+As mozilla does not allow to change the profile name of a session while
+the session is running, after changing the configuration entry
+OpenOffice.org must be restarted if it already opened a mozilla session
+– i.e. if you already connected to any of the above-mentioned address
+data source types. If you did not do this before, your change in the
+configuration will take effect immediately.<br>
+<h2><a name="sample"></a>Sample Basic Macro</h2>
+The following Basic function will change the configuration entry in
+question to the string passed to it (You can download this macro
+in the <a href="../downloads/index.html">Tools section</a>):
+<pre style="font-family: monospace;"><span
+ style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">ChangeMozillaAddressBookProfile</span>( <span
+ style="color: rgb(0, 128, 0);">sProfileName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span> )<br> <span
+ style="color: rgb(102, 102, 102);">' access the global configuration provider</span><br> <span
+ style="color: rgb(0, 0, 153);"><span style="color: rgb(0, 0, 128);">Dim</span> </span><span
+ style="color: rgb(0, 128, 0);">aConfigProvider</span> <span
+ style="color: rgb(0, 0, 128);">As Object</span><br><br> <span
+ style="color: rgb(0, 128, 0);">aConfigProvider</span> = <span
+ style="color: rgb(0, 128, 0);">createUnoService</span>( _<br> <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.configuration.ConfigurationProvider"</span> )<br><br> <span
+ style="color: rgb(102, 102, 102);">' create an access object for the driver settings key</span><br> <span
+ style="color: rgb(0, 0, 153);"><span style="color: rgb(0, 0, 128);">Dim</span> </span><span
+ style="color: rgb(0, 128, 0);">aParams</span>(0) <span
+ style="color: rgb(0, 0, 128);">As new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span><br> <span
+ style="color: rgb(0, 128, 0);">aParams</span>(0).<span
+ style="color: rgb(0, 0, 128);">Name </span>= <span
+ style="color: rgb(255, 0, 0);">"nodepath"</span><br> <span
+ style="color: rgb(0, 128, 0);">aParams</span>(0).<span
+ style="color: rgb(0, 128, 0);">Value</span> = _<br> <span
+ style="color: rgb(255, 0, 0);">"/org.openoffice.Office.DataAccess/DriverSettings/com.sun.star.comp.sdbc.MozabDriver"</span><br><br> <span
+ style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aDriverSettings</span> <span
+ style="color: rgb(0, 0, 128);">As Object</span><br> <span
+ style="color: rgb(0, 128, 0);">aDriverSettings</span> = <span
+ style="color: rgb(0, 128, 0);">aConfigProvider.createInstanceWithArguments</span>( _<br> <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.configuration.ConfigurationUpdateAccess"</span>, _<br> <span
+ style="color: rgb(0, 128, 0);">aParams</span>() )<br><br> <span
+ style="color: rgb(102, 102, 102);">' create an access object for the mozilla preferences node</span><br> <span
+ style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aMozPrefs</span> <span
+ style="color: rgb(0, 0, 128);">As Object</span><br> <span
+ style="color: rgb(0, 128, 0);">aMozPrefs</span> = <span
+ style="color: rgb(0, 128, 0);">aDriverSettings.getByName</span>( <span
+ style="color: rgb(255, 0, 0);">"MozillaPreferences"</span> )<br><br> <span
+ style="color: rgb(102, 102, 102);">' set the preferred profile name</span><br> <span
+ style="color: rgb(0, 128, 0);">aMozPrefs.replaceByName</span>( <span
+ style="color: rgb(255, 0, 0);">"ProfileName"</span>, <span
+ style="color: rgb(0, 128, 0);">sProfileName</span> )<br><br> <span
+ style="color: rgb(102, 102, 102);">' commit the changes done</span><br> <span
+ style="color: rgb(0, 128, 0);">aDriverSettings.commitChanges()<br><span
+ style="color: rgb(0, 0, 128);">End Sub</span><br></span></pre>
+<br>
+</body>
+</html>
diff --git a/content/dba/howto/param_subst.html b/content/dba/howto/param_subst.html
new file mode 100644
index 0000000..79d58e1
--- /dev/null
+++ b/content/dba/howto/param_subst.html
@@ -0,0 +1,255 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Parameter Name Substitution</title>
+</head>
+<body>
+<h1>Parameter Name Substitution for ODBC data sources</h1>
+<span style="font-size:xx-large;font-weight:bold">Note:</span> <em>The below information
+is outdated, it applies only to OpenOffice.org versions prior to 2.0.</em>
+<h2>The Problem</h2>
+When working with parametrized statements, OpenOffice.org usually uses
+named parameters such as in "<span style="font-family: monospace;">SELECT
+* FROM <table> WHERE <field> = :param</span>" Here "<span
+ style="font-family: monospace;">:param</span>" is a so-called <span
+ style="font-style: italic;">named parameter</span>. However, some
+databases do not allow such named parameters, but only unnamed ones. The
+statement then would be "<span style="font-family: monospace;">SELECT *
+FROM <table> WHERE <field> = ?</span>". Such databases
+usually reject statements with named parameters.<br>
+<h2>The Solution</h2>
+The OpenOffice.org ODBC-SDBC bridge (more sloppy: OOo's ODBC driver)
+features substituting named parameters with unnamed ones before sending
+statements to the system driver.<br>
+<br>
+Parameter name substitution can be enabled on a per-data-source basis.
+For this, the "Info" property of a <a
+ href="http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/DataSource.html">data
+source</a> should contain a name-value-pair with<br>
+<span style="font-family: monospace;">Name</span>: <span
+ style="font-family: monospace;">ParameterNameSubstituion</span><br>
+<span style="font-family: monospace;">Value</span>: <span
+ style="font-family: monospace;">TRUE</span><br>
+<br>
+Unfortunately, there is no user interface, yet, for doing so. There is
+an <a href="http://www.openoffice.org/issues/show_bug.cgi?id=2794">issuezilla
+bug requesting this UI</a>, but as long as it's not fixed, you could
+use the Basic macro provided below, which adds the setting for a data
+source of your choice.<br>
+<br>
+Note that in OpenOffice.org 1.0.x, this feature is available for ODBC
+drivers only. In later versions (notably in the upcoming 1.1, but also
+in the intermediate developer snapshots), it has been implemented for
+JDBC drivers, too.
+<h2>The Macro</h2>
+The following macro enables parameter name substitution for a data
+source of your choice. You can also download this macro in the <a
+ href="../downloads/">downloads section</a>.<br>
+<br>
+<span style="font-family: monospace; color: rgb(102, 102, 102);">REM
+***** BASIC *****</span><br style="font-family: monospace;">
+<br style="font-family: monospace;">
+<span style="font-family: monospace;"><span
+ style="color: rgb(0, 0, 128);">Option Explicit</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">Main</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span><br>
+ <span style="color: rgb(0, 128, 0);">sDataSourceName</span>
+= <span style="color: rgb(0, 128, 0);">InputBox</span>( <span
+ style="color: rgb(255, 0, 0);">"Please enter the name of the data
+source:"</span> )<br>
+ <span style="color: rgb(0, 128, 0);">EnableParameterNameSubstitution</span>(<span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Sub</span> <span
+ style="color: rgb(0, 128, 0);">EnableParameterNameSubstitution</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span> )<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source context (ehm - the service name is historical :)</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aContext</span>
+= <span style="color: rgb(0, 128, 0);">createUnoService</span>( <span
+ style="color: rgb(255, 0, 0);">"com.sun.star.sdb.DatabaseContext"</span>
+)<br>
+<br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 0, 128);">Not</span> <span
+ style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">hasByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> ) ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">MsgBox</span> <span
+ style="color: rgb(255, 0, 0);">"There is no data source named "</span>
++ <span style="color: rgb(0, 128, 0);">sDataSourceName</span> + <span
+ style="color: rgb(255, 0, 0);">"!"</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">Exit Sub</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' the data
+source</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aDataSource</span> <span
+ style="color: rgb(0, 0, 128);">as Object</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>
+= <span style="color: rgb(0, 128, 0);">aContext</span>.<span
+ style="color: rgb(0, 128, 0);">getByName</span>( <span
+ style="color: rgb(0, 128, 0);">sDataSourceName</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new ParameterNameSubstitution flag</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bFlag</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bFlag</span> = <span
+ style="color: rgb(0, 128, 0);">TRUE</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aInfo</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> = <span
+ style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span><br>
+ <span style="color: rgb(0, 128, 0);">aInfo</span> = <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aInfo</span>, <span
+ style="color: rgb(255, 0, 0);">"ParameterNameSubstitution"</span>, <span
+ style="color: rgb(0, 128, 0);">bFlag</span> )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' and
+write back</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">Info</span> = <span
+ style="color: rgb(0, 128, 0);">aInfo</span><br>
+ <span style="color: rgb(102, 102, 102);">' flush
+(not really necessary, but to be on the safe side :)</span><br>
+ <span style="color: rgb(0, 128, 0);">aDataSource</span>.<span
+ style="color: rgb(0, 128, 0);">flush</span><br>
+<span style="color: rgb(0, 0, 128);">End Sub</span><br>
+<br>
+<span style="color: rgb(0, 0, 128);">Function</span> <span
+ style="color: rgb(0, 128, 0);">AddInfo</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span>,<span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> <span
+ style="color: rgb(0, 0, 128);">as String</span>, <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span> <span
+ style="color: rgb(0, 0, 128);">as Variant</span> ) <span
+ style="color: rgb(0, 0, 128);">as Variant</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nLower</span> = <span
+ style="color: rgb(0, 128, 0);">LBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+ <span style="color: rgb(0, 128, 0);">nUpper</span> = <span
+ style="color: rgb(0, 128, 0);">UBound</span>( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>() )<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' look if
+the setting is already present</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">as Boolean</span><br>
+ <span style="color: rgb(0, 128, 0);">bNeedAdd</span>
+= <span style="color: rgb(0, 128, 0);">TRUE</span><br>
+<br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">i</span> <span
+ style="color: rgb(0, 0, 128);">As Integer</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> = <span
+ style="color: rgb(0, 128, 0);">FALSE</span><br>
+ <span
+ style="color: rgb(0, 0, 128);">End If</span><br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' allocate
+the new array</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> <span
+ style="color: rgb(0, 0, 128);">as Integer</span><br>
+ <span style="color: rgb(0, 128, 0);">nNewSize</span>
+= ( <span style="color: rgb(0, 128, 0);">nUpper</span> - <span
+ style="color: rgb(0, 128, 0);">nLower</span> )<br>
+ <span style="color: rgb(0, 0, 128);">If</span> <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> <span
+ style="color: rgb(0, 0, 128);">Then</span> <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> = <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> + <span
+ style="color: rgb(255, 0, 0);">1</span><br>
+ <span style="color: rgb(0, 0, 128);">Dim</span> <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nNewSize</span> ) <span
+ style="color: rgb(0, 0, 128);">as new</span> <span
+ style="color: rgb(0, 128, 0);">com.sun.star.beans.PropertyValue</span><br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' copy the
+elements (a simply copy does not work in Basic)</span><br>
+ <span style="color: rgb(0, 0, 128);">For</span> <span
+ style="color: rgb(0, 128, 0);">i</span> = <span
+ style="color: rgb(0, 128, 0);">nLower</span> <span
+ style="color: rgb(0, 0, 128);">To</span> <span
+ style="color: rgb(0, 128, 0);">nUpper</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> ) = <span
+ style="color: rgb(0, 128, 0);">aOldInfo</span>( <span
+ style="color: rgb(0, 128, 0);">i</span> )<br>
+ <span style="color: rgb(0, 0, 128);">Next</span> i<br>
+<br>
+ <span style="color: rgb(102, 102, 102);">' append
+the new setting, if necessary</span><br>
+ <span style="color: rgb(0, 0, 128);">If</span> ( <span
+ style="color: rgb(0, 128, 0);">bNeedAdd</span> ) <span
+ style="color: rgb(0, 0, 128);">Then</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 0, 128);">Name</span> = <span
+ style="color: rgb(0, 128, 0);">sSettingsName</span><br>
+ <span
+ style="color: rgb(0, 128, 0);">aNewInfo</span>( <span
+ style="color: rgb(0, 128, 0);">nUpper</span> + <span
+ style="color: rgb(255, 0, 0);">1</span> ).<span
+ style="color: rgb(0, 128, 0);">Value</span> = <span
+ style="color: rgb(0, 128, 0);">aSettingsValue</span><br>
+ <span style="color: rgb(0, 0, 128);">End If</span><br>
+<br>
+ <span style="color: rgb(0, 128, 0);">AddInfo</span>
+= <span style="color: rgb(0, 128, 0);">aNewInfo</span>()<br>
+<span style="color: rgb(0, 0, 128);">End Function</span></span>
+<h2></h2>
+</body>
+</html>
diff --git a/content/dba/index.html b/content/dba/index.html
new file mode 100644
index 0000000..f02f15b
--- /dev/null
+++ b/content/dba/index.html
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <style type="text/css">@import url("css/dba.css");</style>
+ <title>OpenOffice.org Base - Project Home</title>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body>
+ <div class="menu">
+ <b>Project Sections</b>:
+ <a href="./index.html"><b>Home</b></a>
+ | <a href="./specifications/index.html">Specifications</a>
+ | <a href="http://qa.openoffice.org/ooQAReloaded/DatabaseTeamsite/ooQA-TeamDatabase.html">QA</a>
+ | <a href="./development/index.html">Development</a>
+ | <a href="./drivers/index.html">Database Drivers</a><br/>
+ </div>
+
+ <hr/>
+
+ <div class="dba">
+ <h1>OpenOffice.org Base</h1>
+
+ <div class="axial">
+ <p>Please consult with the <a href="mailto:dev@openoffice.apache.org">development mailing list</a>.</p>
+ </div>
+
+ <h2>Project Overview</h2>
+
+ <p>Starting as mere database access functionality of the other OpenOffice.org applications,
+ <a href="http://www.openoffice.org/product/base.html">Base</a> has, with OpenOffice 3, evolved
+ to an own database application. It allows you to access data on an external database of your choice (for
+ instance <a href="http://www.mysql.org">MySQL</a>, <a href="http://www.postgresql.org">PostgreSQL</a>,
+ and many others), plus bundles the <a href="http://hsqldb.org/">HSQLDB</a> database engine,
+ this way allowing you to kick-start with your own database.</p>
+
+ <h2>Participation</h2>
+
+ <p>There are various resources here on this page as well as in our
+ <a href="http://wiki.services.openoffice.org/wiki/Main_Page">OpenOffice.org Wiki</a>. What are you looking for?
+ <ul>
+ <li><strong>Documentation</strong>
+ <p><a href="http://wiki.services.openoffice.org/wiki/Category:Database">Our Wiki</a> features a whole
+ category dedicated to <a href="http://wiki.services.openoffice.org/wiki/Category:Base_Documentation">end-user
+ documentation for OpenOffice.org Base</a>. There you'll find articles, HowTo's, frequently asked questions
+ (and answers). You might also want to visit the
+ <a href="http://wiki.services.openoffice.org/wiki/Category:Base_Tutorials">Tutorials</a> category.<p>
+ <p>As always, you're encouraged to contribute to the Wiki - if you find something is missing, or otherwise
+ have information to share: just add it!</p>
+ </li>
+
+ <li><strong>Development</strong>
+
+ <p>You want to contribute some coding, but don't know where to start? Welcome!</p>
+
+
+ <p>You can <a href="https://issues.apache.org/ooo/buglist.cgi?bug_status=__open__&content=&product=Base&query_format=specific&order=bug_status%2Cpriority%2Cassigned_to%2Cbug_id&limit=0">browse</a> all issues pertaining to Base.
+ You can also submit Base bugs using BugZilla.</p>
+
+ <p>Addtionally, you might find the <a href="development/project_structure.html">project structure</a> helpful if you're pursing
+ Base development.</p>
+
+ <p>Finally, there is an older list of small to medium self-contained projects for developers, so if you're interested,
+ <a href="development/projects.html">have a look</a>.</p>
+
+ <p>If you have a pet peeve database which currently poorly connects to OpenOffice.org Base, or some other
+ structured data which you want Base to be able to access (for instance some address book data), writing
+ a dedicated driver might be for you. This is easier than it sounds, as various contributions have proven
+ in the past. Again, <a href="mailto:dev@openoffice.apache.org">our developer mailing lists</a> could be your
+ first stop, and the <a href="http://wiki.services.openoffice.org/wiki/Base_New_Driver_Tutorial">Base New Driver
+ Tutorial</a> your second one.</p>
+ </li>
+
+ <li><strong>Quality Assurance</strong>
+ <p>We're working hard to make Base perfect, but let's face the truth: we're not there (yet). If
+ you found a bug, or are missing a feature, you can help by
+ <a href="http://qa.openoffice.org/issue_handling/pre_submission.html">describing it in IssueZilla</a>,
+ OpenOffice.org's bug tracking system.</p>
+
+ <p>If you have some more time to spend to make OpenOffice.org better, consider joining the
+ <a href="http://qa.openoffice.org/">QA Team</a>.</p>
+
+ <p>If you want to have a look a future features before they're available to all others, and help us
+ to make them better before we release them to the wild, visit our
+ <a href="http://wiki.services.openoffice.org/wiki/Category:Base%27s_Bleeding_Edge">Bleeding Edge</a>
+ section.</p>
+
+
+ </li>
+
+ <li><strong>Miscellaneous</strong>
+ <p>If you always wanted to know how Base is intended to work, our <a href="specifications/index.html">Specifications
+ section</a> might be for you.</p>
+ </li>
+ </ul>
+ </p>
+
+ </body>
+</html>
diff --git a/content/dba/menu.html b/content/dba/menu.html
new file mode 100644
index 0000000..b26fd5d
--- /dev/null
+++ b/content/dba/menu.html
@@ -0,0 +1,28 @@
+<html><head>
+<meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
+</head>
+<body>
+<!-- custom project include -->
+<img src="/branding/images/blue_divider.gif" width="108" height="15" alt="blue divider" /><br>
+<br>
+<a href="/index.html"><b>OpenOffice.org Base</b></a><br>
+
+<img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/specifications/index.html">Specifications</a><br>
+
+<img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/FAQ/index.html">Tips
+ 'n' tricks</a><br>
+ <img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/FAQ/specific.html">Specific
+ Problems</a><br>
+ <img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/FAQ/external.html">External
+ Resources</a><br>
+
+<img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/development/index.html">Development</a><br>
+ <img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/development/projects.html">Developer
+ Projects</a><br>
+
+
+<img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/tools/SDBTestTool.html">SDB Test Tool</a><br>
+ <img src="/branding/images/blue_bullet.gif" alt="blue bullet" /> <a href="/drivers/postgresql/index.html">PostgreSQL driver</a><br>
+<!-- end custom project include -->
+</body>
+</html>
diff --git a/content/dba/project_tools.html b/content/dba/project_tools.html
new file mode 100644
index 0000000..55c48bd
--- /dev/null
+++ b/content/dba/project_tools.html
@@ -0,0 +1,53 @@
+<!-- Note: You don't have to fill in the name of your project
+with ONE exception:
+you must specify the project name for the Version control link. -->
+
+<div class="label"><strong>Project tools</strong></div>
+<div class="body">
+ <div> <a href="/servlets/ProjectHome">Project home</a> </div>
+ <div> <a href="/servlets/ProjectMemberList">Membership</a> </div>
+</div>
+<div class="body">
+ <div> <a href="/servlets/ProjectNewsList">Announcements</a> </div>
+ <!-- #if ($isLoggedIn && !$loginUser.isAnonymous())
+ <div><a href="/servlets/ProjectForumView">Discussion forums</a></div>
+ #end -->
+ <div> <a href="/servlets/ProjectMailingListList">Mailing lists</a> </div>
+</div>
+<div class="body">
+ <div> <a href="/servlets/ProjectDocumentList">Documents & files</a> </div>
+ <div><a href="/source/browse/dba">Version control</a> </div>
+</div>
+<div class="body">
+ <div> <a href="/servlets/ProjectIssues">Issue tracker</a> </div>
+ <!-- #if ($isLoggedIn && !$loginUser.isAnonymous())
+ <div><a href="http://qa.openoffice.org/issues/buglist.cgi?cmdtype=runuserdefault">My issues</a></div>
+ #end </div> -->
+<!--Other links should just be added using <div>...</div>, with regular expressions, eg., <div>about-downloads.html</div>, to link to http://[projectname].openoffice.org/about-downloads.html, which is in the project/www/ directory. To link to, say, http://[projectname].openoffice.org/information/index.html, use <div>/information/index.html</div>.
+
+Thus:
+
+<div>file.html</div>
+<div>/directory/file.html</div>
+
+-->
+</div>
+
+<div class="label"><a href="/index.html"><strong>OpenOffice.org Base</strong></a> </div>
+
+<div class="body" id="dba_project_menu">
+ <div id="dba_specifications_item_menu_left"><a href="/specifications/index.html">Specifications</a></div>
+
+ <div id="dba_qa_item_menu_left"><a href="http://qa.openoffice.org/ooQAReloaded/DatabaseTeamsite/ooQA-TeamDatabase.html">QA</a></div>
+
+ <div id="dba_dev_item_menu_left"><a href="/development/index.html">Development</a>
+ <div id="dba_dev_projects_item_menu_left"><a href="/development/projects.html">Developer projects</a></div>
+ <div id="dba_dev_structure_item_menu_left"><a href="/development/project_structure.html">Project Structure</a></div>
+ </div>
+
+ <div id="sdb_drivers_item_menu_left"><a href="/drivers/index.html">Database Drivers</a>
+ <div id="postgres_driver_item_menu_left"><a href="/drivers/postgresql/index.html">PostgreSQL</a></div>
+ <div id="mdb_driver_item_menu_left"><a href="/drivers/mdb/index.html">MDB</a></div>
+ <div id="sqlite_driver_item_menu_left"><a href="/drivers/sqlite/index.html">SQLite</a></div>
+ </div>
+</div>
\ No newline at end of file
diff --git a/content/dba/specifications/AutoIncrementValues.html b/content/dba/specifications/AutoIncrementValues.html
new file mode 100644
index 0000000..9d4b3c7
--- /dev/null
+++ b/content/dba/specifications/AutoIncrementValues.html
@@ -0,0 +1,306 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>The creation and retrieving of auto increment values</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Win32)">
+ <META NAME="AUTHOR" CONTENT="Ocke Janssen">
+ <META NAME="CREATED" CONTENT="20020710;8345700">
+ <META NAME="CHANGEDBY" CONTENT="Ocke Janssen">
+ <META NAME="CHANGED" CONTENT="20020729;8060399">
+ <STYLE>
+ <!--
+ @page { margin: 2cm }
+ TD P { margin-bottom: 0.21cm }
+ H1 { margin-bottom: 0.21cm }
+ H1.western { font-family: "Albany", sans-serif; font-size: 16pt }
+ H1.cjk { font-size: 16pt }
+ H1.ctl { font-size: 16pt }
+ P { margin-bottom: 0.21cm }
+ H2 { margin-bottom: 0.21cm }
+ H2.western { font-family: "Albany", sans-serif; font-size: 14pt; font-style: italic }
+ H2.cjk { font-size: 14pt; font-style: italic }
+ H2.ctl { font-size: 14pt; font-style: italic }
+ H3 { margin-bottom: 0.21cm }
+ H3.western { font-family: "Albany", sans-serif }
+ H4 { margin-bottom: 0.21cm }
+ H4.western { font-family: "Albany", sans-serif; font-size: 11pt; font-style: italic }
+ H4.cjk { font-size: 11pt; font-style: italic }
+ H4.ctl { font-size: 11pt; font-style: italic }
+ TH P { margin-bottom: 0.21cm; font-style: italic }
+ -->
+ </STYLE>
+</head>
+<body LANG="en-US">
+<H1 CLASS="western" ALIGN=CENTER>The creation and retrieving of auto
+increment values</H1>
+<P><BR><BR>
+</P>
+<P>Version History</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=128*>
+ <COL WIDTH=128*>
+ <THEAD>
+ <TR VALIGN=TOP>
+ <TH WIDTH=50%>
+ <P>What/When</P>
+ </TH>
+ <TH WIDTH=50%>
+ <P>Who</P>
+ </TH>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR VALIGN=TOP>
+ <TD WIDTH=50%>
+ <P>Draft---July 18, 2002</P>
+ </TD>
+ <TD WIDTH=50%>
+ <P>Ocke Janssen</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=50%>
+ <P>GUI string review---July 25, 2002</P>
+ </TD>
+ <TD WIDTH=50%>
+ <P>Elizabeth Matthis</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=50%>
+ <P>GUI change---July 26, 2002</P>
+ </TD>
+ <TD WIDTH=50%>
+ <P>Ocke Janssen</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=50%>
+ <P>Final--- July 26, 2002fill in date
+ </P>
+ </TD>
+ <TD WIDTH=50%>
+ <P>Ocke Janssen</P>
+ </TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H1 CLASS="western"><BR><BR>
+</H1>
+<H2 CLASS="western">Problem description</H2>
+<P>At the moment it is not possible to create auto increment columns
+and to retrieve the value of an auto increment column when a new row
+was inserted.
+</P>
+<H4 CLASS="western">Creation of auto increment columns</H4>
+<P>Due to the fact that there exists no standard way on defining auto
+increment columns when creating a new table, a general approach is
+not possible. For example: MySQL identifies an auto increment
+definition of a column with the key word “auto_increment”,
+the MS SQL Server on the other side uses the keyword “increment(1,1)”
+to identify the auto increment column.
+</P>
+<H4 CLASS="western">Retrieving of auto increment column's values</H4>
+<P>The retrieving of an auto increment column's value, when inserting
+a new row, is already defined in the JDBC API 3.0. There the
+statement supports an additional method which returns a result set to
+access the new inserted auto increment column's value. This result
+set also supports meta data. To check if the statement supports this
+mechanism, the database meta data is extended by new support method
+which simply returns true or false.</P>
+<H2 CLASS="western">Solution</H2>
+<P>To allow a general approach of defining/retrieving auto increment
+columns/values, the user must have the possibility to define a
+statement which should be appended at the column definition when
+creating a table or should be called when fetching the new value of
+the auto increment column.</P>
+<H4 CLASS="western">Creation of auto increment columns</H4>
+<P>When creating tables for any kind of database, the current
+handling at the moment is that we use a general SDBCX layer for all
+database drivers which do not support the layer by their self. In
+other words the user has to take no action when the database driver
+supports already the SDBCX layer. For the case that the driver
+doesn't support the SDBCX layer and the user creates a new table, the
+generated SQL statement may look like this:</P>
+<P>CREATE TABLE “table1” (“id” INTEGER)</P>
+<P>The “CREATE TABLE” statement doesn't support any auto
+increment features, so that it isn't possible to create such columns.
+For MySQL this statement for an auto increment column looks like
+this:</P>
+<P>CREATE TABLE “table1” (“id” INTEGER
+AUTO_INCREMENT)</P>
+<P>Like this examples shows the user must have the opportunity to add
+the missing part of the statement to the “CREATE TABLE”
+statement. This can be done in two different ways which mustn't
+exclude each other.</P>
+<OL>
+ <LI><P>The data source stores in their info property an additional
+ string which should be appended to the column part when creating an
+ auto increment column. To allow the user to insert this string the
+ data source administration dialog could be extended by a simple text
+ field and may be an additional checkbox which enables this text
+ field.</P>
+ <LI><P>The table design offers an additional field on the column
+ properties area when an auto increment type was selected. This field
+ can be used by the user to define a string which should be appended
+ to the “CREATE TABLE” statement.
+ </P>
+ <LI><P>The points 1. and 2. are both used and under point 2, the
+ string which the user inserted under point 1 will be displayed in
+ the extra field.</P>
+</OL>
+<P>The 3<SUP>rd</SUP> approach would be the one which allows the user
+the most flexibility to get a predefined string which he could change
+if necessary. The best place to store the value for the data source
+would be the data source administration dialog. To be more precise
+this would be implemented for the JDBC and the ODBC drivers (they
+don't support the SDBCX layer). All other drivers support the SDBCX
+layer.</P>
+<H4 CLASS="western">Retrieving of auto increment column's values</H4>
+<P>As mentioned in the problem description JDBC 3.0 already defines
+methods to accomplish the task but it is not possible just to forward
+this to the used drivers. Many drivers as also APIs like ODBC don't
+support this feature. To fit near all databases, a method has to be
+implemented that allows to fetch the new inserted auto increment
+value. Many databases support a special SQL statement which allows to
+fetch this value. Mostly these statements are database specific and
+not SQL conform. So a similar approach as for the creation of auto
+increment columns should be chosen. The data source should also store
+a SQL string which allows to fetch the auto increment values. This
+string will then be executed by the statement when asked for the auto
+increment values after inserting a new row. To be compatible as
+possible to any kind of database the SQL string, stored in the data
+source, must fulfill some additional specifications to be valid for
+different tables. In other words, the SQL string must contain some
+keywords like $column1 or $table1 which will be replaced with the
+auto increment column name or with the used table. A general string
+could already be inserted into the data source dialog which is not
+the best solution but works for a lot of drivers:</P>
+<P>“select count($column1)+1 from $table1”</P>
+<P>If the supporting of this feature should be disabled the string
+could be cleared by the user or an additional checkbox must be
+inserted into to the dialog to enable or disable this feature. When
+this feature is enabled the database meta data object implemented by
+the driver will return false when asking the general support method
+for the feature “AutoRetrievingEnabled” otherwise true.
+When true was returned the statement object implemented by the driver
+allows the creation of a result set to fetch the auto increment
+values.</P>
+<H2 CLASS="western" STYLE="page-break-before: always">Data source
+administration dialog</H2>
+<P><IMG SRC="AutoIncrementValues_html_m243b4459.gif" NAME="Graphic1" ALIGN=LEFT WIDTH=643 HEIGHT=391 BORDER=0><BR CLEAR=LEFT><BR><BR>
+</P>
+<P><BR><BR>
+</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <THEAD>
+ <TR VALIGN=TOP>
+ <TH WIDTH=33%>
+ <P>English</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>German</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>Comment</P>
+ </TH>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>~Retrieve generated values</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Generierte Werte ~berücksichtigen</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Checkbox to enable this feature</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>~Auto-increment statement</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>~Auto-Increment-Ausdruck</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>FixedText which contains the statement which should be
+ appended after each column definition</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>~Query of generated values</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Abfrage der generierten ~Werte</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>FixedText which contains the statement which will be called
+ after an “INSERT” statement</P>
+ </TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<P><BR><BR>
+</P>
+<H3 CLASS="western">Table design</H3>
+<P><IMG SRC="AutoIncrementValues_html_2f28066b.gif" NAME="Graphic2" ALIGN=LEFT WIDTH=642 HEIGHT=372 BORDER=0><BR CLEAR=LEFT><BR><BR>
+</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <THEAD>
+ <TR VALIGN=TOP>
+ <TH WIDTH=33%>
+ <P>English</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>German</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>Comment</P>
+ </TH>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Auto-increment statement</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>~Auto-Increment-Ausdruck</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>FixedText which contains the same value as the 2<SUP>nd</SUP>
+ FixedText in data source administration dialog</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Enter an SQL statement for the auto-increment field.\n\nThis
+ statement will be directly transferred to the database when the
+ table is created.</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Geben Sie hier einen SQL Ausdruck für das
+ Auto-Increment-Feld an.\n\nDieser Ausdruck wird beim Erzeugen der
+ Tabelle direkt an die Datenbank übertragen.</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>HelpText for this field which appears in the left side control</P>
+ </TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<P><BR><BR>
+</P>
+</body>
+</HTML>
diff --git a/content/dba/specifications/Drag_Drop_DSBrowser.html b/content/dba/specifications/Drag_Drop_DSBrowser.html
new file mode 100644
index 0000000..410bd4b
--- /dev/null
+++ b/content/dba/specifications/Drag_Drop_DSBrowser.html
@@ -0,0 +1,137 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Drag and Drop in the Datasource Browser</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Win32)">
+ <META NAME="AUTHOR" CONTENT="Ocke Janssen">
+ <META NAME="CREATED" CONTENT="20020408;15591366">
+ <META NAME="CHANGEDBY" CONTENT="Ocke Janssen">
+ <META NAME="CHANGED" CONTENT="20020408;16013755">
+ <STYLE>
+ <!--
+ TH P { margin-bottom: 0.21cm; font-style: italic }
+ -->
+ </STYLE>
+</head>
+<body LANG="de-DE">
+<H1>Drag and Drop in the Datasource Browser
+</H1>
+<P>This document shows what should be possible to drag and what
+should be happen when droped inside the datasource browser.
+</P>
+<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <THEAD>
+ <TR VALIGN=TOP>
+ <TH WIDTH=33%>
+ <P>Source</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>Destination</P>
+ </TH>
+ <TH WIDTH=33%>
+ <P>Effect</P>
+ </TH>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Table object</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Table container</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Opens Wizard, whole table and data will be copied. See 1</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Query object</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Table container</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Opens Wizard, whole query (as table or as view) and data will
+ be copied. See 2</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Qurey object</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Query container</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Copies the query object</P>
+ </TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P>Grid-control</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Table container</P>
+ </TD>
+ <TD WIDTH=33%>
+ <P>Opens Wizard, only selection will be copied. See 3</P>
+ </TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<P STYLE="margin-top: 0.42cm; margin-bottom: 0.21cm; page-break-after: avoid">
+<FONT FACE="Albany, sans-serif"><FONT SIZE=4>1 The table object as
+drag source</FONT></FONT></P>
+<P>Inside the datasorce browser, the table object can only be copied
+onto the table container. When copied all properties must also be
+copied. That means that the following properties have to look for if
+they are copied too.</P>
+<UL>
+ <LI><P>Columns</P>
+ <LI><P>Keys</P>
+ <LI><P>Indexes</P>
+ <LI><P>table settings, like color, filter and filter applied,
+ sorting
+ </P>
+ <LI><P>column settings, like number format</P>
+ <LI><P>and the data</P>
+</UL>
+<P>Outside the datasource browser, the table should be exported in
+HTML and RTF format. Additionally the writer should support extra
+functionality.</P>
+<P STYLE="margin-top: 0.42cm; margin-bottom: 0.21cm; page-break-after: avoid">
+<FONT FACE="Albany, sans-serif"><FONT SIZE=4>2 The query object as
+drag source</FONT></FONT></P>
+<P>The query object can be copied onto the query container. It should
+be a 1:1 copy. All properties have to be copied, the same as for the
+table object. When copied onto the table container, the user could
+choise between a table object to be created or an view object when
+the database supports it.</P>
+<UL>
+ <LI><P>the SQL statement</P>
+ <LI><P>the column settings as by a table</P>
+ <LI><P>the query settings, like color</P>
+</UL>
+<P STYLE="margin-top: 0.42cm; margin-bottom: 0.21cm; page-break-after: avoid">
+<FONT FACE="Albany, sans-serif"><FONT SIZE=4>4 The grid-control as
+drag source</FONT></FONT></P>
+<P>The grid control shows the current selection of the tree view.
+This view can be sorted and filtered. At this reason it is possible
+that the source contains a filter which has to be include when coping
+data. Additionally it is possible to do a multiselection on the rows.
+When this selection is copied on the table container, only the
+selected rows have to be copied and not the whole rows. Another point
+to mention is that the rows must also be dragable to other
+applications like the writer, this is also valid for the column
+header.
+</P>
+<P><BR><BR>
+</P>
+</body>
+</HTML>
diff --git a/content/dba/specifications/Form_Navigator_DnD.html b/content/dba/specifications/Form_Navigator_DnD.html
new file mode 100644
index 0000000..409f6e7
--- /dev/null
+++ b/content/dba/specifications/Form_Navigator_DnD.html
@@ -0,0 +1,371 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+
+ <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+ <title>Form Navigator Data Exchange Functional Spec</title>
+
+ <meta name="GENERATOR" content="StarOffice 6.0 (Win32)">
+
+ <meta name="CREATED" content="20020513;14164900">
+
+ <meta name="CHANGEDBY" content="Frank Sch�nheit">
+
+ <meta name="CHANGED" content="20020521;16011356">
+</head>
+<body lang="de-DE">
+<div id="Table of Contents1">
+<div style="text-align: center;"> </div>
+<div id="Table of Contents1_Head">
+<div style="text-align: center;"> <font size="+3"><span
+ style="font-weight: bold;">Data Exchange in the Form Navigator</span></font><br>
+<font size="+1"><span style="font-style: italic; font-weight: bold;">Functional
+specification</span></font><br>
+</div>
+<br>
+This document describes the data exchange functionality in the form
+navigator. This is the small floater which can be switched on when
+designing a form document, and visualizes the logical structure of the
+form components (forms, sub forms, control models). <br>
+<br>
+Data exchange means Drag and Drop functionality as well as Clipboard
+activities.
+<h2><a name="mozTocId51302" class="mozTocH2"></a>Table of Contents</h2>
+ </div>
+
+<ul id="mozToc">
+<!--mozToc h3 3 h4 4 h5 5--><li><a href="#mozTocId975628">1 Acceptance
+Rules</a></li>
+ <ul>
+ <li><a href="#mozTocId24028">1.1 Actions for different Component</a></li>
+ <li><a href="#mozTocId581363">1.2 Move</a></li>
+ <li><a href="#mozTocId244433">1.3 Copy</a></li>
+ </ul>
+ <li><a href="#mozTocId125168">2 Functionality</a>
+ <ul>
+ <li><a href="#mozTocId665767">2.1 Drag and Drop</a>
+ <ul>
+ <li><a href="#mozTocId134648">2.1.1 Activation</a><br></li>
+ <li><a href="#mozTocId658958">2.1.2 Mode selection</a></li>
+ </ul>
+ </li>
+ <li><a href="#mozTocId547415">2.2 Clipboard</a>
+ <ul>
+ <li><a href="#mozTocId4311">2.2.1 Activation</a></li>
+ <li><a href="#mozTocId14953">2.2.2 Cutting Entries</a></li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li><a href="#mozTocId620921">3 Clipboard formats</a>
+ <ul>
+ <li><a href="#mozTocId563632">3.1 Hidden controls</a></li>
+ <li><a href="#mozTocId166879">3.2 Control paths</a></li>
+ <li><a href="#mozTocId755191">3.3 Tree list entries</a></li>
+ </ul>
+ </li>
+ <li><a href="#mozTocId320803">4 Test cases</a>
+ <ul>
+ <li><a href="#mozTocId929325">4.1 Hidden controls</a></li>
+ <li><a href="#mozTocId985204">4.2 Non-Hidden Controls</a></li>
+ <li><a href="#mozTocId970357">4.3 More to come .....</a></li>
+ </ul>
+ </li>
+ </ul>
+</ul>
+<p style="margin-bottom: 0cm;"><br>
+</p>
+</div>
+<p class="western"><br>
+</p>
+<h3><a name="mozTocId975628" class="mozTocH3"></a>1 Acceptance Rules</h3>
+<p class="western">When doing a copy or move operation, given a set of
+source components (e.g. the drag source) and a target component (the
+drop target), the operation is rejected according to the rules below. If
+and only neither of the rules applies, the operation is accepted.<br>
+In general and by default, the source can be an arbitrary mixture of
+hidden controls, "normal" controls, and forms, while the destination can
+be any valid entry in the form navigator.</p>
+<h4><a name="mozTocId24028" class="mozTocH4"></a>1.1 Actions for
+different Component</h4>
+<p class="western">Allowed actions differ for the different types of
+components: (hidden/non-hidden controls, and forms). Additionally, there
+is a difference if the data exchange is in-place (within the same
+navigator instance) or if it crosses document boundaries.</p>
+<p class="western">The following table shows the acceptance matrix
+under these aspects.</p>
+<table width="642" border="1" bordercolor="#000000" cellpadding="4"
+ cellspacing="0">
+ <col width="126"> <col width="119"> <col width="119"> <col width="119">
+ <col width="118"> <thead> <tr valign="top">
+ <th width="126">
+ <p class="western" style="">control \ action</p>
+ </th>
+ <th width="119">
+ <p class="western" style="">copy, in-place</p>
+ </th>
+ <th width="119">
+ <p class="western" style="">move, in-place</p>
+ </th>
+ <th width="119">
+ <p class="western" style="">copy, crossing</p>
+ </th>
+ <th width="118">
+ <p class="western" style="">move, crossing</p>
+ </th>
+ </tr>
+ </thead> <tbody>
+ <tr valign="top">
+ <td width="126">
+ <p class="western">hidden control</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">+</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">+</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">+</p>
+ </td>
+ <td width="118">
+ <p class="western" align="center">-</p>
+ </td>
+ </tr>
+ <tr valign="top">
+ <td width="126">
+ <p class="western">non-hidden control</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">-</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">+</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">-</p>
+ </td>
+ <td width="118">
+ <p class="western" align="center">-</p>
+ </td>
+ </tr>
+ <tr valign="top">
+ <td width="126">
+ <p class="western">forms</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">-</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">+</p>
+ </td>
+ <td width="119">
+ <p class="western" align="center">-</p>
+ </td>
+ <td width="118">
+ <p class="western" align="center">-</p>
+ </td>
+ </tr>
+
+ </tbody>
+</table>
+<p class="western"><br>
+<br>
+</p>
+<p class="western">If the source of a data exchange operation contains
+a mixed set of different types, the weakest rules determine the result.
+Means if you mix for instance a hidden control with a form, then the
+acceptance rules for the form apply.</p>
+<p class="western">There are additional rules which may restrict the
+operation even further, they are explained in the next paragraphs.</p>
+<h4><a name="mozTocId581363" class="mozTocH4"></a>1.2 Move</h4>
+<p class="western">In addition to the rules from chapter 1.1, a move
+operation is rejected if one of the following points applies:</p>
+<ol>
+ <li>
+ <p class="western">The target does not exist, i.e. the components
+were dropped onto empty space.</p>
+ </li>
+ <li>
+ <p class="western">The root entry is part of the source components
+� you can't move the root</p>
+ </li>
+ <li>
+ <p class="western">One of the source components</p>
+
+ <ol type="a">
+ <li>
+ <p class="western">is a child of the target component</p>
+ </li>
+ <li>
+ <p class="western">equals the target component</p>
+ </li>
+ <li>
+ <p class="western">is a form, and at the same time an
+ancestor of the target</p>
+ </li>
+ <li>
+ <p class="western">is a control, and the target is the root
+component</p>
+ </li>
+ </ol>
+ </li>
+ <li>
+ <p class="western">The target component is a control</p>
+ </li>
+</ol>
+<h4><a name="mozTocId244433" class="mozTocH4"></a>1.3 Copy</h4>
+<p class="western">In addition to the rules from chapter 1.1, a copy
+operation is rejected if and only if one of the following points applies:</p>
+<ol>
+ <li>
+ <p class="western">The target does not exist, i.e. the components
+were dropped onto empty space.</p>
+ </li>
+ <li>
+ <p class="western">The target component is no form</p>
+ </li>
+</ol>
+<h3><a name="mozTocId125168" class="mozTocH3"></a>2 Functionality</h3>
+<h4><a name="mozTocId665767" class="mozTocH4"></a>2.1 Drag and Drop</h4>
+<h5><a name="mozTocId134648" class="mozTocH5"></a>2.1.1 Activation</h5>
+<p class="western">as usual: Select an arbitrary set of entries in the
+navigator, and start dragging them.</p>
+<h5><a name="mozTocId658958" class="mozTocH5"></a>2.1.2 Mode selection</h5>
+<p class="western">The default mode is "move", i.e. if you do a DnD
+operation without any modifier keys, a move will be triggered.<br>
+You can use the usual platform-dependent (e.g. on Windows: Ctrl)
+modifier key(s) to force copying</p>
+<h4><a name="mozTocId547415" class="mozTocH4"></a>2.2 Clipboard</h4>
+<h5><a name="mozTocId4311" class="mozTocH5"></a>2.2.1 Activation</h5>
+<p class="western">as usual: Select an arbitrary set of entries in the
+navigator, open the context menu (no matter if by mouse or keyboard),
+and choose "Copy" or "Cut" therein. Alternatively, press the usual,
+platform-dependent keyboard shortcuts (e.g. on Windows: Ctrl-C for copy,
+Ctrl-X for cut).</p>
+<p class="western" style="font-style: normal;">The Paste aka Insert
+functionality is reachable when via context menu and usual shortcut,
+too. It is not available if no entry is selected, if more than one entry
+is selected, or if the selected entry does not fullfill the acceptance
+rules from chapter 1.</p>
+<h5><a name="mozTocId14953" class="mozTocH5"></a>2.2.2 Cutting Entries</h5>
+<p class="western">If you started a cut, the entries in question will
+get a brighter icon, indicating that they are to be moved once the move
+operation is finished. This means they are not removed from the model
+when you do the cut, but only when you do the paste from the clipboard.</p>
+<h3><a name="mozTocId620921" class="mozTocH3"></a>3 Clipboard formats</h3>
+<p class="western">This chapter is for completeness. It describes the
+internal clipboard formats used.</p>
+<p class="western">The following formats are used for transfering data
+within one or more instances of the form navigator.</p>
+<h4><a name="mozTocId563632" class="mozTocH4"></a>3.1 Hidden controls</h4>
+<ul>
+ <li>
+ <p class="western">format name:
+ application/x-openoffice;windows_formatname="svxform.HiddenControlModelsExchange"</p>
+ </li>
+ <li>
+ <p class="western" style="font-style: normal;">content: a
+Sequence< XPropertySet >, denoting the models of the hidden
+ controls to transfer</p>
+ </li>
+</ul>
+<h4><a name="mozTocId166879" class="mozTocH4"></a>3.2 Control paths</h4>
+<ul>
+ <li>
+ <p class="western">format name:
+ application/x-openoffice;windows_formatname="svxform.ControlPathExchange"</p>
+ </li>
+ <li>
+ <p class="western" style="font-style: normal;"> content:
+Sequence< Any >, 2 elements</p>
+
+ <ul>
+ <li>
+ <p class="western" style="font-style: normal;"> first element:
+Reference< XNameContainer > which represents the collections of
+all forms</p>
+ </li>
+ <li>
+ <p class="western" style="font-style: normal;"> second
+element: Sequence< Sequence< int > >: Every element
+describes a "path� to a control model, relative to the container in
+the container above.<br>
+ <br>
+E.g., if the sequence is "( ( 0, 2 ), (1, 3, 2) )", then two
+ elements with the paths "(0, 2)" and "(1, 3, 2)" are described.
+Means the first element is the third (2!) children of the first (0!)
+children of the container, and the second element is the third
+children of the forth children of the second children of the container.</p>
+ </li>
+ </ul>
+ </li>
+</ul>
+<h4><a name="mozTocId755191" class="mozTocH4"></a>3.3 Tree list entries</h4>
+<ul>
+ <li>
+ <p class="western">format name:
+ application/x-openoffice;windows_formatname="svxform.FieldNameExchange"</p>
+ </li>
+ <li> content: Virtually nothing :). This is not really transfered via
+the usual exchange mechanisms, it is just a shortcut for instances
+where the drag source is the same as the drop target; in this case the
+latter does not need to rebuild all the internal information from the
+ persistent format 2.<br>
+In particular, this means the format does not supply data, it acts as
+placeholder only. </li>
+</ul>
+<h3><a name="mozTocId320803" class="mozTocH3"></a>4 Test cases</h3>
+<h4><a name="mozTocId929325" class="mozTocH4"></a>4.1 Hidden controls</h4>
+<ul>
+ <li>
+ <p class="western">Create a form containing a hidden control.
+ Create a new sub form below the first form.</p>
+
+ <ul>
+ <li>
+ <p class="western">Try to DnD this control to itself, to it's
+ parent, to the sub form, to a free place in the navigator. Check
+ that moving is allowed (and works) on the sub form, and nowhere else.</p>
+ </li>
+ <li>
+ <p class="western">Try the same actions with the first modifier
+ key (Ctrl). This should be a copy operation, thus it should be
+ allowed (and work) on the forms, but nowhere else.</p>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <p class="western">Create a second document, and a form therein</p>
+
+ <ul>
+ <li>
+ <p class="western">Try to DnD the hidden control from the first
+ document to the form in the second document. Only copying to a form
+ should work.</p>
+ </li>
+ </ul>
+ </li>
+</ul>
+<h4><a name="mozTocId985204" class="mozTocH4"></a>4.2 Non-Hidden
+Controls</h4>
+<ul>
+ <li>
+ <p class="western">Create a form with some controls (except than
+ hidden controls)</p>
+
+ <ul>
+ <li>
+ <p class="western">mark an arbitrary set of controls, and try
+ to DnD them in the navigator. Should be refused all times: Movement
+ is not allowed (as the only existent form is the parent of the
+ controls), and copy is not allowed in general for non-hidden
+ controls.</p>
+ </li>
+ </ul>
+ </li>
+</ul>
+<h4><a name="mozTocId970357" class="mozTocH4"></a>4.3 More to come .....</h4>
+</body>
+</html>
diff --git a/content/dba/specifications/MySQL_data_source_page.html b/content/dba/specifications/MySQL_data_source_page.html
new file mode 100644
index 0000000..36d772c
--- /dev/null
+++ b/content/dba/specifications/MySQL_data_source_page.html
@@ -0,0 +1,245 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<head>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>MySQL driver page</TITLE>
+ <META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Win32)">
+ <META NAME="AUTHOR" CONTENT="Ocke Janssen">
+ <META NAME="CREATED" CONTENT="20020306;7403200">
+ <META NAME="CHANGEDBY" CONTENT="Ocke Janssen">
+ <META NAME="CHANGED" CONTENT="20021122;10010893">
+</head>
+<body LANG="en-US" LINK="#0000cc">
+<P ALIGN=CENTER><FONT FACE="Albany"><FONT SIZE=5><B>MySQL driver page</B></FONT></FONT></P>
+<P ALIGN=CENTER><FONT FACE="Albany"><FONT SIZE=3><I><SPAN LANG="en-US">applies</SPAN>
+to StarOffice 6.1 <BR>status: finished, last modified: <SDFIELD TYPE=DOCINFO SUBTYPE=CHANGE FORMAT=DATE SDNUM="1033;1033;D. MMM. YYYY">22. Nov. 2002</SDFIELD></I></FONT></FONT></P>
+<H1><FONT FACE="Albany"><FONT SIZE=4>Version History</FONT></FONT></H1>
+<TABLE WIDTH=586 BORDER=1 CELLPADDING=4 CELLSPACING=0 FRAME=HSIDES RULES=ROWS>
+ <COL WIDTH=99>
+ <COL WIDTH=32>
+ <COL WIDTH=129>
+ <COL WIDTH=294>
+ <THEAD>
+ <TR>
+ <TD WIDTH=99 VALIGN=BOTTOM SDVAL="37570" SDNUM="1033;0;MM/DD/YY">
+ <P ALIGN=RIGHT><FONT FACE="Albany"><FONT SIZE=2>11/10/02</FONT></FONT></TD>
+ <TD WIDTH=32 VALIGN=TOP>
+ <P ALIGN=LEFT><BR>
+ </TD>
+ <TD WIDTH=129 VALIGN=TOP>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Ocke Janssen</FONT></FONT></TD>
+ <TD WIDTH=294 VALIGN=TOP>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>first draft</FONT></FONT></TD>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR>
+ <TD WIDTH=99 VALIGN=BOTTOM SDVAL="37581" SDNUM="1033;0;MM/DD/YY">
+ <P ALIGN=RIGHT><FONT FACE="Albany"><FONT SIZE=2>11/21/02</FONT></FONT></TD>
+ <TD WIDTH=32 VALIGN=TOP>
+ <P ALIGN=LEFT><BR>
+ </TD>
+ <TD WIDTH=129 VALIGN=TOP>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Elizabeth Matthis</FONT></FONT></TD>
+ <TD WIDTH=294 VALIGN=TOP>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>GUI string review</FONT></FONT></TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H1><FONT FACE="Albany"><FONT SIZE=4>Abstract</FONT></FONT></H1>
+<P ALIGN=JUSTIFY><FONT FACE="Thorndale">To create a new data source
+with the new MySQL driver, the data source administration dialog must
+be extended. A new page will be inserted where the user can fill in
+all necessary information which are needed to connect to a MySQL
+database.</FONT></P>
+<DIV ID="Table of Contents1">
+ <DIV ID="Table of Contents1_Head">
+ <H1><FONT FACE="Albany"><FONT SIZE=4>Contents</FONT></FONT></H1>
+ </DIV>
+ <DL>
+ <DT><FONT FACE="Albany"><FONT SIZE=2>1 MySQL driver page 1</FONT></FONT><DT>
+ <FONT FACE="Albany"><FONT SIZE=2>1.1 The driver page in detail 1</FONT></FONT><DT>
+ <FONT FACE="Albany"><FONT SIZE=2>1.2 String List 1</FONT></FONT></DL>
+</DIV>
+<H1><FONT FACE="Albany"><FONT SIZE=4>1 MySQL driver page</FONT></FONT></H1>
+<P ALIGN=JUSTIFY><FONT FACE="Thorndale">The new driver page fort
+MySQL allows the user to select between two different kinds of 'how
+to connect to the MySQL database'. The first possibility is to use an
+existing MyODBC<A CLASS="sdfootnoteanc" NAME="sdfootnote1anc" HREF="#sdfootnote1sym"><SUP>1</SUP></A>
+data source which must be defined in the used system. The second kind
+is to use the JDBC<A CLASS="sdfootnoteanc" NAME="sdfootnote2anc" HREF="#sdfootnote2sym"><SUP>2</SUP></A>
+version from MySQL named “connector/J”. </FONT>
+</P>
+<H2><FONT FACE="Albany"><FONT SIZE=4>1.1 The driver page in detail</FONT></FONT></H2>
+<P ALIGN=JUSTIFY><IMG SRC="./MySQL_data_source_page_html_17ee6536.gif" NAME="Rahmen1" ALT="Rahmen1" ALIGN=LEFT HSPACE=8 VSPACE=8><BR CLEAR=LEFT><FONT FACE="Thorndale">In
+the first group box the user can select which kind of connection he
+would like to use. Either an existing ODBC data source which must be
+defined in the used system or to connect to the database via the JDBC
+interface. To allow the user to specify different driver classes, an
+extra edit field is enabled when the JDBC was selected, where the
+name of the driver class can be inserted<A CLASS="sdfootnoteanc" NAME="sdfootnote3anc" HREF="#sdfootnote3sym"><SUP>3</SUP></A>.
+In the second group box information about the data source, the user
+name, if a password is required and which character set the MySQL
+server should use, can be defined. The URL field contains different
+meaning depending on the type of connection. In the case of ODBC, it
+contains the name of the ODBC data source; in the case of JDBC it
+contains the host name, a port number and the database name. To give
+the user a hint, the URL field will contain a default value for a
+JDBC kind of connection, where the user has to substitute only the
+fields in the brackets.</FONT></P>
+<H2><FONT FACE="Albany"><FONT SIZE=4>1.2 String List</FONT></FONT></H2>
+<TABLE WIDTH=100% BORDER=1 CELLPADDING=4 CELLSPACING=0>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <COL WIDTH=85*>
+ <THEAD>
+ <TR VALIGN=TOP>
+ <TH WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>String</FONT></FONT></TH>
+ <TH WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>German translation</FONT></FONT></TH>
+ <TH WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>comment</FONT></FONT></TH>
+ </TR>
+ </THEAD>
+ <TBODY>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Type of connection</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>Art der Verbindung</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Fixed line;
+ Separates the kind of connection from the general information. No
+ mnemonic necessary.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Use existing
+ My~ODBC data source</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>Existierende My~ODBC
+ Datenquelle verwenden</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Radio button
+ label; Will be marked by the user when he wants to use an
+ existing ODBC system data source. “MyODBC” is product
+ name and not to translate.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Use Connector/~J3</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Connector/~J3
+ verwenden</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Radio button
+ label; Connector/J3 is the JDBC driver from MySQL. Do not
+ translate or change “Connector/J3”-- it is a product
+ name.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>MySQL JDBC d~river
+ class</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>MySQL JDBC
+ ~Treiberklasse</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>The label for the
+ edit (text box), where the user can insert the JDBC driver class
+ for MySQL</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>General</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Allgemein</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Fixed line; A
+ separator. No mnemonic necessary.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>~Data source URL</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>D~atenquellen-URL</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Text box label;
+ The url for the connection.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>~User name</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>~Benutzername</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Text box label;
+ The user name needed to connect to the database.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Password r~equired</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Kennwort
+ ~erforderlich</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Check box label;
+ Indicates that a password is needed to connect to the database.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>~Character set</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>~Zeichensatz</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Text box label;
+ The character set.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2><host>:<3306>/<DBNAME></FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2><Rechnername>:<3306>/<DBNAME></FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>String; will be
+ inserted into the URL field when choosing the Connector/J3 to
+ give the user a clue about what is needed.</FONT></FONT></TD>
+ </TR>
+ <TR VALIGN=TOP>
+ <TH WIDTH=33%>
+ <P><BR>
+ </TH>
+ <TH WIDTH=33%>
+ <P><FONT FACE="Albany"><FONT SIZE=2>General Page</FONT></FONT></TH>
+ <TH WIDTH=33%>
+ <P><BR>
+ </TH>
+ </TR>
+ <TR VALIGN=TOP>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>To adjust the
+ settings, go to the MySQL tab page.</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>Wechseln Sie zur
+ MySQL-Registerseite um die Einstellungen vorzunehmen.</FONT></FONT></TD>
+ <TD WIDTH=33%>
+ <P ALIGN=LEFT><FONT FACE="Albany"><FONT SIZE=2>This text will be
+ shown on the general page when the type MySQL is selected.</FONT></FONT></TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<P ALIGN=JUSTIFY><BR><BR>
+</P>
+<DIV ID="sdfootnote1">
+ <P><FONT FACE="Thorndale"><FONT SIZE=2><A CLASS="sdfootnotesym" NAME="sdfootnote1sym" HREF="#sdfootnote1anc">1</A>Open
+ database connectivity</FONT></FONT></DIV>
+<DIV ID="sdfootnote2">
+ <P><FONT FACE="Thorndale"><FONT SIZE=2><A CLASS="sdfootnotesym" NAME="sdfootnote2sym" HREF="#sdfootnote2anc">2</A>Java
+ database connectivity</FONT></FONT></DIV>
+<DIV ID="sdfootnote3">
+ <P><FONT FACE="Thorndale"><FONT SIZE=2><A CLASS="sdfootnotesym" NAME="sdfootnote3sym" HREF="#sdfootnote3anc">3</A>The
+ driver class will be searched for in the jar files which can be
+ added under tools->options->Security.</FONT></FONT></DIV>
+</body>
+</HTML>
diff --git a/content/dba/specifications/address_book_architecture.html b/content/dba/specifications/address_book_architecture.html
new file mode 100644
index 0000000..7c66074
--- /dev/null
+++ b/content/dba/specifications/address_book_architecture.html
@@ -0,0 +1,1100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Architecture Overview OpenOffice.org Address Book Integration</title>
+</head>
+<body>
+<h1><a name="mozTocId548490" class="mozTocH1"></a>Architecture Overview
+OpenOffice.org Address Book Integration</h1>
+<ol id="mozToc">
+<!--mozToc h1 1 h2 2 h3 3 h4 4 h5 5 h6 6--><li><a href="#mozTocId548490">Architecture
+Overview OpenOffice.org Address Book Integration</a>
+ <ol>
+ <li><a href="#mozTocId858361">Introduction</a></li>
+ <li><a href="#mozTocId175483"> Background</a></li>
+ <li><a href="#mozTocId347884">Glossary</a></li>
+ <li><a href="#mozTocId900549">Supported Address Books</a></li>
+ <li><a href="#mozTocId785983">Architecture</a></li>
+ <li><a href="#mozTocId689331">References</a></li>
+ <li><a href="#mozTocId343804">Appendix - Mozilla files included
+in OpenOffice.org distribution</a><br>
+ </li>
+ </ol>
+ </li>
+</ol>
+<h2><a name="mozTocId858361" class="mozTocH2"></a>Introduction</h2>
+This document aims to provide an overview of the technologies related
+to the integration of the address-book feature into OpenOffice.org and
+Mozilla, a summary of the address-book types supported and their
+respective underlying API's, and an architecture diagram that shows the
+shared and unique parts distributed with OpenOffice.org and Mozilla. An
+appendix lists the Mozilla files installed automatically by
+OpenOffice.org, including platform variations.<br>
+<br>
+Note: The abbreviation AB in this document is used as a shorthand for
+"address-book".<br>
+<h2><a name="mozTocId175483" class="mozTocH2"></a><br>
+Background</h2>
+<p><a href="http://www.openoffice.org/"><b>OpenOffice.org</b></a> has
+it's own open database access API called <b>SDBC</b> (<b>S</b>un <b>D</b>ata<b>B</b>ase<b>C</b>onnectivity)
+which is modeled on the architecture of Java's JDBC. SDBC supports
+several databases and database-like API's via an extensible provider
+architecture; ODBC 3.0, JDBC, ADO, dBase and CSV are among the
+databases and database management systems supported. Each SDBC
+provider is implemented as a <b>UNO</b> component; UNO is <a
+ href="http://udk.openoffice.org/common/man/uno.html">OpenOffice.org's
+ component technology</a>.</p>
+
+<p style="margin-bottom: 0.1cm;"><b>Mail</b> applications such as
+Mozilla Messenger and Microsoft Outlook often have a local
+address-book (contacts) database, as well as enterprise LDAP-based
+directory access which is often used as a shared address-book.
+Mozilla extensions are implemented as XPCOM components; XPCOM is
+Mozilla's <a href="http://www.mozilla.org/projects/xpcom/">cross-platform
+ ("XP") component (object model) technology</a>.</p>
+
+<h2><a name="mozTocId347884" class="mozTocH2"></a>Glossary</h2>
+<ul>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>Mozilla</b> - the
+open-source project and distribution of the Netscape browser</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>AbZilla</b> - the
+address-book project for Mozilla</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>XPCOM</b> - an abbreviation
+of "cross-platform component object model", XPCOM is Mozilla's
+in-process component middleware technology</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>UNO</b> - OpenOffice.org's
+distributed cross-platform component object model</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>SDBC</b> - <b>S</b>un <b>D</b>ata<b>B</b>ase<b>C</b>onnectivity</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>JDBC</b> - Java's extensible
+database API</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>Outlook</b> - the
+full-function licensed version of the Microsoft Outlook Express mail
+client, including group-calendaring and peer-to-peer workflow</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>Outlook Express</b> - a
+cut-down mail client based on Microsoft Outlook and bundled with
+Microsoft Internet Explorer; replaces the MS Mail client</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>WAB</b> - MS <b>W</b>indows <b>A</b>ddress<b>B</b>ook
+files (.wab)</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>PAB</b> - MS Exchange® <b>P</b>ersonal<b>A</b>ddress<b>B</b>ook</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>CSV</b> - <b>C</b>omma-<b>S</b>eparated<b>V</b>alues,
+a generic exchange format for table or other repeating lists of
+attribute values</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>COM</b> - Common Object
+Model, Microsoft's simple object component technology</p>
+ </li>
+ <li>
+ <p><b>MAPI</b> - a traditional C API for full-function
+messaging, calendaring and address-book</p>
+ </li>
+</ul>
+<h2><a name="mozTocId900549" class="mozTocH2"></a>Supported Address
+Books</h2>
+Several address-book types are supported. Each source is accessed via
+an XPCOM provider component, but this in turn uses a specific
+address-book API as shown in the following table. The address-books
+shown in bold are available on all Mozilla platforms, the other
+address-books are only supported on Windows.<br>
+<br>
+<table style="text-align: left; width: 100%;" border="1" cellspacing="0"
+ cellpadding="0">
+ <tbody>
+ <tr>
+ <td style="vertical-align: top; font-weight: bold;" width="120">Mail
+Client<br>
+ </td>
+ <td style="vertical-align: top; font-weight: bold; width: 400px;">Address
+Book Type<br>
+ </td>
+ <td style="vertical-align: top; font-weight: bold;">API<br>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;" width="120">Any<br>
+ </td>
+ <td style="vertical-align: top;">LDAP<br>
+ </td>
+ <td style="vertical-align: top;">Mozilla's LDAP XPCOM component<br>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;" width="120">Mozilla<br>
+ </td>
+ <td style="vertical-align: top;">Local address book<br>
+ </td>
+ <td style="vertical-align: top;">Mozilla address-book XPCOM
+component<br>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;" width="120">Outlook<br>
+ </td>
+ <td style="vertical-align: top;">Outlook Personal Address Book
+(PAB)<br>
+ </td>
+ <td style="vertical-align: top;">MAPI<br>
+ </td>
+ </tr>
+ <tr>
+ <td style="vertical-align: top;" width="120">Outlook Express / MS
+Mail<br>
+ </td>
+ <td style="vertical-align: top;">Windows Address Book (WAB)<br>
+ </td>
+ <td style="vertical-align: top;">WAB API<br>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<br>
+<h2><a name="mozTocId785983" class="mozTocH2"></a>Architecture</h2>
+<p>As noted above, it was decided to provide open address-book
+access for both Mozilla's mail client and OpenOffice.org SDBC using a
+common set of components. Since the integration of new features into
+Mozilla is achieved using XPCOM, it was decided to develop an adaptor
+for Outlook and Outlook Express address-books and expose the adaptor
+ using an XPCOM API, and also to support LDAP address-books via an
+ existing XPCOM LDAP component.</p>
+
+<p>OpenOffice.org makes extensive use of it's own UNO object
+component technology. Similar to the address-book <b>XPCOM</b>
+component-based provider architecture devised for Mozilla, the SDBC
+architecture supports providers for many different data sources with
+each new source having its own adaptor <b>UNO</b> component. To
+integrate the AbZilla address-book components into OpenOffice.org, an
+ address-book data-source must be exposed via a UNO component.</p>
+
+<p>The architecture chosen was to implement the address-book
+providers principally using XPCOM to achieve Mozilla integration.
+These XPCOM interfaces are then wrapped with a private C++ API which
+is in turn exposed to OpenOffice.org via a UNO interface adaptor.
+This architecture is summarized in the following diagram:</p>
+ <img src="ab_architecture.gif" title="" alt="architecture overview"
+ style="width: 623px; height: 705px;"><br>
+<p align="center" style="margin-bottom: 0cm;">Figure 1: <b>OpenOffice.org
+and Mozila, on a common address-book architecture</b></p>
+
+<p><br>
+<br>
+ </p>
+
+<p>OpenOffice.org ships two <b>libraries</b> that expose the Mozilla
+address-book functionality to OpenOffice.org's SDBC framework:</p>
+
+<ul>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>libmozab2.so</b> which
+implements a UNO-based SDBC provider and uses a (private) C++ API
+provided by libmozabdrv2.so</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>libmozabdrv2.so</b> which
+exposes a (private) C++ API and uses the AbZila address-book
+XPCOM-based components (and indirectly uses XPCOM and it's
+dependencies)</p>
+ </li>
+</ul>
+
+<p>Since the PAB, WAB Moz-AB and Moz-LDAP address-book providers
+expose XPCOM API's, the core XPCOM infrastructure and related
+dependencies are required to use them.</p>
+
+<p>For OpenOffice.org to make use of the AbZilla XPCOM-based
+address-book components, OpenOffice.org now ships with a total 50
+Mozilla files, comprising:</p>
+
+<ul>
+ <li>
+ <p style="margin-bottom: 0.2cm;">the essential libraries that
+implement Mozilla's XPCOM technology</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;">configuration files</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;">some other dependent libraries
+including JavaScript to access XPCOM's configuration</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;">the library containing the
+four specific address-book related XPCOM components (PAB, WAB,
+Mozilla AB, and Mozilla LDAP)</p>
+ </li>
+</ul>
+
+<p>The Mozilla libraries shipped with OpenOffice.org are not
+entirely built from the normal Mozilla CVS trunk as some required bug
+fixes developed by the project team have not yet been accepted into
+the standard Mozilla build. These fixes are listed within a summary
+bug report at <a
+ href="http://www.openoffice.org/issues/show_bug.cgi?id=8239">http://www.openoffice.org/issues/show_bug.cgi?id=8239</a>.
+ If these fixes were integrated into Mozilla, it would be possible
+ for OpenOffice.org to use the dependent files from a standard
+ Mozilla installation by pointing a Mozilla environment variable at
+ the Mozilla distribution, but as Mozilla is not completely bundled
+ nor can it be assumed to be pre-installed, the Mozilla
+ dependencies are distrbuted with (and installed by) OpenOffice.org.</p>
+
+<h2><a name="mozTocId689331" class="mozTocH2"></a>References</h2>
+<ul>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>AbZilla</b>, the Mozilla
+address-book project - <a href="http://abzilla.mozdev.org/">http://abzilla.mozdev.org</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>SDBC</b>, OpenOffice.org's
+database access framework - http:<a
+ href="http://staroffice-doc.germany.sun.com:8080/">//dba.openoffice.org/</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>XPCOM</b>, Mozilla's object
+component technology - <a
+ href="http://www.mozilla.org/projects/xpcom">http://www.mozilla.org/projects/xpcom</a>
+ </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0.2cm;"><b>UNO</b>, OpenOffice.org's
+object component technology - http:<a
+ href="http://staroffice-doc.germany.sun.com:8080/">//udk.openoffice.org/</a>
+ </p>
+ </li>
+ <li>
+ <p><b>MAPI</b>, Windows Messaging API - <a
+ href="http://msdn.microsoft.com/library/?url=/library/en-us/mapi/html/_mapi1book_legal_information_2.asp?frame=true">http://msdn.microsoft.com/library/?url=/library/en-us/mapi/html/_mapi1book_legal_information_2.asp?frame=true</a>
+ </p>
+ </li>
+</ul>
+<p> </p>
+<h2><a name="mozTocId343804" class="mozTocH2"></a>Appendix - Mozilla
+files included in OpenOffice.org distribution</h2>
+<br>
+<table cellpadding="0" cellspacing="0" ID="Table1">
+ <tbody>
+ <tr>
+ <td colspan="2" width="7%"> <b>Size (bytes, on Solaris)</b> </td>
+ <td width="21%"> <b>Filename</b> </td>
+ <td colspan="2" width="8%"> <b>Solaris (Sparc and Intel)</b> </td>
+ <td colspan="2" width="8%"> <b>Linux</b> </td>
+ <td width="8%"> <b>Win32</b> </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="222898" sdnum="1031;"> 222898 </td>
+ <td width="21%"> component.reg </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/addrbook.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="1247464" sdnum="1031;"> 1247464 </td>
+ <td width="21%"> components/libaddrbook.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="633624" sdnum="1031;"> 633624 </td>
+ <td width="21%"> components/libmork.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="186160" sdnum="1031;"> 186160 </td>
+ <td width="21%"> components/libmozldap.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="1957760" sdnum="1031;"> 1957760 </td>
+ <td width="21%"> components/libnecko.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="195712" sdnum="1031;"> 195712 </td>
+ <td width="21%"> components/libpref.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="221204" sdnum="1031;"> 221204 </td>
+ <td width="21%"> components/libprofile.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="513568" sdnum="1031;"> 513568 </td>
+ <td width="21%"> components/librdf.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="75776" sdnum="1031;"> 75776 </td>
+ <td width="21%"> components/libstrres.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="271228" sdnum="1031;"> 271228 </td>
+ <td width="21%"> components/libuconv.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="193132" sdnum="1031;"> 193132 </td>
+ <td width="21%"> components/libucvcn.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="123644" sdnum="1031;"> 123644 </td>
+ <td width="21%"> components/libucvibm.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="264368" sdnum="1031;"> 264368 </td>
+ <td width="21%"> components/libucvja.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="202092" sdnum="1031;"> 202092 </td>
+ <td width="21%"> components/libucvko.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="753456" sdnum="1031;"> 753456 </td>
+ <td width="21%"> components/libucvlatin.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="187316" sdnum="1031;"> 187316 </td>
+ <td width="21%"> components/libucvtw.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="257652" sdnum="1031;"> 257652 </td>
+ <td width="21%"> components/libucvtw2.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="82180" sdnum="1031;"> 82180 </td>
+ <td width="21%"> components/libunicharutil.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="303864" sdnum="1031;"> 303864 </td>
+ <td width="21%"> components/liburiloader.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="112548" sdnum="1031;"> 112548 </td>
+ <td width="21%"> components/libvcard.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="744852" sdnum="1031;"> 744852 </td>
+ <td width="21%"> components/libxpconnect.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/mork.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/mozldap.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/necko.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="524" sdnum="1031;"> 524 </td>
+ <td width="21%"> components/necko_dns.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/profile.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/rdf.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/strres.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucharuti.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/uconv.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvcn.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvibm.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvja.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvko.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvlatin.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvtw.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/ucvtw2.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/urildr.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/vcard.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/xpc3250.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2212" sdnum="1031;"> 2212 </td>
+ <td width="21%"> components/xpcom_base.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="5103" sdnum="1031;"> 5103 </td>
+ <td width="21%"> components/xpcom_components.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="7890" sdnum="1031;"> 7890 </td>
+ <td width="21%"> components/xpcom_ds.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="7806" sdnum="1031;"> 7806 </td>
+ <td width="21%"> components/xpcom_io.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/xpcom_thread.xpt </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2513" sdnum="1031;"> 2513 </td>
+ <td width="21%"> components/xpcom_threads.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="1560" sdnum="1031;"> 1560 </td>
+ <td width="21%"> components/xpcom_xpti.xpt </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> components/xppref32.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="8698" sdnum="1031;"> 8698 </td>
+ <td width="21%"> components/xpti.dat </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="8698" sdnum="1031;"> 8698 </td>
+ <td width="21%"> components/xptitemp.dat </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="32621" sdnum="1031;"> 32621 </td>
+ <td width="21%"> defaults/pref/all.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2096" sdnum="1031;"> 2096 </td>
+ <td width="21%"> defaults/pref/config.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="3590" sdnum="1031;"> 3590 </td>
+ <td width="21%"> defaults/pref/editor.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2668" sdnum="1031;"> 2668 </td>
+ <td width="21%"> defaults/pref/initpref.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2039" sdnum="1031;"> 2039 </td>
+ <td width="21%"> defaults/pref/inspector.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="20741" sdnum="1031;"> 20741 </td>
+ <td width="21%"> defaults/pref/mailnews.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> defaults/pref/mdn.js </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="1373" sdnum="1031;"> 1373 </td>
+ <td width="21%"> defaults/pref/security-prefs.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="14394" sdnum="1031;"> 14394 </td>
+ <td width="21%"> defaults/pref/unix.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> defaults/pref/winpref.js </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="219" sdnum="1031;"> 219 </td>
+ <td width="21%"> defaults/pref/xpinstall.js </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> js3250.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="352592" sdnum="1031;"> 352592 </td>
+ <td width="21%"> libldap50.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="745248" sdnum="1031;"> 745248 </td>
+ <td width="21%"> libmozjs.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="103388" sdnum="1031;"> 103388 </td>
+ <td width="21%"> libmozz.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="654092" sdnum="1031;"> 654092 </td>
+ <td width="21%"> libmsgbaseutil.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="370240" sdnum="1031;"> 370240 </td>
+ <td width="21%"> libnspr4.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="36592" sdnum="1031;"> 36592 </td>
+ <td width="21%"> libplc4.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="14432" sdnum="1031;"> 14432 </td>
+ <td width="21%"> libplds4.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="29284" sdnum="1031;"> 29284 </td>
+ <td width="21%"> libprldap50.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="2221260" sdnum="1031;"> 2221260 </td>
+ <td width="21%"> libxpcom.so </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> + </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> mozreg.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> msgbsutl.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> nsldap32v50.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> nsldappr32v50.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> nspr4.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> nsreg.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> plc4.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> plds4.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%" sdval="10244" sdnum="1031;"> 10244 </td>
+ <td width="21%"> res/charsetalias.properties </td>
+ <td colspan="2" width="8%"> + </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> - </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> xpcom.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2" width="7%"> <br>
+ </td>
+ <td width="21%"> zlib.dll </td>
+ <td colspan="2" width="8%"> - </td>
+ <td colspan="2" width="8%"> - </td>
+ <td width="8%"> + </td>
+ <td width="48%"> <br>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<br>
+<hr style="width: 100%; height: 2px;">
+<div style="text-align: right;">Author: <a
+ href="mailto:ColmS@openoffice.org">Colm Smyth</a><br>
+Last Modified: $Date: 2003/12/16 07:41:48 $<br>
+Copyright © 2002 OpenOffice.org<br>
+</div>
+<font color="#ffffff"></font>
+</body>
+</html>
diff --git a/content/dba/specifications/character_sets.html b/content/dba/specifications/character_sets.html
new file mode 100644
index 0000000..0f92017
--- /dev/null
+++ b/content/dba/specifications/character_sets.html
@@ -0,0 +1,105 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>Data Sources Character Sets - Functional Spec</title>
+</head>
+<body>
+<div style="text-align: center;"><font size="+3"><span
+ style="font-weight: bold;">Data Sources Character Sets<br>
+<span style="font-style: italic;"><span style="font-weight: bold;"><font
+ size="+1">Functional Specification<br>
+</font></span></span></span></font>
+<div style="text-align: left;">
+<h2>Content</h2>
+<div style="margin-left: 40px;"><a href="#abstract">Abstract<br>
+</a><a href="#functional">Functional Description</a><br>
+</div>
+<h2><a name="abstract"></a>Abstract</h2>
+OpenOffice.org, Unicode-enabled itself, allows to access non-Unicode
+(8-Bit) databases. Thus when transfering string data from connections
+to such databases, OOo must convert the data into UniCode. For this,
+the user can specify which character set to use for this conversion.<br>
+<h2><a name="functional"></a>Functional Description</h2>
+<ul>
+ <li>
+ <p><font face="arial, sans-serif" size="2">Character sets are
+specified per data source. This means that in the data source
+ administration dialog, there is an option where the user chooses
+ a character set to use for every connection created for a data
+ source.</font></p>
+ </li>
+ <li>
+ <p><font face="arial, sans-serif" size="2">The Character Sets
+setting is available for the following data source types: Adabas,
+ODBC, dBase, Text, MySQL (when adapted via ODBC, see the <a
+ href="../specifications/MySQL_data_source_page.html">MySQL
+spec</a>)</font></p>
+ </li>
+ <li>
+ <p><font size="2" face="arial, sans-serif">In general (with on
+exception, see below), only character sets which are part of the
+respective <a href="http://www.iana.org/assignments/character-sets">IANA-standard</a>
+ can be supported by StarOffice. The reason for this is that
+ character sets need to be transported via UNO, and instead of
+ defining an own standard for naming them, we decided to use the
+ most comprehensive standard available - IANA.</font></p>
+ </li>
+ <li>
+ <p><font face="arial, sans-serif" size="2">OpenOffice.org
+ versions up to 1.0.x supported only a very limited set of
+ character sets, namely windows-1252, macintosh, IBMPC 437,
+ ~850,~860,~861,~863,~865,~866, UTF-8 and Big5-HKSCS.</font></p>
+ </li>
+</ul>
+
+<ul>
+ <p>Since OpenOffice.org 1.1, this list has been extended. For
+ compatibility reasons, the encodings above form the very minimal
+ set of required encodings.</p>
+ <p><font face="arial, sans-serif" size="2"><i>Nowadays, OOo data
+sources support every encoding which is known to OOo in general,
+and which is a valid IANA name. This list is much too large to cite
+it here completely, and it can be extended in the future without
+further notice.</i></font></p>
+ <li>
+ <p style="font-style: normal;"><font face="arial, sans-serif"
+ size="2">The display names of the character sets are the usual
+names as used in other places, too (for instance
+"Tools/Options/Load/Save/HTML compatibility/Character Set").</font></p>
+ </li>
+ <li>
+ <p style="font-style: normal;"><font face="arial, sans-serif"
+ size="2">There is one "virtual" character set named "System".
+ Choosing this just means that the current system character set is
+ used, so the user does not need to care for an explicit setting.
+ This is the default when creating new data sources. For Text and
+ dBase data sources, all text encodings which do not have a
+ constant character size are forbidden. For instance, UTF-8 uses a
+ different number of bytes to code different characters – thus
+UTF-8 and all character sets with the same characteristics are not
+allowed for dBase and Text.</font></p>
+ </li>
+ <li>
+ <p style="font-style: normal;"><font face="arial, sans-serif"
+ size="2">Consider a character set which, in the current
+environment or for the current data source type, is not available.
+First, this means that the list box for selecting the character sets
+does not display it. If, however, the user changed the character set
+for a data source by other means than our UI, then we fallback to
+ “System encoding”, means instead of the invalid encoding
+“System” is displayed.</font></p>
+ </li>
+</ul>
+<font size="+3"><span style="font-weight: bold;"><span
+ style="font-style: italic;"><span style="font-weight: bold;"></span></span></span></font><br>
+<hr style="width: 100%; height: 1px;">Author: <a
+ href="mailto:fs@openoffice.org">Frank Schönheit</a><br>
+Last Modified: $Date: 2003/07/08 07:21:39 $<br>
+<span style="font-style: italic;">Copyright © 2001-2003
+OpenOffice.org</span><font size="+3"><span style="font-weight: bold;"><span
+ style="font-style: italic;"><span style="font-weight: bold;"></span></span></span></font></div>
+</div>
+</body>
+</html>
diff --git a/content/dba/specifications/file_based_functions.html b/content/dba/specifications/file_based_functions.html
new file mode 100644
index 0000000..139a954
--- /dev/null
+++ b/content/dba/specifications/file_based_functions.html
@@ -0,0 +1,210 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+ <title>SQL functions for file based database drivers</title>
+</head>
+<body>
+<div style="text-align: center;"><font size="+3">SQL Functions for file
+based database drivers<br>
+</font></div>
+<div style="text-align: center;"><font size="+1"><span
+ style="font-style: italic; font-weight: bold;">Feature Specification<br>
+</span></font>
+<div style="text-align: left;">
+<h3><font size="+1">Content</font></h3>
+ <a href="#abstract">Abstract</a><br>
+ <a href="#functional">Functional Description</a><br>
+<h3><a name="abstract"></a>Abstract</h3>
+The current file based database drivers in OOo 1.0-1.1 (dBase, flat
+file, and spreadsheet) dosn't support any SQL functions. Neither string,
+date nor numeric functions. In the new version OOo 2.0 these drivers
+will support the following functions.<br>
+<h3><a name="functional"></a>Functional description</h3>
+<h1><font face="arial, sans-serif"><font size="2">String functions</font></font></h1>
+<ul>
+ <li>
+ <p><font face="arial, sans-serif"><font size="2">UCASE(str)<br>
+UPPER(str)<br>
+Returns the string str with all characters changed to uppercase
+according to the ascii </font></font><font size="2"><font
+ face="arial, sans-serif">character set </font></font><font
+ face="arial, sans-serif"><font size="2">mapping.<br>
+ </font></font></p>
+ </li>
+ <li>
+ <p><font size="2"><font face="arial, sans-serif">LCASE(str)<br>
+LOWER(str)<br>
+Returns the string str with all characters changed to lowercase
+according to the ascii character set mapping.<br>
+ </font></font></p>
+ </li>
+ <li>
+ <p><font face="arial, sans-serif"><font size="2">ASCII(str)<br>
+Returns the ASCII code value of the leftmost character of the string
+str. Returns 0 if str is the empty string. Returns NULL if str is NULL:</font></font></p>
+ </li>
+ <li><font face="arial, sans-serif"><font size="2">LENGTH(str)<br>
+OCTET_LENGTH(str)<br>
+CHAR_LENGTH(str)<br>
+CHARACTER_LENGTH(str)<br>
+Returns the length of the string str:</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">CHAR(N,...)<br>
+CHAR() interprets the arguments as integers and returns a string
+consisting of the characters given by the ASCII code values of those
+integers. NULL values are skipped:</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">CONCAT(str1,str2,...)<br>
+Returns the string that results from concatenating the arguments.
+Returns NULL if any argument is NULL. May have more than 2 arguments. A
+numeric argument is converted to the equivalent string form.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LOCATE(substr,str)<br>
+Returns the position of the first occurrence of substring substr in
+string str. Returns 0 if substr is not in str.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SUBSTRING(str,pos)<br>
+Returns a substring from string str starting at position pos.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SUBSTRING(str,pos,len)<br>
+SUBSTRING(str FROM pos FOR len)<br>
+Returns a substring len characters long from string str, starting at
+position pos. The variant form that uses FROM is SQL-92 syntax.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LTRIM(str)<br>
+Returns the string str with leading space characters removed.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">RTRIM(str)<br>
+Returns the string str with trailing space characters removed.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SPACE(N)<br>
+Returns a string consisting of N space characters.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">REPLACE(str,from_str,to_str)<br>
+Returns the string str with all occurrences of the string from_str
+replaced by the string to_str.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">REPEAT(str,count)<br>
+Returns a string consisting of the string str repeated count times. If
+count <= 0, returns an empty string. Returns NULL if str or count are
+NULL.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">INSERT(str,pos,len,newstr)<br>
+Returns the string str, with the substring beginning at position pos
+and len characters long replaced by the string newstr.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LEFT(str,len)<br>
+Returns the leftmost len characters from the string str.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">RIGHT(str,len)<br>
+Returns the rightmost len characters from the string str.</font></font></li>
+</ul>
+<h1><font face="arial, sans-serif"><font size="2">Numeric fucntions</font></font></h1>
+<ul>
+ <li><font face="arial, sans-serif"><font size="2">ABS(X)<br>
+Returns the absolute value of X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SIGN(X)<br>
+Returns the sign of the argument as -1, 0, or 1, depending on whether X
+is negative, zero, or positive.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">MOD(N,M)<br>
+Modulo (like the % operator in C). Returns the remainder of N divided
+by M.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">FLOOR(X)<br>
+Returns the largest integer value not greater than X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">CEILING(X)<br>
+Returns the smallest integer value not less than X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">ROUND(X)<br>
+ROUND(X,D)<br>
+Returns the argument X, rounded to the nearest integer. With two
+arguments rounded to a number to D decimals.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">EXP(X)<br>
+Returns the value of e (the base of natural logarithms) raised to the
+power of X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LN(X)<br>
+Returns the natural logarithm of X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LOG(X)<br>
+LOG(B,X)<br>
+If called with one parameter, this function returns the natural
+logarithm of X. If called with two parameters, this function returns the
+logarithm of X for an arbitary base B.<br>
+ </font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">LOG10(X)<br>
+Returns the base-10 logarithm of X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">POWER(X,Y)<br>
+Returns the value of X raised to the power of Y.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SQRT(X)<br>
+Returns the non-negative square root of X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">PI()<br>
+Returns the value of PI.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">COS(X)<br>
+Returns the cosine of X, where X is given in radians.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SIN(X)<br>
+Returns the sine of X, where X is given in radians.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">TAN(X)<br>
+Returns the tangent of X, where X is given in radians.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">ACOS(X)<br>
+Returns the arc cosine of X, that is, the value whose cosine is X.
+Returns NULL if X is not in the range -1 to 1.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">ASIN(X)<br>
+Returns the arc sine of X, that is, the value whose sine is X. Returns
+NULL if X is not in the range -1 to 1.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">ATAN(X)<br>
+Returns the arc tangent of X, that is, the value whose tangent is X.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">ATAN2(Y,X)<br>
+Returns the arc tangent of the two variables X and Y. It is similar to
+calculating the arc tangent of Y / X, except that the signs of both
+arguments are used to determine the quadrant of the result.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">DEGREES(X)<br>
+Returns the argument X, converted from radians to degrees.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">RADIANS(X)<br>
+Returns the argument X, converted from degrees to radians.</font></font></li>
+</ul>
+<h1><font face="arial, sans-serif"><font size="2">DateTime functions</font></font></h1>
+<ul>
+ <li><font face="arial, sans-serif"><font size="2">DAYOFWEEK(date)<br>
+Returns the weekday index for date (1 = Sunday, 2 = Monday, ... 7 =
+Saturday). These index values correspond to the ODBC standard.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">DAYOFMONTH(date)<br>
+Returns the day of the month for date, in the range 1 to 31.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">DAYOFYEAR(date)<br>
+Returns the day of the year for date, in the range 1 to 366.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">MONTH(date)<br>
+Returns the month for date, in the range 1 to 12.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">DAYNAME(date)<br>
+Returns the name of the weekday for date.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">MONTHNAME(date)<br>
+Returns the name of the month for date.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">QUARTER(date)<br>
+Returns the quarter of the year for date, in the range 1 to 4.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">WEEK(date)<br>
+WEEK(date,first)<br>
+With a single argument, returns the week for date, in the range 0 to 53
+(yes, there may be the beginnings of a week 53), for locations where
+Sunday is the first day of the week. The two-argument form of WEEK()
+allows you to specify whether the week starts on Sunday or Monday and
+whether the return value should be in the range 0-53 or 1-52. Here is a
+table for how the second argument works:<br>
+
+ Value Meaning<br>
+
+ 0 Week starts on Sunday and return
+value is in range 0-53<br>
+
+ 1 Week starts on Monday and return
+value is in range 0-53</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">YEAR(date)<br>
+Returns the year for date.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">HOUR(time)<br>
+Returns the hour for time, in the range 0 to 23.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">MINUTE(time)<br>
+Returns the minute for time, in the range 0 to 59.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">SECOND(time)<br>
+Returns the second for time, in the range 0 to 59.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">CURDATE()<br>
+Returns today's date as a value in 'YYYY-MM-DD' or YYYYMMDD format,
+depending on whether the function is used in a string or numeric context.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">CURTIME()<br>
+Returns the current time as a value in 'HH:MM:SS' or HHMMSS format,
+depending on whether the function is used in a string or numeric context.</font></font></li>
+ <li><font face="arial, sans-serif"><font size="2">NOW()<br>
+Returns the current date and time as a value in 'YYYY-MM-DD HH:MM:SS'
+or YYYYMMDDHHMMSS format, depending on whether the function is used in a
+string or numeric context.</font></font></li>
+</ul>
+<br>
+<hr style="width: 100%; height: 1px;"> Author: Ocke.Janssen<br>
+Last Modified: $Date: 2003/07/08 07:21:39 $<br>
+<span style="font-style: italic;">Copyright © 2003 OpenOffice.org</span><br>
+<font size="+1"><span style="font-style: italic; font-weight: bold;"></span></font></div>
+</div>
+</body>
+</html>
diff --git a/content/dba/specifications/index.html b/content/dba/specifications/index.html
new file mode 100644
index 0000000..07159b6
--- /dev/null
+++ b/content/dba/specifications/index.html
@@ -0,0 +1,610 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <title>OpenOffice.org Database Specifications</title>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+ <meta http-equiv="Content-Style-Type" content="text/css">
+ <style type="text/css"> @import "/css/dba.css"; .available_in_1x_not_used { background-color:#CCFFCC; }
+ .available_in_20_not_used { background-color:#CCFFFF; }
+ .available_in_204_not_used { background-color:#CCFFFF; }
+ .available_in_680_not_used { background-color:#FFFFCC; }
+ </style>
+ <script type="text/javascript" src="/js/dba_default.js"></script>
+ </head>
+ <body>
+ <div id="dba_menu_bar">
+ <b>Project Sections</b>: <a href="../index.html">Home</a> | <a href="../specifications/index.html" class="selected">
+ <b>Specifications</b></a> | <a href="../QA/index.html">QA</a> | <a href="../development/index.html">
+ Development</a> | <a href="../drivers/index.html">Database Drivers</a><br>
+ </div>
+ <hr>
+ <div class="dba">
+ <h1 id="dba_specifications">OpenOffice.org Base - Specifications</h1>
+ </div>
+ <div class="dba_light">
+ <table cellpadding="0" cellspacing="0" width="100%">
+ <tbody>
+ <tr class="MainTableHeader">
+ <td colspan="2">Most recently added or changed specifications:</td>
+ </tr>
+ <tr>
+ <td>
+ <UL>
+ <LI>
+ 2007-11-12: <A href="#application">Data Source
+ Property dialog</A>: added new database type for Microsoft Access 2007
+ <LI>
+ 2007-11-06: <A href="#application">Functions property browser</A>:
+ extension of the report property browser to create report functions
+ <LI>
+ 2007-11-06: <A href="#application">Data Source Property dialog</A>: added option 'Ignore currency field information' to the
+ 'Special Settings' page</LI></UL>
+ </td>
+ <td>
+ <tr class="MainTableHeader">
+ <td>Sections</td>
+ <td>Legend</td>
+ </tr>
+ <tr>
+ <td>
+ <ul>
+ <li>
+ <a href="#application">Database Application</a>
+ <li>
+ <a href="#wizards">Wizards</a>
+ <li>
+ <a href="#architecture">Architecture</a>
+ <li>
+ <a href="#core_functionality">Database Driver Core Functionality</a>
+ <li>
+ <a href="#forms">Forms and Form Controls</a>
+ <li>
+ <a href="#misc">Miscellaneous</a>
+ </li>
+ </ul>
+ </td>
+ <td width="300">
+ <b>V</b>: Document version<br>
+ <b>A</b>: OpenOffice.org version in which the functionality described in this
+ document is/will be available.<br>
+ <b>D</b>: Date of the last change to the document<br>
+ <b>T</b>: Document type
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <table cellpadding="0" cellspacing="0">
+ <tbody>
+ <!-- ======================= -->
+ <!----------------------------->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7">
+ <a name="application">Database Application </a>
+ </td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td>V</td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td valign="top" width="180"><a href="ReportDesigner.odt">Report Designer</a></td>
+ <td>Specification for the new Report Designer</td>
+ <td><a href="mailto:ocke.janssen@sun.com">Ocke Janssen</a></td>
+ <td>1.8</td>
+ <td><span class="available_whenever">2.3.</span></td>
+ <td>2008-10-30</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <TR>
+ <TD vAlign="top" width="180"><a href="Function_Property_Browser.odt">Functions property browser</a></TD>
+ <TD>Specification hot to create simple functions with the report property browser</TD>
+ <td><a href="mailto:ocke.janssen@sun.com">Ocke Janssen</a></td>
+ <td>0.1</td>
+ <td><span class="available_whenever">2.4</span></td>
+ <td>2007-11-06</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </TR>
+ <tr>
+ <td valign="top" width="180"><a href="Conditional%20Formatting.odt">The conditional
+ formatting dialog</a></td>
+ <td>Specification for the conditional formatting dialog in the Report Designer</td>
+ <td><a href="mailto:bettina.haberer@sun.com">Bettina Haberer</a></td>
+ <td>0.1</td>
+ <td><span class="available_whenever">2.3.</span></td>
+ <td>2007-05-21</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td valign="top" width="180"><a href="Link_CSV_Text_files_into_HSQL_databases.odt">Link
+ CSV/Text files into HSQL databases</a></td>
+ <td>HSQLDB, the default database engine used by OpenOffice.org Base, features
+ linkage of CSV/Text files, handling them as if they were native HSQL tables,
+ including applicability of the full power of the HSQL database engine.<br>
+ This document describes an user interface, implemented for OpenOffice.org Base,
+ which allows to conveniently manage those linked tables in an HSQL database.</td>
+ <td><a href="mailto:frank.schoenheit@sun.com">Frank Sch�nheit</a></td>
+ <td>0.3</td>
+ <td><span class="available_whenever">t.b.d.</span></td>
+ <td>2006-11-27</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td valign="top" width="180"><a href="Queries_in_Queries_.odt">Queries in Queries</a></td>
+ <td>For certain database backends, OpenOffice.org supports using queries in
+ queries.</td>
+ <td><a href="mailto:frank.schoenheit@sun.com">Frank Sch�nheit</a></td>
+ <td>1.0.1</td>
+ <td><span class="available_in_204">2.0.4</span></td>
+ <td>2006-10-11</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td valign="top" width="180"><a href="Data_Source_Property_Dialog.sxw">Data Source
+ Property dialog</a></td>
+ <td>This document describes the handling of data source properties in OO.org 2.0.</td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>1.4</td>
+ <td>2.4</td>
+ <td>2007-11-12</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px">
+ </td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180">
+ <a href="http://dba.openoffice.org/specifications/Database_application.sxw"></a>
+ <a href="Database_application.sxw">Database Application</a>
+ </td>
+ <td>The document describes the new database application.</td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>1.1</td>
+ <td>2.2</td>
+ <td>2005-02-01</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px">
+ </td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="http://dba.openoffice.org/specifications/Database_Registration.sxw">Database
+ Registration dialog</a></td>
+ <td>The document describes the new database registration dialog.<br>
+ </td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>1.4</td>
+ <td>2.2</td>
+ <td>2004-01-28<br>
+ </td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px">
+ </td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="query_im_export.sxw">Export and Import of Queries</a></td>
+ <td>The document describes a feature to provide the easy importing and exporting of
+ queries (SQL statements) created within OOo Base.</td>
+ <td><a href="mailto:phillg@openoffice.org">Phill Gillespie</a></td>
+ <td>1.0</td>
+ <td><span class="available_whenever">t.b.d.</span></td>
+ <td>2004-06-13</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px">
+ </td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="Embedded_Database.sxw">Embedded Database</a></td>
+ <td>The document describes a feature to embed any kind of databases.</td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2004-11-08</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px">
+ </td>
+ </tr>
+ <!-- ======================= -->
+ <!-- Wizards -->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7"><a name="wizards"></a>Wizards</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td><b>V</b></td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Wizard_Report.sxw">ReportWizard</a></td>
+ <td>
+ This document describes the functionality of the report wizard. With this
+ wizard it is possible to generate reports with a lot of different styles from a
+ database document.</td>
+ <td><a href="mailto:bc@openoffice.org">Berend Cornelius</a></td>
+ <td>1.1</td>
+ <td>2.2</td>
+ <td>2005-03-10</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Wizard_Query.sxw">Query Wizard</a></td>
+ <td>The new query wizard</td>
+ <td><a href="mailto:bc@openoffice.org">Berend Cornelius</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2004-01-26</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Wizard_Table.sxw">Table Wizard</a></td>
+ <td>The new table wizard</td>
+ <td><a href="mailto:bc@openoffice.org">Berend Cornelius</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2003-12-18</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Wizard_Form.sxw">Form Wizard</a></td>
+ <td>The new improved form wizard</td>
+ <td><a href="mailto:bc@openoffice.org">Berend Cornelius</a></td>
+ <td>1.1</td>
+ <td>2.2</td>
+ <td>2003-12-19</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Wizard_Database.sxw">Database Wizard</a></td>
+ <td>The main entry point into the database application (OpenOffice.org Base) is a
+ wizard which guides the user through the creation of a database document.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.1.4</td>
+ <td>2.2</td>
+ <td>2005-06-27</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!-- ======================= -->
+ <!-- Architecture -->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7"><a name="architecture"></a>Architecture</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td><b>V</b></td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="address_book_architecture.html"> Address Book Architecture</a></td>
+ <td>This document aims to provide an overview of the technologies related to the
+ integration of the address-book feature into OpenOffice.org and Mozilla, a
+ summary of the address-book types supported and their respective underlying
+ API's, and ...</td>
+ <td><a href="mailto:ColmS@openoffice.org">Colm Smyth</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <tr>
+ <td>
+ <br>
+ </td>
+ </tr>
+ <!-- ======================= --> <!-- Core Functionality -->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7"><a name="core_functionality"></a>Database Driver Core
+ Functionality</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td><b>V</b></td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="file_based_functions.html">File based functions</a></td>
+ <td>This document describes the SQL functions implemented by file based database
+ drivers.</td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <tr>
+ <td>
+ <br>
+ </td>
+ </tr>
+ <!-- ======================= -->
+ <!-- Forms and Form Controls -->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7"><a name="forms"></a>Forms and Form Controls</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td><b>V</b></td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td valign="top" width="180"><a href="forms/scrollbar_form_control.sxw">Scroll Bar Form
+ Control</a>
+ </td>
+ <td>A form control which acts as a scrollbar.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2003-11-05</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="http://dba.openoffice.org/specifications/forms/spinbutton_form_control.sxw">Spin
+ Button Form Control</a></td>
+ <td>A form control which acts as a spinbutton.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2003-11-05</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="forms/prop_browser_enhancements.sxw">Property Browser Enhancements</a></td>
+ <td>Changes to the form/control property browser which hopefully increase its
+ usability</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0.3</td>
+ <td>2.2</td>
+ <td>2004-03-03</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="forms/rich_text_control.sxw">A Rich Text Form Control</a></td>
+ <td>This document describes a control which allows displaying and editing rich
+ text.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0.2</td>
+ <td>2.2</td>
+ <td>2005-02-17</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="forms/navigation_bar.sxw">Navigation Bar Form Control</a></td>
+ <td>This document describes a control which provides the functionality from the
+ well-known form navigation toolbar.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0.2</td>
+ <td>2.2</td>
+ <td>2004-07-15</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="forms/navigation_buttons.sxw">Form Navigation Functionality for Push
+ Buttons</a></td>
+ <td>This document describes an extension to push button controls, which allows to
+ easily assign common form navigation functionality (such as moving the form to
+ a new record) to those buttons.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0.1</td>
+ <td>2.2</td>
+ <td>2004-04-05</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="forms/multiline_line_ends.sxw">Handling Line Ends in MultiLine Text Fields</a></td>
+ <td>specifies how to handle different line ends ("DOS-like" (CR LF) vs. "Unix-like"
+ (LF)) in form controls.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2004-04-26</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="forms/form_controls_interop_1.sxw">Form Controls:
+ Interoperability I</a></td>
+ <td>OpenOffice.org's form controls will be refit with various new properties, which
+ allow to modify appearance-related aspects of them which previously could not
+ be customized. This gives ....</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2004-06-18</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="forms/multi_column_list_controls.odt">Multi Column List and
+ Combo Box Controls</a></td>
+ <td>OpenOffice.org extends its existing list and combo box form controls to allow
+ for more than one column. That is, ...</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>0.2</td>
+ <td><span class="available_whenever">t.b.d.</span></td>
+ <td>2005-06-01</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 16px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td>
+ <br>
+ </td>
+ </tr>
+ <!-- ======================= -->
+ <!-- Miscellaneous -->
+ <tr class="MainTableHeader">
+ <td rowspan="1" colspan="7"><a name="misc"></a>Miscellaneous</td>
+ </tr>
+ <tr class="InnerTableHeader">
+ <td valign="top" width="180">Specification Name:</td>
+ <td>Description:</td>
+ <td>Author:</td>
+ <td><b>V</b></td>
+ <td>A</td>
+ <td>D</td>
+ <td>T</td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="character_sets.html">Character Sets for Database Access</a></td>
+ <td>OpenOffice.org, Unicode-enabled itself, allows to access non-Unicode (8-Bit)
+ databases. Thus when transfering string data from connections to such databases
+ ....</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Drag_Drop_DSBrowser.html"> Drag and Drop in the Datasource
+ browser</a></td>
+ <td>Describes what should be possible to drag&drop in the datasource browser.</td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Form_Navigator_DnD.html">Data Exchange in the form navigator</a></td>
+ <td>This document describes the data exchange functionality in the form navigator.
+ This is the small floater which can be switched .....
+ </td>
+ <td><a href="mailto:fs@openoffice.org">Frank Sch�nheit</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="AutoIncrementValues.html">Auto-Increment values</a></td>
+ <td>This document describes a general way to create and retrieve auto increment
+ values.
+ </td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="MySQL_data_source_page.html">MySQL data source page</a></td>
+ <td>This document describes the data source page, which will be displayed when
+ choosing MySQL as database type in the data source administration dialog
+ </td>
+ <td><a href="mailto:oj@openoffice.org">Ocke Janssen</a></td>
+ <td>n/a</td>
+ <td><a class="available_in_1x" href="http://download.openoffice.org/1.1.1/index.html">1.1.1</a></td>
+ <td>n/a</td>
+ <td><img src="../images/html.gif" title="HTML Document" alt="html" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180">
+ <a href="ADO_Browse_Dialog.sxw">ADO Browse Dialog</a></td>
+ <td>This document describes a browse dialog we want to add to data source
+ administration dialog of ADO datasource.
+ </td>
+ <td><a href="mailto:windly@openoffice.org">Wind li</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2003-12-17</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180">
+ <a href="Ldap_authentication.sxw">LDAP Authentication</a></td>
+ <td>This document describes the LDAP authentication enhancement.
+ </td>
+ <td><a href="mailto:windly@openoffice.org">Wind li</a></td>
+ <td>1.1</td>
+ <td>2.2</td>
+ <td>2003-12-17</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td width="180"><a href="Write_Access_To_AddressBooks.sxw">Write Access To AddressBooks</a></td>
+ <td>This document is for i20338 Q-PCD Database-15: Read and Write access to Address
+ Books.
+ </td>
+ <td><a href="mailto:windly@openoffice.org">Wind li</a></td>
+ <td>0.2</td>
+ <td><span class="available_in_20">2.0</span></td>
+ <td>2004-04-19</td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="Thunderbird_ab.sxw">Mozab Enhance</a><br>
+ </td>
+ <td>This document describes the changes need to be made to access multiple Mozilla
+ profiles and Thunderbird profiles.<br>
+ </td>
+ <td><a href="mailto:windly@openoffice.org">Wind li</a></td>
+ <td>1.0</td>
+ <td>2.2</td>
+ <td>2005-01-31<br>
+ </td>
+ <td><img src="../images/sxw.gif" title="OpenOffice.org Text Document" alt="sxw" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ <tr>
+ <td><a href="kde_address_book_access.odt">KDE Address Book Access</a><br>
+ </td>
+ <td>OpenOffice.org will be enabled to access the KDE Address Book data, if running
+ on a KDE system.<br>
+ </td>
+ <td><a href="mailto:frank.schoenheit@sun.com">Frank Sch�nheit</a></td>
+ <td>0.4</td>
+ <td>2.0.2</td>
+ <td>2005-12-13</td>
+ <td><img src="../images/odt.gif" title="OASIS OpenDocument Text" alt="odt" style="WIDTH: 13px; HEIGHT: 16px"></td>
+ </tr>
+ <!----------------------------->
+ </tbody>
+ </table>
+ </div>
+ </body>
+</html>
\ No newline at end of file
diff --git a/content/dba/test/DataSource.html b/content/dba/test/DataSource.html
new file mode 100644
index 0000000..1d6ee97
--- /dev/null
+++ b/content/dba/test/DataSource.html
@@ -0,0 +1,495 @@
+<html>
+<head>
+<title>Service DataSource</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" type="text/css" href="http://api.openoffice.org/docs/common/ref/idl.css">
+</head>
+<body>
+<div id="adc-idlref">
+
+<a name="_top_"> </a>
+<table class="navimain" border="0" cellpadding="3">
+<tr>
+<td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td>
+<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
+<td class="navimain"><a href="DataSource-xref.html" class="navimain">Use</a></td>
+<td class="navimainnone">Devguide</td>
+<td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td>
+</tr>
+</table>
+<table class="navisub" border="0" cellpadding="0">
+<tr>
+<td class="navisub">Included Services</td>
+<td class="navisub"><a href="#ExportedInterfaces" class="navisub">Exported Interfaces</a></td>
+<td class="navisub"><a href="#PropertiesSummary" class="navisub">Properties' Summary</a></td>
+<td class="navisub"><a href="#PropertiesDetails" class="navisub">Properties' Details</a></td>
+</tr>
+</table>
+<hr>
+<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
+<tr>
+<td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">sdb</a> :: </p>
+</td>
+</tr>
+<tr>
+<td class="title">service DataSource</td>
+</tr>
+<tr>
+<td><dl>
+<dt><b>Description</b></dt>
+<dd>is a factory to establish database connections. It should be registered at
+a ::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/NamingService.html">NamingService</a> .
+</dd>
+<dt><b>See also</b></dt>
+<dd><a href="DatabaseContext.html">DatabaseContext</a></dd>
+</dl>
+</td>
+</tr>
+</table>
+<hr>
+<a name="ExportedInterfaces"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Exported Interfaces</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>provides information about and access to the
+properties from an implementation.
+
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XCompletedConnection.html">XCompletedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing connections with the completion of connection parameters
+provided during user interaction.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XIsolatedConnection.html">XIsolatedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing isolated connections which are not shared among others
+as it is the case when using <a href="XCompletedConnection.html">XCompletedConnection</a> or ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a> .
+</dd>
+<dt><b/></dt>
+<dd/><dt><b/></dt>
+<dd/><dt><b>Since </b></dt>
+<dd>OOo 1.1.2 </dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XFlushable.html">XFlushable</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>is provided to flush a DataSource within to a Database Context.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XQueryDefinitionsSupplier.html">XQueryDefinitionsSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>provides the access to DataSource related queries.
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XQueryDefinitionsSupplier::getQueryDefinitions() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>is used for establishing connections via a factory which is identified
+by its name. A DataSource object is typically registered by a naming service
+provider.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XBookmarksSupplier.html">XBookmarksSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Usage Restrictions</b></dt>
+<dd><i>optional</i></dd>
+<dt><b>Description</b></dt>
+<dd>provides access to bookmarks to documents associated with the data source
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XBookmarksSupplier::getBookmarks() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+<a name="PropertiesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Properties' Summary</td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] string<br>
+<a href="#Name">Name</a></td>
+<td class="imsum_right">is the name of the data source.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#URL">URL</a></td>
+<td class="imsum_right">indicates a database url of the form <br>
+<code>jdbc: <em>subprotocol </em>: <em>subname </em></code>
+or
+<code>sdbc: <em>subprotocol </em>: <em>subname </em></code>
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> ><br>
+<a href="#Info">Info</a></td>
+<td class="imsum_right">is a list of arbitrary string tag/value pairs as connection arguments
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a><br>
+<a href="#Settings">Settings</a></td>
+<td class="imsum_right"><b>[ OPTIONAL ]<br>
+</b>is a convenience wrapper around the <a href="#Info">Info</a> property.
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#User">User</a></td>
+<td class="imsum_right">determines a users login name.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#Password">Password</a></td>
+<td class="imsum_right">determines a users password. The password is not persistent.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">boolean<br>
+<a href="#IsPasswordRequired">IsPasswordRequired</a></td>
+<td class="imsum_right">indicates that a password is always necessary.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">boolean<br>
+<a href="#SuppressVersionColumns">SuppressVersionColumns</a></td>
+<td class="imsum_right">indicates that components displaying data obtained from this
+data source should suppress columns used for versioning.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] boolean<br>
+<a href="#IsReadOnly">IsReadOnly</a></td>
+<td class="imsum_right">determines whether modifications on the data source are allowed or not.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] ::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XNumberFormatsSupplier.html">XNumberFormatsSupplier</a><br>
+<a href="#NumberFormatsSupplier">NumberFormatsSupplier</a></td>
+<td class="imsum_right">provides an object for formatting numbers.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< string ><br>
+<a href="#TableFilter">TableFilter</a></td>
+<td class="imsum_right">defines a list of tables, on which the DataSource should have it's focus.
+If empty, all tables are rejected.
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< string ><br>
+<a href="#TableTypeFilter">TableTypeFilter</a></td>
+<td class="imsum_right">defines a list of table types, on which the DataSource should have it's focus.
+If empty, all table types are rejected.
+
+ </td>
+</tr>
+</table>
+<a name="PropertiesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle">Properties' Details</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Name" class="membertitle">Name</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] string <b>Name</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>is the name of the data source.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="URL" class="membertitle">URL</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>URL</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates a database url of the form <br>
+<code>jdbc: <em>subprotocol </em>: <em>subname </em></code>
+or
+<code>sdbc: <em>subprotocol </em>: <em>subname </em></code>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Info" class="membertitle">Info</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> > <b>Info</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>is a list of arbitrary string tag/value pairs as connection arguments
+
+</dd>
+<dd><p>The <a href="DataSource.html">DataSource</a> itself does not attempt to interpret any of those values. </p>
+
+<p>Instead, the values in this property have two use cases:
+<ul><li>Upon creating a connection, for every value in this sequence it's checked
+whether the ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDriver.html">XDriver</a> which is to provide
+the connection supports a setting with the respective name, using its
+
+If so, the settings is passed to the drivers's
+If not,
+the setting is ignored. </li>
+<li>External components may use the settings to carry arbitrary information with
+the data source. Usually, this is used to control the behaviour of components
+working with the data source. </li>
+</ul>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Settings" class="membertitle">Settings</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a> <b>Settings</b>;<hr>
+<dl>
+<dt><b>Usage Restrictions</b></dt>
+<dd><i>optional</i></dd>
+<dt><b>Description</b></dt>
+<dd>is a convenience wrapper around the <a href="#Info">Info</a> property.
+
+</dd>
+<dd><p>Since fiddling around with a sequence of property values is somewhat uncomfortable
+in all known UNO language bindings (especially for tasks like simply changing the value
+of an existing value), the <a href="#Settings">Settings</a> property wraps the <a href="#Info">Info</a>
+property for easier single-value access. </p>
+
+<p>You should use the <a href="#Setting">Setting</a> property if you need to access a few properties only,
+and the <a href="#Info">Info</a> property if you need access to all existent settings at once. </p>
+
+<p>The object represented by this property supports the ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyBag.html" title="com::sun::star::beans::PropertyBag">PropertyBag</a>
+service. That is, you can at runtime add arbitrary new properties to the bag. </p>
+
+<p>Additionally, the property bag supports default values of properties, and thus the
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertyState.html">XPropertyState</a> interface. If you add an own property to
+the bag using ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertyContainer.html">XPropertyContainer</a>::<a href="../beans/XPropertyContainer.html#addProperty">addProperty</a> , you need
+to specifiy an initial value, which is also used as default value (exceptions see below). </p>
+
+<p>Effectively, the property bag represented by <code>Settings </code>contains two classes of properties:
+Pre-defined ones and user-defined ones. </p>
+
+<p><em>Pre-defined </em>properties are properties which are potentially used by the data source, the
+application UI for the data source, or a particular backend driver employed by the data source. There's
+a large set of such properties, no all of them are effectively used for a concrete data source, nonetheless,
+they're all present in the <code>Settings </code>. <br/>
+Such properties are not removeable from the bag, that is, their
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyAttribute.html">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#REMOVEABLE">REMOVEABLE</a> attribute is <em>not </em>set. <br/>
+Usually, you'll find that all of this properties have the
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyState.html">PropertyState</a>::<a href="../beans/PropertyState.html#PropertyState_DEFAULT_VALUE">PropertyState_DEFAULT_VALUE</a> state. </p>
+
+<p><em>User-defined </em>properties are the ones which are added at runtime by any instance. They might or might
+not be removeable, this depends on whether or not the code adding them specifies the
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyAttribute.html">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#REMOVEABLE">REMOVEABLE</a> attribute. Also, they might
+or might not have a default value, determined by the
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyAttribute.html">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#MAYBEDEFAULT">MAYBEDEFAULT</a> attribute at the time they're added
+to the bag. </p>
+
+<p>When a data source is made persistent, then properties which are not removeable (which are assumed to be the
+pre-defined properties) are ignored when they are in <code>DEFAULT </code>state. All other properties are
+always made persistent, except when an explicit
+::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyAttribute.html">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#TRANSIENT">TRANSIENT</a> attribute prohibits this. </p>
+
+<p>Similar, when you obtain the <a href="#Info">Info</a> property of a <code>DataSource </code>, the
+<code>Settings </code>bag is asked for all its property values, and the ones which are removeable and
+in state default are stripped, and <em>not </em>returned in the <code>Info </code>sequence. </p>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="User" class="membertitle">User</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>User</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines a users login name.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Password" class="membertitle">Password</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>Password</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines a users password. The password is not persistent.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="IsPasswordRequired" class="membertitle">IsPasswordRequired</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>boolean <b>IsPasswordRequired</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates that a password is always necessary.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="SuppressVersionColumns" class="membertitle">SuppressVersionColumns</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>boolean <b>SuppressVersionColumns</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates that components displaying data obtained from this
+data source should suppress columns used for versioning.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="IsReadOnly" class="membertitle">IsReadOnly</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] boolean <b>IsReadOnly</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines whether modifications on the data source are allowed or not.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="NumberFormatsSupplier" class="membertitle">NumberFormatsSupplier</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] ::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XNumberFormatsSupplier.html">XNumberFormatsSupplier</a> <b>NumberFormatsSupplier</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>provides an object for formatting numbers.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="TableFilter" class="membertitle">TableFilter</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< string > <b>TableFilter</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>defines a list of tables, on which the DataSource should have it's focus.
+If empty, all tables are rejected.
+
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="TableTypeFilter" class="membertitle">TableTypeFilter</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< string > <b>TableTypeFilter</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>defines a list of table types, on which the DataSource should have it's focus.
+If empty, all table types are rejected.
+
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2003 Sun Microsystems, Inc.</p>
+
+</div> <!-- id="adc-idlref" -->
+</body>
+
+</html>
diff --git a/content/dba/test/DataSource_new.html b/content/dba/test/DataSource_new.html
new file mode 100644
index 0000000..7d46659
--- /dev/null
+++ b/content/dba/test/DataSource_new.html
@@ -0,0 +1,495 @@
+<html>
+<head>
+<title>Service DataSource</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" type="text/css" href="http://api.openoffice.org/docs/common/ref/idl.css">
+</head>
+<body>
+<div id="adc-idlref">
+
+<a name="_top_"> </a>
+<table class="navimain" border="0" cellpadding="3">
+<tr>
+<td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td>
+<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
+<td class="navimain"><a href="DataSource-xref.html" class="navimain">Use</a></td>
+<td class="navimainnone">Devguide</td>
+<td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td>
+</tr>
+</table>
+<table class="navisub" border="0" cellpadding="0">
+<tr>
+<td class="navisub">Included Services</td>
+<td class="navisub"><a href="#ExportedInterfaces" class="navisub">Exported Interfaces</a></td>
+<td class="navisub"><a href="#PropertiesSummary" class="navisub">Properties' Summary</a></td>
+<td class="navisub"><a href="#PropertiesDetails" class="navisub">Properties' Details</a></td>
+</tr>
+</table>
+<hr>
+<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
+<tr>
+<td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">sdb</a> :: </p>
+</td>
+</tr>
+<tr>
+<td class="title">service DataSource</td>
+</tr>
+<tr>
+<td><dl>
+<dt><b>Description</b></dt>
+<dd>is a factory to establish database connections. It should be registered at
+a ::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/NamingService.html">NamingService</a> .
+</dd>
+<dt><b>See also</b></dt>
+<dd><a href="DatabaseContext.html">DatabaseContext</a></dd>
+</dl>
+</td>
+</tr>
+</table>
+<hr>
+<a name="ExportedInterfaces"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Exported Interfaces</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>provides information about and access to the
+properties from an implementation.
+
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XCompletedConnection.html">XCompletedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing connections with the completion of connection parameters
+provided during user interaction.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XIsolatedConnection.html">XIsolatedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing isolated connections which are not shared among others
+as it is the case when using <a href="XCompletedConnection.html">XCompletedConnection</a> or ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a> .
+</dd>
+<dt><b/></dt>
+<dd/><dt><b/></dt>
+<dd/><dt><b>Since </b></dt>
+<dd>OOo 1.1.2 </dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XFlushable.html">XFlushable</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>is provided to flush a DataSource within to a Database Context.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XQueryDefinitionsSupplier.html">XQueryDefinitionsSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>provides the access to DataSource related queries.
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XQueryDefinitionsSupplier::getQueryDefinitions() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>is used for establishing connections via a factory which is identified
+by its name. A DataSource object is typically registered by a naming service
+provider.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XBookmarksSupplier.html">XBookmarksSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Usage Restrictions</b></dt>
+<dd><i>optional</i></dd>
+<dt><b>Description</b></dt>
+<dd>provides access to bookmarks to documents associated with the data source
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XBookmarksSupplier::getBookmarks() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+<a name="PropertiesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Properties' Summary</td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] string<br>
+<a href="#Name">Name</a></td>
+<td class="imsum_right">is the name of the data source.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#URL">URL</a></td>
+<td class="imsum_right">indicates a database url of the form <br>
+<code>jdbc: <em>subprotocol </em>: <em>subname </em></code>
+or
+<code>sdbc: <em>subprotocol </em>: <em>subname </em></code>
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> ><br>
+<a href="#Info">Info</a></td>
+<td class="imsum_right">is a list of arbitrary string tag/value pairs as connection arguments
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a><br>
+<a href="#Settings">Settings</a></td>
+<td class="imsum_right"><b>[ OPTIONAL ]<br>
+</b>is a convenience wrapper around the <a href="#Info">Info</a> property.
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#User">User</a></td>
+<td class="imsum_right">determines a users login name.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#Password">Password</a></td>
+<td class="imsum_right">determines a users password. The password is not persistent.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">boolean<br>
+<a href="#IsPasswordRequired">IsPasswordRequired</a></td>
+<td class="imsum_right">indicates that a password is always necessary.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">boolean<br>
+<a href="#SuppressVersionColumns">SuppressVersionColumns</a></td>
+<td class="imsum_right">indicates that components displaying data obtained from this
+data source should suppress columns used for versioning.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] boolean<br>
+<a href="#IsReadOnly">IsReadOnly</a></td>
+<td class="imsum_right">determines whether modifications on the data source are allowed or not.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] ::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XNumberFormatsSupplier.html">XNumberFormatsSupplier</a><br>
+<a href="#NumberFormatsSupplier">NumberFormatsSupplier</a></td>
+<td class="imsum_right">provides an object for formatting numbers.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< string ><br>
+<a href="#TableFilter">TableFilter</a></td>
+<td class="imsum_right">defines a list of tables, on which the DataSource should have it's focus.
+If empty, all tables are rejected.
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< string ><br>
+<a href="#TableTypeFilter">TableTypeFilter</a></td>
+<td class="imsum_right">defines a list of table types, on which the DataSource should have it's focus.
+If empty, all table types are rejected.
+
+ </td>
+</tr>
+</table>
+<a name="PropertiesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle">Properties' Details</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Name" class="membertitle">Name</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] string <b>Name</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>is the name of the data source.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="URL" class="membertitle">URL</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>URL</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates a database url of the form <br>
+<code>jdbc: <em>subprotocol </em>: <em>subname </em></code>
+or
+<code>sdbc: <em>subprotocol </em>: <em>subname </em></code>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Info" class="membertitle">Info</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> > <b>Info</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>is a list of arbitrary string tag/value pairs as connection arguments
+
+</dd>
+<dd><p>The <a href="DataSource.html">DataSource</a> itself does not attempt to interpret any of those values. </p>
+
+<p>Instead, the values in this property have two use cases:
+<ul><li>Upon creating a connection, for every value in this sequence it's checked
+whether the ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDriver.html">XDriver</a> which is to provide
+the connection supports a setting with the respective name, using its
+
+If so, the settings is passed to the drivers's
+If not,
+the setting is ignored. </li>
+<li>External components may use the settings to carry arbitrary information with
+the data source. Usually, this is used to control the behaviour of components
+working with the data source. </li>
+</ul>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Settings" class="membertitle">Settings</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a> <b>Settings</b>;<hr>
+<dl>
+<dt><b>Usage Restrictions</b></dt>
+<dd><i>optional</i></dd>
+<dt><b>Description</b></dt>
+<dd>is a convenience wrapper around the <a href="#Info">Info</a> property.
+
+</dd>
+<dd><p>Since fiddling around with a sequence of property values is somewhat uncomfortable
+in all known UNO language bindings (especially for tasks like simply changing the value
+of an existing value), the <a href="#Settings">Settings</a> property wraps the <a href="#Info">Info</a>
+property for easier single-value access.</p>
+
+<p>You should use the <a href="#Setting">Setting</a> property if you need to access a few properties only,
+and the <a href="#Info">Info</a> property if you need access to all existent settings at once.</p>
+
+<p>The object represented by this property supports the <a href="../beans/PropertyBag.html" title="com::sun::star::beans::PropertyBag">PropertyBag</a>
+service. That is, you can at runtime add arbitrary new properties to the bag.</p>
+
+<p>Additionally, the property bag supports default values of properties, and thus the
+<a href="../beans/XPropertyState.html" title="com::sun::star::beans::XPropertyState">XPropertyState</a> interface. If you add an own property to
+the bag using <a href="../beans/XPropertyContainer.html" title="com::sun::star::beans::XPropertyContainer">XPropertyContainer</a>::<a href="../beans/XPropertyContainer.html#addProperty">addProperty</a>, you need
+to specifiy an initial value, which is also used as default value (exceptions see below).</p>
+
+<p>Effectively, the property bag represented by <code>Settings</code> contains two classes of properties:
+Pre-defined ones and user-defined ones.</p>
+
+<p><em>Pre-defined</em> properties are properties which are potentially used by the data source, the
+application UI for the data source, or a particular backend driver employed by the data source. There's
+a large set of such properties, no all of them are effectively used for a concrete data source, nonetheless,
+they're all present in the <code>Settings</code>.<br/>
+Such properties are not removeable from the bag, that is, their
+<a href="../beans/PropertyAttribute.html" title="com::sun::star::beans::PropertyAttribute">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#REMOVEABLE">REMOVEABLE</a> attribute is <em>not</em> set. <br/>
+Usually, you'll find that all of this properties have the
+<a href="../beans/PropertyState.html" title="com::sun::star::beans::PropertyState">PropertyState</a>::<a href="../beans/PropertyState.html#PropertyState_DEFAULT_VALUE">PropertyState_DEFAULT_VALUE</a> state.</p>
+
+<p><em>User-defined</em> properties are the ones which are added at runtime by any instance. They might or might
+not be removeable, this depends on whether or not the code adding them specifies the
+<a href="../beans/PropertyAttribute.html" title="com::sun::star::beans::PropertyAttribute">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#REMOVEABLE">REMOVEABLE</a> attribute. Also, they might
+or might not have a default value, determined by the
+<a href="../beans/PropertyAttribute.html" title="com::sun::star::beans::PropertyAttribute">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#MAYBEDEFAULT">MAYBEDEFAULT</a> attribute at the time they're added
+to the bag.</p>
+
+<p>When a data source is made persistent, then properties which are not removeable (which are assumed to be the
+pre-defined properties) are ignored when they are in <code>DEFAULT</code> state. All other properties are
+always made persistent, except when an explicit
+<a href="../beans/PropertyAttribute.html" title="com::sun::star::beans::PropertyAttribute">PropertyAttribute</a>::<a href="../beans/PropertyAttribute.html#TRANSIENT">TRANSIENT</a> attribute prohibits this.</p>
+
+<p>Similar, when you obtain the <a href="#Info">Info</a> property of a <code>DataSource</code>, the
+<code>Settings</code> bag is asked for all its property values, and the ones which are removeable and
+in state default are stripped, and <em>not</em> returned in the <code>Info</code> sequence.</p>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="User" class="membertitle">User</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>User</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines a users login name.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="Password" class="membertitle">Password</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>string <b>Password</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines a users password. The password is not persistent.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="IsPasswordRequired" class="membertitle">IsPasswordRequired</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>boolean <b>IsPasswordRequired</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates that a password is always necessary.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="SuppressVersionColumns" class="membertitle">SuppressVersionColumns</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>boolean <b>SuppressVersionColumns</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>indicates that components displaying data obtained from this
+data source should suppress columns used for versioning.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="IsReadOnly" class="membertitle">IsReadOnly</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] boolean <b>IsReadOnly</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>determines whether modifications on the data source are allowed or not.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="NumberFormatsSupplier" class="membertitle">NumberFormatsSupplier</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>[ readonly ] ::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XNumberFormatsSupplier.html">XNumberFormatsSupplier</a> <b>NumberFormatsSupplier</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>provides an object for formatting numbers.
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="TableFilter" class="membertitle">TableFilter</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< string > <b>TableFilter</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>defines a list of tables, on which the DataSource should have it's focus.
+If empty, all tables are rejected.
+
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td class="imdetail"><a name="TableTypeFilter" class="membertitle">TableTypeFilter</a>
+<table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
+<tr>
+<td>sequence< string > <b>TableTypeFilter</b>;<hr>
+<dl>
+<dt><b>Description</b></dt>
+<dd>defines a list of table types, on which the DataSource should have it's focus.
+If empty, all table types are rejected.
+
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2003 Sun Microsystems, Inc.</p>
+
+</div> <!-- id="adc-idlref" -->
+</body>
+
+</html>
diff --git a/content/dba/test/DataSource_new_new.html b/content/dba/test/DataSource_new_new.html
new file mode 100644
index 0000000..dc7f53e
--- /dev/null
+++ b/content/dba/test/DataSource_new_new.html
@@ -0,0 +1,495 @@
+<html>
+<head>
+<title>Service DataSource</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" type="text/css" href="http://api.openoffice.org/docs/common/ref/idl.css">
+</head>
+<body>
+<div id="adc-idlref">
+
+<a name="_top_"> </a>
+<table class="navimain" border="0" cellpadding="3">
+<tr>
+<td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td>
+<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
+<td class="navimain"><a href="DataSource-xref.html" class="navimain">Use</a></td>
+<td class="navimainnone">Devguide</td>
+<td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td>
+</tr>
+</table>
+<table class="navisub" border="0" cellpadding="0">
+<tr>
+<td class="navisub">Included Services</td>
+<td class="navisub"><a href="#ExportedInterfaces" class="navisub">Exported Interfaces</a></td>
+<td class="navisub"><a href="#PropertiesSummary" class="navisub">Properties' Summary</a></td>
+<td class="navisub"><a href="#PropertiesDetails" class="navisub">Properties' Details</a></td>
+</tr>
+</table>
+<hr>
+<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
+<tr>
+<td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">sdb</a> :: </p>
+</td>
+</tr>
+<tr>
+<td class="title">service DataSource</td>
+</tr>
+<tr>
+<td><dl>
+<dt><b>Description</b></dt>
+<dd>is a factory to establish database connections. It should be registered at
+a ::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/NamingService.html">NamingService</a> .
+</dd>
+<dt><b>See also</b></dt>
+<dd><a href="DatabaseContext.html">DatabaseContext</a></dd>
+</dl>
+</td>
+</tr>
+</table>
+<hr>
+<a name="ExportedInterfaces"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Exported Interfaces</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>provides information about and access to the
+properties from an implementation.
+
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XCompletedConnection.html">XCompletedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing connections with the completion of connection parameters
+provided during user interaction.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XIsolatedConnection.html">XIsolatedConnection</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>useful for establishing isolated connections which are not shared among others
+as it is the case when using <a href="XCompletedConnection.html">XCompletedConnection</a> or ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a> .
+</dd>
+<dt><b/></dt>
+<dd/><dt><b/></dt>
+<dd/><dt><b>Since </b></dt>
+<dd>OOo 1.1.2 </dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XFlushable.html">XFlushable</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>is provided to flush a DataSource within to a Database Context.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XQueryDefinitionsSupplier.html">XQueryDefinitionsSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Description</b></dt>
+<dd>provides the access to DataSource related queries.
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XQueryDefinitionsSupplier::getQueryDefinitions() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left">::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/XDataSource.html">XDataSource</a></td>
+<td class="imsum_right"><dl>
+<dt>(referenced entity's summary:)</dt>
+<dd>is used for establishing connections via a factory which is identified
+by its name. A DataSource object is typically registered by a naming service
+provider.
+</dd>
+</dl>
+</td>
+</tr>
+<tr>
+<td class="imsum_left"><a href="XBookmarksSupplier.html">XBookmarksSupplier</a></td>
+<td class="imsum_right"><dl>
+<dt><b>Usage Restrictions</b></dt>
+<dd><i>optional</i></dd>
+<dt><b>Description</b></dt>
+<dd>provides access to bookmarks to documents associated with the data source
+</dd>
+<dd><p>
+The object returned by the
+<method scope="com::sun::star::sdb">XBookmarksSupplier::getBookmarks() </method>
+supports the
+<service scope="com::sun::star::sdb">DefinitionContainer </service>
+service.
+</p>
+</dd>
+</dl>
+</td>
+</tr>
+</table>
+<a name="PropertiesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
+<tr>
+<td class="subtitle" colspan="2">Properties' Summary</td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] string<br>
+<a href="#Name">Name</a></td>
+<td class="imsum_right">is the name of the data source.
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">string<br>
+<a href="#URL">URL</a></td>
+<td class="imsum_right">indicates a database url of the form <br>
+<code>jdbc: <em>subprotocol </em>: <em>subname </em></code>
+or
+<code>sdbc: <em>subprotocol </em>: <em>subname </em></code>
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">sequence< ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> ><br>
+<a href="#Info">Info</a></td>
+<td class="imsum_right">is a list of arbitrary string tag/value pairs as connection arguments
+
+ </td>
+</tr>
+<tr>
+<td class="imsum_left">[ readonly ] ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a><br>
+<a href="#Settings">Settings</a></td>
+<td class="imsum_right"><b>[ OPTIONAL ]<br>
+</b>is a convenience wrapper around the <a href="#Info">Info</a> property.
+
+ </td>
+</tr>
+<tr>
... 587 lines suppressed ...