ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / Managing replications / WLanguage functions
  • Operating mode
  • Initializing filters
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
Initializes or reinitializes a replication defined by the replication editor (ReplicEdit). This initialization is used to define the parameters of the replication (value of the filters). The necessary data is transferred to the local database.
Remark: The subscriber database must be created locally with HCreation before using ReplicInitialize.
Example
// Initializes the replication
// by passing the zip code to take into account
IF ReplicInfo("MyReplication", replicInitialized) = False THEN
ReplicInitialize("MyReplication", 47012)
END
Syntax
<Result> = ReplicInitialize(<Replication name> [, <Parameter 1> [... [, <Parameter N>]]])
<Result>: Boolean
  • True if the initialization was performed,
  • False otherwise. For more details about the problem, use ErrorInfo.
<Replication name>: Character string
Name of the replication to initialize. This name corresponds to:
  • the name of ".wer" file, created by ReplicEdit (for an online replication). This file must be found beside the executable.
  • the publication name (for a replication server)
<Parameter 1>: Type of parameter, optional
Value of the first parameter for the replication. If this parameter corresponds to an empty string (""), the previous initialization of parameters will be canceled.
<Parameter N>: Type of parameter, optional
Value of the Nth parameter for the replication. If this parameter corresponds to an empty string (""), the previous initialization of parameters will be canceled.
Remarks

Operating mode

The initialization of the replication is used to:
  • initialize the parameters of filters if necessary
  • re-initialize the parameters of filters to 0.
  • reinitialize a replication (deletion and re-creation of the replication elements: .rpp, .rpa, .syn files, ...).
  • reinitialize the information regarding the ranges of identifiers.
Caution: as soon as a subscriber replica is initialized, you must no longer replace/restore one of the master files (because they contain information regarding the ranges of identifiers for the subscriber replicas).
Warning
From version 17, the replication files created with an application or a site in version 17 (or later) cannot be handled by an application or a site in version 16 (or earlier).
The applications or the sites in version 17 (or later) continue to handle the replication files created with an application or a site in version 16 (or earlier).

Initializing filters

The parameters must be specified in the order defined in the replication editor (ReplicEdit). In the replication editor, the order of the parameters can be viewed (and modified if necessary) via "Replication .. Replication description", "Parameters" tab.
Reminder: To optimize the performance of the universal replication, we advise you to define filters.
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