ReplicInitialize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Operating mode
Initializing filters

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ReplicInitialize (Function)

In french: RéplicInitialise

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 by HCreation before using ReplicInitialize. Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 19 and later

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

New in version 19

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

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 (with quotes)

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.
re-initialize a replication (deletion and re-creation of the replication elements: .rpp, .rpa, .syn files, ...).
re-initialize 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: wd260rpl.dll