ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / Managing replications / WLanguage functions
  • Replication and WithSpace function
  • Replication via a replication server
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Synchronizes the data corresponding to a replication. This replication was created by the replication editor (ReplicEdit).
Example
// Starts the synchronization
ReplicSynchronize("MyReplication")
Syntax

Synchronization in direct mode Hide the details

<Result> = ReplicSynchronize(<Replication name>)
<Result>: Boolean
  • True if the synchronization was performed,
  • False otherwise. For more details about the problem, use ErrorInfo.
<Replication name>: Character string
Name of replication to synchronize. This name corresponds to the name of the ".wer" file created by ReplicEdit. This file must be found beside the executable.

Synchronization with a replication server Hide the details

<Result> = ReplicSynchronize(<Replication name> [, <Options>])
<Result>: Boolean
  • True if the synchronization was performed,
  • False otherwise. For more details about the problem, use ErrorInfo.
<Replication name>: Character string
Name of replication to synchronize. This name corresponds to the publication name for a replication server.
<Options>: Optional Integer constant
Type of replication to perform. These options are taken into account for a replication with a replication server.
replicaImmediateThe replica is immediately created, during the synchronization.
This replication mode can be quite long but it guarantees to be updated from the master database.
replicaNoProgressBarBy default, a progress bar is displayed during synchronization. This progress bar is adapted to the current platform.
This constant allows you to no longer display the progress bar.
This constant can be combined with the replicaImmediate and replicaPeriodic constants.
replicaPeriodic
(Default value)
The replica that is taken into account is the replica that is available on the server.
If the replica is periodically created on the server, the last created replica is taken into account.
If the replica is not periodically created on the server, the last generated replica is taken into account. This last replica was generated just after the last synchronization.
This replication mode is fast but it does not guarantee to be "entirely updated" from the master database.

Remark: you should use the same type of replication as the one defined on the server.
Remarks

Replication and WithSpace function

The replication is not compatible with WithSpace in the code of the client application. This function changes the nehavior of HFSQL. Using this function in the client application can affect the efficiency of replication.
From version 21 update 3 (version 210065), the synchronization functions (programmed or assisted universal replication) return an error to the client application if WithSpace was applied to at least one of the replicated files.

Replication via a replication server

During a replication via a replication server (especially for the replication of mobile data (Android or iOS)), the Web server that is hosting the replication server must be configured to allow the data upload and download. Therefore, the option "Maximum authorized length for content" configured in "Filtering requests" of an IIS server must be greater than the size of subscriber data (RPA).
Component: wd290rpl.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help