ReplicSynchronize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

Managing databases

Managing replications

WLanguage functions

Prefix syntax

ReplicSynchronize

Presentation

Example

Replication and WithSpace function

Replication via a replication server

See also

ReplicSynchronize (Function)

In french: RéplicSynchronise

Not available

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.
replicaImmediate The replica is immediately created, during the synchronization.
This replication mode can be quite long but it guarantees to be updated from the master database.
replicaNoProgressBar By 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: wd270rpl.dll