ActiveSync

Overview

Vine ActiveSync synchronizes user events in a Vine database with appointments in a groupware server (such as Microsoft Exchange) supporting the Exchange ActiveSync protocol.

The Vine ActiveSync client is integrated into Vine Web:

Figure 1. Vine ActiveSync client is built into Vine Web

Using

First, Vine ActiveSync has to be properly configured. Users can configure ActiveSync replication in Vine Web and Vine client for Windows. The administrator can define system settings so that user do not need to configure settings like server and protocol used. After the configuration there is no need for any special actions from users. The replication will work automatically on the Vine Web server and the users will see Vine events appear in their client calendar applications, such as Outlook, and events from ActiveSync Server (e.g. Exchange) appear in their Vine calendars. The users do not have to be logged to Vine Web or Vine client for Windows for the replication to work.

Requirements

For the very latest Vine ActiveSync requirements please refer to the Vine Web release notes.

Vine ActiveSync Client Side

    Vine Web 5.1.2 or higherVine Database 5.1.2 or higher
  • Vine ActiveSync client must be able to connect over HTTP(S) to the ActiveSync Server.
ActiveSync Server Side

Currently the following ActiveSync servers are supported:

  • Microsoft Exchange 2010
  • IBM Lotus Domino 8.5.x
The ActiveSync protocol version 14.1 is supported.

User Requirements

  • Any user of Vine Web or Vine client for Windows can use ActiveSync replication.
  • The user has to have an account on a groupware server such as Microsoft Exchange. The current version of ActiveSync allows each user to have its own ActiveSync server.
    • Please note that the use of ActiveSync protocol has to be enabled for your user account on the ActiveSync server.

Configuring ActiveSync

ActiveSync Server Configuration

Normally there is no need for any configuration on the ActiveSync server. In Microsoft Exchange, you might want to check if using ActiveSync protocol is allowed for user accounts supposed to use Vine ActiveSync replication. You can disable the use of ActiveSync for user accounts you do not want to allow using the replication.

Vine Web Server Configuration

You should set the “SyncRepeatTimeout” parameter in the vyconfig.xml file located in the WEB-INF folder of Vine Web product folder under Tomcat:

  • 0 – default value. Automatic synchronization is disabled, but users can manually run a sync.
  • >0. Positive integer number enables automatic synchronization and sets a time interval in minutes between sync rounds. Do not set this interval too low if you have many users as then you might have next sync waiting for the previous one to end which will result in synchronization running all the time.
  • <0 Synchronization is disabled for everyone.

ActiveSync System Settings|linktag=ActiveSyncSystemSettingsLT

You can use the following system settings to configure the default ActiveSync settings, so that users do not need to configure them themselves:

  • vx_ActiveSync_ProtocolType – it can have string value “0” (AS disabled) or “10” (AS used)
  • vx_ActiveSync_ServerType – string value “10” (Exchange) or “20” (Lotus)
  • vx_ActiveSync_ServerAddress – server address, e.g. “https://intra.Vine.fi/Microsoft-Server-ActiveSync”