gContactOOo logo Documentation

Ce document en français.

The use of this software subjects you to our Terms Of Use and Data Protection Policy.

version 1.3.0

Introduction:

gContactOOo is part of a Suite of LibreOffice and/or OpenOffice extensions allowing to offer you innovative services in these office suites.

This extension gives you access, in LibreOffice, to your phone contacts (the contacts of your Android phone).
It uses Google People API to synchronize your remote Google Contacts into a local HsqlDB 2.7.4 database.
This extension is seen by LibreOffice as a database driver responding to the URL: sdbc:address:google:*.

Being free software I encourage you:

In short, to participate in the development of this extension.
Because it is together that we can make Free Software smarter.


Requirement:

The gContactOOo extension uses the OAuth2OOo extension to work.
It must therefore meet the requirement of the OAuth2OOo extension.

The gContactOOo extension uses the jdbcDriverOOo extension to work.
It must therefore meet the requirement of the jdbcDriverOOo extension.
Additionally, gContactOOo requires the jdbcDriverOOo extension to be configured to provide com.sun.star.sdb as the API level, which is the default configuration.


Installation:

It seems important that the file was not renamed when it was downloaded. If necessary, rename it before installing it.

Restart LibreOffice after installation.
Be careful, restarting LibreOffice may not be enough.

After restarting LibreOffice, you can ensure that the extension and its driver are correctly installed by checking that the io.github.prrvchr.gContactOOo.Driver driver is listed in the Connection Pool, accessible via the menu: Tools -> Options -> LibreOffice Base -> Connections. It is not necessary to enable the connection pool.

If the driver is not listed, the reason for the driver failure can be found in the extension’s logging. This log is accessible via the menu: Tools -> Options -> LibreOffice Base -> Google Contacts -> Logging Options.
The gContactLog logging must first be enabled and then LibreOffice restarted to get the error message in the log.


Use:

In LibreOffice / OpenOffice go to: File -> Wizards -> Address Data Source…

gContactOOo screenshot 1

The Address Book Datasource Wizard open.

In step: 1.Address Book Type:

gContactOOo screenshot 2

In step: 2.Connection Settings:

gContactOOo screenshot 3

A new wizard opens. Data source properties.

In step: 1.Advanced Properties.
In Database type list:

gContactOOo screenshot 4

In step: 2.Connection Settings.
In General: Enter the DBMS/driver-specific connection string here.

gContactOOo screenshot 5

After authorizing the OAuth2OOo application to access your Contacts, normally you should see: Connection Test: The connection was established successfully.

gContactOOo screenshot 6

If the connection has been established, you can complete this wizard with the Finish button.

gContactOOo screenshot 7

In step: 3.Table Selection.
If your data source has multiple tables, you will be asked to select the primary table.
In this case select the table: All my contacts. If necessary and before any connection it is possible to rename the main table name in: Tools -> Options -> Internet -> gContactOOo -> Main table name.

In step: 4.Field Assignment.
If necessary it is possible to rename the names of the columns of the data source using the button: Field Assignment.
Please continue this wizard with the button: Next.

gContactOOo screenshot 8

In step: 5.Data Source Title.

You must create an odb file. To do this you must:

This odb file must also be made accessible. To do this you must:

gContactOOo screenshot 9

Have fun…


How to build the extension:

Normally, the extension is created with Eclipse for Java and LOEclipse. To work around Eclipse, I modified LOEclipse to allow the extension to be created with Apache Ant.
To create the gContactOOo extension with the help of Apache Ant, you need to:


Has been tested with:

I encourage you in case of problem :confused:
to create an issue
I will try to solve it :smile:


Historical:

Introduction:

This extension was written in order to make usable in free software (LibreOffice or OpenOffice) your personal data (your address book) stored in your Android phone.

With the eMailerOOo extension, it can be the data source for mail merge by email, to your correspondents contained in your phone.

It will give you access to an information system that only larges companies are able, today, to implement.

What has been done for version 0.0.5:

What has been done for version 0.0.6:

What has been done for version 1.0.1:

What has been done for version 1.0.2:

What has been done for version 1.0.3:

What has been done for version 1.1.0:

What has been done for version 1.1.1:

What has been done for version 1.1.2:

What has been done for version 1.1.3:

What has been done for version 1.1.4:

What has been done for version 1.1.5:

What has been done for version 1.1.6:

What has been done for version 1.2.0:

What has been done for version 1.2.1:

What has been done for version 1.3.0:

What remains to be done for version 1.3.0: