7. Setting up a BSP project for synchronisation

In this tutorial we will use the application we created in tutorials 5 – 6 to show you how to set up your BSP Project ready to synchronise data to and from a server. The goal of synchronisation is for 2 different data sources (E.g. one in the client and a database on a server) to contain the same data, so that the users can work with the data on the client and serve with equal ease.

7.1 Create sync rules

Sync rules define the subset of data specified by a query to be synchronised and which direction data is transmitted. The sync rule will use the query specified to define the data to be sent and defines which direction (i.e. client to server or server to client).

1. Right click on the Sync Rules subtree and select ‘New Sync Rule’.

2. In the Direction tab in the Sync Rule editor window we need to choose a direction to synchronise data. We’ll set the direction as ‘Client To Server’ meaning data will be sent from the client to the server.

3. Change to the Query tab where we will set the query which will define the data to be sent to the server. Set it to the query created from tutorial 5.2. This sync rule will send all the data in the local table on the client to the server.

    

4. Create another new sync rule to send all data from the server to the client by changing the direction to ‘Server to Client’ and using the same query.

7.2 Implement Client to Server Synchronisation in your BSP project

In this tutorial you will learn how to get data from the server to the client. More information on synchronisation can be found here.

1. In the main form (where the ‘New’ button can be found), add a button and change its caption to ‘Get From Server’.

2. Double-click the button control, then click ‘Run Expression’.

3. Using the methods in ‘Objects>Synchroniser’, ‘Objects>Form’ and the listview methods, replicate what has been done below.

   Synchroniser.DisableAll();

   Synchroniser.EnableSyncRule("SyncRule2", true);

   Form.ShowSyncDialog(false);

   listview1.Refresh();

The above code will disable all sync rules from running, then enable our sync rule to get data from the server to run. We then invoke the sync dialog and refresh the listview to reflect any changes.

7.3 Implement Server to Client Synchronisation in your BSP project

1. Add a new button and label it ‘Send To Server’.

2. Double-click the button and press ‘Run Expression’.

3. For the ‘Send to Server’ button, we do the same thing however enabling the sync rule for sending data to the server.

   Synchroniser.DisableAll();

   Synchroniser.EnableSyncRule("SyncRule1", true);

   Form.ShowSyncDialog(false);

   listview1.Refresh();

Now our mobile application is ready to send and receive data between the client and a server. In the following tutorials we will show you have to set up a localhost server and a BEP file in order to use synchronisation.

Copyright © 2002-26 Bright Software Pty. Ltd. All rights reserved