This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Difference between revisions of "Synchronization"

From Group-Office Groupware and CRM Documentation
Jump to: navigation, search
(ActiveSync)
(Client or device setup)
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Group-Office supports two synchronization protocols. It supports Microsoft ActiveSync and SyncML.
+
==Introduction==
 +
Group-Office supports two synchronization protocols. It supports Microsoft ActiveSync and Caldav/Carddav. To use ActiveSync z-push must be installed. Read [[ActiveSync]] for installation instructions. When z-push is installed at the server, phones can be configured to use ActiveSync very easily. To test if your server is setup with ActiveSync support you can enter:
  
==ActiveSync==
+
http://'''your.url.to.groupoffice'''/Microsoft-Server-ActiveSync
To use ActiveSync z-push must be installed. Read modules/sync/z-push/INSTALL.TXT for installation instructions. When z-push is installed at the server, phones can be configured to use ActiveSync very easily.
+
  
Group-Office can synchronize the following items with ActiveSync:
+
<b>Note:</b> this is not the Server or host URL you must configure on your device. On the device you have to use the '''bold''' part of the URL.
  
* Appointments
+
If it's working you should get a Z-push browser authentication dialog which you should simply cancel.
* Tasks
+
* Contacts
+
* E-mail
+
  
Use the hostname of your Group-Office installation as Exchange Server For example if your Group-Office URL is https://intermesh.group-office.com/groupoffice/ then the exchange server address is: intermesh.group-office.com. If your server supports https / SSL then you can enable encryption too. Use your Group-Office username and password.
+
Group-Office can synchronize the following items:
  
Supported Devices:
+
#Appointments
 +
#Tasks
 +
#Contacts
 +
#E-mail (ActiveSync only, E-mail can be configured with IMAP when using Caldav/Carddav clients)
  
#[http://support.apple.com/kb/HT2480 iPhone]
+
==Client or device setup==
#[http://europe.nokia.com/find-products/nokia-for-business/messaging Nokia Mail for Exchange]
+
Group-Office can synchronize with the following clients or devices. Click on your device type to view the instructions. In general you need the to enter the following info:
#[http://www.wikihow.com/Configure-Windows-Mobile-6-Smartphones-for-Microsoft-Exchange Windows Mobile]
+
#[[Outlook]]
#[http://kb.palm.com/wps/portal/kb/common/article/44726_en.html Palm]
+
#[[Max OS X]]
#Other phones that support ActiveSync
+
#[[Gnome Evolution]]
 +
#'''Mobile devices with ActiveSync support'''<br />Use your Group-Office username, password and the bold  part of the Group-Office URL: http://'''your.url.to.groupoffice'''/groupoffice/. The domain field can be left empty or enter anything.
 +
##[http://support.apple.com/kb/HT2480 iPhone]
 +
##[http://europe.nokia.com/support/download-software/mail-for-exchange Nokia Mail for Exchange]
 +
##[http://www.wikihow.com/Configure-Windows-Mobile-6-Smartphones-for-Microsoft-Exchange Windows Mobile]
 +
##[http://kb.palm.com/wps/portal/kb/common/article/44726_en.html Palm]
 +
##[[Google Android]]
 +
#CalDAV and CardDAV
 +
## [http://groupoffice.blogspot.nl/2015/05/davdroid-calendar-and-contact-sync.html DAVDroid] for Android phones
 +
## [http://groupoffice.blogspot.nl/2014/03/synchronize-your-android-phone-with.html Caldav and Cardav sync free] for Android
 +
## iOS devices support caldav and carddav natively.
 +
#[[Blackberry]]
 +
#[[Thunderbird 3]]
 +
#Other phones that support ActiveSync or Caldav/Carddav.
  
===Troubleshooting===
+
==Group-Office synchronization settings==
If you have problems with z-push then put a file called debug.txt in modules/z-push. Change the permissions to 666 so the webserver can write to it. Check this file for errors.
+
 
+
==SyncML==
+
Group-Office Professional has a SyncML server built in. There's no need to install a complicated server. Any mobile phone, PDA or software application that supports the SyncML protocol can synchronize data with Group-Office over the air.
+
At the moment Group-Office can synchronize:
+
 
+
* Appointments
+
* Tasks
+
* Contacts
+
 
+
===Supported devices and download links===
+
 
+
* Nokia, Sony Ericsson with Symbian OS (SyncML client is built in)
+
* Windows Mobile/Pocket PC (Funambol or Synthesis client required)
+
* Blackberry (Funambol client)
+
* Palm OS (Synthesis client)
+
* Outlook (Funambol or Nexthaus client)
+
* Thunderbird (Experimental! with Funambol client 0.7, there are known issues with this client)
+
 
+
The following clients are available:
+
 
+
{|cellpadding="5" cellspacing="0" border="1"
+
! Device
+
! Available clients
+
! Recommended
+
|-
+
| Outlook
+
| Funambol, Nexthaus
+
| Funambol
+
|-
+
| Pocket PC
+
| Funambol, Synthesis
+
| Synthesis
+
|-
+
| Palm
+
| Synthesis
+
| Synthesis
+
|-
+
| Nokia, Sony Ericsson, Symbian
+
| The SyncML client is already installed on these phones
+
|-
+
| Blackberry
+
| Funambol, Nexthaus
+
| Nexthaus
+
|-
+
|-
+
| Iphone (Limited, read below])
+
| Synthesis, Funambol, Nexthaus
+
|-
+
|-
+
|}
+
 
+
You can get the clients here:
+
 
+
Synthesis AG clients: Order them at the software shop.(Try them 30 days free of charge)<br />
+
Funambol Outlook client: http://www.funambol.com/opensource/downloads.php<br />
+
Supported Symbian phones: http://www.symbian.com/phones/index.html<br />
+
Nexthaus clients: http://www.nexthaus.com/<br />
+
 
+
=== General synchronization client or device settings ===
+
 
+
Consult the client or device documentation on how to setup a synchronization profile. You need the following values to setup a synchronization profile:
+
 
+
SyncML Server Version: 1.1<br />
+
SyncML server URL: http://<Enter the URL for your Group-Office>/sync.php (Look it up at Settings -> Synchronization in your Group-Office)<br />
+
Port: 80<br />
+
Username: Your Group-Office username<br />
+
Password: Your Group-Office password<br />
+
 
+
==== Datastores ====
+
 
+
Mostly the datastores are already set correctly by default. Below are the different settings for each client.
+
 
+
{|cellpadding="5" cellspacing="0" border="1"
+
! Database
+
! Symbian (Nokia / Sony-Ericsson)
+
! Funambol
+
! Synthesis
+
! Nexthaus
+
! Funambol Mozilla
+
|-
+
| Calendar
+
| calendar
+
| scal
+
| events
+
| event
+
| event
+
|-
+
| Tasks
+
| none, tasks sync with calendar
+
| stask
+
| tasks
+
| tasks
+
| not supported
+
|-
+
| Contacts
+
| contacts
+
| scard
+
| card
+
| contacts
+
| contacts
+
|-
+
|}
+
 
+
===Group-Office synchronization settings===
+
 
When you click the "Settings" button on the top right you'll find a synchronization tab in the settings window. Here you can control the addressbooks, tasklists and calendar to synchronize with. You can also enable the automatic deletion of events and tasks that are older then a configurable number of days. With this setting enabled all old events will be deleted from your phone but not from Group-Office. This way your phone stays clean and fast.
 
When you click the "Settings" button on the top right you'll find a synchronization tab in the settings window. Here you can control the addressbooks, tasklists and calendar to synchronize with. You can also enable the automatic deletion of events and tasks that are older then a configurable number of days. With this setting enabled all old events will be deleted from your phone but not from Group-Office. This way your phone stays clean and fast.
  
 
[[Image:Synchronization-settings.png|Group-Office synchronization settings tab]]
 
[[Image:Synchronization-settings.png|Group-Office synchronization settings tab]]
  
====Deleting synchronization devices====
+
===Deleting synchronization devices===
 
In general you should never delete a device. It's only useful when you want to start over with a clean phone. So when you hard reset the device and reformat everything you should delete the device in Group-Office too so all information is gone there too.
 
In general you should never delete a device. It's only useful when you want to start over with a clean phone. So when you hard reset the device and reformat everything you should delete the device in Group-Office too so all information is gone there too.
  
 
When you delete it on Group-Office and don't reset the device you will get double entries because Group-Office does not know the relations anymore and it will resend all items to the phone.
 
When you delete it on Group-Office and don't reset the device you will get double entries because Group-Office does not know the relations anymore and it will resend all items to the phone.
  
===iPhone SyncML client===
+
==CalDAV calendar server==
 +
As an alternative to synchronization you can also connect with other client software like Thunderbird, Evolution or Apple iCal. This is ideal if you want to have multiple Group-Office calendars in your client software.
  
Apple restricts it's API for third party developers. Therefore it's only possible to sync with the Apple contacts application. However, Synthesis developed it's own calendar and tasks application for the iPhone so that synchronization is possible.
+
You can read more about it on the [[CalDAV calendar server]] page.
  
You can read more about it here:
+
==CardDAV addressbook server==
 +
Connecting to carddav works exactly like CalDAV. Only instead of the URL /caldav you must use /carddav or /groupoffice/modules/carddav/addressbook.php
  
http://www.group-office.com/News/iPhone+sync
+
You can read more about it on the [[CalDAV calendar server]] page.
  
 
==Troubleshooting==
 
==Troubleshooting==
 
See the [[Troubleshooting#Problems_with_synchronization|Troubleshooting]] page for more information.
 
See the [[Troubleshooting#Problems_with_synchronization|Troubleshooting]] page for more information.

Latest revision as of 08:02, 15 June 2016

Introduction

Group-Office supports two synchronization protocols. It supports Microsoft ActiveSync and Caldav/Carddav. To use ActiveSync z-push must be installed. Read ActiveSync for installation instructions. When z-push is installed at the server, phones can be configured to use ActiveSync very easily. To test if your server is setup with ActiveSync support you can enter:

http://your.url.to.groupoffice/Microsoft-Server-ActiveSync

Note: this is not the Server or host URL you must configure on your device. On the device you have to use the bold part of the URL.

If it's working you should get a Z-push browser authentication dialog which you should simply cancel.

Group-Office can synchronize the following items:

  1. Appointments
  2. Tasks
  3. Contacts
  4. E-mail (ActiveSync only, E-mail can be configured with IMAP when using Caldav/Carddav clients)

Client or device setup

Group-Office can synchronize with the following clients or devices. Click on your device type to view the instructions. In general you need the to enter the following info:

  1. Outlook
  2. Max OS X
  3. Gnome Evolution
  4. Mobile devices with ActiveSync support
    Use your Group-Office username, password and the bold part of the Group-Office URL: http://your.url.to.groupoffice/groupoffice/. The domain field can be left empty or enter anything.
    1. iPhone
    2. Nokia Mail for Exchange
    3. Windows Mobile
    4. Palm
    5. Google Android
  5. CalDAV and CardDAV
    1. DAVDroid for Android phones
    2. Caldav and Cardav sync free for Android
    3. iOS devices support caldav and carddav natively.
  6. Blackberry
  7. Thunderbird 3
  8. Other phones that support ActiveSync or Caldav/Carddav.

Group-Office synchronization settings

When you click the "Settings" button on the top right you'll find a synchronization tab in the settings window. Here you can control the addressbooks, tasklists and calendar to synchronize with. You can also enable the automatic deletion of events and tasks that are older then a configurable number of days. With this setting enabled all old events will be deleted from your phone but not from Group-Office. This way your phone stays clean and fast.

Group-Office synchronization settings tab

Deleting synchronization devices

In general you should never delete a device. It's only useful when you want to start over with a clean phone. So when you hard reset the device and reformat everything you should delete the device in Group-Office too so all information is gone there too.

When you delete it on Group-Office and don't reset the device you will get double entries because Group-Office does not know the relations anymore and it will resend all items to the phone.

CalDAV calendar server

As an alternative to synchronization you can also connect with other client software like Thunderbird, Evolution or Apple iCal. This is ideal if you want to have multiple Group-Office calendars in your client software.

You can read more about it on the CalDAV calendar server page.

CardDAV addressbook server

Connecting to carddav works exactly like CalDAV. Only instead of the URL /caldav you must use /carddav or /groupoffice/modules/carddav/addressbook.php

You can read more about it on the CalDAV calendar server page.

Troubleshooting

See the Troubleshooting page for more information.