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

Not available

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: wd270rpl.dll